@mantajs/core 0.1.7 → 0.2.0-beta.1

package/dist/adapters/relational-query-memory.js

@@ -0,0 +1,263 @@
+// In-memory IRelationalQueryPort — for dev/test
+// Simulates relational queries using in-memory data stores.
+/**
+ * In-memory relational query adapter.
+ *
+ * Stores data per entity and uses relation metadata to resolve JOINs in memory.
+ * Suitable for unit/conformance tests — not for production.
+ */
+export class InMemoryRelationalQuery {
+    _data = new Map();
+    _relations = new Map();
+    /**
+     * Seed entity data for testing.
+     */
+    setData(entityName, records) {
+        this._data.set(entityName.toLowerCase(), records);
+    }
+    /**
+     * Register relation metadata for an entity.
+     */
+    setRelations(entityName, relations) {
+        this._relations.set(entityName.toLowerCase(), relations);
+    }
+    async findWithRelations(config) {
+        const entityKey = config.entity.toLowerCase();
+        let records = [...(this._data.get(entityKey) ?? [])];
+        // Apply soft-delete filter
+        if (!config.withDeleted) {
+            records = records.filter((r) => r.deleted_at == null);
+        }
+        // Apply root-level filters
+        if (config.filters) {
+            records = this._applyFilters(records, config.filters, entityKey);
+        }
+        // Apply sorting
+        if (config.sort) {
+            records = this._applySort(records, config.sort);
+        }
+        // Apply pagination
+        const offset = config.pagination?.offset ?? 0;
+        const limit = config.pagination?.limit ?? 100;
+        records = records.slice(offset, offset + limit);
+        // Resolve relations based on requested fields
+        const relationFields = this._extractRelationFields(config.fields ?? ['*']);
+        if (relationFields.length > 0) {
+            records = records.map((record) => this._resolveRelations(record, entityKey, relationFields, config.withDeleted ?? false, config.relPagination));
+        }
+        return records;
+    }
+    async findAndCountWithRelations(config) {
+        const entityKey = config.entity.toLowerCase();
+        let allRecords = [...(this._data.get(entityKey) ?? [])];
+        if (!config.withDeleted) {
+            allRecords = allRecords.filter((r) => r.deleted_at == null);
+        }
+        if (config.filters) {
+            allRecords = this._applyFilters(allRecords, config.filters, entityKey);
+        }
+        const total = allRecords.length;
+        const results = await this.findWithRelations(config);
+        return [results, total];
+    }
+    _applyFilters(records, filters, entityKey) {
+        return records.filter((record) => {
+            for (const [key, value] of Object.entries(filters)) {
+                if (key.includes('.')) {
+                    // Dotted path — filter on relation
+                    const parts = key.split('.');
+                    const relName = parts[0];
+                    const relField = parts.slice(1).join('.');
+                    const relMeta = this._relations.get(entityKey)?.[relName];
+                    if (!relMeta)
+                        return false;
+                    const relRecords = this._getRelatedRecords(record, entityKey, relName, relMeta, false);
+                    const matches = relRecords.some((r) => InMemoryRelationalQuery._matchValue(r[relField], value));
+                    if (!matches)
+                        return false;
+                }
+                else {
+                    if (!InMemoryRelationalQuery._matchValue(record[key], value))
+                        return false;
+                }
+            }
+            return true;
+        });
+    }
+    /**
+     * Evaluate whether a concrete record field `actual` matches the user's
+     * `filter` spec. Supports:
+     *  - scalar equality (`filter: 'x'`)
+     *  - `null` → exact null
+     *  - operator bags: `{ $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin }`
+     *
+     * Mirrors the operators honored by the Drizzle adapter's buildFieldPredicates,
+     * so that conformance tests exercise the same semantics across adapters.
+     */
+    static _matchValue(actual, filter) {
+        if (filter === null)
+            return actual == null;
+        // Plain array value → `actual IN (filter)`. Mirrors the pg adapter's
+        // inArray shortcut for multi-select UI filters serialized as arrays.
+        if (Array.isArray(filter))
+            return filter.includes(actual);
+        if (typeof filter === 'object' && !Array.isArray(filter)) {
+            const ops = filter;
+            for (const [op, val] of Object.entries(ops)) {
+                switch (op) {
+                    case '$eq':
+                        if (actual !== val)
+                            return false;
+                        break;
+                    case '$ne':
+                        if (actual === val)
+                            return false;
+                        break;
+                    case '$gt':
+                        if (!(InMemoryRelationalQuery._compare(actual, val) > 0))
+                            return false;
+                        break;
+                    case '$gte':
+                        if (!(InMemoryRelationalQuery._compare(actual, val) >= 0))
+                            return false;
+                        break;
+                    case '$lt':
+                        if (!(InMemoryRelationalQuery._compare(actual, val) < 0))
+                            return false;
+                        break;
+                    case '$lte':
+                        if (!(InMemoryRelationalQuery._compare(actual, val) <= 0))
+                            return false;
+                        break;
+                    case '$in':
+                        if (!Array.isArray(val) || !val.includes(actual))
+                            return false;
+                        break;
+                    case '$nin':
+                        if (!Array.isArray(val) || val.includes(actual))
+                            return false;
+                        break;
+                    default:
+                        // Unknown operator keys are ignored (matches Drizzle adapter behaviour).
+                        break;
+                }
+            }
+            return true;
+        }
+        return actual === filter;
+    }
+    static _compare(a, b) {
+        if (a == null && b == null)
+            return 0;
+        if (a == null)
+            return -1;
+        if (b == null)
+            return 1;
+        if (typeof a === 'number' && typeof b === 'number')
+            return a - b;
+        const as = String(a);
+        const bs = String(b);
+        return as < bs ? -1 : as > bs ? 1 : 0;
+    }
+    _applySort(records, sort) {
+        return [...records].sort((a, b) => {
+            for (const [field, direction] of Object.entries(sort)) {
+                const aVal = a[field];
+                const bVal = b[field];
+                if (aVal === bVal)
+                    continue;
+                const cmp = (() => {
+                    if (aVal == null && bVal == null)
+                        return 0;
+                    if (aVal == null)
+                        return 1; // nulls last
+                    if (bVal == null)
+                        return -1;
+                    return aVal < bVal ? -1 : aVal > bVal ? 1 : 0;
+                })();
+                if (cmp === 0)
+                    continue;
+                return direction === 'desc' ? -cmp : cmp;
+            }
+            return 0;
+        });
+    }
+    _extractRelationFields(fields) {
+        const relations = [];
+        for (const field of fields) {
+            if (field.includes('.')) {
+                const relName = field.split('.')[0];
+                if (!relations.includes(relName)) {
+                    relations.push(relName);
+                }
+            }
+        }
+        return relations;
+    }
+    _resolveRelations(record, entityKey, relationFields, withDeleted, relPagination) {
+        const result = { ...record };
+        const entityRelations = this._relations.get(entityKey);
+        if (!entityRelations)
+            return result;
+        for (const relName of relationFields) {
+            const relMeta = entityRelations[relName];
+            if (!relMeta)
+                continue;
+            let related = this._getRelatedRecords(record, entityKey, relName, relMeta, withDeleted);
+            // Apply relation pagination
+            const relPag = relPagination?.[relName];
+            if (relPag) {
+                const relOffset = relPag.offset ?? 0;
+                const relLimit = relPag.limit ?? related.length;
+                related = related.slice(relOffset, relOffset + relLimit);
+            }
+            if (relMeta.type === 'hasOne' || relMeta.type === 'hasOneWithFK' || relMeta.type === 'belongsTo') {
+                result[relName] = related[0] ?? null;
+            }
+            else {
+                result[relName] = related;
+            }
+        }
+        return result;
+    }
+    _getRelatedRecords(record, entityKey, _relName, relMeta, withDeleted) {
+        const targetKey = relMeta.target.toLowerCase();
+        let targetRecords = [...(this._data.get(targetKey) ?? [])];
+        if (!withDeleted) {
+            targetRecords = targetRecords.filter((r) => r.deleted_at == null);
+        }
+        switch (relMeta.type) {
+            case 'hasMany': {
+                const fk = relMeta.foreignKey ?? `${entityKey}_id`;
+                return targetRecords.filter((r) => r[fk] === record.id);
+            }
+            case 'hasOne':
+            case 'hasOneWithFK': {
+                const fk = relMeta.foreignKey ?? `${entityKey}_id`;
+                return targetRecords.filter((r) => r[fk] === record.id);
+            }
+            case 'belongsTo': {
+                const fk = relMeta.foreignKey ?? `${targetKey}_id`;
+                return targetRecords.filter((r) => r.id === record[fk]);
+            }
+            case 'manyToMany': {
+                if (!relMeta.pivotEntity)
+                    return [];
+                const pivotKey = relMeta.pivotEntity.toLowerCase();
+                const pivotRecords = this._data.get(pivotKey) ?? [];
+                const leftFk = `${entityKey}_id`;
+                const rightFk = `${targetKey}_id`;
+                const matchingPivots = pivotRecords.filter((p) => p[leftFk] === record.id);
+                const targetIds = new Set(matchingPivots.map((p) => p[rightFk]));
+                return targetRecords.filter((r) => targetIds.has(r.id));
+            }
+            default:
+                return [];
+        }
+    }
+    _reset() {
+        this._data.clear();
+        this._relations.clear();
+    }
+}
+//# sourceMappingURL=relational-query-memory.js.map

