actor-ts 0.9.1 → 0.11.0

package/dist/persistence/journals/CassandraJournalOptions.js

@@ -0,0 +1,101 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import { OptionsValidator } from '../../util/OptionsValidator.js';
+/**
+ * Fluent builder for {@link CassandraJournalOptionsType}:
+ *
+ *     new CassandraJournal(
+ *       CassandraJournalOptions.create()
+ *         .withContactPoints(['10.0.0.1'])
+ *         .withKeyspace('app')
+ *         .withUseTagIndex(true),
+ *     )
+ *
+ * Carries `withX` methods for the shared {@link CassandraConnection}
+ * fields too — the connection mixin is not built on its own; each
+ * concrete store exposes its connection surface directly.
+ */
+export class CassandraJournalOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new CassandraJournalOptionsBuilder()`. */
+    static create() {
+        return new CassandraJournalOptionsBuilder();
+    }
+    /* --- shared CassandraConnection fields --- */
+    /** Node(s) to seed the cluster topology from. */
+    withContactPoints(contactPoints) {
+        return this.set('contactPoints', contactPoints);
+    }
+    /** Local DC — required for DCAwareRoundRobinPolicy.  Defaults to `datacenter1`. */
+    withLocalDataCenter(localDataCenter) {
+        return this.set('localDataCenter', localDataCenter);
+    }
+    /** Keyspace to `USE` after connect.  Must already exist, or pass `withAutoCreateKeyspace(true)`. */
+    withKeyspace(keyspace) {
+        return this.set('keyspace', keyspace);
+    }
+    /** Username/password for PLAIN auth. */
+    withCredentials(username, password) {
+        return this.set('credentials', { username, password });
+    }
+    /** Port — defaults to 9042. */
+    withPort(port) {
+        return this.set('port', port);
+    }
+    /** If true, create the keyspace on startup (simple strategy, rf=1). */
+    withAutoCreateKeyspace(autoCreateKeyspace = true) {
+        return this.set('autoCreateKeyspace', autoCreateKeyspace);
+    }
+    /** Replication options used by autoCreateKeyspace.  Ignored otherwise. */
+    withReplication(replication) {
+        return this.set('replication', replication);
+    }
+    /** CQL consistency level for all reads and writes.  Default `LOCAL_QUORUM` (6). */
+    withConsistency(consistency) {
+        return this.set('consistency', consistency);
+    }
+    /* --- journal-specific fields --- */
+    /** Table name for events.  Default: `events`. */
+    withEventsTable(eventsTable) {
+        return this.set('eventsTable', eventsTable);
+    }
+    /** Table tracking the highest sequence number per pid.  Default: `metadata`. */
+    withMetadataTable(metadataTable) {
+        return this.set('metadataTable', metadataTable);
+    }
+    /** Lookup table for `persistenceIds()`.  Default: `all_persistence_ids`. */
+    withAllIdsTable(allIdsTable) {
+        return this.set('allIdsTable', allIdsTable);
+    }
+    /** Tag-index side table populated when `useTagIndex` is set.  Default: `events_by_tag`. */
+    withTagIndexTable(tagIndexTable) {
+        return this.set('tagIndexTable', tagIndexTable);
+    }
+    /** Rows per partition before rolling over to a new one.  Default: 500_000. */
+    withPartitionSize(partitionSize) {
+        return this.set('partitionSize', partitionSize);
+    }
+    /** Auto-create the events/metadata/all-ids tables on first connect. */
+    withAutoCreateTables(autoCreateTables = true) {
+        return this.set('autoCreateTables', autoCreateTables);
+    }
+    /** Opt in to maintaining an `events_by_tag` side table for indexed `eventsByTag` queries (#44). */
+    withUseTagIndex(useTagIndex = true) {
+        return this.set('useTagIndex', useTagIndex);
+    }
+    /** Inject a pre-built client instead of letting the journal instantiate `cassandra-driver` itself. */
+    withClient(client) {
+        return this.set('client', client);
+    }
+}
+/** Validates resolved {@link CassandraJournalOptionsType} settings. */
+export class CassandraJournalOptionsValidator extends OptionsValidator {
+    constructor() {
+        super('CassandraJournalOptions');
+    }
+    rules(_s) {
+        this.port('port'); // real Cassandra CQL port (default 9042)
+        this.positiveInt('partitionSize');
+    }
+}
+/** Value alias so `CassandraJournalOptions.create()` / `new CassandraJournalOptions()` resolve to the builder. */
+export const CassandraJournalOptions = CassandraJournalOptionsBuilder;
+//# sourceMappingURL=CassandraJournalOptions.js.map

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

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

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

@@ -1,23 +1,8 @@
 import type { PersistenceExtension } from '../PersistenceExtension.js';
-import { type CassandraJournalOptions } from './CassandraJournal.js';
-import { type CassandraSnapshotStoreOptions } from '../snapshot-stores/CassandraSnapshotStore.js';
-import type { CassandraClientLike } from './CassandraClient.js';
+import type { RegisterCassandraPluginsOptions } from './CassandraPluginOptions.js';
 /** Canonical plug-in IDs for the Cassandra journal and snapshot store. */
 export declare const CASSANDRA_JOURNAL_PLUGIN_ID = "actor-ts.persistence.journal.cassandra";
 export declare const CASSANDRA_SNAPSHOT_PLUGIN_ID = "actor-ts.persistence.snapshot-store.cassandra";
-export interface RegisterCassandraPluginsOptions {
-    /**
-     * Shared CQL client used by the journal AND the snapshot store.  When
-     * provided, both plug-ins reuse the same connection pool (one TCP
-     * connection tree per cluster node).  When omitted, each plug-in
-     * constructs its own client.
-     */
-    readonly client?: CassandraClientLike;
-    /** Journal-specific overrides. */
-    readonly journal: Omit<CassandraJournalOptions, 'client'>;
-    /** Snapshot-store-specific overrides.  Usually shares keyspace with the journal. */
-    readonly snapshotStore: Omit<CassandraSnapshotStoreOptions, 'client'>;
-}
 /**
  * One-shot registration of both the Cassandra/Scylla journal and the
  * matching snapshot store against the running `PersistenceExtension`.

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

@@ -1 +1 @@
-{"version":3,"file":"CassandraPlugin.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/CassandraPlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,2CAA2C,CAAC;AACpF,eAAO,MAAM,4BAA4B,kDAAkD,CAAC;AAE5F,MAAM,WAAW,+BAA+B;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;IAC1D,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,6BAA6B,EAAE,QAAQ,CAAC,CAAC;CACvE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,oBAAoB,EACzB,OAAO,EAAE,+BAA+B,GACvC,IAAI,CASN"}
+{"version":3,"file":"CassandraPlugin.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/CassandraPlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAKvE,OAAO,KAAK,EAAE,+BAA+B,EAAuC,MAAM,6BAA6B,CAAC;AAExH,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,2CAA2C,CAAC;AACpF,eAAO,MAAM,4BAA4B,kDAAkD,CAAC;AAE5F;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,oBAAoB,EACzB,OAAO,EAAE,+BAA+B,GACvC,IAAI,CAcN"}

package/dist/persistence/journals/CassandraPlugin.js

@@ -1,5 +1,5 @@
-import { CassandraJournal, } from './CassandraJournal.js';
-import { CassandraSnapshotStore, } from '../snapshot-stores/CassandraSnapshotStore.js';
+import { CassandraJournal } from './CassandraJournal.js';
+import { CassandraSnapshotStore } from '../snapshot-stores/CassandraSnapshotStore.js';
 /** Canonical plug-in IDs for the Cassandra journal and snapshot store. */
 export const CASSANDRA_JOURNAL_PLUGIN_ID = 'actor-ts.persistence.journal.cassandra';
 export const CASSANDRA_SNAPSHOT_PLUGIN_ID = 'actor-ts.persistence.snapshot-store.cassandra';
@@ -12,7 +12,12 @@ export const CASSANDRA_SNAPSHOT_PLUGIN_ID = 'actor-ts.persistence.snapshot-store
  * either via HOCON or a `{ config: { ... } }` override to make them active.
  */
 export function registerCassandraPlugins(ext, options) {
-    ext.registerJournal(CASSANDRA_JOURNAL_PLUGIN_ID, (_system) => new CassandraJournal({ ...options.journal, client: options.client }));
-    ext.registerSnapshotStore(CASSANDRA_SNAPSHOT_PLUGIN_ID, (_system) => new CassandraSnapshotStore({ ...options.snapshotStore, client: options.client }));
+    const resolvedOptions = options;
+    // Resolve each leaf to a plain object and merge the shared client (when
+    // set) onto it, so both plug-ins reuse one connection tree.
+    const journal = { ...(resolvedOptions.journal ?? {}), ...(resolvedOptions.client ? { client: resolvedOptions.client } : {}) };
+    const snapshotStore = { ...(resolvedOptions.snapshotStore ?? {}), ...(resolvedOptions.client ? { client: resolvedOptions.client } : {}) };
+    ext.registerJournal(CASSANDRA_JOURNAL_PLUGIN_ID, (_system) => new CassandraJournal(journal));
+    ext.registerSnapshotStore(CASSANDRA_SNAPSHOT_PLUGIN_ID, (_system) => new CassandraSnapshotStore(snapshotStore));
 }
 //# sourceMappingURL=CassandraPlugin.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"CassandraPlugin.js","sourceRoot":"","sources":["../../../src/persistence/journals/CassandraPlugin.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,GAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,GAEvB,MAAM,8CAA8C,CAAC;AAGtD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,2BAA2B,GAAG,wCAAwC,CAAC;AACpF,MAAM,CAAC,MAAM,4BAA4B,GAAG,+CAA+C,CAAC;AAgB5F;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAyB,EACzB,OAAwC;IAExC,GAAG,CAAC,eAAe,CACjB,2BAA2B,EAC3B,CAAC,OAAoB,EAAE,EAAE,CAAC,IAAI,gBAAgB,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAC/F,CAAC;IACF,GAAG,CAAC,qBAAqB,CACvB,4BAA4B,EAC5B,CAAC,OAAoB,EAAE,EAAE,CAAC,IAAI,sBAAsB,CAAC,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAC3G,CAAC;AACJ,CAAC"}
+{"version":3,"file":"CassandraPlugin.js","sourceRoot":"","sources":["../../../src/persistence/journals/CassandraPlugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAItF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,2BAA2B,GAAG,wCAAwC,CAAC;AACpF,MAAM,CAAC,MAAM,4BAA4B,GAAG,+CAA+C,CAAC;AAE5F;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAyB,EACzB,OAAwC;IAExC,MAAM,eAAe,GAAI,OAA+C,CAAC;IACzE,wEAAwE;IACxE,4DAA4D;IAC5D,MAAM,OAAO,GAAG,EAAE,GAAI,CAAC,eAAe,CAAC,OAAO,IAAI,EAAE,CAA0C,EAAE,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACxK,MAAM,aAAa,GAAG,EAAE,GAAI,CAAC,eAAe,CAAC,aAAa,IAAI,EAAE,CAAgD,EAAE,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1L,GAAG,CAAC,eAAe,CACjB,2BAA2B,EAC3B,CAAC,OAAoB,EAAE,EAAE,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,CACxD,CAAC;IACF,GAAG,CAAC,qBAAqB,CACvB,4BAA4B,EAC5B,CAAC,OAAoB,EAAE,EAAE,CAAC,IAAI,sBAAsB,CAAC,aAAa,CAAC,CACpE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,51 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import type { CassandraClientLike } from './CassandraClient.js';
+import type { CassandraJournalOptions } from './CassandraJournalOptions.js';
+import type { CassandraSnapshotStoreOptions } from '../snapshot-stores/CassandraSnapshotStoreOptions.js';
+export interface RegisterCassandraPluginsOptionsType {
+    /**
+     * Shared CQL client used by the journal AND the snapshot store.  When
+     * provided, both plug-ins reuse the same connection pool (one TCP
+     * connection tree per cluster node).  When omitted, each plug-in
+     * constructs its own client.
+     */
+    readonly client?: CassandraClientLike;
+    /** Journal-specific overrides. */
+    readonly journal: CassandraJournalOptions;
+    /** Snapshot-store-specific overrides.  Usually shares keyspace with the journal. */
+    readonly snapshotStore: CassandraSnapshotStoreOptions;
+}
+/**
+ * Fluent builder for {@link RegisterCassandraPluginsOptionsType}.  Each store
+ * takes its own leaf builder (or a plain object of its options); the
+ * shared {@link CassandraClientLike} is merged onto both leaves at
+ * registration time so a single connection tree serves the journal and
+ * snapshot store:
+ *
+ *     registerCassandraPlugins(
+ *       ext,
+ *       RegisterCassandraPluginsOptions.create()
+ *         .withClient(client)
+ *         .withJournal(CassandraJournalOptions.create().withContactPoints(['fake']).withKeyspace('app'))
+ *         .withSnapshotStore(CassandraSnapshotStoreOptions.create().withContactPoints(['fake']).withKeyspace('app')),
+ *     )
+ */
+export declare class RegisterCassandraPluginsOptionsBuilder extends OptionsBuilder<RegisterCassandraPluginsOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new RegisterCassandraPluginsOptionsBuilder()`. */
+    static create(): RegisterCassandraPluginsOptionsBuilder;
+    /** Shared CQL client reused by both plug-ins.  When omitted, each constructs its own. */
+    withClient(client: CassandraClientLike): this;
+    /** Journal-specific options builder. */
+    withJournal(journal: CassandraJournalOptions): this;
+    /** Snapshot-store-specific options builder. */
+    withSnapshotStore(snapshotStore: CassandraSnapshotStoreOptions): this;
+}
+/**
+ * Accepted input for {@link registerCassandraPlugins}: the fluent
+ * {@link RegisterCassandraPluginsOptionsBuilder} OR a plain
+ * {@link RegisterCassandraPluginsOptionsType} object.
+ */
+export type RegisterCassandraPluginsOptions = RegisterCassandraPluginsOptionsBuilder | Partial<RegisterCassandraPluginsOptionsType>;
+/** Value alias so `RegisterCassandraPluginsOptions.create()` / `new RegisterCassandraPluginsOptions()` resolve to the builder. */
+export declare const RegisterCassandraPluginsOptions: typeof RegisterCassandraPluginsOptionsBuilder;
+//# sourceMappingURL=CassandraPluginOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CassandraPluginOptions.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/CassandraPluginOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qDAAqD,CAAC;AAEzG,MAAM,WAAW,mCAAmC;IAClD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,6BAA6B,CAAC;CACvD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sCAAuC,SAAQ,cAAc,CAAC,mCAAmC,CAAC;IAC7G,4FAA4F;IAC5F,MAAM,CAAC,MAAM,IAAI,sCAAsC;IAIvD,yFAAyF;IACzF,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAI7C,wCAAwC;IACxC,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAInD,+CAA+C;IAC/C,iBAAiB,CAAC,aAAa,EAAE,6BAA6B,GAAG,IAAI;CAGtE;AAED;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GACvC,sCAAsC,GACtC,OAAO,CAAC,mCAAmC,CAAC,CAAC;AACjD,kIAAkI;AAClI,eAAO,MAAM,+BAA+B,+CAAyC,CAAC"}

