automategraph 1.5.1 → 1.5.3

package/js/examples/json-scripts.js

@@ -0,0 +1,131 @@
+"use strict";
+/* ============================================================
+ * A document that brings its own code (v1.5)
+ * ------------------------------------------------------------
+ * order-flow.scripted.graph.json declares WHICH functions it needs and
+ * WHERE they come from:
+ *
+ *   scripts: [
+ *     { "namespace": "order", "path": "./order-flow.functions.cjs" },
+ *     { "namespace": "audit", "source": "…registerEngineNamespace('audit', …)" }
+ *   ]
+ *
+ * Two strategies in one document:
+ *   • `order`  — a CommonJS FILE whose export table is the contribution
+ *   • `audit`  — INLINE source that registers itself from inside the
+ *                script through globalThis.GraphEngine (the loader
+ *                installs that global for the duration of the load only)
+ *
+ * The pipeline stays two-step:
+ *
+ *   const { functions } = await loadGraphScripts(document);
+ *   const engine = createEngineFromJSON(document, { functions });
+ *
+ * Run:  npm run example:scripts      (after npm run build)
+ * ============================================================ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const graph_scripts_1 = require("../src/node/graph-scripts");
+const graph_json_1 = require("../src/graph-json");
+const EXAMPLES = path.join(__dirname, "..", "..", "examples");
+const DOCUMENT_PATH = path.join(EXAMPLES, "order-flow.scripted.graph.json");
+async function main() {
+    const document = fs.readFileSync(DOCUMENT_PATH, "utf8");
+    console.log("=".repeat(96));
+    console.log(`graph with scripts — ${path.basename(DOCUMENT_PATH)} ` +
+        "(functions live in the document's own scripts)");
+    console.log("=".repeat(96));
+    /* ---------- 1. load ---------- */
+    const loaded = await (0, graph_scripts_1.loadGraphScripts)(document, {
+        baseDir: EXAMPLES,
+        onLog: (level, message) => {
+            if (level === "warn" || level === "error")
+                console.log(`  log[${level}] ${message}`);
+        }
+    });
+    for (const script of loaded.scripts) {
+        console.log(`\n▶ namespace "${script.namespace}"  (${script.source}, ${script.format})`);
+        console.log(`   provided: ${script.names.join(", ")}`);
+        if (script.ignoredExports.length > 0) {
+            console.log(`   ignored (not functions): ${script.ignoredExports.join(", ")}`);
+        }
+    }
+    console.log(`\nmerged registry: ${loaded.registry.names.length} functions, ` +
+        `fingerprint ${loaded.registry.fingerprint}`);
+    /* ---------- 2. run ---------- */
+    const engine = (0, graph_json_1.createEngineFromJSON)(document, {
+        functions: loaded.functions,
+        lint: "error"
+    });
+    const report = await engine.run();
+    const path2 = report.results
+        .filter(result => result.status === "SUCCEEDED")
+        .map(result => result.nodeId)
+        .join(" → ");
+    console.log("\n" + "-".repeat(96));
+    console.log(`run: ${report.status}  path: ${path2}` +
+        `  ${path2 === "classify → audit → charge → ship" ? "✓" : "✗ expected classify → audit → charge → ship"}`);
+    for (const result of report.results) {
+        console.log(`   ${result.nodeId.padEnd(9)} fn=${(result.fn ?? "-").padEnd(15)} ` +
+            `attempt=${result.attempt} ${result.status}` +
+            (result.output === undefined ? "" : `  output=${JSON.stringify(result.output)}`));
+    }
+    console.log(`   report.registry: ${report.registry?.fingerprint}  ` +
+        `(${report.registry?.fingerprint === loaded.registry.fingerprint ? "matches the loaded table" : "MISMATCH"})`);
+    console.log(`   lint issues: ${report.lintIssues.length}`);
+    if (report.errors.length > 0) {
+        for (const error of report.errors) {
+            console.log(`   error ${error.code} @${error.nodeId} handled=${error.handled}`);
+        }
+    }
+    /* ---------- 3. the freeze ---------- */
+    console.log("\n" + "-".repeat(96));
+    console.log("the namespace freeze: one claim per process\n");
+    console.log(`   claims now: ${(0, graph_scripts_1.registeredNamespaces)()
+        .map(claim => `${claim.namespace} (${claim.names}, from ${claim.source})`)
+        .join("; ")}`);
+    try {
+        await (0, graph_scripts_1.loadGraphScripts)(document, { baseDir: EXAMPLES });
+        console.log("   ✗ a second load succeeded — the freeze is broken");
+    }
+    catch (error) {
+        const scripted = error;
+        console.log(`   second load → ${scripted.code}`);
+        console.log(`   ${scripted.message.split(". ")[0]}.`);
+    }
+    console.log("\n   (resetGraphScriptNamespaces() clears the claims — test/CI hygiene;\n" +
+        "    production code should not need it: a document is loaded once.)");
+    (0, graph_scripts_1.resetGraphScriptNamespaces)();
+    const reloaded = await (0, graph_scripts_1.loadGraphScripts)(document, { baseDir: EXAMPLES });
+    console.log(`   after reset → loaded again: ${reloaded.registry.names.length} functions, ` +
+        `fingerprint ${reloaded.registry.fingerprint}`);
+    console.log("\n" + "=".repeat(96));
+}
+if (require.main === module) {
+    void main();
+}
+//# sourceMappingURL=json-scripts.js.map

package/js/examples/json-scripts.js.map

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