@bian-womp/spark-remote 0.3.87 → 0.3.89

package/lib/src/server/ServerCommandHandler.js

@@ -0,0 +1,325 @@
+import { summarize, serializeError } from "./errors";
+import { decodeInputsFromTransport } from "../utils/inputEncoding";
+export class ServerCommandHandler {
+    constructor(adapter, options) {
+        this.adapter = adapter;
+        this.options = options;
+        this.middlewares = [];
+    }
+    /**
+     * Register middleware to preprocess commands before handling.
+     * Middlewares are executed in registration order.
+     */
+    use(middleware) {
+        this.middlewares.push(middleware);
+    }
+    /**
+     * Handle command with error handling and middleware support.
+     */
+    async handleCommand(env, ack) {
+        try {
+            // Execute middlewares in sequence, then process command
+            await this.executeMiddlewares(env, async () => {
+                await this.processCommand(env, ack);
+            });
+        }
+        catch (err) {
+            this.handleError(env, err);
+        }
+    }
+    /**
+     * Execute middlewares in sequence, then call the final handler.
+     */
+    async executeMiddlewares(env, finalHandler) {
+        let index = 0;
+        const next = async () => {
+            if (index >= this.middlewares.length) {
+                await finalHandler();
+                return;
+            }
+            const middleware = this.middlewares[index++];
+            await middleware(env, next);
+        };
+        await next();
+    }
+    /**
+     * Process the command by routing to the appropriate handler.
+     */
+    async processCommand(env, ack) {
+        const msg = env.message;
+        switch (msg.type) {
+            case "Build": {
+                this.logCommand("Build", env, {
+                    nodes: msg.payload.def.nodes?.length ?? 0,
+                    edges: msg.payload.def.edges?.length ?? 0,
+                    envKeys: Object.keys(msg.payload.environment ?? {}).join(","),
+                });
+                await this.adapter.build(msg.payload.def, msg.payload.environment);
+                ack();
+                break;
+            }
+            case "Update": {
+                const dry = msg.dry;
+                this.logCommand("Update", env, {
+                    nodes: msg.payload.def.nodes?.length ?? 0,
+                    edges: msg.payload.def.edges?.length ?? 0,
+                    dry: !!dry,
+                });
+                await this.adapter.update(msg.payload.def, { dry });
+                ack();
+                break;
+            }
+            case "SetEnvironment": {
+                const dry = msg.dry;
+                this.logCommand("SetEnvironment", env, dry ? { dry: true } : undefined);
+                await this.adapter.setEnvironment(msg.payload.environment, {
+                    merge: Boolean(msg.payload.merge),
+                    dry,
+                });
+                ack();
+                break;
+            }
+            case "SetInputs": {
+                const dry = msg.dry;
+                this.logCommand("SetInputs", env, {
+                    nodeId: msg.payload.nodeId,
+                    keys: Object.keys(msg.payload.inputs || {}).join(","),
+                    dry: !!dry,
+                });
+                const nodeId = msg.payload.nodeId;
+                const inputs = decodeInputsFromTransport(msg.payload.inputs);
+                await this.adapter.setInputs(nodeId, inputs, { dry });
+                ack();
+                break;
+            }
+            case "CopyOutputs": {
+                const dry = msg.dry;
+                this.logCommand("CopyOutputs", env, {
+                    fromNodeId: msg.payload.fromNodeId,
+                    toNodeId: msg.payload.toNodeId,
+                    dry: !!dry,
+                });
+                await this.adapter.copyOutputs(msg.payload.fromNodeId, msg.payload.toNodeId, { dry });
+                ack();
+                break;
+            }
+            case "TriggerExternal": {
+                const dry = msg.dry;
+                this.logCommand("TriggerExternal", env, {
+                    nodeId: msg.payload.nodeId,
+                    event: summarize(msg.payload.event),
+                    dry: !!dry,
+                });
+                await this.adapter.triggerExternal(msg.payload.nodeId, msg.payload.event, { dry });
+                ack();
+                break;
+            }
+            // SetViewport is handled by middleware before reaching here
+            // It's not a standard Command type, so we handle it in middleware
+            case "Launch": {
+                const launchPayload = msg.payload;
+                this.logCommand("Launch", env, {
+                    runMode: launchPayload.runMode,
+                    invalidate: launchPayload.invalidate,
+                });
+                await this.adapter.launch(launchPayload);
+                ack();
+                break;
+            }
+            case "SetRunMode": {
+                const setRunModePayload = msg.payload;
+                this.logCommand("SetRunMode", env, setRunModePayload);
+                await this.adapter.setRunMode(setRunModePayload.runMode);
+                ack();
+                break;
+            }
+            case "ComputeNode": {
+                const computeNodePayload = msg.payload;
+                this.logCommand("ComputeNode", env, computeNodePayload);
+                await this.adapter.computeNode(computeNodePayload.nodeId);
+                ack();
+                break;
+            }
+            case "RunFromHere": {
+                this.logCommand("RunFromHere", env, {
+                    nodeId: msg.payload.nodeId,
+                });
+                await this.adapter.runFromHere(msg.payload.nodeId);
+                ack();
+                break;
+            }
+            case "CancelNodeRuns": {
+                const cancelPayload = msg.payload;
+                this.logCommand("CancelNodeRuns", env, cancelPayload);
+                await this.adapter.cancelNodeRuns(cancelPayload.nodeIds);
+                ack();
+                break;
+            }
+            case "WhenIdle": {
+                this.logCommand("WhenIdle", env);
+                await this.adapter.whenIdle();
+                ack();
+                break;
+            }
+            case "Snapshot": {
+                this.logCommand("Snapshot", env);
+                const snap = await this.adapter.snapshot();
+                ack({ snapshot: snap });
+                break;
+            }
+            case "SnapshotFull": {
+                this.logCommand("SnapshotFull", env);
+                const snap = await this.adapter.snapshotFull();
+                ack({ snapshot: snap });
+                break;
+            }
+            case "GetEnvironment": {
+                this.logCommand("GetEnvironment", env);
+                const environment = await this.adapter.getEnvironment();
+                ack({ environment });
+                break;
+            }
+            case "ApplySnapshotFull": {
+                const skipBuild = msg.skipBuild;
+                this.logCommand("ApplySnapshotFull", env, skipBuild ? { skipBuild: true } : undefined);
+                await this.adapter.applySnapshotFull(msg.payload, { skipBuild });
+                ack();
+                break;
+            }
+            case "ConvertSnapshot": {
+                const converterConfig = msg.payload.converterConfig;
+                const dry = msg.dry;
+                this.logCommand("ConvertSnapshot", env, { dry });
+                const converted = await this.adapter.convertSnapshot(converterConfig, { dry });
+                ack({ snapshot: converted });
+                break;
+            }
+            case "Coerce": {
+                this.logCommand("Coerce", env, {
+                    from: msg.payload.from,
+                    to: msg.payload.to,
+                });
+                const value = await this.adapter.coerce(msg.payload.from, msg.payload.to, msg.payload.value);
+                ack({ value });
+                break;
+            }
+            case "DescribeRegistry": {
+                this.logCommand("DescribeRegistry", env);
+                const desc = await this.adapter.describeRegistry();
+                ack({ registry: desc });
+                break;
+            }
+            case "RegistryApply": {
+                this.logCommand("RegistryApply", env);
+                await this.adapter.applyRegistry(msg.payload.deltas || []);
+                ack();
+                break;
+            }
+            case "SetExtData": {
+                await this.adapter.setExtData(msg.payload);
+                ack();
+                break;
+            }
+            case "UpdateExtData": {
+                const hasCustomUpdate = await this.adapter.updateExtData(msg.payload);
+                ack({ hasCustomUpdate });
+                break;
+            }
+            case "Dispose": {
+                this.logCommand("Dispose", env);
+                await this.adapter.dispose();
+                ack();
+                break;
+            }
+            case "Commit": {
+                this.logCommand("Commit", env);
+                const history = await this.adapter.commit(msg.payload.reason);
+                ack(history ? { history } : undefined);
+                break;
+            }
+            case "Undo": {
+                this.logCommand("Undo", env);
+                const success = await this.adapter.undo();
+                ack({ success });
+                break;
+            }
+            case "Redo": {
+                this.logCommand("Redo", env);
+                const success = await this.adapter.redo();
+                ack({ success });
+                break;
+            }
+            case "Pause": {
+                this.logCommand("Pause", env);
+                await this.adapter.pause();
+                ack();
+                break;
+            }
+            case "Resume": {
+                this.logCommand("Resume", env);
+                await this.adapter.resume();
+                ack();
+                break;
+            }
+            default: {
+                this.logCommand("Unknown type", env);
+                ack();
+            }
+        }
+    }
+    /**
+     * Helper method to log commands with consistent format.
+     */
+    logCommand(type, env, extra) {
+        const extraStr = extra
+            ? ` ${Object.entries(extra)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(" ")}`
+            : "";
+        const message = `rx ${type} seq=${env.seq}${extraStr}`;
+        if (this.options?.logHandler) {
+            this.options.logHandler("debug", message, {
+                seq: env.seq,
+                ...extra,
+            });
+        }
+        else {
+            // Fallback to console.debug for backward compatibility
+            console.debug(message);
+        }
+    }
+    /**
+     * Handle errors and notify error handler if provided.
+     * Formats errors as SystemError since these are infrastructure/command processing errors,
+     * not node execution errors.
+     */
+    handleError(env, err) {
+        const errorMessage = `error handling command(${env.message.type}): ${String(err)}`;
+        if (this.options?.logHandler) {
+            this.options.logHandler("error", errorMessage, {
+                seq: env.seq,
+                err,
+            });
+        }
+        else {
+            // Fallback to console.error for backward compatibility
+            console.error(`${errorMessage}:`, err);
+        }
+        const serialized = serializeError(err);
+        const systemError = {
+            kind: "system",
+            message: serialized?.message || String(err) || "Unknown error",
+            code: serialized?.code || serialized?.statusCode || 500,
+            err: serialized,
+        };
+        const errorEnv = {
+            seq: env.seq ?? Date.now(),
+            ts: Date.now(),
+            message: { type: "error", payload: systemError },
+        };
+        if (this.options?.errorHandler) {
+            this.options.errorHandler(errorEnv);
+        }
+    }
+}
+//# sourceMappingURL=ServerCommandHandler.js.map

