@elaraai/east-web-std 1.0.85

package/dist/src/fetch.js

@@ -0,0 +1,412 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { East, StringType, IntegerType, BooleanType, DictType, OptionType, VariantType, NullType, StructType, BlobType, SortedMap, compareFor } from "@elaraai/east";
+import { EastError } from "@elaraai/east/internal";
+/**
+ * HTTP method variant type.
+ *
+ * Represents the HTTP request method for fetch operations.
+ * Supports standard HTTP methods: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS.
+ */
+export const FetchMethod = VariantType({
+    GET: NullType,
+    POST: NullType,
+    PUT: NullType,
+    DELETE: NullType,
+    PATCH: NullType,
+    HEAD: NullType,
+    OPTIONS: NullType,
+});
+/**
+ * HTTP request configuration structure.
+ *
+ * Complete configuration for making HTTP requests with custom methods,
+ * headers, and optional body content.
+ */
+export const FetchRequestConfig = StructType({
+    url: StringType,
+    method: FetchMethod,
+    headers: DictType(StringType, StringType),
+    body: OptionType(StringType),
+});
+/**
+ * HTTP response structure.
+ *
+ * Complete HTTP response including status code, headers, body, and success indicator.
+ * The `ok` field is true for status codes in the 200-299 range.
+ */
+export const FetchResponse = StructType({
+    status: IntegerType,
+    statusText: StringType,
+    headers: DictType(StringType, StringType),
+    body: StringType,
+    ok: BooleanType,
+});
+/** Orders response header names as East orders its Strings. */
+const compareHeaderNames = compareFor(StringType);
+/**
+ * Performs an HTTP GET request and returns the response body as a string.
+ *
+ * Makes a simple GET request to the specified URL and returns the response body text.
+ * This is a convenience function for basic GET requests without custom headers.
+ * Throws an error if the response status is not in the 200-299 range.
+ *
+ * This is a platform function for the East language, enabling HTTP GET requests
+ * in East programs running in a browser, through the browser's `fetch`.
+ *
+ * @param url - The URL to fetch (must be a valid HTTP/HTTPS URL)
+ * @returns The response body as a string
+ *
+ * @throws {EastError} When request fails:
+ * - Invalid URL
+ * - Network error, or a cross-origin request the server's CORS headers refuse
+ * - Non-2xx HTTP status code
+ *
+ * @example
+ * ```ts
+ * const fetchData = East.function([], StringType, $ => {
+ *     const data = $.let(Fetch.get("https://api.example.com/data"));
+ *     return data;
+ * });
+ * ```
+ */
+export const fetch_get = East.asyncPlatform("fetch_get", [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 in a browser, through the browser's `fetch`.
+ *
+ * @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, or a cross-origin request the server's CORS headers refuse
+ * - 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 const fetch_get_bytes = East.asyncPlatform("fetch_get_bytes", [StringType], BlobType);
+/**
+ * Performs an HTTP POST request with a string body.
+ *
+ * Makes a POST request to the specified URL with the provided string body.
+ * Sets Content-Type header to "text/plain" by default. For more control over
+ * headers and methods, use {@link fetch_request}.
+ * Throws an error if the response status is not in the 200-299 range.
+ *
+ * This is a platform function for the East language, enabling HTTP POST requests
+ * in East programs running in a browser, through the browser's `fetch`.
+ *
+ * @param url - The URL to post to (must be a valid HTTP/HTTPS URL)
+ * @param body - The request body as a string
+ * @returns The response body as a string
+ *
+ * @throws {EastError} When request fails:
+ * - Invalid URL
+ * - Network error, or a cross-origin request the server's CORS headers refuse
+ * - Non-2xx HTTP status code
+ *
+ * @example
+ * ```ts
+ * const postData = East.function([], StringType, $ => {
+ *     const response = $.let(Fetch.post("https://api.example.com/submit", "data"));
+ *     return response;
+ * });
+ * ```
+ */
+export const fetch_post = East.asyncPlatform("fetch_post", [StringType, StringType], StringType);
+/**
+ * Performs a full HTTP request with custom configuration.
+ *
+ * Makes an HTTP request with complete control over method, headers, and body.
+ * Returns the full response including status, headers, and body. Unlike {@link fetch_get}
+ * and {@link fetch_post}, this does not throw on non-2xx status codes - check the `ok`
+ * field in the response instead.
+ *
+ * This is a platform function for the East language, enabling full HTTP requests
+ * in East programs running in a browser, through the browser's `fetch`.
+ *
+ * @param config - The request configuration (url, method, headers, optional body)
+ * @returns The complete HTTP response with status, headers, and body
+ *
+ * @throws {EastError} When request fails at the network level (not for HTTP errors)
+ *
+ * @example
+ * ```ts
+ * const makeRequest = East.function([], FetchResponse, $ => {
+ *     const config = $.let({
+ *         url: "https://api.example.com/data",
+ *         method: variant("GET", null),
+ *         headers: new Map([["Authorization", "Bearer token"]]),
+ *         body: none,
+ *     }, FetchRequestConfig);
+ *     return Fetch.request(config);
+ * });
+ * ```
+ *
+ * @remarks
+ * A browser sends a request only with the headers it allows a page to set,
+ * and a cross-origin response shows only the headers its server exposes.
+ */
+export const fetch_request = East.asyncPlatform("fetch_request", [FetchRequestConfig], FetchResponse);
+/**
+ * Browser implementation of fetch platform functions.
+ *
+ * Pass this array to {@link East.compileAsync} to enable fetch operations.
+ */
+const FetchImpl = [
+    fetch_get.implement(async (url) => {
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new EastError(`HTTP ${response.status}: ${response.statusText}`, {
+                    location: [{ filename: "fetch_get", line: 0n, column: 0n }]
+                });
+            }
+            return await response.text();
+        }
+        catch (err) {
+            if (err instanceof EastError)
+                throw err;
+            throw new EastError(`Failed to fetch ${url}: ${err.message}`, {
+                location: [{ filename: "fetch_get", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+    fetch_get_bytes.implement(async (url) => {
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new EastError(`HTTP ${response.status}: ${response.statusText}`, {
+                    location: [{ filename: "fetch_get_bytes", line: 0n, column: 0n }]
+                });
+            }
+            const arrayBuffer = await response.arrayBuffer();
+            return new Uint8Array(arrayBuffer);
+        }
+        catch (err) {
+            if (err instanceof EastError)
+                throw err;
+            throw new EastError(`Failed to fetch ${url}: ${err.message}`, {
+                location: [{ filename: "fetch_get_bytes", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+    fetch_post.implement(async (url, body) => {
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                body: body,
+                headers: {
+                    'Content-Type': 'text/plain',
+                },
+            });
+            if (!response.ok) {
+                throw new EastError(`HTTP ${response.status}: ${response.statusText}`, {
+                    location: [{ filename: "fetch_post", line: 0n, column: 0n }]
+                });
+            }
+            return await response.text();
+        }
+        catch (err) {
+            if (err instanceof EastError)
+                throw err;
+            throw new EastError(`Failed to post to ${url}: ${err.message}`, {
+                location: [{ filename: "fetch_post", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+    fetch_request.implement(async (config) => {
+        const url = config.url;
+        const method = config.method.type; // The variant's tag names the method
+        const headers = {};
+        // Convert the Dict to a plain object
+        for (const [key, value] of config.headers) {
+            headers[key] = value;
+        }
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: config.body.type === "some" ? config.body.value : null,
+            });
+            const responseHeaders = new SortedMap([], compareHeaderNames);
+            response.headers.forEach((value, key) => {
+                responseHeaders.set(key, value);
+            });
+            const body = await response.text();
+            return {
+                status: BigInt(response.status),
+                statusText: response.statusText,
+                headers: responseHeaders,
+                body,
+                ok: response.ok,
+            };
+        }
+        catch (err) {
+            throw new EastError(`Failed to fetch ${url}: ${err.message}`, {
+                location: [{ filename: "fetch_request", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+];
+/**
+ * Grouped fetch platform functions.
+ *
+ * Provides HTTP client operations using the browser's fetch API.
+ *
+ * @example
+ * ```ts
+ * import { East, StringType } from "@elaraai/east";
+ * import { Fetch } from "@elaraai/east-web-std";
+ *
+ * const getData = East.function([], StringType, $ => {
+ *     const response = $.let(Fetch.get("https://api.example.com/data"));
+ *     return response;
+ * });
+ *
+ * const compiled = await East.compileAsync(getData.toIR(), Fetch.Implementation);
+ * await compiled();  // Returns response body as string
+ * ```
+ */
+export const Fetch = {
+    /**
+     * Performs an HTTP GET request and returns the response body.
+     *
+     * Makes a simple GET request to the specified URL and returns the response body text.
+     * 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 a string
+     * @throws {EastError} When request fails or status is not 2xx
+     *
+     * @example
+     * ```ts
+     * const fetchData = East.function([], StringType, $ => {
+     *     return Fetch.get("https://api.example.com/data");
+     * });
+     *
+     * const compiled = await East.compileAsync(fetchData.toIR(), Fetch.Implementation);
+     * await compiled();  // Returns: response body as string
+     * ```
+     */
+    get: fetch_get,
+    /**
+     * 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
+     * ```
+     */
+    getBytes: fetch_get_bytes,
+    /**
+     * Performs an HTTP POST request with a string body.
+     *
+     * Makes a POST request to the specified URL with the provided string body.
+     * Sets Content-Type to "text/plain" by default.
+     * Throws an error if the response status is not in the 200-299 range.
+     *
+     * @param url - The URL to post to
+     * @param body - The request body as a string
+     * @returns The response body as a string
+     * @throws {EastError} When request fails or status is not 2xx
+     *
+     * @example
+     * ```ts
+     * const postData = East.function([], StringType, $ => {
+     *     return Fetch.post("https://api.example.com/submit", "data");
+     * });
+     *
+     * const compiled = await East.compileAsync(postData.toIR(), Fetch.Implementation);
+     * await compiled();  // Returns: response body as string
+     * ```
+     */
+    post: fetch_post,
+    /**
+     * Performs a full HTTP request with custom configuration.
+     *
+     * Makes an HTTP request with complete control over method, headers, and body.
+     * Returns the full response including status, headers, and body.
+     * Does not throw on non-2xx status - check the `ok` field instead.
+     *
+     * @param config - The request configuration
+     * @returns The complete HTTP response
+     * @throws {EastError} When request fails at the network level
+     *
+     * @example
+     * ```ts
+     * const makeRequest = East.function([], FetchResponse, $ => {
+     *     const config = $.let({
+     *         url: "https://api.example.com/data",
+     *         method: variant("GET", null),
+     *         headers: new Map(),
+     *         body: none,
+     *     }, FetchRequestConfig);
+     *     return Fetch.request(config);
+     * });
+     *
+     * const compiled = await East.compileAsync(makeRequest.toIR(), Fetch.Implementation);
+     * const response = await compiled();  // Returns: FetchResponse object
+     * ```
+     */
+    request: fetch_request,
+    /**
+     * Browser implementation of fetch platform functions.
+     *
+     * Pass this to {@link East.compileAsync} to enable fetch operations.
+     */
+    Implementation: FetchImpl,
+    /**
+     * Type definitions for fetch operations.
+     */
+    Types: {
+        /**
+         * HTTP method variant type (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS).
+         */
+        Method: FetchMethod,
+        /**
+         * HTTP request configuration structure.
+         */
+        RequestConfig: FetchRequestConfig,
+        /**
+         * HTTP response structure.
+         */
+        Response: FetchResponse,
+    },
+};
+// Exported beside `Fetch.Implementation`, as east-node-std exports it
+export { FetchImpl };
+//# sourceMappingURL=fetch.js.map

package/dist/src/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/fetch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAoB,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvL,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;IACnC,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,QAAQ;IACd,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,QAAQ;CACpB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;IACzC,GAAG,EAAE,UAAU;IACf,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IACzC,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC;CAC/B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACpC,MAAM,EAAE,WAAW;IACnB,UAAU,EAAE,UAAU;IACtB,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IACzC,IAAI,EAAE,UAAU;IAChB,EAAE,EAAE,WAAW;CAClB,CAAC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,kBAAkB,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC,kBAAkB,CAAC,EAAE,aAAa,CAAC,CAAC;AAEtG;;;;GAIG;AACH,MAAM,SAAS,GAAuB;IAClC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;QACtC,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,SAAS,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,EAAE;oBACnE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;iBAC9D,CAAC,CAAC;YACP,CAAC;YACD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,GAAG,YAAY,SAAS;gBAAE,MAAM,GAAG,CAAC;YACxC,MAAM,IAAI,SAAS,CAAC,mBAAmB,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE;gBAC1D,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBAC3D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IACF,eAAe,CAAC,SAAS,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;QAC5C,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,SAAS,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,EAAE;oBACnE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;iBACpE,CAAC,CAAC;YACP,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;YACjD,OAAO,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,GAAG,YAAY,SAAS;gBAAE,MAAM,GAAG,CAAC;YACxC,MAAM,IAAI,SAAS,CAAC,mBAAmB,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE;gBAC1D,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBACjE,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IACF,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,GAAW,EAAE,IAAY,EAAE,EAAE;QACrD,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC9B,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE;oBACL,cAAc,EAAE,YAAY;iBAC/B;aACJ,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,SAAS,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,EAAE;oBACnE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;iBAC/D,CAAC,CAAC;YACP,CAAC;YACD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,GAAG,YAAY,SAAS;gBAAE,MAAM,GAAG,CAAC;YACxC,MAAM,IAAI,SAAS,CAAC,qBAAqB,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE;gBAC5D,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;gBAC5D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IACF,aAAa,CAAC,SAAS,CAAC,KAAK,EAAE,MAA8C,EAAE,EAAE;QAC7E,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,qCAAqC;QACxE,MAAM,OAAO,GAA2B,EAAE,CAAC;QAE3C,qCAAqC;QACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;QAED,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC9B,MAAM;gBACN,OAAO;gBACP,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;aAC/D,CAAC,CAAC;YAEH,MAAM,eAAe,GAAG,IAAI,SAAS,CAAiB,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAC9E,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACpC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEnC,OAAO;gBACH,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO,EAAE,eAAe;gBACxB,IAAI;gBACJ,EAAE,EAAE,QAAQ,CAAC,EAAE;aAClB,CAAC;QACN,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,SAAS,CAAC,mBAAmB,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE;gBAC1D,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;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACjB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,EAAE,SAAS;IAEd;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,EAAE,eAAe;IAEzB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,EAAE,UAAU;IAEhB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAO,EAAE,aAAa;IAEtB;;;;OAIG;IACH,cAAc,EAAE,SAAS;IAEzB;;OAEG;IACH,KAAK,EAAE;QACH;;WAEG;QACH,MAAM,EAAE,WAAW;QAEnB;;WAEG;QACH,aAAa,EAAE,kBAAkB;QAEjC;;WAEG;QACH,QAAQ,EAAE,aAAa;KAC1B;CACK,CAAC;AAEX,sEAAsE;AACtE,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * East Web - the standard platform functions for East programs in a browser.
+ *
+ * The same platform functions, under the same names and East types, as
+ * east-node-std's Console, Time, Random, Crypto, Fetch, Path and Test, so an
+ * East program written for Node runs in a browser unchanged. It reaches no
+ * Node module: only web-standard globals.
+ *
+ * FileSystem, Env and the large-JSON reader have no browser meaning and are
+ * not provided: a program that calls one fails to compile, naming the
+ * platform function it called.
+ *
+ * @packageDocumentation
+ */
+import type { PlatformFunction } from "@elaraai/east/internal";
+export * from "./test.js";
+export * from "./console.js";
+export * from "./path.js";
+export * from "./crypto.js";
+export * from "./time.js";
+export * from "./fetch.js";
+export * from "./random.js";
+import { type ConsoleSink } from "./console.js";
+import { type TestHost } from "./test.js";
+/**
+ * What a host gives the platform it runs a program on.
+ */
+export interface WebPlatformOptions {
+    /**
+     * Where the program's console output goes: the host's standard output and
+     * standard error. Defaults to the global `console`
+     * ({@link globalConsoleSink}).
+     */
+    console?: ConsoleSink;
+    /**
+     * Runs the suites and tests an East test program declares. Defaults to
+     * running them in place (see {@link TestImpl}).
+     */
+    test?: TestHost;
+    /**
+     * Stops the program's waits, for a host that stops a program without
+     * ending its thread: once it aborts, a `Time.sleep` under way fails at
+     * once, its timer cleared — nothing the program left keeps its thread's
+     * event loop alive — and a later one fails as it starts. Unset, a sleep
+     * ends once its time has passed, or with its thread.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Creates a complete browser platform for one program.
+ *
+ * The platform holds east-node-std's platform functions that mean the same in
+ * a browser — Console, Path, Crypto, Time, Fetch, Random and Test — writing
+ * console output to the host's sink and running tests through its host, its
+ * sleeps stopped by the host's signal when it gives one. Random starts
+ * unseeded, with a generator no other platform shares.
+ *
+ * @param options - The host's console sink, test host and signal
+ * @returns The platform functions, to pass to `compile()` or `compileAsync()`
+ *
+ * @example
+ * ```ts
+ * import { East, NullType } from "@elaraai/east";
+ * import { Console, createWebPlatform } from "@elaraai/east-web-std";
+ *
+ * let stdout = "";
+ * const fn = East.asyncFunction([], NullType, $ => {
+ *     $(Console.log("Hello from a browser"));
+ * });
+ *
+ * const platform = createWebPlatform({
+ *     console: { stdout: text => { stdout += text; }, stderr: text => { stdout += text; } },
+ * });
+ * await fn.toIR().compile(platform)();  // stdout is now "Hello from a browser\n"
+ * ```
+ */
+export declare function createWebPlatform(options?: WebPlatformOptions): PlatformFunction[];
+/**
+ * Complete browser platform implementation.
+ *
+ * Pass this array to `compile()` or `compileAsync()` to enable all the
+ * browser's platform functions. Console output goes to the global `console`,
+ * tests run in place, and every program compiled with it shares one Random
+ * generator; use {@link createWebPlatform} to give a program its own.
+ *
+ * @example
+ * ```ts
+ * import { East, NullType } from "@elaraai/east";
+ * import { WebPlatform, Console, Crypto } from "@elaraai/east-web-std";
+ *
+ * const fn = East.asyncFunction([], NullType, $ => {
+ *     const id = $.let(Crypto.uuid());
+ *     $(Console.log(id));
+ * });
+ *
+ * // An async East function, since Time.sleep and Fetch are async
+ * const compiled = fn.toIR().compile(WebPlatform);
+ * await compiled();
+ * ```
+ */
+export declare const WebPlatform: PlatformFunction[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAqD,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAMnG,OAAO,EAA4B,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAEhB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,gBAAgB,EAAE,CAUtF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,WAAW,EAAE,gBAAgB,EAQzC,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,93 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+// Export test utilities
+export * from "./test.js";
+// Export platform function definitions and implementations
+export * from "./console.js";
+export * from "./path.js";
+export * from "./crypto.js";
+export * from "./time.js";
+export * from "./fetch.js";
+export * from "./random.js";
+// Import implementations for combined export
+import { ConsoleImpl, createConsoleImpl, globalConsoleSink } from "./console.js";
+import { PathImpl } from "./path.js";
+import { CryptoImpl } from "./crypto.js";
+import { TimeImpl, createTimeImpl } from "./time.js";
+import { FetchImpl } from "./fetch.js";
+import { RandomImpl, createRandomImpl } from "./random.js";
+import { TestImpl, createTestImpl } from "./test.js";
+/**
+ * Creates a complete browser platform for one program.
+ *
+ * The platform holds east-node-std's platform functions that mean the same in
+ * a browser — Console, Path, Crypto, Time, Fetch, Random and Test — writing
+ * console output to the host's sink and running tests through its host, its
+ * sleeps stopped by the host's signal when it gives one. Random starts
+ * unseeded, with a generator no other platform shares.
+ *
+ * @param options - The host's console sink, test host and signal
+ * @returns The platform functions, to pass to `compile()` or `compileAsync()`
+ *
+ * @example
+ * ```ts
+ * import { East, NullType } from "@elaraai/east";
+ * import { Console, createWebPlatform } from "@elaraai/east-web-std";
+ *
+ * let stdout = "";
+ * const fn = East.asyncFunction([], NullType, $ => {
+ *     $(Console.log("Hello from a browser"));
+ * });
+ *
+ * const platform = createWebPlatform({
+ *     console: { stdout: text => { stdout += text; }, stderr: text => { stdout += text; } },
+ * });
+ * await fn.toIR().compile(platform)();  // stdout is now "Hello from a browser\n"
+ * ```
+ */
+export function createWebPlatform(options = {}) {
+    return [
+        ...createConsoleImpl(options.console ?? globalConsoleSink),
+        ...PathImpl,
+        ...CryptoImpl,
+        ...createTimeImpl(options.signal),
+        ...FetchImpl,
+        ...createRandomImpl(),
+        ...createTestImpl(options.test),
+    ];
+}
+/**
+ * Complete browser platform implementation.
+ *
+ * Pass this array to `compile()` or `compileAsync()` to enable all the
+ * browser's platform functions. Console output goes to the global `console`,
+ * tests run in place, and every program compiled with it shares one Random
+ * generator; use {@link createWebPlatform} to give a program its own.
+ *
+ * @example
+ * ```ts
+ * import { East, NullType } from "@elaraai/east";
+ * import { WebPlatform, Console, Crypto } from "@elaraai/east-web-std";
+ *
+ * const fn = East.asyncFunction([], NullType, $ => {
+ *     const id = $.let(Crypto.uuid());
+ *     $(Console.log(id));
+ * });
+ *
+ * // An async East function, since Time.sleep and Fetch are async
+ * const compiled = fn.toIR().compile(WebPlatform);
+ * await compiled();
+ * ```
+ */
+export const WebPlatform = [
+    ...ConsoleImpl,
+    ...PathImpl,
+    ...CryptoImpl,
+    ...TimeImpl,
+    ...FetchImpl,
+    ...RandomImpl,
+    ...TestImpl,
+];
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,wBAAwB;AACxB,cAAc,WAAW,CAAC;AAE1B,2DAA2D;AAC3D,cAAc,cAAc,CAAC;AAC7B,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,iBAAiB,EAAE,iBAAiB,EAAoB,MAAM,cAAc,CAAC;AACnG,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAiB,MAAM,WAAW,CAAC;AA6BpE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA8B,EAAE;IAC9D,OAAO;QACH,GAAG,iBAAiB,CAAC,OAAO,CAAC,OAAO,IAAI,iBAAiB,CAAC;QAC1D,GAAG,QAAQ;QACX,GAAG,UAAU;QACb,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC;QACjC,GAAG,SAAS;QACZ,GAAG,gBAAgB,EAAE;QACrB,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC;KAClC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAuB;IAC3C,GAAG,WAAW;IACd,GAAG,QAAQ;IACX,GAAG,UAAU;IACb,GAAG,QAAQ;IACX,GAAG,SAAS;IACZ,GAAG,UAAU;IACb,GAAG,QAAQ;CACd,CAAC"}