@elaraai/east 0.0.1-beta.0

package/dist/src/eastir.js

@@ -0,0 +1,92 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import {} from "./types.js";
+import { compile_internal, ReturnException } from "./compile.js";
+import { analyzeIR } from "./analyze.js";
+/** A helper class wrapping East's "intermediate representation" (IR) for a free function.
+ * The IR can be serialized and saved, or compiled so that the function can be executed.
+ */
+export class EastIR {
+    ir;
+    constructor(ir) {
+        this.ir = ir;
+        if (ir.type !== "Function") {
+            throw new Error(`Expected function expressions, got a ${ir.type}`);
+        }
+        if (ir.value.captures.length !== 0) {
+            throw new Error(`Expected free function, without captured variables`);
+        }
+    }
+    /** Compile the function for execution in JavaScript using a closure-compiler technique.
+     * Platform functions must be provided for the function to evaluate.
+     *
+     * This method is for synchronous platforms only. Use compileAsync() if any platform function is async.
+     * @throws {Error} if any platform function is async
+     */
+    compile(platform) {
+        // Check that no platform functions are async
+        if (platform.some(fn => fn.type === 'async')) {
+            throw new Error(`Cannot use compile() with async platform functions: ${platform.map(f => f.name).join(', ')}. ` +
+                `Use compileAsync() instead.`);
+        }
+        // Analyse the IR
+        const analyzed_ir = analyzeIR(this.ir, platform, {});
+        // compile the function (with no variables in environment)
+        const platformFns = Object.fromEntries(platform.map(fn => [fn.name, fn.fn]));
+        const asyncPlatformFns = new Set();
+        const compiled_expr = compile_internal(analyzed_ir, {}, platformFns, asyncPlatformFns);
+        // instantiate the function (with no environment)
+        const instantiated_function = compiled_expr({});
+        // Return sync wrapper
+        return (...inputs) => {
+            try {
+                return instantiated_function(...inputs);
+            }
+            catch (e) {
+                if (e instanceof ReturnException) {
+                    return e.value;
+                }
+                else {
+                    throw e;
+                }
+            }
+        };
+    }
+    /** Compile the function for execution in JavaScript using a closure-compiler technique.
+     * Platform functions must be provided for the function to evaluate.
+     *
+     * This method is for platforms with async functions. Use compile() if all platform functions are sync.
+     * @throws {Error} if no platform functions are async
+     */
+    compileAsync(platform) {
+        // Check that at least one platform function is async
+        if (!platform.some(fn => fn.type === 'async')) {
+            throw new Error(`No async platform functions found. Use compile() instead of compileAsync() for better performance.`);
+        }
+        // Analyse the IR
+        const analyzed_ir = analyzeIR(this.ir, platform, {});
+        // compile the function (with no variables in environment)
+        const platformFns = Object.fromEntries(platform.map(fn => [fn.name, fn.fn]));
+        const asyncPlatformFns = new Set(platform.filter(fn => fn.type === 'async').map(fn => fn.name));
+        const compiled_expr = compile_internal(analyzed_ir, {}, platformFns, asyncPlatformFns);
+        // instantiate the function (with no environment)
+        const instantiated_function = compiled_expr({});
+        // Return async wrapper
+        return async (...inputs) => {
+            try {
+                return await instantiated_function(...inputs);
+            }
+            catch (e) {
+                if (e instanceof ReturnException) {
+                    return e.value;
+                }
+                else {
+                    throw e;
+                }
+            }
+        };
+    }
+}
+//# sourceMappingURL=eastir.js.map

package/dist/src/eastir.js.map

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

package/dist/src/error.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import type { LocationValue } from "./ir.js";
+export declare class EastError extends Error {
+    location: LocationValue[];
+    constructor(message: string, options: {
+        cause?: any;
+        location: LocationValue;
+    });
+}
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,qBAAa,SAAU,SAAQ,KAAK;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,GAAG,CAAC;QAAC,QAAQ,EAAE,aAAa,CAAA;KAAE;CAI/E"}

package/dist/src/error.js

@@ -0,0 +1,8 @@
+export class EastError extends Error {
+    location;
+    constructor(message, options) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.location = [options.location];
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/src/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAC3B,QAAQ,CAAkB;IAEjC,YAAY,OAAe,EAAE,OAAiD;QAC5E,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,QAAQ,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF"}