package/lib/src/server/ServerCommandHandler.js.map

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

package/lib/src/server/ServerRuntimeAdapter.d.ts

@@ -0,0 +1,27 @@
+import type { Envelope, RuntimeEvent, RuntimeMetadata } from "@bian-womp/spark-protocol";
+import { GraphBuilder, Registry, GraphRuntime, LocalEngine, type GraphLifecycleApi, type Engine } from "@bian-womp/spark-graph";
+/**
+ * ServerRuntimeAdapter extends GraphLifecycleApi and Engine to provide a unified interface
+ * for both lifecycle and execution operations on the server side.
+ *
+ * Note: All Engine methods (including setInputs, copyOutputs, triggerExternal) already include
+ * the `dry` option, so no overrides are needed. Some methods are sync in implementation but
+ * match async signatures via wrappers.
+ */
+export interface ServerRuntimeAdapter extends GraphLifecycleApi, Omit<Engine, "launch"> {
+    orignalDispose?: () => void;
+}
+export interface ServerRuntimeAdapterContext {
+    registry: Registry;
+    builder: GraphBuilder;
+    graphRuntime: GraphRuntime | undefined;
+    engine: LocalEngine | undefined;
+    extData: {
+        runtime?: RuntimeMetadata;
+    } & Record<string, unknown>;
+}
+export type ServerRuntimeAdapterExtension = {
+    [K in Exclude<keyof ServerRuntimeAdapter, "originalAdapter">]?: ServerRuntimeAdapter[K] extends (...args: any[]) => any ? (original: ServerRuntimeAdapter[K], context: ServerRuntimeAdapterContext, ...args: Parameters<ServerRuntimeAdapter[K]>) => ReturnType<ServerRuntimeAdapter[K]> : never;
+};
+export declare function createServerRuntimeAdapter(id: string | undefined, createRegistry: (id?: string) => Promise<Registry>, send: (e: Envelope<RuntimeEvent>) => void, extensions?: ServerRuntimeAdapterExtension): Promise<ServerRuntimeAdapter>;
+//# sourceMappingURL=ServerRuntimeAdapter.d.ts.map

package/lib/src/server/ServerRuntimeAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerRuntimeAdapter.d.ts","sourceRoot":"","sources":["../../../src/server/ServerRuntimeAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EAIZ,eAAe,EAGhB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,WAAW,EAGX,KAAK,iBAAiB,EACtB,KAAK,MAAM,EAKZ,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;IAErF,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;IACvC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,eAAe,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,6BAA6B,GAAG;KACzC,CAAC,IAAI,OAAO,CAAC,MAAM,oBAAoB,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,SAAS,CAC9F,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,GAAG,GACJ,CACE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,EACjC,OAAO,EAAE,2BAA2B,EACpC,GAAG,IAAI,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,KACzC,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,GACxC,KAAK;CACV,CAAC;AAEF,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,cAAc,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EAClD,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,IAAI,EACzC,UAAU,CAAC,EAAE,6BAA6B,GACzC,OAAO,CAAC,oBAAoB,CAAC,CA6a/B"}