@mantajs/core 0.1.7 → 0.2.0-beta.1

package/dist/service/index.d.ts

@@ -0,0 +1,52 @@
+import type { IRepository } from '../ports/repository.js';
+/**
+ * Options for configuring service queries.
+ */
+export interface ServiceConfig {
+    select?: string[];
+    relations?: string[];
+    withDeleted?: boolean;
+    order?: Record<string, 'ASC' | 'DESC'>;
+    skip?: number;
+    take?: number;
+}
+export declare function buildEventNamesFromModelName(modelName: string): {
+    created: string;
+    updated: string;
+    deleted: string;
+};
+/**
+ * createService() — generates a base service class with CRUD methods for DML entities.
+ *
+ * Signatures match Medusa V2 (context last, optional):
+ *   retrieve{Entity}(id, config?, sharedContext?)
+ *   list{Entities}(filters?, config?, sharedContext?)
+ *   listAndCount{Entities}(filters?, config?, sharedContext?)
+ *   create{Entities}(data | data[], sharedContext?)
+ *   update{Entities}(data | data[], sharedContext?)
+ *   delete{Entities}(ids, sharedContext?)
+ *   softDelete{Entities}(ids, sharedContext?)
+ *   restore{Entities}(ids, sharedContext?)
+ */
+/**
+ * Model input — accepts DmlEntity objects (like Medusa) or plain { name } objects.
+ * Usage:
+ *   createService({ Product, Variant })           // DmlEntity objects (ISO Medusa)
+ *   createService({ Product: { name: 'Product' }}) // Plain objects (legacy)
+ */
+/**
+ * Base interface exposed by createService() return type.
+ * Subclasses can access these protected members with proper typing.
+ */
+export interface GeneratedServiceBase {
+    baseRepository_: IRepository;
+    __container__: Record<string, unknown>;
+    container_: Record<string, unknown>;
+}
+export declare function createService(models: Record<string, any>): new (deps: Record<string, unknown>) => GeneratedServiceBase & Record<string, unknown>;
+export type { ServiceDescriptor, ServiceFactoryContext, TypedRepository } from './define.js';
+export { defineService, isServiceDescriptor } from './define.js';
+export { instantiateServiceDescriptor } from './instantiate.js';
+export { SnapshotRepository } from './snapshot-repository.js';
+export type { GeneratedServicePrototype, IntrospectableServiceConstructor, OrmEventArgs } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAIzD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,CAAA;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG;IAC/D,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB,CAOA;AAYD;;;;;;;;;;;;GAYG;AACH;;;;;GAKG;AACH;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,WAAW,CAAA;IAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAGD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,KACD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyTlD;AAGD,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC5F,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC7D,YAAY,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/service/index.js