package/dist/persistence/journals/CassandraPluginOptions.js

@@ -0,0 +1,37 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link RegisterCassandraPluginsOptionsType}.  Each store
+ * takes its own leaf builder (or a plain object of its options); the
+ * shared {@link CassandraClientLike} is merged onto both leaves at
+ * registration time so a single connection tree serves the journal and
+ * snapshot store:
+ *
+ *     registerCassandraPlugins(
+ *       ext,
+ *       RegisterCassandraPluginsOptions.create()
+ *         .withClient(client)
+ *         .withJournal(CassandraJournalOptions.create().withContactPoints(['fake']).withKeyspace('app'))
+ *         .withSnapshotStore(CassandraSnapshotStoreOptions.create().withContactPoints(['fake']).withKeyspace('app')),
+ *     )
+ */
+export class RegisterCassandraPluginsOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new RegisterCassandraPluginsOptionsBuilder()`. */
+    static create() {
+        return new RegisterCassandraPluginsOptionsBuilder();
+    }
+    /** Shared CQL client reused by both plug-ins.  When omitted, each constructs its own. */
+    withClient(client) {
+        return this.set('client', client);
+    }
+    /** Journal-specific options builder. */
+    withJournal(journal) {
+        return this.set('journal', journal);
+    }
+    /** Snapshot-store-specific options builder. */
+    withSnapshotStore(snapshotStore) {
+        return this.set('snapshotStore', snapshotStore);
+    }
+}
+/** Value alias so `RegisterCassandraPluginsOptions.create()` / `new RegisterCassandraPluginsOptions()` resolve to the builder. */
+export const RegisterCassandraPluginsOptions = RegisterCassandraPluginsOptionsBuilder;
+//# sourceMappingURL=CassandraPluginOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CassandraPluginOptions.js","sourceRoot":"","sources":["../../../src/persistence/journals/CassandraPluginOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAmB9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,sCAAuC,SAAQ,cAAmD;IAC7G,4FAA4F;IAC5F,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,sCAAsC,EAAE,CAAC;IACtD,CAAC;IAED,yFAAyF;IACzF,UAAU,CAAC,MAA2B;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,wCAAwC;IACxC,WAAW,CAAC,OAAgC;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,+CAA+C;IAC/C,iBAAiB,CAAC,aAA4C;QAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;CACF;AAUD,kIAAkI;AAClI,MAAM,CAAC,MAAM,+BAA+B,GAAG,sCAAsC,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * Minimal shapes of the `mariadb` connector API the MariaDB backends use.
+ * Own interfaces (no `@types`) so the framework stays dependency-free and
+ * tests can inject a fake.  The official `mariadb` connector speaks both
+ * MariaDB and MySQL.
+ *
+ * `query()` returns **either** an array of row objects (SELECT) **or** an
+ * OK-packet `{ affectedRows, insertId, warningStatus }` (INSERT/UPDATE/
+ * DELETE) — use `rowsOf` / `affectedRowsOf` to read each shape.  BIGINT
+ * columns may surface as `bigint`; every numeric read is `Number(...)`-
+ * coerced at the mapping boundary.
+ */
+export type MariaDbRow = Record<string, unknown>;
+export interface MariaDbOkPacket {
+    readonly affectedRows: number | bigint;
+    readonly insertId?: number | bigint;
+    readonly warningStatus?: number;
+}
+export type MariaDbResult = MariaDbRow[] | MariaDbOkPacket;
+export interface MariaDbConnectionLike {
+    query(sql: string, values?: ReadonlyArray<unknown>): Promise<MariaDbResult>;
+    beginTransaction(): Promise<void>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+    release(): void;
+}
+export interface MariaDbPoolLike {
+    query(sql: string, values?: ReadonlyArray<unknown>): Promise<MariaDbResult>;
+    /** Check out a dedicated connection for a multi-statement transaction. */
+    getConnection(): Promise<MariaDbConnectionLike>;
+    end(): Promise<void>;
+}
+/** Connection options shared by the three MariaDB stores. */
+export interface MariaDbConnection {
+    /** Connection URI passed straight to `createPool`, e.g. `mariadb://user:pass@host:3306/db`. */
+    readonly url?: string;
+    /** `createPool` config object (host/user/password/database/…); takes precedence over `url`. */
+    readonly poolConfig?: Record<string, unknown>;
+    /** Pre-built pool — shares one pool across the three stores, or injects a fake in tests. */
+    readonly pool?: MariaDbPoolLike;
+}
+/** Build (or pass through) the connection pool for a store. */
+export declare function buildMariaDbPool(conn: MariaDbConnection): Promise<MariaDbPoolLike>;
+/** Rows from a SELECT result (OK-packets yield `[]`). */
+export declare function rowsOf(res: MariaDbResult): MariaDbRow[];
+/** `affectedRows` from a DML OK-packet (arrays yield 0). */
+export declare function affectedRowsOf(res: MariaDbResult): number;
+/** MariaDB/MySQL duplicate-key error (errno 1062 / `ER_DUP_ENTRY`). */
+export declare function isDuplicateKeyError(e: unknown): boolean;
+/** Guard configurable table names against injection (see PostgresClient). */
+export declare function assertSafeIdentifier(name: string, what: string): string;
+/** Test hook — reset the cached lazy `mariadb` import. */
+export declare function resetMariaDbModuleCache(): void;
+//# sourceMappingURL=MariaDbClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MariaDbClient.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/MariaDbClient.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AACD,MAAM,MAAM,aAAa,GAAG,UAAU,EAAE,GAAG,eAAe,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5E,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5E,0EAA0E;IAC1E,aAAa,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAChD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAaD,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,+FAA+F;IAC/F,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,4FAA4F;IAC5F,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;CACjC;AAED,+DAA+D;AAC/D,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAKxF;AAED,yDAAyD;AACzD,wBAAgB,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,EAAE,CAEvD;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAGvD;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvE;AAED,0DAA0D;AAC1D,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/persistence/journals/MariaDbClient.js

