@ddd-ts-kit/knex 0.0.0-stage → 0.1.0

package/dist/columns/tenant-column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-column.js","sourceRoot":"","sources":["../../src/columns/tenant-column.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAAC,KAA8B;IACzD,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC;AAC5D,CAAC"}

package/dist/columns/tenant-row.d.ts

@@ -0,0 +1,7 @@
+import type { TenantScoped } from '@ddd-ts-kit/kernel';
+export interface TenantRow {
+    tenant_id: string;
+}
+/** `tenantScopeOf(scope)` under the column name: spread it into an insert and into every `where`. */
+export declare function tenantRow(scoped: TenantScoped): TenantRow;
+//# sourceMappingURL=tenant-row.d.ts.map

package/dist/columns/tenant-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-row.d.ts","sourceRoot":"","sources":["../../src/columns/tenant-row.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAEzD"}

package/dist/columns/tenant-row.js

@@ -0,0 +1,5 @@
+/** `tenantScopeOf(scope)` under the column name: spread it into an insert and into every `where`. */
+export function tenantRow(scoped) {
+    return { tenant_id: scoped.tenantId };
+}
+//# sourceMappingURL=tenant-row.js.map

package/dist/columns/tenant-row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-row.js","sourceRoot":"","sources":["../../src/columns/tenant-row.ts"],"names":[],"mappings":"AAMA,qGAAqG;AACrG,MAAM,UAAU,SAAS,CAAC,MAAoB;IAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { CONCURRENCY_CONFLICT, ConcurrencyError, optimisticUpdate, schemaNameOf, type VersionStep, } from '@ddd-ts-kit/kernel';
+export * from './unit-of-work/knex-context.js';
+export * from './unit-of-work/create-knex-unit-of-work.js';
+export * from './outbox/table-names.js';
+export * from './outbox/outbox-tables-options.js';
+export * from './outbox/create-outbox-tables.js';
+export * from './outbox/drop-outbox-tables.js';
+export * from './outbox/knex-outbox-store.js';
+export * from './outbox/knex-processed-event-store.js';
+export * from './columns/audit-columns.js';
+export * from './columns/tenant-column.js';
+export * from './columns/audit-row.js';
+export * from './columns/tenant-row.js';
+export * from './sql/insert-ignoring-conflict.js';
+export * from './read-model/read-model-columns.js';
+export * from './read-model/predicate-to-knex.js';
+export * from './read-model/criteria-to-knex.js';
+export * from './read-model/knex-read-model-options.js';
+export * from './read-model/knex-read-model-table.js';
+export * from './read-model/knex-read-model-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAC5B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+export { CONCURRENCY_CONFLICT, ConcurrencyError, optimisticUpdate, schemaNameOf, } from '@ddd-ts-kit/kernel';
+export * from './unit-of-work/knex-context.js';
+export * from './unit-of-work/create-knex-unit-of-work.js';
+export * from './outbox/table-names.js';
+export * from './outbox/outbox-tables-options.js';
+export * from './outbox/create-outbox-tables.js';
+export * from './outbox/drop-outbox-tables.js';
+export * from './outbox/knex-outbox-store.js';
+export * from './outbox/knex-processed-event-store.js';
+export * from './columns/audit-columns.js';
+export * from './columns/tenant-column.js';
+export * from './columns/audit-row.js';
+export * from './columns/tenant-row.js';
+export * from './sql/insert-ignoring-conflict.js';
+export * from './read-model/read-model-columns.js';
+export * from './read-model/predicate-to-knex.js';
+export * from './read-model/criteria-to-knex.js';
+export * from './read-model/knex-read-model-options.js';
+export * from './read-model/knex-read-model-table.js';
+export * from './read-model/knex-read-model-store.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GAEb,MAAM,oBAAoB,CAAC;AAC5B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,uCAAuC,CAAC"}

package/dist/outbox/builder-in.d.ts

