@mantajs/core 0.1.6 → 0.2.0-beta.0

package/dist/ports/event-bus.d.ts

@@ -0,0 +1,85 @@
+import type { Message } from '../events/types';
+import type { GroupStatus } from './types';
+/**
+ * Event bus port contract.
+ * Adapters: InMemoryEventBus (dev), Vercel Queues (prod).
+ */
+export interface IEventBusPort {
+    /**
+     * Emit one or more events. Optionally group them by eventGroupId.
+     * @param event - A single message or array of messages
+     * @param options - Optional groupId for grouped events
+     */
+    emit(event: Message | Message[], options?: {
+        groupId?: string;
+    }): Promise<void>;
+    /**
+     * Subscribe a handler to an event name.
+     * @param eventName - The event name to subscribe to
+     * @param handler - The handler function
+     * @param options - Optional subscriberId for unsubscribe
+     */
+    subscribe(eventName: string, handler: (event: Message) => Promise<void> | void, options?: {
+        subscriberId?: string;
+    }): void;
+    /**
+     * Unsubscribe a handler by its subscriberId.
+     * @param subscriberId - The subscriber to remove
+     */
+    unsubscribe(subscriberId: string): void;
+    /**
+     * Release all grouped events for the given groupId (emit them to subscribers).
+     * @param eventGroupId - The group to release
+     */
+    releaseGroupedEvents(eventGroupId: string): Promise<void>;
+    /**
+     * Clear all grouped events for the given groupId without emitting.
+     * @param eventGroupId - The group to clear
+     */
+    clearGroupedEvents(eventGroupId: string): Promise<void>;
+    /**
+     * Add an interceptor that observes messages as they are emitted.
+     * Interceptors are read-only, fire-and-forget.
+     * @param fn - The interceptor function
+     */
+    addInterceptor(fn: (message: Message, context?: {
+        isGrouped?: boolean;
+        eventGroupId?: string;
+    }) => Promise<void> | void): void;
+    /**
+     * Remove a previously added interceptor.
+     * @param fn - The interceptor function to remove
+     */
+    removeInterceptor(fn: (message: Message, context?: {
+        isGrouped?: boolean;
+        eventGroupId?: string;
+    }) => Promise<void> | void): void;
+    /**
+     * Optional: hook called when a new event group is created.
+     * @param handler - Callback receiving groupId and event count
+     */
+    onGroupCreated?(handler: (eventGroupId: string, eventCount: number) => void): void;
+    /**
+     * Optional: hook called when a group is released.
+     * @param handler - Callback receiving groupId and event count
+     */
+    onGroupReleased?(handler: (eventGroupId: string, eventCount: number) => void): void;
+    /**
+     * Optional: hook called when a group is cleared.
+     * @param handler - Callback receiving groupId, count, and reason
+     */
+    onGroupCleared?(handler: (eventGroupId: string, eventCount: number, reason: 'explicit' | 'ttl') => void): void;
+    /**
+     * Optional: get the status of a grouped event set.
+     * @param eventGroupId - The group to check
+     * @returns GroupStatus or null if group does not exist
+     */
+    getGroupStatus?(eventGroupId: string): GroupStatus | null;
+    /**
+     * Optional readiness probe. Returns true if the event bus backend is reachable.
+     * Used by /health/ready (BC-F22). If the adapter does not implement ping(),
+     * the readiness handler treats the event bus as present but unprobed.
+     */
+    ping?(): Promise<boolean>;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/ports/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/ports/event-bus.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/E;;;;;OAKG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EACjD,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAClC,IAAI,CAAA;IAEP;;;OAGG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAEvC;;;OAGG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzD;;;OAGG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEvD;;;;OAIG;IACH,cAAc,CACZ,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACvG,IAAI,CAAA;IAEP;;;OAGG;IACH,iBAAiB,CACf,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACvG,IAAI,CAAA;IAEP;;;OAGG;IACH,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IAElF;;;OAGG;IACH,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IAEnF;;;OAGG;IACH,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,KAAK,KAAK,IAAI,GAAG,IAAI,CAAA;IAE9G;;;;OAIG;IACH,cAAc,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAA;IAEzD;;;;OAIG;IACH,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAC1B"}

package/dist/ports/event-bus.js

@@ -0,0 +1,3 @@
+// SPEC-034 — IEventBusPort interface
+export {};
+//# sourceMappingURL=event-bus.js.map

package/dist/ports/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/ports/event-bus.ts"],"names":[],"mappings":"AAAA,qCAAqC"}

package/dist/ports/file.d.ts

@@ -0,0 +1,62 @@
+/**
+ * File storage port contract.
+ * Adapters: LocalFileAdapter (dev), VercelBlobAdapter (prod).
+ */
+export interface IFilePort {
+    /**
+     * Upload a file.
+     * @param key - The file key/path
+     * @param data - The file content as Buffer or ReadableStream
+     * @param contentType - Optional MIME type
+     * @returns The stored key and public URL
+     */
+    upload(key: string, data: Buffer | ReadableStream, contentType?: string): Promise<{
+        key: string;
+        url: string;
+    }>;
+    /**
+     * Delete one or more files.
+     * @param key - Single key or array of keys
+     */
+    delete(key: string | string[]): Promise<void>;
+    /**
+     * Get a presigned URL for downloading a file.
+     * @param key - The file key
+     * @returns The presigned download URL
+     */
+    getPresignedDownloadUrl(key: string): Promise<string>;
+    /**
+     * Optional: get a presigned URL for uploading a file.
+     * @param key - The file key
+     * @returns The presigned upload URL
+     */
+    getPresignedUploadUrl?(key: string): Promise<string>;
+    /**
+     * Get a readable stream for downloading a file.
+     * @param key - The file key
+     * @returns A ReadableStream of the file content
+     */
+    getDownloadStream(key: string): Promise<ReadableStream>;
+    /**
+     * Get file content as a Buffer.
+     * @param key - The file key
+     * @returns The file content as Buffer
+     */
+    getAsBuffer(key: string): Promise<Buffer>;
+    /**
+     * List files matching a prefix.
+     * @param prefix - The prefix to filter by
+     * @returns Array of matching file keys
+     */
+    list(prefix?: string): Promise<string[]>;
+    /**
+     * Optional: get a writable stream for uploading a file.
+     * @param key - The file key
+     * @returns An object with the writable stream and a done promise
+     */
+    getUploadStream?(key: string): Promise<{
+        stream: WritableStream;
+        done: Promise<void>;
+    }>;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/ports/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/ports/file.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAE/G;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE7C;;;;OAIG;IACH,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAErD;;;;OAIG;IACH,qBAAqB,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEpD;;;;OAIG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAEvD;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEzC;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAExC;;;;OAIG;IACH,eAAe,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAA;CACxF"}

package/dist/ports/file.js

@@ -0,0 +1,3 @@
+// SPEC-065/080/081 — IFilePort interface
+export {};
+//# sourceMappingURL=file.js.map

package/dist/ports/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/ports/file.ts"],"names":[],"mappings":"AAAA,yCAAyC"}

package/dist/ports/http.d.ts

@@ -0,0 +1,20 @@
+/**
+ * HTTP port contract (simplified).
+ * Adapters: NitroHttpAdapter.
+ */
+export interface IHttpPort {
+    /**
+     * Register a route handler.
+     * @param method - HTTP method (GET, POST, PUT, DELETE, etc.)
+     * @param path - The route path
+     * @param handler - The request handler returning a Response
+     */
+    registerRoute(method: string, path: string, handler: (req: Request) => Promise<Response> | Response): void;
+    /**
+     * Handle an incoming HTTP request through the pipeline.
+     * @param req - The incoming Request
+     * @returns The Response
+     */
+    handleRequest(req: Request): Promise<Response>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/ports/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/ports/http.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAA;IAE1G;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC/C"}

package/dist/ports/http.js

@@ -0,0 +1,3 @@
+// SPEC-039 — IHttpPort interface
+export {};
+//# sourceMappingURL=http.js.map

package/dist/ports/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/ports/http.ts"],"names":[],"mappings":"AAAA,iCAAiC"}

package/dist/ports/in-memory-progress-channel.d.ts

@@ -0,0 +1,9 @@
+import type { IProgressChannelPort, ProgressSnapshot } from './progress-channel';
+export declare class InMemoryProgressChannel implements IProgressChannelPort {
+    private _store;
+    set(runId: string, snapshot: ProgressSnapshot): Promise<void>;
+    get(runId: string): Promise<ProgressSnapshot | null>;
+    clear(runId: string): Promise<void>;
+    _reset(): void;
+}
+//# sourceMappingURL=in-memory-progress-channel.d.ts.map

package/dist/ports/in-memory-progress-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-progress-channel.d.ts","sourceRoot":"","sources":["../../src/ports/in-memory-progress-channel.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAEhF,qBAAa,uBAAwB,YAAW,oBAAoB;IAClE,OAAO,CAAC,MAAM,CAAsC;IAE9C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAIpD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,MAAM;CAGP"}

package/dist/ports/in-memory-progress-channel.js

@@ -0,0 +1,19 @@
+// InMemoryProgressChannel — test-only implementation of IProgressChannelPort.
+// See WORKFLOW_PROGRESS.md §9.2 "progress-memory: test containers".
+// Uses a plain Map — no TTL, no throttle.
+export class InMemoryProgressChannel {
+    _store = new Map();
+    async set(runId, snapshot) {
+        this._store.set(runId, snapshot);
+    }
+    async get(runId) {
+        return this._store.get(runId) ?? null;
+    }
+    async clear(runId) {
+        this._store.delete(runId);
+    }
+    _reset() {
+        this._store.clear();
+    }
+}
+//# sourceMappingURL=in-memory-progress-channel.js.map

package/dist/ports/in-memory-progress-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-progress-channel.js","sourceRoot":"","sources":["../../src/ports/in-memory-progress-channel.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oEAAoE;AACpE,0CAA0C;AAI1C,MAAM,OAAO,uBAAuB;IAC1B,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAA;IAEpD,KAAK,CAAC,GAAG,CAAC,KAAa,EAAE,QAA0B;QACjD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IAClC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAA;IACvC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAa;QACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;CACF"}

package/dist/ports/in-memory-queue.d.ts

@@ -0,0 +1,24 @@
+import type { IQueuePort, QueueMessage } from './queue';
+export interface InMemoryQueueAdapterOptions {
+    /**
+     * Extra headers to add to every POST — typically an internal auth header
+     * the resume route trusts (so end users can't spam /_workflow/:id/resume).
+     */
+    headers?: Record<string, string>;
+    /** fetch implementation override — for tests. Defaults to global fetch. */
+    fetch?: typeof globalThis.fetch;
+    /** Logger for delivery failures. */
+    logger?: {
+        warn: (msg: string) => void;
+        error?: (msg: string, err?: unknown) => void;
+    };
+}
+export declare class InMemoryQueueAdapter implements IQueuePort {
+    private _recent;
+    private _headers;
+    private _fetch;
+    private _logger;
+    constructor(opts?: InMemoryQueueAdapterOptions);
+    enqueue(message: QueueMessage): Promise<void>;
+}
+//# sourceMappingURL=in-memory-queue.d.ts.map

package/dist/ports/in-memory-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-queue.d.ts","sourceRoot":"","sources":["../../src/ports/in-memory-queue.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAIvD,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAC/B,oCAAoC;IACpC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAA;CACvF;AAED,qBAAa,oBAAqB,YAAW,UAAU;IACrD,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,OAAO,CAAuC;gBAE1C,IAAI,GAAE,2BAAgC;IAM5C,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAoCpD"}

package/dist/ports/in-memory-queue.js

@@ -0,0 +1,63 @@
+// InMemoryQueueAdapter — dev / test IQueuePort implementation.
+//
+// Delivers messages via `setImmediate(() => fetch(url, { method: 'POST', body }))`
+// in the same Node process. Sufficient for local `pnpm dev` where the dev
+// server and the lambda handler share a process. Loses messages on process
+// death — use `@mantajs/adapter-queue-qstash` (or a similar durable queue) for
+// production.
+//
+// Idempotency: keeps a small in-memory LRU of recently-delivered keys so
+// duplicate enqueues (e.g. a step that throws mid-retry) don't deliver
+// twice within the same process. Best-effort; not a substitute for the
+// durable dedupe a real queue provides.
+const RECENT_KEYS_MAX = 1000;
+export class InMemoryQueueAdapter {
+    _recent = new Set();
+    _headers;
+    _fetch;
+    _logger;
+    constructor(opts = {}) {
+        this._headers = opts.headers ?? {};
+        this._fetch = opts.fetch ?? globalThis.fetch;
+        this._logger = opts.logger;
+    }
+    async enqueue(message) {
+        if (message.idempotencyKey) {
+            if (this._recent.has(message.idempotencyKey))
+                return;
+            this._recent.add(message.idempotencyKey);
+            if (this._recent.size > RECENT_KEYS_MAX) {
+                // Evict oldest — Set iteration is insertion order so pop the first one.
+                const first = this._recent.values().next().value;
+                if (first !== undefined)
+                    this._recent.delete(first);
+            }
+        }
+        const delay = Math.max(0, message.delayMs ?? 0);
+        const deliver = async () => {
+            try {
+                const res = await this._fetch(message.url, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json', ...this._headers },
+                    body: JSON.stringify(message.payload ?? {}),
+                });
+                if (!res.ok) {
+                    const body = await res.text().catch(() => '');
+                    this._logger?.warn?.(`[InMemoryQueueAdapter] delivery ${res.status} for ${message.url}: ${body.slice(0, 200)}`);
+                }
+            }
+            catch (err) {
+                this._logger?.error?.(`[InMemoryQueueAdapter] delivery failed for ${message.url}`, err);
+            }
+        };
+        if (delay > 0) {
+            setTimeout(deliver, delay);
+        }
+        else {
+            // setImmediate so the enqueue returns before the POST fires — matches
+            // real queue semantics where enqueue is decoupled from delivery.
+            setImmediate(deliver);
+        }
+    }
+}
+//# sourceMappingURL=in-memory-queue.js.map

package/dist/ports/in-memory-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-queue.js","sourceRoot":"","sources":["../../src/ports/in-memory-queue.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,mFAAmF;AACnF,0EAA0E;AAC1E,2EAA2E;AAC3E,+EAA+E;AAC/E,cAAc;AACd,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,uEAAuE;AACvE,wCAAwC;AAIxC,MAAM,eAAe,GAAG,IAAI,CAAA;AAc5B,MAAM,OAAO,oBAAoB;IACvB,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;IAC3B,QAAQ,CAAwB;IAChC,MAAM,CAAyB;IAC/B,OAAO,CAAuC;IAEtD,YAAY,OAAoC,EAAE;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAA;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAA;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAqB;QACjC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC;gBAAE,OAAM;YACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;YACxC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,eAAe,EAAE,CAAC;gBACxC,wEAAwE;gBACxE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;gBAChD,IAAI,KAAK,KAAK,SAAS;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACrD,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,CAAA;QAC/C,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;oBACzC,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;oBACjE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;iBAC5C,CAAC,CAAA;gBACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;oBAC7C,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAClB,mCAAmC,GAAG,CAAC,MAAM,QAAQ,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC1F,CAAA;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,8CAA8C,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAA;YACzF,CAAC;QACH,CAAC,CAAA;QACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC5B,CAAC;aAAM,CAAC;YACN,sEAAsE;YACtE,iEAAiE;YACjE,YAAY,CAAC,OAAO,CAAC,CAAA;QACvB,CAAC;IACH,CAAC;CACF"}

package/dist/ports/index.d.ts

@@ -0,0 +1,27 @@
+export type { AuthenticationInput, AuthenticationResponse } from '../auth/providers/types';
+export type { AuthContext, AuthCredentials, SessionOptions } from '../auth/types';
+export type { GetMessagesOptions, IMessageAggregator, Message } from '../events/types';
+export type { IAnalyticsProvider } from './analytics';
+export type { IAuthGateway, IAuthModuleService, IAuthPort } from './auth';
+export type { ICachePort } from './cache';
+export type { IDatabasePort } from './database';
+export type { IEventBusPort } from './event-bus';
+export type { IFilePort } from './file';
+export type { IHttpPort } from './http';
+export { InMemoryProgressChannel } from './in-memory-progress-channel';
+export { InMemoryQueueAdapter, type InMemoryQueueAdapterOptions } from './in-memory-queue';
+export type { IJobSchedulerPort } from './job-scheduler';
+export type { ILockingPort } from './locking';
+export type { ILoggerPort } from './logger';
+export type { INotificationPort } from './notification';
+export type { IProgressChannelPort, ProgressSnapshot } from './progress-channel';
+export type { IQueuePort, QueueMessage } from './queue';
+export type { IRelationalQueryPort, RelationalQueryConfig } from './relational-query';
+export type { IRepository } from './repository';
+export type { IRepositoryFactory } from './repository-factory';
+export type { ISchemaGenerator } from './schema-generator';
+export type { ISearchProvider } from './search';
+export type { Context, CursorPagination, DatabaseConfig, GroupStatus, JobExecution, JobResult, TransactionOptions, WorkflowLifecycleEvent, } from './types';
+export { ContainerRegistrationKeys } from './types';
+export type { IWorkflowStorePort, NewWorkflowRun, StepState, StepStatus, WorkflowError, WorkflowRun, WorkflowStatus, } from './workflow-store';
+//# sourceMappingURL=index.d.ts.map

package/dist/ports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAE1F,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEjF,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACtF,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAEzE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACvC,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,mBAAmB,CAAA;AAC1F,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAChF,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACvD,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AACrF,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,YAAY,EACV,OAAO,EACP,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AACnD,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,kBAAkB,CAAA"}

package/dist/ports/index.js

@@ -0,0 +1,6 @@
+// Port interfaces — re-exports all port contracts
+// Each port is defined in its own file with SPEC references.
+export { InMemoryProgressChannel } from './in-memory-progress-channel';
+export { InMemoryQueueAdapter } from './in-memory-queue';
+export { ContainerRegistrationKeys } from './types';
+//# sourceMappingURL=index.js.map

package/dist/ports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,6DAA6D;AAe7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAoC,MAAM,mBAAmB,CAAA;AAuB1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA"}

package/dist/ports/job-scheduler.d.ts

@@ -0,0 +1,42 @@
+import type { MantaApp } from '../app';
+import type { JobExecution, JobResult } from './types';
+/**
+ * Job scheduler port contract.
+ * Adapters: NodeCronJobScheduler (dev), VercelCronAdapter (prod).
+ * Dependencies: ILockingPort, ILoggerPort.
+ */
+export interface IJobSchedulerPort {
+    /**
+     * Register a scheduled job.
+     * @param name - Unique job name
+     * @param schedule - Cron expression
+     * @param handler - Job handler receiving the app
+     * @param options - Concurrency, execution limit, and retry options
+     */
+    register(name: string, schedule: string, handler: (ctx: {
+        app: MantaApp;
+    }) => Promise<JobResult>, options?: {
+        concurrency?: 'allow' | 'forbid';
+        numberOfExecutions?: number;
+        timeout?: number;
+        retry?: {
+            maxRetries: number;
+            backoff?: 'fixed' | 'exponential';
+            delay?: number;
+        };
+    }): void;
+    /**
+     * Manually trigger a registered job.
+     * @param name - The job name
+     * @returns The job execution result
+     */
+    runJob(name: string): Promise<JobResult>;
+    /**
+     * Get execution history for a job.
+     * @param jobName - The job name
+     * @param limit - Maximum number of records to return
+     * @returns Array of job execution records
+     */
+    getJobHistory(jobName: string, limit?: number): Promise<JobExecution[]>;
+}
+//# sourceMappingURL=job-scheduler.d.ts.map

package/dist/ports/job-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-scheduler.d.ts","sourceRoot":"","sources":["../../src/ports/job-scheduler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEtD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,GAAG,EAAE;QAAE,GAAG,EAAE,QAAQ,CAAA;KAAE,KAAK,OAAO,CAAC,SAAS,CAAC,EACvD,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;QAChC,kBAAkB,CAAC,EAAE,MAAM,CAAA;QAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAClF,GACA,IAAI,CAAA;IAEP;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IAExC;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;CACxE"}

package/dist/ports/job-scheduler.js

@@ -0,0 +1,3 @@
+// SPEC-063 — IJobSchedulerPort interface
+export {};
+//# sourceMappingURL=job-scheduler.js.map

package/dist/ports/job-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-scheduler.js","sourceRoot":"","sources":["../../src/ports/job-scheduler.ts"],"names":[],"mappings":"AAAA,yCAAyC"}

package/dist/ports/locking.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Locking port contract.
+ * Adapters: InMemoryLocking (dev), Neon advisory locks (prod).
+ */
+export interface ILockingPort {
+    /**
+     * Execute a job while holding locks on the given keys.
+     * Acquires locks, runs job, releases locks.
+     * @param keys - Lock keys to acquire
+     * @param job - The function to execute under lock
+     * @param options - Optional timeout in ms
+     * @returns The result of the job function
+     */
+    execute<T>(keys: string[], job: () => Promise<T>, options?: {
+        timeout?: number;
+    }): Promise<T>;
+    /**
+     * Manually acquire locks on one or more keys.
+     * @param keys - Lock key(s) to acquire
+     * @param options - Optional ownerId and expiration in ms
+     * @returns True if all locks were acquired, false otherwise
+     */
+    acquire(keys: string | string[], options?: {
+        ownerId?: string;
+        expire?: number;
+    }): Promise<boolean>;
+    /**
+     * Release locks on one or more keys.
+     * @param keys - Lock key(s) to release
+     * @param options - Optional ownerId to verify ownership
+     */
+    release(keys: string | string[], options?: {
+        ownerId?: string;
+    }): Promise<void>;
+    /**
+     * Release all locks held by an owner.
+     * @param options - Optional ownerId filter
+     */
+    releaseAll(options?: {
+        ownerId?: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=locking.d.ts.map

package/dist/ports/locking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locking.d.ts","sourceRoot":"","sources":["../../src/ports/locking.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAE7F;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEnG;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/E;;;OAGG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1D"}

package/dist/ports/locking.js

@@ -0,0 +1,3 @@
+// SPEC-066/089/090 — ILockingPort interface
+export {};
+//# sourceMappingURL=locking.js.map

package/dist/ports/locking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locking.js","sourceRoot":"","sources":["../../src/ports/locking.ts"],"names":[],"mappings":"AAAA,4CAA4C"}

package/dist/ports/logger.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Logger port contract.
+ * Adapters: PinoLogger (dev/prod).
+ */
+export interface ILoggerPort {
+    /** Log at error level */
+    error(msg: string, ...args: unknown[]): void;
+    /** Log at warn level */
+    warn(msg: string, ...args: unknown[]): void;
+    /** Log at info level */
+    info(msg: string, ...args: unknown[]): void;
+    /** Log at http level */
+    http(msg: string, ...args: unknown[]): void;
+    /** Log at verbose level */
+    verbose(msg: string, ...args: unknown[]): void;
+    /** Log at debug level */
+    debug(msg: string, ...args: unknown[]): void;
+    /** Log at silly level */
+    silly(msg: string, ...args: unknown[]): void;
+    /**
+     * Log a panic-level message and potentially crash.
+     * @param data - Arbitrary data to log
+     */
+    panic(data: unknown): void;
+    /**
+     * Start a timed activity log.
+     * @param msg - The activity description
+     * @returns An activity ID for progress/success/failure
+     */
+    activity(msg: string): string;
+    /**
+     * Log progress on an activity.
+     * @param id - The activity ID
+     * @param msg - Progress message
+     */
+    progress(id: string, msg: string): void;
+    /**
+     * Mark an activity as successful.
+     * @param id - The activity ID
+     * @param msg - Success message
+     */
+    success(id: string, msg: string): void;
+    /**
+     * Mark an activity as failed.
+     * @param id - The activity ID
+     * @param msg - Failure message
+     */
+    failure(id: string, msg: string): void;
+    /**
+     * Check if a given log level would be output.
+     * @param level - The log level to check
+     * @returns True if messages at this level would be logged
+     */
+    shouldLog(level: string): boolean;
+    /**
+     * Override the current log level.
+     * @param level - The new log level
+     */
+    setLogLevel(level: string): void;
+    /**
+     * Reset the log level to the default.
+     */
+    unsetLogLevel(): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/ports/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/ports/logger.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC5C,wBAAwB;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC3C,wBAAwB;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC3C,wBAAwB;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC3C,2BAA2B;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9C,yBAAyB;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC5C,yBAAyB;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAE5C;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAEvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAEtC;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAEtC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IAEjC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAEhC;;OAEG;IACH,aAAa,IAAI,IAAI,CAAA;CACtB"}

package/dist/ports/logger.js

@@ -0,0 +1,3 @@
+// SPEC-067/082 — ILoggerPort interface
+export {};
+//# sourceMappingURL=logger.js.map

package/dist/ports/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/ports/logger.ts"],"names":[],"mappings":"AAAA,uCAAuC"}