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

package/dist/read-model/column-of.js

@@ -0,0 +1,9 @@
+/** The column a field is mapped to. A field without a column is a mistake of the adapter, never of a caller. */
+export function columnOf(columns, field) {
+    const column = Object.hasOwn(columns, field) ? columns[field] : undefined;
+    if (column === undefined) {
+        throw new Error(`The field "${field}" is mapped to no column`);
+    }
+    return column;
+}
+//# sourceMappingURL=column-of.js.map

package/dist/read-model/column-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-of.js","sourceRoot":"","sources":["../../src/read-model/column-of.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,MAAM,UAAU,QAAQ,CAAC,OAAyC,EAAE,KAAa;IAC/E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,0BAA0B,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/read-model/criteria-to-knex.d.ts

@@ -0,0 +1,11 @@
+import type { Knex } from 'knex';
+import type { CriteriaPlan } from '@ddd-ts-kit/kernel';
+/**
+ * Adds a criteria plan to a query on the table of a read model: its filters and the scope of
+ * the actor, the keyset of a cursor page, the total order and the window.
+ * `criteriaToKnex(db('appointment_list'), planCriteria(definition, criteria), columns)`, then
+ * `pageOfPlan(plan, rows)`. A field that may be null is ordered as the plan means it, on every
+ * dialect: nulls last ascending, first descending.
+ */
+export declare function criteriaToKnex<Builder extends Knex.QueryBuilder>(builder: Builder, plan: CriteriaPlan, columns: Readonly<Record<string, string>>): Builder;
+//# sourceMappingURL=criteria-to-knex.d.ts.map

package/dist/read-model/criteria-to-knex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria-to-knex.d.ts","sourceRoot":"","sources":["../../src/read-model/criteria-to-knex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,IAAI,CAAC,YAAY,EAC9D,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACxC,OAAO,CAqBT"}

package/dist/read-model/criteria-to-knex.js

@@ -0,0 +1,28 @@
+import { columnOf } from './column-of.js';
+import { predicateToKnex } from './predicate-to-knex.js';
+/**
+ * Adds a criteria plan to a query on the table of a read model: its filters and the scope of
+ * the actor, the keyset of a cursor page, the total order and the window.
+ * `criteriaToKnex(db('appointment_list'), planCriteria(definition, criteria), columns)`, then
+ * `pageOfPlan(plan, rows)`. A field that may be null is ordered as the plan means it, on every
+ * dialect: nulls last ascending, first descending.
+ */
+export function criteriaToKnex(builder, plan, columns) {
+    predicateToKnex(builder, plan.filter, columns);
+    predicateToKnex(builder, plan.seek, columns);
+    for (const { field, direction } of plan.sort) {
+        const column = columnOf(columns, field);
+        if (plan.fields[field]?.nullable === true) {
+            void builder.orderBy(column, direction, direction === 'asc' ? 'last' : 'first');
+        }
+        else {
+            void builder.orderBy(column, direction);
+        }
+    }
+    void builder.limit(plan.fetch);
+    if (plan.offset > 0) {
+        void builder.offset(plan.offset);
+    }
+    return builder;
+}
+//# sourceMappingURL=criteria-to-knex.js.map

package/dist/read-model/criteria-to-knex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria-to-knex.js","sourceRoot":"","sources":["../../src/read-model/criteria-to-knex.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,IAAkB,EAClB,OAAyC;IAEzC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE7C,KAAK,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAExC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC1C,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAClF,CAAC;aAAM,CAAC;YACN,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,KAAK,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE/B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/read-model/knex-read-model-options.d.ts

@@ -0,0 +1,10 @@
+export interface KnexReadModelOptions<Row> {
+    readonly table: string;
+    /** The schema of the context. Default: the default schema of the connection. */
+    readonly schema?: string;
+    /** The column of the key, which is the primary key of the table. Default `id`. */
+    readonly keyColumn?: string;
+    /** The column of every field of the row: `{ startsAt: 'starts_at' }`. */
+    readonly columns: Readonly<Record<keyof Row & string, string>>;
+}
+//# sourceMappingURL=knex-read-model-options.d.ts.map

package/dist/read-model/knex-read-model-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex-read-model-options.d.ts","sourceRoot":"","sources":["../../src/read-model/knex-read-model-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB,CAAC,GAAG;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChE"}