@@ -0,0 +1,40 @@
+import { Lazy } from '../../util/Lazy.js';
+import { lazyImportModule } from '../../util/LazyImport.js';
+const mariadbLazy = Lazy.of(() => lazyImportModule('mariadb', {
+    context: 'The MariaDB persistence backends require',
+    installHint: 'npm install mariadb',
+}));
+/** Build (or pass through) the connection pool for a store. */
+export async function buildMariaDbPool(conn) {
+    if (conn.pool)
+        return conn.pool;
+    const mod = await mariadbLazy.get();
+    const arg = conn.poolConfig ?? conn.url ?? {};
+    return mod.createPool(arg);
+}
+/** Rows from a SELECT result (OK-packets yield `[]`). */
+export function rowsOf(res) {
+    return Array.isArray(res) ? res : [];
+}
+/** `affectedRows` from a DML OK-packet (arrays yield 0). */
+export function affectedRowsOf(res) {
+    return Array.isArray(res) ? 0 : Number(res.affectedRows ?? 0);
+}
+/** MariaDB/MySQL duplicate-key error (errno 1062 / `ER_DUP_ENTRY`). */
+export function isDuplicateKeyError(e) {
+    const err = e;
+    return err.errno === 1062 || err.code === 'ER_DUP_ENTRY';
+}
+/** Guard configurable table names against injection (see PostgresClient). */
+export function assertSafeIdentifier(name, what) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
+        throw new Error(`MariaDB: unsafe ${what} identifier ${JSON.stringify(name)} — `
+            + 'must match /^[A-Za-z_][A-Za-z0-9_]*$/.');
+    }
+    return name;
+}
+/** Test hook — reset the cached lazy `mariadb` import. */
+export function resetMariaDbModuleCache() {
+    mariadbLazy.reset();
+}
+//# sourceMappingURL=MariaDbClient.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MariaDbClient.js","sourceRoot":"","sources":["../../../src/persistence/journals/MariaDbClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAyC5D,MAAM,WAAW,GAAiC,IAAI,CAAC,EAAE,CACvD,GAAG,EAAE,CAAC,gBAAgB,CAAgB,SAAS,EAAE;IAC/C,OAAO,EAAE,0CAA0C;IACnD,WAAW,EAAE,qBAAqB;CACnC,CAAC,CACH,CAAC;AAYF,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAuB;IAC5D,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAChC,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC;IACpC,MAAM,GAAG,GAAqC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;IAChF,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,MAAM,CAAC,GAAkB;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,CAAU;IAC5C,MAAM,GAAG,GAAG,CAAsC,CAAC;IACnD,OAAO,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC;AAC3D,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,IAAY;IAC7D,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK;cAC7D,wCAAwC,CAC3C,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,uBAAuB;IACrC,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { Journal } from '../Journal.js';
+import { type PersistentEvent } from '../JournalTypes.js';
+import type { MariaDbJournalOptions } from './MariaDbJournalOptions.js';
+/**
+ * Journal backed by MariaDB / MySQL via the `mariadb` connector.  Sibling
+ * of `PostgresJournal` (separate implementation, MariaDB dialect): `?`
+ * placeholders, `INSERT IGNORE` for the tag dedup, `ER_DUP_ENTRY` (1062)
+ * as the optimistic-concurrency backstop, and `LONGTEXT`/`BIGINT` columns.
+ * Cross-process backend → no in-process event bus.
+ */
+export declare class MariaDbJournal implements Journal {
+    private readonly options;
+    private readonly table;
+    private readonly tagsTable;
+    private readonly autoCreate;
+    private pool;
+    private initPromise;
+    private closed;
+    constructor(options?: MariaDbJournalOptions);
+    append<E>(pid: string, events: ReadonlyArray<E>, expectedSeq: number, tags?: ReadonlyArray<string>): Promise<PersistentEvent<E>[]>;
+    read<E>(pid: string, fromSeq: number, toSeq?: number): Promise<PersistentEvent<E>[]>;
+    highestSeq(pid: string): Promise<number>;
+    delete(pid: string, toSeq: number): Promise<void>;
+    persistenceIds(): Promise<string[]>;
+    close(): Promise<void>;
+    private ensureOpen;
+    private init;
+}
+//# sourceMappingURL=MariaDbJournal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MariaDbJournal.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/MariaDbJournal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,KAAK,EAAE,qBAAqB,EAA6B,MAAM,4BAA4B,CAAC;AAUnG;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,OAAO;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IAErC,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,qBAA0B;IAUzC,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;IAyD1B,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;IAwBpF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASxC,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;YASd,UAAU;YAQV,IAAI;CA8BnB"}