@@ -0,0 +1,3 @@
+import type { Knex } from 'knex';
+export declare function builderIn(knex: Knex, schema: string | undefined): Knex.SchemaBuilder;
+//# sourceMappingURL=builder-in.d.ts.map

package/dist/outbox/builder-in.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-in.d.ts","sourceRoot":"","sources":["../../src/outbox/builder-in.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,aAAa,CAEpF"}

package/dist/outbox/builder-in.js

@@ -0,0 +1,4 @@
+export function builderIn(knex, schema) {
+    return schema === undefined ? knex.schema : knex.schema.withSchema(schema);
+}
+//# sourceMappingURL=builder-in.js.map

package/dist/outbox/builder-in.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-in.js","sourceRoot":"","sources":["../../src/outbox/builder-in.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,IAAU,EAAE,MAA0B;IAC9D,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC7E,CAAC"}

package/dist/outbox/create-outbox-tables.d.ts

@@ -0,0 +1,9 @@
+import type { Knex } from 'knex';
+import type { OutboxTablesOptions } from './outbox-tables-options.js';
+/**
+ * Creates the outbox and processed-event tables. Call it from a migration of the consuming
+ * project (`export const up = (knex) => createOutboxTables(knex, { schema: 'messaging' })`),
+ * which then owns the tables like any other.
+ */
+export declare function createOutboxTables(knex: Knex, options?: OutboxTablesOptions): Promise<void>;
+//# sourceMappingURL=create-outbox-tables.d.ts.map

package/dist/outbox/create-outbox-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-outbox-tables.d.ts","sourceRoot":"","sources":["../../src/outbox/create-outbox-tables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAMjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOrG"}

package/dist/outbox/create-outbox-tables.js