package/dist/read-model/knex-read-model-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=knex-read-model-options.js.map

package/dist/read-model/knex-read-model-options.js.map

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

package/dist/read-model/knex-read-model-store.d.ts

@@ -0,0 +1,16 @@
+import { TableReadModelStore, type CriteriaDefinition } from '@ddd-ts-kit/kernel';
+import type { KnexContext } from '../unit-of-work/knex-context.js';
+import type { KnexReadModelOptions } from './knex-read-model-options.js';
+export interface KnexReadModel<Row> extends KnexReadModelOptions<Row> {
+    /** What a read of the read model may filter and sort by. */
+    readonly definition: CriteriaDefinition<Row>;
+}
+/**
+ * The read model of a projection in a knex table. The adapter of a read model port extends
+ * it and adds nothing: `class KnexAppointmentList extends KnexReadModelStore<AppointmentRow>
+ * implements AppointmentList`. Its `table` is what a `ProjectionRebuild` takes.
+ */
+export declare class KnexReadModelStore<Row extends object> extends TableReadModelStore<Row> {
+    constructor(context: KnexContext, { definition, ...options }: KnexReadModel<Row>);
+}
+//# sourceMappingURL=knex-read-model-store.d.ts.map

package/dist/read-model/knex-read-model-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex-read-model-store.d.ts","sourceRoot":"","sources":["../../src/read-model/knex-read-model-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,MAAM,WAAW,aAAa,CAAC,GAAG,CAAE,SAAQ,oBAAoB,CAAC,GAAG,CAAC;IACnE,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;CAC9C;AAED;;;;GAIG;AACH,qBAAa,kBAAkB,CAAC,GAAG,SAAS,MAAM,CAAE,SAAQ,mBAAmB,CAAC,GAAG,CAAC;IAClF,YAAY,OAAO,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,EAE/E;CACF"}

package/dist/read-model/knex-read-model-store.js

@@ -0,0 +1,13 @@
+import { TableReadModelStore } from '@ddd-ts-kit/kernel';
+import { KnexReadModelTable } from './knex-read-model-table.js';
+/**
+ * The read model of a projection in a knex table. The adapter of a read model port extends
+ * it and adds nothing: `class KnexAppointmentList extends KnexReadModelStore<AppointmentRow>
+ * implements AppointmentList`. Its `table` is what a `ProjectionRebuild` takes.
+ */
+export class KnexReadModelStore extends TableReadModelStore {
+    constructor(context, { definition, ...options }) {
+        super(new KnexReadModelTable(context, options), definition);
+    }
+}
+//# sourceMappingURL=knex-read-model-store.js.map

package/dist/read-model/knex-read-model-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex-read-model-store.js","sourceRoot":"","sources":["../../src/read-model/knex-read-model-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA2B,MAAM,oBAAoB,CAAC;AAGlF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAOhE;;;;GAIG;AACH,MAAM,OAAO,kBAAuC,SAAQ,mBAAwB;IAClF,YAAY,OAAoB,EAAE,EAAE,UAAU,EAAE,GAAG,OAAO,EAAsB;QAC9E,KAAK,CAAC,IAAI,kBAAkB,CAAM,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/read-model/knex-read-model-table.d.ts

@@ -0,0 +1,32 @@
+import { type CriteriaPlan, type EventStamp, type SearchedRows, type ReadModelRows, type ReadModelTable, type StampedRow, type TouchedKey } from '@ddd-ts-kit/kernel';
+import type { KnexContext } from '../unit-of-work/knex-context.js';
+import type { KnexReadModelOptions } from './knex-read-model-options.js';
+/**
+ * The table of one read model on knex: what `TableReadModelStore` and `ProjectionRebuild` are
+ * given. Every statement runs on the executor of the context, so a write made by a projection
+ * commits with the processed mark of its event. The rebuild is PostgreSQL only.
+ */
+export declare class KnexReadModelTable<Row extends object> implements ReadModelTable<Row> {
+    private readonly context;
+    private readonly options;
+    private readonly rows;
+    private readonly copy;
+    private readonly rebuild;
+    constructor(context: KnexContext, options: KnexReadModelOptions<Row>);
+    find(key: string): Promise<StampedRow<Row> | undefined>;
+    insert(entry: StampedRow<Row>): Promise<boolean>;
+    replace(entry: StampedRow<Row>, held: EventStamp): Promise<boolean>;
+    search(plan: CriteriaPlan): Promise<SearchedRows<Row>>;
+    rebuilding(): Promise<boolean>;
+    touch(key: string): Promise<void>;
+    beginRebuild(): Promise<void>;
+    shadow(): ReadModelRows<Row>;
+    touched(limit: number): Promise<readonly TouchedKey[]>;
+    settle(keys: readonly TouchedKey[]): Promise<void>;
+    holdWriters(): Promise<void>;
+    promote(): Promise<void>;
+    abandonRebuild(): Promise<void>;
+    /** knex writes its bindings `?`: the statements of the rebuild name each of theirs once, in order. */
+    private run;
+}
+//# sourceMappingURL=knex-read-model-table.d.ts.map

