@abloatai/transaction 0.37.0

package/dist/source/adapters/kysely.js

@@ -0,0 +1,206 @@
+/**
+ * Kysely wrappers for Ablo's two customer-database write transports.
+ *
+ * Both wrappers compose the same exported {@link createKyselyMutationCore}:
+ *
+ * - {@link kyselyDataSource} is the endpoint adapter. Its transaction contains
+ *   row DML, the permanent idempotency ledger, and correlated outbox events. A
+ *   Postgres logical marker remains optional for compatibility.
+ * - {@link kyselyDirectMutation} is the engine-side direct wrapper. Its
+ *   transaction contains row DML, the same ledger, and a required logical
+ *   marker. It never creates, writes, or serves `ablo_outbox`.
+ *
+ * The ledger reservation happens before DML via `INSERT ... ON CONFLICT DO
+ * NOTHING`. Postgres waits on a concurrent uncommitted owner of the same key;
+ * after that owner commits, the loser reads and hash-checks its durable response.
+ * If the owner rolls back, the waiter acquires the reservation and performs the
+ * mutation. This gives same-key concurrency one database arbiter and one effect.
+ */
+import { AbloValidationError } from '../../errors.js';
+import { changeSetSchema, outboxEventSchema, sourceCommitEchoMarkerSchema, } from '../contract.js';
+import { assertSourceIdempotencyIntent, assertSourceIdempotencyRetention, sourceChangeIntentHash, SOURCE_IDEMPOTENCY_RETENTION, } from '../idempotency.js';
+import { adapterTableMigrations, idempotencyLedgerMigrations, } from '../migrations.js';
+import { ABLO_POSTGRES_COMMIT_ECHO_PREFIX } from '../types.js';
+import { createKyselyMutationCore, kyselyOperationRowId, } from './kyselyMutationCore.js';
+export { createKyselyMutationCore, kyselyOperationRowId, } from './kyselyMutationCore.js';
+function rawQuery(queryId, sql, parameters) {
+    return {
+        query: { kind: 'RawNode', sqlFragments: [sql], parameters: [] },
+        queryId: { queryId },
+        sql,
+        parameters,
+    };
+}
+function reserveLedgerQuery(correlationId, requestHash) {
+    return rawQuery('ablo-idempotency-reserve', `INSERT INTO ablo_idempotency (client_tx_id, response, request_hash, expires_at)
+     VALUES ($1, $2::jsonb, $3, now() + $4::interval)
+     ON CONFLICT (client_tx_id) DO NOTHING
+     RETURNING client_tx_id`, [correlationId, '[]', requestHash, SOURCE_IDEMPOTENCY_RETENTION]);
+}
+function completeLedgerQuery(correlationId, rows) {
+    return rawQuery('ablo-idempotency-complete', `UPDATE ablo_idempotency
+        SET response = $2::jsonb
+      WHERE client_tx_id = $1`, [correlationId, JSON.stringify(rows)]);
+}
+function postgresLogicalMarkerQuery(payload) {
+    return rawQuery('ablo-postgres-logical-marker', 'SELECT pg_logical_emit_message(true, $1::text, $2::text)', [ABLO_POSTGRES_COMMIT_ECHO_PREFIX, payload]);
+}
+function parseCachedRows(response) {
+    const parsed = typeof response === 'string' ? JSON.parse(response) : response;
+    if (!Array.isArray(parsed)) {
+        throw new AbloValidationError('The source idempotency response is corrupt and cannot be replayed safely', { code: 'idempotency_conflict' });
+    }
+    return parsed;
+}
+function markerAction(type) {
+    if (type === 'CREATE')
+        return 'I';
+    if (type === 'DELETE')
+        return 'D';
+    return 'U';
+}
+function assertDirectLogicalMarker(change, markerModelFor) {
+    const payload = change.echo?.payload;
+    if (!payload) {
+        throw new AbloValidationError('A direct Kysely mutation requires a transactional Postgres logical marker', { code: 'source_adapter_misconfigured' });
+    }
+    try {
+        const marker = sourceCommitEchoMarkerSchema.parse(JSON.parse(payload));
+        if (marker.correlationId !== change.correlationId) {
+            throw new Error('marker correlation does not match the ledger key');
+        }
+        if (marker.operations.length !== change.operations.length) {
+            throw new Error('marker operation count does not match the mutation');
+        }
+        for (const [index, operation] of change.operations.entries()) {
+            const markerOperation = marker.operations[index];
+            // The marker speaks the canonical schema TYPENAME (the vocabulary the
+            // WAL consumer validates deltas against), while the mutation operation
+            // carries the authoring wire key. `markerModelFor` translates the wire
+            // key through the schema so the two vocabularies compare correctly.
+            if (!markerOperation ||
+                markerOperation.model !== markerModelFor(operation.model) ||
+                markerOperation.id !== kyselyOperationRowId(operation) ||
+                markerOperation.action !== markerAction(operation.type) ||
+                markerOperation.transactionId !== operation.transactionId) {
+                throw new Error(`marker operation ${index} does not match the mutation`);
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof AbloValidationError)
+            throw error;
+        throw new AbloValidationError(`The direct Postgres logical marker is invalid: ${error instanceof Error ? error.message : 'unknown marker error'}`, { code: 'source_adapter_misconfigured' });
+    }
+}
+export function createKyselyMutationAdapter(db, core, mode, options = {}) {
+    const markerModelFor = options.markerModelFor ?? ((model) => model);
+    return {
+        capabilities: {
+            transactions: true,
+            propose: false,
+            schemaIntrospection: true,
+            postgresWalEcho: true,
+            outboxEvents: mode === 'endpoint',
+        },
+        migrations() {
+            return mode === 'endpoint'
+                ? adapterTableMigrations()
+                : idempotencyLedgerMigrations();
+        },
+        read(request) {
+            return core.read(request);
+        },
+        async commit(change) {
+            const request = changeSetSchema.parse(change);
+            if (mode === 'direct')
+                assertDirectLogicalMarker(request, markerModelFor);
+            const requestHash = sourceChangeIntentHash(request);
+            return db.transaction().execute(async (transaction) => {
+                const reservation = await transaction.executeQuery(reserveLedgerQuery(request.correlationId, requestHash));
+                if (reservation.rows.length === 0) {
+                    const cached = await transaction
+                        .selectFrom('ablo_idempotency')
+                        .selectAll()
+                        .where('client_tx_id', '=', request.correlationId)
+                        .limit(1)
+                        .execute();
+                    const cachedRow = cached[0];
+                    if (!cachedRow) {
+                        throw new AbloValidationError('The source idempotency reservation disappeared during replay', { code: 'idempotency_conflict' });
+                    }
+                    assertSourceIdempotencyIntent(cachedRow.request_hash, requestHash);
+                    assertSourceIdempotencyRetention(cachedRow.expires_at);
+                    return { rows: parseCachedRows(cachedRow.response) };
+                }
+                const rows = [];
+                for (const [index, operation] of request.operations.entries()) {
+                    const row = await core.applyOperation(transaction, operation);
+                    rows.push(row);
+                    if (mode === 'endpoint') {
+                        const entityId = String(row.id ?? kyselyOperationRowId(operation));
+                        await transaction
+                            .insertInto('ablo_outbox')
+                            .values({
+                            id: `${request.correlationId}:${index}`,
+                            model: operation.model,
+                            entity_id: entityId,
+                            type: operation.type,
+                            data: operation.type === 'DELETE' ? null : JSON.stringify(row),
+                            correlation_id: request.correlationId,
+                            transaction_id: operation.transactionId ?? null,
+                            occurred_at: Date.now(),
+                        })
+                            .execute();
+                    }
+                }
+                await transaction.executeQuery(completeLedgerQuery(request.correlationId, rows));
+                if (request.echo?.kind === 'postgres-wal') {
+                    await transaction.executeQuery(postgresLogicalMarkerQuery(request.echo.payload));
+                }
+                return { rows };
+            });
+        },
+    };
+}
+/** Endpoint wrapper: mutation + ledger + outbox, with an optional marker. */
+export function kyselyDataSource(db, schema) {
+    const mutation = createKyselyMutationAdapter(db, createKyselyMutationCore(db, schema), 'endpoint');
+    return {
+        ...mutation,
+        capabilities: { ...mutation.capabilities, outboxEvents: true },
+        async events(cursor, limit) {
+            const rows = await db
+                .selectFrom('ablo_outbox')
+                .selectAll()
+                .where('cursor', '>', cursor ?? '0')
+                .orderBy('cursor', 'asc')
+                .limit(limit)
+                .execute();
+            const events = rows.map((row) => outboxEventSchema.parse({
+                id: row.id,
+                model: row.model,
+                entityId: row.entity_id,
+                type: row.type,
+                data: typeof row.data === 'string' ? JSON.parse(row.data) : row.data ?? null,
+                organizationId: row.organization_id ?? null,
+                clientTxId: row.client_tx_id ?? null,
+                correlationId: row.correlation_id ?? null,
+                transactionId: row.transaction_id ?? null,
+                occurredAt: row.occurred_at != null ? Number(row.occurred_at) : null,
+                cursor: String(row.cursor),
+            }));
+            return { events, nextCursor: events.at(-1)?.cursor ?? null };
+        },
+    };
+}
+/** Direct wrapper: mutation + ledger + required logical marker, never outbox. */
+export function kyselyDirectMutation(db, schema) {
+    return createKyselyMutationAdapter(db, createKyselyMutationCore(db, schema), 'direct', {
+        markerModelFor: (operationModel) => {
+            const typename = schema.models[operationModel]?.typename;
+            return typename && typename.length > 0 ? typename : operationModel;
+        },
+    });
+}
+//# sourceMappingURL=kysely.js.map

package/dist/source/adapters/kysely.js.map

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

package/dist/source/adapters/kyselyMutationCore.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Reusable Kysely row-mutation core.
+ *
+ * This is the single schema-field ↔ physical-column translation used by both
+ * Kysely transports. It deliberately knows nothing about outboxes, logical
+ * markers, or idempotency: wrappers compose those transaction policies around
+ * the same `applyOperation` implementation, so direct and endpoint DML cannot
+ * drift into separate hand-written mappers.
+ */
+import type { Schema, SchemaRecord } from '../../schema/schema.js';
+import type { AdapterReadRequest, Row } from '../adapter.js';
+import type { Operation } from '../contract.js';
+/** The subset of a Kysely instance, or transaction handle, used by the core. */
+export interface KyselyLike {
+    selectFrom(table: string): KyselySelectBuilder;
+    insertInto(table: string): KyselyInsertBuilder;
+    updateTable(table: string): KyselyUpdateBuilder;
+    deleteFrom(table: string): KyselyDeleteBuilder;
+    /** Execute a precompiled raw query on this exact transaction handle. */
+    executeQuery(query: KyselyCompiledQuery): Promise<{
+        readonly rows: readonly Row[];
+    }>;
+    transaction(): KyselyTransactionBuilder;
+}
+/** Structural slice of Kysely's public `CompiledQuery` shape. */
+export interface KyselyCompiledQuery {
+    readonly query: {
+        readonly kind: 'RawNode';
+        readonly sqlFragments: readonly string[];
+        readonly parameters: readonly [];
+    };
+    readonly queryId: {
+        readonly queryId: string;
+    };
+    readonly sql: string;
+    readonly parameters: readonly unknown[];
+}
+export interface KyselyTransactionBuilder {
+    execute<T>(fn: (trx: KyselyLike) => Promise<T>): Promise<T>;
+}
+export interface KyselySelectBuilder {
+    selectAll(): KyselySelectBuilder;
+    where(column: string, operator: string, value: unknown): KyselySelectBuilder;
+    orderBy(column: string, direction: 'asc' | 'desc'): KyselySelectBuilder;
+    limit(limit: number): KyselySelectBuilder;
+    execute(): Promise<readonly Row[]>;
+}
+export interface KyselyReturningExecutable {
+    execute(): Promise<readonly Row[]>;
+}
+export interface KyselyInsertBuilder {
+    values(row: Row): KyselyInsertValuesBuilder;
+}
+export interface KyselyInsertValuesBuilder {
+    returningAll(): KyselyReturningExecutable;
+    execute(): Promise<unknown>;
+}
+export interface KyselyUpdateBuilder {
+    set(patch: Row): KyselyUpdateSetBuilder;
+}
+export interface KyselyUpdateSetBuilder {
+    where(column: string, operator: string, value: unknown): KyselyUpdateSetBuilder;
+    returningAll(): KyselyReturningExecutable;
+}
+export interface KyselyDeleteBuilder {
+    where(column: string, operator: string, value: unknown): KyselyDeleteBuilder;
+    returningAll(): KyselyReturningExecutable;
+}
+/** Resolve the stable row id required by every source operation. */
+export declare function kyselyOperationRowId(operation: Operation): string;
+/** The transport-independent Kysely field/column mutation boundary. */
+export interface KyselyMutationCore {
+    read(request: AdapterReadRequest): Promise<readonly Row[]>;
+    applyOperation(transaction: KyselyLike, operation: Operation): Promise<Row>;
+}
+export declare function createKyselyMutationCore<S extends SchemaRecord>(db: KyselyLike, schema: Schema<S>): KyselyMutationCore;
+//# sourceMappingURL=kyselyMutationCore.d.ts.map

package/dist/source/adapters/kyselyMutationCore.d.ts.map

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

package/dist/source/adapters/kyselyMutationCore.js

@@ -0,0 +1,126 @@
+/**
+ * Reusable Kysely row-mutation core.
+ *
+ * This is the single schema-field ↔ physical-column translation used by both
+ * Kysely transports. It deliberately knows nothing about outboxes, logical
+ * markers, or idempotency: wrappers compose those transaction policies around
+ * the same `applyOperation` implementation, so direct and endpoint DML cannot
+ * drift into separate hand-written mappers.
+ */
+import { AbloValidationError } from '../../errors.js';
+import { toSchemaJSON } from '../../schema/serialize.js';
+import { camelToSnake, snakeToCamel } from '../../schema/ddl.js';
+import { tenancyColumn } from '../../schema/tenancy.js';
+function buildColumnMaps(schema) {
+    const json = toSchemaJSON(schema);
+    const out = new Map();
+    for (const [key, model] of Object.entries(json.models)) {
+        const fieldToColumn = new Map();
+        const columnToField = new Map();
+        const register = (field, column) => {
+            if (column === camelToSnake(field))
+                return;
+            fieldToColumn.set(field, column);
+            columnToField.set(column, field);
+        };
+        for (const [field, meta] of Object.entries(model.fields)) {
+            if (meta.column)
+                register(field, meta.column);
+        }
+        const orgColumn = tenancyColumn(model.tenancy);
+        if (orgColumn)
+            register('organizationId', orgColumn);
+        out.set(key, {
+            table: model.tableName ?? key,
+            fieldToColumn,
+            columnToField,
+        });
+    }
+    return out;
+}
+/** Resolve the stable row id required by every source operation. */
+export function kyselyOperationRowId(operation) {
+    const id = operation.id ?? operation.input?.id;
+    if (typeof id !== 'string' || id.length === 0) {
+        throw new AbloValidationError(`operation on "${operation.model}" requires an id`, { code: 'source_operation_id_required' });
+    }
+    return id;
+}
+export function createKyselyMutationCore(db, schema) {
+    const maps = buildColumnMaps(schema);
+    const modelColumns = (model) => {
+        const columns = maps.get(model);
+        if (!columns) {
+            throw new AbloValidationError(`kysely mutation core: no model "${model}" in schema`, { code: 'source_adapter_misconfigured' });
+        }
+        return columns;
+    };
+    const columnFor = (columns, field) => columns.fieldToColumn.get(field) ?? camelToSnake(field);
+    const fieldFor = (columns, column) => columns.columnToField.get(column) ?? snakeToCamel(column);
+    const toColumns = (columns, row) => {
+        const out = {};
+        for (const key of Object.keys(row))
+            out[columnFor(columns, key)] = row[key];
+        return out;
+    };
+    const toFields = (columns, row) => {
+        const out = {};
+        for (const key of Object.keys(row))
+            out[fieldFor(columns, key)] = row[key];
+        return out;
+    };
+    return {
+        async read(request) {
+            const columns = modelColumns(request.model);
+            if (request.kind === 'load') {
+                const rows = await db
+                    .selectFrom(columns.table)
+                    .selectAll()
+                    .where('id', '=', request.id)
+                    .limit(1)
+                    .execute();
+                return rows.map((row) => toFields(columns, row));
+            }
+            const rows = await db
+                .selectFrom(columns.table)
+                .selectAll()
+                .limit(request.query?.limit ?? 1000)
+                .execute();
+            return rows.map((row) => toFields(columns, row));
+        },
+        async applyOperation(transaction, operation) {
+            const columns = modelColumns(operation.model);
+            const id = kyselyOperationRowId(operation);
+            const input = operation.input ?? {};
+            if (operation.type === 'DELETE') {
+                const deleted = await transaction
+                    .deleteFrom(columns.table)
+                    .where('id', '=', id)
+                    .returningAll()
+                    .execute();
+                return deleted[0] ? toFields(columns, deleted[0]) : { id };
+            }
+            if (operation.type === 'CREATE') {
+                const inserted = await transaction
+                    .insertInto(columns.table)
+                    .values(toColumns(columns, { id, ...input }))
+                    .returningAll()
+                    .execute();
+                return inserted[0] ? toFields(columns, inserted[0]) : { id, ...input };
+            }
+            const patch = toColumns(columns, {
+                ...input,
+                ...(operation.type === 'ARCHIVE' ? { archivedAt: new Date() } : {}),
+                ...(operation.type === 'UNARCHIVE' ? { archivedAt: null } : {}),
+            });
+            const updated = await transaction
+                .updateTable(columns.table)
+                .set(patch)
+                .where('id', '=', id)
+                .returningAll()
+                .execute();
+            return updated[0] ? toFields(columns, updated[0]) : { id, ...input };
+        },
+    };
+}
+//# sourceMappingURL=kyselyMutationCore.js.map

package/dist/source/adapters/kyselyMutationCore.js.map

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

package/dist/source/adapters/memory.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The in-memory reference implementation of {@link DataSourceAdapter}. It is the
+ * simplest correct adapter: a stand-in you can commit to and read from in tests
+ * without a database, and the fixture the conformance suite runs against to confirm
+ * the suite exercises real behavior. An adapter for a given object-relational
+ * mapper is complete when it passes the same suite this one passes.
+ *
+ * It models the semantics minimally but faithfully: one row store per model, an
+ * idempotency ledger keyed by scoped correlation, and an append-only outbox with a
+ * monotonic cursor.
+ */
+import type { DataSourceAdapter } from '../adapter.js';
+export declare function memoryDataSource(): DataSourceAdapter;
+//# sourceMappingURL=memory.d.ts.map

package/dist/source/adapters/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/source/adapters/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAGV,iBAAiB,EAElB,MAAM,eAAe,CAAC;AAevB,wBAAgB,gBAAgB,IAAI,iBAAiB,CAwHpD"}

package/dist/source/adapters/memory.js

@@ -0,0 +1,131 @@
+/**
+ * The in-memory reference implementation of {@link DataSourceAdapter}. It is the
+ * simplest correct adapter: a stand-in you can commit to and read from in tests
+ * without a database, and the fixture the conformance suite runs against to confirm
+ * the suite exercises real behavior. An adapter for a given object-relational
+ * mapper is complete when it passes the same suite this one passes.
+ *
+ * It models the semantics minimally but faithfully: one row store per model, an
+ * idempotency ledger keyed by scoped correlation, and an append-only outbox with a
+ * monotonic cursor.
+ */
+import { AbloValidationError } from '../../errors.js';
+import { assertSourceIdempotencyIntent, sourceChangeIntentHash, } from '../idempotency.js';
+function rowId(op) {
+    const id = op.id ?? op.input?.id;
+    if (typeof id !== 'string' || id.length === 0) {
+        throw new AbloValidationError(`operation on "${op.model}" requires an id`, { code: 'source_operation_id_required' });
+    }
+    return id;
+}
+export function memoryDataSource() {
+    /** model → (id → row). */
+    const store = new Map();
+    /** Permanent correlationId → intent hash + original response ledger. */
+    const idempotency = new Map();
+    /** Append-only outbox; `cursor` is the 1-based index as a string. */
+    const outbox = [];
+    const modelStore = (model) => {
+        let m = store.get(model);
+        if (!m) {
+            m = new Map();
+            store.set(model, m);
+        }
+        return m;
+    };
+    const applyOperation = (op) => {
+        const m = modelStore(op.model);
+        const id = rowId(op);
+        switch (op.type) {
+            case 'CREATE': {
+                const row = { id, ...(op.input ?? {}) };
+                m.set(id, row);
+                return row;
+            }
+            case 'UPDATE':
+            case 'ARCHIVE':
+            case 'UNARCHIVE': {
+                const prev = m.get(id) ?? { id };
+                const row = {
+                    ...prev,
+                    ...(op.input ?? {}),
+                    ...(op.type === 'ARCHIVE' ? { archivedAt: Date.now() } : {}),
+                    ...(op.type === 'UNARCHIVE' ? { archivedAt: null } : {}),
+                };
+                m.set(id, row);
+                return row;
+            }
+            case 'DELETE': {
+                const prev = m.get(id) ?? { id };
+                m.delete(id);
+                return prev;
+            }
+        }
+    };
+    return {
+        capabilities: {
+            transactions: true,
+            propose: false,
+            schemaIntrospection: false,
+            postgresWalEcho: false,
+            outboxEvents: true,
+        },
+        migrations() {
+            // Nothing to create in memory. A database-backed adapter returns the SQL for its ablo_idempotency and ablo_outbox tables here.
+            return [];
+        },
+        async read(req) {
+            const m = store.get(req.model);
+            if (!m)
+                return [];
+            if (req.kind === 'load') {
+                const row = m.get(req.id);
+                return row ? [row] : [];
+            }
+            let rows = [...m.values()];
+            const limit = req.query?.limit;
+            if (typeof limit === 'number')
+                rows = rows.slice(0, limit);
+            return rows;
+        },
+        async commit(change) {
+            if (change.echo) {
+                throw new AbloValidationError('memoryDataSource cannot emit a Postgres WAL commit echo');
+            }
+            // Idempotency: a duplicate scoped correlation returns the original rows.
+            const requestHash = sourceChangeIntentHash(change);
+            const cached = idempotency.get(change.correlationId);
+            if (cached) {
+                assertSourceIdempotencyIntent(cached.requestHash, requestHash);
+                return { rows: cached.rows };
+            }
+            const rows = [];
+            for (const [index, op] of change.operations.entries()) {
+                const row = applyOperation(op);
+                rows.push(row);
+                // Transactional outbox: one event per op, monotonic cursor.
+                outbox.push({
+                    id: `${change.correlationId}:${index}`,
+                    model: op.model,
+                    entityId: String(row.id ?? rowId(op)),
+                    type: op.type,
+                    data: op.type === 'DELETE' ? null : row,
+                    correlationId: change.correlationId,
+                    ...(op.transactionId ? { transactionId: op.transactionId } : {}),
+                    cursor: String(outbox.length + 1),
+                });
+            }
+            idempotency.set(change.correlationId, { requestHash, rows });
+            return { rows };
+        },
+        async events(cursor, limit) {
+            const after = cursor ? Number(cursor) : 0;
+            const page = outbox.filter((e) => Number(e.cursor) > after).slice(0, limit);
+            return {
+                events: page,
+                nextCursor: page.at(-1)?.cursor ?? null,
+            };
+        },
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/source/adapters/memory.js.map

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