@@ -0,0 +1,281 @@
+// SPEC-058 — createService() base class with CRUD methods
+// Signatures aligned with Medusa V2: context is LAST and OPTIONAL.
+//   retrieve{Entity}(id, config?, sharedContext?)
+//   list{Entities}(filters?, config?, sharedContext?)
+//   create{Entities}(data | data[], sharedContext?)
+//   update{Entities}(data | data[], sharedContext?)
+//   delete{Entities}(ids, sharedContext?)
+//   softDelete{Entities}(ids, sharedContext?)
+//   restore{Entities}(ids, sharedContext?)
+import { MantaError } from '../errors/manta-error.js';
+export function buildEventNamesFromModelName(modelName) {
+    const name = modelName.toLowerCase();
+    return {
+        created: `${name}.created`,
+        updated: `${name}.updated`,
+        deleted: `${name}.deleted`,
+    };
+}
+function pluralize(name) {
+    if (name.endsWith('s') || name.endsWith('x') || name.endsWith('ch') || name.endsWith('sh')) {
+        return `${name}es`;
+    }
+    if (name.endsWith('y') && !/[aeiou]y$/i.test(name)) {
+        return `${name.slice(0, -1)}ies`;
+    }
+    return `${name}s`;
+}
+// biome-ignore lint/suspicious/noExplicitAny: accepts DmlEntity or plain object
+export function createService(models) {
+    class GeneratedService {
+        baseRepository_;
+        __messageAggregator;
+        // biome-ignore lint/suspicious/noExplicitAny: Medusa compat — stores the Awilix cradle
+        __container__;
+        // biome-ignore lint/suspicious/noExplicitAny: Medusa compat alias
+        container_;
+        /** Event bus service (resolved from deps if available) */
+        eventBusModuleService_;
+        // biome-ignore lint/suspicious/noExplicitAny: accepts Awilix cradle or explicit deps
+        constructor(deps = {}) {
+            this.baseRepository_ = (deps.baseRepository ?? deps.repository);
+            this.__messageAggregator = deps.messageAggregator ?? null;
+            this.__container__ = deps;
+            this.container_ = deps;
+            // Try to resolve event bus from deps (Medusa pattern)
+            try {
+                this.eventBusModuleService_ = deps.eventBusModuleService ?? deps.IEventBusPort ?? undefined;
+            }
+            catch {
+                this.eventBusModuleService_ = undefined;
+            }
+        }
+    }
+    // Store models on the class for introspection (Medusa pattern)
+    ;
+    GeneratedService.$modelObjects = models;
+    for (const [key, modelDef] of Object.entries(models)) {
+        const entityName = modelDef.name ?? key;
+        const plural = pluralize(entityName);
+        const events = buildEventNamesFromModelName(entityName);
+        // retrieve{Entity}(id, config?, sharedContext?)
+        Object.defineProperty(GeneratedService.prototype, `retrieve${entityName}`, {
+            value: async function (id, config, _sharedContext) {
+                const results = await this.baseRepository_.find({
+                    where: { id },
+                    withDeleted: config?.withDeleted,
+                });
+                if (results.length === 0) {
+                    throw new MantaError('NOT_FOUND', `${entityName} with id "${id}" not found`);
+                }
+                return results[0];
+            },
+            writable: true,
+            configurable: true,
+        });
+        // list{Entities}(filters?, config?, sharedContext?)
+        Object.defineProperty(GeneratedService.prototype, `list${plural}`, {
+            value: async function (filters, config, _sharedContext) {
+                return this.baseRepository_.find({
+                    where: filters,
+                    order: config?.order,
+                    offset: config?.skip,
+                    limit: config?.take,
+                    withDeleted: config?.withDeleted,
+                });
+            },
+            writable: true,
+            configurable: true,
+        });
+        // listAndCount{Entities}(filters?, config?, sharedContext?)
+        Object.defineProperty(GeneratedService.prototype, `listAndCount${plural}`, {
+            value: async function (filters, config, _sharedContext) {
+                return this.baseRepository_.findAndCount({
+                    where: filters,
+                    order: config?.order,
+                    offset: config?.skip,
+                    limit: config?.take,
+                    withDeleted: config?.withDeleted,
+                });
+            },
+            writable: true,
+            configurable: true,
+        });
+        // create{Entities}(data | data[], sharedContext?)
+        Object.defineProperty(GeneratedService.prototype, `create${plural}`, {
+            value: async function (data, sharedContext) {
+                const items = Array.isArray(data) ? data : [data];
+                const created = (await this.baseRepository_.create(items));
+                if (this.__messageAggregator) {
+                    const messages = created.map((entity) => ({
+                        eventName: events.created,
+                        data: { id: entity.id },
+                        metadata: {
+                            timestamp: Date.now(),
+                            auth_context: sharedContext?.auth_context,
+                        },
+                    }));
+                    this.__messageAggregator.save(messages);
+                }
+                return Array.isArray(data) ? created : created[0];
+            },
+            writable: true,
+            configurable: true,
+        });
+        // update{Entities}(data | data[], sharedContext?)
+        Object.defineProperty(GeneratedService.prototype, `update${plural}`, {
+            value: async function (data, sharedContext) {
+                const items = Array.isArray(data) ? data : [data];
+                const updated = [];
+                for (const item of items) {
+                    const result = (await this.baseRepository_.update(item));
+                    updated.push(result);
+                }
+                if (this.__messageAggregator) {
+                    const messages = updated.map((entity) => ({
+                        eventName: events.updated,
+                        data: { id: entity.id },
+                        metadata: {
+                            timestamp: Date.now(),
+                            auth_context: sharedContext?.auth_context,
+                        },
+                    }));
+                    this.__messageAggregator.save(messages);
+                }
+                return Array.isArray(data) ? updated : updated[0];
+            },
+            writable: true,
+            configurable: true,
+        });
+        // delete{Entities}(ids, sharedContext?)
+        Object.defineProperty(GeneratedService.prototype, `delete${plural}`, {
+            value: async function (ids, sharedContext) {
+                const idArray = Array.isArray(ids) ? ids : [ids];
+                await this.baseRepository_.delete(idArray);
+                if (this.__messageAggregator) {
+                    const messages = idArray.map((id) => ({
+                        eventName: events.deleted,
+                        data: { id },
+                        metadata: {
+                            timestamp: Date.now(),
+                            auth_context: sharedContext?.auth_context,
+                        },
+                    }));
+                    this.__messageAggregator.save(messages);
+                }
+            },
+            writable: true,
+            configurable: true,
+        });
+        // softDelete{Entities}(ids, sharedContext?)
+        Object.defineProperty(GeneratedService.prototype, `softDelete${plural}`, {
+            value: async function (ids, _sharedContext) {
+                const idArray = Array.isArray(ids) ? ids : [ids];
+                return this.baseRepository_.softDelete(idArray);
+            },
+            writable: true,
+            configurable: true,
+        });
+        // restore{Entities}(ids, sharedContext?)
+        Object.defineProperty(GeneratedService.prototype, `restore${plural}`, {
+            value: async function (ids, _sharedContext) {
+                const idArray = Array.isArray(ids) ? ids : [ids];
+                return this.baseRepository_.restore(idArray);
+            },
+            writable: true,
+            configurable: true,
+        });
+    }
+    // --- Medusa-compatible event methods ---
+    /**
+     * emitEvents_ — emit grouped events to the event bus.
+     * ISO Medusa: called after entity mutations to emit domain events.
+     */
+    ;
+    GeneratedService.prototype.emitEvents_ = async function (groupedEvents) {
+        if (!this.eventBusModuleService_ || !groupedEvents)
+            return;
+        const promises = [];
+        for (const group of Object.keys(groupedEvents)) {
+            promises.push(this.eventBusModuleService_.emit(groupedEvents[group], { internal: true }));
+        }
+        await Promise.all(promises);
+    };
+    GeneratedService.prototype.aggregatedEvents = function ({ action, object, eventName, source, data, context, }) {
+        if (!context?.messageAggregator)
+            return;
+        const messages = [
+            {
+                eventName: String(eventName ?? `${String(object)}.${String(action)}`),
+                data: (data ?? {}),
+                metadata: {
+                    timestamp: Date.now(),
+                    source: String(source ?? ''),
+                    action: String(action),
+                    object: String(object),
+                },
+            },
+        ];
+        context.messageAggregator.save(messages);
+    };
+    GeneratedService.prototype.interceptEntityMutationEvents = function (event, args, context) {
+        // Map ORM events to domain events
+        let action = '';
+        switch (event) {
+            case 'afterCreate':
+                action = 'created';
+                break;
+            case 'afterUpdate': {
+                const isSoftDeleted = !!args?.changeSet?.entity?.deleted_at && !args?.changeSet?.originalEntity?.deleted_at;
+                const isRestored = !!args?.changeSet?.originalEntity?.deleted_at && !args?.changeSet?.entity?.deleted_at;
+                action = isRestored ? 'restored' : isSoftDeleted ? 'deleted' : 'updated';
+                break;
+            }
+            case 'afterDelete':
+                action = 'deleted';
+                break;
+            default:
+                return;
+        }
+        const entity = args?.entity ?? args?.changeSet?.entity;
+        if (!entity)
+            return;
+        const entityName = args?.changeSet?.name ?? entity.constructor?.name ?? 'unknown';
+        this.aggregatedEvents?.({
+            action,
+            object: entityName,
+            eventName: `${String(entityName).toLowerCase()}.${action}`,
+            data: { id: entity.id },
+            context: context,
+        });
+    };
+    /**
+     * MedusaContextIndex_ — maps method names to the parameter index of sharedContext.
+     * ISO Medusa: used for context auto-injection.
+     */
+    const contextIndex = {};
+    for (const [key, modelDef] of Object.entries(models)) {
+        const entityName = modelDef.name ?? key;
+        const plural = pluralize(entityName);
+        // retrieve(id, config?, context?) → index 2
+        contextIndex[`retrieve${entityName}`] = 2;
+        // list(filters?, config?, context?) → index 2
+        contextIndex[`list${plural}`] = 2;
+        contextIndex[`listAndCount${plural}`] = 2;
+        // create/update(data, context?) → index 1
+        contextIndex[`create${plural}`] = 1;
+        contextIndex[`update${plural}`] = 1;
+        // delete(ids, context?) → index 1
+        contextIndex[`delete${plural}`] = 1;
+        // softDelete/restore(ids, config?, context?) → index 2
+        contextIndex[`softDelete${plural}`] = 2;
+        contextIndex[`restore${plural}`] = 2;
+    }
+    ;
+    GeneratedService.prototype.MedusaContextIndex_ = contextIndex;
+    return GeneratedService;
+}
+export { defineService, isServiceDescriptor } from './define.js';
+export { instantiateServiceDescriptor } from './instantiate.js';
+export { SnapshotRepository } from './snapshot-repository.js';
+//# sourceMappingURL=index.js.map

