npm - @womp/spark-protocol - Versions diffs - 0.3.92 - Mend

@womp/spark-protocol 0.3.92

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/lib/cjs/index.cjs +12 -0
package/lib/cjs/index.cjs.map +1 -0
package/lib/cjs/src/index.d.ts +479 -0
package/lib/cjs/src/index.d.ts.map +1 -0
package/lib/esm/index.js +10 -0
package/lib/esm/index.js.map +1 -0
package/lib/esm/src/index.d.ts +479 -0
package/lib/esm/src/index.d.ts.map +1 -0
package/package.json +46 -0

package/lib/cjs/index.cjs ADDED Viewed

@@ -0,0 +1,12 @@
+'use strict';
+const LOG_LEVEL_VALUES = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+exports.LOG_LEVEL_VALUES = LOG_LEVEL_VALUES;
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/index.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.cjs","sources":["../../src/index.ts"],"sourcesContent":["// Shared protocol types for Spark runtime transport (backend side)\nexport type DataTypeId = string;\nexport type NodeCategoryId = string;\nexport type NodeTypeId = string;\nexport type NodeInstanceId = string;\nexport type HandleId = string;\nexport type EdgeInstanceId = string;\n\nexport interface EnumOption {\n value: number;\n label: string;\n meta?: Record<string, unknown>;\n}\n\nexport interface HandleMetadata extends Record<string, unknown> {\n // Numeric constraints (for Float, Int, etc.)\n min?: number;\n max?: number;\n step?: number;\n // Add other metadata fields as needed in the future\n // e.g., unit?: string, precision?: number, etc.\n}\n\nexport type InputDefaultPolicy = \"unbound\" | \"bound\";\n\nexport type InputHandleDescriptor =\n | DataTypeId\n | DataTypeId[]\n | {\n typeId: DataTypeId | DataTypeId[];\n private?: boolean;\n metadata?: HandleMetadata;\n defaultPolicy?: InputDefaultPolicy;\n };\n\nexport type ResolvedHandles = {\n inputs: Record<string, InputHandleDescriptor>;\n outputs: Record<string, DataTypeId | DataTypeId[]>;\n inputDefaults: Record<string, unknown>;\n};\n\n// Execution policy for node execution behavior\nexport interface ExecutionPolicy {\n asyncConcurrency: \"merge\" | \"switch\" | \"queue\" | \"drop\";\n timeoutMs: number;\n maxQueue: number;\n debounceMs: number;\n throttleMs: number;\n retry: { attempts: number; backoffMs: (attemptIndex: number) => number };\n autoRun?: boolean; // When true, node runs automatically on input changes even in manual mode\n rerunOnSameInput?: boolean; // When true, node runs even when inputs haven't changed (e.g., RandomSeed nodes)\n}\n\n// Graph definition types - unified definition used across all Spark packages\nexport interface GraphNodeDefinition {\n nodeId: NodeInstanceId;\n typeId: NodeTypeId;\n params?: Record<string, unknown> & { policy?: Partial<ExecutionPolicy> };\n // Optional per-node resolved handles provided by the builder/remote runtime\n resolvedHandles?: Partial<ResolvedHandles>;\n}\n\nexport interface GraphEdgeDefinition {\n id: EdgeInstanceId;\n source: { nodeId: NodeInstanceId; handle: HandleId };\n target: { nodeId: NodeInstanceId; handle: HandleId };\n typeId?: DataTypeId;\n}\n\nexport interface GraphDefinition {\n nodes: GraphNodeDefinition[];\n edges: GraphEdgeDefinition[];\n}\n\n// Canonical graph shape used for patch-friendly persistence.\nexport interface GraphDefinitionById {\n nodesById: Record<NodeInstanceId, GraphNodeDefinition>;\n edgesById: Record<EdgeInstanceId, GraphEdgeDefinition>;\n}\n\nexport type RunMode = \"manual\" | \"auto\";\n\nexport interface RunnerOptions {\n runMode?: RunMode; // default is \"manual\"\n invalidate?: boolean;\n startPaused?: boolean; // If true, runtime starts in paused state\n}\n\n// Common JSON type used across packages\nexport type Json = Record<string, unknown>;\n\nexport interface Envelope<T = unknown> {\n sessionId?: string;\n seq?: number;\n ts?: number;\n message: T;\n}\n\nexport type Command =\n | {\n type: \"Build\";\n payload: {\n def: GraphDefinition;\n environment?: Record<string, unknown>;\n };\n }\n | { type: \"Update\"; payload: { def: GraphDefinition }; dry?: boolean }\n | { type: \"RegistryApply\"; payload: { deltas: RegistryDelta[] } }\n | { type: \"GetEnvironment\" }\n | {\n type: \"SetEnvironment\";\n payload: { environment: Record<string, unknown>; merge?: boolean };\n dry?: boolean;\n }\n | { type: \"DescribeRegistry\" }\n | {\n type: \"TriggerExternal\";\n payload: { nodeId: string; event: unknown };\n dry?: boolean;\n }\n | { type: \"Launch\"; payload: RunnerOptions }\n | {\n type: \"ComputeNode\";\n payload: { nodeId: string };\n }\n | { type: \"RunFromHere\"; payload: { nodeId: string } }\n | { type: \"CancelNodeRuns\"; payload: { nodeIds: string[] } }\n | { type: \"WhenIdle\" }\n | {\n type: \"SetInputs\";\n payload: { nodeId: string; inputs: Record<string, unknown> };\n dry?: boolean;\n }\n | {\n type: \"CopyOutputs\";\n payload: { fromNodeId: string; toNodeId: string };\n dry?: boolean;\n }\n | { type: \"Snapshot\" }\n | { type: \"SnapshotFull\" }\n | {\n type: \"ApplySnapshotFull\";\n payload: RuntimeSnapshotFull;\n skipBuild?: boolean;\n }\n | {\n type: \"Coerce\";\n payload: { from: string; to: string; value: unknown };\n }\n | { type: \"SetExtData\"; payload: Record<string, unknown> }\n | { type: \"UpdateExtData\"; payload: Array<{ path: string; value: unknown }> }\n | { type: \"SetRunMode\"; payload: { runMode: RunMode } }\n | {\n type: \"ConvertSnapshot\";\n payload: { converterConfig: ConverterConfig };\n dry?: boolean;\n }\n | { type: \"Dispose\" }\n | { type: \"Commit\"; payload: { reason?: string } }\n | { type: \"Undo\" }\n | { type: \"Redo\" }\n | { type: \"Pause\" }\n | { type: \"Resume\" };\n\n// Event payloads\nexport interface RuntimeValue {\n nodeId: string;\n handle: string;\n value: unknown;\n io: \"input\" | \"output\";\n // If the value is a union-typed output, this conveys its runtime type id\n runtimeTypeId?: string;\n dry?: boolean;\n}\n\nexport type NodeRunError = {\n kind: \"node-run\";\n nodeId: string;\n nodeTypeId?: string;\n runId: string;\n err: unknown;\n};\n\nexport type EdgeConvertError = {\n kind: \"edge-convert\";\n edgeId: string;\n source: { nodeId: string; handle: string };\n target: { nodeId: string; handle: string };\n sourceTypeId?: string;\n targetTypeId?: string;\n err: unknown;\n};\n\nexport type RegistryError = {\n kind: \"registry\";\n message: string;\n err?: unknown;\n attempt?: number;\n maxAttempts?: number;\n};\n\nexport type SystemError = {\n kind: \"system\";\n message: string;\n code?: string | number;\n err?: unknown;\n details?: Record<string, unknown>;\n};\n\nexport type InputValidationError = {\n kind: \"input-validation\";\n nodeId: string;\n nodeTypeId?: string;\n handle: string;\n typeId: string;\n value: unknown;\n message: string;\n};\n\nexport type RuntimeError = NodeRunError | EdgeConvertError | RegistryError | SystemError | InputValidationError;\n\nexport interface RuntimeInvalidate {\n reason: string;\n // Optional: present when reason === \"registry-changed\"\n deltas?: RegistryDelta[];\n // Optional: present when reason === \"graph-updated\" or \"graph-built\"\n // Maps nodeId to their updated resolvedHandles (only included when handles actually change)\n resolvedHandles?: Record<string, Partial<ResolvedHandles>>;\n}\n\nexport type NodeStartStats = {\n kind: \"node-start\";\n nodeId: string;\n typeId: string;\n runId: string;\n};\n\nexport type NodeProgressStats = {\n kind: \"node-progress\";\n nodeId: string;\n typeId: string;\n runId: string;\n progress: number;\n};\n\nexport type NodeDoneStats = {\n kind: \"node-done\";\n nodeId: string;\n typeId: string;\n runId: string;\n durationMs?: number;\n cancelled?: boolean; // true when node was cancelled (deleted, snapshot, etc.)\n};\n\nexport type NodeCustomDataStats = {\n kind: \"node-custom-data\";\n nodeId: string;\n typeId: string;\n runId: string;\n data: Record<string, unknown>;\n};\n\nexport type EdgeStartStats = {\n kind: \"edge-start\";\n edgeId: string;\n typeId?: string;\n source: { nodeId: string; handle: string };\n target: { nodeId: string; handle: string };\n sourceTypeId?: string;\n targetTypeId?: string;\n};\n\nexport type EdgeDoneStats = {\n kind: \"edge-done\";\n edgeId: string;\n typeId?: string;\n source: { nodeId: string; handle: string };\n target: { nodeId: string; handle: string };\n sourceTypeId?: string;\n targetTypeId?: string;\n durationMs?: number;\n};\n\nexport type RuntimeStats =\n | NodeStartStats\n | NodeProgressStats\n | NodeDoneStats\n | NodeCustomDataStats\n | EdgeStartStats\n | EdgeDoneStats;\n\nexport type Viewport = { x: number; y: number; zoom: number };\n\nexport type RuntimeEvent =\n | { type: \"value\"; payload: RuntimeValue }\n | { type: \"invalidate\"; payload: RuntimeInvalidate }\n | { type: \"error\"; payload: RuntimeError }\n | { type: \"stats\"; payload: RuntimeStats }\n | { type: \"registry\"; payload: { registry: RegistryDescriptor } }\n | { type: \"registryChanged\"; payload: { deltas?: RegistryDelta[] } }\n | { type: \"viewport\"; payload: { viewport: Viewport } };\n\n// Registry mutation protocol\nexport type RegistryDelta =\n | {\n kind: \"register-enum\";\n id: string;\n displayName?: string;\n options: Array<EnumOption>;\n bakeTarget?: { nodeTypeId: string; inputHandle: string };\n opts?: {\n withArray?: boolean;\n arrayId?: string;\n arrayPickFirstDefined?: boolean;\n };\n }\n | {\n kind: \"register-type\";\n id: string;\n displayName?: string;\n bakeTarget?: { nodeTypeId: string; inputHandle: string };\n }\n | {\n kind: \"register-node\";\n desc: {\n id: string;\n categoryId: string;\n displayName?: string;\n } & Partial<ResolvedHandles>;\n };\n\nexport interface RegistryDescriptor {\n types: Array<{\n id: string;\n displayName?: string;\n options?: Array<EnumOption>;\n bakeTarget?: { nodeTypeId: string; inputHandle: string };\n }>;\n categories: Array<{ id: string; displayName?: string }>;\n nodes: Array<\n {\n id: string;\n categoryId: string;\n displayName?: string;\n policy?: Partial<ExecutionPolicy>;\n } & ResolvedHandles\n >;\n coercions: Array<{\n from: string;\n to: string;\n async?: boolean;\n nonTransitive?: boolean;\n }>;\n schemaVersion: number;\n}\n\nexport interface RuntimeSnapshot {\n inputs: Record<string, Record<string, unknown>>;\n outputs: Record<string, Record<string, unknown>>;\n}\n\nexport type NodeRuntimeMetadata = {\n lastRunAt?: number;\n lastSuccessAt?: number;\n lastErrorAt?: number;\n lastInputAt?: Record<string, number>;\n lastOutputAt?: Record<string, number>;\n lastErrorSummary?: { message: string; code?: number };\n};\n\nexport interface RuntimeMetadata {\n nodes: Record<string, NodeRuntimeMetadata>;\n}\n\nexport interface RuntimeSnapshotFull extends RuntimeSnapshot {\n def?: GraphDefinition;\n environment?: Record<string, unknown>;\n extData?: { runtime?: RuntimeMetadata } & Record<string, unknown>;\n}\n\n// Snapshot variant used by persistence layers that patch by stable IDs.\nexport interface RuntimeSnapshotForPatch extends RuntimeSnapshot {\n def: GraphDefinitionById;\n environment?: Record<string, unknown>;\n extData?: { runtime?: RuntimeMetadata } & Record<string, unknown>;\n}\n\nexport interface RuntimeHistoryInfo {\n cursor: number;\n length: number;\n undoCount: number;\n redoCount: number;\n}\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"silent\";\n\nexport const LOG_LEVEL_VALUES: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n silent: 4,\n};\n\nexport type LogHandler = (level: LogLevel, message: string, context?: Record<string, unknown>) => void;\n\nexport interface ValueConverterConfig {\n nodeId: string;\n handleId: string;\n value: unknown;\n type: \"input\" | \"output\" | \"inputDefault\";\n nodeTypeId?: string;\n handleDataType?: string;\n runtimeTypeId?: string;\n}\n\nexport type PathSegment = string | number | RegExp;\nexport type JsonPath = string | PathSegment[];\n\nexport interface ValueMappingConfig {\n handleId?: string | RegExp;\n nodeId?: string | RegExp;\n nodeTypeId?: string | RegExp;\n handleDataType?: string | RegExp;\n runtimeTypeId?: string | RegExp;\n transformTypedValue?: boolean;\n path?: JsonPath;\n type?: \"input\" | \"output\" | \"inputDefault\";\n valueMap: Map<string | number | boolean, unknown> | Record<string | number, unknown>;\n}\n\nexport interface ConverterConfig {\n mappings: ValueMappingConfig[];\n}\n"],"names":[],"mappings":";;AA4YO,MAAM,gBAAgB,GAA6B;AACxD,IAAA,KAAK,EAAE,CAAC;AACR,IAAA,IAAI,EAAE,CAAC;AACP,IAAA,IAAI,EAAE,CAAC;AACP,IAAA,KAAK,EAAE,CAAC;AACR,IAAA,MAAM,EAAE,CAAC;;;;;"}