package/dist/adapters/relational-query-memory.js.map

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

package/dist/adapters/repository-factory-memory.d.ts

@@ -0,0 +1,17 @@
+import type { IRepository } from '../ports/repository.js';
+import type { IRepositoryFactory } from '../ports/repository-factory.js';
+import { InMemoryRepository } from './repository-memory.js';
+/**
+ * In-memory repository factory for dev/test.
+ * Creates and caches InMemoryRepository instances per entity name.
+ */
+export declare class InMemoryRepositoryFactory implements IRepositoryFactory {
+    private _cache;
+    registerTable(_entityName: string, _table: unknown): void;
+    createRepository<T = unknown>(entityName: string, _options?: Record<string, unknown>): IRepository<T>;
+    /** Get a previously created repository (for testing) */
+    getRepository(entityName: string): InMemoryRepository | undefined;
+    /** Reset all cached repositories */
+    _reset(): void;
+}
+//# sourceMappingURL=repository-factory-memory.d.ts.map

package/dist/adapters/repository-factory-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-factory-memory.d.ts","sourceRoot":"","sources":["../../src/adapters/repository-factory-memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,OAAO,CAAC,MAAM,CAAwC;IAEtD,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIzD,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IASrG,wDAAwD;IACxD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjE,oCAAoC;IACpC,MAAM,IAAI,IAAI;CAMf"}

