@elaraai/east-node-std 1.0.69 → 1.0.71

package/README.md

@@ -9,14 +9,14 @@
 
 ## Features
 
-- **📁 File System** - Read/write files, manage directories
-- **🖥️ Console I/O** - stdout/stderr output, stdin input
-- **🌐 HTTP Client** - Modern Fetch API for HTTP requests
+- **File System** - Read/write files, manage directories, open huge beast2 collection files lazily
+- **Console I/O** - stdout/stderr output, stdin input
+- **HTTP Client** - Modern Fetch API for HTTP requests
 - **Cryptography** - Random bytes, SHA-256, UUID generation
-- **🎲 Random** - Random number generation with 14 statistical distributions
-- **⏱️ Time Operations** - Timestamps and sleep
-- **🛤️ Path Utilities** - Cross-platform path manipulation
-- **🧪 Test Framework** - Built-in testing utilities
+- **Random** - Random number generation with statistical distributions
+- **Time Operations** - Timestamps and sleep
+- **Path Utilities** - Cross-platform path manipulation
+- **Test Framework** - Built-in testing utilities
 - **Type-Safe** - Full TypeScript support with EastError handling
 
 ## Installation
@@ -49,17 +49,17 @@ compiled("/path/to/input.txt");
 
 ## Platform Functions
 
-East Node provides seven platform modules:
+East Node provides these platform modules:
 
 | Module | Functions | Description |
 |--------|-----------|-------------|
 | **Console** | `log`, `error`, `write` | Console I/O operations |
-| **FileSystem** | `readFile`, `writeFile`, `exists`, `createDirectory`, etc. | File system operations (11 functions) |
+| **FileSystem** | `readFile`, `writeFile`, `exists`, `createDirectory`, `openBeast`, etc. | File system operations, including lazily paged beast2 collection files |
 | **Fetch** | `get`, `post`, `request` | HTTP client using Fetch API |
 | **Crypto** | `randomBytes`, `hashSha256`, `uuid` | Cryptographic operations |
 | **Time** | `now`, `sleep` | Time and delay operations |
 | **Path** | `join`, `resolve`, `dirname`, `basename`, `extname` | Path manipulation |
-| **Random** | `uniform`, `normal`, `range`, `exponential`, `bernoulli`, etc. | Random number generation with 14 distributions |
+| **Random** | `uniform`, `normal`, `range`, `exponential`, `bernoulli`, etc. | Random number generation with statistical distributions |
 
 **Complete platform:**
 ```typescript

package/dist/src/fs.d.ts

@@ -2,7 +2,7 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
-import { StringType, NullType, BooleanType, ArrayType, BlobType } from "@elaraai/east";
+import { StringType, NullType, BooleanType, ArrayType, BlobType, type SetType, type DictType, type SubtypeExprOrValue, type ExprType } from "@elaraai/east";
 import type { PlatformFunction } from "@elaraai/east/internal";
 /**
  * Reads a file as a UTF-8 string.
@@ -274,6 +274,50 @@ export declare const fs_read_file_bytes: import("@elaraai/east").PlatformDefinit
  * ```
  */
 export declare const fs_write_file_bytes: import("@elaraai/east").PlatformDefinition<[StringType, BlobType], NullType>;
