actor-ts 0.9.1 → 0.11.0

package/dist/persistence/journals/PostgresJournalOptions.js

@@ -0,0 +1,44 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link PostgresJournalOptionsType}:
+ *
+ *     new PostgresJournal(PostgresJournalOptions.create().withUrl('postgres://…').withEventsTable('journal'))
+ *
+ * The connection fields (`withUrl` / `withPoolConfig` / `withPool`) come
+ * from the shared {@link PostgresConnection} mixin; pass a pre-built
+ * `withPool(...)` to share ONE pool across the journal, snapshot, and
+ * durable-state stores.
+ */
+export class PostgresJournalOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new PostgresJournalOptionsBuilder()`. */
+    static create() {
+        return new PostgresJournalOptionsBuilder();
+    }
+    /** Connection string, e.g. `postgres://user:pass@host:5432/db`. */
+    withUrl(url) {
+        return this.set('url', url);
+    }
+    /** Extra node-postgres `Pool` config, merged over `{ connectionString: url }`. */
+    withPoolConfig(poolConfig) {
+        return this.set('poolConfig', poolConfig);
+    }
+    /** Pre-built pool — bypasses the lazy `pg` import; share it across stores. */
+    withPool(pool) {
+        return this.set('pool', pool);
+    }
+    /** Events table name.  Default: `events`. */
+    withEventsTable(eventsTable) {
+        return this.set('eventsTable', eventsTable);
+    }
+    /** Tags join table name.  Default: `${eventsTable}_tags`. */
+    withTagsTable(tagsTable) {
+        return this.set('tagsTable', tagsTable);
+    }
+    /** Run `CREATE TABLE IF NOT EXISTS` on first use.  Default: true. */
+    withAutoCreateTables(autoCreateTables) {
+        return this.set('autoCreateTables', autoCreateTables);
+    }
+}
+/** Value alias so `PostgresJournalOptions.create()` / `new PostgresJournalOptions()` resolve to the builder. */
+export const PostgresJournalOptions = PostgresJournalOptionsBuilder;
+//# sourceMappingURL=PostgresJournalOptions.js.map

package/dist/persistence/journals/PostgresJournalOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresJournalOptions.js","sourceRoot":"","sources":["../../../src/persistence/journals/PostgresJournalOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAY9D;;;;;;;;;GASG;AACH,MAAM,OAAO,6BAA8B,SAAQ,cAA0C;IAC3F,mFAAmF;IACnF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,6BAA6B,EAAE,CAAC;IAC7C,CAAC;IAED,mEAAmE;IACnE,OAAO,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,kFAAkF;IAClF,cAAc,CAAC,UAAmC;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,8EAA8E;IAC9E,QAAQ,CAAC,IAAgB;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,6CAA6C;IAC7C,eAAe,CAAC,WAAmB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,6DAA6D;IAC7D,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,qEAAqE;IACrE,oBAAoB,CAAC,gBAAyB;QAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IACxD,CAAC;CACF;AAOD,gHAAgH;AAChH,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC"}

package/dist/persistence/journals/PostgresPlugin.d.ts

@@ -0,0 +1,32 @@
+import type { PersistenceExtension } from '../PersistenceExtension.js';
+import { PostgresDurableStateStore } from '../durable-state-stores/PostgresDurableStateStore.js';
+import type { RegisterPostgresPluginsOptions } from './PostgresPluginOptions.js';
+/** Canonical plug-in IDs for the Postgres journal, snapshot, and durable-state stores. */
+export declare const POSTGRES_JOURNAL_PLUGIN_ID = "actor-ts.persistence.journal.postgres";
+export declare const POSTGRES_SNAPSHOT_PLUGIN_ID = "actor-ts.persistence.snapshot-store.postgres";
+export declare const POSTGRES_DURABLE_STATE_PLUGIN_ID = "actor-ts.persistence.durable-state.postgres";
+export interface PostgresPluginHandles {
+    /**
+     * The DurableState store instance.  `PersistenceExtension` carries no
+     * DurableState registry (same as the object-storage plugin), so callers
+     * who want DurableState read this from the return value and pass it into
+     * their `DurableStateActor` options.
+     */
+    readonly durableStateStore: PostgresDurableStateStore;
+}
+/**
+ * One-shot registration of the Postgres journal + snapshot store against
+ * the running `PersistenceExtension`, returning a ready-to-use
+ * DurableState store handle.  Mirrors `registerCassandraPlugins` /
+ * `registerObjectStoragePlugins`.
+ *
+ * After this call, activate the journal + snapshot store via:
+ *   `actor-ts.persistence.journal.plugin = "actor-ts.persistence.journal.postgres"`
+ *   `actor-ts.persistence.snapshot-store.plugin = "actor-ts.persistence.snapshot-store.postgres"`
+ * either via HOCON or a `{ config: { ... } }` override.
+ *
+ * Pass `pool` to share a single connection pool across all three stores
+ * (recommended when they target the same DB).
+ */
+export declare function registerPostgresPlugins(ext: PersistenceExtension, options?: RegisterPostgresPluginsOptions): PostgresPluginHandles;
+//# sourceMappingURL=PostgresPlugin.d.ts.map