package/lib/cjs/src/index.d.ts ADDED Viewed

@@ -0,0 +1,479 @@
+export type DataTypeId = string;
+export type NodeCategoryId = string;
+export type NodeTypeId = string;
+export type NodeInstanceId = string;
+export type HandleId = string;
+export type EdgeInstanceId = string;
+export interface EnumOption {
+    value: number;
+    label: string;
+    meta?: Record<string, unknown>;
+}
+export interface HandleMetadata extends Record<string, unknown> {
+    min?: number;
+    max?: number;
+    step?: number;
+}
+export type InputDefaultPolicy = "unbound" | "bound";
+export type InputHandleDescriptor = DataTypeId | DataTypeId[] | {
+    typeId: DataTypeId | DataTypeId[];
+    private?: boolean;
+    metadata?: HandleMetadata;
+    defaultPolicy?: InputDefaultPolicy;
+};
+export type ResolvedHandles = {
+    inputs: Record<string, InputHandleDescriptor>;
+    outputs: Record<string, DataTypeId | DataTypeId[]>;
+    inputDefaults: Record<string, unknown>;
+};
+export interface ExecutionPolicy {
+    asyncConcurrency: "merge" | "switch" | "queue" | "drop";
+    timeoutMs: number;
+    maxQueue: number;
+    debounceMs: number;
+    throttleMs: number;
+    retry: {
+        attempts: number;
+        backoffMs: (attemptIndex: number) => number;
+    };
+    autoRun?: boolean;
+    rerunOnSameInput?: boolean;
+}
+export interface GraphNodeDefinition {
+    nodeId: NodeInstanceId;
+    typeId: NodeTypeId;
+    params?: Record<string, unknown> & {
+        policy?: Partial<ExecutionPolicy>;
+    };
+    resolvedHandles?: Partial<ResolvedHandles>;
+}
+export interface GraphEdgeDefinition {
+    id: EdgeInstanceId;
+    source: {
+        nodeId: NodeInstanceId;
+        handle: HandleId;
+    };
+    target: {
+        nodeId: NodeInstanceId;
+        handle: HandleId;
+    };
+    typeId?: DataTypeId;
+}
+export interface GraphDefinition {
+    nodes: GraphNodeDefinition[];
+    edges: GraphEdgeDefinition[];
+}
+export interface GraphDefinitionById {
+    nodesById: Record<NodeInstanceId, GraphNodeDefinition>;
+    edgesById: Record<EdgeInstanceId, GraphEdgeDefinition>;
+}
+export type RunMode = "manual" | "auto";
+export interface RunnerOptions {
+    runMode?: RunMode;
+    invalidate?: boolean;
+    startPaused?: boolean;
+}
+export type Json = Record<string, unknown>;
+export interface Envelope<T = unknown> {
+    sessionId?: string;
+    seq?: number;
+    ts?: number;
+    message: T;
+}
+export type Command = {
+    type: "Build";
+    payload: {
+        def: GraphDefinition;
+        environment?: Record<string, unknown>;
+    };
+} | {
+    type: "Update";
+    payload: {
+        def: GraphDefinition;
+    };
+    dry?: boolean;
+} | {
+    type: "RegistryApply";
+    payload: {
+        deltas: RegistryDelta[];
+    };
+} | {
+    type: "GetEnvironment";
+} | {
+    type: "SetEnvironment";
+    payload: {
+        environment: Record<string, unknown>;
+        merge?: boolean;
+    };
+    dry?: boolean;
+} | {
+    type: "DescribeRegistry";
+} | {
+    type: "TriggerExternal";
+    payload: {
+        nodeId: string;
+        event: unknown;
+    };
+    dry?: boolean;
+} | {
+    type: "Launch";
+    payload: RunnerOptions;
+} | {
+    type: "ComputeNode";
+    payload: {
+        nodeId: string;
+    };
+} | {
+    type: "RunFromHere";
+    payload: {
+        nodeId: string;
+    };
+} | {
+    type: "CancelNodeRuns";
+    payload: {
+        nodeIds: string[];
+    };
+} | {
+    type: "WhenIdle";
+} | {
+    type: "SetInputs";
+    payload: {
+        nodeId: string;
+        inputs: Record<string, unknown>;
+    };
+    dry?: boolean;
+} | {
+    type: "CopyOutputs";
+    payload: {
+        fromNodeId: string;
+        toNodeId: string;
+    };
+    dry?: boolean;
+} | {
+    type: "Snapshot";
+} | {
+    type: "SnapshotFull";
+} | {
+    type: "ApplySnapshotFull";
+    payload: RuntimeSnapshotFull;
+    skipBuild?: boolean;
+} | {
+    type: "Coerce";
+    payload: {
+        from: string;
+        to: string;
+        value: unknown;
+    };
+} | {
+    type: "SetExtData";
+    payload: Record<string, unknown>;
+} | {
+    type: "UpdateExtData";
+    payload: Array<{
+        path: string;
+        value: unknown;
+    }>;
+} | {
+    type: "SetRunMode";
+    payload: {
+        runMode: RunMode;
+    };
+} | {
+    type: "ConvertSnapshot";
+    payload: {
+        converterConfig: ConverterConfig;
+    };
+    dry?: boolean;
+} | {
+    type: "Dispose";
+} | {
+    type: "Commit";
+    payload: {
+        reason?: string;
+    };
+} | {
+    type: "Undo";
+} | {
+    type: "Redo";
+} | {
+    type: "Pause";
+} | {
+    type: "Resume";
+};
+export interface RuntimeValue {
+    nodeId: string;
+    handle: string;
+    value: unknown;
+    io: "input" | "output";
+    runtimeTypeId?: string;
+    dry?: boolean;
+}
+export type NodeRunError = {
+    kind: "node-run";
+    nodeId: string;
+    nodeTypeId?: string;
+    runId: string;
+    err: unknown;
+};
+export type EdgeConvertError = {
+    kind: "edge-convert";
+    edgeId: string;
+    source: {
+        nodeId: string;
+        handle: string;
+    };
+    target: {
+        nodeId: string;
+        handle: string;
+    };
+    sourceTypeId?: string;
+    targetTypeId?: string;
+    err: unknown;
+};
+export type RegistryError = {
+    kind: "registry";
+    message: string;
+    err?: unknown;
+    attempt?: number;
+    maxAttempts?: number;
+};
+export type SystemError = {
+    kind: "system";
+    message: string;
+    code?: string | number;
+    err?: unknown;
+    details?: Record<string, unknown>;
+};
+export type InputValidationError = {
+    kind: "input-validation";
+    nodeId: string;
+    nodeTypeId?: string;
+    handle: string;
+    typeId: string;
+    value: unknown;
+    message: string;
+};
+export type RuntimeError = NodeRunError | EdgeConvertError | RegistryError | SystemError | InputValidationError;
+export interface RuntimeInvalidate {
+    reason: string;
+    deltas?: RegistryDelta[];
+    resolvedHandles?: Record<string, Partial<ResolvedHandles>>;
+}
+export type NodeStartStats = {
+    kind: "node-start";
+    nodeId: string;
+    typeId: string;
+    runId: string;
+};
+export type NodeProgressStats = {
+    kind: "node-progress";
+    nodeId: string;
+    typeId: string;
+    runId: string;
+    progress: number;
+};
+export type NodeDoneStats = {
+    kind: "node-done";
+    nodeId: string;
+    typeId: string;
+    runId: string;
+    durationMs?: number;
+    cancelled?: boolean;
+};
+export type NodeCustomDataStats = {
+    kind: "node-custom-data";
+    nodeId: string;
+    typeId: string;
+    runId: string;
+    data: Record<string, unknown>;
+};
+export type EdgeStartStats = {
+    kind: "edge-start";
+    edgeId: string;
+    typeId?: string;
+    source: {
+        nodeId: string;
+        handle: string;
+    };
+    target: {
+        nodeId: string;
+        handle: string;
+    };
+    sourceTypeId?: string;
+    targetTypeId?: string;
+};
+export type EdgeDoneStats = {
+    kind: "edge-done";
+    edgeId: string;
+    typeId?: string;
+    source: {
+        nodeId: string;
+        handle: string;
+    };
+    target: {
+        nodeId: string;
+        handle: string;
+    };
+    sourceTypeId?: string;
+    targetTypeId?: string;
+    durationMs?: number;
+};
+export type RuntimeStats = NodeStartStats | NodeProgressStats | NodeDoneStats | NodeCustomDataStats | EdgeStartStats | EdgeDoneStats;
+export type Viewport = {
+    x: number;
+    y: number;
+    zoom: number;
+};
+export type RuntimeEvent = {
+    type: "value";
+    payload: RuntimeValue;
+} | {
+    type: "invalidate";
+    payload: RuntimeInvalidate;
+} | {
+    type: "error";
+    payload: RuntimeError;
+} | {
+    type: "stats";
+    payload: RuntimeStats;
+} | {
+    type: "registry";
+    payload: {
+        registry: RegistryDescriptor;
+    };
+} | {
+    type: "registryChanged";
+    payload: {
+        deltas?: RegistryDelta[];
+    };
+} | {
+    type: "viewport";
+    payload: {
+        viewport: Viewport;
+    };
+};
+export type RegistryDelta = {
+    kind: "register-enum";
+    id: string;
+    displayName?: string;
+    options: Array<EnumOption>;
+    bakeTarget?: {
+        nodeTypeId: string;
+        inputHandle: string;
+    };
+    opts?: {
+        withArray?: boolean;
+        arrayId?: string;
+        arrayPickFirstDefined?: boolean;
+    };
+} | {
+    kind: "register-type";
+    id: string;
+    displayName?: string;
+    bakeTarget?: {
+        nodeTypeId: string;
+        inputHandle: string;
+    };
+} | {
+    kind: "register-node";
+    desc: {
+        id: string;
+        categoryId: string;
+        displayName?: string;
+    } & Partial<ResolvedHandles>;
+};
+export interface RegistryDescriptor {
+    types: Array<{
+        id: string;
+        displayName?: string;
+        options?: Array<EnumOption>;
+        bakeTarget?: {
+            nodeTypeId: string;
+            inputHandle: string;
+        };
+    }>;
+    categories: Array<{
+        id: string;
+        displayName?: string;
+    }>;
+    nodes: Array<{
+        id: string;
+        categoryId: string;
+        displayName?: string;
+        policy?: Partial<ExecutionPolicy>;
+    } & ResolvedHandles>;
+    coercions: Array<{
+        from: string;
+        to: string;
+        async?: boolean;
+        nonTransitive?: boolean;
+    }>;
+    schemaVersion: number;
+}
+export interface RuntimeSnapshot {
+    inputs: Record<string, Record<string, unknown>>;
+    outputs: Record<string, Record<string, unknown>>;
+}
+export type NodeRuntimeMetadata = {
+    lastRunAt?: number;
+    lastSuccessAt?: number;
+    lastErrorAt?: number;
+    lastInputAt?: Record<string, number>;
+    lastOutputAt?: Record<string, number>;
+    lastErrorSummary?: {
+        message: string;
+        code?: number;
+    };
+};
+export interface RuntimeMetadata {
+    nodes: Record<string, NodeRuntimeMetadata>;
+}
+export interface RuntimeSnapshotFull extends RuntimeSnapshot {
+    def?: GraphDefinition;
+    environment?: Record<string, unknown>;
+    extData?: {
+        runtime?: RuntimeMetadata;
+    } & Record<string, unknown>;
+}
+export interface RuntimeSnapshotForPatch extends RuntimeSnapshot {
+    def: GraphDefinitionById;
+    environment?: Record<string, unknown>;
+    extData?: {
+        runtime?: RuntimeMetadata;
+    } & Record<string, unknown>;
+}
+export interface RuntimeHistoryInfo {
+    cursor: number;
+    length: number;
+    undoCount: number;
+    redoCount: number;
+}
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+export declare const LOG_LEVEL_VALUES: Record<LogLevel, number>;
+export type LogHandler = (level: LogLevel, message: string, context?: Record<string, unknown>) => void;
+export interface ValueConverterConfig {
+    nodeId: string;
+    handleId: string;
+    value: unknown;
+    type: "input" | "output" | "inputDefault";
+    nodeTypeId?: string;
+    handleDataType?: string;
+    runtimeTypeId?: string;
+}
+export type PathSegment = string | number | RegExp;
+export type JsonPath = string | PathSegment[];
+export interface ValueMappingConfig {
+    handleId?: string | RegExp;
+    nodeId?: string | RegExp;
+    nodeTypeId?: string | RegExp;
+    handleDataType?: string | RegExp;
+    runtimeTypeId?: string | RegExp;
+    transformTypedValue?: boolean;
+    path?: JsonPath;
+    type?: "input" | "output" | "inputDefault";
+    valueMap: Map<string | number | boolean, unknown> | Record<string | number, unknown>;
+}
+export interface ConverterConfig {
+    mappings: ValueMappingConfig[];
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/cjs/src/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}

