@decaf-ts/integrations 0.10.5 → 0.11.0

package/lib/esm/graph/log/GraphRunLogger.js

@@ -1,140 +0,0 @@
-/**
- * @module integrations/graph/log/GraphRunLogger
- * @summary ctx.logger for graph node execution with structured SSE forwarding.
- * @description A decaf-ts {@link Logger} that attaches the DECAF-48 run
- * attributes (`nodeId` / `workflowId` / `runId` / `user`) through
- * DECAF-9 `logger.for({...})`, renders through the standard MiniLogger
- * pipeline, and forwards the structured {@link GraphRunLogEntry} to the
- * graph execution Observable so run logs stream over SSE on the existing
- * `/graph/events` pipeline (no second out-of-band channel).
- */
-import { Logging } from "@decaf-ts/logging";
-import { GraphLogAttribute, GraphExecutionEventType, } from "@decaf-ts/ui-decorators/graph";
-/**
- * Logger used by graph node executors (`ctx.logger`).
- *
- * Wraps the shared MiniLogger pipeline so the DECAF-48 attributes render as
- * discrete custom attributes in the formatted output, and forwards each
- * structured entry through {@link GraphRunLoggerOptions.forward} so the SSE
- * log channel (`graph.run.log`) receives the level/message/attributes/
- * timestamp payload.
- */
-export class GraphRunLogger {
-    constructor(options) {
-        this.baseOptions = options;
-        this.inner = Logging.for("GraphRun").for(this.attributeConfig(options));
-    }
-    /**
-     * Produces the `Partial<LoggingConfig>` carrying the DECAF-48 attributes
-     * so the LogParameter descriptors render them (DECAF-9 §4.6).
-     */
-    attributeConfig(options) {
-        return {
-            [GraphLogAttribute.NODE_ID]: options.nodeId,
-            [GraphLogAttribute.WORKFLOW_ID]: options.workflowId,
-            [GraphLogAttribute.RUN_ID]: options.runId,
-            [GraphLogAttribute.USER]: options.user ?? null,
-        };
-    }
-    /** Emits a structured log entry synchronously (forward is fire-and-forget). */
-    emit(level, msg, meta) {
-        const rawMessage = typeof msg === "string"
-            ? msg
-            : msg instanceof Error
-                ? msg.message
-                : String(msg);
-        const entry = {
-            level,
-            message: rawMessage,
-            timestamp: new Date().toISOString(),
-            runId: this.baseOptions.runId,
-            workflowId: this.baseOptions.workflowId,
-            nodeId: this.baseOptions.nodeId,
-            user: this.baseOptions.user ?? null,
-            payload: meta,
-        };
-        this.baseOptions.forward({
-            type: GraphExecutionEventType.GRAPH_RUN_LOG,
-            payload: entry,
-        }).catch(() => {
-            // Log forwarding must never crash node execution.
-        });
-        const dispatch = {
-            benchmark: (m, x) => this.inner.benchmark(m, x),
-            fatal: (m, x) => this.inner.fatal(m, x),
-            critical: (m, x) => this.inner.critical(m, x),
-            silly: (m, x) => this.inner.silly(m, x),
-            trace: (m, x) => this.inner.trace(m, x),
-            verbose: (m, x) => this.inner.verbose(m, x),
-            info: (m, x) => this.inner.info(m, x),
-            warn: (m, x) => this.inner.warn(m, x),
-            error: (m, x) => this.inner.error(m, x),
-            debug: (m, x) => this.inner.debug(m, x),
-        };
-        dispatch[level](rawMessage, meta);
-    }
-    /** @inheritdoc */
-    benchmark(msg, meta) {
-        this.emit("benchmark", msg, meta);
-    }
-    /** @inheritdoc */
-    fatal(msg, error, meta) {
-        this.emit("fatal", msg, error ?? meta);
-    }
-    /** @inheritdoc */
-    critical(msg, error, meta) {
-        this.emit("critical", msg, error ?? meta);
-    }
-    /** @inheritdoc */
-    silly(msg, verbosity, meta) {
-        this.emit("silly", msg, typeof verbosity === "object" ? verbosity : meta);
-    }
-    /** @inheritdoc */
-    trace(msg, meta) {
-        this.emit("trace", msg, meta);
-    }
-    /** @inheritdoc */
-    verbose(msg, verbosity, meta) {
-        this.emit("verbose", msg, typeof verbosity === "object" ? verbosity : meta);
-    }
-    /** @inheritdoc */
-    info(msg, meta) {
-        this.emit("info", msg, meta);
-    }
-    /** @inheritdoc */
-    error(msg, error, meta) {
-        this.emit("error", msg, error ?? meta);
-    }
-    /** @inheritdoc */
-    warn(msg, meta) {
-        this.emit("warn", msg, meta);
-    }
-    /** @inheritdoc */
-    debug(msg, meta) {
-        this.emit("debug", msg, meta);
-    }
-    action(action, codeOrMeta, meta) {
-        this.inner.action(action, codeOrMeta, meta);
-    }
-    /** @inheritdoc */
-    setConfig() {
-        // Configuration is owned by the wrapped MiniLogger; nothing to apply.
-    }
-    /** @inheritdoc */
-    for(_method, _config, 
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    ..._args) {
-        void _method;
-        void _config;
-        return this;
-    }
-    /** @inheritdoc */
-    clear() {
-        return this;
-    }
-    /** @inheritdoc */
-    get root() {
-        return this.inner.root;
-    }
-}
-//# sourceMappingURL=GraphRunLogger.js.map