package/dist/persistence/journals/PostgresPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresPlugin.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/PostgresPlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAKvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAC;AAEjG,OAAO,KAAK,EAAE,8BAA8B,EAAsC,MAAM,4BAA4B,CAAC;AAErH,0FAA0F;AAC1F,eAAO,MAAM,0BAA0B,0CAA0C,CAAC;AAClF,eAAO,MAAM,2BAA2B,iDAAiD,CAAC;AAC1F,eAAO,MAAM,gCAAgC,gDAAgD,CAAC;AAE9F,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;CACvD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,oBAAoB,EACzB,OAAO,GAAE,8BAAmC,GAC3C,qBAAqB,CAoBvB"}

package/dist/persistence/journals/PostgresPlugin.js

@@ -0,0 +1,35 @@
+import { PostgresJournal } from './PostgresJournal.js';
+import { PostgresSnapshotStore } from '../snapshot-stores/PostgresSnapshotStore.js';
+import { PostgresDurableStateStore } from '../durable-state-stores/PostgresDurableStateStore.js';
+/** Canonical plug-in IDs for the Postgres journal, snapshot, and durable-state stores. */
+export const POSTGRES_JOURNAL_PLUGIN_ID = 'actor-ts.persistence.journal.postgres';
+export const POSTGRES_SNAPSHOT_PLUGIN_ID = 'actor-ts.persistence.snapshot-store.postgres';
+export const POSTGRES_DURABLE_STATE_PLUGIN_ID = 'actor-ts.persistence.durable-state.postgres';
+/**
+ * One-shot registration of the Postgres journal + snapshot store against
+ * the running `PersistenceExtension`, returning a ready-to-use
+ * DurableState store handle.  Mirrors `registerCassandraPlugins` /
+ * `registerObjectStoragePlugins`.
+ *
+ * After this call, activate the journal + snapshot store via:
+ *   `actor-ts.persistence.journal.plugin = "actor-ts.persistence.journal.postgres"`
+ *   `actor-ts.persistence.snapshot-store.plugin = "actor-ts.persistence.snapshot-store.postgres"`
+ * either via HOCON or a `{ config: { ... } }` override.
+ *
+ * Pass `pool` to share a single connection pool across all three stores
+ * (recommended when they target the same DB).
+ */
+export function registerPostgresPlugins(ext, options = {}) {
+    const resolvedOptions = options;
+    // Resolve each leaf to a plain object and merge the shared pool (when
+    // set) onto it — no more mutating nested builders.  A missing leaf falls
+    // back to an empty object so the shared pool still reaches every store.
+    const journal = { ...(resolvedOptions.journal ?? {}), ...(resolvedOptions.pool ? { pool: resolvedOptions.pool } : {}) };
+    const snapshotStore = { ...(resolvedOptions.snapshotStore ?? {}), ...(resolvedOptions.pool ? { pool: resolvedOptions.pool } : {}) };
+    const durableState = { ...(resolvedOptions.durableStateStore ?? {}), ...(resolvedOptions.pool ? { pool: resolvedOptions.pool } : {}) };
+    ext.registerJournal(POSTGRES_JOURNAL_PLUGIN_ID, (_system) => new PostgresJournal(journal));
+    ext.registerSnapshotStore(POSTGRES_SNAPSHOT_PLUGIN_ID, (_system) => new PostgresSnapshotStore(snapshotStore));
+    const durableStateStore = new PostgresDurableStateStore(durableState);
+    return { durableStateStore };
+}
+//# sourceMappingURL=PostgresPlugin.js.map

