@oomol-lab/open-flow 0.1.0-beta.25 → 0.1.0-beta.26

package/dist/common/engine-contract.d.ts

@@ -4,6 +4,6 @@ export interface EngineContract {
     readonly platformModule: string;
     readonly platformSource: string;
 }
-export declare const currentEngineContract = "open-flow-engine/v3";
-export declare const nodejsEngineContract = "open-flow-engine/v3/nodejs-compat-v1";
+export declare const currentEngineContract = "open-flow-engine/v4";
+export declare const nodejsEngineContract = "open-flow-engine/v4/nodejs-compat-v1";
 export declare function findEngineContract(contract: string): EngineContract | undefined;

package/dist/common/flow-graph.d.ts

@@ -1,14 +1,36 @@
-import type { FlowDocument, Graph, GraphNode, InputPortDefinition, PortDefinition, RevisionContent } from '../browser/flow-change.js';
+import type { FlowDocument, Graph, GraphNode, InputPortDefinition, PortDefinition, RevisionContent, SchemaMismatch } from '../browser/flow-change.js';
 import type { Diagnostic, SemanticClosure } from './flow-semantics.js';
 export declare function nodeInputPorts(document: FlowDocument, node: GraphNode): Readonly<Record<string, InputPortDefinition>>;
 export declare function waitOutputPorts(node: Extract<GraphNode, {
     readonly kind: 'wait';
 }>): Readonly<Record<string, PortDefinition>>;
 export declare function graphOrder(graph: Graph): readonly string[];
+export type InputSourceCheck = {
+    readonly kind: 'available';
+} | {
+    readonly kind: 'source-missing';
+} | {
+    readonly kind: 'output-missing';
+} | {
+    readonly kind: 'not-ready';
+} | {
+    readonly kind: 'schema';
+    readonly mismatch: SchemaMismatch;
+} | {
+    readonly kind: 'schema-error';
+};
+export interface InputSourcesCheck {
+    readonly conflict: boolean;
+    readonly sources: readonly InputSourceCheck[];
+}
 /** Check one saved binding without enumerating candidate ports. */
-export declare function inputSourceAvailable(document: FlowDocument, graph: Graph, target: string, handle: string, source: {
+export declare function checkInputSource(document: FlowDocument, graph: Graph, target: string, handle: string, source: {
     nodeId: string;
     output: string;
-}): boolean;
+}): InputSourceCheck;
+export declare function checkInputSources(document: FlowDocument, graph: Graph, target: string, handle: string, sources: readonly {
+    readonly nodeId: string;
+    readonly output: string;
+}[]): InputSourcesCheck;
 export declare function availableOutputs(document: FlowDocument, graph: Graph, target: string, handle?: string): Readonly<Record<string, readonly string[]>>;
 export declare function validateFlowGraph(revision: RevisionContent, closure: SemanticClosure): readonly Diagnostic[];

package/dist/common/flow-schema.d.ts

@@ -1,8 +1,18 @@
-import type { JsonValue, PortDefinition, TriggerNode } from '../browser/flow-change.js';
+import type { JsonValue, PortDefinition, SchemaMismatch, TriggerNode } from '../browser/flow-change.js';
 export declare function triggerPayloadSchema(trigger: TriggerNode): JsonValue;
 export declare function schemaObject(schema: JsonValue): Readonly<Record<string, JsonValue>> | undefined;
 export declare function schemaList(value: JsonValue | undefined): readonly JsonValue[] | undefined;
 export declare function matchesSchema(value: JsonValue, schema: JsonValue): boolean;
+export type PortCompareResult = {
+    readonly kind: 'compatible';
+} | {
+    readonly kind: 'compare-error';
+    readonly message: string;
+} | {
+    readonly kind: 'incompatible';
+    readonly mismatch: SchemaMismatch;
+};
+export declare function comparePorts(source: PortDefinition, target: PortDefinition): PortCompareResult;
 export declare function portsAssignable(source: PortDefinition, target: PortDefinition): boolean;
 export declare function variableInputCompatible(jsonSchema: JsonValue): boolean;
 export declare function hasRetiredRef(value: unknown): boolean;

package/dist/common/flow-semantics.d.ts

@@ -1,6 +1,6 @@
 import type { EngineContract } from './engine-contract.js';
 import type { RuntimeProgram } from './runtime-contract.js';
-import type { ConnectorCapability, FlowDocument, Graph, RevisionContent } from '../browser/flow-change.js';
+import type { ConnectorCapability, FlowDocument, Graph, RevisionContent, SchemaMismatch } from '../browser/flow-change.js';
 export { availableOutputs, graphOrder, nodeInputPorts } from './flow-graph.js';
 export { validateModules } from './flow-modules.js';
 export { matchesSchema, triggerPayloadSchema, variableInputCompatible } from './flow-schema.js';
@@ -23,6 +23,7 @@ export interface Diagnostic {
     readonly column: number;
     readonly line: number;
     readonly message: string;
+    readonly mismatch?: SchemaMismatch;
     readonly path: string;
     readonly values?: Readonly<Record<string, string | number>>;
 }