actor-ts 0.9.1 → 0.11.0

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

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;AAE/D,OAAO,KAAK,EAAE,0BAA0B,EAAkC,MAAM,iCAAiC,CAAC;AAUlH;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,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;IAQ9C,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

@@ -1,6 +1,7 @@
 import { getSqliteDriver } from '../../runtime/sqlite/index.js';
 import { JournalError } from '../JournalTypes.js';
 import { none, some } from '../../util/Option.js';
+import { assertSafeIdentifier } from '../storage/SqlIdentifier.js';
 /**
  * SQLite-backed SnapshotStore — JSON payloads, single table, prune-on-save.
  * Works on Bun (`bun:sqlite`) and Node.js (`better-sqlite3`) via the
@@ -16,9 +17,11 @@ export class SqliteSnapshotStore {
     stmts = null;
     initPromise = null;
     constructor(options = {}) {
-        this.options = options;
-        this.table = options.snapshotsTable ?? 'snapshots';
-        this.keepN = options.keepN ?? 3;
+        const resolvedOptions = options;
+        this.options = resolvedOptions;
+        // Interpolated into DDL/DML — validate against SQL injection (#6).
+        this.table = assertSafeIdentifier(resolvedOptions.snapshotsTable ?? 'snapshots', 'snapshots table');
+        this.keepN = resolvedOptions.keepN ?? 3;
     }
     async save(pid, seq, state, _options) {
         // SQLite store has no compression / encryption — options ignored.

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/persistence/storage/KeyValidator.js

@@ -50,10 +50,10 @@ export function makeKeyValidator(rules) {
         // are on (matches the pre-refactor MemcachedCache behaviour).
         if (rejectControlChars) {
             for (let i = 0; i < key.length; i++) {
-                const c = key.charCodeAt(i);
-                if (c <= 0x1F || c === 0x7F) {
+                const charCode = key.charCodeAt(i);
+                if (charCode <= 0x1F || charCode === 0x7F) {
                     throw new errorClass(`${errorPrefix}: contains control character at index ${i} ` +
-                        `(charCode=${c}) — would allow protocol injection`);
+                        `(charCode=${charCode}) — would allow protocol injection`);
                 }
             }
         }

package/dist/persistence/storage/KeyValidator.js.map

@@ -1 +1 @@
-{"version":3,"file":"KeyValidator.js","sourceRoot":"","sources":["../../../src/persistence/storage/KeyValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AA8CH;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACxD,MAAM,EACJ,UAAU,EACV,WAAW,EACX,SAAS,GAAG,CAAC,EACb,SAAS,EACT,SAAS,GAAG,IAAI,EAChB,kBAAkB,GAAG,KAAK,EAC1B,WAAW,GAAG,KAAK,EACnB,mBAAmB,GAAG,KAAK,EAC3B,uBAAuB,GAAG,KAAK,GAChC,GAAG,KAAK,CAAC;IAEV,OAAO,CAAC,GAAW,EAAQ,EAAE;QAC3B,mEAAmE;QACnE,4BAA4B;QAC5B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACtD,MAAM,IAAI,UAAU,CAAC,GAAG,WAAW,8BAA8B,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACtD,MAAM,IAAI,UAAU,CAAC,GAAG,WAAW,aAAa,SAAS,oBAAoB,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9F,CAAC;QACD,kEAAkE;QAClE,4DAA4D;QAC5D,gEAAgE;QAChE,8DAA8D;QAC9D,IAAI,kBAAkB,EAAE,CAAC;YACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBAC5B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC5B,MAAM,IAAI,UAAU,CAClB,GAAG,WAAW,yCAAyC,CAAC,GAAG;wBAC3D,aAAa,CAAC,oCAAoC,CACnD,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QACD,gEAAgE;QAChE,8DAA8D;QAC9D,8DAA8D;QAC9D,sDAAsD;QACtD,qBAAqB;QACrB,IAAI,SAAS,IAAI,CAAC,kBAAkB,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,UAAU,CAAC,GAAG,WAAW,wBAAwB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;gBAClB,MAAM,IAAI,UAAU,CAClB,GAAG,WAAW,6BAA6B,QAAQ,mCAAmC,CACvF,CAAC;YACJ,CAAC;QACH,CAAC;QACD,wEAAwE;QACxE,IAAI,mBAAmB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACxG,MAAM,IAAI,UAAU,CAAC,GAAG,WAAW,qCAAqC,GAAG,GAAG,CAAC,CAAC;QAClF,CAAC;QACD,mEAAmE;QACnE,qCAAqC;QACrC,IAAI,uBAAuB,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,UAAU,CAClB,GAAG,WAAW,qDAAqD,GAAG,GAAG,CAC1E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"KeyValidator.js","sourceRoot":"","sources":["../../../src/persistence/storage/KeyValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AA8CH;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACxD,MAAM,EACJ,UAAU,EACV,WAAW,EACX,SAAS,GAAG,CAAC,EACb,SAAS,EACT,SAAS,GAAG,IAAI,EAChB,kBAAkB,GAAG,KAAK,EAC1B,WAAW,GAAG,KAAK,EACnB,mBAAmB,GAAG,KAAK,EAC3B,uBAAuB,GAAG,KAAK,GAChC,GAAG,KAAK,CAAC;IAEV,OAAO,CAAC,GAAW,EAAQ,EAAE;QAC3B,mEAAmE;QACnE,4BAA4B;QAC5B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACtD,MAAM,IAAI,UAAU,CAAC,GAAG,WAAW,8BAA8B,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACtD,MAAM,IAAI,UAAU,CAAC,GAAG,WAAW,aAAa,SAAS,oBAAoB,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9F,CAAC;QACD,kEAAkE;QAClE,4DAA4D;QAC5D,gEAAgE;QAChE,8DAA8D;QAC9D,IAAI,kBAAkB,EAAE,CAAC;YACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBACnC,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBAC1C,MAAM,IAAI,UAAU,CAClB,GAAG,WAAW,yCAAyC,CAAC,GAAG;wBAC3D,aAAa,QAAQ,oCAAoC,CAC1D,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QACD,gEAAgE;QAChE,8DAA8D;QAC9D,8DAA8D;QAC9D,sDAAsD;QACtD,qBAAqB;QACrB,IAAI,SAAS,IAAI,CAAC,kBAAkB,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,UAAU,CAAC,GAAG,WAAW,wBAAwB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;gBAClB,MAAM,IAAI,UAAU,CAClB,GAAG,WAAW,6BAA6B,QAAQ,mCAAmC,CACvF,CAAC;YACJ,CAAC;QACH,CAAC;QACD,wEAAwE;QACxE,IAAI,mBAAmB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACxG,MAAM,IAAI,UAAU,CAAC,GAAG,WAAW,qCAAqC,GAAG,GAAG,CAAC,CAAC;QAClF,CAAC;QACD,mEAAmE;QACnE,qCAAqC;QACrC,IAAI,uBAAuB,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,UAAU,CAClB,GAAG,WAAW,qDAAqD,GAAG,GAAG,CAC1E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/persistence/storage/SqlIdentifier.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Assert that `name` is a safe SQL/CQL identifier (table name, keyspace, …).
+ *
+ * Identifiers cannot be passed as bound parameters, so backends interpolate
+ * them straight into DDL/DML.  An identifier sourced from configuration must
+ * therefore be validated or it becomes an injection vector (security audit
+ * #6).  Shared by the SQLite and Cassandra backends; Postgres/MariaDB carry
+ * their own equivalent in their client modules.
+ */
+export declare function assertSafeIdentifier(name: string, what: string): string;
+//# sourceMappingURL=SqlIdentifier.d.ts.map