package/dist/persistence/journals/PostgresPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresPlugin.js","sourceRoot":"","sources":["../../../src/persistence/journals/PostgresPlugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAEpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAC;AAIjG,0FAA0F;AAC1F,MAAM,CAAC,MAAM,0BAA0B,GAAG,uCAAuC,CAAC;AAClF,MAAM,CAAC,MAAM,2BAA2B,GAAG,8CAA8C,CAAC;AAC1F,MAAM,CAAC,MAAM,gCAAgC,GAAG,6CAA6C,CAAC;AAY9F;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAyB,EACzB,UAA0C,EAAE;IAE5C,MAAM,eAAe,GAAI,OAA8C,CAAC;IAExE,sEAAsE;IACtE,yEAAyE;IACzE,wEAAwE;IACxE,MAAM,OAAO,GAAG,EAAE,GAAI,CAAC,eAAe,CAAC,OAAO,IAAI,EAAE,CAAyC,EAAE,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACjK,MAAM,aAAa,GAAG,EAAE,GAAI,CAAC,eAAe,CAAC,aAAa,IAAI,EAAE,CAA+C,EAAE,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACnL,MAAM,YAAY,GAAG,EAAE,GAAI,CAAC,eAAe,CAAC,iBAAiB,IAAI,EAAE,CAAmD,EAAE,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAE1L,GAAG,CAAC,eAAe,CACjB,0BAA0B,EAC1B,CAAC,OAAoB,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC,CACvD,CAAC;IACF,GAAG,CAAC,qBAAqB,CACvB,2BAA2B,EAC3B,CAAC,OAAoB,EAAE,EAAE,CAAC,IAAI,qBAAqB,CAAC,aAAa,CAAC,CACnE,CAAC;IACF,MAAM,iBAAiB,GAAG,IAAI,yBAAyB,CAAC,YAAY,CAAC,CAAC;IACtE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC/B,CAAC"}

package/dist/persistence/journals/PostgresPluginOptions.d.ts

@@ -0,0 +1,54 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import type { PgPoolLike } from './PostgresClient.js';
+import type { PostgresJournalOptions } from './PostgresJournalOptions.js';
+import type { PostgresSnapshotStoreOptions } from '../snapshot-stores/PostgresSnapshotStoreOptions.js';
+import type { PostgresDurableStateStoreOptions } from '../durable-state-stores/PostgresDurableStateStoreOptions.js';
+export interface RegisterPostgresPluginsOptionsType {
+    /**
+     * Shared connection pool injected into all three stores.  When provided,
+     * the journal + snapshot + durable-state stores reuse ONE pool (the
+     * usual case — they target the same database).  When omitted, each store
+     * lazily builds its own pool from its `url` / `poolConfig`.
+     */
+    readonly pool?: PgPoolLike;
+    /** Journal-specific options (table names, autoCreate, and connection if no shared `pool`). */
+    readonly journal?: PostgresJournalOptions;
+    /** Snapshot-store-specific options. */
+    readonly snapshotStore?: PostgresSnapshotStoreOptions;
+    /** Durable-state-store-specific options.  Defaults to a fresh builder (uses the shared `pool`). */
+    readonly durableStateStore?: PostgresDurableStateStoreOptions;
+}
+/**
+ * Fluent builder for {@link RegisterPostgresPluginsOptionsType}:
+ *
+ *     registerPostgresPlugins(ext, RegisterPostgresPluginsOptions.create()
+ *       .withPool(pool)
+ *       .withJournal(PostgresJournalOptions.create().withEventsTable('journal'))
+ *       .withSnapshotStore(PostgresSnapshotStoreOptions.create().withKeepN(5)))
+ *
+ * The shared `withPool(...)` is merged onto each store's resolved options
+ * by {@link registerPostgresPlugins}, so a leaf builder carries only its
+ * store-specific fields.  Each leaf setter accepts EITHER the leaf builder
+ * OR a plain object of the leaf's options.
+ */
+export declare class RegisterPostgresPluginsOptionsBuilder extends OptionsBuilder<RegisterPostgresPluginsOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new RegisterPostgresPluginsOptionsBuilder()`. */
+    static create(): RegisterPostgresPluginsOptionsBuilder;
+    /** Shared connection pool injected into all three stores. */
+    withPool(pool: PgPoolLike): this;
+    /** Journal-specific options (table names, autoCreate, and connection if no shared pool). */
+    withJournal(journal: PostgresJournalOptions): this;
+    /** Snapshot-store-specific options. */
+    withSnapshotStore(snapshotStore: PostgresSnapshotStoreOptions): this;
+    /** Durable-state-store-specific options.  Defaults to a fresh builder (uses the shared pool). */
+    withDurableStateStore(durableStateStore: PostgresDurableStateStoreOptions): this;
+}
+/**
+ * Accepted input for {@link registerPostgresPlugins}: the fluent
+ * {@link RegisterPostgresPluginsOptionsBuilder} OR a plain
+ * {@link RegisterPostgresPluginsOptionsType} object.
+ */
+export type RegisterPostgresPluginsOptions = RegisterPostgresPluginsOptionsBuilder | Partial<RegisterPostgresPluginsOptionsType>;
+/** Value alias so `RegisterPostgresPluginsOptions.create()` / `new RegisterPostgresPluginsOptions()` resolve to the builder. */
+export declare const RegisterPostgresPluginsOptions: typeof RegisterPostgresPluginsOptionsBuilder;
+//# sourceMappingURL=PostgresPluginOptions.d.ts.map

package/dist/persistence/journals/PostgresPluginOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresPluginOptions.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/PostgresPluginOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AACvG,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,6DAA6D,CAAC;AAEpH,MAAM,WAAW,kCAAkC;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C,uCAAuC;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,4BAA4B,CAAC;IACtD,mGAAmG;IACnG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gCAAgC,CAAC;CAC/D;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,qCAAsC,SAAQ,cAAc,CAAC,kCAAkC,CAAC;IAC3G,2FAA2F;IAC3F,MAAM,CAAC,MAAM,IAAI,qCAAqC;IAItD,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIhC,4FAA4F;IAC5F,WAAW,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAIlD,uCAAuC;IACvC,iBAAiB,CAAC,aAAa,EAAE,4BAA4B,GAAG,IAAI;IAIpE,iGAAiG;IACjG,qBAAqB,CAAC,iBAAiB,EAAE,gCAAgC,GAAG,IAAI;CAGjF;AAED;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GACtC,qCAAqC,GACrC,OAAO,CAAC,kCAAkC,CAAC,CAAC;AAChD,gIAAgI;AAChI,eAAO,MAAM,8BAA8B,8CAAwC,CAAC"}

package/dist/persistence/journals/PostgresPluginOptions.js

@@ -0,0 +1,39 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link RegisterPostgresPluginsOptionsType}:
+ *
+ *     registerPostgresPlugins(ext, RegisterPostgresPluginsOptions.create()
+ *       .withPool(pool)
+ *       .withJournal(PostgresJournalOptions.create().withEventsTable('journal'))
+ *       .withSnapshotStore(PostgresSnapshotStoreOptions.create().withKeepN(5)))
+ *
+ * The shared `withPool(...)` is merged onto each store's resolved options
+ * by {@link registerPostgresPlugins}, so a leaf builder carries only its
+ * store-specific fields.  Each leaf setter accepts EITHER the leaf builder
+ * OR a plain object of the leaf's options.
+ */
+export class RegisterPostgresPluginsOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new RegisterPostgresPluginsOptionsBuilder()`. */
+    static create() {
+        return new RegisterPostgresPluginsOptionsBuilder();
+    }
+    /** Shared connection pool injected into all three stores. */
+    withPool(pool) {
+        return this.set('pool', pool);
+    }
+    /** Journal-specific options (table names, autoCreate, and connection if no shared pool). */
+    withJournal(journal) {
+        return this.set('journal', journal);
+    }
+    /** Snapshot-store-specific options. */
+    withSnapshotStore(snapshotStore) {
+        return this.set('snapshotStore', snapshotStore);
+    }
+    /** Durable-state-store-specific options.  Defaults to a fresh builder (uses the shared pool). */
+    withDurableStateStore(durableStateStore) {
+        return this.set('durableStateStore', durableStateStore);
+    }
+}
+/** Value alias so `RegisterPostgresPluginsOptions.create()` / `new RegisterPostgresPluginsOptions()` resolve to the builder. */
+export const RegisterPostgresPluginsOptions = RegisterPostgresPluginsOptionsBuilder;
+//# sourceMappingURL=PostgresPluginOptions.js.map