package/dist/read-model/knex-read-model-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex-read-model-table.d.ts","sourceRoot":"","sources":["../../src/read-model/knex-read-model-table.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAMzE;;;;GAIG;AACH,qBAAa,kBAAkB,CAAC,GAAG,SAAS,MAAM,CAAE,YAAW,cAAc,CAAC,GAAG,CAAC;IAQ9E,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAE5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAE5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IAEnD,YACmB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,oBAAoB,CAAC,GAAG,CAAC,EAWpD;IAED,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAEtD;IAED,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/C;IAED,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAElE;IAEK,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAc3D;IAED,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAE7B;IAED,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhC;IAED,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5B;IAED,MAAM,IAAI,aAAa,CAAC,GAAG,CAAC,CAE3B;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAErD;IAED,MAAM,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjD;IAED,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAED,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvB;IAED,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED,sGAAsG;YACxF,GAAG;CAQlB"}

package/dist/read-model/knex-read-model-table.js

@@ -0,0 +1,83 @@
+import { PostgresReadModelRebuild, } from '@ddd-ts-kit/kernel';
+import { criteriaToKnex } from './criteria-to-knex.js';
+import { KnexStampedRows } from './knex-stamped-rows.js';
+import { predicateToKnex } from './predicate-to-knex.js';
+import { recordsOf } from './records-of.js';
+import { RowMapper } from './row.mapper.js';
+/**
+ * The table of one read model on knex: what `TableReadModelStore` and `ProjectionRebuild` are
+ * given. Every statement runs on the executor of the context, so a write made by a projection
+ * commits with the processed mark of its event. The rebuild is PostgreSQL only.
+ */
+export class KnexReadModelTable {
+    context;
+    options;
+    rows;
+    copy;
+    rebuild;
+    constructor(context, options) {
+        this.context = context;
+        this.options = options;
+        const { table, schema } = options;
+        this.rows = new KnexStampedRows(context, options);
+        this.copy = new KnexStampedRows(context, { ...options, table: PostgresReadModelRebuild.shadowOf(table) });
+        this.rebuild = new PostgresReadModelRebuild((statement, parameters) => this.run(statement, parameters), {
+            table,
+            ...(schema === undefined ? {} : { schema }),
+        });
+    }
+    find(key) {
+        return this.rows.find(key);
+    }
+    insert(entry) {
+        return this.rows.insert(entry);
+    }
+    replace(entry, held) {
+        return this.rows.replace(entry, held);
+    }
+    async search(plan) {
+        const { columns } = this.options;
+        const mapper = new RowMapper(columns);
+        const kept = () => this.rows.table().where('deleted', false);
+        const answered = await criteriaToKnex(kept().select(Object.values(columns)), plan, columns);
+        const rows = recordsOf(answered).map((record) => mapper.toRow(record));
+        if (plan.kind === 'cursor') {
+            return { rows };
+        }
+        const counted = await predicateToKnex(kept(), plan.filter, columns).count({ total: '*' });
+        return { rows, total: Number(recordsOf(counted)[0]?.['total'] ?? 0) };
+    }
+    rebuilding() {
+        return this.rebuild.rebuilding();
+    }
+    touch(key) {
+        return this.rebuild.touch(key);
+    }
+    beginRebuild() {
+        return this.rebuild.begin();
+    }
+    shadow() {
+        return this.copy;
+    }
+    touched(limit) {
+        return this.rebuild.touched(limit);
+    }
+    settle(keys) {
+        return this.rebuild.settle(keys);
+    }
+    holdWriters() {
+        return this.rebuild.holdWriters();
+    }
+    promote() {
+        return this.rebuild.promote();
+    }
+    abandonRebuild() {
+        return this.rebuild.abandon();
+    }
+    /** knex writes its bindings `?`: the statements of the rebuild name each of theirs once, in order. */
+    async run(statement, parameters) {
+        const result = await this.context.executor().raw(statement.replace(/\$\d+/g, '?'), [...parameters]);
+        return recordsOf(typeof result === 'object' && result !== null && 'rows' in result ? result.rows : []);
+    }
+}
+//# sourceMappingURL=knex-read-model-table.js.map