@@ -0,0 +1,97 @@
+import { INDEXABLE_LENGTH } from '../columns/indexable-length.js';
+import { INSTANT } from '../columns/instant.js';
+import { dialectOf } from '../sql/dialect-of.js';
+import { builderIn } from './builder-in.js';
+import { OUTBOX_TABLE, PROCESSED_EVENTS_TABLE } from './table-names.js';
+/**
+ * Creates the outbox and processed-event tables. Call it from a migration of the consuming
+ * project (`export const up = (knex) => createOutboxTables(knex, { schema: 'messaging' })`),
+ * which then owns the tables like any other.
+ */
+export async function createOutboxTables(knex, options = {}) {
+    if (options.schema !== undefined) {
+        await createNamespace(knex, options.schema);
+    }
+    await createOutboxTable(knex, options);
+    await createProcessedEventsTable(knex, options);
+}
+/** One namespace per bounded context: a schema in PostgreSQL, a database in MySQL. */
+async function createNamespace(knex, name) {
+    switch (dialectOf(knex)) {
+        case 'postgres':
+            await knex.schema.createSchemaIfNotExists(name);
+            return;
+        case 'mysql':
+            await knex.raw('create database if not exists ??', [name]);
+            return;
+        case 'sqlite':
+            throw new TypeError('SQLite has no schemas: name the tables per context with outboxTable and processedEventsTable');
+        default:
+        // Any other database: the schema is expected to exist already.
+    }
+}
+async function createOutboxTable(knex, options) {
+    const outbox = options.outboxTable ?? OUTBOX_TABLE;
+    await builderIn(knex, options.schema).createTable(outbox, (table) => {
+        keyColumns(table, dialectOf(knex));
+        table.text('type').notNullable();
+        table.integer('version').notNullable();
+        // Text, not a timestamp: the envelope must come back exactly as published, offset included.
+        table.text('occurred_at').notNullable();
+        table.jsonb('payload');
+        table.text('traceparent');
+        table.text('correlation_id');
+        table.string('status', 16).notNullable().defaultTo('pending');
+        table.integer('attempts').notNullable().defaultTo(0);
+        table.datetime('next_attempt_at', INSTANT).notNullable();
+        table.text('last_error_code');
+        table.datetime('published_at', INSTANT);
+        table.datetime('created_at', INSTANT).notNullable().defaultTo(rightNow(knex));
+        pendingIndex(table, outbox, knex);
+    });
+}
+/** The identifier and `sequence`, the insertion order that breaks the ties of the claim. */
+function keyColumns(table, dialect) {
+    switch (dialect) {
+        case 'sqlite':
+            // SQLite only auto-increments an integer primary key, so the roles are swapped there.
+            table.increments('sequence');
+            table.string('id', INDEXABLE_LENGTH).notNullable().unique();
+            return;
+        case 'mysql':
+            table.string('id', INDEXABLE_LENGTH).primary();
+            // Spelled out: knex drops AUTO_INCREMENT from a non-primary bigIncrements on MySQL,
+            // which also requires such a column to be a key.
+            table.specificType('sequence', 'bigint unsigned not null auto_increment unique');
+            return;
+        default:
+            table.string('id', INDEXABLE_LENGTH).primary();
+            table.bigIncrements('sequence', { primaryKey: false });
+    }
+}
+function rightNow(knex) {
+    // SQLite knows CURRENT_TIMESTAMP only without a precision.
+    return dialectOf(knex) === 'sqlite' ? knex.fn.now() : knex.fn.now(3);
+}
+function pendingIndex(table, outbox, knex) {
+    if (dialectOf(knex) === 'mysql') {
+        // No partial index in MySQL: the status leads the index instead.
+        table.index(['status', 'next_attempt_at', 'sequence'], `${outbox}_pending_idx`);
+    }
+    else {
+        // Partial: the relay only ever scans what is pending, and published rows dominate.
+        table.index(['next_attempt_at', 'sequence'], `${outbox}_pending_idx`, {
+            predicate: knex.whereRaw("status = 'pending'"),
+        });
+    }
+}
+async function createProcessedEventsTable(knex, options) {
+    await builderIn(knex, options.schema).createTable(options.processedEventsTable ?? PROCESSED_EVENTS_TABLE, (table) => {
+        table.string('consumer', INDEXABLE_LENGTH).notNullable();
+        table.string('event_id', INDEXABLE_LENGTH).notNullable();
+        table.datetime('processed_at', INSTANT).notNullable().defaultTo(rightNow(knex));
+        // The primary key is the unique (consumer, event_id) the store relies on.
+        table.primary(['consumer', 'event_id']);
+    });
+}
+//# sourceMappingURL=create-outbox-tables.js.map

package/dist/outbox/create-outbox-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-outbox-tables.js","sourceRoot":"","sources":["../../src/outbox/create-outbox-tables.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAU,EAAE,OAAO,GAAwB,EAAE;IACpF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,sFAAsF;AACtF,KAAK,UAAU,eAAe,CAAC,IAAU,EAAE,IAAY;IACrD,QAAQ,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,UAAU;YACb,MAAM,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;YAEhD,OAAO;QACT,KAAK,OAAO;YACV,MAAM,IAAI,CAAC,GAAG,CAAC,kCAAkC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YAE3D,OAAO;QACT,KAAK,QAAQ;YACX,MAAM,IAAI,SAAS,CACjB,8FAA8F,CAC/F,CAAC;QACJ,QAAQ;QACR,+DAA+D;IACjE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAU,EAAE,OAA4B;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC;IAEnD,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;QAClE,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,4FAA4F;QAC5F,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC9D,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QACxC,KAAK,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9E,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,4FAA4F;AAC5F,SAAS,UAAU,CAAC,KAA8B,EAAE,OAAmB;IACrE,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,sFAAsF;YACtF,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAC7B,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,CAAC;YAE5D,OAAO;QACT,KAAK,OAAO;YACV,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/C,oFAAoF;YACpF,iDAAiD;YACjD,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,gDAAgD,CAAC,CAAC;YAEjF,OAAO;QACT;YACE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/C,KAAK,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAU;IAC1B,2DAA2D;IAC3D,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,YAAY,CAAC,KAA8B,EAAE,MAAc,EAAE,IAAU;IAC9E,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QAChC,iEAAiE;QACjE,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,iBAAiB,EAAE,UAAU,CAAC,EAAE,GAAG,MAAM,cAAc,CAAC,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,mFAAmF;QACnF,KAAK,CAAC,KAAK,CAAC,CAAC,iBAAiB,EAAE,UAAU,CAAC,EAAE,GAAG,MAAM,cAAc,EAAE;YACpE,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,KAAK,UAAU,0BAA0B,CAAC,IAAU,EAAE,OAA4B;IAChF,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,oBAAoB,IAAI,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE;QAClH,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC;QACzD,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC;QACzD,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAChF,0EAA0E;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/outbox/drop-outbox-tables.d.ts