package/dist/adapters/repository-factory-memory.js

@@ -0,0 +1,32 @@
+// SPEC-126 — InMemoryRepositoryFactory implements IRepositoryFactory
+import { InMemoryRepository } from './repository-memory.js';
+/**
+ * In-memory repository factory for dev/test.
+ * Creates and caches InMemoryRepository instances per entity name.
+ */
+export class InMemoryRepositoryFactory {
+    _cache = new Map();
+    registerTable(_entityName, _table) {
+        // No-op — InMemory repos don't need table definitions
+    }
+    createRepository(entityName, _options) {
+        const cached = this._cache.get(entityName);
+        if (cached)
+            return cached;
+        const repo = new InMemoryRepository(entityName);
+        this._cache.set(entityName, repo);
+        return repo;
+    }
+    /** Get a previously created repository (for testing) */
+    getRepository(entityName) {
+        return this._cache.get(entityName);
+    }
+    /** Reset all cached repositories */
+    _reset() {
+        for (const repo of this._cache.values()) {
+            repo._reset();
+        }
+        this._cache.clear();
+    }
+}
+//# sourceMappingURL=repository-factory-memory.js.map

package/dist/adapters/repository-factory-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-factory-memory.js","sourceRoot":"","sources":["../../src/adapters/repository-factory-memory.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAIrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D;;;GAGG;AACH,MAAM,OAAO,yBAAyB;IAC5B,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAA;IAEtD,aAAa,CAAC,WAAmB,EAAE,MAAe;QAChD,sDAAsD;IACxD,CAAC;IAED,gBAAgB,CAAc,UAAkB,EAAE,QAAkC;QAClF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAC1C,IAAI,MAAM;YAAE,OAAO,MAAwB,CAAA;QAE3C,MAAM,IAAI,GAAG,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAAA;QAC/C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QACjC,OAAO,IAAsB,CAAA;IAC/B,CAAC;IAED,wDAAwD;IACxD,aAAa,CAAC,UAAkB;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACpC,CAAC;IAED,oCAAoC;IACpC,MAAM;QACJ,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,MAAM,EAAE,CAAA;QACf,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;CACF"}