package/dist/read-model/knex-read-model-table.js.map

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

package/dist/read-model/knex-stamped-rows.d.ts

@@ -0,0 +1,19 @@
+import type { Knex } from 'knex';
+import type { EventStamp, ReadModelRows, StampedRow } from '@ddd-ts-kit/kernel';
+import type { KnexContext } from '../unit-of-work/knex-context.js';
+import type { KnexReadModelOptions } from './knex-read-model-options.js';
+/** The stamped rows of one table, the copy of a rebuild as well as the table itself. */
+export declare class KnexStampedRows<Row extends object> implements ReadModelRows<Row> {
+    private readonly context;
+    private readonly options;
+    private readonly mapper;
+    constructor(context: KnexContext, options: KnexReadModelOptions<Row>);
+    find(key: string): Promise<StampedRow<Row> | undefined>;
+    insert(entry: StampedRow<Row>): Promise<boolean>;
+    replace(entry: StampedRow<Row>, held: EventStamp): Promise<boolean>;
+    /** The table, on the executor of the current unit of work. */
+    table(): Knex.QueryBuilder;
+    private recordOf;
+    private keyColumn;
+}
+//# sourceMappingURL=knex-stamped-rows.d.ts.map

package/dist/read-model/knex-stamped-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex-stamped-rows.d.ts","sourceRoot":"","sources":["../../src/read-model/knex-stamped-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAIzE,wFAAwF;AACxF,qBAAa,eAAe,CAAC,GAAG,SAAS,MAAM,CAAE,YAAW,aAAa,CAAC,GAAG,CAAC;IAI1E,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAExC,YACmB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,oBAAoB,CAAC,GAAG,CAAC,EAGpD;IAEK,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAmB5D;IAEK,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CASrD;IAEK,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAQxE;IAED,8DAA8D;IAC9D,KAAK,IAAI,IAAI,CAAC,YAAY,CAKzB;IAED,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,SAAS;CAGlB"}

package/dist/read-model/knex-stamped-rows.js

@@ -0,0 +1,68 @@
+import { insertIgnoringConflict } from '../sql/insert-ignoring-conflict.js';
+import { recordsOf } from './records-of.js';
+import { RowMapper } from './row.mapper.js';
+/** The stamped rows of one table, the copy of a rebuild as well as the table itself. */
+export class KnexStampedRows {
+    context;
+    options;
+    mapper;
+    constructor(context, options) {
+        this.context = context;
+        this.options = options;
+        this.mapper = new RowMapper(options.columns);
+    }
+    async find(key) {
+        const answered = await this.table().where(this.keyColumn(), key).limit(1);
+        const [record] = recordsOf(answered);
+        if (record === undefined) {
+            return undefined;
+        }
+        const version = record['last_event_version'];
+        return {
+            key,
+            row: record['deleted'] === true ? undefined : this.mapper.toRow(record),
+            stamp: {
+                eventId: String(record['last_event_id']),
+                occurredAt: new Date(String(record['last_event_at'])),
+                ...(version === null || version === undefined ? {} : { version: Number(version) }),
+            },
+        };
+    }
+    async insert(entry) {
+        if (entry.row === undefined) {
+            return false;
+        }
+        return insertIgnoringConflict(this.context.executor(), this.table(), {
+            row: this.recordOf(entry),
+            conflict: this.keyColumn(),
+        });
+    }
+    async replace(entry, held) {
+        const replaced = await this.table()
+            .where(this.keyColumn(), entry.key)
+            .where('last_event_id', held.eventId)
+            .where('last_event_at', held.occurredAt)
+            .update(this.recordOf(entry));
+        return Number(replaced) === 1;
+    }
+    /** The table, on the executor of the current unit of work. */
+    table() {
+        const { table, schema } = this.options;
+        const builder = this.context.executor()(table);
+        return schema === undefined ? builder : builder.withSchema(schema);
+    }
+    recordOf({ key, row, stamp }) {
+        return {
+            ...(row === undefined ? {} : this.mapper.toRecord(row)),
+            [this.keyColumn()]: key,
+            last_event_id: stamp.eventId,
+            last_event_at: stamp.occurredAt,
+            last_event_version: stamp.version ?? null,
+            deleted: row === undefined,
+        };
+    }
+    keyColumn() {
+        return this.options.keyColumn ?? 'id';
+    }
+}
+//# sourceMappingURL=knex-stamped-rows.js.map

