@decaf-ts/integrations 0.8.0 → 0.10.0

package/lib/types/secrets/vault/VaultSecretService.d.cts

@@ -1,7 +1,7 @@
-import { SecretProvider } from "../../secrets/core/index.d.cts";
+import { ClientBasedSecretService, SecretProvider } from "../../secrets/core/index.d.cts";
 import { SecretName, SecretPayload, SecretReference, SecretMetadata } from "../../secrets/core/index.d.cts";
 import { StoreSecretOptions, ListSecretsOptions } from "../../secrets/core/index.d.cts";
-import { ClientBasedService, type MaybeContextualArg } from "@decaf-ts/core";
+import { type MaybeContextualArg } from "@decaf-ts/core";
 import { VaultSecretServiceConfig } from "./VaultSecretServiceConfig.d.cts";
 export declare class VaultKvV2Client {
     private baseUrl;
@@ -21,8 +21,9 @@ export declare class VaultKvV2Client {
     list(path: string): Promise<string[]>;
     metadata(path: string): Promise<any>;
 }
-export declare class VaultSecretService extends ClientBasedService<VaultKvV2Client, VaultSecretServiceConfig> {
+export declare class VaultSecretService extends ClientBasedSecretService<VaultKvV2Client, VaultSecretServiceConfig> {
     readonly provider: SecretProvider;
+    protected configFromEnvironment(): VaultSecretServiceConfig | undefined;
     initialize(...args: MaybeContextualArg<any>): Promise<{
         config: VaultSecretServiceConfig;
         client: VaultKvV2Client;

package/lib/types/secrets/vault/VaultSecretService.d.mts

@@ -1,7 +1,7 @@
-import { SecretProvider } from "../../secrets/core/index.d.mts";
+import { ClientBasedSecretService, SecretProvider } from "../../secrets/core/index.d.mts";
 import { SecretName, SecretPayload, SecretReference, SecretMetadata } from "../../secrets/core/index.d.mts";
 import { StoreSecretOptions, ListSecretsOptions } from "../../secrets/core/index.d.mts";
-import { ClientBasedService, type MaybeContextualArg } from "@decaf-ts/core";
+import { type MaybeContextualArg } from "@decaf-ts/core";
 import { VaultSecretServiceConfig } from "./VaultSecretServiceConfig.d.mts";
 export declare class VaultKvV2Client {
     private baseUrl;
@@ -21,8 +21,9 @@ export declare class VaultKvV2Client {
     list(path: string): Promise<string[]>;
     metadata(path: string): Promise<any>;
 }
-export declare class VaultSecretService extends ClientBasedService<VaultKvV2Client, VaultSecretServiceConfig> {
+export declare class VaultSecretService extends ClientBasedSecretService<VaultKvV2Client, VaultSecretServiceConfig> {
     readonly provider: SecretProvider;
+    protected configFromEnvironment(): VaultSecretServiceConfig | undefined;
     initialize(...args: MaybeContextualArg<any>): Promise<{
         config: VaultSecretServiceConfig;
         client: VaultKvV2Client;

package/lib/types/secrets/vault/index.d.cts

@@ -5,3 +5,4 @@
  */
 export * from "./VaultSecretService.d.cts";
 export * from "./VaultSecretServiceConfig.d.cts";
+export * from "./VaultSecretEnvironment.d.cts";

package/lib/types/secrets/vault/index.d.mts

@@ -5,3 +5,4 @@
  */
 export * from "./VaultSecretService.d.mts";
 export * from "./VaultSecretServiceConfig.d.mts";
+export * from "./VaultSecretEnvironment.d.mts";

package/lib/types/sftp/aws/AwsSftpEnvironment.d.cts

@@ -0,0 +1,24 @@
+export interface AwsSftpEnvironmentConfig {
+    sourceId: string;
+    host: string;
+    port?: number;
+    username: string;
+    password?: string;
+    privateKey?: string;
+    passphrase?: string;
+    remotePath?: string;
+    region: string;
+    bucket: string;
+    s3Prefix?: string;
+    serverId?: string;
+}
+export interface AwsSftpEnvironmentShape {
+    sftp: {
+        aws: AwsSftpEnvironmentConfig;
+    };
+}
+export declare const AwsSftpEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").SftpCommonEnvironmentShape & AwsSftpEnvironmentShape>;

package/lib/types/sftp/aws/AwsSftpEnvironment.d.mts

@@ -0,0 +1,24 @@
+export interface AwsSftpEnvironmentConfig {
+    sourceId: string;
+    host: string;
+    port?: number;
+    username: string;
+    password?: string;
+    privateKey?: string;
+    passphrase?: string;
+    remotePath?: string;
+    region: string;
+    bucket: string;
+    s3Prefix?: string;
+    serverId?: string;
+}
+export interface AwsSftpEnvironmentShape {
+    sftp: {
+        aws: AwsSftpEnvironmentConfig;
+    };
+}
+export declare const AwsSftpEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").SftpCommonEnvironmentShape & AwsSftpEnvironmentShape>;

package/lib/types/sftp/aws/AwsSftpService.d.cts

@@ -24,6 +24,7 @@ interface S3LikeClient {
 }
 export declare class AwsSftpService extends SftpSource<S3LikeClient, AwsTransferSftpConfig> {
     constructor();
+    protected configFromEnvironment(): AwsTransferSftpConfig | undefined;
     initialize(...args: ContextualArgs<any>): Promise<{
         config: AwsTransferSftpConfig;
         client: S3LikeClient;

package/lib/types/sftp/aws/AwsSftpService.d.mts

@@ -24,6 +24,7 @@ interface S3LikeClient {
 }
 export declare class AwsSftpService extends SftpSource<S3LikeClient, AwsTransferSftpConfig> {
     constructor();
+    protected configFromEnvironment(): AwsTransferSftpConfig | undefined;
     initialize(...args: ContextualArgs<any>): Promise<{
         config: AwsTransferSftpConfig;
         client: S3LikeClient;

package/lib/types/sftp/core/SftpEnvironment.d.cts

@@ -0,0 +1,11 @@
+import type { SftpProvider } from "./SftpSource.d.cts";
+export interface SftpCommonEnvironmentShape {
+    sftp: {
+        provider: SftpProvider;
+    };
+}
+export declare const SftpEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & SftpCommonEnvironmentShape>;

package/lib/types/sftp/core/SftpEnvironment.d.mts

@@ -0,0 +1,11 @@
+import type { SftpProvider } from "./SftpSource.d.mts";
+export interface SftpCommonEnvironmentShape {
+    sftp: {
+        provider: SftpProvider;
+    };
+}
+export declare const SftpEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & SftpCommonEnvironmentShape>;

package/lib/types/sftp/core/SftpSource.d.cts

@@ -36,5 +36,12 @@ export declare abstract class SftpSource<TClient = unknown, TConfig extends Sftp
     abstract fetch(remotePath: string, ...args: MaybeContextualArg<any>): Promise<SftpFileResult>;
     abstract delete(remotePath: string, ...args: MaybeContextualArg<any>): Promise<void>;
     abstract close(...args: MaybeContextualArg<any>): Promise<void>;
+    protected getConfigFromArgs<TExpected extends TConfig>(...args: MaybeContextualArg<any>): TExpected;
+    /**
+     * @description Builds a config from the provider's environment as a fallback.
+     * @summary Providers must override this to read from their own `sftp.<provider>`
+     * environment slice.
+     */
+    protected abstract configFromEnvironment(): TConfig | undefined;
 }
 export declare function assertSftpConfig(config: SftpSourceConfig): void;

package/lib/types/sftp/core/SftpSource.d.mts

@@ -36,5 +36,12 @@ export declare abstract class SftpSource<TClient = unknown, TConfig extends Sftp
     abstract fetch(remotePath: string, ...args: MaybeContextualArg<any>): Promise<SftpFileResult>;
     abstract delete(remotePath: string, ...args: MaybeContextualArg<any>): Promise<void>;
     abstract close(...args: MaybeContextualArg<any>): Promise<void>;
+    protected getConfigFromArgs<TExpected extends TConfig>(...args: MaybeContextualArg<any>): TExpected;
+    /**
+     * @description Builds a config from the provider's environment as a fallback.
+     * @summary Providers must override this to read from their own `sftp.<provider>`
+     * environment slice.
+     */
+    protected abstract configFromEnvironment(): TConfig | undefined;
 }
 export declare function assertSftpConfig(config: SftpSourceConfig): void;

package/lib/types/sftp/core/index.d.cts

@@ -1 +1,2 @@
 export * from "./SftpSource.d.cts";
+export * from "./SftpEnvironment.d.cts";

package/lib/types/sftp/core/index.d.mts

@@ -1 +1,2 @@
 export * from "./SftpSource.d.mts";
+export * from "./SftpEnvironment.d.mts";

package/lib/types/sftp/index.d.cts

@@ -1,3 +1,6 @@
 export * from "./ssh2/Ssh2SftpService.d.cts";
+export * from "./ssh2/Ssh2SftpEnvironment.d.cts";
 export * from "./aws/AwsSftpService.d.cts";
+export * from "./aws/AwsSftpEnvironment.d.cts";
 export * from "./core/SftpSource.d.cts";
+export * from "./core/SftpEnvironment.d.cts";

package/lib/types/sftp/index.d.mts

@@ -1,3 +1,6 @@
 export * from "./ssh2/Ssh2SftpService.d.mts";
+export * from "./ssh2/Ssh2SftpEnvironment.d.mts";
 export * from "./aws/AwsSftpService.d.mts";
+export * from "./aws/AwsSftpEnvironment.d.mts";
 export * from "./core/SftpSource.d.mts";
+export * from "./core/SftpEnvironment.d.mts";

package/lib/types/sftp/ssh2/Ssh2SftpEnvironment.d.cts

@@ -0,0 +1,21 @@
+export interface Ssh2SftpEnvironmentConfig {
+    sourceId: string;
+    host: string;
+    port?: number;
+    username: string;
+    password?: string;
+    privateKey?: string;
+    passphrase?: string;
+    remotePath?: string;
+    readyTimeout?: number;
+}
+export interface Ssh2SftpEnvironmentShape {
+    sftp: {
+        ssh2: Ssh2SftpEnvironmentConfig;
+    };
+}
+export declare const Ssh2SftpEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").SftpCommonEnvironmentShape & Ssh2SftpEnvironmentShape>;

package/lib/types/sftp/ssh2/Ssh2SftpEnvironment.d.mts

@@ -0,0 +1,21 @@
+export interface Ssh2SftpEnvironmentConfig {
+    sourceId: string;
+    host: string;
+    port?: number;
+    username: string;
+    password?: string;
+    privateKey?: string;
+    passphrase?: string;
+    remotePath?: string;
+    readyTimeout?: number;
+}
+export interface Ssh2SftpEnvironmentShape {
+    sftp: {
+        ssh2: Ssh2SftpEnvironmentConfig;
+    };
+}
+export declare const Ssh2SftpEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").SftpCommonEnvironmentShape & Ssh2SftpEnvironmentShape>;

package/lib/types/sftp/ssh2/Ssh2SftpService.d.cts

@@ -34,6 +34,7 @@ interface Ssh2SftpHandle {
 export declare class Ssh2SftpService extends SftpSource<Ssh2Client, Ssh2SftpConfig> {
     private sftp?;
     constructor();
+    protected configFromEnvironment(): Ssh2SftpConfig | undefined;
     initialize(...args: ContextualArgs<any>): Promise<{
         config: Ssh2SftpConfig;
         client: Ssh2Client;

package/lib/types/sftp/ssh2/Ssh2SftpService.d.mts

@@ -34,6 +34,7 @@ interface Ssh2SftpHandle {
 export declare class Ssh2SftpService extends SftpSource<Ssh2Client, Ssh2SftpConfig> {
     private sftp?;
     constructor();
+    protected configFromEnvironment(): Ssh2SftpConfig | undefined;
     initialize(...args: ContextualArgs<any>): Promise<{
         config: Ssh2SftpConfig;
         client: Ssh2Client;

package/lib/types/shared/environmentValue.d.cts

@@ -0,0 +1,16 @@
+/**
+ * @module integrations/shared/environment-value
+ * @summary Helpers for reading primitive values out of decaf-ts Environment instances.
+ * @description `@decaf-ts/logging`'s `Environment` resolves an unset leaf property to a
+ * Proxy object rather than `undefined` when it is reached through a path that was not
+ * part of the model captured by the last `.accumulate()` call for that root key (the
+ * proxy exists so callers can still compose the fully-qualified env-var key name via
+ * `String(...)`). Such proxies are objects, so they are truthy and pass straight through
+ * a bare `if (!value)` check, and they do not have the shape callers expect (e.g. no
+ * `.replace` on what looks like a string). Every `configFromEnvironment()` implementation
+ * must use these helpers instead of a raw truthiness check, both to decide whether a
+ * field was really configured and to build the config object it returns.
+ */
+export declare function envString(value: unknown): string | undefined;
+export declare function envNumber(value: unknown): number | undefined;
+export declare function envBoolean(value: unknown): boolean | undefined;

package/lib/types/shared/environmentValue.d.mts

@@ -0,0 +1,16 @@
+/**
+ * @module integrations/shared/environment-value
+ * @summary Helpers for reading primitive values out of decaf-ts Environment instances.
+ * @description `@decaf-ts/logging`'s `Environment` resolves an unset leaf property to a
+ * Proxy object rather than `undefined` when it is reached through a path that was not
+ * part of the model captured by the last `.accumulate()` call for that root key (the
+ * proxy exists so callers can still compose the fully-qualified env-var key name via
+ * `String(...)`). Such proxies are objects, so they are truthy and pass straight through
+ * a bare `if (!value)` check, and they do not have the shape callers expect (e.g. no
+ * `.replace` on what looks like a string). Every `configFromEnvironment()` implementation
+ * must use these helpers instead of a raw truthiness check, both to decide whether a
+ * field was really configured and to build the config object it returns.
+ */
+export declare function envString(value: unknown): string | undefined;
+export declare function envNumber(value: unknown): number | undefined;
+export declare function envBoolean(value: unknown): boolean | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/integrations",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.mts",
@@ -258,6 +258,17 @@
       },
       "default": "./lib/esm/blob/memory/index.js"
     },
+    "./calendar": {
+      "import": {
+        "types": "./lib/types/calendar/index.d.mts",
+        "default": "./lib/esm/calendar/index.js"
+      },
+      "require": {
+        "types": "./lib/types/calendar/index.d.cts",
+        "default": "./lib/cjs/calendar/index.cjs"
+      },
+      "default": "./lib/esm/calendar/index.js"
+    },
     "./graph": {
       "import": {
         "types": "./lib/types/graph/index.d.mts",
@@ -280,17 +291,6 @@
       },
       "default": "./lib/esm/sftp/index.js"
     },
-    "./graph/shared": {
-      "import": {
-        "types": "./lib/types/graph/shared/index.d.mts",
-        "default": "./lib/esm/graph/shared/index.js"
-      },
-      "require": {
-        "types": "./lib/types/graph/shared/index.d.cts",
-        "default": "./lib/cjs/graph/shared/index.cjs"
-      },
-      "default": "./lib/esm/graph/shared/index.js"
-    },
     "./plugins": {
       "import": {
         "types": "./lib/types/plugins/index.d.mts",
@@ -342,16 +342,16 @@
     "test:unit": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --testPathPatterns=\"/tests/unit\" --passWithNoTests --detectOpenHandles",
     "test:integration": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --testPathPatterns=\"/tests/(integration)\" --passWithNoTests --detectOpenHandles",
     "test:e2e": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --testPathPatterns=\"/tests/(e2e)\" --passWithNoTests --detectOpenHandles",
-    "test:e2e:plugins": "npx playwright test --config tests/e2e/plugins/playwright.config.ts --project chromium",
-    "test:e2e:plugins:kibana": "npx playwright test --config tests/e2e/plugins/playwright.config.ts tests/e2e/plugins/kibana.e2e.test.ts",
-    "test:e2e:plugins:superset": "npx playwright test --config tests/e2e/plugins/playwright.config.ts tests/e2e/plugins/superset.e2e.test.ts",
+    "test:e2e:plugins": "npx playwright test --config tests/playwright/playwright.config.ts --project chromium",
+    "test:e2e:plugins:kibana": "npx playwright test --config tests/playwright/playwright.config.ts tests/playwright/kibana.e2e.ts",
+    "test:e2e:plugins:superset": "npx playwright test --config tests/playwright/playwright.config.ts tests/playwright/superset.e2e.ts",
     "test:all": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watchman=false --runInBand --testPathPatterns=\"/tests\" --passWithNoTests",
     "test:circular": "dpdm -T --no-warning --no-tree ./src/index.ts",
     "coverage": "rimraf ./workdocs/reports/data/*.json && npm run test:all -- --coverage --config=./workdocs/reports/jest.coverage.config.cjs",
     "lint": "eslint .",
     "lint-fix": "eslint --fix .",
     "prepare-pr": "npm run lint-fix && npm run build:prod && npm run coverage && npm run docs",
-    "prepare-release": "npm run lint-fix && npm run build:prod && npm run docs",
+    "prepare-release": "npm run lint-fix && npm run build:prod",
     "release": "./bin/tag-release.sh",
     "clean-publish": "npx clean-publish",
     "drawings": "for FILE in workdocs/drawings/*.drawio; do echo \"converting $FILE to image...\" && docker run --rm -v $(pwd):/data rlespinasse/drawio-export --format png $FILE; done && cp -rf workdocs/drawings/export/* workdocs/resources/",
@@ -362,6 +362,7 @@
     "repo:setup": "codex exec \"$(cat ./.codex/prompts/repo-setup.md)\nbase_path is ./\"",
     "repo:doc": "codex exec \"$(cat ./.codex/prompts/doc.md) $(cat ./.codex/prompts/bulk-docs.md)\nbase_path is ./\"",
     "repo:tests": "codex exec \"$(cat ./.codex/prompts/bulk-tests.md)\nbase_path is ./ and coverage is 95%\" -s workspace-write",
+    "prepare-it-tests": "echo \"prepare-it-tests: no infra to boot\"",
     "repo:readme": "codex exec \"$(cat ./.codex/prompts/update-readme.md)\nbase_path is ./\"",
     "repo:pr": "npm run repo:doc && npm run repo:tests && npm run repo:readme",
     "clean": "rimraf ./lib ./workdocs/coverage"
@@ -402,7 +403,8 @@
     "@types/supertest": "^6.0.0",
     "reflect-metadata": "^0.2.0",
     "rxjs": "^7.8.0",
-    "supertest": "^7.0.0"
+    "supertest": "^7.0.0",
+    "cron-parser": "^5.7.0"
   },
   "peerDependencies": {
     "@decaf-ts/as-zod": "latest",

package/lib/cjs/graph/engine/events/GraphExecutionEvent.cjs

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=GraphExecutionEvent.js.map
-//# sourceMappingURL=GraphExecutionEvent.cjs.map

package/lib/cjs/graph/engine/events/GraphExecutionEvent.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph/engine/events/GraphExecutionEvent.cjs","sourceRoot":"","sources":["graph/engine/events/GraphExecutionEvent.js"],"names":[],"mappings":";;AACA,+CAA+C"}

package/lib/cjs/graph/engine/planning/GraphRelationResolver.cjs

@@ -1,172 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GraphRelationResolver = void 0;
-const graph_1 = require("@decaf-ts/ui-decorators/graph");
-const constants_js_1 = require("./../constants.cjs");
-const GraphPortError_js_1 = require("./../errors/GraphPortError.cjs");
-const GraphTopologyError_js_1 = require("./../errors/GraphTopologyError.cjs");
-/**
- * Resolves raw workflow relation metadata into normalized execution edges.
- */
-class GraphRelationResolver {
-    /**
-     * Resolves all relations of a workflow into execution edges.
-     *
-     * @param workflow - The workflow definition.
-     * @returns Array of normalized edges.
-     * @throws {GraphTopologyError} when an endpoint is unknown or ambiguous.
-     * @throws {GraphPortError} when a referenced port is missing or unknown.
-     */
-    resolve(workflow) {
-        const nodeIds = new Set(workflow.nodes.map((n) => n.id));
-        const boundaryAliases = this.boundaryAliases(workflow);
-        const inputPorts = this.portNames(workflow.inputs);
-        const outputPorts = this.portNames(workflow.outputs);
-        const nodePortMap = this.buildNodePortMap(workflow);
-        const edges = [];
-        for (const relation of workflow.relations ?? []) {
-            const edge = this.resolveRelation(relation, nodeIds, boundaryAliases, inputPorts, outputPorts, nodePortMap);
-            edges.push(edge);
-        }
-        return edges;
-    }
-    /**
-     * Resolves a single relation into an edge.
-     */
-    resolveRelation(relation, nodeIds, boundaryAliases, inputPorts, outputPorts, nodePortMap) {
-        const sourceNodeId = this.resolveEndpoint(relation.source, nodeIds, boundaryAliases);
-        const targetNodeId = this.resolveEndpoint(relation.target, nodeIds, boundaryAliases);
-        const sourcePort = relation.sourcePort;
-        const targetPort = relation.targetPort;
-        if (!sourcePort) {
-            throw new GraphPortError_js_1.GraphPortError(`Relation is missing sourcePort (source: ${String(relation.source)}, target: ${String(relation.target)})`, { relation });
-        }
-        if (!targetPort) {
-            throw new GraphPortError_js_1.GraphPortError(`Relation is missing targetPort (source: ${String(relation.source)}, target: ${String(relation.target)})`, { relation });
-        }
-        this.validatePort(sourceNodeId, sourcePort, true, boundaryAliases, inputPorts, outputPorts, nodePortMap);
-        this.validatePort(targetNodeId, targetPort, false, boundaryAliases, inputPorts, outputPorts, nodePortMap);
-        return {
-            id: this.createEdgeId(sourceNodeId, sourcePort, targetNodeId, targetPort),
-            sourceNodeId,
-            sourcePort,
-            targetNodeId,
-            targetPort,
-            label: relation.label,
-            metadata: relation.metadata,
-        };
-    }
-    /**
-     * Resolves an endpoint (source or target) to a node id or the workflow boundary.
-     */
-    resolveEndpoint(endpoint, nodeIds, boundaryAliases) {
-        const name = String(endpoint);
-        if (boundaryAliases.has(name))
-            return constants_js_1.GRAPH_WORKFLOW_BOUNDARY;
-        if (nodeIds.has(name))
-            return name;
-        throw new GraphTopologyError_js_1.GraphTopologyError(`Unknown endpoint '${name}'`, { endpoint: name, knownNodes: Array.from(nodeIds) });
-    }
-    /**
-     * Validates that a port exists on the given node or boundary.
-     */
-    validatePort(nodeId, port, isSource, boundaryAliases, inputPorts, outputPorts, nodePortMap) {
-        if (nodeId === constants_js_1.GRAPH_WORKFLOW_BOUNDARY) {
-            const ports = isSource ? inputPorts : outputPorts;
-            if (!ports.has(port)) {
-                throw new GraphPortError_js_1.GraphPortError(`Unknown ${isSource ? "input" : "output"} port '${port}' on workflow boundary`, { nodeId, port, isSource, available: Array.from(ports) });
-            }
-            return;
-        }
-        const nodePorts = nodePortMap.get(nodeId);
-        if (!nodePorts) {
-            throw new GraphTopologyError_js_1.GraphTopologyError(`No port map for node '${nodeId}'`, {
-                nodeId,
-            });
-        }
-        const ports = isSource ? nodePorts.output : nodePorts.input;
-        if (!ports.has(port)) {
-            throw new GraphPortError_js_1.GraphPortError(`Unknown ${isSource ? "output" : "input"} port '${port}' on node '${nodeId}'`, { nodeId, port, isSource, available: Array.from(ports) });
-        }
-    }
-    /**
-     * Builds the set of boundary aliases for a workflow.
-     */
-    boundaryAliases(workflow) {
-        return new Set([
-            constants_js_1.GRAPH_WORKFLOW_BOUNDARY,
-            "workflow",
-            "graph",
-            workflow.name,
-        ]);
-    }
-    /**
-     * Extracts port names from a list of port definitions.
-     */
-    portNames(ports) {
-        return new Set((ports ?? []).map((p) => p.name));
-    }
-    /**
-     * Builds a map of node id -> { input ports, output ports }.
-     */
-    buildNodePortMap(workflow) {
-        const map = new Map();
-        for (const nodeMeta of workflow.nodes ?? []) {
-            const input = new Set();
-            const output = new Set();
-            const def = this.resolveNodeDefinition(nodeMeta);
-            if (def) {
-                for (const port of def.ports ?? []) {
-                    if (port.direction === "input")
-                        input.add(port.name);
-                    else
-                        output.add(port.name);
-                }
-            }
-            map.set(nodeMeta.id, { input, output });
-        }
-        return map;
-    }
-    /**
-     * Attempts to resolve a node's full definition from its metadata.
-     *
-     * Accepts either a decorated Model class/instance (resolved via
-     * `graphDefinitionOf`) or a plain `GraphNodeDefinition`-shaped object
-     * (useful for serialized workflows that inline node definitions).
-     */
-    resolveNodeDefinition(nodeMeta) {
-        if (nodeMeta.node) {
-            if (this.isRawDefinition(nodeMeta.node)) {
-                return nodeMeta.node;
-            }
-            try {
-                const def = (0, graph_1.graphDefinitionOf)(nodeMeta.node);
-                return def;
-            }
-            catch {
-                return undefined;
-            }
-        }
-        return undefined;
-    }
-    /**
-     * Returns `true` when a value looks like a raw {@link GraphNodeDefinition}
-     * (a plain object with a `ports` array and a `name` string).
-     */
-    isRawDefinition(value) {
-        return (typeof value === "object" &&
-            value !== null &&
-            !Array.isArray(value) &&
-            typeof value.name === "string" &&
-            Array.isArray(value.ports));
-    }
-    /**
-     * Creates a stable edge id from its endpoints and ports.
-     */
-    createEdgeId(sourceNodeId, sourcePort, targetNodeId, targetPort) {
-        return `${sourceNodeId}:${sourcePort}->${targetNodeId}:${targetPort}`;
-    }
-}
-exports.GraphRelationResolver = GraphRelationResolver;
-//# sourceMappingURL=GraphRelationResolver.js.map
-//# sourceMappingURL=GraphRelationResolver.cjs.map

package/lib/cjs/graph/engine/planning/GraphRelationResolver.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph/engine/planning/GraphRelationResolver.cjs","sourceRoot":"","sources":["graph/engine/planning/GraphRelationResolver.js"],"names":[],"mappings":"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"}