actor-ts 0.9.0 → 0.10.0

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

@@ -0,0 +1,107 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import type { CassandraClientLike, CassandraConnection } from './CassandraClient.js';
+export interface CassandraJournalOptionsType extends CassandraConnection {
+    /** Table name for events.  Default: `events`. */
+    readonly eventsTable?: string;
+    /** Table tracking the highest sequence number per pid.  Default: `metadata`. */
+    readonly metadataTable?: string;
+    /** Lookup table for `persistenceIds()`.  Default: `all_persistence_ids`. */
+    readonly allIdsTable?: string;
+    /** Tag-index side table populated when `useTagIndex` is set.  Default: `events_by_tag`. */
+    readonly tagIndexTable?: string;
+    /**
+     * Rows per partition before rolling over to a new one.  Keeps Cassandra
+     * partitions bounded.  Default: 500_000 — a good balance between write
+     * amplification and read-scan cost for long-lived streams.
+     */
+    readonly partitionSize?: number;
+    /** Auto-create the events/metadata/all-ids tables on first connect. */
+    readonly autoCreateTables?: boolean;
+    /**
+     * Opt in to maintaining an `events_by_tag` side table for indexed
+     * `eventsByTag` queries (#44).  When set, every `append` writes one
+     * extra row per `(event, tag)` pair to the side table inside the same
+     * batch as the primary `events` insert; `CassandraQuery.currentEventsBy
+     * Tag` then walks a single tag-partition instead of scanning the
+     * whole journal client-side.
+     *
+     * Off by default to keep existing schemas compatible — operators
+     * opting in must run the side-table DDL on their cluster (the journal
+     * issues `CREATE TABLE IF NOT EXISTS` when `autoCreateTables` is also
+     * true; otherwise the DDL in {@link CassandraClient.tagIndexDdl} can
+     * be applied manually).
+     *
+     * **Caveat:** `delete(toSeq)` does NOT propagate to the side table —
+     * deleting from `events_by_tag` would require either a secondary
+     * index on `persistence_id` or pre-reading the event's tags (extra
+     * round-trips on the hot path).  Operators with delete-heavy
+     * workloads should rely on Cassandra TTLs or accept stale tag
+     * entries (queries dedupe via the primary key, so they're harmless
+     * — just storage overhead).
+     */
+    readonly useTagIndex?: boolean;
+    /**
+     * Inject a pre-built client instead of letting the journal instantiate
+     * `cassandra-driver` itself — useful for tests and when the host already
+     * owns the client lifecycle.
+     */
+    readonly client?: CassandraClientLike;
+}
+/**
+ * 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 declare class CassandraJournalOptionsBuilder extends OptionsBuilder<CassandraJournalOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new CassandraJournalOptionsBuilder()`. */
+    static create(): CassandraJournalOptionsBuilder;
+    /** Node(s) to seed the cluster topology from. */
+    withContactPoints(contactPoints: ReadonlyArray<string>): this;
+    /** Local DC — required for DCAwareRoundRobinPolicy.  Defaults to `datacenter1`. */
+    withLocalDataCenter(localDataCenter: string): this;
+    /** Keyspace to `USE` after connect.  Must already exist, or pass `withAutoCreateKeyspace(true)`. */
+    withKeyspace(keyspace: string): this;
+    /** Username/password for PLAIN auth. */
+    withCredentials(username: string, password: string): this;
+    /** Port — defaults to 9042. */
+    withPort(port: number): this;
+    /** If true, create the keyspace on startup (simple strategy, rf=1). */
+    withAutoCreateKeyspace(autoCreateKeyspace?: boolean): this;
+    /** Replication settings used by autoCreateKeyspace.  Ignored otherwise. */
+    withReplication(replication: NonNullable<CassandraJournalOptionsType['replication']>): this;
+    /** CQL consistency level for all reads and writes.  Default `LOCAL_QUORUM` (6). */
+    withConsistency(consistency: number): this;
+    /** Table name for events.  Default: `events`. */
+    withEventsTable(eventsTable: string): this;
+    /** Table tracking the highest sequence number per pid.  Default: `metadata`. */
+    withMetadataTable(metadataTable: string): this;
+    /** Lookup table for `persistenceIds()`.  Default: `all_persistence_ids`. */
+    withAllIdsTable(allIdsTable: string): this;
+    /** Tag-index side table populated when `useTagIndex` is set.  Default: `events_by_tag`. */
+    withTagIndexTable(tagIndexTable: string): this;
+    /** Rows per partition before rolling over to a new one.  Default: 500_000. */
+    withPartitionSize(partitionSize: number): this;
+    /** Auto-create the events/metadata/all-ids tables on first connect. */
+    withAutoCreateTables(autoCreateTables?: boolean): this;
+    /** Opt in to maintaining an `events_by_tag` side table for indexed `eventsByTag` queries (#44). */
+    withUseTagIndex(useTagIndex?: boolean): this;
+    /** Inject a pre-built client instead of letting the journal instantiate `cassandra-driver` itself. */
+    withClient(client: CassandraClientLike): this;
+}
+/**
+ * Accepted input for any Cassandra-journal constructor: the fluent
+ * {@link CassandraJournalOptionsBuilder} OR a plain {@link CassandraJournalOptionsType} object.
+ */
+export type CassandraJournalOptions = CassandraJournalOptionsBuilder | Partial<CassandraJournalOptionsType>;
+/** Value alias so `CassandraJournalOptions.create()` / `new CassandraJournalOptions()` resolve to the builder. */
+export declare const CassandraJournalOptions: typeof CassandraJournalOptionsBuilder;
+//# sourceMappingURL=CassandraJournalOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CassandraJournalOptions.d.ts","sourceRoot":"","sources":["../../../src/persistence/journals/CassandraJournalOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAErF,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,iDAAiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,8BAA+B,SAAQ,cAAc,CAAC,2BAA2B,CAAC;IAC7F,oFAAoF;IACpF,MAAM,CAAC,MAAM,IAAI,8BAA8B;IAM/C,iDAAiD;IACjD,iBAAiB,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAI7D,mFAAmF;IACnF,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAIlD,oGAAoG;IACpG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC,wCAAwC;IACxC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIzD,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,uEAAuE;IACvE,sBAAsB,CAAC,kBAAkB,UAAO,GAAG,IAAI;IAIvD,2EAA2E;IAC3E,eAAe,CAAC,WAAW,EAAE,WAAW,CAAC,2BAA2B,CAAC,aAAa,CAAC,CAAC,GAAG,IAAI;IAI3F,mFAAmF;IACnF,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAM1C,iDAAiD;IACjD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI1C,gFAAgF;IAChF,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAI9C,4EAA4E;IAC5E,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI1C,2FAA2F;IAC3F,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAI9C,8EAA8E;IAC9E,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAI9C,uEAAuE;IACvE,oBAAoB,CAAC,gBAAgB,UAAO,GAAG,IAAI;IAInD,mGAAmG;IACnG,eAAe,CAAC,WAAW,UAAO,GAAG,IAAI;IAIzC,sGAAsG;IACtG,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;CAG9C;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,8BAA8B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;AAC5G,kHAAkH;AAClH,eAAO,MAAM,uBAAuB,uCAAiC,CAAC"}