package/dist/persistence/storage/SqlIdentifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlIdentifier.d.ts","sourceRoot":"","sources":["../../../src/persistence/storage/SqlIdentifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvE"}

package/dist/persistence/storage/SqlIdentifier.js

@@ -0,0 +1,16 @@
+/**
+ * Assert that `name` is a safe SQL/CQL identifier (table name, keyspace, …).
+ *
+ * Identifiers cannot be passed as bound parameters, so backends interpolate
+ * them straight into DDL/DML.  An identifier sourced from configuration must
+ * therefore be validated or it becomes an injection vector (security audit
+ * #6).  Shared by the SQLite and Cassandra backends; Postgres/MariaDB carry
+ * their own equivalent in their client modules.
+ */
+export function assertSafeIdentifier(name, what) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
+        throw new Error(`unsafe ${what} identifier ${JSON.stringify(name)} — must match /^[A-Za-z_][A-Za-z0-9_]*$/`);
+    }
+    return name;
+}
+//# sourceMappingURL=SqlIdentifier.js.map

package/dist/persistence/storage/SqlIdentifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlIdentifier.js","sourceRoot":"","sources":["../../../src/persistence/storage/SqlIdentifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,IAAY;IAC7D,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,0CAA0C,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runtime/detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/runtime/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAwBlD,6DAA6D;AAC7D,wBAAgB,aAAa,IAAI,WAAW,CAA8B;AAE1E,4CAA4C;AAC5C,wBAAgB,MAAM,IAAI,OAAO,CAAyC;AAE1E,6CAA6C;AAC7C,wBAAgB,OAAO,IAAI,OAAO,CAA0C;AAE5E;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAQnC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAE9D"}
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/runtime/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAwBlD,6DAA6D;AAC7D,wBAAgB,aAAa,IAAI,WAAW,CAA8B;AAE1E,4CAA4C;AAC5C,wBAAgB,MAAM,IAAI,OAAO,CAAmD;AAEpF,6CAA6C;AAC7C,wBAAgB,OAAO,IAAI,OAAO,CAAoD;AAEtF;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAQnC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAE9D"}

