actor-ts 0.9.1 → 0.10.0

package/dist/persistence/snapshot-stores/ObjectStorageSnapshotStoreOptions.d.ts

@@ -0,0 +1,45 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import type { CompressionConfig, CompressionResolver, EncryptionConfig, EncryptionResolver } from '../object-storage/PluginConfig.js';
+import type { ObjectStorageBackend } from '../object-storage/ObjectStorageBackend.js';
+export interface ObjectStorageSnapshotStoreOptionsType {
+    /** The underlying storage layer (S3 / Filesystem / …). */
+    readonly backend: ObjectStorageBackend;
+    /** Prepended to every key before the persistenceId.  Default: ''. */
+    readonly prefix?: string;
+    /** Keep this many snapshots per persistenceId; older ones are deleted on save.  Default: 3. */
+    readonly keepN?: number;
+    /** Compression — flat config or per-pid resolver.  Default: `{ algorithm: 'gzip' }`. */
+    readonly compression?: CompressionConfig | CompressionResolver;
+    /** Encryption — flat config or per-pid resolver.  Default: `{ mode: 'none' }`. */
+    readonly encryption?: EncryptionConfig | EncryptionResolver;
+}
+/**
+ * Fluent builder for {@link ObjectStorageSnapshotStoreOptionsType}.  The
+ * `backend` is required:
+ *
+ *     new ObjectStorageSnapshotStore(
+ *       ObjectStorageSnapshotStoreOptions.create().withBackend(backend).withKeepN(2),
+ *     )
+ */
+export declare class ObjectStorageSnapshotStoreOptionsBuilder extends OptionsBuilder<ObjectStorageSnapshotStoreOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new ObjectStorageSnapshotStoreOptionsBuilder()`. */
+    static create(): ObjectStorageSnapshotStoreOptionsBuilder;
+    /** The underlying storage layer (S3 / Filesystem / …). */
+    withBackend(backend: ObjectStorageBackend): this;
+    /** Key prefix prepended before the persistenceId.  Default: ''. */
+    withPrefix(prefix: string): this;
+    /** Keep this many snapshots per persistenceId; older ones are pruned on save.  Default: 3. */
+    withKeepN(keepN: number): this;
+    /** Compression — flat config or per-pid resolver.  Default: gzip. */
+    withCompression(compression: CompressionConfig | CompressionResolver): this;
+    /** Encryption — flat config or per-pid resolver.  Default: none. */
+    withEncryption(encryption: EncryptionConfig | EncryptionResolver): this;
+}
+/**
+ * Accepted input for the object-storage snapshot-store constructor: the fluent
+ * {@link ObjectStorageSnapshotStoreOptionsBuilder} OR a plain {@link ObjectStorageSnapshotStoreOptionsType} object.
+ */
+export type ObjectStorageSnapshotStoreOptions = ObjectStorageSnapshotStoreOptionsBuilder | Partial<ObjectStorageSnapshotStoreOptionsType>;
+/** Value alias so `ObjectStorageSnapshotStoreOptions.create()` / `new ObjectStorageSnapshotStoreOptions()` resolve to the builder. */
+export declare const ObjectStorageSnapshotStoreOptions: typeof ObjectStorageSnapshotStoreOptionsBuilder;
+//# sourceMappingURL=ObjectStorageSnapshotStoreOptions.d.ts.map

package/dist/persistence/snapshot-stores/ObjectStorageSnapshotStoreOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectStorageSnapshotStoreOptions.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/ObjectStorageSnapshotStoreOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEtF,MAAM,WAAW,qCAAqC;IACpD,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,CAAC;IAC/D,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAAC;CAC7D;AAED;;;;;;;GAOG;AACH,qBAAa,wCAAyC,SAAQ,cAAc,CAAC,qCAAqC,CAAC;IACjH,8FAA8F;IAC9F,MAAM,CAAC,MAAM,IAAI,wCAAwC;IAIzD,0DAA0D;IAC1D,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAIhD,mEAAmE;IACnE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC,8FAA8F;IAC9F,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,qEAAqE;IACrE,eAAe,CAAC,WAAW,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,IAAI;IAI3E,oEAAoE;IACpE,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,IAAI;CAGxE;AAED;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,wCAAwC,GAAG,OAAO,CAAC,qCAAqC,CAAC,CAAC;AAC1I,sIAAsI;AACtI,eAAO,MAAM,iCAAiC,iDAA2C,CAAC"}

package/dist/persistence/snapshot-stores/ObjectStorageSnapshotStoreOptions.js

@@ -0,0 +1,38 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link ObjectStorageSnapshotStoreOptionsType}.  The
+ * `backend` is required:
+ *
+ *     new ObjectStorageSnapshotStore(
+ *       ObjectStorageSnapshotStoreOptions.create().withBackend(backend).withKeepN(2),
+ *     )
+ */
+export class ObjectStorageSnapshotStoreOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new ObjectStorageSnapshotStoreOptionsBuilder()`. */
+    static create() {
+        return new ObjectStorageSnapshotStoreOptionsBuilder();
+    }
+    /** The underlying storage layer (S3 / Filesystem / …). */
+    withBackend(backend) {
+        return this.set('backend', backend);
+    }
+    /** Key prefix prepended before the persistenceId.  Default: ''. */
+    withPrefix(prefix) {
+        return this.set('prefix', prefix);
+    }
+    /** Keep this many snapshots per persistenceId; older ones are pruned on save.  Default: 3. */
+    withKeepN(keepN) {
+        return this.set('keepN', keepN);
+    }
+    /** Compression — flat config or per-pid resolver.  Default: gzip. */
+    withCompression(compression) {
+        return this.set('compression', compression);
+    }
+    /** Encryption — flat config or per-pid resolver.  Default: none. */
+    withEncryption(encryption) {
+        return this.set('encryption', encryption);
+    }
+}
+/** Value alias so `ObjectStorageSnapshotStoreOptions.create()` / `new ObjectStorageSnapshotStoreOptions()` resolve to the builder. */
+export const ObjectStorageSnapshotStoreOptions = ObjectStorageSnapshotStoreOptionsBuilder;
+//# sourceMappingURL=ObjectStorageSnapshotStoreOptions.js.map