package/lib/esm/graph/log/GraphRunLogger.js.map

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

package/lib/esm/graph/log/LogParameters.js

@@ -1,69 +0,0 @@
-import { logParameterRegistry } from "@decaf-ts/logging";
-import { GraphLogAttribute } from "@decaf-ts/ui-decorators/graph";
-/** Registry modules may re-run (tests / hot reload); keep it idempotent. */
-const registered = new Set();
-/**
- * Reads a custom attribute off the config snapshot, tolerating non-standard
- * keys that the logger's `for({...})` config may carry.
- *
- * @param payload - The log parameter payload exposing the `config` snapshot.
- * @param key - The custom attribute key to read.
- * @returns The value bound to `key`, or `undefined` when absent.
- */
-function configAttribute(payload, key) {
-    return payload.config[key];
-}
-/**
- * Registers the four DECAF-48 run attributes as log parameter descriptors
- * (nodeId / workflowId / runId / user). Rendered only when keyed with a
- * non-null value so one-shot module imports from other packages never leak
- * empty columns.
- */
-export function registerGraphRunLogParameters() {
-    const descriptors = [
-        {
-            key: GraphLogAttribute.NODE_ID,
-            shouldInclude(payload) {
-                return configAttribute(payload, GraphLogAttribute.NODE_ID) != null;
-            },
-            render(payload) {
-                return String(configAttribute(payload, GraphLogAttribute.NODE_ID));
-            },
-        },
-        {
-            key: GraphLogAttribute.WORKFLOW_ID,
-            shouldInclude(payload) {
-                return configAttribute(payload, GraphLogAttribute.WORKFLOW_ID) != null;
-            },
-            render(payload) {
-                return String(configAttribute(payload, GraphLogAttribute.WORKFLOW_ID));
-            },
-        },
-        {
-            key: GraphLogAttribute.RUN_ID,
-            shouldInclude(payload) {
-                return configAttribute(payload, GraphLogAttribute.RUN_ID) != null;
-            },
-            render(payload) {
-                return String(configAttribute(payload, GraphLogAttribute.RUN_ID));
-            },
-        },
-        {
-            key: GraphLogAttribute.USER,
-            shouldInclude(payload) {
-                return configAttribute(payload, GraphLogAttribute.USER) != null;
-            },
-            render(payload) {
-                return String(configAttribute(payload, GraphLogAttribute.USER));
-            },
-        },
-    ];
-    for (const descriptor of descriptors) {
-        if (registered.has(descriptor.key))
-            continue;
-        logParameterRegistry.register(descriptor);
-        registered.add(descriptor.key);
-    }
-}
-registerGraphRunLogParameters();
-//# sourceMappingURL=LogParameters.js.map