package/dist/service/index.js.map

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

package/dist/service/instantiate.d.ts

@@ -0,0 +1,15 @@
+import type { IMessageAggregator } from '../events/types.js';
+import type { ILoggerPort } from '../ports/logger.js';
+import type { IRepository } from '../ports/repository.js';
+import type { ServiceDescriptor } from './define.js';
+/**
+ * Instantiate a ServiceDescriptor into a live service object.
+ *
+ * @param descriptor - The ServiceDescriptor from service.define()
+ * @param repo - A real IRepository instance (injected by bootstrap)
+ * @param messageAggregator - Optional message aggregator for domain events
+ * @param logger - Optional logger instance for the service factory context
+ * @returns The fully-wired service object with CRUD + query helpers + custom methods
+ */
+export declare function instantiateServiceDescriptor(descriptor: ServiceDescriptor<any, any>, repo: IRepository, messageAggregator?: IMessageAggregator, logger?: ILoggerPort): Record<string, unknown>;
+//# sourceMappingURL=instantiate.d.ts.map

package/dist/service/instantiate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instantiate.d.ts","sourceRoot":"","sources":["../../src/service/instantiate.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAepD;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAE1C,UAAU,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,EACvC,IAAI,EAAE,WAAW,EACjB,iBAAiB,CAAC,EAAE,kBAAkB,EACtC,MAAM,CAAC,EAAE,WAAW,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiJzB"}