package/dist/read-model/knex-stamped-rows.js.map

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

package/dist/read-model/like-pattern.d.ts

@@ -0,0 +1,4 @@
+import type { FilterOperator } from '@ddd-ts-kit/kernel';
+/** The `LIKE` pattern of a text search, the text itself taken literally: `%`, `_` and `\` are escaped by `\`. */
+export declare function likePattern(operator: FilterOperator, text: string): string;
+//# sourceMappingURL=like-pattern.d.ts.map

package/dist/read-model/like-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"like-pattern.d.ts","sourceRoot":"","sources":["../../src/read-model/like-pattern.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,iHAAiH;AACjH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI1E"}

package/dist/read-model/like-pattern.js

@@ -0,0 +1,6 @@
+/** The `LIKE` pattern of a text search, the text itself taken literally: `%`, `_` and `\` are escaped by `\`. */
+export function likePattern(operator, text) {
+    const literal = text.replace(/[\\%_]/g, (special) => `\\${special}`);
+    return operator === 'startsWith' ? `${literal}%` : `%${literal}%`;
+}
+//# sourceMappingURL=like-pattern.js.map

package/dist/read-model/like-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"like-pattern.js","sourceRoot":"","sources":["../../src/read-model/like-pattern.ts"],"names":[],"mappings":"AAEA,iHAAiH;AACjH,MAAM,UAAU,WAAW,CAAC,QAAwB,EAAE,IAAY;IAChE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAErE,OAAO,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC;AACpE,CAAC"}

package/dist/read-model/predicate-to-knex.d.ts

@@ -0,0 +1,11 @@
+import type { Knex } from 'knex';
+import type { Predicate } from '@ddd-ts-kit/kernel';
+type Columns = Readonly<Record<string, string>>;
+/**
+ * Adds a predicate of a criteria plan to a query, as one parenthesised condition. Every
+ * value is a binding and every column comes from the mapping of the adapter: nothing a caller
+ * wrote is ever part of the statement.
+ */
+export declare function predicateToKnex<Builder extends Knex.QueryBuilder>(builder: Builder, predicate: Predicate | undefined, columns: Columns): Builder;
+export {};
+//# sourceMappingURL=predicate-to-knex.d.ts.map

package/dist/read-model/predicate-to-knex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate-to-knex.d.ts","sourceRoot":"","sources":["../../src/read-model/predicate-to-knex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAc,SAAS,EAAiB,MAAM,oBAAoB,CAAC;AAI/E,KAAK,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAIhD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,SAAS,IAAI,CAAC,YAAY,EAC/D,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,EAAE,OAAO,GACf,OAAO,CAUT"}

package/dist/read-model/predicate-to-knex.js