@@ -0,0 +1,5 @@
+import type { Knex } from 'knex';
+import type { OutboxTablesOptions } from './outbox-tables-options.js';
+/** The `down` of `createOutboxTables`. The schema itself is left in place. */
+export declare function dropOutboxTables(knex: Knex, options?: OutboxTablesOptions): Promise<void>;
+//# sourceMappingURL=drop-outbox-tables.d.ts.map

package/dist/outbox/drop-outbox-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-outbox-tables.d.ts","sourceRoot":"","sources":["../../src/outbox/drop-outbox-tables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,8EAA8E;AAC9E,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAInG"}

package/dist/outbox/drop-outbox-tables.js

@@ -0,0 +1,8 @@
+import { builderIn } from './builder-in.js';
+import { OUTBOX_TABLE, PROCESSED_EVENTS_TABLE } from './table-names.js';
+/** The `down` of `createOutboxTables`. The schema itself is left in place. */
+export async function dropOutboxTables(knex, options = {}) {
+    await builderIn(knex, options.schema).dropTableIfExists(options.processedEventsTable ?? PROCESSED_EVENTS_TABLE);
+    await builderIn(knex, options.schema).dropTableIfExists(options.outboxTable ?? OUTBOX_TABLE);
+}
+//# sourceMappingURL=drop-outbox-tables.js.map

package/dist/outbox/drop-outbox-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-outbox-tables.js","sourceRoot":"","sources":["../../src/outbox/drop-outbox-tables.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAExE,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAU,EAAE,OAAO,GAAwB,EAAE;IAClF,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,oBAAoB,IAAI,sBAAsB,CAAC,CAAC;IAEhH,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC,CAAC;AAC/F,CAAC"}

package/dist/outbox/knex-outbox-store.d.ts