package/lib/esm/graph/log/LogParameters.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LogParameters.js","sourceRoot":"","sources":["../../../../src/graph/log/LogParameters.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,4EAA4E;AAC5E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;AAErC;;;;;;;GAOG;AACH,SAAS,eAAe,CACtB,OAA4C,EAC5C,GAAW;IAEX,OAAQ,OAAO,CAAC,MAAkC,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B;IAC3C,MAAM,WAAW,GAA6B;QAC5C;YACE,GAAG,EAAE,iBAAiB,CAAC,OAAO;YAC9B,aAAa,CAAC,OAAO;gBACnB,OAAO,eAAe,CAAC,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;YACrE,CAAC;YACD,MAAM,CAAC,OAAO;gBACZ,OAAO,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;YACrE,CAAC;SACF;QACD;YACE,GAAG,EAAE,iBAAiB,CAAC,WAAW;YAClC,aAAa,CAAC,OAAO;gBACnB,OAAO,eAAe,CAAC,OAAO,EAAE,iBAAiB,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;YACzE,CAAC;YACD,MAAM,CAAC,OAAO;gBACZ,OAAO,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC;YACzE,CAAC;SACF;QACD;YACE,GAAG,EAAE,iBAAiB,CAAC,MAAM;YAC7B,aAAa,CAAC,OAAO;gBACnB,OAAO,eAAe,CAAC,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;YACpE,CAAC;YACD,MAAM,CAAC,OAAO;gBACZ,OAAO,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;YACpE,CAAC;SACF;QACD;YACE,GAAG,EAAE,iBAAiB,CAAC,IAAI;YAC3B,aAAa,CAAC,OAAO;gBACnB,OAAO,eAAe,CAAC,OAAO,EAAE,iBAAiB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;YAClE,CAAC;YACD,MAAM,CAAC,OAAO;gBACZ,OAAO,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;YAClE,CAAC;SACF;KACF,CAAC;IAEF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC7C,oBAAoB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC1C,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,6BAA6B,EAAE,CAAC"}

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