@@ -0,0 +1,63 @@
+import { columnOf } from './column-of.js';
+import { likePattern } from './like-pattern.js';
+const COMPARISONS = { eq: '=', ne: '<>', gt: '>', gte: '>=', lt: '<', lte: '<=' };
+/**
+ * Adds a predicate of a criteria plan to a query, as one parenthesised condition. Every
+ * value is a binding and every column comes from the mapping of the adapter: nothing a caller
+ * wrote is ever part of the statement.
+ */
+export function predicateToKnex(builder, predicate, columns) {
+    if (predicate === undefined) {
+        return builder;
+    }
+    void builder.where((group) => {
+        held(group, predicate, columns);
+    });
+    return builder;
+}
+function held(builder, predicate, columns) {
+    if (predicate.kind === 'test') {
+        tested(builder, predicate, columnOf(columns, predicate.field));
+        return;
+    }
+    for (const part of predicate.parts) {
+        const nested = (group) => {
+            held(group, part, columns);
+        };
+        void (predicate.kind === 'and' ? builder.andWhere(nested) : builder.orWhere(nested));
+    }
+}
+function tested(builder, test, column) {
+    if (test.operator === 'isNull') {
+        void (test.value === true ? builder.whereNull(column) : builder.whereNotNull(column));
+    }
+    else if (test.negated) {
+        void builder.whereNot((refuted) => {
+            compared(refuted, test, column);
+        });
+    }
+    else {
+        compared(builder, test, column);
+    }
+}
+function compared(builder, { operator, value }, column) {
+    const values = typeof value === 'object' && !(value instanceof Date) ? [...value] : [value];
+    const [first = null, second = null] = values;
+    switch (operator) {
+        case 'in':
+            void builder.whereIn(column, values);
+            break;
+        case 'between':
+            void builder.whereBetween(column, [first, second]);
+            break;
+        case 'contains':
+        case 'startsWith':
+            void builder.whereRaw('?? like ? escape ?', [column, likePattern(operator, String(first)), '\\']);
+            break;
+        case 'isNull':
+            break;
+        default:
+            void builder.where(column, COMPARISONS[operator], first);
+    }
+}
+//# sourceMappingURL=predicate-to-knex.js.map

package/dist/read-model/predicate-to-knex.js.map

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

package/dist/read-model/read-model-columns.d.ts

@@ -0,0 +1,8 @@
+import type { Knex } from 'knex';
+/**
+ * Adds to a read model table the columns a projection orders its events by, under the same
+ * names in every project: `last_event_id`, `last_event_at`, `last_event_version` and `deleted`,
+ * the trace a removed row leaves so that a late event does not bring it back.
+ */
+export declare function readModelColumns(table: Knex.CreateTableBuilder): void;
+//# sourceMappingURL=read-model-columns.d.ts.map

package/dist/read-model/read-model-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-model-columns.d.ts","sourceRoot":"","sources":["../../src/read-model/read-model-columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAIjC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAKrE"}

package/dist/read-model/read-model-columns.js

@@ -0,0 +1,14 @@
+import { INDEXABLE_LENGTH } from '../columns/indexable-length.js';
+import { INSTANT } from '../columns/instant.js';
+/**
+ * Adds to a read model table the columns a projection orders its events by, under the same
+ * names in every project: `last_event_id`, `last_event_at`, `last_event_version` and `deleted`,
+ * the trace a removed row leaves so that a late event does not bring it back.
+ */
+export function readModelColumns(table) {
+    table.string('last_event_id', INDEXABLE_LENGTH).notNullable();
+    table.datetime('last_event_at', INSTANT).notNullable();
+    table.bigInteger('last_event_version').nullable();
+    table.boolean('deleted').notNullable().defaultTo(false);
+}
+//# sourceMappingURL=read-model-columns.js.map

package/dist/read-model/read-model-columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-model-columns.js","sourceRoot":"","sources":["../../src/read-model/read-model-columns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA8B;IAC7D,KAAK,CAAC,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9D,KAAK,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClD,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,3 @@
+/** What a driver answered, as records: anything else is left out. */
+export declare function recordsOf(answered: unknown): Readonly<Record<string, unknown>>[];
+//# sourceMappingURL=records-of.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"records-of.d.ts","sourceRoot":"","sources":["../../src/read-model/records-of.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAIhF"}

package/dist/read-model/records-of.js

