@decaf-ts/integrations 0.10.5 → 0.11.0

package/lib/esm/nest/graph/GraphRunController.js

@@ -1,270 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); }
-};
-/**
- * @module integrations/nest/graph/GraphRunController
- * @summary Asynchronous run lifecycle HTTP API (DECAF-50 §4.14–§4.15).
- * @description Creates (`POST /graph/runs`), reads
- * (`GET /graph/runs/:runId`), cancels (`DELETE /graph/runs/:runId`), and
- * replays (`SSE /graph/runs/:runId/events`) graph runs on top of
- * {@link GraphRunService}, enforcing authentication, run limits, and
- * ownership; engine errors surface as `500` with their message while Nest
- * {@link HttpException}s pass through unchanged.
- */
-import { Body, Controller, Delete, Get, HttpException, HttpStatus, NotFoundException, Optional, Param, Post, Query, Sse, Inject, HttpCode, } from "@nestjs/common";
-import { Observable } from "rxjs";
-import { NotFoundError, ValidationError } from "@decaf-ts/db-decorators";
-import { AuthorizationError, ForbiddenError } from "@decaf-ts/core";
-import { DecafRequestContext } from "@decaf-ts/for-nest";
-import { isGraphRunTerminalEventType } from "@decaf-ts/ui-decorators/graph";
-import { GraphRunService } from "./../../graph/index.js";
-import { graphWorkflowOwnerOf } from "./GraphWorkflowService.js";
-/** DI token for {@link GraphRunControllerOptions}. */
-export const GRAPH_RUN_OPTIONS = "GRAPH_RUN_OPTIONS";
-/**
- * Maps a thrown Decaf error to the Nest HTTP equivalent for the run
- * lifecycle API: ownership/authorization failures become `403` (naming the
- * run), missing runs `404`, validation failures `400`, and anything else
- * surfaces as `500` with its message. Nest {@link HttpException}s pass
- * through unchanged.
- */
-function graphRunHttpErrorOf(e, runId) {
-    if (e instanceof ForbiddenError || e instanceof AuthorizationError) {
-        return new HttpException(runId
-            ? `Graph run '${runId}' is owned by another user`
-            : e.message, HttpStatus.FORBIDDEN);
-    }
-    if (e instanceof NotFoundError) {
-        return new NotFoundException(e.message);
-    }
-    if (e instanceof ValidationError) {
-        return new HttpException(e.message, HttpStatus.BAD_REQUEST);
-    }
-    if (e instanceof HttpException)
-        return e;
-    const message = e instanceof Error ? e.message : String(e);
-    return new HttpException(message, HttpStatus.INTERNAL_SERVER_ERROR);
-}
-function graphRunToHttp(run) {
-    return JSON.parse(JSON.stringify(run));
-}
-function graphRunEventMessage(event) {
-    return {
-        type: "message",
-        data: JSON.stringify(event),
-    };
-}
-/**
- * Asynchronous run lifecycle HTTP API (DECAF-50 §4.14–§4.15):
- * `POST /graph/runs` creates and schedules a run (202 Accepted), run
- * read/cancel endpoints expose lifecycle state, and
- * `GET /graph/runs/:runId/events` streams the run's sequenced event
- * envelopes over SSE until a terminal event closes the stream. Every
- * operation is ownership-checked against the requesting user.
- */
-let GraphRunController = class GraphRunController {
-    constructor(runService, requestContext, options = {}) {
-        this.runService = runService;
-        this.requestContext = requestContext;
-        this.options = options;
-    }
-    /**
-     * Enforces the configured authentication mode: `auth` defaults to
-     * `"required"` (SAA-595 secure-defaults alignment) and rejects
-     * unauthenticated calls with `401`; `"optional"` admits anonymous
-     * requests for standalone module runs (DECAF-48 §4.15).
-     */
-    requireAuthenticatedContext() {
-        if ((this.options.auth ?? "required") !== "required") {
-            return this.requestContext;
-        }
-        if (!this.requestContext) {
-            throw new HttpException("Graph run access requires an authenticated request context", HttpStatus.UNAUTHORIZED);
-        }
-        return this.requestContext;
-    }
-    ownerUserOf() {
-        return graphWorkflowOwnerOf(this.requestContext) ?? null;
-    }
-    /** Concurrency-bucket key for the per-caller run cap: the owner, else the request IP, else a shared anonymous bucket. */
-    concurrencyKeyOf(owner) {
-        if (owner)
-            return owner;
-        const ip = this.requestContext?.request?.ip;
-        return ip ? `ip:${ip}` : "anonymous";
-    }
-    /**
-     * Creates and schedules a run (DECAF-50 §4.14): accepts an inline workflow
-     * document or a saved `workflowId` plus optional inputs, answers
-     * `202 Accepted` with the queued run's identity and its event/result URLs.
-     * The per-caller concurrency cap buckets by owner user, then request IP,
-     * then a shared anonymous bucket (SAA-595 F4).
-     */
-    async createRun(body) {
-        const context = this.requireAuthenticatedContext();
-        const request = {
-            ...(body?.workflow !== undefined ? { workflow: body.workflow } : {}),
-            ...(body?.workflowId !== undefined
-                ? { workflowId: body.workflowId }
-                : {}),
-            ...(body?.inputs !== undefined ? { inputs: body.inputs } : {}),
-        };
-        try {
-            const owner = this.ownerUserOf();
-            const run = await this.runService.createRun(request, owner, this.concurrencyKeyOf(owner), context);
-            return {
-                runId: run.runId,
-                workflowId: run.workflowId,
-                status: "queued",
-                eventsUrl: `/graph/runs/${run.runId}/events`,
-                resultUrl: `/graph/runs/${run.runId}`,
-            };
-        }
-        catch (e) {
-            throw graphRunHttpErrorOf(e);
-        }
-    }
-    async getRun(runId) {
-        const context = this.requireAuthenticatedContext();
-        try {
-            const run = await this.runService.getRun(runId, this.ownerUserOf(), context);
-            return graphRunToHttp(run);
-        }
-        catch (e) {
-            throw graphRunHttpErrorOf(e, runId);
-        }
-    }
-    async cancelRun(runId) {
-        const context = this.requireAuthenticatedContext();
-        try {
-            const run = await this.runService.cancelRun(runId, this.ownerUserOf(), context);
-            return graphRunToHttp(run);
-        }
-        catch (e) {
-            throw graphRunHttpErrorOf(e, runId);
-        }
-    }
-    async events(runId, afterSequence) {
-        const context = this.requireAuthenticatedContext();
-        const owner = this.ownerUserOf();
-        const after = this.parseAfterSequence(afterSequence);
-        let run;
-        try {
-            run = await this.runService.getRun(runId, owner, context);
-        }
-        catch (e) {
-            throw graphRunHttpErrorOf(e, runId);
-        }
-        const buffered = [];
-        let streaming = false;
-        let completed = false;
-        let sink;
-        const emit = (event) => {
-            if (completed || !sink)
-                return;
-            sink.next(graphRunEventMessage(event));
-            if (isGraphRunTerminalEventType(event.type)) {
-                completed = true;
-                unsubscribe();
-                sink.complete();
-            }
-        };
-        const unsubscribe = this.runService.subscribeRunEvents(run, (event) => {
-            if (completed)
-                return;
-            if (streaming)
-                emit(event);
-            else
-                buffered.push(event);
-        });
-        const replay = await this.runService.listEvents(runId, after, owner, context);
-        const replayTerminal = replay.length > 0 &&
-            isGraphRunTerminalEventType(replay[replay.length - 1].type);
-        return new Observable((subscriber) => {
-            sink = subscriber;
-            let last = after;
-            for (const event of replay) {
-                if (completed)
-                    break;
-                emit(event);
-                last = Math.max(last, event.sequence);
-            }
-            if (!completed) {
-                while (buffered.length > 0 && buffered[0].sequence <= last) {
-                    buffered.shift();
-                }
-                streaming = true;
-                while (buffered.length > 0 && !completed) {
-                    emit(buffered.shift());
-                }
-            }
-            if (replayTerminal && !completed) {
-                completed = true;
-                unsubscribe();
-                subscriber.complete();
-            }
-            return () => {
-                completed = true;
-                unsubscribe();
-            };
-        });
-    }
-    parseAfterSequence(afterSequence) {
-        if (afterSequence === undefined || afterSequence === "")
-            return 0;
-        if (!/^\d+$/.test(afterSequence)) {
-            throw new HttpException(`Invalid afterSequence '${afterSequence}': must be a non-negative integer`, HttpStatus.BAD_REQUEST);
-        }
-        return Number.parseInt(afterSequence, 10);
-    }
-};
-__decorate([
-    Post("runs"),
-    HttpCode(HttpStatus.ACCEPTED),
-    __param(0, Body()),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", Promise)
-], GraphRunController.prototype, "createRun", null);
-__decorate([
-    Get("runs/:runId"),
-    __param(0, Param("runId")),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String]),
-    __metadata("design:returntype", Promise)
-], GraphRunController.prototype, "getRun", null);
-__decorate([
-    Delete("runs/:runId"),
-    __param(0, Param("runId")),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String]),
-    __metadata("design:returntype", Promise)
-], GraphRunController.prototype, "cancelRun", null);
-__decorate([
-    Sse("runs/:runId/events"),
-    __param(0, Param("runId")),
-    __param(1, Query("afterSequence")),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, String]),
-    __metadata("design:returntype", Promise)
-], GraphRunController.prototype, "events", null);
-GraphRunController = __decorate([
-    Controller("graph"),
-    __param(1, Optional()),
-    __param(1, Inject(DecafRequestContext)),
-    __param(2, Optional()),
-    __param(2, Inject(GRAPH_RUN_OPTIONS)),
-    __metadata("design:paramtypes", [GraphRunService,
-        DecafRequestContext, Object])
-], GraphRunController);
-export { GraphRunController };
-//# sourceMappingURL=GraphRunController.js.map