package/dist/persistence/journals/MariaDbJournal.js

@@ -0,0 +1,161 @@
+import { JournalConcurrencyError, JournalError, } from '../JournalTypes.js';
+import { assertSafeIdentifier, buildMariaDbPool, isDuplicateKeyError, rowsOf, } from './MariaDbClient.js';
+/**
+ * Journal backed by MariaDB / MySQL via the `mariadb` connector.  Sibling
+ * of `PostgresJournal` (separate implementation, MariaDB dialect): `?`
+ * placeholders, `INSERT IGNORE` for the tag dedup, `ER_DUP_ENTRY` (1062)
+ * as the optimistic-concurrency backstop, and `LONGTEXT`/`BIGINT` columns.
+ * Cross-process backend → no in-process event bus.
+ */
+export class MariaDbJournal {
+    options;
+    table;
+    tagsTable;
+    autoCreate;
+    pool = null;
+    initPromise = null;
+    closed = false;
+    constructor(options = {}) {
+        const resolvedOptions = options;
+        this.options = resolvedOptions;
+        this.table = assertSafeIdentifier(resolvedOptions.eventsTable ?? 'events', 'events table');
+        this.tagsTable = assertSafeIdentifier(resolvedOptions.tagsTable ?? `${this.table}_tags`, 'tags table');
+        this.autoCreate = resolvedOptions.autoCreateTables ?? true;
+    }
+    async append(pid, events, expectedSeq, tags) {
+        if (events.length === 0)
+            return [];
+        const pool = await this.ensureOpen();
+        const conn = await pool.getConnection();
+        const now = Date.now();
+        try {
+            await conn.beginTransaction();
+            const head = rowsOf(await conn.query(`SELECT COALESCE(MAX(sequence_nr), 0) AS hi FROM ${this.table} WHERE persistence_id = ?`, [pid]));
+            const actualSeq = Number(head[0].hi);
+            if (actualSeq !== expectedSeq) {
+                await conn.rollback();
+                throw new JournalConcurrencyError(pid, expectedSeq, actualSeq);
+            }
+            const out = [];
+            const tagString = tags && tags.length ? tags.join(',') : null;
+            let seq = actualSeq;
+            for (const ev of events) {
+                seq++;
+                await conn.query(`INSERT INTO ${this.table}(persistence_id, sequence_nr, payload, tags, timestamp) VALUES (?, ?, ?, ?, ?)`, [pid, seq, JSON.stringify(ev), tagString, now]);
+                if (tags) {
+                    for (const tag of tags) {
+                        if (tag.length === 0)
+                            continue;
+                        await conn.query(`INSERT IGNORE INTO ${this.tagsTable}(persistence_id, sequence_nr, tag, timestamp) VALUES (?, ?, ?, ?)`, [pid, seq, tag, now]);
+                    }
+                }
+                out.push({
+                    persistenceId: pid,
+                    sequenceNr: seq,
+                    event: ev,
+                    timestamp: now,
+                    tags: tags ? [...tags] : undefined,
+                });
+            }
+            await conn.commit();
+            return out;
+        }
+        catch (e) {
+            try {
+                await conn.rollback();
+            }
+            catch { /* already rolled back */ }
+            if (e instanceof JournalConcurrencyError)
+                throw e;
+            if (isDuplicateKeyError(e)) {
+                const actual = await this.highestSeq(pid).catch(() => expectedSeq);
+                throw new JournalConcurrencyError(pid, expectedSeq, actual);
+            }
+            throw new JournalError(`MariaDbJournal.append failed: ${e.message}`, e);
+        }
+        finally {
+            conn.release();
+        }
+    }
+    async read(pid, fromSeq, toSeq) {
+        const pool = await this.ensureOpen();
+        try {
+            const rows = rowsOf(toSeq === undefined
+                ? await pool.query(`SELECT persistence_id, sequence_nr, payload, tags, timestamp FROM ${this.table} WHERE persistence_id = ? AND sequence_nr >= ? ORDER BY sequence_nr ASC`, [pid, fromSeq])
+                : await pool.query(`SELECT persistence_id, sequence_nr, payload, tags, timestamp FROM ${this.table} WHERE persistence_id = ? AND sequence_nr >= ? AND sequence_nr <= ? ORDER BY sequence_nr ASC`, [pid, fromSeq, toSeq]));
+            return rows.map((r) => ({
+                persistenceId: r.persistence_id,
+                sequenceNr: Number(r.sequence_nr),
+                event: JSON.parse(r.payload),
+                timestamp: Number(r.timestamp),
+                tags: r.tags ? String(r.tags).split(',') : undefined,
+            }));
+        }
+        catch (e) {
+            throw new JournalError(`MariaDbJournal.read failed: ${e.message}`, e);
+        }
+    }
+    async highestSeq(pid) {
+        const pool = await this.ensureOpen();
+        const rows = rowsOf(await pool.query(`SELECT COALESCE(MAX(sequence_nr), 0) AS hi FROM ${this.table} WHERE persistence_id = ?`, [pid]));
+        return Number(rows[0].hi);
+    }
+    async delete(pid, toSeq) {
+        const pool = await this.ensureOpen();
+        await pool.query(`DELETE FROM ${this.tagsTable} WHERE persistence_id = ? AND sequence_nr <= ?`, [pid, toSeq]);
+        await pool.query(`DELETE FROM ${this.table} WHERE persistence_id = ? AND sequence_nr <= ?`, [pid, toSeq]);
+    }
+    async persistenceIds() {
+        const pool = await this.ensureOpen();
+        const rows = rowsOf(await pool.query(`SELECT DISTINCT persistence_id FROM ${this.table}`));
+        return rows.map((r) => r.persistence_id);
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        try {
+            await this.pool?.end();
+        }
+        catch { /* ignore */ }
+        this.pool = null;
+    }
+    /* --------------------------- internals -------------------------------- */
+    async ensureOpen() {
+        if (this.closed)
+            throw new JournalError('MariaDbJournal is closed');
+        if (this.pool)
+            return this.pool;
+        if (!this.initPromise)
+            this.initPromise = this.init();
+        await this.initPromise;
+        return this.pool;
+    }
+    async init() {
+        const pool = await buildMariaDbPool(this.options);
+        if (this.autoCreate) {
+            // Indexes declared inline — `CREATE INDEX IF NOT EXISTS` isn't
+            // portable across MariaDB/MySQL versions, but inline INDEX in
+            // CREATE TABLE is.
+            await pool.query(`CREATE TABLE IF NOT EXISTS ${this.table} (
+           persistence_id VARCHAR(255) NOT NULL,
+           sequence_nr    BIGINT NOT NULL,
+           payload        LONGTEXT NOT NULL,
+           tags           TEXT,
+           timestamp      BIGINT NOT NULL,
+           PRIMARY KEY (persistence_id, sequence_nr),
+           INDEX idx_${this.table}_pid (persistence_id)
+         )`);
+            await pool.query(`CREATE TABLE IF NOT EXISTS ${this.tagsTable} (
+           persistence_id VARCHAR(255) NOT NULL,
+           sequence_nr    BIGINT NOT NULL,
+           tag            VARCHAR(255) NOT NULL,
+           timestamp      BIGINT NOT NULL,
+           PRIMARY KEY (tag, timestamp, persistence_id, sequence_nr),
+           INDEX idx_${this.tagsTable}_pid_seq (persistence_id, sequence_nr)
+         )`);
+        }
+        this.pool = pool;
+    }
+}
+//# sourceMappingURL=MariaDbJournal.js.map

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

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

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