@@ -0,0 +1,9 @@
+/** What a driver answered, as records: anything else is left out. */
+export function recordsOf(answered) {
+    const records = Array.isArray(answered) ? answered : [];
+    return records.filter(isRecord);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=records-of.js.map

package/dist/read-model/records-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records-of.js","sourceRoot":"","sources":["../../src/read-model/records-of.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,UAAU,SAAS,CAAC,QAAiB;IACzC,MAAM,OAAO,GAAuB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5E,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/read-model/row.mapper.d.ts

@@ -0,0 +1,8 @@
+/** Translates between the row of a read model, keyed by field, and the record of its table, keyed by column. */
+export declare class RowMapper<Row extends object> {
+    private readonly columns;
+    constructor(columns: Readonly<Record<string, string>>);
+    toRow(record: Readonly<Record<string, unknown>>): Row;
+    toRecord(row: Row): Record<string, unknown>;
+}
+//# sourceMappingURL=row.mapper.d.ts.map

package/dist/read-model/row.mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row.mapper.d.ts","sourceRoot":"","sources":["../../src/read-model/row.mapper.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,qBAAa,SAAS,CAAC,GAAG,SAAS,MAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAI;IAE1E,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,GAAG,CAIpD;IAED,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ1C;CACF"}

package/dist/read-model/row.mapper.js

@@ -0,0 +1,17 @@
+/** Translates between the row of a read model, keyed by field, and the record of its table, keyed by column. */
+export class RowMapper {
+    columns;
+    constructor(columns) {
+        this.columns = columns;
+    }
+    toRow(record) {
+        return Object.fromEntries(Object.entries(this.columns).map(([field, column]) => [field, record[column] ?? null]));
+    }
+    toRecord(row) {
+        return Object.fromEntries(Object.entries(this.columns).map(([field, column]) => {
+            const value = Reflect.get(row, field);
+            return [column, value === undefined ? null : value];
+        }));
+    }
+}
+//# sourceMappingURL=row.mapper.js.map

package/dist/read-model/row.mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row.mapper.js","sourceRoot":"","sources":["../../src/read-model/row.mapper.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,MAAM,OAAO,SAAS;IACS,OAAO;IAApC,YAA6B,OAAyC;uBAAzC,OAAO;IAAqC,CAAC;IAE1E,KAAK,CAAC,MAAyC;QAC7C,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAChF,CAAC;IACX,CAAC;IAED,QAAQ,CAAC,GAAQ;QACf,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE;YACnD,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAE/C,OAAO,CAAC,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}

package/dist/sql/dialect-of.d.ts

@@ -0,0 +1,4 @@
+import type { Knex } from 'knex';
+import type { SqlDialect } from './sql-dialect.js';
+export declare function dialectOf(knex: Knex): SqlDialect;
+//# sourceMappingURL=dialect-of.d.ts.map

package/dist/sql/dialect-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect-of.d.ts","sourceRoot":"","sources":["../../src/sql/dialect-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAkBhD"}

package/dist/sql/dialect-of.js

@@ -0,0 +1,17 @@
+export function dialectOf(knex) {
+    // `client.dialect` is the name knex itself gives the dialect, whatever driver is behind it.
+    const client = knex.client;
+    const name = typeof client === 'object' && client !== null && 'dialect' in client ? client.dialect : undefined;
+    switch (name) {
+        case 'postgresql':
+        case 'cockroachdb':
+            return 'postgres';
+        case 'mysql':
+            return 'mysql';
+        case 'sqlite3':
+            return 'sqlite';
+        default:
+            return 'other';
+    }
+}
+//# sourceMappingURL=dialect-of.js.map

package/dist/sql/dialect-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect-of.js","sourceRoot":"","sources":["../../src/sql/dialect-of.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,4FAA4F;IAC5F,MAAM,MAAM,GAAY,IAAI,CAAC,MAAM,CAAC;IAEpC,MAAM,IAAI,GACR,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAEpG,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY,CAAC;QAClB,KAAK,aAAa;YAChB,OAAO,UAAU,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/sql/insert-ignoring-conflict.d.ts

@@ -0,0 +1,16 @@
+import type { Knex } from 'knex';
+export interface IgnoringInsert {
+    readonly row: Readonly<Record<string, unknown>>;
+    /** The column or columns of the key that may already exist. */
+    readonly conflict: string | readonly string[];
+}
+/**
+ * Inserts one row unless its key already exists, and says whether it did insert. Unlike
+ * catching the unique violation, it leaves the surrounding transaction usable on PostgreSQL.
+ * It serves the processed-event store and the first save of an aggregate alike.
+ *
+ * `table` is the query builder of the target table, built on `executor`:
+ * `insertIgnoringConflict(db, db('invoices').withSchema('billing'), { row, conflict: 'id' })`.
+ */
+export declare function insertIgnoringConflict(executor: Knex, table: Knex.QueryBuilder, { row, conflict }: IgnoringInsert): Promise<boolean>;
+//# sourceMappingURL=insert-ignoring-conflict.d.ts.map

package/dist/sql/insert-ignoring-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-ignoring-conflict.d.ts","sourceRoot":"","sources":["../../src/sql/insert-ignoring-conflict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGjC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,IAAI,EACd,KAAK,EAAE,IAAI,CAAC,YAAY,EACxB,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,cAAc,GAChC,OAAO,CAAC,OAAO,CAAC,CAYlB"}