@@ -0,0 +1,61 @@
+import type { IntegrationEvent } from '@ddd-ts-kit/kernel';
+import type { OutboxRecord, OutboxStats, OutboxStore } from '@ddd-ts-kit/events';
+import type { KnexContext } from '../unit-of-work/knex-context.js';
+/**
+ * How concurrent relays share the pending records.
+ * - `skip-locked`: one `SELECT ... FOR UPDATE SKIP LOCKED` and one update in a short
+ *   transaction. Needs PostgreSQL or MySQL 8.
+ * - `compare-and-set`: reads the due records, then takes each with an update guarded by the
+ *   attempt count it read. No lock clause, so it runs on any database, at one statement per
+ *   record.
+ */
+export type OutboxClaimStrategy = 'skip-locked' | 'compare-and-set';
+export interface KnexOutboxStoreOptions {
+    /** The schema the table was created in. Default: the default schema of the connection. */
+    readonly schema?: string;
+    /** Default `outbox`. */
+    readonly table?: string;
+    /** How long a claimed record stays invisible to other claims. Default 30000. */
+    readonly leaseMs?: number;
+    /** Default: `skip-locked` on PostgreSQL and MySQL, `compare-and-set` elsewhere. */
+    readonly claim?: OutboxClaimStrategy;
+}
+/**
+ * The outbox in a SQL database. `append` runs on the executor of the context: called inside a
+ * unit of work, the events are written by the transaction of the command and share its fate,
+ * which is the whole point of an outbox.
+ */
+export declare class KnexOutboxStore implements OutboxStore {
+    private readonly context;
+    private readonly schemaName;
+    private readonly tableName;
+    private readonly leaseDurationMs;
+    private readonly claimStrategy;
+    constructor(context: KnexContext, options?: KnexOutboxStoreOptions);
+    append(events: readonly IntegrationEvent[]): Promise<void>;
+    claimBatch(limit: number, now: Date): Promise<OutboxRecord[]>;
+    markPublished(ids: readonly string[], at: Date): Promise<void>;
+    markFailed(id: string, error: {
+        readonly code: string;
+    }, nextAttemptAt: Date | null): Promise<void>;
+    retryDead(ids: readonly string[], now: Date): Promise<number>;
+    purgePublished(before: Date): Promise<number>;
+    stats(): Promise<OutboxStats>;
+    /**
+     * Selects the due rows `FOR UPDATE SKIP LOCKED`, so concurrent relays pass over each other's
+     * rows instead of waiting, then leases them in the same transaction by pushing
+     * `next_attempt_at` forward. The row locks last a few milliseconds; the lease is what covers
+     * the publication.
+     */
+    private claimSkippingLocked;
+    /**
+     * Takes each due row with an update that only applies if nobody claimed it since it was
+     * read: every claim increments `attempts`, so an unchanged count on a row that is still due
+     * means the row is free. Rows lost to another relay are replaced by reading again.
+     */
+    private claimByCompareAndSet;
+    private rows;
+    private due;
+    private lease;
+}
+//# sourceMappingURL=knex-outbox-store.d.ts.map

package/dist/outbox/knex-outbox-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex-outbox-store.d.ts","sourceRoot":"","sources":["../../src/outbox/knex-outbox-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAgB,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG/F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAGnE;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAEpE,MAAM,WAAW,sBAAsB;IACrC,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAsBD;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IAEtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAEhE,YAAY,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,sBAA2B,EAMrE;IAEK,MAAM,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB/D;IAEK,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAqBlE;IAEK,aAAa,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQnE;IAEK,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,aAAa,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CASxG;IAEK,SAAS,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CASlE;IAEK,cAAc,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAKlD;IAEK,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC,CAclC;IAED;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;;;OAIG;YACW,oBAAoB;IA2BlC,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,GAAG;IASX,OAAO,CAAC,KAAK;CAMd"}

package/dist/outbox/knex-outbox-store.js