package/lib/esm/index.js ADDED Viewed

@@ -0,0 +1,10 @@
+const LOG_LEVEL_VALUES = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+export { LOG_LEVEL_VALUES };
+//# sourceMappingURL=index.js.map

package/lib/esm/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["// Shared protocol types for Spark runtime transport (backend side)\nexport type DataTypeId = string;\nexport type NodeCategoryId = string;\nexport type NodeTypeId = string;\nexport type NodeInstanceId = string;\nexport type HandleId = string;\nexport type EdgeInstanceId = string;\n\nexport interface EnumOption {\n value: number;\n label: string;\n meta?: Record<string, unknown>;\n}\n\nexport interface HandleMetadata extends Record<string, unknown> {\n // Numeric constraints (for Float, Int, etc.)\n min?: number;\n max?: number;\n step?: number;\n // Add other metadata fields as needed in the future\n // e.g., unit?: string, precision?: number, etc.\n}\n\nexport type InputDefaultPolicy = \"unbound\" | \"bound\";\n\nexport type InputHandleDescriptor =\n | DataTypeId\n | DataTypeId[]\n | {\n typeId: DataTypeId | DataTypeId[];\n private?: boolean;\n metadata?: HandleMetadata;\n defaultPolicy?: InputDefaultPolicy;\n };\n\nexport type ResolvedHandles = {\n inputs: Record<string, InputHandleDescriptor>;\n outputs: Record<string, DataTypeId | DataTypeId[]>;\n inputDefaults: Record<string, unknown>;\n};\n\n// Execution policy for node execution behavior\nexport interface ExecutionPolicy {\n asyncConcurrency: \"merge\" | \"switch\" | \"queue\" | \"drop\";\n timeoutMs: number;\n maxQueue: number;\n debounceMs: number;\n throttleMs: number;\n retry: { attempts: number; backoffMs: (attemptIndex: number) => number };\n autoRun?: boolean; // When true, node runs automatically on input changes even in manual mode\n rerunOnSameInput?: boolean; // When true, node runs even when inputs haven't changed (e.g., RandomSeed nodes)\n}\n\n// Graph definition types - unified definition used across all Spark packages\nexport interface GraphNodeDefinition {\n nodeId: NodeInstanceId;\n typeId: NodeTypeId;\n params?: Record<string, unknown> & { policy?: Partial<ExecutionPolicy> };\n // Optional per-node resolved handles provided by the builder/remote runtime\n resolvedHandles?: Partial<ResolvedHandles>;\n}\n\nexport interface GraphEdgeDefinition {\n id: EdgeInstanceId;\n source: { nodeId: NodeInstanceId; handle: HandleId };\n target: { nodeId: NodeInstanceId; handle: HandleId };\n typeId?: DataTypeId;\n}\n\nexport interface GraphDefinition {\n nodes: GraphNodeDefinition[];\n edges: GraphEdgeDefinition[];\n}\n\n// Canonical graph shape used for patch-friendly persistence.\nexport interface GraphDefinitionById {\n nodesById: Record<NodeInstanceId, GraphNodeDefinition>;\n edgesById: Record<EdgeInstanceId, GraphEdgeDefinition>;\n}\n\nexport type RunMode = \"manual\" | \"auto\";\n\nexport interface RunnerOptions {\n runMode?: RunMode; // default is \"manual\"\n invalidate?: boolean;\n startPaused?: boolean; // If true, runtime starts in paused state\n}\n\n// Common JSON type used across packages\nexport type Json = Record<string, unknown>;\n\nexport interface Envelope<T = unknown> {\n sessionId?: string;\n seq?: number;\n ts?: number;\n message: T;\n}\n\nexport type Command =\n | {\n type: \"Build\";\n payload: {\n def: GraphDefinition;\n environment?: Record<string, unknown>;\n };\n }\n | { type: \"Update\"; payload: { def: GraphDefinition }; dry?: boolean }\n | { type: \"RegistryApply\"; payload: { deltas: RegistryDelta[] } }\n | { type: \"GetEnvironment\" }\n | {\n type: \"SetEnvironment\";\n payload: { environment: Record<string, unknown>; merge?: boolean };\n dry?: boolean;\n }\n | { type: \"DescribeRegistry\" }\n | {\n type: \"TriggerExternal\";\n payload: { nodeId: string; event: unknown };\n dry?: boolean;\n }\n | { type: \"Launch\"; payload: RunnerOptions }\n | {\n type: \"ComputeNode\";\n payload: { nodeId: string };\n }\n | { type: \"RunFromHere\"; payload: { nodeId: string } }\n | { type: \"CancelNodeRuns\"; payload: { nodeIds: string[] } }\n | { type: \"WhenIdle\" }\n | {\n type: \"SetInputs\";\n payload: { nodeId: string; inputs: Record<string, unknown> };\n dry?: boolean;\n }\n | {\n type: \"CopyOutputs\";\n payload: { fromNodeId: string; toNodeId: string };\n dry?: boolean;\n }\n | { type: \"Snapshot\" }\n | { type: \"SnapshotFull\" }\n | {\n type: \"ApplySnapshotFull\";\n payload: RuntimeSnapshotFull;\n skipBuild?: boolean;\n }\n | {\n type: \"Coerce\";\n payload: { from: string; to: string; value: unknown };\n }\n | { type: \"SetExtData\"; payload: Record<string, unknown> }\n | { type: \"UpdateExtData\"; payload: Array<{ path: string; value: unknown }> }\n | { type: \"SetRunMode\"; payload: { runMode: RunMode } }\n | {\n type: \"ConvertSnapshot\";\n payload: { converterConfig: ConverterConfig };\n dry?: boolean;\n }\n | { type: \"Dispose\" }\n | { type: \"Commit\"; payload: { reason?: string } }\n | { type: \"Undo\" }\n | { type: \"Redo\" }\n | { type: \"Pause\" }\n | { type: \"Resume\" };\n\n// Event payloads\nexport interface RuntimeValue {\n nodeId: string;\n handle: string;\n value: unknown;\n io: \"input\" | \"output\";\n // If the value is a union-typed output, this conveys its runtime type id\n runtimeTypeId?: string;\n dry?: boolean;\n}\n\nexport type NodeRunError = {\n kind: \"node-run\";\n nodeId: string;\n nodeTypeId?: string;\n runId: string;\n err: unknown;\n};\n\nexport type EdgeConvertError = {\n kind: \"edge-convert\";\n edgeId: string;\n source: { nodeId: string; handle: string };\n target: { nodeId: string; handle: string };\n sourceTypeId?: string;\n targetTypeId?: string;\n err: unknown;\n};\n\nexport type RegistryError = {\n kind: \"registry\";\n message: string;\n err?: unknown;\n attempt?: number;\n maxAttempts?: number;\n};\n\nexport type SystemError = {\n kind: \"system\";\n message: string;\n code?: string | number;\n err?: unknown;\n details?: Record<string, unknown>;\n};\n\nexport type InputValidationError = {\n kind: \"input-validation\";\n nodeId: string;\n nodeTypeId?: string;\n handle: string;\n typeId: string;\n value: unknown;\n message: string;\n};\n\nexport type RuntimeError = NodeRunError | EdgeConvertError | RegistryError | SystemError | InputValidationError;\n\nexport interface RuntimeInvalidate {\n reason: string;\n // Optional: present when reason === \"registry-changed\"\n deltas?: RegistryDelta[];\n // Optional: present when reason === \"graph-updated\" or \"graph-built\"\n // Maps nodeId to their updated resolvedHandles (only included when handles actually change)\n resolvedHandles?: Record<string, Partial<ResolvedHandles>>;\n}\n\nexport type NodeStartStats = {\n kind: \"node-start\";\n nodeId: string;\n typeId: string;\n runId: string;\n};\n\nexport type NodeProgressStats = {\n kind: \"node-progress\";\n nodeId: string;\n typeId: string;\n runId: string;\n progress: number;\n};\n\nexport type NodeDoneStats = {\n kind: \"node-done\";\n nodeId: string;\n typeId: string;\n runId: string;\n durationMs?: number;\n cancelled?: boolean; // true when node was cancelled (deleted, snapshot, etc.)\n};\n\nexport type NodeCustomDataStats = {\n kind: \"node-custom-data\";\n nodeId: string;\n typeId: string;\n runId: string;\n data: Record<string, unknown>;\n};\n\nexport type EdgeStartStats = {\n kind: \"edge-start\";\n edgeId: string;\n typeId?: string;\n source: { nodeId: string; handle: string };\n target: { nodeId: string; handle: string };\n sourceTypeId?: string;\n targetTypeId?: string;\n};\n\nexport type EdgeDoneStats = {\n kind: \"edge-done\";\n edgeId: string;\n typeId?: string;\n source: { nodeId: string; handle: string };\n target: { nodeId: string; handle: string };\n sourceTypeId?: string;\n targetTypeId?: string;\n durationMs?: number;\n};\n\nexport type RuntimeStats =\n | NodeStartStats\n | NodeProgressStats\n | NodeDoneStats\n | NodeCustomDataStats\n | EdgeStartStats\n | EdgeDoneStats;\n\nexport type Viewport = { x: number; y: number; zoom: number };\n\nexport type RuntimeEvent =\n | { type: \"value\"; payload: RuntimeValue }\n | { type: \"invalidate\"; payload: RuntimeInvalidate }\n | { type: \"error\"; payload: RuntimeError }\n | { type: \"stats\"; payload: RuntimeStats }\n | { type: \"registry\"; payload: { registry: RegistryDescriptor } }\n | { type: \"registryChanged\"; payload: { deltas?: RegistryDelta[] } }\n | { type: \"viewport\"; payload: { viewport: Viewport } };\n\n// Registry mutation protocol\nexport type RegistryDelta =\n | {\n kind: \"register-enum\";\n id: string;\n displayName?: string;\n options: Array<EnumOption>;\n bakeTarget?: { nodeTypeId: string; inputHandle: string };\n opts?: {\n withArray?: boolean;\n arrayId?: string;\n arrayPickFirstDefined?: boolean;\n };\n }\n | {\n kind: \"register-type\";\n id: string;\n displayName?: string;\n bakeTarget?: { nodeTypeId: string; inputHandle: string };\n }\n | {\n kind: \"register-node\";\n desc: {\n id: string;\n categoryId: string;\n displayName?: string;\n } & Partial<ResolvedHandles>;\n };\n\nexport interface RegistryDescriptor {\n types: Array<{\n id: string;\n displayName?: string;\n options?: Array<EnumOption>;\n bakeTarget?: { nodeTypeId: string; inputHandle: string };\n }>;\n categories: Array<{ id: string; displayName?: string }>;\n nodes: Array<\n {\n id: string;\n categoryId: string;\n displayName?: string;\n policy?: Partial<ExecutionPolicy>;\n } & ResolvedHandles\n >;\n coercions: Array<{\n from: string;\n to: string;\n async?: boolean;\n nonTransitive?: boolean;\n }>;\n schemaVersion: number;\n}\n\nexport interface RuntimeSnapshot {\n inputs: Record<string, Record<string, unknown>>;\n outputs: Record<string, Record<string, unknown>>;\n}\n\nexport type NodeRuntimeMetadata = {\n lastRunAt?: number;\n lastSuccessAt?: number;\n lastErrorAt?: number;\n lastInputAt?: Record<string, number>;\n lastOutputAt?: Record<string, number>;\n lastErrorSummary?: { message: string; code?: number };\n};\n\nexport interface RuntimeMetadata {\n nodes: Record<string, NodeRuntimeMetadata>;\n}\n\nexport interface RuntimeSnapshotFull extends RuntimeSnapshot {\n def?: GraphDefinition;\n environment?: Record<string, unknown>;\n extData?: { runtime?: RuntimeMetadata } & Record<string, unknown>;\n}\n\n// Snapshot variant used by persistence layers that patch by stable IDs.\nexport interface RuntimeSnapshotForPatch extends RuntimeSnapshot {\n def: GraphDefinitionById;\n environment?: Record<string, unknown>;\n extData?: { runtime?: RuntimeMetadata } & Record<string, unknown>;\n}\n\nexport interface RuntimeHistoryInfo {\n cursor: number;\n length: number;\n undoCount: number;\n redoCount: number;\n}\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"silent\";\n\nexport const LOG_LEVEL_VALUES: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n silent: 4,\n};\n\nexport type LogHandler = (level: LogLevel, message: string, context?: Record<string, unknown>) => void;\n\nexport interface ValueConverterConfig {\n nodeId: string;\n handleId: string;\n value: unknown;\n type: \"input\" | \"output\" | \"inputDefault\";\n nodeTypeId?: string;\n handleDataType?: string;\n runtimeTypeId?: string;\n}\n\nexport type PathSegment = string | number | RegExp;\nexport type JsonPath = string | PathSegment[];\n\nexport interface ValueMappingConfig {\n handleId?: string | RegExp;\n nodeId?: string | RegExp;\n nodeTypeId?: string | RegExp;\n handleDataType?: string | RegExp;\n runtimeTypeId?: string | RegExp;\n transformTypedValue?: boolean;\n path?: JsonPath;\n type?: \"input\" | \"output\" | \"inputDefault\";\n valueMap: Map<string | number | boolean, unknown> | Record<string | number, unknown>;\n}\n\nexport interface ConverterConfig {\n mappings: ValueMappingConfig[];\n}\n"],"names":[],"mappings":"AA4YO,MAAM,gBAAgB,GAA6B;AACxD,IAAA,KAAK,EAAE,CAAC;AACR,IAAA,IAAI,EAAE,CAAC;AACP,IAAA,IAAI,EAAE,CAAC;AACP,IAAA,KAAK,EAAE,CAAC;AACR,IAAA,MAAM,EAAE,CAAC;;;;;"}