+/**
+ * Opens an indexed beast2 collection file as a frozen, lazily paged value.
+ *
+ * Generic over the collection type `T` (an `Array`, `Set` or `Dict` type),
+ * passed first at the call site as every generic platform call is spelled:
+ * `fs_open_beast([T], path)`. The result behaves exactly as `blob.openBeast`'s:
+ * `size`, `get`, `has` and a `$.for` loop decode one segment of the file at a
+ * time, the value is frozen (mutation is an error, copy first), and a file
+ * without a paging index (what `East.Blob.encodeBeast` writes) or whose element
+ * shape holds `Ref` or function values decodes whole, frozen. The file's header
+ * must carry exactly `T`.
+ *
+ * The file is paged from the file system on every runtime: east-c and east-py
+ * map it, Node reads each segment frame through positioned reads on an open
+ * descriptor — the wire bytes never sit on the heap whole, and only the
+ * segments a program touches are ever resident (a Set or Dict file's first
+ * keyed read also probes every segment's fence once). The descriptor closes
+ * when the value is garbage collected, which is not prompt: a loop opening
+ * thousands of files can exhaust descriptors before any are released. Keep
+ * the file unchanged while the value is alive — the other runtimes map it,
+ * and a truncated mapping faults. The same program produces the same values
+ * on all three.
+ *
+ * Prefer {@link FileSystem.openBeast}, which checks `T` when the expression is
+ * built.
+ *
+ * @param path - The file path to open (relative or absolute)
+ * @returns The frozen collection of type `T`
+ *
+ * @throws {EastError} When the file cannot be opened as `T`:
+ * - File doesn't exist: `Failed to open beast file <path>: ENOENT: no such file or directory`
+ * - Header carries another type: `Failed to open beast file <path>: beast2: cannot open a blob of type <wire> as <T>`
+ * - Not a beast2 container: `Failed to open beast file <path>: <decode error>`
+ *
+ * @example
+ * ```ts
+ * const TableType = DictType(IntegerType, StructType({ id: IntegerType, name: StringType }));
+ * const lookup = East.function([StringType], StringType, ($, path) => {
+ *     const table = $.let(fs_open_beast([TableType], path));
+ *     return table.get(7n).name;   // decodes the one segment holding key 7
+ * });
+ * ```
+ */
+export declare const fs_open_beast: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [StringType], "T">;
 /**
  * Node.js implementation of file system platform functions.
  *
@@ -509,6 +553,42 @@ export declare const FileSystem: {
      * ```
      */
     readonly writeFileBytes: import("@elaraai/east").PlatformDefinition<[StringType, BlobType], NullType>;