package/dist/persistence/journals/PostgresPluginOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresPluginOptions.js","sourceRoot":"","sources":["../../../src/persistence/journals/PostgresPluginOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAsB9D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,qCAAsC,SAAQ,cAAkD;IAC3G,2FAA2F;IAC3F,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,qCAAqC,EAAE,CAAC;IACrD,CAAC;IAED,6DAA6D;IAC7D,QAAQ,CAAC,IAAgB;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,4FAA4F;IAC5F,WAAW,CAAC,OAA+B;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,uCAAuC;IACvC,iBAAiB,CAAC,aAA2C;QAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,iGAAiG;IACjG,qBAAqB,CAAC,iBAAmD;QACvE,OAAO,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;IAC1D,CAAC;CACF;AAUD,gIAAgI;AAChI,MAAM,CAAC,MAAM,8BAA8B,GAAG,qCAAqC,CAAC"}

package/dist/persistence/journals/SqliteJournal.d.ts

@@ -1,21 +1,7 @@
-import { type SqliteDriver } from '../../runtime/sqlite/index.js';
 import { type JournalEventBus } from '../JournalEventBus.js';
 import type { Journal } from '../Journal.js';
 import { type PersistentEvent } from '../JournalTypes.js';
-export interface SqliteJournalOptions {
-    /** File path (absolute or relative) or ":memory:" for an ephemeral DB. */
-    readonly path?: string;
-    /** Table name for events.  Default: `events`. */
-    readonly eventsTable?: string;
-    /** If true, opens the DB with WAL mode enabled. */
-    readonly wal?: boolean;
-    /**
-     * Explicit driver — useful for tests or when you want to pin a
-     * specific SQLite backend.  Default: auto-detect via `getSqliteDriver()`
-     * (Bun → `bun:sqlite`, Node → `better-sqlite3`).
-     */
-    readonly driver?: SqliteDriver;
-}
+import type { SqliteJournalOptions } from './SqliteJournalOptions.js';
 /**
  * Journal backed by SQLite — zero-dependency, single-file persistence.
  *
@@ -26,9 +12,9 @@ export interface SqliteJournalOptions {
  *
  * Construction is lazy: the native DB is opened on the first `append` /
  * `read` / `highestSeq` / `delete` / `persistenceIds` call.  This keeps
- * `new SqliteJournal({ path })` sync-friendly (matches the pre-abstraction
- * shape) while still supporting the async driver-resolution flow Node
- * requires.
+ * `new SqliteJournal(SqliteJournalOptions.create().withPath(path))`
+ * sync-friendly (matches the pre-abstraction shape) while still
+ * supporting the async driver-resolution flow Node requires.
  */
 export declare class SqliteJournal implements Journal {
     private readonly options;

package/dist/persistence/journals/SqliteJournal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SqliteJournal.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/SqliteJournal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,YAAY,EAAwB,MAAM,+BAA+B,CAAC;AACxH,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC;AAiBD;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAkC;IAElE,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,GAAE,oBAAyB;IAKxC,MAAM,CAAC,CAAC,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAoD1B,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IA+BpF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,UAAU;YAOV,IAAI;IAmElB;;;;;;;;OAQG;IACH,OAAO,CAAC,yBAAyB;CAwBlC"}
+{"version":3,"file":"SqliteJournal.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/SqliteJournal.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,oBAAoB,EAA4B,MAAM,2BAA2B,CAAC;AAiBhG;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAkC;IAElE,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,GAAE,oBAAyB;IASxC,MAAM,CAAC,CAAC,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAoD1B,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IA+BpF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,UAAU;YAOV,IAAI;IAmElB;;;;;;;;OAQG;IACH,OAAO,CAAC,yBAAyB;CAwBlC"}

package/dist/persistence/journals/SqliteJournal.js

@@ -1,6 +1,7 @@
 import { getSqliteDriver } from '../../runtime/sqlite/index.js';
 import { InProcessJournalEventBus } from '../JournalEventBus.js';
 import { JournalConcurrencyError, JournalError, } from '../JournalTypes.js';
+import { assertSafeIdentifier } from '../storage/SqlIdentifier.js';
 /**
  * Journal backed by SQLite — zero-dependency, single-file persistence.
  *
@@ -11,9 +12,9 @@ import { JournalConcurrencyError, JournalError, } from '../JournalTypes.js';
  *
  * Construction is lazy: the native DB is opened on the first `append` /
  * `read` / `highestSeq` / `delete` / `persistenceIds` call.  This keeps
- * `new SqliteJournal({ path })` sync-friendly (matches the pre-abstraction
- * shape) while still supporting the async driver-resolution flow Node
- * requires.
+ * `new SqliteJournal(SqliteJournalOptions.create().withPath(path))`
+ * sync-friendly (matches the pre-abstraction shape) while still
+ * supporting the async driver-resolution flow Node requires.
  */
 export class SqliteJournal {
     options;
@@ -31,8 +32,12 @@ export class SqliteJournal {
     stmts = null;
     initPromise = null;
     constructor(options = {}) {
-        this.options = options;
-        this.table = options.eventsTable ?? 'events';
+        const resolvedOptions = options;
+        this.options = resolvedOptions;
+        // Table name is interpolated into DDL/DML (can't be bound) — validate it
+        // so a config-sourced identifier can't inject SQL (security audit #6).
+        // The `_tags` sibling is derived from this validated name, so it's safe too.
+        this.table = assertSafeIdentifier(resolvedOptions.eventsTable ?? 'events', 'events table');
     }
     async append(pid, events, expectedSeq, tags) {
         await this.ensureOpen();
@@ -212,10 +217,10 @@ export class SqliteJournal {
         if (rows.length === 0)
             return;
         const fill = db.transaction((items) => {
-            for (const r of items) {
-                const tagList = r.tags.split(',').filter((t) => t.length > 0);
+            for (const row of items) {
+                const tagList = row.tags.split(',').filter((t) => t.length > 0);
                 for (const tag of tagList) {
-                    stmts.insertTag.run(r.persistence_id, r.sequence_nr, tag, r.timestamp);
+                    stmts.insertTag.run(row.persistence_id, row.sequence_nr, tag, row.timestamp);
                 }
             }
         });

package/dist/persistence/journals/SqliteJournal.js.map

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

package/dist/persistence/journals/SqliteJournalOptions.d.ts

@@ -0,0 +1,41 @@
+import type { SqliteDriver } from '../../runtime/sqlite/index.js';
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+export interface SqliteJournalOptionsType {
+    /** File path (absolute or relative) or ":memory:" for an ephemeral DB. */
+    readonly path?: string;
+    /** Table name for events.  Default: `events`. */
+    readonly eventsTable?: string;
+    /** If true, opens the DB with WAL mode enabled. */
+    readonly wal?: boolean;
+    /**
+     * Explicit driver — useful for tests or when you want to pin a
+     * specific SQLite backend.  Default: auto-detect via `getSqliteDriver()`
+     * (Bun → `bun:sqlite`, Node → `better-sqlite3`).
+     */
+    readonly driver?: SqliteDriver;
+}
+/**
+ * Fluent builder for {@link SqliteJournalOptionsType}:
+ *
+ *     new SqliteJournal(SqliteJournalOptions.create().withPath(':memory:').withWal(true))
+ */
+export declare class SqliteJournalOptionsBuilder extends OptionsBuilder<SqliteJournalOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new SqliteJournalOptionsBuilder()`. */
+    static create(): SqliteJournalOptionsBuilder;
+    /** File path (absolute or relative) or ":memory:" for an ephemeral DB. */
+    withPath(path: string): this;
+    /** Table name for events.  Default: `events`. */
+    withEventsTable(eventsTable: string): this;
+    /** If true, opens the DB with WAL mode enabled. */
+    withWal(wal?: boolean): this;
+    /** Explicit driver — pin a specific SQLite backend (defaults to auto-detect). */
+    withDriver(driver: SqliteDriver): this;
+}
+/**
+ * Accepted input for any SQLite-journal constructor: the fluent
+ * {@link SqliteJournalOptionsBuilder} OR a plain {@link SqliteJournalOptionsType} object.
+ */
+export type SqliteJournalOptions = SqliteJournalOptionsBuilder | Partial<SqliteJournalOptionsType>;
+/** Value alias so `SqliteJournalOptions.create()` / `new SqliteJournalOptions()` resolve to the builder. */
+export declare const SqliteJournalOptions: typeof SqliteJournalOptionsBuilder;
+//# sourceMappingURL=SqliteJournalOptions.d.ts.map

package/dist/persistence/journals/SqliteJournalOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteJournalOptions.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/SqliteJournalOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,wBAAwB,CAAC;IACvF,iFAAiF;IACjF,MAAM,CAAC,MAAM,IAAI,2BAA2B;IAI5C,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,iDAAiD;IACjD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI1C,mDAAmD;IACnD,OAAO,CAAC,GAAG,UAAO,GAAG,IAAI;IAIzB,iFAAiF;IACjF,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;CAGvC;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;AACnG,4GAA4G;AAC5G,eAAO,MAAM,oBAAoB,oCAA8B,CAAC"}

package/dist/persistence/journals/SqliteJournalOptions.js

@@ -0,0 +1,31 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link SqliteJournalOptionsType}:
+ *
+ *     new SqliteJournal(SqliteJournalOptions.create().withPath(':memory:').withWal(true))
+ */
+export class SqliteJournalOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new SqliteJournalOptionsBuilder()`. */
+    static create() {
+        return new SqliteJournalOptionsBuilder();
+    }
+    /** File path (absolute or relative) or ":memory:" for an ephemeral DB. */
+    withPath(path) {
+        return this.set('path', path);
+    }
+    /** Table name for events.  Default: `events`. */
+    withEventsTable(eventsTable) {
+        return this.set('eventsTable', eventsTable);
+    }
+    /** If true, opens the DB with WAL mode enabled. */
+    withWal(wal = true) {
+        return this.set('wal', wal);
+    }
+    /** Explicit driver — pin a specific SQLite backend (defaults to auto-detect). */
+    withDriver(driver) {
+        return this.set('driver', driver);
+    }
+}
+/** Value alias so `SqliteJournalOptions.create()` / `new SqliteJournalOptions()` resolve to the builder. */
+export const SqliteJournalOptions = SqliteJournalOptionsBuilder;
+//# sourceMappingURL=SqliteJournalOptions.js.map

package/dist/persistence/journals/SqliteJournalOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteJournalOptions.js","sourceRoot":"","sources":["../../../src/persistence/journals/SqliteJournalOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAiB9D;;;;GAIG;AACH,MAAM,OAAO,2BAA4B,SAAQ,cAAwC;IACvF,iFAAiF;IACjF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,2BAA2B,EAAE,CAAC;IAC3C,CAAC;IAED,0EAA0E;IAC1E,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,iDAAiD;IACjD,eAAe,CAAC,WAAmB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,mDAAmD;IACnD,OAAO,CAAC,GAAG,GAAG,IAAI;QAChB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,iFAAiF;IACjF,UAAU,CAAC,MAAoB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAOD,4GAA4G;AAC5G,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC"}

package/dist/persistence/migration/MigrationChain.js

@@ -148,11 +148,11 @@ export class MigrationChain {
      * from its `toJournal`.
      */
     toJournalAt(current, writeVersion) {
-        const v = writeVersion ?? this._currentVersion;
+        const version = writeVersion ?? this._currentVersion;
         return {
             manifest: this._manifest,
-            version: v,
-            payload: v === this._currentVersion ? current : this.downcast(current, v),
+            version,
+            payload: version === this._currentVersion ? current : this.downcast(current, version),
         };
     }
 }

package/dist/persistence/migration/MigrationChain.js.map

@@ -1 +1 @@
-{"version":3,"file":"MigrationChain.js","sourceRoot":"","sources":["../../../src/persistence/migration/MigrationChain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MigrationChain.js","sourceRoot":"","sources":["../../../src/persistence/migration/MigrationChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA4B/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,cAAc;IAKN;IACA;IALF,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IACzC,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE7D,YACmB,SAAiB,EACjB,eAAuB;QADvB,cAAS,GAAT,SAAS,CAAQ;QACjB,oBAAe,GAAf,eAAe,CAAQ;QAExC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,iEAAiE,eAAe,EAAE,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IAED,0FAA0F;IAC1F,MAAM,CAAC,GAAG,CAAI,QAAgB,EAAE,cAAsB;QACpD,OAAO,IAAI,cAAc,CAAI,QAAQ,EAAE,cAAc,CAAC,CAAC;IACzD,CAAC;IAED,wDAAwD;IACxD,GAAG,CAAO,IAAyB;QACjC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,gDAAgD,IAAI,CAAC,WAAW,iBAAiB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACrH,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,CAAC,SAAS,gCAAgC,IAAI,CAAC,eAAe,EAAE,CAC/F,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,kDAAkD,IAAI,CAAC,WAAW,QAAQ,QAAQ,CAAC,SAAS,uBAAuB,CACpH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAqB,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAO,IAAwB;QACpC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,gDAAgD,IAAI,CAAC,WAAW,iBAAiB,IAAI,CAAC,SAAS,EAAE,CAClG,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,WAAW,gCAAgC,IAAI,CAAC,eAAe,EAAE,CAClG,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,SAAS,8BAA8B,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,wDAAwD,IAAI,CAAC,WAAW,QAAQ,QAAQ,CAAC,SAAS,uBAAuB,CAC1H,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAoB,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uCAAuC;IACvC,IAAI,QAAQ,KAAa,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAEjD,sDAAsD;IACtD,IAAI,cAAc,KAAa,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;IAE7D,4EAA4E;IAC5E,MAAM,CAAC,MAAmB;QACxB,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,cAAc,CACtB,oCAAoC,IAAI,CAAC,SAAS,WAAW,MAAM,CAAC,QAAQ,GAAG,EAC/E,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAChC,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,MAAM,IAAI,cAAc,CACtB,qBAAqB,MAAM,CAAC,QAAQ,WAAW,MAAM,CAAC,OAAO,QAAQ,IAAI,CAAC,eAAe,EAAE,EAC3F,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAChC,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;QAC5B,IAAI,OAAO,GAAY,MAAM,CAAC,OAAO,CAAC;QACtC,OAAO,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,cAAc,CACtB,+BAA+B,MAAM,CAAC,QAAQ,kBAAkB,MAAM,GAAG;sBACvE,YAAY,IAAI,CAAC,eAAe,2CAA2C,MAAM,EAAE,EACrF,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAChC,CAAC;YACJ,CAAC;YACD,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC/B,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,CAAC;QACD,OAAO,OAAkB,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,OAAgB,EAAE,aAAqB;QAC9C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,cAAc,CACtB,iDAAiD,aAAa,EAAE,EAChE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CACrC,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YACzC,MAAM,IAAI,cAAc,CACtB,oBAAoB,IAAI,CAAC,SAAS,mBAAmB,IAAI,CAAC,eAAe,QAAQ,aAAa,mBAAmB,EACjH,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CACrC,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC;QAClC,IAAI,OAAO,GAAY,OAAO,CAAC;QAC/B,OAAO,MAAM,GAAG,aAAa,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,cAAc,CACtB,iCAAiC,IAAI,CAAC,SAAS,kBAAkB,MAAM,GAAG;sBACxE,YAAY,aAAa,0CAA0C,MAAM,EAAE,EAC7E,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CACrC,CAAC;YACJ,CAAC;YACD,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,OAAgB,EAAE,YAAqB;QACjD,MAAM,OAAO,GAAG,YAAY,IAAI,IAAI,CAAC,eAAe,CAAC;QACrD,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,OAAO;YACP,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;SACtF,CAAC;IACJ,CAAC;CACF"}

package/dist/persistence/migration/SchemaRegistry.js

@@ -57,16 +57,16 @@ export class InMemorySchemaRegistry {
         if (!bucket || bucket.size === 0)
             return undefined;
         let latest = -Infinity;
-        for (const v of bucket.keys())
-            if (v > latest)
-                latest = v;
+        for (const version of bucket.keys())
+            if (version > latest)
+                latest = version;
         return latest === -Infinity ? undefined : latest;
     }
     list() {
         const out = [];
         for (const bucket of this.entries.values()) {
-            for (const d of bucket.values())
-                out.push(d);
+            for (const descriptor of bucket.values())
+                out.push(descriptor);
         }
         return out;
     }
@@ -89,13 +89,13 @@ export class InMemorySchemaRegistry {
                 }
                 let value = startDesc.codec.decode(stored.payload);
                 const latest = this.latestVersion(stored.manifest);
-                for (let v = stored.version + 1; v <= latest; v++) {
-                    const desc = this.get(stored.manifest, v);
+                for (let version = stored.version + 1; version <= latest; version++) {
+                    const desc = this.get(stored.manifest, version);
                     if (!desc) {
-                        throw new MigrationError(`SchemaRegistry: gap on the upcast path for '${stored.manifest}': v${v} not registered`, stored.manifest, stored.version);
+                        throw new MigrationError(`SchemaRegistry: gap on the upcast path for '${stored.manifest}': v${version} not registered`, stored.manifest, stored.version);
                     }
                     if (!desc.upcastFromPrev) {
-                        throw new MigrationError(`SchemaRegistry: ${stored.manifest}@v${v} has no upcastFromPrev — cannot bring v${stored.version} forward`, stored.manifest, stored.version);
+                        throw new MigrationError(`SchemaRegistry: ${stored.manifest}@v${version} has no upcastFromPrev — cannot bring v${stored.version} forward`, stored.manifest, stored.version);
                     }
                     value = desc.upcastFromPrev(value);
                 }

package/dist/persistence/migration/SchemaRegistry.js.map

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

package/dist/persistence/migration/defaultsAdapter.js

@@ -56,10 +56,10 @@ function validateSpec(spec) {
     if (!Number.isInteger(spec.currentVersion) || spec.currentVersion < 1) {
         throw new Error(`defaultsAdapter currentVersion must be a positive integer, got ${spec.currentVersion}`);
     }
-    for (const k of Object.keys(spec.defaults)) {
-        const fromVersion = Number(k);
+    for (const key of Object.keys(spec.defaults)) {
+        const fromVersion = Number(key);
         if (!Number.isInteger(fromVersion) || fromVersion < 1) {
-            throw new Error(`defaultsAdapter defaults keys must be positive integers, got '${k}'`);
+            throw new Error(`defaultsAdapter defaults keys must be positive integers, got '${key}'`);
         }
         if (fromVersion >= spec.currentVersion) {
             throw new Error(`defaultsAdapter has defaults for v${fromVersion} but currentVersion is ${spec.currentVersion} `
@@ -75,10 +75,10 @@ function validateSpec(spec) {
         }
         // Every step in (writeVersion, currentVersion] must have a defaults
         // entry — that's where we know which fields to strip on write.
-        for (let v = spec.writeVersion; v < spec.currentVersion; v++) {
-            if (!spec.defaults[v]) {
+        for (let version = spec.writeVersion; version < spec.currentVersion; version++) {
+            if (!spec.defaults[version]) {
                 throw new Error(`defaultsAdapter writeVersion=${spec.writeVersion} requires defaults entries for every `
-                    + `step on the path to currentVersion=${spec.currentVersion}; missing defaults[${v}]`);
+                    + `step on the path to currentVersion=${spec.currentVersion}; missing defaults[${version}]`);
             }
         }
     }
@@ -91,8 +91,8 @@ function upcastByDefaults(stored, spec) {
         throw new MigrationError(`cannot downgrade '${stored.manifest}' from v${stored.version} to v${spec.currentVersion}`, stored.manifest, stored.version);
     }
     let payload = stored.payload;
-    for (let v = stored.version; v < spec.currentVersion; v++) {
-        const fill = spec.defaults[v];
+    for (let version = stored.version; version < spec.currentVersion; version++) {
+        const fill = spec.defaults[version];
         if (fill)
             payload = { ...fill, ...payload };
     }
@@ -106,8 +106,8 @@ function upcastByDefaults(stored, spec) {
  */
 function downcastByDefaults(current, spec, targetVersion) {
     let payload = { ...current };
-    for (let v = spec.currentVersion - 1; v >= targetVersion; v--) {
-        const fields = spec.defaults[v];
+    for (let version = spec.currentVersion - 1; version >= targetVersion; version--) {
+        const fields = spec.defaults[version];
         if (!fields)
             continue;
         for (const key of Object.keys(fields)) {