package/lib/esm/nest/graph/GraphRunController.js.map

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

package/lib/esm/nest/graph/GraphRunModel.js

@@ -1,74 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-import { model } from "@decaf-ts/decorator-validation";
-import { BaseModel, column, pk, table } from "@decaf-ts/core";
-/**
- * Persistent run record for the graph run lifecycle (DECAF-50 §4.14): one
- * row per {@link GraphRun}, storing lifecycle status, the executed
- * document's fingerprint, inputs, result, and error payloads. Written and
- * read through {@link GraphRunModelService}, which adapts it to the
- * engine-side {@link GraphRun} shape.
- */
-let GraphRunModel = class GraphRunModel extends BaseModel {
-    constructor(arg) {
-        super(arg);
-    }
-};
-__decorate([
-    pk({ type: String, generated: false }),
-    __metadata("design:type", String)
-], GraphRunModel.prototype, "runId", void 0);
-__decorate([
-    column(),
-    __metadata("design:type", String)
-], GraphRunModel.prototype, "workflowId", void 0);
-__decorate([
-    column(),
-    __metadata("design:type", String)
-], GraphRunModel.prototype, "owner", void 0);
-__decorate([
-    column(),
-    __metadata("design:type", String)
-], GraphRunModel.prototype, "status", void 0);
-__decorate([
-    column(),
-    __metadata("design:type", String)
-], GraphRunModel.prototype, "documentFingerprint", void 0);
-__decorate([
-    column(),
-    __metadata("design:type", Object)
-], GraphRunModel.prototype, "inputs", void 0);
-__decorate([
-    column(),
-    __metadata("design:type", Object)
-], GraphRunModel.prototype, "result", void 0);
-__decorate([
-    column(),
-    __metadata("design:type", Object)
-], GraphRunModel.prototype, "error", void 0);
-__decorate([
-    column(),
-    __metadata("design:type", Date)
-], GraphRunModel.prototype, "createdAt", void 0);
-__decorate([
-    column(),
-    __metadata("design:type", Date)
-], GraphRunModel.prototype, "startedAt", void 0);
-__decorate([
-    column(),
-    __metadata("design:type", Date)
-], GraphRunModel.prototype, "finishedAt", void 0);
-GraphRunModel = __decorate([
-    table("graph_run"),
-    model(),
-    __metadata("design:paramtypes", [Object])
-], GraphRunModel);
-export { GraphRunModel };
-//# sourceMappingURL=GraphRunModel.js.map