@@ -0,0 +1,43 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import type { MariaDbPoolLike, MariaDbConnection } from './MariaDbClient.js';
+export interface MariaDbJournalOptionsType extends MariaDbConnection {
+    /** Events table name.  Default: `events`. */
+    readonly eventsTable?: string;
+    /** Tags join table name.  Default: `${eventsTable}_tags`. */
+    readonly tagsTable?: string;
+    /** Run `CREATE TABLE IF NOT EXISTS` on first use.  Default: true. */
+    readonly autoCreateTables?: boolean;
+}
+/**
+ * Fluent builder for {@link MariaDbJournalOptionsType}:
+ *
+ *     new MariaDbJournal(MariaDbJournalOptions.create().withUrl('mariadb://…').withEventsTable('journal'))
+ *
+ * The connection fields (`withUrl` / `withPoolConfig` / `withPool`) come
+ * from the shared {@link MariaDbConnection} mixin; the rest are journal
+ * specific.
+ */
+export declare class MariaDbJournalOptionsBuilder extends OptionsBuilder<MariaDbJournalOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new MariaDbJournalOptionsBuilder()`. */
+    static create(): MariaDbJournalOptionsBuilder;
+    /** Connection URI passed straight to `createPool`, e.g. `mariadb://user:pass@host:3306/db`. */
+    withUrl(url: string): this;
+    /** `createPool` config object (host/user/password/database/…); takes precedence over `url`. */
+    withPoolConfig(poolConfig: Record<string, unknown>): this;
+    /** Pre-built pool — shares one pool across the three stores, or injects a fake in tests. */
+    withPool(pool: MariaDbPoolLike): this;
+    /** Events table name.  Default: `events`. */
+    withEventsTable(eventsTable: string): this;
+    /** Tags join table name.  Default: `${eventsTable}_tags`. */
+    withTagsTable(tagsTable: string): this;
+    /** Run `CREATE TABLE IF NOT EXISTS` on first use.  Default: true. */
+    withAutoCreateTables(autoCreateTables: boolean): this;
+}
+/**
+ * Accepted input for any MariaDB-journal constructor: the fluent
+ * {@link MariaDbJournalOptionsBuilder} OR a plain {@link MariaDbJournalOptionsType} object.
+ */
+export type MariaDbJournalOptions = MariaDbJournalOptionsBuilder | Partial<MariaDbJournalOptionsType>;
+/** Value alias so `MariaDbJournalOptions.create()` / `new MariaDbJournalOptions()` resolve to the builder. */
+export declare const MariaDbJournalOptions: typeof MariaDbJournalOptionsBuilder;
+//# sourceMappingURL=MariaDbJournalOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MariaDbJournalOptions.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/MariaDbJournalOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,qBAAa,4BAA6B,SAAQ,cAAc,CAAC,yBAAyB,CAAC;IACzF,kFAAkF;IAClF,MAAM,CAAC,MAAM,IAAI,4BAA4B;IAI7C,+FAA+F;IAC/F,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI1B,+FAA+F;IAC/F,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIzD,4FAA4F;IAC5F,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAIrC,6CAA6C;IAC7C,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI1C,6DAA6D;IAC7D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC,qEAAqE;IACrE,oBAAoB,CAAC,gBAAgB,EAAE,OAAO,GAAG,IAAI;CAGtD;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;AACtG,8GAA8G;AAC9G,eAAO,MAAM,qBAAqB,qCAA+B,CAAC"}