+    /**
+     * Opens an indexed beast2 collection file as a frozen, lazily paged value.
+     *
+     * The file-backed twin of `blob.openBeast`: `size`, `get`, `has` and a
+     * `$.for` loop decode one segment of the file at a time, the value is
+     * frozen, and a file without a paging index (or whose element shape holds
+     * `Ref` or function values) decodes whole, frozen. The file's header must
+     * carry exactly `type`. Only `Array`, `Set` and `Dict` types are accepted,
+     * checked when the expression is built; the same program produces the
+     * same values on the east-node, east-c and east-py runners.
+     *
+     * @typeParam T - The collection type the file was written with
+     * @param type - The `Array`, `Set` or `Dict` type to open the file as
+     * @param path - The file path to open (relative or absolute)
+     * @returns The frozen collection of type `T`
+     * @throws {Error} When `type` is not an Array, Set or Dict type (at build time)
+     * @throws {EastError} When the file cannot be opened as `type`
+     * (`Failed to open beast file <path>: ...`, naming both types on a mismatch)
+     *
+     * @example
+     * ```ts
+     * const TableType = DictType(IntegerType, StructType({ id: IntegerType, name: StringType }));
+     * const total = East.function([StringType], IntegerType, ($, path) => {
+     *     const table = $.let(FileSystem.openBeast(TableType, path));
+     *     const sum = $.let(0n);
+     *     $.for(table, ($, row) => {
+     *         $.assign(sum, sum.add(row.id));   // one segment decoded at a time
+     *     });
+     *     return sum;
+     * });
+     *
+     * const compiled = East.compile(total, FileSystem.Implementation);
+     * compiled("rows.beast2");
+     * ```
+     */
+    readonly openBeast: <T extends ArrayType | SetType | DictType>(type: T, path: SubtypeExprOrValue<StringType>) => ExprType<T>;
     /**
      * Node.js implementation of file system platform functions.
      *

package/dist/src/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/fs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAa/D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,YAAY,sEAA0D,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,aAAa,gFAAqE,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc,gFAAsE,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc,oEAA0D,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,SAAS,uEAAwD,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,UAAU,uEAAyD,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,uEAA8D,CAAC;AAE3F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB,oEAA+D,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,iBAAiB,iFAA0E,CAAC;AAEzG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,kBAAkB,oEAA8D,CAAC;AAE9F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,mBAAmB,8EAAyE,CAAC;AAE1G;;;;GAIG;AACH,QAAA,MAAM,cAAc,EAAE,gBAAgB,EAmGrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,UAAU;IACnB;;;;;;;;;;;;;;;;;;;;OAoBG;;IAGH;;;;;;;;;;;;;;;;;;;;OAoBG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;;;;;;OAqBG;;IAGH;;;;OAIG;;CAEG,CAAC;AAGX,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/fs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACG,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAC5D,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAiB,KAAK,kBAAkB,EAAE,KAAK,QAAQ,EAIrF,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAiB/D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,YAAY,sEAA0D,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,aAAa,gFAAqE,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc,gFAAsE,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc,oEAA0D,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,SAAS,uEAAwD,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,UAAU,uEAAyD,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,uEAA8D,CAAC;AAE3F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB,oEAA+D,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,iBAAiB,iFAA0E,CAAC;AAEzG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,kBAAkB,oEAA8D,CAAC;AAE9F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,mBAAmB,8EAAyE,CAAC;AAE1G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,aAAa,+FAAkE,CAAC;AAa7F;;;;GAIG;AACH,QAAA,MAAM,cAAc,EAAE,gBAAgB,EAqKrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,UAAU;IACnB;;;;;;;;;;;;;;;;;;;;OAoBG;;IAGH;;;;;;;;;;;;;;;;;;;;OAoBG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;;;;;;OAqBG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;yBACO,CAAC,SAAS,SAAS,GAAG,OAAO,GAAG,QAAQ,QAAQ,CAAC,QAAQ,kBAAkB,CAAC,UAAU,CAAC,KAAG,QAAQ,CAAC,CAAC,CAAC;IAO/G;;;;OAIG;;CAEG,CAAC;AAGX,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/src/fs.js

@@ -2,9 +2,9 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
-import { East, StringType, NullType, BooleanType, ArrayType, BlobType } from "@elaraai/east";
+import { East, StringType, NullType, BooleanType, ArrayType, BlobType, isTypeValueEqual, printTypeValue, readBeast2Type, readBeast2Extents, isBeast2LazySafe, openBeast2LazyFor, decodeBeast2For, } from "@elaraai/east";
 import { EastError } from "@elaraai/east/internal";
-import { readFileSync, writeFileSync, appendFileSync, unlinkSync, existsSync, statSync, mkdirSync, readdirSync, } from "node:fs";
+import { readFileSync, writeFileSync, appendFileSync, unlinkSync, existsSync, statSync, mkdirSync, readdirSync, openSync, closeSync, fstatSync, readSync, } from "node:fs";
 /**
  * Reads a file as a UTF-8 string.
  *
@@ -275,6 +275,61 @@ export const fs_read_file_bytes = East.platform("fs_read_file_bytes", [StringTyp
  * ```
  */
 export const fs_write_file_bytes = East.platform("fs_write_file_bytes", [StringType, BlobType], NullType);