package/dist/persistence/snapshot-stores/ObjectStorageSnapshotStoreOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectStorageSnapshotStoreOptions.js","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/ObjectStorageSnapshotStoreOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAsB9D;;;;;;;GAOG;AACH,MAAM,OAAO,wCAAyC,SAAQ,cAAqD;IACjH,8FAA8F;IAC9F,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,wCAAwC,EAAE,CAAC;IACxD,CAAC;IAED,0DAA0D;IAC1D,WAAW,CAAC,OAA6B;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,mEAAmE;IACnE,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,8FAA8F;IAC9F,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,qEAAqE;IACrE,eAAe,CAAC,WAAoD;QAClE,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,oEAAoE;IACpE,cAAc,CAAC,UAAiD;QAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;CACF;AAOD,sIAAsI;AACtI,MAAM,CAAC,MAAM,iCAAiC,GAAG,wCAAwC,CAAC"}

package/dist/persistence/snapshot-stores/PostgresSnapshotStore.d.ts

@@ -0,0 +1,31 @@
+import { type Snapshot } from '../JournalTypes.js';
+import type { PersistenceOptions } from '../PersistenceOptions.js';
+import type { SnapshotStore } from '../SnapshotStore.js';
+import { type Option } from '../../util/Option.js';
+import type { PostgresSnapshotStoreOptions } from './PostgresSnapshotStoreOptions.js';
+/**
+ * SnapshotStore backed by PostgreSQL (`pg`).  One row per
+ * `(persistence_id, sequence_nr)`; `loadLatest` is an indexed
+ * `ORDER BY sequence_nr DESC LIMIT 1`.  Prune-on-save keeps the newest
+ * `keepN`.  `PersistenceOptions` (compression/encryption) are ignored —
+ * like the SQLite and Cassandra stores, payloads are stored as JSON text.
+ */
+export declare class PostgresSnapshotStore implements SnapshotStore {
+    private readonly settings;
+    private readonly table;
+    private readonly keepN;
+    private readonly autoCreate;
+    private pool;
+    private initPromise;
+    private closed;
+    constructor(options?: PostgresSnapshotStoreOptions);
+    save<S>(pid: string, seq: number, state: S, _options?: PersistenceOptions): Promise<Snapshot<S>>;
+    loadLatest<S>(pid: string, _options?: PersistenceOptions): Promise<Option<Snapshot<S>>>;
+    loadBefore<S>(pid: string, seq: number, _options?: PersistenceOptions): Promise<Option<Snapshot<S>>>;
+    delete(pid: string, toSeq: number): Promise<void>;
+    close(): Promise<void>;
+    private toSnapshot;
+    private ensureOpen;
+    private init;
+}
+//# sourceMappingURL=PostgresSnapshotStore.d.ts.map