package/dist/adapters/repository-memory.d.ts

@@ -0,0 +1,30 @@
+import type { IRepository } from '../ports/index.js';
+export declare class InMemoryRepository implements IRepository<Record<string, unknown>> {
+    private _store;
+    private _entityName;
+    constructor(entityName?: string);
+    find(options?: {
+        where?: Record<string, unknown>;
+        withDeleted?: boolean;
+        limit?: number;
+        offset?: number;
+        order?: Record<string, 'ASC' | 'DESC'>;
+        cursor?: {
+            after?: string;
+            before?: string;
+            limit?: number;
+        };
+    }): Promise<Record<string, unknown>[]>;
+    findAndCount(options?: Record<string, unknown>): Promise<[Record<string, unknown>[], number]>;
+    create(data: Record<string, unknown> | Record<string, unknown>[]): Promise<Record<string, unknown> | Record<string, unknown>[]>;
+    private _createOne;
+    update(data: Record<string, unknown> | Record<string, unknown>[]): Promise<Record<string, unknown> | Record<string, unknown>[]>;
+    private _updateOne;
+    delete(ids: string | string[]): Promise<void>;
+    softDelete(ids: string | string[]): Promise<Record<string, string[]>>;
+    restore(ids: string | string[]): Promise<void>;
+    serialize(data: unknown, _options?: unknown): Promise<unknown>;
+    upsertWithReplace(data: Record<string, unknown>[], replaceFields?: string[], _conflictTarget?: string[]): Promise<Record<string, unknown>[]>;
+    _reset(): void;
+}
+//# sourceMappingURL=repository-memory.d.ts.map

package/dist/adapters/repository-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-memory.d.ts","sourceRoot":"","sources":["../../src/adapters/repository-memory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,qBAAa,kBAAmB,YAAW,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7E,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,WAAW,CAAQ;gBAEf,UAAU,SAAW;IAI3B,IAAI,CAAC,OAAO,CAAC,EAAE;QACnB,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;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAC7D,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAgEhC,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAgB7F,MAAM,CACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACxD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAO/D,OAAO,CAAC,UAAU;IAcZ,MAAM,CACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACxD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAO/D,OAAO,CAAC,UAAU;IAaZ,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAcrE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9C,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D,iBAAiB,CACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IA4BrC,MAAM;CAGP"}

package/dist/adapters/repository-memory.js

