@graphysdk/data-import-utils converts CSV, TSV, and spreadsheet files into the Data structure expected by @graphysdk/core.
Installation
Parse a CSV
Parse a Spreadsheet
Parse from Disk (Node.js)
fromFile auto-detects the format from the file extension. See File for details.
Parse from URL
fromURL fetches a remote file and auto-detects the format from the URL path extension. See URL for details.
Features
| Feature | Details |
|---|---|
| Formats | CSV, TSV, XLSX, XLS, ODS |
| SSRF protection | fromURL blocks private IPs and non-http(s) schemes |
| Timeout support | fromURL supports configurable timeout and AbortSignal |
| Byte-budget enforcement | All parsers enforce a configurable maxFileSize limit; fromURL aborts streaming downloads early |
| Row / cell limits | Spreadsheet parsers enforce maxRows (default 100k) and maxCells (default 5M) |
Entrypoints
Sources
| Source | Function | Entrypoint |
|---|---|---|
| Local file | fromFile() | @graphysdk/data-import-utils/file |
| Remote URL | fromURL() | @graphysdk/data-import-utils/url |
| Text (CSV/TSV) | fromText() | @graphysdk/data-import-utils/text |
| Binary (XLSX/XLS/ODS) | fromBuffer() | @graphysdk/data-import-utils/buffer |
Formats
| Format | Function | Input type | Entrypoint |
|---|---|---|---|
| CSV | fromCSV() | string | @graphysdk/data-import-utils (root) or /csv |
| TSV | fromTSV() | string | @graphysdk/data-import-utils (root) or /tsv |
| XLSX | fromXLSX() | ArrayBuffer | @graphysdk/data-import-utils/xlsx |
| XLS | fromXLS() | ArrayBuffer | @graphysdk/data-import-utils/xls |
| ODS | fromODS() | ArrayBuffer | @graphysdk/data-import-utils/ods |

