@mantajs/core 0.1.7 → 0.2.0-beta.0

package/dist/service/snapshot-repository.js

@@ -0,0 +1,114 @@
+// SnapshotRepository — auto-snapshot wrapper for TypedRepository.
+// Intercepts mutations (update, delete, softDelete, create) and captures
+// state before each operation. On rollback(), reverses all operations.
+//
+// This eliminates manual compensation in service methods — the framework
+// handles undo automatically.
+/**
+ * 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 class SnapshotRepository {
+    _inner;
+    _snapshots = [];
+    constructor(_inner) {
+        this._inner = _inner;
+    }
+    // ── Reads — passthrough ─────────────────────────────────────────────
+    find(options) {
+        return this._inner.find(options);
+    }
+    findAndCount(options) {
+        return this._inner.findAndCount(options);
+    }
+    // ── Mutations — auto-snapshot before execution ──────────────────────
+    async create(data) {
+        const result = await this._inner.create(data);
+        // Track created IDs for rollback (delete on compensation)
+        const items = Array.isArray(result) ? result : [result];
+        for (const item of items) {
+            this._snapshots.push({ type: 'create', id: item.id });
+        }
+        return result;
+    }
+    async update(data) {
+        // Snapshot: fetch entity before mutation
+        const [before] = await this._inner.find({ where: { id: data.id } });
+        if (before) {
+            this._snapshots.push({ type: 'update', before: before, id: data.id });
+        }
+        return this._inner.update(data);
+    }
+    async delete(ids) {
+        // Snapshot: fetch all entities before deletion
+        const idArray = Array.isArray(ids) ? ids : [ids];
+        for (const id of idArray) {
+            const [before] = await this._inner.find({ where: { id }, withDeleted: true });
+            if (before) {
+                this._snapshots.push({ type: 'delete', before: before, id });
+            }
+        }
+        return this._inner.delete(ids);
+    }
+    async softDelete(ids) {
+        // Snapshot: fetch all entities before soft-deletion
+        const idArray = Array.isArray(ids) ? ids : [ids];
+        for (const id of idArray) {
+            const [before] = await this._inner.find({ where: { id } });
+            if (before) {
+                this._snapshots.push({ type: 'softDelete', before: before, id });
+            }
+        }
+        return this._inner.softDelete(ids);
+    }
+    async restore(ids) {
+        return this._inner.restore(ids);
+    }
+    // Bulk upsert — bypasses compensation tracking (mixed create/update not compensable)
+    async upsertWithReplace(data, replaceFields, conflictTarget) {
+        return this._inner.upsertWithReplace(data, replaceFields, conflictTarget);
+    }
+    // ── Compensation ────────────────────────────────────────────────────
+    /** Undo all mutations in reverse order. */
+    async rollback() {
+        const reversed = [...this._snapshots].reverse();
+        for (const snap of reversed) {
+            switch (snap.type) {
+                case 'update':
+                    if (snap.before) {
+                        await this._inner.update(snap.before);
+                    }
+                    break;
+                case 'delete':
+                    if (snap.before) {
+                        await this._inner.create(snap.before);
+                    }
+                    break;
+                case 'softDelete':
+                    if (snap.id) {
+                        await this._inner.restore(snap.id);
+                    }
+                    break;
+                case 'create':
+                    if (snap.id) {
+                        await this._inner.delete(snap.id);
+                    }
+                    break;
+            }
+        }
+        this._snapshots = [];
+    }
+    /** Clear snapshots after successful completion (no rollback needed). */
+    clearSnapshots() {
+        this._snapshots = [];
+    }
+    /** Check if there are pending snapshots. */
+    get hasSnapshots() {
+        return this._snapshots.length > 0;
+    }
+}
+//# sourceMappingURL=snapshot-repository.js.map

package/dist/service/snapshot-repository.js.map

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

package/dist/service/types.d.ts