package/lib/esm/nest/graph/GraphRunModel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GraphRunModel.js","sourceRoot":"","sources":["../../../../src/nest/graph/GraphRunModel.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE9D;;;;;;GAMG;AAGI,IAAM,aAAa,GAAnB,MAAM,aAAc,SAAQ,SAAS;IAkC1C,YAAY,GAA4B;QACtC,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;CACF,CAAA;AAnCC;IADC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;;4CACxB;AAGf;IADC,MAAM,EAAE;;iDACW;AAGpB;IADC,MAAM,EAAE;;4CACM;AAGf;IADC,MAAM,EAAE;;6CACO;AAGhB;IADC,MAAM,EAAE;;0DACoB;AAG7B;IADC,MAAM,EAAE;;6CACwB;AAGjC;IADC,MAAM,EAAE;;6CACwB;AAGjC;IADC,MAAM,EAAE;;4CACuB;AAGhC;IADC,MAAM,EAAE;8BACG,IAAI;gDAAC;AAGjB;IADC,MAAM,EAAE;8BACG,IAAI;gDAAC;AAGjB;IADC,MAAM,EAAE;8BACI,IAAI;iDAAC;AAhCP,aAAa;IAFzB,KAAK,CAAC,WAAW,CAAC;IAClB,KAAK,EAAE;;GACK,aAAa,CAqCzB"}