@@ -0,0 +1,184 @@
+import { dialectOf } from '../sql/dialect-of.js';
+import { OUTBOX_TABLE } from './table-names.js';
+// A fresh record is due at once, whatever clock the relay runs on.
+const DUE_IMMEDIATELY = new Date(0);
+/**
+ * The outbox in a SQL database. `append` runs on the executor of the context: called inside a
+ * unit of work, the events are written by the transaction of the command and share its fate,
+ * which is the whole point of an outbox.
+ */
+export class KnexOutboxStore {
+    context;
+    schemaName;
+    tableName;
+    leaseDurationMs;
+    claimStrategy;
+    constructor(context, options = {}) {
+        this.context = context;
+        this.schemaName = options.schema;
+        this.tableName = options.table ?? OUTBOX_TABLE;
+        this.leaseDurationMs = options.leaseMs ?? 30_000;
+        this.claimStrategy = options.claim;
+    }
+    async append(events) {
+        if (events.length === 0) {
+            return;
+        }
+        await this.rows(this.context.executor()).insert(events.map((event) => ({
+            id: event.id,
+            type: event.type,
+            version: event.version,
+            occurred_at: event.occurredAt,
+            // Serialized here: drivers would send a JS array as a SQL array, not as JSON.
+            payload: event.payload === undefined ? null : JSON.stringify(event.payload),
+            traceparent: event.traceparent ?? null,
+            correlation_id: event.correlationId ?? null,
+            next_attempt_at: DUE_IMMEDIATELY,
+        })));
+    }
+    async claimBatch(limit, now) {
+        if (limit <= 0) {
+            return [];
+        }
+        const executor = this.context.executor();
+        const dialect = dialectOf(executor);
+        const strategy = this.claimStrategy ?? (dialect === 'postgres' || dialect === 'mysql' ? 'skip-locked' : 'compare-and-set');
+        const claimed = strategy === 'skip-locked'
+            ? await this.claimSkippingLocked(executor, limit, now)
+            : await this.claimByCompareAndSet(executor, limit, now);
+        const leasedUntil = new Date(now.getTime() + this.leaseDurationMs);
+        return claimed.map((row) => toRecord({ ...row, attempts: row.attempts + 1, next_attempt_at: leasedUntil }, dialect));
+    }
+    async markPublished(ids, at) {
+        if (ids.length === 0) {
+            return;
+        }
+        await this.rows(this.context.executor())
+            .whereIn('id', [...ids])
+            .update({ status: 'published', published_at: at });
+    }
+    async markFailed(id, error, nextAttemptAt) {
+        await this.rows(this.context.executor())
+            .where({ id })
+            .whereNot({ status: 'published' })
+            .update(nextAttemptAt === null
+            ? { status: 'dead', last_error_code: error.code }
+            : { next_attempt_at: nextAttemptAt, last_error_code: error.code });
+    }
+    async retryDead(ids, now) {
+        if (ids.length === 0) {
+            return 0;
+        }
+        return this.rows(this.context.executor())
+            .whereIn('id', [...ids])
+            .where({ status: 'dead' })
+            .update({ status: 'pending', attempts: 0, next_attempt_at: now });
+    }
+    async purgePublished(before) {
+        return this.rows(this.context.executor())
+            .where({ status: 'published' })
+            .where('published_at', '<', before)
+            .delete();
+    }
+    async stats() {
+        const executor = this.context.executor();
+        // Portable form of `count(*) filter (where ...)`.
+        const count = (condition, alias) => executor.raw(`sum(case when ${condition} then 1 else 0 end) as ??`, [alias]);
+        const row = await this.rows(executor).first(count("status = 'pending'", 'pending'), count("status = 'pending' and last_error_code is not null", 'failed'), count("status = 'dead'", 'dead'));
+        return { pending: countAt(row, 'pending'), failed: countAt(row, 'failed'), dead: countAt(row, 'dead') };
+    }
+    /**
+     * Selects the due rows `FOR UPDATE SKIP LOCKED`, so concurrent relays pass over each other's
+     * rows instead of waiting, then leases them in the same transaction by pushing
+     * `next_attempt_at` forward. The row locks last a few milliseconds; the lease is what covers
+     * the publication.
+     */
+    claimSkippingLocked(executor, limit, now) {
+        return executor.transaction(async (transaction) => {
+            const due = await this.due(transaction, limit, now).forUpdate().skipLocked();
+            if (due.length > 0) {
+                await this.rows(transaction)
+                    .whereIn('id', due.map((row) => row.id))
+                    .update(this.lease(transaction, now));
+            }
+            return due;
+        });
+    }
+    /**
+     * Takes each due row with an update that only applies if nobody claimed it since it was
+     * read: every claim increments `attempts`, so an unchanged count on a row that is still due
+     * means the row is free. Rows lost to another relay are replaced by reading again.
+     */
+    async claimByCompareAndSet(executor, limit, now) {
+        const claimed = [];
+        while (claimed.length < limit) {
+            const wanted = limit - claimed.length;
+            const due = await this.due(executor, wanted, now);
+            for (const row of due) {
+                const taken = await this.rows(executor)
+                    .where({ id: row.id, status: 'pending', attempts: row.attempts })
+                    .where('next_attempt_at', '<=', now)
+                    .update(this.lease(executor, now));
+                if (taken === 1) {
+                    claimed.push(row);
+                }
+            }
+            if (due.length < wanted) {
+                // Nothing else is due: the rows lost to another relay need no replacement.
+                break;
+            }
+        }
+        return claimed;
+    }
+    rows(executor) {
+        const table = executor(this.tableName);
+        return this.schemaName === undefined ? table : table.withSchema(this.schemaName);
+    }
+    due(executor, limit, now) {
+        return this.rows(executor)
+            .select('*')
+            .where({ status: 'pending' })
+            .where('next_attempt_at', '<=', now)
+            .orderBy([{ column: 'next_attempt_at' }, { column: 'sequence' }])
+            .limit(limit);
+    }
+    lease(executor, now) {
+        return {
+            attempts: executor.raw('?? + 1', ['attempts']),
+            next_attempt_at: new Date(now.getTime() + this.leaseDurationMs),
+        };
+    }
+}
+/** A sum is a bigint or a decimal, which drivers return as a string, and NULL over no row. */
+function countAt(row, column) {
+    if (typeof row !== 'object' || row === null) {
+        return 0;
+    }
+    const value = Object.entries(row).find(([key]) => key === column)?.[1];
+    return Number(value ?? 0);
+}
+function toRecord(row, dialect) {
+    // SQLite has no JSON type: the driver hands the text back. Elsewhere the driver has parsed
+    // the column already, and a payload that is itself a string must not be parsed twice.
+    const payload = dialect === 'sqlite' && typeof row.payload === 'string' ? JSON.parse(row.payload) : row.payload;
+    return {
+        event: {
+            id: row.id,
+            type: row.type,
+            version: row.version,
+            occurredAt: row.occurred_at,
+            payload,
+            ...(row.traceparent === null ? {} : { traceparent: row.traceparent }),
+            ...(row.correlation_id === null ? {} : { correlationId: row.correlation_id }),
+        },
+        status: row.status,
+        attempts: row.attempts,
+        nextAttemptAt: toDate(row.next_attempt_at),
+        ...(row.last_error_code === null ? {} : { lastErrorCode: row.last_error_code }),
+        ...(row.published_at === null ? {} : { publishedAt: toDate(row.published_at) }),
+    };
+}
+function toDate(value) {
+    return value instanceof Date ? value : new Date(value);
+}
+//# sourceMappingURL=knex-outbox-store.js.map

