@elaraai/east-node-io 0.0.1-beta.2 → 0.0.1-beta.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elaraai/east-node-io",
-  "version": "0.0.1-beta.2",
+  "version": "0.0.1-beta.3",
   "description": "I/O platform functions for the East language on Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -80,7 +80,7 @@
     "node": ">=22.0.0"
   },
   "devDependencies": {
-    "@elaraai/east-node-std": "^0.0.1-beta.2",
+    "@elaraai/east-node-std": "^0.0.1-beta.3",
     "@types/adm-zip": "^0.5.7",
     "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^22.18.1",
@@ -97,7 +97,7 @@
   "dependencies": {
     "@aws-sdk/client-s3": "^3.713.0",
     "@aws-sdk/s3-request-presigner": "^3.713.0",
-    "@elaraai/east": "^0.0.1-beta.3",
+    "@elaraai/east": "^0.0.1-beta.5",
     "adm-zip": "^0.5.16",
     "basic-ftp": "^5.0.5",
     "better-sqlite3": "^11.0.0",

package/dist/format/csv.d.ts

@@ -1,210 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-import { BlobType, ArrayType, DictType, StringType, OptionType, BooleanType, StructType, VariantType, NullType } from "@elaraai/east";
-import type { PlatformFunction } from "@elaraai/east/internal";
-export declare const CsvColumnType: VariantType<{
-    Null: NullType;
-    Boolean: NullType;
-    Integer: NullType;
-    Float: NullType;
-    String: NullType;
-    DateTime: NullType;
-    Blob: NullType;
-}>;
-export declare const CsvParseConfig: StructType<{
-    columns: OptionType<DictType<StringType, VariantType<{
-        Null: NullType;
-        Boolean: NullType;
-        Integer: NullType;
-        Float: NullType;
-        String: NullType;
-        DateTime: NullType;
-        Blob: NullType;
-    }>>>;
-    delimiter: OptionType<StringType>;
-    quoteChar: OptionType<StringType>;
-    escapeChar: OptionType<StringType>;
-    newline: OptionType<StringType>;
-    hasHeader: BooleanType;
-    nullString: OptionType<StringType>;
-    skipEmptyLines: BooleanType;
-    trimFields: BooleanType;
-}>;
-export declare const CsvSerializeConfig: StructType<{
-    delimiter: StringType;
-    quoteChar: StringType;
-    escapeChar: StringType;
-    newline: StringType;
-    includeHeader: BooleanType;
-    nullString: StringType;
-    alwaysQuote: BooleanType;
-}>;
-/** Represents a single CSV row as a dictionary mapping column names to optional string values. */
-export declare const CsvRowType: DictType<StringType, VariantType<{
-    Null: NullType;
-    Boolean: BooleanType;
-    Integer: import("@elaraai/east").IntegerType;
-    Float: import("@elaraai/east").FloatType;
-    String: StringType;
-    DateTime: import("@elaraai/east").DateTimeType;
-    Blob: BlobType;
-}>>;
-/** Represents CSV data as an array of row dictionaries. */
-export declare const CsvDataType: ArrayType<DictType<StringType, VariantType<{
-    Null: NullType;
-    Boolean: BooleanType;
-    Integer: import("@elaraai/east").IntegerType;
-    Float: import("@elaraai/east").FloatType;
-    String: StringType;
-    DateTime: import("@elaraai/east").DateTimeType;
-    Blob: BlobType;
-}>>>;
-/**
- * Parses CSV data from a binary blob into structured row data.
- *
- * Converts CSV-formatted binary data into an array of row dictionaries,
- * where each dictionary maps column names to optional string values.
- * Supports configurable delimiters, quote characters, escape sequences,
- * and header handling.
- *
- * This is a platform function for the East language, enabling CSV parsing
- * in East programs running on Node.js.
- *
- * @param blob - The CSV data as a binary blob (UTF-8 encoded)
- * @param config - Parsing configuration including delimiter, quote characters, and header options
- * @returns An array of row dictionaries, each mapping column names to optional string values
- *
- * @throws {EastError} When CSV is malformed with specific error messages:
- * - "Unclosed quote in row N, column M" - Quote not properly closed
- * - "Too many fields in row N (expected X columns, found at least Y)" - More fields than header
- * - "Too few fields in row N (expected X columns, got Y)" - Fewer fields than header
- * - "Invalid escape sequence in row N, column M" - Invalid escape character usage
- * - "Expected delimiter or newline after closing quote in row N, column M" - Invalid data after quote
- * - "quoteChar must have length 1" - Invalid configuration
- * - "escapeChar must have length 1" - Invalid configuration
- * - "delimiter must not be empty" - Invalid configuration
- *
- * @example
- * ```ts
- * const parseCSV = East.function([BlobType], CsvDataType, ($, csvBlob) => {
- *     const config = $.const(East.value({
- *         delimiter: variant('some', ','),
- *         quoteChar: variant('some', '"'),
- *         escapeChar: variant('some', '"'),
- *         newline: variant('none', null),
- *         hasHeader: true,
- *         nullString: variant('some', ''),
- *         skipEmptyLines: true,
- *         trimFields: false,
- *     }, CsvParseConfig));
- *
- *     return csv_parse(csvBlob, config);
- *     // Returns: [{"name": some("Alice"), "age": some("30")}, ...]
- * });
- * ```
- *
- * @remarks
- * - Handles quoted fields with embedded delimiters and newlines
- * - Supports both quote-as-escape ("") and backslash-escape (\") modes
- * - Auto-detects newline format (CRLF, LF, or CR) when newline option is none
- * - Validates column counts when hasHeader is true
- * - Skips UTF-8 BOM (0xEF 0xBB 0xBF) if present at start
- * - When hasHeader is false, generates column names as "column_0", "column_1", etc.
- */
-export declare const csv_parse: import("@elaraai/east").PlatformDefinition<[BlobType, StructType<{
-    columns: OptionType<DictType<StringType, VariantType<{
-        Null: NullType;
-        Boolean: NullType;
-        Integer: NullType;
-        Float: NullType;
-        String: NullType;
-        DateTime: NullType;
-        Blob: NullType;
-    }>>>;
-    delimiter: OptionType<StringType>;
-    quoteChar: OptionType<StringType>;
-    escapeChar: OptionType<StringType>;
-    newline: OptionType<StringType>;
-    hasHeader: BooleanType;
-    nullString: OptionType<StringType>;
-    skipEmptyLines: BooleanType;
-    trimFields: BooleanType;
-}>], ArrayType<DictType<StringType, VariantType<{
-    Null: NullType;
-    Boolean: BooleanType;
-    Integer: import("@elaraai/east").IntegerType;
-    Float: import("@elaraai/east").FloatType;
-    String: StringType;
-    DateTime: import("@elaraai/east").DateTimeType;
-    Blob: BlobType;
-}>>>>;
-/**
- * Serializes structured row data into CSV-formatted binary data.
- *
- * Converts an array of row dictionaries into CSV-formatted binary data.
- * Supports configurable delimiters, quote characters, escape sequences,
- * and formatting options.
- *
- * This is a platform function for the East language, enabling CSV serialization
- * in East programs running on Node.js.
- *
- * @param data - An array of row dictionaries to serialize
- * @param config - Serialization configuration including delimiter, quote characters, and formatting options
- * @returns A binary blob containing the CSV-formatted data (UTF-8 encoded)
- *
- * @throws {EastError} When configuration is invalid:
- * - "quoteChar must have length 1" - Invalid configuration
- * - "escapeChar must have length 1" - Invalid configuration
- * - "delimiter must not be empty" - Invalid configuration
- *
- * @example
- * ```ts
- * const serializeCSV = East.function([CsvDataType], BlobType, ($, data) => {
- *     const config = $.const(East.value({
- *         delimiter: ',',
- *         quoteChar: '"',
- *         escapeChar: '"',
- *         newline: '\n',
- *         includeHeader: true,
- *         nullString: '',
- *         alwaysQuote: false,
- *     }, CsvSerializeConfig));
- *
- *     return csv_serialize(data, config);
- *     // Returns blob that decodes to: "name,age\nAlice,30\nBob,25"
- * });
- * ```
- *
- * @remarks
- * - Automatically quotes fields containing delimiter, quote char, newline, or null string
- * - Escapes quote characters within quoted fields using escapeChar
- * - Column order is determined by the first row's dictionary keys
- * - Null values are serialized as nullString
- * - Use alwaysQuote: true to force quoting of all fields
- */
-export declare const csv_serialize: import("@elaraai/east").PlatformDefinition<[ArrayType<DictType<StringType, VariantType<{
-    Null: NullType;
-    Boolean: BooleanType;
-    Integer: import("@elaraai/east").IntegerType;
-    Float: import("@elaraai/east").FloatType;
-    String: StringType;
-    DateTime: import("@elaraai/east").DateTimeType;
-    Blob: BlobType;
-}>>>, StructType<{
-    delimiter: StringType;
-    quoteChar: StringType;
-    escapeChar: StringType;
-    newline: StringType;
-    includeHeader: BooleanType;
-    nullString: StringType;
-    alwaysQuote: BooleanType;
-}>], BlobType>;
-/**
- * Node.js implementation of CSV platform functions.
- *
- * Pass this array to {@link East.compile} to enable CSV operations.
- */
-export declare const CsvImpl: PlatformFunction[];
-//# sourceMappingURL=csv.d.ts.map

package/dist/format/csv.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../src/format/csv.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAA6B,WAAW,EAAE,QAAQ,EAAS,MAAM,eAAe,CAAC;AAC9K,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,eAAO,MAAM,aAAa;;;;;;;;EAQxB,CAAA;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAUzB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;EAQ7B,CAAC;AAIH,kGAAkG;AAClG,eAAO,MAAM,UAAU;;;;;;;;GAAyC,CAAC;AAEjE,2DAA2D;AAC3D,eAAO,MAAM,WAAW;;;;;;;;IAAwB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;KAAsE,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;cAA8E,CAAC;AAEzG;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,gBAAgB,EAwBrC,CAAC"}