# 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.