@@ -1,257 +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/GraphExecutionController
- * @summary Legacy synchronous graph execution surface (SAA-595).
- * @description The deprecated `POST /graph/execute` endpoint, the deprecated
- * global `SSE /graph/events` stream, plus the run-result read and workflow
- * persistence endpoints. All execution now flows through
- * {@link GraphRunService}; only canonical documents are accepted (inline
- * node/definition/executor/ports/component fields are rejected at the
- * boundary) and the global stream is disabled unless explicitly enabled.
- */
-import { Controller, Post, Put, Get, Body, Param, Sse, Optional, Inject, NotFoundException, HttpException, HttpStatus, } from "@nestjs/common";
-import { Subject, Observable } from "rxjs";
-import { concatMap, filter } from "rxjs/operators";
-import { GraphExecutionEngine, GraphRunService, } from "./../../graph/index.js";
-import { isGraphWorkflowDocumentShape, } from "@decaf-ts/ui-decorators/graph";
-import { ValidationError, NotFoundError } from "@decaf-ts/db-decorators";
-import { AuthorizationError, ForbiddenError } from "@decaf-ts/core";
-import { DecafRequestContext } from "@decaf-ts/for-nest";
-import { GraphResultService } from "./GraphResultService.js";
-import { GraphWorkflowService, graphWorkflowOwnerOf } from "./GraphWorkflowService.js";
-/** DI token for {@link GraphExecutionControllerOptions}. */
-export const GRAPH_EXECUTION_OPTIONS = "GRAPH_EXECUTION_OPTIONS";
-/**
- * Legacy synchronous graph execution surface (DECAF-50 §4.14/§4.18): the
- * `POST /graph/execute` endpoint (deprecated in favour of the run lifecycle
- * at `POST /graph/runs`), the legacy `PUT /graph/:id/execute` alias, and the
- * deprecated global SSE event stream. All execution now flows through
- * {@link GraphRunService}; only canonical documents are accepted.
- */
-let GraphExecutionController = class GraphExecutionController {
-    constructor(engine, resultService, workflowService, runService, requestContext, options = {}) {
-        this.engine = engine;
-        this.resultService = resultService;
-        this.workflowService = workflowService;
-        this.runService = runService;
-        this.requestContext = requestContext;
-        this.options = options;
-        this.eventSubject = new Subject();
-        this.engine.observe({
-            refresh: async (event) => {
-                this.eventSubject.next(event);
-            },
-        });
-    }
-    /**
-     * @deprecated DECAF-50 §4.14/§4.18 cutover: the synchronous execution
-     * endpoint is deprecated in favour of the asynchronous run lifecycle
-     * (`POST /graph/runs`). It is kept, not removed, within this
-     * specification. Only canonical {@link GraphWorkflowDocument} payloads are
-     * accepted; legacy definition/snapshot payloads and inline
-     * node/definition/executor/ports/component fields are rejected (§4.16).
-     */
-    async execute(body) {
-        const document = this.requireCanonicalDocument(body.workflow);
-        const owner = graphWorkflowOwnerOf(this.requestContext) ?? null;
-        const run = await this.runService.executeAndWait({ workflow: document, inputs: body.inputs ?? {} }, owner, this.concurrencyKeyOf(owner), this.requestContext);
-        if (run.result) {
-            try {
-                await this.resultService.saveResult(run.result, this.requestContext);
-            }
-            catch {
-                // persistence failures must not mask a successful execution result
-            }
-        }
-        return {
-            runId: run.runId,
-            status: run.status,
-            outputs: (run.result?.outputs ?? {}),
-        };
-    }
-    /**
-     * DECAF-50 §4.16 cutover: only a canonical {@link GraphWorkflowDocument}
-     * is accepted. Payloads resembling legacy decorated definitions, snapshot
-     * wrappers, or any other non-canonical shape are rejected with a Decaf
-     * {@link ValidationError} before the engine or planner sees them.
-     */
-    requireCanonicalDocument(workflow) {
-        if (isGraphWorkflowDocumentShape(workflow)) {
-            return workflow;
-        }
-        throw new ValidationError("Execution payload must be a canonical GraphWorkflowDocument: legacy workflow definitions, snapshot wrappers and inline node/definition/executor/ports/component payloads are rejected; compile decorated workflows client-side via GraphDecoratedWorkflowCompiler or use POST /graph/runs");
-    }
-    /**
-     * @deprecated DECAF-50 §4.15 cutover (SAA-595 F2): the global `/graph/events`
-     * stream is disabled by default — the run-scoped, authorized, replayable
-     * `GET /graph/runs/{runId}/events` transport is the canonical stream. Hosts
-     * with a residual transition need may re-enable it explicitly via
-     * {@link GraphExecutionControllerOptions.enableGlobalEventStream}; every
-     * event is then ownership-gated at emit: a connected caller only ever
-     * receives events for runs they own.
-     */
-    events() {
-        if (this.options.enableGlobalEventStream !== true) {
-            throw new HttpException("The global graph event stream is disabled; use the run-scoped GET /graph/runs/{runId}/events transport", HttpStatus.NOT_FOUND);
-        }
-        const caller = graphWorkflowOwnerOf(this.requestContext) ?? null;
-        return this.eventSubject.asObservable().pipe(concatMap(async (event) => {
-            return (await this.callerOwnsRun(caller, event.runId))
-                ? this.messageOf(event)
-                : null;
-        }), filter((message) => message !== null));
-    }
-    /** Encodes one engine event in the global stream's wire format: a `["graph", type, runId, envelope]` SSE message tuple. */
-    messageOf(event) {
-        return {
-            type: "message",
-            data: JSON.stringify([
-                "graph",
-                event.type,
-                event.runId,
-                {
-                    id: event.id,
-                    sequence: event.sequence,
-                    type: event.type,
-                    runId: event.runId,
-                    parentRunId: event.parentRunId,
-                    workflowId: event.workflowId,
-                    nodeId: event.nodeId,
-                    edgeId: event.edgeId,
-                    port: event.port,
-                    iteration: event.iteration,
-                    path: event.path,
-                    status: event.status,
-                    payload: event.payload,
-                    error: event.error,
-                    timestamp: event.timestamp.toISOString(),
-                },
-            ]),
-        };
-    }
-    /** Strict ownership gate for the global stream: only run owners see their runs' events. */
-    async callerOwnsRun(caller, runId) {
-        try {
-            const run = await this.runService.getRun(runId, caller, this.requestContext);
-            return (run.ownerUser ?? null) === caller;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Reads a persisted execution result by run id (DECAF-50 §4.18). Gated
-     * through the centralized run ownership check first (SAA-595 F1): a
-     * cross-user or anonymous caller gets `403` for a run owned by another
-     * user before any result data is read.
-     */
-    async getResult(runId) {
-        const owner = graphWorkflowOwnerOf(this.requestContext) ?? null;
-        try {
-            await this.runService.getRun(runId, owner, this.requestContext);
-        }
-        catch (e) {
-            throw graphExecutionHttpErrorOf(e, runId);
-        }
-        const model = await this.resultService.findByRunId(runId, this.requestContext);
-        if (!model) {
-            throw new NotFoundException(`No graph execution result found for runId '${runId}'`);
-        }
-        return {
-            runId: model.runId,
-            workflowId: model.workflowId,
-            status: model.status,
-            inputs: model.inputs,
-            outputs: model.outputs,
-            nodeResults: model.nodeResults,
-            startedAt: model.startedAt,
-            finishedAt: model.finishedAt,
-        };
-    }
-    /** 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";
-    }
-    async saveWorkflow(id, snapshot) {
-        const model = await this.workflowService.saveSnapshot(id, snapshot, this.requestContext);
-        return { workflowId: id, savedAt: model.updatedAt.toISOString() };
-    }
-};
-__decorate([
-    Post("execute"),
-    __param(0, Body()),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", Promise)
-], GraphExecutionController.prototype, "execute", null);
-__decorate([
-    Sse("events"),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", Observable)
-], GraphExecutionController.prototype, "events", null);
-__decorate([
-    Get("results/:runId"),
-    __param(0, Param("runId")),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String]),
-    __metadata("design:returntype", Promise)
-], GraphExecutionController.prototype, "getResult", null);
-__decorate([
-    Put("workflow/:id"),
-    __param(0, Param("id")),
-    __param(1, Body()),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, Object]),
-    __metadata("design:returntype", Promise)
-], GraphExecutionController.prototype, "saveWorkflow", null);
-GraphExecutionController = __decorate([
-    Controller("graph"),
-    __param(4, Optional()),
-    __param(4, Inject(DecafRequestContext)),
-    __param(5, Optional()),
-    __param(5, Inject(GRAPH_EXECUTION_OPTIONS)),
-    __metadata("design:paramtypes", [GraphExecutionEngine,
-        GraphResultService,
-        GraphWorkflowService,
-        GraphRunService,
-        DecafRequestContext, Object])
-], GraphExecutionController);
-export { GraphExecutionController };
-/**
- * Maps a thrown Decaf error to the Nest HTTP equivalent for the execution
- * surface: ownership/authorization failures become `403` (naming the run),
- * missing resources `404`, validation failures `400`, and anything else
- * surfaces as `500` with its message. Nest {@link HttpException}s pass
- * through unchanged.
- */
-function graphExecutionHttpErrorOf(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);
-}
-//# sourceMappingURL=GraphExecutionController.js.map

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

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

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

@@ -1,137 +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 GraphExecutionModule_1;
-/**
- * @module integrations/nest/graph/GraphExecutionModule
- * @summary NestJS graph backend module wiring (DECAF-50 §4.10–§4.16).
- * @description The dynamic module assembling the graph backend: the
- * {@link GraphExecutionEngine}, the trusted {@link GraphNodeCatalogue} with
- * built-in registrations, the run lifecycle services and stores, and the
- * HTTP/SSE controllers (catalogue, workflows, runs, legacy execution) — each
- * configurable with authentication enforcement and backend-enforced
- * resource limits via {@link GraphExecutionModuleOptions}.
- */
-import { Module } from "@nestjs/common";
-import { GraphExecutionEngine, GraphNodeCatalogue, GraphRunService, InMemoryGraphRunEventStore, } from "./../../graph/index.js";
-import { createDemoEngineConfig } from "./GraphExecutorRegistryFactory.js";
-import { GraphExecutionController, GRAPH_EXECUTION_OPTIONS } from "./GraphExecutionController.js";
-import { GraphNodeCatalogueController, GRAPH_CATALOGUE_CONTROLLER_OPTIONS, } from "./GraphNodeCatalogueController.js";
-import { GraphResultService } from "./GraphResultService.js";
-import { GraphRunModelService } from "./GraphRunModelService.js";
-import { GraphRunController, GRAPH_RUN_OPTIONS, } from "./GraphRunController.js";
-import { GraphWorkflowService, GRAPH_WORKFLOW_OPTIONS, } from "./GraphWorkflowService.js";
-import { GraphWorkflowController, } from "./GraphWorkflowController.js";
-/**
- * NestJS module wiring the graph execution stack (DECAF-50 §4.13–§4.16): the
- * engine, catalogue, workflow persistence, run lifecycle/SSE controllers,
- * and their services. Configure via {@link GraphExecutionModule.forRoot}.
- */
-let GraphExecutionModule = GraphExecutionModule_1 = class GraphExecutionModule {
-    /**
-     * Creates the dynamic module. Boots a default RamAdapter for standalone
-     * development unless `initAdapter` is `false`. Wires the optional
-     * {@link GraphCredentialAuthorizer} into the engine's stage-8 validator
-     * (SAA-595 F8), and applies the workflow options to the
-     * {@link GraphWorkflowService} singleton via its {@link
-     * GraphWorkflowService.configure} method, since `@service` constructor
-     * injection does not forward provider options reliably.
-     */
-    static forRoot(options = {}) {
-        const initAdapter = options.initAdapter ?? true;
-        const adapterUser = options.adapterUser ?? "graph-engine";
-        let engineConfig;
-        const sharedConfig = () => (engineConfig ??= createDemoEngineConfig());
-        const providers = [
-            {
-                provide: GraphExecutionEngine,
-                useFactory: async () => {
-                    if (initAdapter) {
-                        const { RamAdapter, RamFlavour } = await import("@decaf-ts/core/ram");
-                        const { Adapter } = await import("@decaf-ts/core");
-                        RamAdapter.decoration();
-                        Adapter.setCurrent(RamFlavour);
-                        new RamAdapter({ user: adapterUser });
-                    }
-                    const config = sharedConfig();
-                    return new GraphExecutionEngine(options.credentialAuthorizer
-                        ? { ...config, credentialAuthorizer: options.credentialAuthorizer }
-                        : config);
-                },
-            },
-            {
-                provide: GraphNodeCatalogue,
-                useFactory: () => sharedConfig().catalogue,
-            },
-            {
-                provide: GRAPH_CATALOGUE_CONTROLLER_OPTIONS,
-                useValue: options.catalogue ?? {},
-            },
-            {
-                provide: GRAPH_WORKFLOW_OPTIONS,
-                useValue: (options.workflows ?? {}),
-            },
-            {
-                provide: GRAPH_RUN_OPTIONS,
-                useValue: (options.runs ?? {}),
-            },
-            {
-                provide: GRAPH_EXECUTION_OPTIONS,
-                useValue: (options.execution ?? {}),
-            },
-            {
-                provide: InMemoryGraphRunEventStore,
-                useFactory: () => new InMemoryGraphRunEventStore(options.runs?.limits ?? {}),
-            },
-            GraphResultService,
-            GraphRunModelService,
-            {
-                provide: GraphWorkflowService,
-                useFactory: (workflowOptions) => new GraphWorkflowService().configure(workflowOptions),
-                inject: [GRAPH_WORKFLOW_OPTIONS],
-            },
-            {
-                provide: GraphRunService,
-                useFactory: (engine, runStore, eventStore, workflowService) => new GraphRunService(engine, runStore, eventStore, {
-                    limits: (options.runs?.limits ?? {}),
-                    allowAnonymousAccess: options.runs?.allowAnonymousAccess === true,
-                    documentResolver: {
-                        resolve: async (workflowId, _ownerUser, ...args) => workflowService.getDocument(workflowId, ...args),
-                    },
-                }),
-                inject: [
-                    GraphExecutionEngine,
-                    GraphRunModelService,
-                    InMemoryGraphRunEventStore,
-                    GraphWorkflowService,
-                ],
-            },
-        ];
-        return {
-            module: GraphExecutionModule_1,
-            controllers: [
-                GraphExecutionController,
-                GraphNodeCatalogueController,
-                GraphWorkflowController,
-                GraphRunController,
-            ],
-            providers,
-            exports: [
-                GraphExecutionEngine,
-                GraphNodeCatalogue,
-                GraphResultService,
-                GraphRunModelService,
-                GraphRunService,
-                GraphWorkflowService,
-            ],
-        };
-    }
-};
-GraphExecutionModule = GraphExecutionModule_1 = __decorate([
-    Module({})
-], GraphExecutionModule);
-export { GraphExecutionModule };
-//# sourceMappingURL=GraphExecutionModule.js.map

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

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