@elaraai/east-node-std 0.0.1-beta.8 → 1.0.0

package/CLA.md

@@ -23,4 +23,4 @@ You represent that:
 
 ## Agreement
 
-By signing this Agreement through CLA Assistant or by submitting a Contribution, you accept and agree to the terms of this Agreement.
+By signing this Agreement through CLA Assistant or by submitting a Contribution, you accept and agree to the terms of this Agreement.

package/CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Contributing to East
+# Contributing to east-node-std
 
 Thank you for your interest in contributing! We welcome contributions from the community.
 
@@ -15,7 +15,7 @@ When you submit your first pull request, the CLA Assistant bot will automaticall
 
 ## Contributing Process
 
-1. Fork the repository
+1. Fork the [east-workspace monorepo](https://github.com/elaraai/east-workspace)
 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
 3. Make your changes
 4. Commit your changes (`git commit -m 'Add amazing feature'`)
@@ -25,4 +25,4 @@ When you submit your first pull request, the CLA Assistant bot will automaticall
 
 ## Questions?
 
-Contact us at support@elara.ai
+Contact us at support@elara.ai

package/LICENSE.md

@@ -0,0 +1,31 @@
+Copyright (c) 2025 Elara AI Pty Ltd
+
+# Dual License — AGPL-3.0 / Commercial
+
+This software is available under two licenses. You may choose which license applies to your use:
+
+## Option 1: AGPL-3.0 (Open Source)
+
+You may use, modify, and distribute this software under the terms of the GNU Affero General Public License v3.0.
+
+This requires that if you use this software in a network service, you must make your complete source code available under AGPL-3.0.
+
+Full text: https://www.gnu.org/licenses/agpl-3.0.html
+
+## Option 2: Commercial License
+
+If you wish to use this software without the source code disclosure requirements of AGPL-3.0, you must obtain a commercial license from Elara AI Pty Ltd.
+
+Contact: support@elara.ai
+
+## Contributions
+
+Contributions are welcome. By submitting a pull request, you agree to license your contribution under both AGPL-3.0 and our commercial license terms.
+
+## Governing Law
+
+This license is governed by the laws of New South Wales, Australia.
+
+---
+
+*Elara AI Pty Ltd*

package/README.md

@@ -5,19 +5,19 @@
 [![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE.md)
 [![Node Version](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg)](https://nodejs.org)
 
-**East Node** provides Node.js platform integration for the [East language](https://github.com/elaraai/East). It enables East programs to interact with the Node.js runtime through platform functions for file system operations, console I/O, HTTP requests, cryptography, and more.
+**East Node** provides Node.js platform integration for the [East language](https://github.com/elaraai/east-workspace/tree/main/libs/east). It enables East programs to interact with the Node.js runtime through platform functions for file system operations, console I/O, HTTP requests, cryptography, and more.
 
 ## Features
 
 - **📁 File System** - Read/write files, manage directories
 - **🖥️ Console I/O** - stdout/stderr output, stdin input
 - **🌐 HTTP Client** - Modern Fetch API for HTTP requests
-- **🔐 Cryptography** - Random bytes, SHA-256, UUID generation
+- **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
-- **🛡️ Type-Safe** - Full TypeScript support with EastError handling
+- **Type-Safe** - Full TypeScript support with EastError handling
 
 ## Installation
 
@@ -76,7 +76,7 @@ const compiled = East.compile(myFunction.toIR(), [...Console.Implementation, ...
 ## Documentation
 
 - **[USAGE.md](USAGE.md)** - Comprehensive guide with examples for all platform functions
-- **[East Documentation](https://github.com/elaraai/East)** - Core East language documentation
+- **[East Documentation](https://github.com/elaraai/east-workspace/tree/main/libs/east)** - Core East language documentation
 
 ## Testing
 
@@ -114,8 +114,24 @@ Platform functions are intentionally limited for sandbox security:
 
 - ❌ No process access (exit, environment variables, command-line arguments)
 - ❌ No arbitrary command execution
-- ✅ Controlled I/O operations only
-- ✅ All operations are type-checked
+- Controlled I/O operations only
+- All operations are type-checked
+
+## Claude Code plugin
+
+The East ecosystem also ships a [Claude Code](https://claude.com/claude-code) plugin — East language skills, example search, and preemptive diagnostics for East code — installed separately from the `elaraai` marketplace:
+
+```text
+# Inside Claude Code
+/plugin marketplace add elaraai/east-workspace
+/plugin install east@elaraai
+```
+
+```bash
+# From a terminal
+claude plugin marketplace add elaraai/east-workspace
+claude plugin install east@elaraai
+```
 
 ## License
 
@@ -126,31 +142,47 @@ Dual-licensed:
 
 ### Ecosystem
 
-- **[East Node](https://github.com/elaraai/east-node)**: Node.js platform functions for I/O, databases, and system operations. Connect East programs to filesystems, SQL/NoSQL databases, cloud storage, and network services.
-  - [@elaraai/east-node-std](https://www.npmjs.com/package/@elaraai/east-node-std): Filesystem, console, HTTP fetch, crypto, random distributions, timestamps
-  - [@elaraai/east-node-io](https://www.npmjs.com/package/@elaraai/east-node-io): SQLite, PostgreSQL, MySQL, MongoDB, S3, FTP, SFTP
+- **[East](https://github.com/elaraai/east-workspace/tree/main/libs/east)**: Statically typed, expression-based language with serializable IR. Run portable logic across TypeScript, Python, C, and other runtimes.
+  - [@elaraai/east](https://www.npmjs.com/package/@elaraai/east): Core language SDK with type system, expressions, and reference JS compiler
+
+- **[East Node](https://github.com/elaraai/east-workspace/tree/main/libs/east-node)**: Node.js platform functions for I/O, databases, and system operations.
+  - [@elaraai/east-node-std](https://www.npmjs.com/package/@elaraai/east-node-std): Console, FileSystem, Fetch, Crypto, Time, Path, Random
+  - [@elaraai/east-node-io](https://www.npmjs.com/package/@elaraai/east-node-io): SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
   - [@elaraai/east-node-cli](https://www.npmjs.com/package/@elaraai/east-node-cli): CLI for running East IR programs in Node.js
 
-- **[East Python](https://github.com/elaraai/east-py)**: Python runtime and platform functions for data science and machine learning. Execute East programs with access to optimization solvers, gradient boosting, neural networks, and model explainability.
-  - [@elaraai/east-py-datascience](https://www.npmjs.com/package/@elaraai/east-py-datascience): TypeScript types for optimization, gradient boosting, neural networks, explainability
+- **[East C](https://github.com/elaraai/east-workspace/tree/main/libs/east-c)**: C11 native runtime for executing East IR. Tarballed for `linux-x64` and `linux-arm64`, attached to each GitHub Release.
+  - `east-c`: Core runtime — type system, IR interpreter, 200+ builtins, serialization (Beast2, JSON, CSV, East text)
+  - `east-c-std`: Console, FileSystem, Fetch, Crypto, Time, Path, Random
+  - `east-c-cli`: CLI for running East IR programs natively
+
+- **[East Python](https://github.com/elaraai/east-workspace/tree/main/libs/east-py)**: Python runtime, standard platform, I/O, and data-science platform functions. Published to PyPI.
+  - [east-py](https://pypi.org/project/east-py/): Core Python runtime — type system, IR compiler, 212+ builtins, Cython-accelerated hot paths
+  - [east-py-std](https://pypi.org/project/east-py-std/): Console, FileSystem, Fetch, Crypto, Time, Path, Random
+  - [east-py-io](https://pypi.org/project/east-py-io/): SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
+  - [east-py-cli](https://pypi.org/project/east-py-cli/): CLI for running East IR programs in Python
+  - [east-py-datascience](https://pypi.org/project/east-py-datascience/) (PyPI) + [@elaraai/east-py-datascience](https://www.npmjs.com/package/@elaraai/east-py-datascience) (npm): Optimization (MADS, Optuna, ALNS, GoogleOR), ML (XGBoost, LightGBM, NGBoost, PyTorch, Lightning, GP), Bayesian inference (PyMC), explainability (SHAP), conformal prediction (MAPIE)
 
-- **[East UI](https://github.com/elaraai/east-ui)**: East types and expressions for building dashboards and interactive layouts. Define UIs as data structures that render consistently across React, web, and other environments.
+- **[East UI](https://github.com/elaraai/east-workspace/tree/main/libs/east-ui)**: Typed UI component definitions and React renderer, plus VS Code preview.
   - [@elaraai/east-ui](https://www.npmjs.com/package/@elaraai/east-ui): 50+ typed UI components for layouts, forms, charts, tables, dialogs
-  - [@elaraai/east-ui-components](https://www.npmjs.com/package/@elaraai/east-ui-components): React renderer with Chakra UI styling
+  - [@elaraai/east-ui-components](https://www.npmjs.com/package/@elaraai/east-ui-components): React renderer with Chakra UI v3 styling
+  - [@elaraai/e3-ui](https://www.npmjs.com/package/@elaraai/e3-ui): e3 + UI bridge — Data bindings, `e3.ui()` task, manifest
+  - [@elaraai/e3-ui-components](https://www.npmjs.com/package/@elaraai/e3-ui-components): React Query hooks and preview components for the e3 API
+  - [east-ui-preview](https://marketplace.visualstudio.com/items?itemName=ElaraAI.east-ui-preview): VS Code extension for live East UI component preview
 
-- **[e3 - East Execution Engine](https://github.com/elaraai/e3)**: Durable execution engine for running East pipelines at scale. Features Git-like content-addressable storage, automatic memoization, task queuing, and real-time monitoring.
+- **[e3 — East Execution Engine](https://github.com/elaraai/east-workspace/tree/main/libs/e3)**: Durable execution engine for running East pipelines at scale. Git-like content-addressable storage, automatic memoization, reactive dataflow, real-time monitoring.
   - [@elaraai/e3](https://www.npmjs.com/package/@elaraai/e3): SDK for authoring e3 packages with typed tasks and pipelines
-  - [@elaraai/e3-core](https://www.npmjs.com/package/@elaraai/e3-core): Git-like object store, task queue, result caching
+  - [@elaraai/e3-core](https://www.npmjs.com/package/@elaraai/e3-core): Object store, dataflow orchestrator, execution state
   - [@elaraai/e3-types](https://www.npmjs.com/package/@elaraai/e3-types): Shared type definitions for e3 packages
-  - [@elaraai/e3-cli](https://www.npmjs.com/package/@elaraai/e3-cli): `e3 init`, `e3 run`, `e3 logs` commands for managing and monitoring tasks
-  - [@elaraai/e3-api-client](https://www.npmjs.com/package/@elaraai/e3-api-client): HTTP client for remote e3 servers
+  - [@elaraai/e3-cli](https://www.npmjs.com/package/@elaraai/e3-cli): `e3 repo`, `e3 package`, `e3 workspace`, `e3 start`, `e3 watch`, `e3 logs` commands
+  - [@elaraai/e3-api-client](https://www.npmjs.com/package/@elaraai/e3-api-client): HTTP client for remote e3 repositories
   - [@elaraai/e3-api-server](https://www.npmjs.com/package/@elaraai/e3-api-server): REST API server for e3 repositories
+  - [@elaraai/e3-api-tests](https://www.npmjs.com/package/@elaraai/e3-api-tests): Shared API compliance test suites
 
 ## Links
 
 - **Website**: [https://elaraai.com/](https://elaraai.com/)
-- **East Repository**: [https://github.com/elaraai/East](https://github.com/elaraai/East)
-- **Issues**: [https://github.com/elaraai/east-node/issues](https://github.com/elaraai/east-node/issues)
+- **East Repository**: [https://github.com/elaraai/east-workspace/tree/main/libs/east](https://github.com/elaraai/east-workspace/tree/main/libs/east)
+- **Issues**: [https://github.com/elaraai/east-workspace/issues](https://github.com/elaraai/east-workspace/issues)
 - **Email**: support@elara.ai
 
 ## About Elara
@@ -159,4 +191,8 @@ East is developed by [Elara AI Pty Ltd](https://elaraai.com/), an AI-powered pla
 
 ---
 
+*Developed by [Elara AI Pty Ltd](https://elaraai.com/).*
+
+---
+
 *Developed by [Elara AI Pty Ltd](https://elaraai.com/)*

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

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/console.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,WAAW,oEAAuD,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa,oEAAyD,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa,oEAAyD,CAAC;AAEpF;;;;GAIG;AACH,QAAA,MAAM,WAAW,EAAE,gBAAgB,EA+BlC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,OAAO;IAChB;;;;;;;;;;;;;;;;;;;OAmBG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;IAGH;;;;;;;;;;;;;;;;;;;;OAoBG;;IAGH;;;;OAIG;;CAEG,CAAC;AAGX,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/{console.js → src/console.js}

@@ -84,7 +84,7 @@ const ConsoleImpl = [
         }
         catch (err) {
             throw new EastError(`Failed to write to stdout: ${err.message}`, {
-                location: { filename: "console_log", line: 0n, column: 0n },
+                location: [{ filename: "console_log", line: 0n, column: 0n }],
                 cause: err
             });
         }
@@ -95,7 +95,7 @@ const ConsoleImpl = [
         }
         catch (err) {
             throw new EastError(`Failed to write to stderr: ${err.message}`, {
-                location: { filename: "console_error", line: 0n, column: 0n },
+                location: [{ filename: "console_error", line: 0n, column: 0n }],
                 cause: err
             });
         }
@@ -106,7 +106,7 @@ const ConsoleImpl = [
         }
         catch (err) {
             throw new EastError(`Failed to write to stdout: ${err.message}`, {
-                location: { filename: "console_write", line: 0n, column: 0n },
+                location: [{ filename: "console_write", line: 0n, column: 0n }],
                 cause: err
             });
         }

package/dist/src/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../src/console.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;AAEpF;;;;GAIG;AACH,MAAM,WAAW,GAAuB;IACpC,WAAW,CAAC,SAAS,CAAC,CAAC,GAAW,EAAE,EAAE;QAClC,IAAI,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,SAAS,CAAC,8BAA8B,GAAG,CAAC,OAAO,EAAE,EAAE;gBAC7D,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBAC7D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IACF,aAAa,CAAC,SAAS,CAAC,CAAC,GAAW,EAAE,EAAE;QACpC,IAAI,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,SAAS,CAAC,8BAA8B,GAAG,CAAC,OAAO,EAAE,EAAE;gBAC7D,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBAC/D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IACF,aAAa,CAAC,SAAS,CAAC,CAAC,GAAW,EAAE,EAAE;QACpC,IAAI,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,SAAS,CAAC,8BAA8B,GAAG,CAAC,OAAO,EAAE,EAAE;gBAC7D,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBAC/D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;CACL,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACnB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,EAAE,WAAW;IAEhB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,EAAE,aAAa;IAEpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,EAAE,aAAa;IAEpB;;;;OAIG;IACH,cAAc,EAAE,WAAW;CACrB,CAAC;AAEX,qCAAqC;AACrC,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;;;;;;;;;;;;;;;;GAkBG"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/crypto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB,qEAAgE,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,kBAAkB,sEAAgE,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,wBAAwB,kEAAkE,CAAC;AAExG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,WAAW,4DAA+C,CAAC;AACxE;;;;GAIG;AACH,QAAA,MAAM,UAAU,EAAE,gBAAgB,EAyCjC,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM;IACf;;;;;;;;;;;;;;;;;;;OAmBG;;IAGH;;;;;;;;;;;;;;;;;;OAkBG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;IAGH;;;;;;;;;;;;;;;;;OAiBG;;IAGH;;;;OAIG;;CAEG,CAAC;AAGX,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/{crypto.js → src/crypto.js}

@@ -108,7 +108,7 @@ const CryptoImpl = [
         }
         catch (err) {
             throw new EastError(`Failed to generate random bytes: ${err.message}`, {
-                location: { filename: "crypto_random_bytes", line: 0n, column: 0n },
+                location: [{ filename: "crypto_random_bytes", line: 0n, column: 0n }],
                 cause: err
             });
         }
@@ -119,7 +119,7 @@ const CryptoImpl = [
         }
         catch (err) {
             throw new EastError(`Failed to compute SHA-256 hash: ${err.message}`, {
-                location: { filename: "crypto_hash_sha256", line: 0n, column: 0n },
+                location: [{ filename: "crypto_hash_sha256", line: 0n, column: 0n }],
                 cause: err
             });
         }
@@ -130,7 +130,7 @@ const CryptoImpl = [
         }
         catch (err) {
             throw new EastError(`Failed to compute SHA-256 hash: ${err.message}`, {
-                location: { filename: "crypto_hash_sha256_bytes", line: 0n, column: 0n },
+                location: [{ filename: "crypto_hash_sha256_bytes", line: 0n, column: 0n }],
                 cause: err
             });
         }
@@ -141,7 +141,7 @@ const CryptoImpl = [
         }
         catch (err) {
             throw new EastError(`Failed to generate UUID: ${err.message}`, {
-                location: { filename: "crypto_uuid", line: 0n, column: 0n },
+                location: [{ filename: "crypto_uuid", line: 0n, column: 0n }],
                 cause: err
             });
         }

package/dist/src/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../src/crypto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,QAAQ,CAAC,0BAA0B,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;AAExG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;AACxE;;;;GAIG;AACH,MAAM,UAAU,GAAuB;IACnC,mBAAmB,CAAC,SAAS,CAAC,CAAC,MAAc,EAAE,EAAE;QAC7C,IAAI,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,SAAS,CAAC,oCAAoC,GAAG,CAAC,OAAO,EAAE,EAAE;gBACnE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,qBAAqB,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBACrE,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IACF,kBAAkB,CAAC,SAAS,CAAC,CAAC,IAAY,EAAE,EAAE;QAC1C,IAAI,CAAC;YACD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,SAAS,CAAC,mCAAmC,GAAG,CAAC,OAAO,EAAE,EAAE;gBAClE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBACpE,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IACF,wBAAwB,CAAC,SAAS,CAAC,CAAC,IAAgB,EAAE,EAAE;QACpD,IAAI,CAAC;YACD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACtD,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,SAAS,CAAC,mCAAmC,GAAG,CAAC,OAAO,EAAE,EAAE;gBAClE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,0BAA0B,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBAC1E,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IACF,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE;QACvB,IAAI,CAAC;YACD,OAAO,UAAU,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,SAAS,CAAC,4BAA4B,GAAG,CAAC,OAAO,EAAE,EAAE;gBAC3D,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBAC7D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;CACL,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAAW,EAAE,mBAAmB;IAEhC;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,EAAE,kBAAkB;IAE9B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,EAAE,wBAAwB;IAEzC;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,EAAE,WAAW;IAEjB;;;;OAIG;IACH,cAAc,EAAE,UAAU;CACpB,CAAC;AAEX,qCAAqC;AACrC,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/{fetch.d.ts → src/fetch.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, IntegerType, BooleanType, DictType, OptionType, VariantType, NullType, StructType } from "@elaraai/east";
+import { StringType, IntegerType, BooleanType, DictType, OptionType, VariantType, NullType, StructType, BlobType } from "@elaraai/east";
 import type { PlatformFunction } from "@elaraai/east/internal";
 /**
  * HTTP method variant type.
@@ -11,13 +11,13 @@ import type { PlatformFunction } from "@elaraai/east/internal";
  * Supports standard HTTP methods: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS.
  */
 export declare const FetchMethod: VariantType<{
-    GET: NullType;
-    POST: NullType;
-    PUT: NullType;
-    DELETE: NullType;
-    PATCH: NullType;
-    HEAD: NullType;
-    OPTIONS: NullType;
+    readonly GET: NullType;
+    readonly POST: NullType;
+    readonly PUT: NullType;
+    readonly DELETE: NullType;
+    readonly PATCH: NullType;
+    readonly HEAD: NullType;
+    readonly OPTIONS: NullType;
 }>;
 /**
  * HTTP request configuration structure.
@@ -26,18 +26,18 @@ export declare const FetchMethod: VariantType<{
  * headers, and optional body content.
  */
 export declare const FetchRequestConfig: StructType<{
-    url: StringType;
-    method: VariantType<{
-        GET: NullType;
-        POST: NullType;
-        PUT: NullType;
-        DELETE: NullType;
-        PATCH: NullType;
-        HEAD: NullType;
-        OPTIONS: NullType;
+    readonly url: StringType;
+    readonly method: VariantType<{
+        readonly GET: NullType;
+        readonly POST: NullType;
+        readonly PUT: NullType;
+        readonly DELETE: NullType;
+        readonly PATCH: NullType;
+        readonly HEAD: NullType;
+        readonly OPTIONS: NullType;
     }>;
-    headers: DictType<StringType, StringType>;
-    body: OptionType<StringType>;
+    readonly headers: DictType<StringType, StringType>;
+    readonly body: OptionType<StringType>;
 }>;
 /**
  * HTTP response structure.
@@ -46,11 +46,11 @@ export declare const FetchRequestConfig: StructType<{
  * The `ok` field is true for status codes in the 200-299 range.
  */
 export declare const FetchResponse: StructType<{
-    status: IntegerType;
-    statusText: StringType;
-    headers: DictType<StringType, StringType>;
-    body: StringType;
-    ok: BooleanType;
+    readonly status: IntegerType;
+    readonly statusText: StringType;
+    readonly headers: DictType<StringType, StringType>;
+    readonly body: StringType;
+    readonly ok: BooleanType;
 }>;
 /**
  * Performs an HTTP GET request and returns the response body as a string.
@@ -79,6 +79,34 @@ export declare const FetchResponse: StructType<{
  * ```
  */
 export declare const fetch_get: import("@elaraai/east").AsyncPlatformDefinition<[StringType], StringType>;
+/**
+ * Performs an HTTP GET request and returns the response body as binary data.
+ *
+ * Makes a simple GET request to the specified URL and returns the response body
+ * as raw bytes (Blob/Uint8Array). Useful for downloading binary files like images,
+ * PDFs, or database files.
+ * Throws an error if the response status is not in the 200-299 range.
+ *
+ * This is a platform function for the East language, enabling binary HTTP GET requests
+ * in East programs running on Node.js.
+ *
+ * @param url - The URL to fetch (must be a valid HTTP/HTTPS URL)
+ * @returns The response body as binary data (Blob)
+ *
+ * @throws {EastError} When request fails:
+ * - Invalid URL
+ * - Network error
+ * - Non-2xx HTTP status code
+ *
+ * @example
+ * ```ts
+ * const downloadFile = East.function([], BlobType, $ => {
+ *     const data = $.let(Fetch.getBytes("https://example.com/file.bin"));
+ *     return data;
+ * });
+ * ```
+ */
+export declare const fetch_get_bytes: import("@elaraai/east").AsyncPlatformDefinition<[StringType], BlobType>;
 /**
  * Performs an HTTP POST request with a string body.
  *
@@ -138,24 +166,24 @@ export declare const fetch_post: import("@elaraai/east").AsyncPlatformDefinition
  * ```
  */
 export declare const fetch_request: import("@elaraai/east").AsyncPlatformDefinition<[StructType<{
-    url: StringType;
-    method: VariantType<{
-        GET: NullType;
-        POST: NullType;
-        PUT: NullType;
-        DELETE: NullType;
-        PATCH: NullType;
-        HEAD: NullType;
-        OPTIONS: NullType;
+    readonly url: StringType;
+    readonly method: VariantType<{
+        readonly GET: NullType;
+        readonly POST: NullType;
+        readonly PUT: NullType;
+        readonly DELETE: NullType;
+        readonly PATCH: NullType;
+        readonly HEAD: NullType;
+        readonly OPTIONS: NullType;
     }>;
-    headers: DictType<StringType, StringType>;
-    body: OptionType<StringType>;
+    readonly headers: DictType<StringType, StringType>;
+    readonly body: OptionType<StringType>;
 }>], StructType<{
-    status: IntegerType;
-    statusText: StringType;
-    headers: DictType<StringType, StringType>;
-    body: StringType;
-    ok: BooleanType;
+    readonly status: IntegerType;
+    readonly statusText: StringType;
+    readonly headers: DictType<StringType, StringType>;
+    readonly body: StringType;
+    readonly ok: BooleanType;
 }>>;
 /**
  * Node.js implementation of fetch platform functions.
@@ -204,6 +232,28 @@ export declare const Fetch: {
      * ```
      */
     readonly get: import("@elaraai/east").AsyncPlatformDefinition<[StringType], StringType>;
+    /**
+     * Performs an HTTP GET request and returns the response body as binary data.
+     *
+     * Makes a simple GET request to the specified URL and returns the response body
+     * as raw bytes (Blob/Uint8Array). Useful for downloading binary files.
+     * Throws an error if the response status is not in the 200-299 range.
+     *
+     * @param url - The URL to fetch
+     * @returns The response body as binary data (Blob)
+     * @throws {EastError} When request fails or status is not 2xx
+     *
+     * @example
+     * ```ts
+     * const downloadFile = East.function([], BlobType, $ => {
+     *     return Fetch.getBytes("https://example.com/file.bin");
+     * });
+     *
+     * const compiled = await East.compileAsync(downloadFile.toIR(), Fetch.Implementation);
+     * await compiled();  // Returns: binary data as Uint8Array
+     * ```
+     */
+    readonly getBytes: import("@elaraai/east").AsyncPlatformDefinition<[StringType], BlobType>;
     /**
      * Performs an HTTP POST request with a string body.
      *
@@ -255,24 +305,24 @@ export declare const Fetch: {
      * ```
      */
     readonly request: import("@elaraai/east").AsyncPlatformDefinition<[StructType<{
-        url: StringType;
-        method: VariantType<{
-            GET: NullType;
-            POST: NullType;
-            PUT: NullType;
-            DELETE: NullType;
-            PATCH: NullType;
-            HEAD: NullType;
-            OPTIONS: NullType;
+        readonly url: StringType;
+        readonly method: VariantType<{
+            readonly GET: NullType;
+            readonly POST: NullType;
+            readonly PUT: NullType;
+            readonly DELETE: NullType;
+            readonly PATCH: NullType;
+            readonly HEAD: NullType;
+            readonly OPTIONS: NullType;
         }>;
-        headers: DictType<StringType, StringType>;
-        body: OptionType<StringType>;
+        readonly headers: DictType<StringType, StringType>;
+        readonly body: OptionType<StringType>;
     }>], StructType<{
-        status: IntegerType;
-        statusText: StringType;
-        headers: DictType<StringType, StringType>;
-        body: StringType;
-        ok: BooleanType;
+        readonly status: IntegerType;
+        readonly statusText: StringType;
+        readonly headers: DictType<StringType, StringType>;
+        readonly body: StringType;
+        readonly ok: BooleanType;
     }>>;
     /**
      * Node.js implementation of fetch platform functions.
@@ -288,40 +338,40 @@ export declare const Fetch: {
          * HTTP method variant type (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS).
          */
         readonly Method: VariantType<{
-            GET: NullType;
-            POST: NullType;
-            PUT: NullType;
-            DELETE: NullType;
-            PATCH: NullType;
-            HEAD: NullType;
-            OPTIONS: NullType;
+            readonly GET: NullType;
+            readonly POST: NullType;
+            readonly PUT: NullType;
+            readonly DELETE: NullType;
+            readonly PATCH: NullType;
+            readonly HEAD: NullType;
+            readonly OPTIONS: NullType;
         }>;
         /**
          * HTTP request configuration structure.
          */
         readonly RequestConfig: StructType<{
-            url: StringType;
-            method: VariantType<{
-                GET: NullType;
-                POST: NullType;
-                PUT: NullType;
-                DELETE: NullType;
-                PATCH: NullType;
-                HEAD: NullType;
-                OPTIONS: NullType;
+            readonly url: StringType;
+            readonly method: VariantType<{
+                readonly GET: NullType;
+                readonly POST: NullType;
+                readonly PUT: NullType;
+                readonly DELETE: NullType;
+                readonly PATCH: NullType;
+                readonly HEAD: NullType;
+                readonly OPTIONS: NullType;
             }>;
-            headers: DictType<StringType, StringType>;
-            body: OptionType<StringType>;
+            readonly headers: DictType<StringType, StringType>;
+            readonly body: OptionType<StringType>;
         }>;
         /**
          * HTTP response structure.
          */
         readonly Response: StructType<{
-            status: IntegerType;
-            statusText: StringType;
-            headers: DictType<StringType, StringType>;
-            body: StringType;
-            ok: BooleanType;
+            readonly status: IntegerType;
+            readonly statusText: StringType;
+            readonly headers: DictType<StringType, StringType>;
+            readonly body: StringType;
+            readonly ok: BooleanType;
         }>;
     };
 };

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/fetch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAA+B,MAAM,eAAe,CAAC;AAC3K,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;EAQtB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;EAK7B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;EAMxB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,SAAS,2EAA4D,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,eAAe,yEAAgE,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,UAAU,uFAAyE,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;GAA2E,CAAC;AAEtG;;;;GAIG;AACH,QAAA,MAAM,SAAS,EAAE,gBAAgB,EAiGhC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,KAAK;IACd;;;;;;;;;;;;;;;;;;;OAmBG;;IAGH;;;;;;;;;;;;;;;;;;;;OAoBG;;IAGH;;;;;;;;;;;;;;;;;;;;;OAqBG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;;;;;;;;;;;;;;;;;;;;;IAGH;;;;OAIG;;IAGH;;OAEG;;QAEC;;WAEG;;;;;;;;;;QAGH;;WAEG;;;;;;;;;;;;;;;QAGH;;WAEG;;;;;;;;;CAGD,CAAC;AAGX,OAAO,EAAE,SAAS,EAAE,CAAC"}