package/dist/service/instantiate.js

@@ -0,0 +1,143 @@
+// instantiateServiceDescriptor() — Runtime wiring for service.define() descriptors.
+//
+// Generates:
+// 1. CRUD methods (retrieve, list, create, update, delete, softDelete, restore)
+// 2. Query helpers (list, findById) — for the Query Graph endpoint
+// 3. Custom methods from the factory (plain async functions, no compensation wrapper)
+//
+// The repo injected into the factory is a SnapshotRepository that auto-captures
+// state before mutations. The service's __snapshotRepo is used by the workflow
+// engine for automatic compensation.
+import { MantaError } from '../errors/manta-error.js';
+import { SnapshotRepository } from './snapshot-repository.js';
+function pluralize(name) {
+    if (name.endsWith('s') || name.endsWith('x') || name.endsWith('ch') || name.endsWith('sh'))
+        return `${name}es`;
+    if (name.endsWith('y') && !/[aeiou]y$/i.test(name))
+        return `${name.slice(0, -1)}ies`;
+    return `${name}s`;
+}
+function buildEventNames(modelName) {
+    const name = modelName.toLowerCase();
+    return { created: `${name}.created`, updated: `${name}.updated`, deleted: `${name}.deleted` };
+}
+/**
+ * Instantiate a ServiceDescriptor into a live service object.
+ *
+ * @param descriptor - The ServiceDescriptor from service.define()
+ * @param repo - A real IRepository instance (injected by bootstrap)
+ * @param messageAggregator - Optional message aggregator for domain events
+ * @param logger - Optional logger instance for the service factory context
+ * @returns The fully-wired service object with CRUD + query helpers + custom methods
+ */
+export function instantiateServiceDescriptor(
+// biome-ignore lint/suspicious/noExplicitAny: generic descriptor
+descriptor, repo, messageAggregator, logger) {
+    const entityName = descriptor.entity.name;
+    const plural = pluralize(entityName);
+    const events = buildEventNames(entityName);
+    // Wrap the repo in a SnapshotRepository for auto-compensation
+    const snapshotRepo = new SnapshotRepository(repo);
+    // biome-ignore lint/suspicious/noExplicitAny: dynamic service object
+    const svc = {};
+    // ===== Query helpers (framework-generated for the Query Graph endpoint) =====
+    svc.list = async (filters) => {
+        return repo.find({ where: filters, order: { created_at: 'DESC' } });
+    };
+    svc.findById = async (id) => {
+        const results = await repo.find({ where: { id } });
+        return results[0] ?? null;
+    };
+    // ===== CRUD methods (same semantics as createService) =====
+    svc[`retrieve${entityName}`] = async (id, config, _sharedContext) => {
+        const results = await repo.find({ where: { id }, withDeleted: config?.withDeleted });
+        if (results.length === 0)
+            throw new MantaError('NOT_FOUND', `${entityName} with id "${id}" not found`);
+        return results[0];
+    };
+    svc[`list${plural}`] = async (filters, config, _sharedContext) => {
+        return repo.find({
+            where: filters,
+            order: config?.order,
+            offset: config?.skip,
+            limit: config?.take,
+            withDeleted: config?.withDeleted,
+        });
+    };
+    svc[`listAndCount${plural}`] = async (filters, config, _sharedContext) => {
+        return repo.findAndCount({
+            where: filters,
+            order: config?.order,
+            offset: config?.skip,
+            limit: config?.take,
+            withDeleted: config?.withDeleted,
+        });
+    };
+    svc[`create${plural}`] = async (data, sharedContext) => {
+        const items = Array.isArray(data) ? data : [data];
+        const created = (await repo.create(items));
+        if (messageAggregator) {
+            messageAggregator.save(created.map((entity) => ({
+                eventName: events.created,
+                data: { id: entity.id },
+                metadata: { timestamp: Date.now(), auth_context: sharedContext?.auth_context },
+            })));
+        }
+        return Array.isArray(data) ? created : created[0];
+    };
+    svc[`update${plural}`] = async (data, sharedContext) => {
+        const items = Array.isArray(data) ? data : [data];
+        const updated = [];
+        for (const item of items) {
+            const result = (await repo.update(item));
+            updated.push(result);
+        }
+        if (messageAggregator) {
+            messageAggregator.save(updated.map((entity) => ({
+                eventName: events.updated,
+                data: { id: entity.id },
+                metadata: { timestamp: Date.now(), auth_context: sharedContext?.auth_context },
+            })));
+        }
+        return Array.isArray(data) ? updated : updated[0];
+    };
+    svc[`delete${plural}`] = async (ids, sharedContext) => {
+        const idArray = Array.isArray(ids) ? ids : [ids];
+        await repo.delete(idArray);
+        if (messageAggregator) {
+            messageAggregator.save(idArray.map((id) => ({
+                eventName: events.deleted,
+                data: { id },
+                metadata: { timestamp: Date.now(), auth_context: sharedContext?.auth_context },
+            })));
+        }
+    };
+    svc[`softDelete${plural}`] = async (ids, _sharedContext) => {
+        const idArray = Array.isArray(ids) ? ids : [ids];
+        return repo.softDelete(idArray);
+    };
+    svc[`restore${plural}`] = async (ids, _sharedContext) => {
+        const idArray = Array.isArray(ids) ? ids : [ids];
+        return repo.restore(idArray);
+    };
+    // ===== Custom methods from factory (plain async functions) =====
+    // The factory receives { db, log } so mutations are auto-tracked.
+    const noopLogger = {
+        info() { },
+        warn() { },
+        error() { },
+        debug() { },
+        child() {
+            return noopLogger;
+        },
+    };
+    const customMethods = descriptor.factory({ db: snapshotRepo, log: logger ?? noopLogger });
+    Object.assign(svc, customMethods);
+    // ===== Metadata for introspection (AI, query endpoint, etc.) =====
+    svc.__entity = descriptor.entity;
+    svc.__snapshotRepo = snapshotRepo;
+    svc.__customMethods = Object.keys(customMethods);
+    svc.__publicMethods = descriptor.publicMethods ?? null;
+    return svc;
+}
+//# sourceMappingURL=instantiate.js.map