package/dist/outbox/knex-outbox-store.js.map

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

package/dist/outbox/knex-processed-event-store.d.ts

@@ -0,0 +1,21 @@
+import type { ProcessedEventStore } from '@ddd-ts-kit/kernel';
+import type { KnexContext } from '../unit-of-work/knex-context.js';
+export interface KnexProcessedEventStoreOptions {
+    /** The schema the table was created in. Default: the default schema of the connection. */
+    readonly schema?: string;
+    /** Default `processed_events`. */
+    readonly table?: string;
+}
+/**
+ * Idempotency of consumers. It writes on the executor of the context: when the consumer runs
+ * inside a unit of work, the mark commits with the effects of the handler and disappears with
+ * them if the handler fails, so the redelivery is processed.
+ */
+export declare class KnexProcessedEventStore implements ProcessedEventStore {
+    private readonly context;
+    private readonly schemaName;
+    private readonly tableName;
+    constructor(context: KnexContext, options?: KnexProcessedEventStoreOptions);
+    markProcessed(consumer: string, eventId: string): Promise<boolean>;
+}
+//# sourceMappingURL=knex-processed-event-store.d.ts.map

package/dist/outbox/knex-processed-event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex-processed-event-store.d.ts","sourceRoot":"","sources":["../../src/outbox/knex-processed-event-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAGnE,MAAM,WAAW,8BAA8B;IAC7C,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IAEtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,8BAAmC,EAI7E;IAED,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQjE;CACF"}

package/dist/outbox/knex-processed-event-store.js