package/lib/esm/src/index.d.ts ADDED Viewed

@@ -0,0 +1,479 @@
+export type DataTypeId = string;
+export type NodeCategoryId = string;
+export type NodeTypeId = string;
+export type NodeInstanceId = string;
+export type HandleId = string;
+export type EdgeInstanceId = string;
+export interface EnumOption {
+    value: number;
+    label: string;
+    meta?: Record<string, unknown>;
+}
+export interface HandleMetadata extends Record<string, unknown> {
+    min?: number;
+    max?: number;
+    step?: number;
+}
+export type InputDefaultPolicy = "unbound" | "bound";
+export type InputHandleDescriptor = DataTypeId | DataTypeId[] | {
+    typeId: DataTypeId | DataTypeId[];
+    private?: boolean;
+    metadata?: HandleMetadata;
+    defaultPolicy?: InputDefaultPolicy;
+};
+export type ResolvedHandles = {
+    inputs: Record<string, InputHandleDescriptor>;
+    outputs: Record<string, DataTypeId | DataTypeId[]>;
+    inputDefaults: Record<string, unknown>;
+};
+export interface ExecutionPolicy {
+    asyncConcurrency: "merge" | "switch" | "queue" | "drop";
+    timeoutMs: number;
+    maxQueue: number;
+    debounceMs: number;
+    throttleMs: number;
+    retry: {
+        attempts: number;
+        backoffMs: (attemptIndex: number) => number;
+    };
+    autoRun?: boolean;
+    rerunOnSameInput?: boolean;
+}
+export interface GraphNodeDefinition {
+    nodeId: NodeInstanceId;
+    typeId: NodeTypeId;
+    params?: Record<string, unknown> & {
+        policy?: Partial<ExecutionPolicy>;
+    };
+    resolvedHandles?: Partial<ResolvedHandles>;
+}
+export interface GraphEdgeDefinition {
+    id: EdgeInstanceId;
+    source: {
+        nodeId: NodeInstanceId;
+        handle: HandleId;
+    };
+    target: {
+        nodeId: NodeInstanceId;
+        handle: HandleId;
+    };
+    typeId?: DataTypeId;
+}
+export interface GraphDefinition {
+    nodes: GraphNodeDefinition[];
+    edges: GraphEdgeDefinition[];
+}
+export interface GraphDefinitionById {
+    nodesById: Record<NodeInstanceId, GraphNodeDefinition>;
+    edgesById: Record<EdgeInstanceId, GraphEdgeDefinition>;
+}
+export type RunMode = "manual" | "auto";
+export interface RunnerOptions {
+    runMode?: RunMode;
+    invalidate?: boolean;
+    startPaused?: boolean;
+}
+export type Json = Record<string, unknown>;
+export interface Envelope<T = unknown> {
+    sessionId?: string;
+    seq?: number;
+    ts?: number;
+    message: T;
+}
+export type Command = {
+    type: "Build";
+    payload: {
+        def: GraphDefinition;
+        environment?: Record<string, unknown>;
+    };
+} | {
+    type: "Update";
+    payload: {
+        def: GraphDefinition;
+    };
+    dry?: boolean;
+} | {
+    type: "RegistryApply";
+    payload: {
+        deltas: RegistryDelta[];
+    };
+} | {
+    type: "GetEnvironment";
+} | {
+    type: "SetEnvironment";
+    payload: {
+        environment: Record<string, unknown>;
+        merge?: boolean;
+    };
+    dry?: boolean;
+} | {
+    type: "DescribeRegistry";
+} | {
+    type: "TriggerExternal";
+    payload: {
+        nodeId: string;
+        event: unknown;
+    };
+    dry?: boolean;
+} | {
+    type: "Launch";
+    payload: RunnerOptions;
+} | {
+    type: "ComputeNode";
+    payload: {
+        nodeId: string;
+    };
+} | {
+    type: "RunFromHere";
+    payload: {
+        nodeId: string;
+    };
+} | {
+    type: "CancelNodeRuns";
+    payload: {
+        nodeIds: string[];
+    };
+} | {
+    type: "WhenIdle";
+} | {
+    type: "SetInputs";
+    payload: {
+        nodeId: string;
+        inputs: Record<string, unknown>;
+    };
+    dry?: boolean;
+} | {
+    type: "CopyOutputs";
+    payload: {
+        fromNodeId: string;
+        toNodeId: string;
+    };
+    dry?: boolean;
+} | {
+    type: "Snapshot";
+} | {
+    type: "SnapshotFull";
+} | {
+    type: "ApplySnapshotFull";
+    payload: RuntimeSnapshotFull;
+    skipBuild?: boolean;
+} | {
+    type: "Coerce";
+    payload: {
+        from: string;
+        to: string;
+        value: unknown;
+    };
+} | {
+    type: "SetExtData";
+    payload: Record<string, unknown>;
+} | {
+    type: "UpdateExtData";
+    payload: Array<{
+        path: string;
+        value: unknown;
+    }>;
+} | {
+    type: "SetRunMode";
+    payload: {
+        runMode: RunMode;
+    };
+} | {
+    type: "ConvertSnapshot";
+    payload: {
+        converterConfig: ConverterConfig;
+    };
+    dry?: boolean;
+} | {
+    type: "Dispose";
+} | {
+    type: "Commit";
+    payload: {
+        reason?: string;
+    };
+} | {
+    type: "Undo";
+} | {
+    type: "Redo";
+} | {
+    type: "Pause";
+} | {
+    type: "Resume";
+};
+export interface RuntimeValue {
+    nodeId: string;
+    handle: string;
+    value: unknown;
+    io: "input" | "output";
+    runtimeTypeId?: string;
+    dry?: boolean;
+}
+export type NodeRunError = {
+    kind: "node-run";
+    nodeId: string;
+    nodeTypeId?: string;
+    runId: string;
+    err: unknown;
+};
+export type EdgeConvertError = {
+    kind: "edge-convert";
+    edgeId: string;
+    source: {
+        nodeId: string;
+        handle: string;
+    };
+    target: {
+        nodeId: string;
+        handle: string;
+    };
+    sourceTypeId?: string;
+    targetTypeId?: string;
+    err: unknown;
+};
+export type RegistryError = {
+    kind: "registry";
+    message: string;
+    err?: unknown;
+    attempt?: number;
+    maxAttempts?: number;
+};
+export type SystemError = {
+    kind: "system";
+    message: string;
+    code?: string | number;
+    err?: unknown;
+    details?: Record<string, unknown>;
+};
+export type InputValidationError = {
+    kind: "input-validation";
+    nodeId: string;
+    nodeTypeId?: string;
+    handle: string;
+    typeId: string;
+    value: unknown;
+    message: string;
+};
+export type RuntimeError = NodeRunError | EdgeConvertError | RegistryError | SystemError | InputValidationError;
+export interface RuntimeInvalidate {
+    reason: string;
+    deltas?: RegistryDelta[];
+    resolvedHandles?: Record<string, Partial<ResolvedHandles>>;
+}
+export type NodeStartStats = {
+    kind: "node-start";
+    nodeId: string;
+    typeId: string;
+    runId: string;
+};
+export type NodeProgressStats = {
+    kind: "node-progress";
+    nodeId: string;
+    typeId: string;
+    runId: string;
+    progress: number;
+};
+export type NodeDoneStats = {
+    kind: "node-done";
+    nodeId: string;
+    typeId: string;
+    runId: string;
+    durationMs?: number;
+    cancelled?: boolean;
+};
+export type NodeCustomDataStats = {
+    kind: "node-custom-data";
+    nodeId: string;
+    typeId: string;
+    runId: string;
+    data: Record<string, unknown>;
+};
+export type EdgeStartStats = {
+    kind: "edge-start";
+    edgeId: string;
+    typeId?: string;
+    source: {
+        nodeId: string;
+        handle: string;
+    };
+    target: {
+        nodeId: string;
+        handle: string;
+    };
+    sourceTypeId?: string;
+    targetTypeId?: string;
+};
+export type EdgeDoneStats = {
+    kind: "edge-done";
+    edgeId: string;
+    typeId?: string;
+    source: {
+        nodeId: string;
+        handle: string;
+    };
+    target: {
+        nodeId: string;
+        handle: string;
+    };
+    sourceTypeId?: string;
+    targetTypeId?: string;
+    durationMs?: number;
+};
+export type RuntimeStats = NodeStartStats | NodeProgressStats | NodeDoneStats | NodeCustomDataStats | EdgeStartStats | EdgeDoneStats;
+export type Viewport = {
+    x: number;
+    y: number;
+    zoom: number;
+};
+export type RuntimeEvent = {
+    type: "value";
+    payload: RuntimeValue;
+} | {
+    type: "invalidate";
+    payload: RuntimeInvalidate;
+} | {
+    type: "error";
+    payload: RuntimeError;
+} | {
+    type: "stats";
+    payload: RuntimeStats;
+} | {
+    type: "registry";
+    payload: {
+        registry: RegistryDescriptor;
+    };
+} | {
+    type: "registryChanged";
+    payload: {
+        deltas?: RegistryDelta[];
+    };
+} | {
+    type: "viewport";
+    payload: {
+        viewport: Viewport;
+    };
+};
+export type RegistryDelta = {
+    kind: "register-enum";
+    id: string;
+    displayName?: string;
+    options: Array<EnumOption>;
+    bakeTarget?: {
+        nodeTypeId: string;
+        inputHandle: string;
+    };
+    opts?: {
+        withArray?: boolean;
+        arrayId?: string;
+        arrayPickFirstDefined?: boolean;
+    };
+} | {
+    kind: "register-type";
+    id: string;
+    displayName?: string;
+    bakeTarget?: {
+        nodeTypeId: string;
+        inputHandle: string;
+    };
+} | {
+    kind: "register-node";
+    desc: {
+        id: string;
+        categoryId: string;
+        displayName?: string;
+    } & Partial<ResolvedHandles>;
+};
+export interface RegistryDescriptor {
+    types: Array<{
+        id: string;
+        displayName?: string;
+        options?: Array<EnumOption>;
+        bakeTarget?: {
+            nodeTypeId: string;
+            inputHandle: string;
+        };
+    }>;
+    categories: Array<{
+        id: string;
+        displayName?: string;
+    }>;
+    nodes: Array<{
+        id: string;
+        categoryId: string;
+        displayName?: string;
+        policy?: Partial<ExecutionPolicy>;
+    } & ResolvedHandles>;
+    coercions: Array<{
+        from: string;
+        to: string;
+        async?: boolean;
+        nonTransitive?: boolean;
+    }>;
+    schemaVersion: number;
+}
+export interface RuntimeSnapshot {
+    inputs: Record<string, Record<string, unknown>>;
+    outputs: Record<string, Record<string, unknown>>;
+}
+export type NodeRuntimeMetadata = {
+    lastRunAt?: number;
+    lastSuccessAt?: number;
+    lastErrorAt?: number;
+    lastInputAt?: Record<string, number>;
+    lastOutputAt?: Record<string, number>;
+    lastErrorSummary?: {
+        message: string;
+        code?: number;
+    };
+};
+export interface RuntimeMetadata {
+    nodes: Record<string, NodeRuntimeMetadata>;
+}
+export interface RuntimeSnapshotFull extends RuntimeSnapshot {
+    def?: GraphDefinition;
+    environment?: Record<string, unknown>;
+    extData?: {
+        runtime?: RuntimeMetadata;
+    } & Record<string, unknown>;
+}
+export interface RuntimeSnapshotForPatch extends RuntimeSnapshot {
+    def: GraphDefinitionById;
+    environment?: Record<string, unknown>;
+    extData?: {
+        runtime?: RuntimeMetadata;
+    } & Record<string, unknown>;
+}
+export interface RuntimeHistoryInfo {
+    cursor: number;
+    length: number;
+    undoCount: number;
+    redoCount: number;
+}
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+export declare const LOG_LEVEL_VALUES: Record<LogLevel, number>;
+export type LogHandler = (level: LogLevel, message: string, context?: Record<string, unknown>) => void;
+export interface ValueConverterConfig {
+    nodeId: string;
+    handleId: string;
+    value: unknown;
+    type: "input" | "output" | "inputDefault";
+    nodeTypeId?: string;
+    handleDataType?: string;
+    runtimeTypeId?: string;
+}
+export type PathSegment = string | number | RegExp;
+export type JsonPath = string | PathSegment[];
+export interface ValueMappingConfig {
+    handleId?: string | RegExp;
+    nodeId?: string | RegExp;
+    nodeTypeId?: string | RegExp;
+    handleDataType?: string | RegExp;
+    runtimeTypeId?: string | RegExp;
+    transformTypedValue?: boolean;
+    path?: JsonPath;
+    type?: "input" | "output" | "inputDefault";
+    valueMap: Map<string | number | boolean, unknown> | Record<string | number, unknown>;
+}
+export interface ConverterConfig {
+    mappings: ValueMappingConfig[];
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/esm/src/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

package/package.json ADDED Viewed

@@ -0,0 +1,46 @@
+{
+  "name": "@womp/spark-protocol",
+  "version": "0.3.92",
+  "description": "Spark Protocol - Communication protocol for distributed graph execution",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./lib/cjs/index.cjs",
+  "module": "./lib/esm/index.js",
+  "types": "./lib/esm/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/esm/src/index.d.ts",
+      "import": "./lib/esm/index.js",
+      "require": "./lib/cjs/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "rimraf dist lib",
+    "build": "rollup -c",
+    "build:tsc": "tsc -p tsconfig.json",
+    "prepublishOnly": "yarn build",
+    "prepack": "yarn build"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "prettier": "^3.8.1",
+    "pretty-quick": "^4.2.2",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.46.1",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "typescript": "5.6.3"
+  }
+}