+/**
+ * Opens an indexed beast2 collection file as a frozen, lazily paged value.
+ *
+ * Generic over the collection type `T` (an `Array`, `Set` or `Dict` type),
+ * passed first at the call site as every generic platform call is spelled:
+ * `fs_open_beast([T], path)`. The result behaves exactly as `blob.openBeast`'s:
+ * `size`, `get`, `has` and a `$.for` loop decode one segment of the file at a
+ * time, the value is frozen (mutation is an error, copy first), and a file
+ * without a paging index (what `East.Blob.encodeBeast` writes) or whose element
+ * shape holds `Ref` or function values decodes whole, frozen. The file's header
+ * must carry exactly `T`.
+ *
+ * The file is paged from the file system on every runtime: east-c and east-py
+ * map it, Node reads each segment frame through positioned reads on an open
+ * descriptor — the wire bytes never sit on the heap whole, and only the
+ * segments a program touches are ever resident (a Set or Dict file's first
+ * keyed read also probes every segment's fence once). The descriptor closes
+ * when the value is garbage collected, which is not prompt: a loop opening
+ * thousands of files can exhaust descriptors before any are released. Keep
+ * the file unchanged while the value is alive — the other runtimes map it,
+ * and a truncated mapping faults. The same program produces the same values
+ * on all three.
+ *
+ * Prefer {@link FileSystem.openBeast}, which checks `T` when the expression is
+ * built.
+ *
+ * @param path - The file path to open (relative or absolute)
+ * @returns The frozen collection of type `T`
+ *
+ * @throws {EastError} When the file cannot be opened as `T`:
+ * - File doesn't exist: `Failed to open beast file <path>: ENOENT: no such file or directory`
+ * - Header carries another type: `Failed to open beast file <path>: beast2: cannot open a blob of type <wire> as <T>`
+ * - Not a beast2 container: `Failed to open beast file <path>: <decode error>`
+ *
+ * @example
+ * ```ts
+ * const TableType = DictType(IntegerType, StructType({ id: IntegerType, name: StringType }));
+ * const lookup = East.function([StringType], StringType, ($, path) => {
+ *     const table = $.let(fs_open_beast([TableType], path));
+ *     return table.get(7n).name;   // decodes the one segment holding key 7
+ * });
+ * ```
+ */
+export const fs_open_beast = East.genericPlatform("fs_open_beast", ["T"], [StringType], "T");
+/** The descriptors behind lazily opened beast files, closed when their
+ *  value is collected: the value reads segment frames from the descriptor
+ *  for its whole life, so nothing shorter-lived may own it. */
+const openBeastFiles = new FinalizationRegistry((fd) => {
+    try {
+        closeSync(fd);
+    }
+    catch {
+        // Already closed — nothing else to release.
+    }
+});
 /**
  * Node.js implementation of file system platform functions.
  *
@@ -389,6 +444,77 @@ const FileSystemImpl = [
             });
         }
     }),
+    fs_open_beast.implement((T) => {
+        // The decoders are built once per type argument, the whole one on
+        // first use (a paged file never needs it). The lazy open is reserved
+        // for the element shapes it can serve frozen; anything else takes
+        // the whole frozen decode, as blob.openBeast does.
+        let whole = null;
+        const lazy = isBeast2LazySafe(T, { frozen: true }) ? openBeast2LazyFor(T, { frozen: true }) : null;
+        return (path) => {
+            const file = path;
+            let fd = -1;
+            try {
+                fd = openSync(file, "r");
+                const handle = fd;
+                const reader = {
+                    size: fstatSync(handle).size,
+                    read(offset, length) {
+                        const out = new Uint8Array(length);
+                        let done = 0;
+                        while (done < length) {
+                            const n = readSync(handle, out, done, length - done, offset + done);
+                            if (n === 0)
+                                throw new Error(`beast2: short read at offset ${offset + done}`);
+                            done += n;
+                        }
+                        return out;
+                    },
+                };
+                // An indexed collection file pages from the descriptor: the
+                // open reads its tail and head, and a program's reads fetch
+                // the segment frames they decode.
+                let extents = null;
+                try {
+                    extents = readBeast2Extents(reader);
+                }
+                catch {
+                    extents = null;
+                }
+                if (extents !== null) {
+                    if (!isTypeValueEqual(extents.typeValue, T)) {
+                        throw new Error(`beast2: cannot open a blob of type ${printTypeValue(extents.typeValue)} as ${printTypeValue(T)}`);
+                    }
+                    if (lazy !== null && extents.selfContained) {
+                        const value = lazy(reader);
+                        openBeastFiles.register(value, handle);
+                        fd = -1; // the value owns the descriptor from here
+                        return value;
+                    }
+                }
+                // Not pageable (index-less, or a gated element shape): the
+                // whole frozen decode from one read of the file. Both
+                // container versions name their type in the header.
+                const data = reader.read(0, reader.size);
+                const wire = readBeast2Type(data);
+                if (!isTypeValueEqual(wire, T)) {
+                    throw new Error(`beast2: cannot open a blob of type ${printTypeValue(wire)} as ${printTypeValue(T)}`);
+                }
+                whole ??= decodeBeast2For(T, { frozen: true });
+                return whole(data);
+            }
+            catch (err) {
+                throw new EastError(`Failed to open beast file ${file}: ${err.message}`, {
+                    location: [{ filename: "fs_open_beast", line: 0n, column: 0n }],
+                    cause: err
+                });
+            }
+            finally {
+                if (fd >= 0)
+                    closeSync(fd);
+            }
+        };
+    }),
 ];
 /**
  * Grouped file system platform functions.
@@ -619,6 +745,47 @@ export const FileSystem = {
      * ```
      */
     writeFileBytes: fs_write_file_bytes,
