@mantajs/core 0.1.7 → 0.2.0-beta.0

package/dist/ports/notification.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Notification port contract.
+ *
+ * The payload is provider-agnostic but biased toward email semantics
+ * (subject/html/text/headers/tags) since email is the dominant channel.
+ * For other channels (sms, push), the implementation may ignore email-only
+ * fields. Adapters MUST validate channel-specific requirements at runtime.
+ *
+ * `to` is a single recipient. Adapters that natively support multi-recipient
+ * sends should expose `sendBatch` instead — the framework's contract is
+ * one-recipient-per-call so retries and failures are scoped.
+ *
+ * `idempotency_key` is the caller's responsibility. Adapters that support
+ * native dedupe (e.g. Resend's `Idempotency-Key` header) should forward it;
+ * adapters that don't should at minimum maintain in-memory dedupe within the
+ * process (see InMemoryNotificationAdapter).
+ */
+export interface INotificationPort {
+    /**
+     * Send a notification.
+     * @param notification - The notification payload
+     * @returns Send result with status and optional id/error
+     */
+    send(notification: {
+        /** Single recipient (email address, phone number, push token...). */
+        to: string;
+        /** Channel name — open string. Common values: `email`, `sms`, `push`. */
+        channel: string;
+        /** Sender. Required for email if no `defaultFrom` is configured on the adapter. */
+        from?: string;
+        /** Reply-to address(es). Email-only. */
+        replyTo?: string | string[];
+        /** Subject line. Required when `channel === 'email'`. */
+        subject?: string;
+        /** HTML body. At least one of `html` or `text` is required for email. */
+        html?: string;
+        /** Plain-text body. At least one of `html` or `text` is required for email. */
+        text?: string;
+        /** Custom email headers (e.g. `List-Unsubscribe`). */
+        headers?: Record<string, string>;
+        /** Provider tags for analytics/segmentation. */
+        tags?: Array<{
+            name: string;
+            value: string;
+        }>;
+        /** Caller-supplied dedupe key. Adapters forward to provider when supported. */
+        idempotency_key?: string;
+    }): Promise<{
+        status: 'SUCCESS' | 'FAILURE' | 'PENDING';
+        id?: string;
+        error?: Error;
+    }>;
+    /**
+     * Optional: send multiple notifications in batch.
+     * @param notifications - Array of notification payloads
+     * @returns Array of send results
+     */
+    sendBatch?(notifications: Array<Parameters<INotificationPort['send']>[0]>): Promise<Array<Awaited<ReturnType<INotificationPort['send']>>>>;
+    /**
+     * Optional: list sent notifications.
+     * @returns Array of notification records
+     */
+    list?(): Promise<unknown[]>;
+    /**
+     * Optional: retrieve a specific notification by id.
+     * @param id - The notification id
+     * @returns The notification record or null
+     */
+    retrieve?(id: string): Promise<unknown | null>;
+}
+//# sourceMappingURL=notification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../src/ports/notification.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,CAAC,YAAY,EAAE;QACjB,qEAAqE;QACrE,EAAE,EAAE,MAAM,CAAA;QACV,yEAAyE;QACzE,OAAO,EAAE,MAAM,CAAA;QACf,mFAAmF;QACnF,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,wCAAwC;QACxC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;QAC3B,yDAAyD;QACzD,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,yEAAyE;QACzE,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,+EAA+E;QAC/E,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,sDAAsD;QACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,gDAAgD;QAChD,IAAI,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC7C,+EAA+E;QAC/E,eAAe,CAAC,EAAE,MAAM,CAAA;KACzB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,CAAA;IAEtF;;;;OAIG;IACH,SAAS,CAAC,CACR,aAAa,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC7D,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAEjE;;;OAGG;IACH,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;CAC/C"}

package/dist/ports/notification.js

@@ -0,0 +1,3 @@
+// SPEC-097 — INotificationPort interface
+export {};
+//# sourceMappingURL=notification.js.map

package/dist/ports/notification.js.map

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

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

@@ -0,0 +1,46 @@
+/**
+ * One-shot progress snapshot written by a running step.
+ * Latest snapshot overrides the previous — no history is retained.
+ */
+export interface ProgressSnapshot {
+    /** Name of the step that produced this snapshot. */
+    stepName: string;
+    /** Current progress count (e.g. items processed). */
+    current: number;
+    /** Total expected count. `null` for unbounded AsyncIterable streams. */
+    total: number | null;
+    /** Optional human-readable status message. */
+    message?: string;
+    /** Epoch milliseconds when the snapshot was produced. */
+    at: number;
+}
+/**
+ * Ephemeral progress channel contract.
+ *
+ * Adapters: UpstashProgressChannel (default), DbProgressChannel (fallback when
+ * no cache is configured), InMemoryProgressChannel (test containers).
+ *
+ * Invariants (see WORKFLOW_PROGRESS.md §10.2):
+ * 1. `set()` is fire-and-forget — callers never await the network/IO.
+ * 2. `set()` never throws — channel errors are logged, not propagated.
+ * 3. No throttle at the call site — the adapter copes (Upstash handles volume
+ *    trivially; the DB fallback throttles internally).
+ */
+export interface IProgressChannelPort {
+    /**
+     * Write the latest snapshot for a run. Overrides any previous snapshot.
+     * MUST NOT throw — errors are logged and swallowed.
+     */
+    set(runId: string, snapshot: ProgressSnapshot): Promise<void>;
+    /**
+     * Read the latest snapshot for a run, or `null` if none / expired.
+     * Called from the `/_workflow/:id` read path — MAY throw.
+     */
+    get(runId: string): Promise<ProgressSnapshot | null>;
+    /**
+     * Clear the snapshot for a run (e.g. on workflow completion).
+     * Called from the engine cleanup path — MAY throw.
+     */
+    clear(runId: string): Promise<void>;
+}
+//# sourceMappingURL=progress-channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress-channel.d.ts","sourceRoot":"","sources":["../../src/ports/progress-channel.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE7D;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IAEpD;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC"}

package/dist/ports/progress-channel.js

@@ -0,0 +1,6 @@
+// IProgressChannelPort — ephemeral liveness channel for workflow step progress.
+// Separate from IWorkflowStorePort (durable) so `ctx.progress()` has sub-ms cost.
+// See WORKFLOW_PROGRESS.md §3 (durability vs liveness), §5.2 (snapshot shape),
+// §9.2 (three adapters), §10.2 (fire-and-forget invariants).
+export {};
+//# sourceMappingURL=progress-channel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress-channel.js","sourceRoot":"","sources":["../../src/ports/progress-channel.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kFAAkF;AAClF,+EAA+E;AAC/E,6DAA6D"}

package/dist/ports/queue.d.ts

@@ -0,0 +1,21 @@
+export interface QueueMessage {
+    /** Target URL the queue should POST to deliver this message. */
+    url: string;
+    /** JSON-serializable payload. Delivered as the POST body. */
+    payload: unknown;
+    /**
+     * Delay in milliseconds before delivery. 0 = deliver as soon as possible.
+     * Adapters MAY round up to their minimum granularity.
+     */
+    delayMs?: number;
+    /**
+     * Optional idempotency key. Adapters SHOULD deduplicate on this key so a
+     * retried enqueue does not produce multiple deliveries. WorkflowManager
+     * passes `resume:<runId>` so a crashed enqueue can be safely retried.
+     */
+    idempotencyKey?: string;
+}
+export interface IQueuePort {
+    enqueue(message: QueueMessage): Promise<void>;
+}
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/ports/queue.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAA;IACX,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAA;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C"}

package/dist/ports/queue.js

@@ -0,0 +1,15 @@
+// IQueuePort — pluggable job scheduler used by WorkflowManager for
+// serverless continuations (WORKFLOW_PROGRESS.md addendum — yield primitive).
+//
+// When a step throws WorkflowYield, the manager persists its `resumeState`,
+// marks the run `paused`, and asks the configured IQueuePort to enqueue a
+// POST to the resume endpoint. The queue delivers that request in a fresh
+// serverless invocation, which calls `manager.resume(runId)` to continue.
+//
+// Adapters:
+//   - `InMemoryQueueAdapter` (in @mantajs/core) — test / dev, uses setImmediate +
+//     direct HTTP fetch to self. Loses messages on process death.
+//   - `@mantajs/adapter-queue-qstash` — production. Upstash QStash HTTP scheduler,
+//     durable, retry-safe, free tier 500 msg/day.
+export {};
+//# sourceMappingURL=queue.js.map

package/dist/ports/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/ports/queue.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,EAAE;AACF,YAAY;AACZ,kFAAkF;AAClF,kEAAkE;AAClE,mFAAmF;AACnF,kDAAkD"}

package/dist/ports/relational-query.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Configuration for relational queries with native JOINs.
+ */
+export interface RelationalQueryConfig {
+    entity: string;
+    fields?: string[];
+    filters?: Record<string, unknown>;
+    sort?: Record<string, 'asc' | 'desc'>;
+    pagination?: {
+        limit?: number;
+        offset?: number;
+    };
+    relPagination?: Record<string, {
+        limit?: number;
+        offset?: number;
+    }>;
+    withDeleted?: boolean;
+}
+/**
+ * IRelationalQueryPort — ORM-agnostic port for relational queries with native JOINs.
+ *
+ * When available, Query.graph() delegates to this port instead of N+1 entity resolvers.
+ * The Drizzle adapter uses `db.query.*.findMany()` for eager loading and explicit JOINs
+ * for cross-relation filtering.
+ */
+export interface IRelationalQueryPort {
+    /**
+     * Find entities with their relations using native SQL JOINs.
+     * Returns nested objects matching the requested fields.
+     */
+    findWithRelations(config: RelationalQueryConfig): Promise<Record<string, unknown>[]>;
+    /**
+     * Find entities with relations and return total count for pagination.
+     */
+    findAndCountWithRelations(config: RelationalQueryConfig): Promise<[Record<string, unknown>[], number]>;
+}
+//# sourceMappingURL=relational-query.d.ts.map

package/dist/ports/relational-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relational-query.d.ts","sourceRoot":"","sources":["../../src/ports/relational-query.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,CAAA;IACrC,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACnE,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;IAEpF;;OAEG;IACH,yBAAyB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAA;CACvG"}

package/dist/ports/relational-query.js

@@ -0,0 +1,3 @@
+// SPEC-011b — IRelationalQueryPort for native SQL JOINs via Drizzle relations
+export {};
+//# sourceMappingURL=relational-query.js.map

package/dist/ports/relational-query.js.map

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

package/dist/ports/repository-factory.d.ts

@@ -0,0 +1,21 @@
+import type { IRepository } from './repository';
+/**
+ * Repository factory port contract.
+ * Creates IRepository instances for specific entities.
+ * Adapters: DrizzleRepositoryFactory (prod), InMemoryRepositoryFactory (test).
+ */
+export interface IRepositoryFactory {
+    /**
+     * Create a repository for the given entity.
+     * @param entityName - The entity name (used to look up schema/table)
+     * @param options - Adapter-specific options
+     * @returns A repository instance for the entity
+     */
+    createRepository<T = unknown>(entityName: string, options?: Record<string, unknown>): IRepository<T>;
+    /**
+     * Register a table/schema for a given entity name.
+     * Called by the bootstrap to register auth, user, and link tables.
+     */
+    registerTable?(entityName: string, table: unknown): void;
+}
+//# sourceMappingURL=repository-factory.d.ts.map

package/dist/ports/repository-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-factory.d.ts","sourceRoot":"","sources":["../../src/ports/repository-factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;IAEpG;;;OAGG;IACH,aAAa,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;CACzD"}

package/dist/ports/repository-factory.js

@@ -0,0 +1,4 @@
+// SPEC-126 — IRepositoryFactory port
+// Factory for creating entity-specific repositories.
+export {};
+//# sourceMappingURL=repository-factory.js.map

package/dist/ports/repository-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-factory.js","sourceRoot":"","sources":["../../src/ports/repository-factory.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,qDAAqD"}

package/dist/ports/repository.d.ts

@@ -0,0 +1,73 @@
+import type { CursorPagination } from './types';
+/**
+ * Repository port contract.
+ * Provides CRUD operations with soft-delete support.
+ * Adapters: DrizzleRepository (prod), InMemoryRepository (test).
+ */
+export interface IRepository<T = unknown> {
+    /**
+     * Find entities matching the given criteria.
+     * Soft-deleted entities are excluded unless withDeleted is true.
+     * @param options - Query options (where, pagination, ordering, cursor)
+     * @returns Array of matching entities
+     */
+    find(options?: {
+        where?: Record<string, unknown>;
+        withDeleted?: boolean;
+        limit?: number;
+        offset?: number;
+        order?: Record<string, 'ASC' | 'DESC'>;
+        cursor?: CursorPagination;
+    }): Promise<T[]>;
+    /**
+     * Find entities and return total count.
+     * @param options - Query options
+     * @returns Tuple of [entities, totalCount]
+     */
+    findAndCount(options?: Record<string, unknown>): Promise<[T[], number]>;
+    /**
+     * Create one or more entities.
+     * @param data - Entity data or array of entity data
+     * @returns The created entity or entities
+     */
+    create(data: Record<string, unknown> | Record<string, unknown>[]): Promise<T | T[]>;
+    /**
+     * Update one or more entities.
+     * @param data - Entity data with id(s) or array of entity data
+     * @returns The updated entity or entities
+     */
+    update(data: Record<string, unknown> | Record<string, unknown>[]): Promise<T | T[]>;
+    /**
+     * Hard delete entities by id.
+     * @param ids - Single id or array of ids
+     */
+    delete(ids: string | string[]): Promise<void>;
+    /**
+     * Soft delete entities by setting deleted_at.
+     * @param ids - Single id or array of ids
+     * @returns Map of entity type to affected ids
+     */
+    softDelete(ids: string | string[]): Promise<Record<string, string[]>>;
+    /**
+     * Restore soft-deleted entities by clearing deleted_at.
+     * @param ids - Single id or array of ids
+     */
+    restore(ids: string | string[]): Promise<void>;
+    /**
+     * Serialize entity data for output.
+     * @param data - Raw entity data
+     * @param options - Serialization options
+     * @returns Serialized data
+     */
+    serialize(data: unknown, options?: unknown): Promise<unknown>;
+    /**
+     * Upsert entities with conflict resolution.
+     * INSERT ON CONFLICT DO UPDATE for specified fields.
+     * @param data - Array of entity data
+     * @param replaceFields - Fields to update on conflict
+     * @param conflictTarget - Columns to detect conflict on
+     * @returns The upserted entities
+     */
+    upsertWithReplace(data: Record<string, unknown>[], replaceFields?: string[], conflictTarget?: string[]): Promise<T[]>;
+}
+//# sourceMappingURL=repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/ports/repository.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC;;;;;OAKG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,CAAA;QACtC,MAAM,CAAC,EAAE,gBAAgB,CAAA;KAC1B,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;IAEhB;;;;OAIG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAA;IAEvE;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAEnF;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAEnF;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE7C;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAErE;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9C;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE7D;;;;;;;OAOG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;CACtH"}

package/dist/ports/repository.js

@@ -0,0 +1,3 @@
+// SPEC-126 — IRepository interface
+export {};
+//# sourceMappingURL=repository.js.map

package/dist/ports/repository.js.map

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

package/dist/ports/schema-generator.d.ts

@@ -0,0 +1,15 @@
+import type { ParsedDmlEntity } from '../dml/generator';
+/**
+ * Schema generator port contract.
+ * Transforms parsed DML entities into ORM-specific schema definitions.
+ * Adapters: DrizzleSchemaGenerator (prod), future alternatives.
+ */
+export interface ISchemaGenerator {
+    /**
+     * Generate an ORM-specific schema from a parsed DML entity.
+     * @param entity - The parsed DML entity definition
+     * @returns The generated schema (type depends on adapter)
+     */
+    generate(entity: ParsedDmlEntity): unknown;
+}
+//# sourceMappingURL=schema-generator.d.ts.map

package/dist/ports/schema-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-generator.d.ts","sourceRoot":"","sources":["../../src/ports/schema-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAA;CAC3C"}

package/dist/ports/schema-generator.js

@@ -0,0 +1,4 @@
+// SPEC-057f — ISchemaGenerator port
+// Decouples DML→schema generation from any specific ORM (Drizzle, etc.)
+export {};
+//# sourceMappingURL=schema-generator.js.map

package/dist/ports/schema-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-generator.js","sourceRoot":"","sources":["../../src/ports/schema-generator.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,wEAAwE"}

package/dist/ports/search.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Search provider contract.
+ * Multiple simultaneous implementations possible.
+ * TODO: Define full interface when implementing search features.
+ */
+export type ISearchProvider = {};
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/ports/search.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,EAAE,CAAA"}

package/dist/ports/search.js

@@ -0,0 +1,3 @@
+// SPEC — ISearchProvider interface (placeholder)
+export {};
+//# sourceMappingURL=search.js.map

package/dist/ports/search.js.map

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

package/dist/ports/types.d.ts

@@ -0,0 +1,112 @@
+import type { MantaError } from '../errors/manta-error';
+/**
+ * Well-known registration keys for resolving ports.
+ */
+export declare const ContainerRegistrationKeys: {
+    readonly CACHE: "ICachePort";
+    readonly EVENT_BUS: "IEventBusPort";
+    readonly LOCKING: "ILockingPort";
+    readonly LOGGER: "ILoggerPort";
+    readonly AUTH: "IAuthPort";
+    readonly AUTH_MODULE: "IAuthModuleService";
+    readonly AUTH_GATEWAY: "IAuthGateway";
+    readonly MESSAGE_AGGREGATOR: "IMessageAggregator";
+    readonly FILE: "IFilePort";
+    readonly DATABASE: "IDatabasePort";
+    readonly JOB_SCHEDULER: "IJobSchedulerPort";
+    readonly NOTIFICATION: "INotificationPort";
+    readonly HTTP: "IHttpPort";
+    readonly SCHEMA_GENERATOR: "ISchemaGenerator";
+    readonly REPOSITORY_FACTORY: "IRepositoryFactory";
+    readonly QUERY: "query";
+    readonly REMOTE_QUERY: "remoteQuery";
+    readonly LINK: "link";
+    readonly REMOTE_LINK: "remoteLink";
+};
+/**
+ * Execution context passed to workflow steps.
+ */
+export interface Context {
+    transactionManager?: unknown;
+    manager?: unknown;
+    isolationLevel?: string;
+    enableNestedTransactions?: boolean;
+    eventGroupId?: string;
+    transactionId?: string;
+    runId?: string;
+    requestId?: string;
+    messageAggregator?: unknown;
+    idempotencyKey?: string;
+    isCancelling?: boolean;
+    auth_context?: import('../auth/types').AuthContext;
+}
+/**
+ * Result of a scheduled job execution.
+ */
+export interface JobResult {
+    status: 'success' | 'failure' | 'skipped';
+    data?: unknown;
+    error?: MantaError;
+    duration_ms: number;
+}
+/**
+ * Historical record of a job execution.
+ */
+export interface JobExecution {
+    job_name: string;
+    started_at: Date;
+    finished_at: Date;
+    status: 'success' | 'failure' | 'skipped';
+    error?: string;
+    attempt: number;
+}
+/**
+ * Lifecycle events emitted by the workflow engine.
+ */
+export interface WorkflowLifecycleEvent {
+    type: 'STEP_SUCCESS' | 'STEP_FAILURE' | 'FINISH' | 'COMPENSATE_BEGIN' | 'COMPENSATE_END';
+    workflowId: string;
+    transactionId: string;
+    stepId?: string;
+    result?: unknown;
+    error?: MantaError;
+    status?: string;
+}
+/**
+ * Transaction options for database/repository operations.
+ */
+export interface TransactionOptions {
+    isolationLevel?: 'READ UNCOMMITTED' | 'READ COMMITTED' | 'REPEATABLE READ' | 'SERIALIZABLE';
+    transaction?: unknown;
+    enableNestedTransactions?: boolean;
+}
+/**
+ * Database connection configuration.
+ */
+export interface DatabaseConfig {
+    url: string;
+    pool?: {
+        min?: number;
+        max?: number;
+        idleTimeout?: number;
+    };
+    ssl?: boolean;
+}
+/**
+ * Cursor-based pagination options.
+ */
+export interface CursorPagination {
+    cursor?: string;
+    limit: number;
+    direction: 'forward' | 'backward';
+}
+/**
+ * Status of a grouped event set.
+ */
+export interface GroupStatus {
+    exists: boolean;
+    eventCount: number;
+    createdAt: number;
+    ttlRemainingMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ports/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;CAoB5B,CAAA;AAEV;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,YAAY,CAAC,EAAE,OAAO,eAAe,EAAE,WAAW,CAAA;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IACzC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,WAAW,EAAE,IAAI,CAAA;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,QAAQ,GAAG,kBAAkB,GAAG,gBAAgB,CAAA;IACxF,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,cAAc,CAAA;IAC3F,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,wBAAwB,CAAC,EAAE,OAAO,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3D,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,SAAS,GAAG,UAAU,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB"}

package/dist/ports/types.js

@@ -0,0 +1,26 @@
+// Shared types used across port interfaces
+/**
+ * Well-known registration keys for resolving ports.
+ */
+export const ContainerRegistrationKeys = {
+    CACHE: 'ICachePort',
+    EVENT_BUS: 'IEventBusPort',
+    LOCKING: 'ILockingPort',
+    LOGGER: 'ILoggerPort',
+    AUTH: 'IAuthPort',
+    AUTH_MODULE: 'IAuthModuleService',
+    AUTH_GATEWAY: 'IAuthGateway',
+    MESSAGE_AGGREGATOR: 'IMessageAggregator',
+    FILE: 'IFilePort',
+    DATABASE: 'IDatabasePort',
+    JOB_SCHEDULER: 'IJobSchedulerPort',
+    NOTIFICATION: 'INotificationPort',
+    HTTP: 'IHttpPort',
+    SCHEMA_GENERATOR: 'ISchemaGenerator',
+    REPOSITORY_FACTORY: 'IRepositoryFactory',
+    QUERY: 'query',
+    REMOTE_QUERY: 'remoteQuery',
+    LINK: 'link',
+    REMOTE_LINK: 'remoteLink',
+};
+//# sourceMappingURL=types.js.map

package/dist/ports/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ports/types.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAI3C;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,KAAK,EAAE,YAAY;IACnB,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,aAAa;IACrB,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,cAAc;IAC5B,kBAAkB,EAAE,oBAAoB;IACxC,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,eAAe;IACzB,aAAa,EAAE,mBAAmB;IAClC,YAAY,EAAE,mBAAmB;IACjC,IAAI,EAAE,WAAW;IACjB,gBAAgB,EAAE,kBAAkB;IACpC,kBAAkB,EAAE,oBAAoB;IACxC,KAAK,EAAE,OAAO;IACd,YAAY,EAAE,aAAa;IAC3B,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,YAAY;CACjB,CAAA"}