package/lib/esm/nest/graph/GraphRunModelService.js

@@ -1,112 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-/**
- * @module integrations/nest/graph/GraphRunModelService
- * @summary Persistent run store on the Decaf model layer.
- * @description Persists {@link GraphRun} rows as {@link GraphRunModel} via
- * the Decaf {@link ModelService}, implementing the engine-side
- * {@link GraphRunStore} and converting between the engine run shape and the
- * JSON-safe persisted columns.
- */
-import { ModelService, service, } from "@decaf-ts/core";
-import { isGraphRunStatus } from "@decaf-ts/ui-decorators/graph";
-import { GraphRunModel } from "./GraphRunModel.js";
-function toJsonSafe(value) {
-    if (value === undefined || value === null)
-        return undefined;
-    return JSON.parse(JSON.stringify(value));
-}
-function runToModel(run) {
-    return new GraphRunModel({
-        runId: run.runId,
-        workflowId: run.workflowId,
-        ...(run.ownerUser ? { owner: run.ownerUser } : {}),
-        status: run.status,
-        ...(run.documentFingerprint
-            ? { documentFingerprint: run.documentFingerprint }
-            : {}),
-        ...(run.result !== undefined
-            ? { result: toJsonSafe(run.result) }
-            : {}),
-        ...(run.error ? { error: toJsonSafe(run.error) } : {}),
-        createdAt: new Date(run.createdAt),
-        ...(run.startedAt ? { startedAt: new Date(run.startedAt) } : {}),
-        ...(run.finishedAt ? { finishedAt: new Date(run.finishedAt) } : {}),
-    });
-}
-function modelToRun(model) {
-    const result = model.result;
-    return {
-        runId: model.runId,
-        workflowId: model.workflowId,
-        ownerUser: model.owner ?? null,
-        status: isGraphRunStatus(model.status) ? model.status : "failed",
-        createdAt: model.createdAt.toISOString(),
-        ...(model.startedAt ? { startedAt: model.startedAt.toISOString() } : {}),
-        ...(model.finishedAt ? { finishedAt: model.finishedAt.toISOString() } : {}),
-        ...(result ? { result } : {}),
-        ...(model.error
-            ? { error: model.error }
-            : {}),
-        ...(model.documentFingerprint
-            ? { documentFingerprint: model.documentFingerprint }
-            : {}),
-    };
-}
-/**
- * Model-backed {@link GraphRunStore}: persists runs as {@link GraphRunModel}
- * rows via the Decaf ModelService, converting between the engine-side
- * {@link GraphRun} shape and the JSON-safe persisted columns.
- */
-let GraphRunModelService = class GraphRunModelService extends ModelService {
-    constructor() {
-        super(GraphRunModel);
-    }
-    async saveRun(run, ...args) {
-        const { ctxArgs } = (await this.logCtx(args, "saveRun", true)).for(this.saveRun);
-        const model = runToModel(run);
-        let existing;
-        try {
-            existing = (await super.read(run.runId, ...ctxArgs));
-        }
-        catch {
-            existing = null;
-        }
-        if (existing) {
-            existing.workflowId = model.workflowId;
-            existing.owner = model.owner;
-            existing.status = model.status;
-            existing.documentFingerprint = model.documentFingerprint;
-            existing.result = model.result;
-            existing.error = model.error;
-            existing.startedAt = model.startedAt;
-            existing.finishedAt = model.finishedAt;
-            await this.update(existing, ...ctxArgs);
-            return;
-        }
-        await this.create(model, ...ctxArgs);
-    }
-    async readRun(runId, ...args) {
-        const { ctxArgs } = (await this.logCtx(args, "readRun", true)).for(this.readRun);
-        try {
-            const model = (await super.read(runId, ...ctxArgs));
-            return modelToRun(model);
-        }
-        catch {
-            return null;
-        }
-    }
-};
-GraphRunModelService = __decorate([
-    service(GraphRunModel),
-    __metadata("design:paramtypes", [])
-], GraphRunModelService);
-export { GraphRunModelService };
-//# sourceMappingURL=GraphRunModelService.js.map