package/dist/service/instantiate.js.map

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

package/dist/service/snapshot-repository.d.ts

@@ -0,0 +1,31 @@
+import type { TypedRepository } from './define.js';
+/**
+ * Wraps a TypedRepository with automatic snapshotting of mutations.
+ * Every update/delete/softDelete captures the entity state before mutation.
+ * Every create captures the created ID for deletion on rollback.
+ *
+ * Call `rollback()` to undo all mutations in reverse order.
+ * Call `clearSnapshots()` after a successful operation.
+ */
+export declare class SnapshotRepository<T extends Record<string, unknown>> implements TypedRepository<T> {
+    private _inner;
+    private _snapshots;
+    constructor(_inner: TypedRepository<T>);
+    find(options?: Parameters<TypedRepository<T>['find']>[0]): Promise<T[]>;
+    findAndCount(options?: Parameters<TypedRepository<T>['findAndCount']>[0]): Promise<[T[], number]>;
+    create(data: Partial<T> | Partial<T>[]): Promise<T | T[]>;
+    update(data: Partial<T> & {
+        id: string;
+    }): Promise<T>;
+    delete(ids: string | string[]): Promise<void>;
+    softDelete(ids: string | string[]): Promise<Record<string, string[]>>;
+    restore(ids: string | string[]): Promise<void>;
+    upsertWithReplace(data: Partial<T>[], replaceFields?: string[], conflictTarget?: string[]): Promise<T[]>;
+    /** Undo all mutations in reverse order. */
+    rollback(): Promise<void>;
+    /** Clear snapshots after successful completion (no rollback needed). */
+    clearSnapshots(): void;
+    /** Check if there are pending snapshots. */
+    get hasSnapshots(): boolean;
+}
+//# sourceMappingURL=snapshot-repository.d.ts.map

package/dist/service/snapshot-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-repository.d.ts","sourceRoot":"","sources":["../../src/service/snapshot-repository.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AASlD;;;;;;;GAOG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IAGlF,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,UAAU,CAAiB;gBAEf,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAI9C,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAIvE,YAAY,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAM3F,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAUzD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IASrD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAYrE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAM9G,2CAA2C;IACrC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B/B,wEAAwE;IACxE,cAAc,IAAI,IAAI;IAItB,4CAA4C;IAC5C,IAAI,YAAY,IAAI,OAAO,CAE1B;CACF"}