package/dist/persistence/snapshot-stores/PostgresSnapshotStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresSnapshotStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/PostgresSnapshotStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAM/D,OAAO,KAAK,EAAE,4BAA4B,EAAoC,MAAM,mCAAmC,CAAC;AASxH;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IAErC,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,4BAAiC;IAQhD,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAsBhG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAUvF,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAUpG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,OAAO,CAAC,UAAU;YASJ,UAAU;YAQV,IAAI;CAenB"}

package/dist/persistence/snapshot-stores/PostgresSnapshotStore.js

@@ -0,0 +1,101 @@
+import { JournalError } from '../JournalTypes.js';
+import { none, some } from '../../util/Option.js';
+import { assertSafeIdentifier, buildPgPool, } from '../journals/PostgresClient.js';
+/**
+ * SnapshotStore backed by PostgreSQL (`pg`).  One row per
+ * `(persistence_id, sequence_nr)`; `loadLatest` is an indexed
+ * `ORDER BY sequence_nr DESC LIMIT 1`.  Prune-on-save keeps the newest
+ * `keepN`.  `PersistenceOptions` (compression/encryption) are ignored —
+ * like the SQLite and Cassandra stores, payloads are stored as JSON text.
+ */
+export class PostgresSnapshotStore {
+    settings;
+    table;
+    keepN;
+    autoCreate;
+    pool = null;
+    initPromise = null;
+    closed = false;
+    constructor(options = {}) {
+        const s = options;
+        this.settings = s;
+        this.table = assertSafeIdentifier(s.snapshotsTable ?? 'snapshots', 'snapshots table');
+        this.keepN = s.keepN ?? 3;
+        this.autoCreate = s.autoCreateTables ?? true;
+    }
+    async save(pid, seq, state, _options) {
+        const pool = await this.ensureOpen();
+        const now = Date.now();
+        try {
+            await pool.query(`INSERT INTO ${this.table}(persistence_id, sequence_nr, payload, timestamp) VALUES ($1, $2, $3, $4)
+         ON CONFLICT (persistence_id, sequence_nr) DO UPDATE SET payload = EXCLUDED.payload, timestamp = EXCLUDED.timestamp`, [pid, seq, JSON.stringify(state), now]);
+            if (this.keepN > 0) {
+                await pool.query(`DELETE FROM ${this.table} WHERE persistence_id = $1 AND sequence_nr NOT IN (
+             SELECT sequence_nr FROM ${this.table} WHERE persistence_id = $1 ORDER BY sequence_nr DESC LIMIT $2)`, [pid, this.keepN]);
+            }
+            return { persistenceId: pid, sequenceNr: seq, state, timestamp: now };
+        }
+        catch (e) {
+            throw new JournalError(`PostgresSnapshotStore.save failed: ${e.message}`, e);
+        }
+    }
+    async loadLatest(pid, _options) {
+        const pool = await this.ensureOpen();
+        const res = await pool.query(`SELECT persistence_id, sequence_nr, payload, timestamp FROM ${this.table} WHERE persistence_id = $1 ORDER BY sequence_nr DESC LIMIT 1`, [pid]);
+        const row = res.rows[0];
+        return row ? some(this.toSnapshot(row)) : none;
+    }
+    async loadBefore(pid, seq, _options) {
+        const pool = await this.ensureOpen();
+        const res = await pool.query(`SELECT persistence_id, sequence_nr, payload, timestamp FROM ${this.table} WHERE persistence_id = $1 AND sequence_nr < $2 ORDER BY sequence_nr DESC LIMIT 1`, [pid, seq]);
+        const row = res.rows[0];
+        return row ? some(this.toSnapshot(row)) : none;
+    }
+    async delete(pid, toSeq) {
+        const pool = await this.ensureOpen();
+        await pool.query(`DELETE FROM ${this.table} WHERE persistence_id = $1 AND sequence_nr <= $2`, [pid, toSeq]);
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        try {
+            await this.pool?.end();
+        }
+        catch { /* ignore */ }
+        this.pool = null;
+    }
+    /* --------------------------- internals -------------------------------- */
+    toSnapshot(row) {
+        return {
+            persistenceId: row.persistence_id,
+            sequenceNr: Number(row.sequence_nr),
+            state: JSON.parse(row.payload),
+            timestamp: Number(row.timestamp),
+        };
+    }
+    async ensureOpen() {
+        if (this.closed)
+            throw new JournalError('PostgresSnapshotStore 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 buildPgPool(this.settings);
+        if (this.autoCreate) {
+            await pool.query(`CREATE TABLE IF NOT EXISTS ${this.table} (
+           persistence_id TEXT NOT NULL,
+           sequence_nr    BIGINT NOT NULL,
+           payload        TEXT NOT NULL,
+           timestamp      BIGINT NOT NULL,
+           PRIMARY KEY (persistence_id, sequence_nr)
+         )`);
+        }
+        this.pool = pool;
+    }
+}
+//# sourceMappingURL=PostgresSnapshotStore.js.map

package/dist/persistence/snapshot-stores/PostgresSnapshotStore.js.map

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

package/dist/persistence/snapshot-stores/PostgresSnapshotStoreOptions.d.ts

@@ -0,0 +1,42 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+import type { PgPoolLike, PostgresConnection } from '../journals/PostgresClient.js';
+export interface PostgresSnapshotStoreOptionsType extends PostgresConnection {
+    /** Snapshots table name.  Default: `snapshots`. */
+    readonly snapshotsTable?: string;
+    /** Keep this many snapshots per persistenceId; older ones pruned on save.  Default: 3.  `<=0` keeps all. */
+    readonly keepN?: number;
+    /** Run `CREATE TABLE IF NOT EXISTS` on first use.  Default: true. */
+    readonly autoCreateTables?: boolean;
+}
+/**
+ * Fluent builder for {@link PostgresSnapshotStoreOptionsType}:
+ *
+ *     new PostgresSnapshotStore(PostgresSnapshotStoreOptions.create().withUrl('postgres://…').withKeepN(5))
+ *
+ * The connection fields (`withUrl` / `withPoolConfig` / `withPool`) come
+ * from the shared {@link PostgresConnection} mixin.
+ */
+export declare class PostgresSnapshotStoreOptionsBuilder extends OptionsBuilder<PostgresSnapshotStoreOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new PostgresSnapshotStoreOptionsBuilder()`. */
+    static create(): PostgresSnapshotStoreOptionsBuilder;
+    /** Connection string, e.g. `postgres://user:pass@host:5432/db`. */
+    withUrl(url: string): this;
+    /** Extra node-postgres `Pool` config, merged over `{ connectionString: url }`. */
+    withPoolConfig(poolConfig: Record<string, unknown>): this;
+    /** Pre-built pool — bypasses the lazy `pg` import; share it across stores. */
+    withPool(pool: PgPoolLike): this;
+    /** Snapshots table name.  Default: `snapshots`. */
+    withSnapshotsTable(snapshotsTable: string): this;
+    /** Keep this many snapshots per persistenceId; older ones pruned on save.  Default: 3.  `<=0` keeps all. */
+    withKeepN(keepN: number): this;
+    /** Run `CREATE TABLE IF NOT EXISTS` on first use.  Default: true. */
+    withAutoCreateTables(autoCreateTables: boolean): this;
+}
+/**
+ * Accepted input for the Postgres snapshot-store constructor: the fluent
+ * {@link PostgresSnapshotStoreOptionsBuilder} OR a plain {@link PostgresSnapshotStoreOptionsType} object.
+ */
+export type PostgresSnapshotStoreOptions = PostgresSnapshotStoreOptionsBuilder | Partial<PostgresSnapshotStoreOptionsType>;
+/** Value alias so `PostgresSnapshotStoreOptions.create()` / `new PostgresSnapshotStoreOptions()` resolve to the builder. */
+export declare const PostgresSnapshotStoreOptions: typeof PostgresSnapshotStoreOptionsBuilder;
+//# sourceMappingURL=PostgresSnapshotStoreOptions.d.ts.map