@@ -0,0 +1,26 @@
+import { insertIgnoringConflict } from '../sql/insert-ignoring-conflict.js';
+import { PROCESSED_EVENTS_TABLE } from './table-names.js';
+/**
+ * Idempotency of consumers. It writes on the executor of the context: when the consumer runs
+ * inside a unit of work, the mark commits with the effects of the handler and disappears with
+ * them if the handler fails, so the redelivery is processed.
+ */
+export class KnexProcessedEventStore {
+    context;
+    schemaName;
+    tableName;
+    constructor(context, options = {}) {
+        this.context = context;
+        this.schemaName = options.schema;
+        this.tableName = options.table ?? PROCESSED_EVENTS_TABLE;
+    }
+    markProcessed(consumer, eventId) {
+        const executor = this.context.executor();
+        const table = executor(this.tableName);
+        return insertIgnoringConflict(executor, this.schemaName === undefined ? table : table.withSchema(this.schemaName), {
+            row: { consumer, event_id: eventId },
+            conflict: ['consumer', 'event_id'],
+        });
+    }
+}
+//# sourceMappingURL=knex-processed-event-store.js.map

package/dist/outbox/knex-processed-event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex-processed-event-store.js","sourceRoot":"","sources":["../../src/outbox/knex-processed-event-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAS1D;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IACjB,OAAO,CAAc;IAErB,UAAU,CAAqB;IAE/B,SAAS,CAAS;IAEnC,YAAY,OAAoB,EAAE,OAAO,GAAmC,EAAE;QAC5E,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,sBAAsB,CAAC;IAC3D,CAAC;IAED,aAAa,CAAC,QAAgB,EAAE,OAAe;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEvC,OAAO,sBAAsB,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;YACjH,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE;YACpC,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/outbox/outbox-tables-options.d.ts

@@ -0,0 +1,12 @@
+export interface OutboxTablesOptions {
+    /**
+     * The schema (PostgreSQL) or database (MySQL) holding the tables; created when missing.
+     * Without it the tables live in the default schema of the connection.
+     */
+    readonly schema?: string;
+    /** Default `outbox`. */
+    readonly outboxTable?: string;
+    /** Default `processed_events`. */
+    readonly processedEventsTable?: string;
+}
+//# sourceMappingURL=outbox-tables-options.d.ts.map

package/dist/outbox/outbox-tables-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-tables-options.d.ts","sourceRoot":"","sources":["../../src/outbox/outbox-tables-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC"}

package/dist/outbox/outbox-tables-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=outbox-tables-options.js.map

package/dist/outbox/outbox-tables-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-tables-options.js","sourceRoot":"","sources":["../../src/outbox/outbox-tables-options.ts"],"names":[],"mappings":""}

package/dist/outbox/table-names.d.ts

@@ -0,0 +1,3 @@
+export declare const OUTBOX_TABLE = "outbox";
+export declare const PROCESSED_EVENTS_TABLE = "processed_events";
+//# sourceMappingURL=table-names.d.ts.map

package/dist/outbox/table-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-names.d.ts","sourceRoot":"","sources":["../../src/outbox/table-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,WAAW,CAAC;AAErC,eAAO,MAAM,sBAAsB,qBAAqB,CAAC"}

package/dist/outbox/table-names.js

@@ -0,0 +1,3 @@
+export const OUTBOX_TABLE = 'outbox';
+export const PROCESSED_EVENTS_TABLE = 'processed_events';
+//# sourceMappingURL=table-names.js.map

package/dist/outbox/table-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-names.js","sourceRoot":"","sources":["../../src/outbox/table-names.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAErC,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC"}

package/dist/read-model/column-of.d.ts

@@ -0,0 +1,3 @@
+/** The column a field is mapped to. A field without a column is a mistake of the adapter, never of a caller. */
+export declare function columnOf(columns: Readonly<Record<string, string>>, field: string): string;
+//# sourceMappingURL=column-of.d.ts.map

package/dist/read-model/column-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-of.d.ts","sourceRoot":"","sources":["../../src/read-model/column-of.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQzF"}