# New File

### Overview

The **New File Component** monitors an FTP or SFTP server for newly created files and directories within a specified path, enabling workflows to react dynamically to file changes.

### Usage

This component connects to an FTP/SFTP server, watches a directory for new files and folders, and emits metadata whenever a new item appears.

#### Properties

| Property | Type     | Description                                                 |
| -------- | -------- | ----------------------------------------------------------- |
| `path`   | `string` | The directory path to monitor for new files or directories. |

#### Output Ports

| Port  | Description                                             |
| ----- | ------------------------------------------------------- |
| `out` | Emits metadata for newly detected files or directories. |

#### Processing Logic

1. **Establishes FTP/SFTP Connection**: Connects securely to the remote server using authentication credentials.
2. **Monitors Directory for Changes**:
   * Lists all current files in the specified path.
   * Compares against previously seen files.
   * Detects new files and directories.
3. **Handles Detected Changes**:
   * If new files or directories are found, outputs their metadata to the `out` port.
   * Saves the current state for future comparisons.
4. **Closes Connection**: Ensures the connection is terminated after execution.

#### Output Data Schema

| Property        | Type     | Description                            |
| --------------- | -------- | -------------------------------------- |
| `name`          | `string` | Name of the new file or directory.     |
| `size`          | `number` | Size of the file in bytes.             |
| `type`          | `string` | Indicates if it's a file or directory. |
| `modifiedAt`    | `number` | Timestamp of the last modification.    |
| `permissions`   | `string` | File permissions.                      |
| `hardLinkCount` | `number` | Number of hard links to the file.      |
| `link`          | `string` | Link to the file, if applicable.       |
| `group`         | `string` | Group ownership of the file.           |
| `user`          | `string` | User ownership of the file.            |
| `uniqueID`      | `string` | Unique identifier of the file.         |

### Notes

* **Supports FTP & SFTP**: Works with both FTP and secure FTP (SFTP) servers.
* **Automated File Monitoring**: Continuously detects and processes new files or directories.
* **Error Handling**: Ensures reliable detection by maintaining a known file state.

This component is useful for workflows requiring automatic response to file additions in remote directories.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.appmixer.com/connector-configuration/utils/ftp/new-file.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.