package/dist/persistence/snapshot-stores/PostgresSnapshotStoreOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresSnapshotStoreOptions.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/PostgresSnapshotStoreOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEpF,MAAM,WAAW,gCAAiC,SAAQ,kBAAkB;IAC1E,mDAAmD;IACnD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,4GAA4G;IAC5G,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,qBAAa,mCAAoC,SAAQ,cAAc,CAAC,gCAAgC,CAAC;IACvG,yFAAyF;IACzF,MAAM,CAAC,MAAM,IAAI,mCAAmC;IAIpD,mEAAmE;IACnE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI1B,kFAAkF;IAClF,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIzD,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIhC,mDAAmD;IACnD,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAIhD,4GAA4G;IAC5G,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,qEAAqE;IACrE,oBAAoB,CAAC,gBAAgB,EAAE,OAAO,GAAG,IAAI;CAGtD;AAED;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,mCAAmC,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAAC;AAC3H,4HAA4H;AAC5H,eAAO,MAAM,4BAA4B,4CAAsC,CAAC"}

package/dist/persistence/snapshot-stores/PostgresSnapshotStoreOptions.js

@@ -0,0 +1,42 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link PostgresSnapshotStoreOptionsType}:
+ *
+ *     new PostgresSnapshotStore(PostgresSnapshotStoreOptions.create().withUrl('postgres://…').withKeepN(5))
+ *
+ * The connection fields (`withUrl` / `withPoolConfig` / `withPool`) come
+ * from the shared {@link PostgresConnection} mixin.
+ */
+export class PostgresSnapshotStoreOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new PostgresSnapshotStoreOptionsBuilder()`. */
+    static create() {
+        return new PostgresSnapshotStoreOptionsBuilder();
+    }
+    /** 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);
+    }
+    /** Snapshots table name.  Default: `snapshots`. */
+    withSnapshotsTable(snapshotsTable) {
+        return this.set('snapshotsTable', snapshotsTable);
+    }
+    /** Keep this many snapshots per persistenceId; older ones pruned on save.  Default: 3.  `<=0` keeps all. */
+    withKeepN(keepN) {
+        return this.set('keepN', keepN);
+    }
+    /** Run `CREATE TABLE IF NOT EXISTS` on first use.  Default: true. */
+    withAutoCreateTables(autoCreateTables) {
+        return this.set('autoCreateTables', autoCreateTables);
+    }
+}
+/** Value alias so `PostgresSnapshotStoreOptions.create()` / `new PostgresSnapshotStoreOptions()` resolve to the builder. */
+export const PostgresSnapshotStoreOptions = PostgresSnapshotStoreOptionsBuilder;
+//# sourceMappingURL=PostgresSnapshotStoreOptions.js.map

package/dist/persistence/snapshot-stores/PostgresSnapshotStoreOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresSnapshotStoreOptions.js","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/PostgresSnapshotStoreOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAY9D;;;;;;;GAOG;AACH,MAAM,OAAO,mCAAoC,SAAQ,cAAgD;IACvG,yFAAyF;IACzF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,mCAAmC,EAAE,CAAC;IACnD,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,mDAAmD;IACnD,kBAAkB,CAAC,cAAsB;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,4GAA4G;IAC5G,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,qEAAqE;IACrE,oBAAoB,CAAC,gBAAyB;QAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IACxD,CAAC;CACF;AAOD,4HAA4H;AAC5H,MAAM,CAAC,MAAM,4BAA4B,GAAG,mCAAmC,CAAC"}

package/dist/persistence/snapshot-stores/SqliteSnapshotStore.d.ts

@@ -1,21 +1,8 @@
-import { type SqliteDriver } from '../../runtime/sqlite/index.js';
 import { type Snapshot } from '../JournalTypes.js';
 import type { PersistenceOptions } from '../PersistenceOptions.js';
 import type { SnapshotStore } from '../SnapshotStore.js';
 import { type Option } from '../../util/Option.js';
-export interface SqliteSnapshotStoreOptions {
-    /** Path or ":memory:". Defaults to ":memory:". */
-    readonly path?: string;
-    /** Table name; default `snapshots`. */
-    readonly snapshotsTable?: string;
-    /** Maximum snapshots retained per persistenceId.  Older ones are pruned on save. */
-    readonly keepN?: number;
-    /**
-     * Explicit driver — useful for tests or when you want to pin a
-     * specific SQLite backend.  Default: auto-detect via `getSqliteDriver()`.
-     */
-    readonly driver?: SqliteDriver;
-}
+import type { SqliteSnapshotStoreOptions } from './SqliteSnapshotStoreOptions.js';
 /**
  * SQLite-backed SnapshotStore — JSON payloads, single table, prune-on-save.
  * Works on Bun (`bun:sqlite`) and Node.js (`better-sqlite3`) via the
@@ -23,7 +10,7 @@ export interface SqliteSnapshotStoreOptions {
  * `SqliteJournal`): the DB is opened on the first save / load call.
  */
 export declare class SqliteSnapshotStore implements SnapshotStore {
-    private readonly options;
+    private readonly settings;
     private readonly table;
     private readonly keepN;
     private closed;

package/dist/persistence/snapshot-stores/SqliteSnapshotStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SqliteSnapshotStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/SqliteSnapshotStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,YAAY,EAAwB,MAAM,+BAA+B,CAAC;AACxH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,WAAW,0BAA0B;IACzC,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC;AAUD;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,GAAE,0BAA+B;IAM9C,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAgBhG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAiBvF,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAiBpG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,UAAU;YAOV,IAAI;CA+BnB"}
+{"version":3,"file":"SqliteSnapshotStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/SqliteSnapshotStore.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,0BAA0B,EAAkC,MAAM,iCAAiC,CAAC;AAUlH;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,GAAE,0BAA+B;IAO9C,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAgBhG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAiBvF,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAiBpG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,UAAU;YAOV,IAAI;CA+BnB"}

package/dist/persistence/snapshot-stores/SqliteSnapshotStore.js

@@ -8,7 +8,7 @@ import { none, some } from '../../util/Option.js';
  * `SqliteJournal`): the DB is opened on the first save / load call.
  */
 export class SqliteSnapshotStore {
-    options;
+    settings;
     table;
     keepN;
     closed = false;
@@ -16,9 +16,10 @@ export class SqliteSnapshotStore {
     stmts = null;
     initPromise = null;
     constructor(options = {}) {
-        this.options = options;
-        this.table = options.snapshotsTable ?? 'snapshots';
-        this.keepN = options.keepN ?? 3;
+        const settings = options;
+        this.settings = settings;
+        this.table = settings.snapshotsTable ?? 'snapshots';
+        this.keepN = settings.keepN ?? 3;
     }
     async save(pid, seq, state, _options) {
         // SQLite store has no compression / encryption — options ignored.
@@ -84,8 +85,8 @@ export class SqliteSnapshotStore {
         await this.initPromise;
     }
     async init() {
-        const driver = this.options.driver ?? await getSqliteDriver();
-        const db = driver.open(this.options.path ?? ':memory:');
+        const driver = this.settings.driver ?? await getSqliteDriver();
+        const db = driver.open(this.settings.path ?? ':memory:');
         db.exec(`
       CREATE TABLE IF NOT EXISTS ${this.table} (
         persistence_id TEXT NOT NULL,

package/dist/persistence/snapshot-stores/SqliteSnapshotStore.js.map

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

package/dist/persistence/snapshot-stores/SqliteSnapshotStoreOptions.d.ts

@@ -0,0 +1,40 @@
+import type { SqliteDriver } from '../../runtime/sqlite/index.js';
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+export interface SqliteSnapshotStoreOptionsType {
+    /** Path or ":memory:". Defaults to ":memory:". */
+    readonly path?: string;
+    /** Table name; default `snapshots`. */
+    readonly snapshotsTable?: string;
+    /** Maximum snapshots retained per persistenceId.  Older ones are pruned on save. */
+    readonly keepN?: number;
+    /**
+     * Explicit driver — useful for tests or when you want to pin a
+     * specific SQLite backend.  Default: auto-detect via `getSqliteDriver()`.
+     */
+    readonly driver?: SqliteDriver;
+}
+/**
+ * Fluent builder for {@link SqliteSnapshotStoreOptionsType}:
+ *
+ *     new SqliteSnapshotStore(SqliteSnapshotStoreOptions.create().withPath(':memory:').withKeepN(2))
+ */
+export declare class SqliteSnapshotStoreOptionsBuilder extends OptionsBuilder<SqliteSnapshotStoreOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new SqliteSnapshotStoreOptionsBuilder()`. */
+    static create(): SqliteSnapshotStoreOptionsBuilder;
+    /** Path or ":memory:". Defaults to ":memory:". */
+    withPath(path: string): this;
+    /** Table name; default `snapshots`. */
+    withSnapshotsTable(snapshotsTable: string): this;
+    /** Maximum snapshots retained per persistenceId.  Older ones are pruned on save. */
+    withKeepN(keepN: number): this;
+    /** Explicit driver — pin a specific SQLite backend (defaults to auto-detect). */
+    withDriver(driver: SqliteDriver): this;
+}
+/**
+ * Accepted input for the SQLite snapshot-store constructor: the fluent
+ * {@link SqliteSnapshotStoreOptionsBuilder} OR a plain {@link SqliteSnapshotStoreOptionsType} object.
+ */
+export type SqliteSnapshotStoreOptions = SqliteSnapshotStoreOptionsBuilder | Partial<SqliteSnapshotStoreOptionsType>;
+/** Value alias so `SqliteSnapshotStoreOptions.create()` / `new SqliteSnapshotStoreOptions()` resolve to the builder. */
+export declare const SqliteSnapshotStoreOptions: typeof SqliteSnapshotStoreOptionsBuilder;
+//# sourceMappingURL=SqliteSnapshotStoreOptions.d.ts.map

package/dist/persistence/snapshot-stores/SqliteSnapshotStoreOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteSnapshotStoreOptions.d.ts","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/SqliteSnapshotStoreOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,WAAW,8BAA8B;IAC7C,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,iCAAkC,SAAQ,cAAc,CAAC,8BAA8B,CAAC;IACnG,uFAAuF;IACvF,MAAM,CAAC,MAAM,IAAI,iCAAiC;IAIlD,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,uCAAuC;IACvC,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAIhD,oFAAoF;IACpF,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,iFAAiF;IACjF,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;CAGvC;AAED;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,iCAAiC,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;AACrH,wHAAwH;AACxH,eAAO,MAAM,0BAA0B,0CAAoC,CAAC"}

package/dist/persistence/snapshot-stores/SqliteSnapshotStoreOptions.js

@@ -0,0 +1,31 @@
+import { OptionsBuilder } from '../../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link SqliteSnapshotStoreOptionsType}:
+ *
+ *     new SqliteSnapshotStore(SqliteSnapshotStoreOptions.create().withPath(':memory:').withKeepN(2))
+ */
+export class SqliteSnapshotStoreOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new SqliteSnapshotStoreOptionsBuilder()`. */
+    static create() {
+        return new SqliteSnapshotStoreOptionsBuilder();
+    }
+    /** Path or ":memory:". Defaults to ":memory:". */
+    withPath(path) {
+        return this.set('path', path);
+    }
+    /** Table name; default `snapshots`. */
+    withSnapshotsTable(snapshotsTable) {
+        return this.set('snapshotsTable', snapshotsTable);
+    }
+    /** Maximum snapshots retained per persistenceId.  Older ones are pruned on save. */
+    withKeepN(keepN) {
+        return this.set('keepN', keepN);
+    }
+    /** Explicit driver — pin a specific SQLite backend (defaults to auto-detect). */
+    withDriver(driver) {
+        return this.set('driver', driver);
+    }
+}
+/** Value alias so `SqliteSnapshotStoreOptions.create()` / `new SqliteSnapshotStoreOptions()` resolve to the builder. */
+export const SqliteSnapshotStoreOptions = SqliteSnapshotStoreOptionsBuilder;
+//# sourceMappingURL=SqliteSnapshotStoreOptions.js.map