package/dist/persistence/journals/CassandraJournalOptions.js

@@ -0,0 +1,90 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.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 settings 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);
+    }
+}
+/** 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":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAmD9D;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,8BAA+B,SAAQ,cAA2C;IAC7F,oFAAoF;IACpF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,8BAA8B,EAAE,CAAC;IAC9C,CAAC;IAED,+CAA+C;IAE/C,iDAAiD;IACjD,iBAAiB,CAAC,aAAoC;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,mFAAmF;IACnF,mBAAmB,CAAC,eAAuB;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IACtD,CAAC;IAED,oGAAoG;IACpG,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,wCAAwC;IACxC,eAAe,CAAC,QAAgB,EAAE,QAAgB;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,+BAA+B;IAC/B,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,uEAAuE;IACvE,sBAAsB,CAAC,kBAAkB,GAAG,IAAI;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;IAC5D,CAAC;IAED,2EAA2E;IAC3E,eAAe,CAAC,WAAoE;QAClF,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,mFAAmF;IACnF,eAAe,CAAC,WAAmB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,qCAAqC;IAErC,iDAAiD;IACjD,eAAe,CAAC,WAAmB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,gFAAgF;IAChF,iBAAiB,CAAC,aAAqB;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,4EAA4E;IAC5E,eAAe,CAAC,WAAmB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,2FAA2F;IAC3F,iBAAiB,CAAC,aAAqB;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,8EAA8E;IAC9E,iBAAiB,CAAC,aAAqB;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,uEAAuE;IACvE,oBAAoB,CAAC,gBAAgB,GAAG,IAAI;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IACxD,CAAC;IAED,mGAAmG;IACnG,eAAe,CAAC,WAAW,GAAG,IAAI;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,sGAAsG;IACtG,UAAU,CAAC,MAA2B;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAOD,kHAAkH;AAClH,MAAM,CAAC,MAAM,uBAAuB,GAAG,8BAA8B,CAAC"}

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 s = 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 = { ...(s.journal ?? {}), ...(s.client ? { client: s.client } : {}) };
+    const snapshotStore = { ...(s.snapshotStore ?? {}), ...(s.client ? { client: s.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,CAAC,GAAI,OAA+C,CAAC;IAC3D,wEAAwE;IACxE,4DAA4D;IAC5D,MAAM,OAAO,GAAG,EAAE,GAAI,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAA0C,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9H,MAAM,aAAa,GAAG,EAAE,GAAI,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAgD,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChJ,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 settings); 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 settings); 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 settings;
+    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,QAAQ,CAA4B;IACrD,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"}