package/dist/runtime/detect.js

@@ -11,7 +11,7 @@
  * The module has no dependencies and no side effects beyond the memoised
  * cache — it is safe to import from any layer.
  */
-const g = globalThis;
+const globalScope = globalThis;
 import { Lazy } from '../util/Lazy.js';
 /**
  * The detected runtime.  `Lazy.of(...)` runs the detection once and then
@@ -19,18 +19,18 @@ import { Lazy } from '../util/Lazy.js';
  * `Lazy.setOverride` under the hood — no explicit cache bookkeeping.
  */
 const runtimeLazy = Lazy.of(() => {
-    if (typeof g.Bun !== 'undefined')
+    if (typeof globalScope.Bun !== 'undefined')
         return 'bun';
-    if (typeof g.Deno !== 'undefined')
+    if (typeof globalScope.Deno !== 'undefined')
         return 'deno';
     return 'node';
 });
 /** Returns the current runtime.  Cached after first call. */
 export function detectRuntime() { return runtimeLazy.get(); }
 /** True iff `globalThis.Bun` is present. */
-export function hasBun() { return typeof g.Bun !== 'undefined'; }
+export function hasBun() { return typeof globalScope.Bun !== 'undefined'; }
 /** True iff `globalThis.Deno` is present. */
-export function hasDeno() { return typeof g.Deno !== 'undefined'; }
+export function hasDeno() { return typeof globalScope.Deno !== 'undefined'; }
 /**
  * High-resolution timestamp in nanoseconds.  Uses `Bun.nanoseconds()` when
  * available (it is truly ns-resolution); otherwise falls back to
@@ -39,10 +39,10 @@ export function hasDeno() { return typeof g.Deno !== 'undefined'; }
  * purposes (individual iteration jitter swamps any sub-µs accuracy).
  */
 export function highResNow() {
-    const bunNs = g.Bun?.nanoseconds;
+    const bunNs = globalScope.Bun?.nanoseconds;
     if (typeof bunNs === 'function')
         return bunNs();
-    const perf = g.performance;
+    const perf = globalScope.performance;
     if (perf && typeof perf.now === 'function')
         return perf.now() * 1_000_000;
     // Last-resort: Date.now() has ms resolution.  Any benchmark running in

package/dist/runtime/detect.js.map

@@ -1 +1 @@
-{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/runtime/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,MAAM,CAAC,GAAgB,UAAoC,CAAC;AAE5D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,GAAsB,IAAI,CAAC,EAAE,CAAc,GAAG,EAAE;IAC/D,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC;IACjD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,UAAU,aAAa,KAAkB,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAE1E,4CAA4C;AAC5C,MAAM,UAAU,MAAM,KAAc,OAAO,OAAO,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC;AAE1E,6CAA6C;AAC7C,MAAM,UAAU,OAAO,KAAc,OAAO,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC;IACjC,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC;IAC3B,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAC1E,uEAAuE;IACvE,qDAAqD;IACrD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,CAAqB;IACtD,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/runtime/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,MAAM,WAAW,GAAgB,UAAoC,CAAC;AAEtE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,GAAsB,IAAI,CAAC,EAAE,CAAc,GAAG,EAAE;IAC/D,IAAI,OAAO,WAAW,CAAC,GAAG,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IACzD,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC;IAC3D,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,UAAU,aAAa,KAAkB,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAE1E,4CAA4C;AAC5C,MAAM,UAAU,MAAM,KAAc,OAAO,OAAO,WAAW,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC;AAEpF,6CAA6C;AAC7C,MAAM,UAAU,OAAO,KAAc,OAAO,OAAO,WAAW,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC;IAC3C,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC;IACrC,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAC1E,uEAAuE;IACvE,qDAAqD;IACrD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,CAAqB;IACtD,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAC7B,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"}

package/dist/runtime/http/DenoHonoRunner.js

@@ -3,7 +3,8 @@
  * 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 class DenoHonoRunner {
     async serve(opts) {
@@ -12,7 +13,7 @@ export class DenoHonoRunner {
             throw new Error('DenoHonoRunner requires Deno runtime (globalThis.Deno.serve).');
         }
         const ac = new AbortController();
-        const server = deno.serve({ hostname: opts.host, port: opts.port, signal: ac.signal }, opts.fetch);
+        const server = deno.serve({ hostname: opts.host, port: opts.port, signal: ac.signal, ...(opts.serveOptions ?? {}) }, opts.fetch);
         return {
             host: opts.host,
             port: opts.port,
@@ -29,5 +30,21 @@ export class DenoHonoRunner {
             },
         };
     }
+    async webSocket(_app) {
+        let mod;
+        try {
+            const name = 'hono/deno';
+            mod = (await import(name));
+        }
+        catch (e) {
+            throw new Error('websocket() routes on the Hono backend (Deno) require "hono".  '
+                + 'Install it with: deno add npm:hono\nOriginal error: '
+                + (e instanceof Error ? e.message : String(e)));
+        }
+        return {
+            upgradeWebSocket: mod.upgradeWebSocket,
+            serveOptions: {},
+        };
+    }
 }
 //# sourceMappingURL=DenoHonoRunner.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"DenoHonoRunner.js","sourceRoot":"","sources":["../../../src/runtime/http/DenoHonoRunner.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,KAAK,CAAC,IAAyD;QACnE,MAAM,IAAI,GAAI,UAAoC,CAAC,IAAI,CAAC;QACxD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACnG,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,CAAC,IAAI,CAAC,QAAiB;gBAC1B,IAAI,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;oBACtD,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACxB,OAAO;gBACT,CAAC;gBACD,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,CAAC;oBAAC,MAAM,MAAM,CAAC,QAAQ,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACvD,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"DenoHonoRunner.js","sourceRoot":"","sources":["../../../src/runtime/http/DenoHonoRunner.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,KAAK,CAAC,IAAgF;QAC1F,MAAM,IAAI,GAAI,UAAoC,CAAC,IAAI,CAAC;QACxD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjI,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,CAAC,IAAI,CAAC,QAAiB;gBAC1B,IAAI,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;oBACtD,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACxB,OAAO;gBACT,CAAC;gBACD,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,CAAC;oBAAC,MAAM,MAAM,CAAC,QAAQ,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACvD,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAa;QAC3B,IAAI,GAAkC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,WAAW,CAAC;YACzB,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAe,CAAC;QAC3C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,iEAAiE;kBAC7D,sDAAsD;kBACtD,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CACjD,CAAC;QACJ,CAAC;QACD,OAAO;YACL,gBAAgB,EAAE,GAAG,CAAC,gBAA2D;YACjF,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;CACF"}

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

@@ -16,13 +16,52 @@ export type FetchHandler = (request: Request) => Promise<Response> | Response;
 export interface HonoServerHandle {
     readonly host: string;
     readonly port: number;
+    /** Underlying native server (e.g. the node:http Server on Node) — used by
+     *  `@hono/node-ws`'s `injectWebSocket`.  Absent on Bun/Deno. */
+    readonly raw?: unknown;
     stop(graceful: boolean): Promise<void>;
 }
+/** Hono's per-runtime WSContext (the socket handed to the event callbacks). */
+export interface WSContextLike {
+    send(data: string | ArrayBuffer | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+    readonly readyState: number;
+    readonly protocol?: string;
+    readonly raw?: unknown;
+}
+/** The events object a Hono `upgradeWebSocket` factory returns. */
+export interface WSEventsLike {
+    onOpen?(evt: unknown, ws: WSContextLike): void;
+    onMessage?(evt: {
+        data: unknown;
+    }, ws: WSContextLike): void;
+    onClose?(evt: {
+        code?: number;
+        reason?: string;
+    }, ws: WSContextLike): void;
+    onError?(evt: unknown, ws: WSContextLike): void;
+}
+/** Hono `upgradeWebSocket` middleware factory. */
+export type UpgradeWebsocketFn = (createEvents: (c: unknown) => WSEventsLike) => unknown;
+/**
+ * Per-runtime WebSocket bridge.  `upgradeWebSocket` is Hono's middleware
+ * factory; `serveOptions` are extra options folded into `serve()` (Bun
+ * needs `{ websocket }`); `attach` runs post-listen wiring (Node needs
+ * `injectWebSocket(server)`).
+ */
+export interface HonoWebsocketBridge {
+    readonly upgradeWebSocket: UpgradeWebsocketFn;
+    readonly serveOptions: object;
+    readonly attach?: (handle: HonoServerHandle) => void;
+}
 export interface HonoServerRunner {
     serve(opts: {
         host: string;
         port: number;
         fetch: FetchHandler;
+        serveOptions?: object;
     }): Promise<HonoServerHandle>;
+    /** Optional capability — all three built-in runners implement it. */
+    webSocket?(app: unknown): Promise<HonoWebsocketBridge>;
 }
 //# sourceMappingURL=HonoServerRunner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"HonoServerRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/HonoServerRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,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,CAAC;CAC7F"}
+{"version":3,"file":"HonoServerRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/HonoServerRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;oEACgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/C,SAAS,CAAC,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5D,OAAO,CAAC,CAAC,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3E,OAAO,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC;CACjD;AAED,kDAAkD;AAClD,MAAM,MAAM,kBAAkB,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,YAAY,KAAK,OAAO,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,gBAAgB;IAC/B,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,CAAC;IACnH,qEAAqE;IACrE,SAAS,CAAC,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACxD"}

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

@@ -1,4 +1,4 @@
-import type { FetchHandler, HonoServerHandle, HonoServerRunner } from './HonoServerRunner.js';
+import type { FetchHandler, HonoServerHandle, HonoServerRunner, HonoWebsocketBridge } from './HonoServerRunner.js';
 /**
  * Node.js implementation — `@hono/node-server`'s `serve()`, which wraps a
  * `node:http` server around a standard fetch handler.  Graceful stop calls
@@ -14,6 +14,8 @@ export declare class NodeHonoRunner implements HonoServerRunner {
         host: string;
         port: number;
         fetch: FetchHandler;
+        serveOptions?: object;
     }): Promise<HonoServerHandle>;
+    webSocket(app: unknown): Promise<HonoWebsocketBridge>;
 }
 //# sourceMappingURL=NodeHonoRunner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"NodeHonoRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/NodeHonoRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9F;;;;;;;;;GASG;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;CA0ClG"}
+{"version":3,"file":"NodeHonoRunner.d.ts","sourceRoot":"","sources":["../../../src/runtime/http/NodeHonoRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;GASG;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;IA4ClH,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA0B5D"}