package/dist/persistence/snapshot-stores/SqliteSnapshotStoreOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteSnapshotStoreOptions.js","sourceRoot":"","sources":["../../../src/persistence/snapshot-stores/SqliteSnapshotStoreOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAgB9D;;;;GAIG;AACH,MAAM,OAAO,iCAAkC,SAAQ,cAA8C;IACnG,uFAAuF;IACvF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,iCAAiC,EAAE,CAAC;IACjD,CAAC;IAED,kDAAkD;IAClD,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,uCAAuC;IACvC,kBAAkB,CAAC,cAAsB;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,oFAAoF;IACpF,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,iFAAiF;IACjF,UAAU,CAAC,MAAoB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAOD,wHAAwH;AACxH,MAAM,CAAC,MAAM,0BAA0B,GAAG,iCAAiC,CAAC"}

package/dist/runtime/http/BunHonoRunner.d.ts

@@ -1,16 +1,22 @@
-import type { FetchHandler, HonoServerHandle, HonoServerRunner } from './HonoServerRunner.js';
+import type { FetchHandler, HonoServerHandle, HonoServerRunner, HonoWebSocketBridge } from './HonoServerRunner.js';
 /**
  * Bun implementation — `Bun.serve({ hostname, port, fetch })`.
  *
  * Graceful stop calls `server.stop(false)` which lets in-flight requests
  * finish.  Non-graceful calls `server.stop(true)` which kicks active
  * connections immediately.
+ *
+ * WebSocket support uses `createBunWebSocket()` from `hono/bun`, whose
+ * `websocket` handler object must be passed to `Bun.serve` — so we fold
+ * it into `serveOptions`.
  */
 export declare class BunHonoRunner implements HonoServerRunner {
     serve(opts: {
         host: string;
         port: number;
         fetch: FetchHandler;
+        serveOptions?: object;
     }): Promise<HonoServerHandle>;
+    webSocket(_app: unknown): Promise<HonoWebSocketBridge>;
 }
 //# sourceMappingURL=BunHonoRunner.d.ts.map