+    /**
+     * Opens an indexed beast2 collection file as a frozen, lazily paged value.
+     *
+     * The file-backed twin of `blob.openBeast`: `size`, `get`, `has` and a
+     * `$.for` loop decode one segment of the file at a time, the value is
+     * frozen, and a file without a paging index (or whose element shape holds
+     * `Ref` or function values) decodes whole, frozen. The file's header must
+     * carry exactly `type`. Only `Array`, `Set` and `Dict` types are accepted,
+     * checked when the expression is built; the same program produces the
+     * same values on the east-node, east-c and east-py runners.
+     *
+     * @typeParam T - The collection type the file was written with
+     * @param type - The `Array`, `Set` or `Dict` type to open the file as
+     * @param path - The file path to open (relative or absolute)
+     * @returns The frozen collection of type `T`
+     * @throws {Error} When `type` is not an Array, Set or Dict type (at build time)
+     * @throws {EastError} When the file cannot be opened as `type`
+     * (`Failed to open beast file <path>: ...`, naming both types on a mismatch)
+     *
+     * @example
+     * ```ts
+     * const TableType = DictType(IntegerType, StructType({ id: IntegerType, name: StringType }));
+     * const total = East.function([StringType], IntegerType, ($, path) => {
+     *     const table = $.let(FileSystem.openBeast(TableType, path));
+     *     const sum = $.let(0n);
+     *     $.for(table, ($, row) => {
+     *         $.assign(sum, sum.add(row.id));   // one segment decoded at a time
+     *     });
+     *     return sum;
+     * });
+     *
+     * const compiled = East.compile(total, FileSystem.Implementation);
+     * compiled("rows.beast2");
+     * ```
+     */
+    openBeast(type, path) {
+        if (type.type !== "Array" && type.type !== "Set" && type.type !== "Dict") {
+            throw new Error(`FileSystem.openBeast opens Array, Set or Dict files, not ${type.type} — read the bytes with FileSystem.readFileBytes and decodeBeast for other types`);
+        }
+        return fs_open_beast([type], path);
+    },
     /**
      * Node.js implementation of file system platform functions.
      *

package/dist/src/fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/fs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/fs.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -16,6 +16,7 @@ export * from "./crypto.js";
 export * from "./time.js";
 export * from "./fetch.js";
 export * from "./random.js";
+export * from "./json.js";
 /**
  * Complete Node.js platform implementation.
  *

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAa5B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,qDAUxB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,qDAS5B,CAAC;AAGF,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAc1B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,qDAWxB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,qDAU5B,CAAC;AAGF,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}

package/dist/src/index.js

@@ -18,6 +18,7 @@ export * from "./crypto.js";
 export * from "./time.js";
 export * from "./fetch.js";
 export * from "./random.js";
+export * from "./json.js";
 // Import implementations for combined export
 import { ConsoleImpl } from "./console.js";
 import { EnvImpl } from "./env.js";
@@ -27,6 +28,7 @@ import { CryptoImpl } from "./crypto.js";
 import { TimeImpl } from "./time.js";
 import { FetchImpl } from "./fetch.js";
 import { RandomImpl } from "./random.js";
+import { JsonImpl } from "./json.js";
 import { TestImpl } from "./test.js";
 /**
  * Complete Node.js platform implementation.
@@ -57,6 +59,7 @@ export const NodePlatform = [
     ...TimeImpl,
     ...FetchImpl,
     ...RandomImpl,
+    ...JsonImpl,
     ...TestImpl,
 ];
 /**
@@ -84,6 +87,7 @@ export const NodePlatformSync = [
     ...PathImpl,
     ...CryptoImpl,
     ...RandomImpl,
+    ...JsonImpl,
     // TimeImpl excluded (has async sleep)
     // FetchImpl excluded (all async)
 ];

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,wBAAwB;AACxB,cAAc,WAAW,CAAC;AAE1B,2DAA2D;AAC3D,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAE5B,6CAA6C;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,GAAG,WAAW;IACd,GAAG,OAAO;IACV,GAAG,cAAc;IACjB,GAAG,QAAQ;IACX,GAAG,UAAU;IACb,GAAG,QAAQ;IACX,GAAG,SAAS;IACZ,GAAG,UAAU;IACb,GAAG,QAAQ;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,GAAG,WAAW;IACd,GAAG,OAAO;IACV,GAAG,cAAc;IACjB,GAAG,QAAQ;IACX,GAAG,UAAU;IACb,GAAG,UAAU;IACb,sCAAsC;IACtC,iCAAiC;CACpC,CAAC;AAEF,oFAAoF;AACpF,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,wBAAwB;AACxB,cAAc,WAAW,CAAC;AAE1B,2DAA2D;AAC3D,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAE1B,6CAA6C;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,GAAG,WAAW;IACd,GAAG,OAAO;IACV,GAAG,cAAc;IACjB,GAAG,QAAQ;IACX,GAAG,UAAU;IACb,GAAG,QAAQ;IACX,GAAG,SAAS;IACZ,GAAG,UAAU;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,GAAG,WAAW;IACd,GAAG,OAAO;IACV,GAAG,cAAc;IACjB,GAAG,QAAQ;IACX,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,QAAQ;IACX,sCAAsC;IACtC,iCAAiC;CACpC,CAAC;AAEF,oFAAoF;AACpF,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}

package/dist/src/json.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { StringType, NullType, BooleanType, type EastType, type SubtypeExprOrValue, type ExprType } from "@elaraai/east";
+import type { PlatformFunction } from "@elaraai/east/internal";
+/**
+ * Opens a JSON file and positions a reader on the array or object to iterate.
+ *
+ * @param path - The file to read
+ * @param pointer - RFC 6901 pointer to the container, `""` for the whole document
+ * @returns An opaque handle
+ *
+ * @throws {EastError} When the file cannot be opened, the pointer does not
+ * resolve, or the node it names is not an array or object
+ *
+ * @remarks
+ * The document is never held: the reader pulls one chunk of text at a time and
+ * constructs one value per {@link json_next}. Reading past the container is
+ * skipping, not parsing, so a pointer naming a small envelope member costs a
+ * scan and nothing more.
+ */
+export declare const json_open: import("@elaraai/east").PlatformDefinition<[StringType, StringType], StringType>;
+/**
+ * Opens an in-memory JSON payload, as {@link json_open} opens a file.
+ *
+ * @param text - The document
+ * @param pointer - RFC 6901 pointer to the container, `""` for the whole document
+ * @returns An opaque handle
+ *
+ * @remarks
+ * The same reader over a string, so a request body and a multi-gigabyte file
+ * are read by one implementation and held to one definition of strict.
+ */
+export declare const json_open_text: import("@elaraai/east").PlatformDefinition<[StringType, StringType], StringType>;
+/**
+ * Whether the container being iterated has another element.
+ *
+ * @param handle - A handle from {@link json_open} or {@link json_open_text}
+ * @returns True while elements remain
+ *
+ * @throws {EastError} When the handle is not open, or the document is malformed
+ *
+ * @remarks
+ * A predicate, not an advance: {@link json_next} moves the cursor, so the two
+ * need not alternate and asking twice is harmless.
+ */
+export declare const json_more: import("@elaraai/east").PlatformDefinition<[StringType], BooleanType>;
+/**
+ * Reads the next element of the container as `T`.
+ *
+ * @param handle - A handle from {@link json_open} or {@link json_open_text}
+ * @returns The decoded value
+ *
+ * @throws {EastError} When the element does not satisfy `T` under East JSON's
+ * encoding, naming the RFC 6901 pointer of the offending node
+ *
+ * @remarks
+ * Strict: it accepts exactly what `jsonSchemaFor(T)` describes, which is what
+ * the ENCODER emits rather than what the historic decoder tolerated. An
+ * integer must be a quoted decimal in i64 range — not `"0x10"`, not `" 7 "`,
+ * not `"007"`; a timestamp must carry an explicit `+00:00`, not `Z` and not a
+ * numeric offset; a blob's hex must be lowercase.
+ *
+ * When the container is a JSON object, `T` must be a `Struct` of exactly `key`
+ * and `value`, in either order, and each member arrives as one of those —
+ * which is what a `Dict` output needs. An error inside an element is located
+ * by its index in an array and by its member name in an object, and reads
+ * word for word as it does on east-c and east-py.
+ */
+export declare const json_next: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [StringType], "T">;
+/**
+ * Reads one whole value from a file, without iterating.
+ *
+ * @param path - The file to read
+ * @param pointer - RFC 6901 pointer to the value
+ * @returns The decoded value
+ *
+ * @throws {EastError} When the file cannot be read, the pointer does not
+ * resolve, or the value does not satisfy `T`
+ *
+ * @remarks
+ * For the small parts of a document whose large parts are streamed — an
+ * envelope's metadata beside a ten-million-row array. Everything outside the
+ * pointer is skipped rather than constructed.
+ */
+export declare const json_value: import("@elaraai/east").GenericPlatformDefinition<readonly ["T"], readonly [StringType, StringType], "T">;
+/**
+ * Closes a reader and releases its file descriptor.
+ *
+ * @param handle - A handle from {@link json_open} or {@link json_open_text}
+ * @returns Null
+ *
+ * @remarks
+ * Handles are held until closed, as a database connection is. A body that can
+ * fail mid-document should close in a `.catch` that re-raises, since a `$.try`
+ * whose `.catch` is left implicit swallows the error.
+ */
+export declare const json_close: import("@elaraai/east").PlatformDefinition<[StringType], NullType>;
+/** Node.js implementation of the JSON reader platform functions. */
+declare const JsonImpl: PlatformFunction[];
+/**
+ * Reading JSON documents that do not fit in memory.
+ *
+ * @remarks
+ * The ingest half of the contract boundary: `jsonSchemaFor(T)` publishes what a
+ * producer must send, and these read it back under exactly that contract. One
+ * element is in flight at a time, whatever the document's size, so the natural
+ * home is an `e3.streamTask` producer that emits as it reads.
+ *
+ * @example
+ * ```ts
+ * const rows = e3.streamTask('rows', {
+ *     inputs: [path],
+ *     output: ArrayType(RowType),
+ * }, ($, p, emit) => {
+ *     const handle = $.let(Json.open(p, "/data"));
+ *     $.while(Json.more(handle), $ => {
+ *         $(emit(Json.next(RowType, handle)));
+ *     });
+ *     $(Json.close(handle));
+ * });
+ * ```
+ */
+export declare const Json: {
+    /**
+     * Opens a JSON file and positions a reader on the container to iterate.
+     *
+     * @param path - The file to read
+     * @param pointer - RFC 6901 pointer to the container, `""` for the whole document
+     * @returns An opaque handle
+     * @throws {EastError} When the file cannot be opened or the pointer does not resolve
+     */
+    readonly open: import("@elaraai/east").PlatformDefinition<[StringType, StringType], StringType>;
+    /**
+     * Opens an in-memory payload, as {@link Json.open} opens a file.
+     *
+     * @param text - The document
+     * @param pointer - RFC 6901 pointer to the container, `""` for the whole document
+     * @returns An opaque handle
+     * @throws {EastError} When the pointer does not resolve
+     */
+    readonly openText: import("@elaraai/east").PlatformDefinition<[StringType, StringType], StringType>;
+    /**
+     * Whether the container has another element.
+     *
+     * @param handle - A handle from {@link Json.open} or {@link Json.openText}
+     * @returns True while elements remain
+     */
+    readonly more: import("@elaraai/east").PlatformDefinition<[StringType], BooleanType>;
+    /**
+     * Reads the next element as `type`.
+     *
+     * @typeParam T - The element's East type
+     * @param type - The type to decode the element as
+     * @param handle - A handle from {@link Json.open} or {@link Json.openText}
+     * @returns The decoded element
+     * @throws {Error} When `type` has no JSON form (at build time)
+     * @throws {EastError} When the element does not satisfy `type`, naming the
+     * RFC 6901 pointer of the offending node
+     */
+    readonly next: <T extends EastType>(type: T, handle: SubtypeExprOrValue<StringType>) => ExprType<T>;
+    /**
+     * Reads one whole value from a file without iterating.
+     *
+     * @typeParam T - The value's East type
+     * @param type - The type to decode the value as
+     * @param path - The file to read
+     * @param pointer - RFC 6901 pointer to the value
+     * @returns The decoded value
+     * @throws {Error} When `type` has no JSON form (at build time)
+     * @throws {EastError} When the value does not satisfy `type`
+     */
+    readonly value: <T extends EastType>(type: T, path: SubtypeExprOrValue<StringType>, pointer: SubtypeExprOrValue<StringType>) => ExprType<T>;
+    /**
+     * Closes a reader and releases its file descriptor.
+     *
+     * @param handle - A handle from {@link Json.open} or {@link Json.openText}
+     * @returns Null
+     */
+    readonly close: import("@elaraai/east").PlatformDefinition<[StringType], NullType>;
+    /**
+     * Node.js implementation of the JSON reader platform functions.
+     *
+     * Pass this to {@link East.compile} to enable them.
+     */
+    readonly Implementation: PlatformFunction[];
+};
+export { JsonImpl };
+export { JsonReadError } from "./json_reader.js";
+//# sourceMappingURL=json.d.ts.map