@@ -0,0 +1,39 @@
+import type { IMessageAggregator } from '../events/types';
+/**
+ * A service class constructor with model introspection data.
+ * Used by createService() to attach $modelObjects to the class.
+ */
+export interface IntrospectableServiceConstructor {
+    $modelObjects?: Record<string, unknown>;
+}
+/**
+ * Prototype extensions added by createService() for Medusa compatibility.
+ * These methods are dynamically attached to GeneratedService.prototype.
+ */
+export interface GeneratedServicePrototype {
+    emitEvents_?: (groupedEvents: Record<string, unknown[]>) => Promise<void>;
+    aggregatedEvents?: (args: {
+        action?: unknown;
+        object?: unknown;
+        eventName?: unknown;
+        source?: unknown;
+        data?: unknown;
+        context?: {
+            messageAggregator?: IMessageAggregator;
+        };
+    }) => void;
+    interceptEntityMutationEvents?: (event: string, args: OrmEventArgs, context: unknown) => void;
+    MedusaContextIndex_?: Record<string, number>;
+}
+/**
+ * ORM event arguments — structured type for MikroORM/Drizzle afterCreate/afterUpdate/afterDelete hooks.
+ */
+export interface OrmEventArgs {
+    entity?: Record<string, unknown>;
+    changeSet?: {
+        entity?: Record<string, unknown>;
+        originalEntity?: Record<string, unknown>;
+        name?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/service/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEzD;;;GAGG;AACH,MAAM,WAAW,gCAAgC;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE;QACxB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,OAAO,CAAC,EAAE;YAAE,iBAAiB,CAAC,EAAE,kBAAkB,CAAA;SAAE,CAAA;KACrD,KAAK,IAAI,CAAA;IACV,6BAA6B,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7F,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAChC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACxC,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF"}

package/dist/service/types.js

@@ -0,0 +1,3 @@
+// Typed interfaces for runtime-tagged functions and classes.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/service/types.js.map

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

package/dist/strict-mode/index.d.ts

@@ -0,0 +1,42 @@
+export interface StrictModeContext {
+    strict: boolean;
+}
+export interface RouteConflictInfo {
+    path: string;
+    method: string;
+    source1: string;
+    source2: string;
+}
+export interface LinkLocation {
+    id: string;
+    path: string;
+}
+export declare function checkRouteConflicts(routes: Array<{
+    method: string;
+    path: string;
+    source: string;
+}>, strict: boolean): {
+    conflicts: RouteConflictInfo[];
+    warnings: string[];
+};
+export declare function checkUnboundedRelations(opts: {
+    dangerouslyUnboundedRelations?: boolean;
+}, strict: boolean): {
+    allowed: boolean;
+    warning?: string;
+};
+export declare function getEntityThreshold(strict: boolean, configuredMax?: number): number;
+export declare function checkLinkLocations(links: LinkLocation[], strict: boolean): {
+    valid: LinkLocation[];
+    invalid: LinkLocation[];
+    warnings: string[];
+};
+export declare function checkAutoDiscovery(strict: boolean, hasManifest: boolean): {
+    useAutoDiscovery: boolean;
+    warning?: string;
+};
+export declare function checkEventNameAutoGeneration(strict: boolean, hasExplicitEvents: boolean): {
+    autoGenerate: boolean;
+    warning?: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/strict-mode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strict-mode/index.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACb;AAGD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/D,MAAM,EAAE,OAAO,GACd;IAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA8BxD;AAGD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE;IAAE,6BAA6B,CAAC,EAAE,OAAO,CAAA;CAAE,EACjD,MAAM,EAAE,OAAO,GACd;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAQxC;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlF;AAGD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EAAE,EACrB,MAAM,EAAE,OAAO,GACd;IAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAwBxE;AAGD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,OAAO,GACnB;IAAE,gBAAgB,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAQjD;AAGD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,OAAO,EACf,iBAAiB,EAAE,OAAO,GACzB;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAQ7C"}

package/dist/strict-mode/index.js

@@ -0,0 +1,84 @@
+// SPEC-140 — Strict mode validation
+// Disables implicit conventions and enforces explicit declarations
+import { MantaError } from '../errors/manta-error';
+// SM-01 -- Route conflict detection
+export function checkRouteConflicts(routes, strict) {
+    const conflicts = [];
+    const warnings = [];
+    const seen = new Map(); // "METHOD /path" -> source
+    for (const route of routes) {
+        const key = `${route.method} ${route.path}`;
+        const existing = seen.get(key);
+        if (existing) {
+            const conflict = {
+                path: route.path,
+                method: route.method,
+                source1: existing,
+                source2: route.source,
+            };
+            conflicts.push(conflict);
+            if (strict) {
+                throw new MantaError('INVALID_STATE', `Route conflict: ${key} registered by both "${existing}" and "${route.source}". Strict mode forbids route conflicts.`);
+            }
+            else {
+                warnings.push(`Route conflict: ${key} — "${route.source}" overrides "${existing}" (last-wins)`);
+            }
+        }
+        seen.set(key, route.source); // last-wins in normal mode
+    }
+    return { conflicts, warnings };
+}
+// SM-02 -- dangerouslyUnboundedRelations
+export function checkUnboundedRelations(opts, strict) {
+    if (opts.dangerouslyUnboundedRelations) {
+        if (strict) {
+            throw new MantaError('INVALID_STATE', 'dangerouslyUnboundedRelations is forbidden in strict mode');
+        }
+        return { allowed: true, warning: 'dangerouslyUnboundedRelations is enabled — nested relations are unbounded' };
+    }
+    return { allowed: false };
+}
+// SM-03 -- Entity threshold
+export function getEntityThreshold(strict, configuredMax) {
+    if (configuredMax !== undefined)
+        return configuredMax;
+    return strict ? 5000 : 10000;
+}
+// SM-04 -- Link outside src/links/
+export function checkLinkLocations(links, strict) {
+    const valid = [];
+    const invalid = [];
+    const warnings = [];
+    for (const link of links) {
+        // Links must be in src/links/ directory
+        const normalized = link.path.replace(/\\/g, '/');
+        if (normalized.includes('/src/links/') || normalized.includes('/links/')) {
+            valid.push(link);
+        }
+        else {
+            invalid.push(link);
+            if (strict) {
+                throw new MantaError('INVALID_STATE', `Link "${link.id}" at "${link.path}" is outside src/links/. Strict mode requires all links in src/links/.`);
+            }
+            else {
+                warnings.push(`Link "${link.id}" at "${link.path}" is outside src/links/ — silently ignored`);
+            }
+        }
+    }
+    return { valid, invalid, warnings };
+}
+// SM-05 -- Auto-discovery vs manifest
+export function checkAutoDiscovery(strict, hasManifest) {
+    if (strict && !hasManifest) {
+        throw new MantaError('INVALID_STATE', 'Strict mode requires a build manifest. Auto-discovery is disabled in strict mode. Run `manta build` first.');
+    }
+    return { useAutoDiscovery: !strict };
+}
+// SM-06 -- Event name auto-generation
+export function checkEventNameAutoGeneration(strict, hasExplicitEvents) {
+    if (strict && !hasExplicitEvents) {
+        throw new MantaError('INVALID_STATE', 'Strict mode requires explicit event name declarations. Auto-generation is disabled.');
+    }
+    return { autoGenerate: !strict };
+}
+//# sourceMappingURL=index.js.map

package/dist/strict-mode/index.js.map

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

package/dist/subscriber/index.d.ts

@@ -0,0 +1,117 @@
+import type { MantaCommands } from '../command/types';
+import type { MantaEventMap, Message } from '../events/types';
+import type { ICachePort } from '../ports/cache';
+import type { IEventBusPort } from '../ports/event-bus';
+import type { ILoggerPort } from '../ports/logger';
+/**
+ * Subscriber handler function type (legacy — receives raw Message).
+ */
+export type SubscriberHandler<T = unknown> = (event: Message<T>) => Promise<void> | void;
+/**
+ * Subscriber configuration for auto-discovery.
+ */
+export interface SubscriberConfig {
+    event: string | string[];
+    subscriberId?: string;
+    context?: {
+        subscriberId?: string;
+    };
+}
+/**
+ * Subscriber module default export shape.
+ */
+export interface SubscriberExport {
+    config: SubscriberConfig;
+    handler: SubscriberHandler;
+}
+/**
+ * Scoped context passed as arg 2 to subscriber handlers.
+ * - `command` — CQRS command callables
+ * - `log` — logger instance
+ */
+export interface SubscriberScope {
+    command: MantaCommands;
+    log: ILoggerPort;
+}
+/**
+ * @deprecated Use SubscriberScope instead. Kept for backward compat.
+ */
+export interface SubscriberContext<T = unknown> {
+    event: Message<T>;
+    command: MantaCommands;
+    log: ILoggerPort;
+}
+/**
+ * Typed subscriber definition.
+ *
+ * Handler receives: (event, { command, log })
+ *   - arg 1: the incoming Message
+ *   - arg 2: scoped methods from the framework
+ *
+ * @example
+ * export default defineSubscriber({
+ *   event: 'order.placed',
+ *   handler: async (event, { command }) => {
+ *     await command.reserveStock({ itemId: event.data.itemId })
+ *   },
+ * })
+ */
+export interface SubscriberDefinition<T = unknown> {
+    event: string | string[];
+    subscriberId?: string;
+    handler: (event: Message<T>, scope: SubscriberScope) => Promise<void> | void;
+}
+/**
+ * Define a typed subscriber.
+ * When event matches a key in MantaEventMap (populated by codegen), event.data is auto-typed.
+ * Handler receives (event, { command, log }) — can only dispatch commands, not access modules directly.
+ *
+ * @example
+ * // String form (preferred) — event name autocompletes from MantaEventMap
+ * export default defineSubscriber('order.placed', async (event, { command }) => {
+ *   await command.reserveStock({ itemId: event.data.itemId })
+ * })
+ *
+ * @example
+ * // Object form — for subscriberId or multi-event
+ * export default defineSubscriber({
+ *   event: ['order.created', 'order.updated'],
+ *   subscriberId: 'order-sync',
+ *   handler: async (event, { command }) => { ... },
+ * })
+ */
+/** Typed overload — event name from MantaEventMap, data auto-typed. */
+export declare function defineSubscriber<E extends keyof MantaEventMap>(event: E, handler: (event: Message<MantaEventMap[E]>, scope: SubscriberScope) => Promise<void> | void): SubscriberDefinition<MantaEventMap[E]> & {
+    __type: 'subscriber';
+};
+/** Typed object overload — event name from MantaEventMap. */
+export declare function defineSubscriber<E extends keyof MantaEventMap>(config: {
+    event: E;
+    subscriberId?: string;
+    handler: (event: Message<MantaEventMap[E]>, scope: SubscriberScope) => Promise<void> | void;
+}): SubscriberDefinition<MantaEventMap[E]> & {
+    __type: 'subscriber';
+};
+/** Fallback object overload for unknown events or multi-event subscribers. */
+export declare function defineSubscriber<T = unknown>(config: SubscriberDefinition<T>): SubscriberDefinition<T> & {
+    __type: 'subscriber';
+};
+/**
+ * Register a subscriber with the event bus.
+ * Convenience wrapper around IEventBusPort.subscribe().
+ */
+export declare function registerSubscriber(eventBus: IEventBusPort, config: SubscriberConfig, handler: SubscriberHandler): void;
+/**
+ * makeIdempotent() — wraps a subscriber handler for at-least-once deduplication.
+ *
+ * Uses ICachePort to track processed events. Default key: `${eventName}:${data.id}`.
+ * Default TTL: 24 hours.
+ *
+ * Usage:
+ *   const handler = makeIdempotent(cache, async (event) => { ... })
+ */
+export declare function makeIdempotent<T = unknown>(cache: ICachePort, handler: SubscriberHandler<T>, options?: {
+    keyFn?: (event: Message<T>) => string;
+    ttl?: number;
+}): SubscriberHandler<T>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/subscriber/index.js

@@ -0,0 +1,76 @@
+// SPEC-034/035 — Subscriber system utilities
+// Subscribers receive (event, { command, log }) — they can ONLY dispatch commands.
+// No direct module access. Every mutation goes through a workflow.
+import { MantaError } from '../errors/manta-error';
+// ── Implementation ───────────────────────────────────────────────────
+export function defineSubscriber(eventOrConfig, handler) {
+    // String form: defineSubscriber('event.name', handler)
+    if (typeof eventOrConfig === 'string') {
+        if (!eventOrConfig) {
+            throw new MantaError('INVALID_DATA', 'Subscriber event must be a non-empty string');
+        }
+        if (typeof handler !== 'function') {
+            throw new MantaError('INVALID_DATA', 'Subscriber handler must be a function');
+        }
+        return { event: eventOrConfig, handler, __type: 'subscriber' };
+    }
+    // Object form: defineSubscriber({ event, handler })
+    const config = eventOrConfig;
+    if (!config.event || (Array.isArray(config.event) && config.event.length === 0)) {
+        throw new MantaError('INVALID_DATA', 'Subscriber event must be a non-empty string or array');
+    }
+    if (typeof config.handler !== 'function') {
+        throw new MantaError('INVALID_DATA', 'Subscriber handler must be a function');
+    }
+    return Object.assign(config, { __type: 'subscriber' });
+}
+/**
+ * Register a subscriber with the event bus.
+ * Convenience wrapper around IEventBusPort.subscribe().
+ */
+export function registerSubscriber(eventBus, config, handler) {
+    const events = Array.isArray(config.event) ? config.event : [config.event];
+    const subscriberId = config.subscriberId ?? config.context?.subscriberId;
+    for (const eventName of events) {
+        eventBus.subscribe(eventName, handler, subscriberId ? { subscriberId } : undefined);
+    }
+}
+/**
+ * makeIdempotent() — wraps a subscriber handler for at-least-once deduplication.
+ *
+ * Uses ICachePort to track processed events. Default key: `${eventName}:${data.id}`.
+ * Default TTL: 24 hours.
+ *
+ * Usage:
+ *   const handler = makeIdempotent(cache, async (event) => { ... })
+ */
+export function makeIdempotent(cache, handler, options) {
+    const ttl = options?.ttl ?? 86400; // 24 hours
+    const keyFn = options?.keyFn ??
+        ((event) => {
+            const data = event.data;
+            const id = data?.id ?? 'unknown';
+            return `idempotent:${event.eventName}:${id}`;
+        });
+    return async (event) => {
+        const key = keyFn(event);
+        try {
+            const existing = await cache.get(key);
+            if (existing !== null && existing !== undefined) {
+                return; // Already processed — skip
+            }
+        }
+        catch {
+            // Cache unavailable — proceed without dedup (at-least-once guarantee)
+        }
+        await handler(event);
+        try {
+            // Mark as processed
+            await cache.set(key, '1', ttl);
+        }
+        catch {
+            // Cache unavailable — next invocation may re-process
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/subscriber/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/subscriber/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,mFAAmF;AACnF,mEAAmE;AAGnE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAgHlD,wEAAwE;AAExE,MAAM,UAAU,gBAAgB,CAC9B,aAA+C,EAC/C,OAA6E;IAE7E,uDAAuD;IACvD,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,6CAA6C,CAAC,CAAA;QACrF,CAAC;QACD,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,uCAAuC,CAAC,CAAA;QAC/E,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,YAAqB,EAEpE,CAAA;IACH,CAAC;IAED,oDAAoD;IACpD,MAAM,MAAM,GAAG,aAAa,CAAA;IAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,sDAAsD,CAAC,CAAA;IAC9F,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,uCAAuC,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,YAAqB,EAAE,CAAC,CAAA;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAuB,EACvB,MAAwB,EACxB,OAA0B;IAE1B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1E,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,OAAO,EAAE,YAAY,CAAA;IAExE,KAAK,MAAM,SAAS,IAAI,MAAM,EAAE,CAAC;QAC/B,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACrF,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAiB,EACjB,OAA6B,EAC7B,OAGC;IAED,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,KAAK,CAAA,CAAC,WAAW;IAC7C,MAAM,KAAK,GACT,OAAO,EAAE,KAAK;QACd,CAAC,CAAC,KAAiB,EAAE,EAAE;YACrB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAsC,CAAA;YACzD,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,SAAS,CAAA;YAChC,OAAO,cAAc,KAAK,CAAC,SAAS,IAAI,EAAE,EAAE,CAAA;QAC9C,CAAC,CAAC,CAAA;IAEJ,OAAO,KAAK,EAAE,KAAiB,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QACxB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACrC,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAChD,OAAM,CAAC,2BAA2B;YACpC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;QACxE,CAAC;QAED,MAAM,OAAO,CAAC,KAAK,CAAC,CAAA;QAEpB,IAAI,CAAC;YACH,oBAAoB;YACpB,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/testing/relational-query-suite.d.ts

@@ -0,0 +1,22 @@
+import type { IRelationalQueryPort } from '../ports/relational-query';
+export interface SeedEntity {
+    rows: Record<string, unknown>[];
+}
+export interface SeedData {
+    products: SeedEntity;
+    variants: SeedEntity;
+    categories: SeedEntity;
+    product_categories: SeedEntity;
+}
+export declare function buildDefaultSeed(): SeedData;
+export interface RelationalQueryTestFactoryInstance {
+    rq: IRelationalQueryPort;
+    seed: (data: SeedData) => Promise<void>;
+    teardown: () => Promise<void>;
+}
+export interface RelationalQueryTestFactory {
+    name: string;
+    create: () => Promise<RelationalQueryTestFactoryInstance>;
+}
+export declare function runRelationalQueryConformance(factory: RelationalQueryTestFactory): void;
+//# sourceMappingURL=relational-query-suite.d.ts.map

package/dist/testing/relational-query-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relational-query-suite.d.ts","sourceRoot":"","sources":["../../src/testing/relational-query-suite.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAIrE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,UAAU,CAAA;IACpB,QAAQ,EAAE,UAAU,CAAA;IACpB,UAAU,EAAE,UAAU,CAAA;IACtB,kBAAkB,EAAE,UAAU,CAAA;CAC/B;AAED,wBAAgB,gBAAgB,IAAI,QAAQ,CA8B3C;AAID,MAAM,WAAW,kCAAkC;IACjD,EAAE,EAAE,oBAAoB,CAAA;IACxB,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,OAAO,CAAC,kCAAkC,CAAC,CAAA;CAC1D;AAID,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAuNvF"}