@@ -0,0 +1,183 @@
+// SPEC-126 — InMemoryRepository implements IRepository
+import { MantaError } from '../errors/manta-error.js';
+export class InMemoryRepository {
+    _store = new Map();
+    _entityName;
+    constructor(entityName = 'entity') {
+        this._entityName = entityName;
+    }
+    async find(options) {
+        let results = Array.from(this._store.values());
+        // Filter soft-deleted by default
+        if (!options?.withDeleted) {
+            results = results.filter((e) => e.deleted_at === null || e.deleted_at === undefined);
+        }
+        // Apply where filters
+        if (options?.where) {
+            for (const [key, value] of Object.entries(options.where)) {
+                results = results.filter((e) => e[key] === value);
+            }
+        }
+        // Apply ordering
+        if (options?.order) {
+            const orderEntries = Object.entries(options.order);
+            results.sort((a, b) => {
+                for (const [field, dir] of orderEntries) {
+                    const aVal = a[field];
+                    const bVal = b[field];
+                    if (aVal === bVal)
+                        continue;
+                    if (aVal === undefined || aVal === null)
+                        return dir === 'ASC' ? -1 : 1;
+                    if (bVal === undefined || bVal === null)
+                        return dir === 'ASC' ? 1 : -1;
+                    const cmp = String(aVal) < String(bVal) ? -1 : 1;
+                    return dir === 'ASC' ? cmp : -cmp;
+                }
+                return 0;
+            });
+        }
+        // Cursor pagination
+        if (options?.cursor) {
+            const afterId = options.cursor.after;
+            if (afterId) {
+                const idx = results.findIndex((e) => e.id === afterId);
+                if (idx >= 0) {
+                    results = results.slice(idx + 1);
+                }
+            }
+            const beforeId = options.cursor.before;
+            if (beforeId) {
+                const idx = results.findIndex((e) => e.id === beforeId);
+                if (idx >= 0) {
+                    results = results.slice(0, idx);
+                }
+            }
+        }
+        // Apply offset (mutually exclusive with cursor)
+        if (options?.offset && !options?.cursor) {
+            results = results.slice(options.offset);
+        }
+        // Apply limit
+        const limit = options?.limit ?? options?.cursor?.limit;
+        if (limit !== undefined) {
+            results = results.slice(0, limit);
+        }
+        return results;
+    }
+    async findAndCount(options) {
+        const results = await this.find(options);
+        let all = Array.from(this._store.values());
+        if (!options?.withDeleted) {
+            all = all.filter((e) => e.deleted_at === null || e.deleted_at === undefined);
+        }
+        if (options?.where) {
+            for (const [key, value] of Object.entries(options.where)) {
+                all = all.filter((e) => e[key] === value);
+            }
+        }
+        return [results, all.length];
+    }
+    async create(data) {
+        if (Array.isArray(data)) {
+            return data.map((d) => this._createOne(d));
+        }
+        return this._createOne(data);
+    }
+    _createOne(data) {
+        const id = data.id ?? crypto.randomUUID();
+        const now = new Date();
+        const entity = {
+            ...data,
+            id,
+            created_at: now,
+            updated_at: now,
+            deleted_at: null,
+        };
+        this._store.set(id, entity);
+        return entity;
+    }
+    async update(data) {
+        if (Array.isArray(data)) {
+            return data.map((d) => this._updateOne(d));
+        }
+        return this._updateOne(data);
+    }
+    _updateOne(data) {
+        const id = data.id;
+        const existing = this._store.get(id);
+        if (!existing)
+            throw new MantaError('NOT_FOUND', `Entity "${id}" not found`);
+        const updated = {
+            ...existing,
+            ...data,
+            updated_at: new Date(),
+        };
+        this._store.set(id, updated);
+        return updated;
+    }
+    async delete(ids) {
+        const idArray = Array.isArray(ids) ? ids : [ids];
+        for (const id of idArray) {
+            this._store.delete(id);
+        }
+    }
+    async softDelete(ids) {
+        const idArray = Array.isArray(ids) ? ids : [ids];
+        const deletedIds = [];
+        for (const id of idArray) {
+            const entity = this._store.get(id);
+            if (entity) {
+                entity.deleted_at = new Date();
+                entity.updated_at = new Date();
+                deletedIds.push(id);
+            }
+        }
+        return deletedIds.length > 0 ? { [this._entityName]: deletedIds } : {};
+    }
+    async restore(ids) {
+        const idArray = Array.isArray(ids) ? ids : [ids];
+        for (const id of idArray) {
+            const entity = this._store.get(id);
+            if (entity) {
+                entity.deleted_at = null;
+                entity.updated_at = new Date();
+            }
+        }
+    }
+    async serialize(data, _options) {
+        return JSON.parse(JSON.stringify(data));
+    }
+    async upsertWithReplace(data, replaceFields, _conflictTarget) {
+        const results = [];
+        for (const item of data) {
+            const id = item.id;
+            const existing = id ? this._store.get(id) : undefined;
+            if (existing) {
+                let updated;
+                if (replaceFields && replaceFields.length > 0) {
+                    updated = { ...existing, updated_at: new Date() };
+                    for (const field of replaceFields) {
+                        if (field in item) {
+                            updated[field] = item[field];
+                        }
+                    }
+                }
+                else {
+                    updated = { ...existing, ...item, updated_at: new Date() };
+                }
+                this._store.set(id, updated);
+                results.push(updated);
+            }
+            else {
+                const entity = this._createOne(item);
+                results.push(entity);
+            }
+        }
+        return results;
+    }
+    _reset() {
+        this._store.clear();
+    }
+}
+//# sourceMappingURL=repository-memory.js.map

