Quickstart - Graphy SDK

@graphysdk/data-import-utils converts CSV, TSV, and spreadsheet files into the { columns, rows } data shape used by Graphy agents and chart configs. No @graphysdk/core dependency or npm org token is required.

Installation

npm install @graphysdk/data-import-utils

yarn add @graphysdk/data-import-utils

pnpm add @graphysdk/data-import-utils

Parse a CSV

import { fromCSV } from '@graphysdk/data-import-utils';

const data = fromCSV('Name,Revenue\nAcme,1000\nGlobex,2000');
// { columns: [{ key: 'c1', label: 'Name' }, ...], rows: [...] }

Parse a Spreadsheet

import { fromXLSX } from '@graphysdk/data-import-utils/xlsx';

const buffer = await file.arrayBuffer();
const data = await fromXLSX(buffer, { sheet: 'Revenue' });

Parse from Disk (Node.js)

import { fromFile } from '@graphysdk/data-import-utils/file';

const data = await fromFile('sales.csv');

fromFile auto-detects the format from the file extension. See File for details.

Parse from URL

import { fromURL } from '@graphysdk/data-import-utils/url';

const data = await fromURL('https://example.com/sales.csv');

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`

Licence

npm install is not a commercial licence. Free Trial is 32 days, local or internal, and does not cover a public page. See licence and evaluation.

​Installation

​Parse a CSV

​Parse a Spreadsheet

​Parse from Disk (Node.js)

​Parse from URL

​Features

​Entrypoints

​Sources

​Formats

​Licence