package/lib/esm/nest/graph/GraphRunModelService.js.map

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

package/lib/esm/nest/graph/GraphWorkflowBoundaryValidation.js

@@ -1,164 +0,0 @@
-import { ValidationError } from "@decaf-ts/db-decorators";
-import { assertGraphWorkflowDocumentValid, isGraphJsonSafeValue, isGraphWorkflowDocumentShape, } from "@decaf-ts/ui-decorators/graph";
-import { DEFAULT_GRAPH_WORKFLOW_DOCUMENT_LIMITS, } from "./GraphWorkflowDocumentLimits.js";
-/**
- * Field keys that must never appear on a submitted workflow document or any
- * of its structural records (DECAF-50 §4.16): client input resembling node,
- * definition, executor, authoritative ports, or frontend component
- * definitions is rejected at the boundary.
- */
-export const GRAPH_WORKFLOW_FORBIDDEN_FIELD_KEYS = [
-    "node",
-    "definition",
-    "executor",
-    "execute",
-    "ports",
-    "component",
-];
-function issue(code, path, message, extra) {
-    return {
-        code,
-        path,
-        message,
-        ...(extra?.nodeId !== undefined ? { nodeId: extra.nodeId } : {}),
-        ...(extra?.edgeId !== undefined ? { edgeId: extra.edgeId } : {}),
-        ...(extra?.details ? { details: extra.details } : {}),
-    };
-}
-function forbiddenFieldIssues(record, path) {
-    const issues = [];
-    for (const key of Object.keys(record)) {
-        if (GRAPH_WORKFLOW_FORBIDDEN_FIELD_KEYS.includes(key)) {
-            issues.push(issue("document.forbidden-field", `${path}.${key}`, `Field '${key}' is not accepted in a canonical workflow document: node, definition, executor, execute, ports and component fields are rejected at the boundary`, {
-                details: { field: key },
-            }));
-        }
-    }
-    return issues;
-}
-function collectForbiddenFieldIssues(document, issues) {
-    issues.push(...forbiddenFieldIssues(document, "$"));
-    document.inputs.forEach((port, index) => issues.push(...forbiddenFieldIssues(port, `inputs[${index}]`)));
-    document.outputs.forEach((port, index) => issues.push(...forbiddenFieldIssues(port, `outputs[${index}]`)));
-    for (const node of document.nodes) {
-        issues.push(...forbiddenFieldIssues(node, `nodes[${node.id}]`));
-        if (node.loop) {
-            issues.push(...forbiddenFieldIssues(node.loop, `nodes[${node.id}].loop`));
-            collectForbiddenFieldIssues(node.loop.body, issues);
-        }
-    }
-    for (const edge of document.edges) {
-        issues.push(...forbiddenFieldIssues(edge, `edges[${edge.id}]`));
-    }
-}
-function duplicateIdIssues(document) {
-    const issues = [];
-    const portIds = new Set();
-    for (const port of [...document.inputs, ...document.outputs]) {
-        if (portIds.has(port.id)) {
-            issues.push(issue("document.duplicate-port-id", `ports[${port.id}]`, `Workflow port '${port.id}' is declared more than once; workflow port ids must be unique`));
-        }
-        else {
-            portIds.add(port.id);
-        }
-    }
-    const nodeIds = new Set();
-    for (const node of document.nodes) {
-        if (nodeIds.has(node.id)) {
-            issues.push(issue("document.duplicate-node-id", `nodes[${node.id}]`, `Node '${node.id}' is declared more than once; node ids must be unique`, { nodeId: node.id }));
-        }
-        else {
-            nodeIds.add(node.id);
-        }
-    }
-    const edgeIds = new Set();
-    for (const edge of document.edges) {
-        if (edgeIds.has(edge.id)) {
-            issues.push(issue("document.duplicate-edge-id", `edges[${edge.id}]`, `Edge '${edge.id}' is declared more than once; edge ids must be unique`, { edgeId: edge.id }));
-        }
-        else {
-            edgeIds.add(edge.id);
-        }
-    }
-    return issues;
-}
-function limitIssues(document, limits) {
-    const issues = [];
-    if (document.nodes.length > limits.maxNodes) {
-        issues.push(issue("document.limit.nodes", "$.nodes", `Document declares ${document.nodes.length} nodes; at most ${limits.maxNodes} are allowed`, { details: { count: document.nodes.length, limit: limits.maxNodes } }));
-    }
-    if (document.edges.length > limits.maxEdges) {
-        issues.push(issue("document.limit.edges", "$.edges", `Document declares ${document.edges.length} edges; at most ${limits.maxEdges} are allowed`, { details: { count: document.edges.length, limit: limits.maxEdges } }));
-    }
-    const maxDepth = maxNestingDepthOf(document);
-    if (maxDepth > limits.maxNestingDepth) {
-        issues.push(issue("document.limit.depth", "$.nodes", `Document nests loop bodies ${maxDepth} levels deep; at most ${limits.maxNestingDepth} levels are allowed`, { details: { depth: maxDepth, limit: limits.maxNestingDepth } }));
-    }
-    const bytes = Buffer.byteLength(JSON.stringify(document), "utf8");
-    if (bytes > limits.maxDocumentBytes) {
-        issues.push(issue("document.limit.size", "$", `Document serializes to ${bytes} bytes; at most ${limits.maxDocumentBytes} bytes are allowed`, { details: { bytes, limit: limits.maxDocumentBytes } }));
-    }
-    return issues;
-}
-function maxNestingDepthOf(document, depth = 0) {
-    let max = depth;
-    for (const node of document.nodes) {
-        if (node.loop?.body) {
-            max = Math.max(max, maxNestingDepthOf(node.loop.body, depth + 1));
-        }
-    }
-    return max;
-}
-function kindIssues(document, catalogue) {
-    const issues = [];
-    for (const node of document.nodes) {
-        if (!catalogue.has(node.kind)) {
-            issues.push(issue("node.unknown-kind", `nodes[${node.id}].kind`, `Node '${node.id}' references kind '${node.kind}' which is not registered in the backend catalogue`, { nodeId: node.id, details: { kind: node.kind } }));
-        }
-        if (node.loop?.body) {
-            issues.push(...kindIssues(node.loop.body, catalogue));
-        }
-    }
-    return issues;
-}
-/**
- * Validates a submitted canonical workflow document at the persistence
- * boundary (DECAF-50 §4.10/§4.16): document shape, JSON safety, forbidden
- * definition/executor/component fields, duplicate ids, backend-enforced
- * resource limits, structural validity (via the shared document contract
- * assertions) and catalogue kind existence. Issues accumulate as structured
- * {@link GraphValidationIssue}s instead of failing abruptly.
- *
- * Full nine-stage document/catalogue validation (DECAF-50 §4.8) is owned by
- * the engine validation phase; this boundary pass is the persistence gate.
- */
-export function validateGraphWorkflowDocumentAtBoundary(document, options = {}) {
-    const limits = {
-        ...DEFAULT_GRAPH_WORKFLOW_DOCUMENT_LIMITS,
-        ...options.limits,
-    };
-    const issues = [];
-    if (!isGraphWorkflowDocumentShape(document)) {
-        issues.push(issue("document.shape", "$", "Payload is not a canonical GraphWorkflowDocument: id and name must be strings and inputs, outputs, nodes and edges must be arrays"));
-        return { valid: false, issues };
-    }
-    if (!isGraphJsonSafeValue(document)) {
-        issues.push(issue("document.json-unsafe", "$", "Document contains JSON-unsafe values: functions, class instances, undefined, NaN/Infinity, symbol keys and unsafe prototype keys (__proto__/prototype/constructor) are rejected"));
-        return { valid: false, issues };
-    }
-    collectForbiddenFieldIssues(document, issues);
-    issues.push(...duplicateIdIssues(document));
-    issues.push(...limitIssues(document, limits));
-    try {
-        assertGraphWorkflowDocumentValid(document);
-    }
-    catch (e) {
-        const message = e instanceof ValidationError ? e.message : String(e);
-        issues.push(issue("document.structure", "$", message));
-    }
-    if (options.catalogue) {
-        issues.push(...kindIssues(document, options.catalogue));
-    }
-    return { valid: issues.length === 0, issues };
-}
-//# sourceMappingURL=GraphWorkflowBoundaryValidation.js.map

package/lib/esm/nest/graph/GraphWorkflowBoundaryValidation.js.map

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