package/dist/adapters/repository-memory.js.map

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

package/dist/ai/index.d.ts

@@ -0,0 +1,53 @@
+import type { z } from 'zod';
+/**
+ * Agent definition — a typed AI call with Zod input/output.
+ */
+export interface AgentDefinition<TInput = unknown, TOutput = unknown> {
+    __type: 'agent';
+    /** Unique agent name (kebab-case) */
+    name: string;
+    /** What this agent does (for docs and AI tool discovery) */
+    description: string;
+    /** Zod schema for the input — validated before the LLM call */
+    input: z.ZodType<TInput>;
+    /** Zod schema for the output — the LLM is forced to return this shape */
+    output: z.ZodType<TOutput>;
+    /** Prompt template — receives the validated input, returns the prompt string */
+    instructions: (input: TInput) => string;
+    /** System prompt (optional) */
+    system?: string;
+    /** Temperature (0 = deterministic, 1 = creative). Default: 0 */
+    temperature?: number;
+    /** Max tokens for the response */
+    maxTokens?: number;
+    /** Model override (e.g., 'gpt-4o', 'claude-sonnet-4-20250514'). Default: provider default */
+    model?: string;
+}
+/**
+ * Define an AI agent — a typed, checkpointable LLM call for workflows.
+ *
+ * The agent has a Zod contract: input is validated, output is forced via generateObject().
+ * In a workflow, the result is checkpointed — if the workflow crashes after the agent step,
+ * the result is recovered from checkpoint (no re-call to the LLM).
+ *
+ * @example
+ * export default defineAgent({
+ *   name: 'categorize-product',
+ *   description: 'Categorize a product into a department',
+ *   input: z.object({ title: z.string() }),
+ *   output: z.object({ category: z.enum(['electronics', 'clothing', 'food', 'other']) }),
+ *   instructions: (input) => `Categorize this product: "${input.title}"`,
+ * })
+ */
+export declare function defineAgent<TInputSchema extends z.ZodType, TOutputSchema extends z.ZodType>(config: {
+    name: string;
+    description: string;
+    input: TInputSchema;
+    output: TOutputSchema;
+    instructions: (input: NoInfer<z.infer<TInputSchema>>) => string;
+    system?: string;
+    temperature?: number;
+    maxTokens?: number;
+    model?: string;
+}): AgentDefinition<z.infer<TInputSchema>, z.infer<TOutputSchema>>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAG5B;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAClE,MAAM,EAAE,OAAO,CAAA;IACf,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,yEAAyE;IACzE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1B,gFAAgF;IAChF,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,YAAY,SAAS,CAAC,CAAC,OAAO,EAAE,aAAa,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE;IACnG,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,aAAa,CAAA;IACrB,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,KAAK,MAAM,CAAA;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAYjE"}