package/dist/src/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/json.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACG,UAAU,EAAE,QAAQ,EAAE,WAAW,EACvC,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,QAAQ,EAExD,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAuC/D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,kFAAmE,CAAC;AAE1F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,kFAAwE,CAAC;AAEpG;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,uEAAwD,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,SAAS,+FAA8D,CAAC;AAErF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU,2GAA2E,CAAC;AAEnG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,oEAAsD,CAAC;AAE9E,oEAAoE;AACpE,QAAA,MAAM,QAAQ,EAAE,gBAAgB,EAqC/B,CAAC;AASF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,IAAI;IACb;;;;;;;OAOG;;IAGH;;;;;;;OAOG;;IAGH;;;;;OAKG;;IAGH;;;;;;;;;;OAUG;oBACE,CAAC,SAAS,QAAQ,QAAQ,CAAC,UAAU,kBAAkB,CAAC,UAAU,CAAC,KAAG,QAAQ,CAAC,CAAC,CAAC;IAKtF;;;;;;;;;;OAUG;qBACG,CAAC,SAAS,QAAQ,QACd,CAAC,QACD,kBAAkB,CAAC,UAAU,CAAC,WAC3B,kBAAkB,CAAC,UAAU,CAAC,KACxC,QAAQ,CAAC,CAAC,CAAC;IAKd;;;;;OAKG;;IAGH;;;;OAIG;;CAEG,CAAC;AAEX,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}