package/dist/runtime/http/BunHonoRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BunHonoRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/BunHonoRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9F;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IAC9C,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAgBlG"}
+{"version":3,"file":"BunHonoRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/BunHonoRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IAC9C,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkBlH,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAkB7D"}

package/dist/runtime/http/BunHonoRunner.js

@@ -4,6 +4,10 @@
  * Graceful stop calls `server.stop(false)` which lets in-flight requests
  * finish.  Non-graceful calls `server.stop(true)` which kicks active
  * connections immediately.
+ *
+ * WebSocket support uses `createBunWebSocket()` from `hono/bun`, whose
+ * `websocket` handler object must be passed to `Bun.serve` — so we fold
+ * it into `serveOptions`.
  */
 export class BunHonoRunner {
     async serve(opts) {
@@ -15,6 +19,7 @@ export class BunHonoRunner {
             hostname: opts.host,
             port: opts.port,
             fetch: opts.fetch,
+            ...(opts.serveOptions ?? {}),
         });
         return {
             host: server.hostname ?? opts.host,
@@ -22,5 +27,22 @@ export class BunHonoRunner {
             async stop(graceful) { server.stop(!graceful); },
         };
     }
+    async webSocket(_app) {
+        let mod;
+        try {
+            const name = 'hono/bun';
+            mod = (await import(name));
+        }
+        catch (e) {
+            throw new Error('websocket() routes on the Hono backend (Bun) require "hono".  '
+                + 'Install it with: bun add hono\nOriginal error: '
+                + (e instanceof Error ? e.message : String(e)));
+        }
+        const { upgradeWebSocket, websocket } = mod.createBunWebSocket();
+        return {
+            upgradeWebSocket: upgradeWebSocket,
+            serveOptions: { websocket },
+        };
+    }
 }
 //# sourceMappingURL=BunHonoRunner.js.map

package/dist/runtime/http/BunHonoRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"BunHonoRunner.js","sourceRoot":"","sources":["../../../src/runtime/http/BunHonoRunner.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,KAAK,CAAC,IAAyD;QACnE,MAAM,GAAG,GAAI,UAAuC,CAAC,GAAG,CAAC;QACzD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC;YACvB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI;YAClC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,CAAC,IAAI,CAAC,QAAiB,IAAmB,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SACzE,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"BunHonoRunner.js","sourceRoot":"","sources":["../../../src/runtime/http/BunHonoRunner.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,KAAK,CAAC,IAAgF;QAC1F,MAAM,GAAG,GAAI,UAAuC,CAAC,GAAG,CAAC;QACzD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC;YACvB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;SAC7B,CAAC,CAAC;QACH,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI;YAClC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,CAAC,IAAI,CAAC,QAAiB,IAAmB,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SACzE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAa;QAC3B,IAAI,GAAoF,CAAC;QACzF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,UAAU,CAAC;YACxB,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAe,CAAC;QAC3C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,gEAAgE;kBAC5D,iDAAiD;kBACjD,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACjD,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACjE,OAAO;YACL,gBAAgB,EAAE,gBAA2D;YAC7E,YAAY,EAAE,EAAE,SAAS,EAAE;SAC5B,CAAC;IACJ,CAAC;CACF"}

package/dist/runtime/http/DenoHonoRunner.d.ts

@@ -1,16 +1,19 @@
-import type { FetchHandler, HonoServerHandle, HonoServerRunner } from './HonoServerRunner.js';
+import type { FetchHandler, HonoServerHandle, HonoServerRunner, HonoWebSocketBridge } from './HonoServerRunner.js';
 /**
  * Deno implementation — `Deno.serve({ hostname, port }, fetch)`.
  * Returns a `HttpServer` with `.shutdown()` for graceful stop and
  * `.unref()` + `AbortController` for hard stop.
  *
- * Requires `--allow-net` to bind the listener.
+ * Requires `--allow-net` to bind the listener.  WebSocket support uses
+ * `upgradeWebSocket` from `hono/deno` (which wraps `Deno.upgradeWebSocket`).
  */
 export declare class DenoHonoRunner implements HonoServerRunner {
     serve(opts: {
         host: string;
         port: number;
         fetch: FetchHandler;
+        serveOptions?: object;
     }): Promise<HonoServerHandle>;
+    webSocket(_app: unknown): Promise<HonoWebSocketBridge>;
 }
 //# sourceMappingURL=DenoHonoRunner.d.ts.map

package/dist/runtime/http/DenoHonoRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DenoHonoRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/DenoHonoRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9F;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,gBAAgB;IAC/C,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAoBlG"}
+{"version":3,"file":"DenoHonoRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/DenoHonoRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;GAOG;AACH,qBAAa,cAAe,YAAW,gBAAgB;IAC/C,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqBlH,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAiB7D"}