@lostgradient/weft 0.11.0 → 0.12.0

package/dist/service-worker/setup.d.ts

@@ -10,7 +10,7 @@
  *
  * @module service-worker/setup
  */
-import { Engine } from '../core/engine';
+import { Engine, type RegistryAgnosticEngine } from '../core/engine';
 import type { Storage as WeftStorage } from '../storage/interface';
 import { ServiceWorkerScheduler } from './scheduler';
 /**
@@ -47,8 +47,12 @@ export interface SetupServiceWorkerOptions {
     /**
      * Pre-built engine. If provided, must use the same storage instance as
      * `options.storage` (or its own storage if `storage` is omitted).
+     *
+     * Typed as {@link RegistryAgnosticEngine} (see its JSDoc) rather than the
+     * plain default `Engine`, so both `new Engine({ storage })` and
+     * `Engine.create({ workflows })` type-check here directly.
      */
-    engine?: Engine;
+    engine?: RegistryAgnosticEngine;
     /**
      * Pre-built storage instance. Must be the same `===` reference as the
      * engine's storage when both are provided.

package/dist/storage/auto.js

@@ -1,2 +1,2 @@
 // @bun
-var F=Object.defineProperty;var P=(z)=>z;function k(z,C){this[z]=P.bind(null,C)}var T=(z,C)=>{for(var J in C)F(z,J,{get:C[J],enumerable:!0,configurable:!0,set:k.bind(C,J)})};var h=(z,C)=>()=>(z&&(C=z(z=0)),C);var Z=import.meta.require,O=(z,C,J)=>{if(C!=null){if(typeof C!=="object"&&typeof C!=="function")throw TypeError('Object expected to be assigned to "using" declaration');let K;if(J)K=C[Symbol.asyncDispose];if(K===void 0)K=C[Symbol.dispose];if(typeof K!=="function")throw TypeError("Object not disposable");z.push([J,K,C])}else if(J)z.push([J]);return C},y=(z,C,J)=>{let K=(V)=>C=J?new SuppressedError(V,C,"An error was suppressed during disposal"):(J=!0,V),Y=(V)=>{while(V=z.pop())try{var A=V[1]&&V[1].call(V[2]);if(V[0])return Promise.resolve(A).then(Y,(q)=>(K(q),Y()))}catch(q){K(q)}if(J)throw C};return Y()};function Q(z){return{hasBun:typeof z.Bun<"u",hasIndexedDB:typeof z.indexedDB<"u",hasNode:z.process!==void 0&&typeof z.process.versions?.node==="string",hasWebExtensionStorage:z.browser?.storage!==void 0||z.chrome?.storage!==void 0}}async function U(z){let{createHash:C}=await import("crypto"),J=z.process?.cwd?.()??"weft-default";return C("sha256").update(J).digest("hex").slice(0,16)}async function X(z){let[{mkdirSync:C},{tmpdir:J},K]=await Promise.all([import("fs"),import("os"),import("path")]),Y=z.process?.env?.WEFT_DEFAULT_STORAGE_PATH,V=Y!==void 0&&Y.length>0?Y:K.join(J(),"weft-default",`${await U(z)}.db`);return C(K.dirname(V),{recursive:!0}),V}function H(z,C){if(C==="Bun")return typeof z.Bun;if(C==="browser.storage")return typeof(z.browser?.storage??z.chrome?.storage);return typeof z.process}function j(z,C){return import.meta.url.endsWith(".ts")?z:C}async function $(z){return await import(z)}function W(z){if(z.browser?.storage!==void 0)return z.browser;if(z.chrome?.storage!==void 0)return z.chrome;return{}}function B(z){let{indexedDB:C,IDBKeyRange:J}=z;if(C===void 0||J===void 0)throw Error("resolveDefaultStorage: IndexedDB resolution requires both indexedDB and IDBKeyRange.");return{indexedDB:C,IDBKeyRange:J}}function N(z){let C=typeof z.indexedDB,J=typeof z.IDBKeyRange;return`typeof indexedDB=${C}, typeof IDBKeyRange=${J}`}var w=j("./bun-sql.ts","./bun-sql.js"),I=j("./node-sqlite.ts","./node-sqlite.js"),L=j("./indexeddb.ts","./indexeddb.js"),R=j("./web-extension.ts","./web-extension.js");async function v(z=globalThis){let C=Q(z);if(C.hasBun){let{BunSQLiteStorage:J}=await $(w);return new J(await X(z))}if(C.hasNode){let{NodeSQLiteStorage:J}=await $(I);return new J(await X(z))}if(C.hasWebExtensionStorage){let{WebExtensionStorage:J}=await $(R);return new J({},W(z))}if(C.hasIndexedDB){let{IndexedDBStorage:J}=await $(L);return new J("weft",B(z))}throw Error(`resolveDefaultStorage: requires Bun, Node, WebExtension storage, or IndexedDB. Detected: typeof Bun=${H(z,"Bun")}, typeof process=${H(z,"process")}, typeof browser.storage=${H(z,"browser.storage")}, ${N(z)}.`)}export{v as resolveDefaultStorage};
+var Z=import.meta.require,I=(z,C,J)=>{if(C!=null){if(typeof C!=="object"&&typeof C!=="function")throw TypeError('Object expected to be assigned to "using" declaration');let K;if(J)K=C[Symbol.asyncDispose];if(K===void 0)K=C[Symbol.dispose];if(typeof K!=="function")throw TypeError("Object not disposable");z.push([J,K,C])}else if(J)z.push([J]);return C},L=(z,C,J)=>{let K=(V)=>C=J?new SuppressedError(V,C,"An error was suppressed during disposal"):(J=!0,V),Y=(V)=>{while(V=z.pop())try{var A=V[1]&&V[1].call(V[2]);if(V[0])return Promise.resolve(A).then(Y,(q)=>(K(q),Y()))}catch(q){K(q)}if(J)throw C};return Y()};function F(z){return{hasBun:typeof z.Bun<"u",hasIndexedDB:typeof z.indexedDB<"u",hasNode:z.process!==void 0&&typeof z.process.versions?.node==="string",hasWebExtensionStorage:z.browser?.storage!==void 0||z.chrome?.storage!==void 0}}async function P(z){let{createHash:C}=await import("crypto"),J=z.process?.cwd?.()??"weft-default";return C("sha256").update(J).digest("hex").slice(0,16)}async function X(z){let[{mkdirSync:C},{tmpdir:J},K]=await Promise.all([import("fs"),import("os"),import("path")]),Y=z.process?.env?.WEFT_DEFAULT_STORAGE_PATH,V=Y!==void 0&&Y.length>0?Y:K.join(J(),"weft-default",`${await P(z)}.db`);return C(K.dirname(V),{recursive:!0}),V}function H(z,C){if(C==="Bun")return typeof z.Bun;if(C==="browser.storage")return typeof(z.browser?.storage??z.chrome?.storage);return typeof z.process}function j(z,C){return import.meta.url.endsWith(".ts")?z:C}async function $(z){return await import(z)}function k(z){if(z.browser?.storage!==void 0)return z.browser;if(z.chrome?.storage!==void 0)return z.chrome;return{}}function Q(z){let{indexedDB:C,IDBKeyRange:J}=z;if(C===void 0||J===void 0)throw Error("resolveDefaultStorage: IndexedDB resolution requires both indexedDB and IDBKeyRange.");return{indexedDB:C,IDBKeyRange:J}}function U(z){let C=typeof z.indexedDB,J=typeof z.IDBKeyRange;return`typeof indexedDB=${C}, typeof IDBKeyRange=${J}`}var W=j("./bun-sql.ts","./bun-sql.js"),B=j("./node-sqlite.ts","./node-sqlite.js"),N=j("./indexeddb.ts","./indexeddb.js"),w=j("./web-extension.ts","./web-extension.js");async function T(z=globalThis){let C=F(z);if(C.hasBun){let{BunSQLiteStorage:J}=await $(W);return new J(await X(z))}if(C.hasNode){let{NodeSQLiteStorage:J}=await $(B);return new J(await X(z))}if(C.hasWebExtensionStorage){let{WebExtensionStorage:J}=await $(w);return new J({},k(z))}if(C.hasIndexedDB){let{IndexedDBStorage:J}=await $(N);return new J("weft",Q(z))}throw Error(`resolveDefaultStorage: requires Bun, Node, WebExtension storage, or IndexedDB. Detected: typeof Bun=${H(z,"Bun")}, typeof process=${H(z,"process")}, typeof browser.storage=${H(z,"browser.storage")}, ${U(z)}.`)}export{T as resolveDefaultStorage};

package/dist/storage/bun-sql.js

@@ -391,19 +391,19 @@ function buildSqliteKeyRangeQuery(prefix, options = {}) {
     sqlSuffix: `WHERE ${conditions.join(" AND ")} ORDER BY key ${direction}${limitClause}`
   };
 }
-function buildSqliteKeyRangeDelete(prefix, options) {
+function buildSqliteKeyRangeDelete(prefix, options, table = "kv") {
   const { conditions, parameters } = buildSqliteKeyRangeConditions(prefix, options);
   const whereClause = conditions.join(" AND ");
   if (options.limit === undefined) {
     return {
       parameters,
-      sql: `DELETE FROM kv WHERE ${whereClause}`
+      sql: `DELETE FROM ${table} WHERE ${whereClause}`
     };
   }
   parameters.push(options.limit);
   return {
     parameters,
-    sql: `DELETE FROM kv WHERE key IN (SELECT key FROM kv WHERE ${whereClause} ORDER BY key ASC LIMIT ?)`
+    sql: `DELETE FROM ${table} WHERE key IN (SELECT key FROM ${table} WHERE ${whereClause} ORDER BY key ASC LIMIT ?)`
   };
 }
 function buildSqliteKeyValueRangeSelect(prefix, options = {}) {

package/dist/storage/cloudflare-durable-object-sql.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Minimal structural view of a Cloudflare Durable Object's `ctx.storage.sql`
+ * binding.
+ *
+ * Deliberately hand-written instead of importing `@cloudflare/workers-types`:
+ * the real binding's `.exec()` method is synchronous (it runs against
+ * transactional local storage with no I/O wait), and this structural
+ * interface only needs the slice of that surface the adapter actually calls.
+ * Any object satisfying this shape — the real Durable Object binding, or a
+ * test double backed by `bun:sqlite` — works as `sql`.
+ *
+ * @module storage/cloudflare-durable-object-sql
+ */
+/**
+ * The value types a Durable Object SQL column can hold.
+ *
+ * @example
+ * ```ts
+ * import type { SqlStorageValue } from '@lostgradient/weft/storage/cloudflare';
+ *
+ * const bound: SqlStorageValue = 'a bound query parameter';
+ * void bound;
+ * ```
+ */
+export type SqlStorageValue = ArrayBuffer | string | number | null;
+/**
+ * The lazily-iterated result of one `Sql.exec()` call. Matches the subset of
+ * Cloudflare's `SqlStorageCursor` this adapter reads: row iteration.
+ *
+ * Deliberately omits `rowsWritten`: on the real Durable Object binding that
+ * field is a billing counter that also counts index writes, not a logical
+ * rows-affected count — this `kv` table's implicit primary-key index means a
+ * single-row `DELETE` can report more than one. `deletePrefix()` and
+ * `deleteRange()` instead read the logical count with a same-connection
+ * `SELECT changes()` query run immediately after the write, with no `await`
+ * in between (see `cloudflare.ts`).
+ *
+ * On the real binding, `exec()` runs the statement immediately — iterating
+ * only consumes the already-computed result, it does not defer execution.
+ *
+ * @example
+ * ```ts
+ * import type { Sql, SqlStorageCursor } from '@lostgradient/weft/storage/cloudflare';
+ *
+ * declare const sql: Sql;
+ * const cursor: SqlStorageCursor<{ key: string }> = sql.exec('SELECT key FROM kv');
+ * const rows = [...cursor];
+ * void rows;
+ * ```
+ */
+export type SqlStorageCursor<T = Record<string, SqlStorageValue>> = Iterable<T>;
+/**
+ * The structural shape of a Cloudflare Durable Object's `ctx.storage.sql`
+ * binding that this adapter depends on.
+ *
+ * `exec()` is synchronous by contract: Durable Object storage operations are
+ * transactional only up to the next `await` in the calling code, so every
+ * code path in {@link CloudflareDurableObjectSQLiteStorage} that needs that
+ * guarantee (`conditionalBatch`'s read-compare-write, `batch`'s multi-write,
+ * `scan`'s snapshot read) calls `exec()` with no `await` in between.
+ *
+ * @example
+ * ```ts
+ * import { CloudflareDurableObjectSQLiteStorage, type Sql } from '@lostgradient/weft/storage/cloudflare';
+ *
+ * // Injected by the Durable Object runtime: `ctx.storage.sql` inside a
+ * // `DurableObject` subclass.
+ * declare const sql: Sql;
+ * const storage = new CloudflareDurableObjectSQLiteStorage({ sql });
+ * void storage;
+ * ```
+ */
+export interface Sql {
+    exec<T = Record<string, SqlStorageValue>>(query: string, ...bindings: SqlStorageValue[]): SqlStorageCursor<T>;
+}

package/dist/storage/cloudflare-value-codec.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Value encoding for {@link CloudflareDurableObjectSQLiteStorage}'s `value`
+ * column: the default base64-`TEXT` encoding, and the opt-in raw
+ * `ArrayBuffer`/`BLOB` encoding.
+ *
+ * @module storage/cloudflare-value-codec
+ */
+import type { SqlStorageValue } from './cloudflare-durable-object-sql.ts';
+/**
+ * How {@link CloudflareDurableObjectSQLiteStorage} stores values in its
+ * `value` column.
+ *
+ * - `'base64'` (the default): values are base64-encoded and stored as
+ *   `TEXT`. Keeps the adapter's SQL binding contract to the TEXT/number/null
+ *   value types the Durable Object SQL binding guarantees, at the cost of
+ *   ~4/3 size expansion per value.
+ * - `'blob'`: values are bound and stored as raw `ArrayBuffer`/`BLOB`,
+ *   avoiding the base64 expansion. Requires the wider binding contract the
+ *   real Durable Object SQL binding also supports (`ArrayBuffer` bind
+ *   parameters and `BLOB` columns).
+ *
+ * @example
+ * ```ts
+ * import type { CloudflareValueEncoding } from '@lostgradient/weft/storage/cloudflare';
+ *
+ * const encoding: CloudflareValueEncoding = 'blob';
+ * void encoding;
+ * ```
+ */
+export type CloudflareValueEncoding = 'base64' | 'blob';
+/**
+ * A `value`-column codec: how to bind a `Uint8Array` as a SQL parameter, and
+ * how to decode a column value read back out. `sqlColumnType` is the
+ * declared type used only when `CREATE TABLE IF NOT EXISTS` creates a fresh
+ * table — SQLite's manifest typing means an already-existing table keeps
+ * whichever storage class (`TEXT` or `BLOB`) each row was actually written
+ * with, regardless of the column's declared type. That is exactly what lets
+ * {@link decode} on both codecs detect and reject a value written under the
+ * *other* encoding: reading a `TEXT` value with the `'blob'` codec (or a
+ * `BLOB` value with the `'base64'` codec) fails the type guard below and
+ * throws immediately, instead of silently misinterpreting the bytes.
+ *
+ * This is the cross-mode contract for
+ * {@link CloudflareDurableObjectSQLiteStorageOptions.valueEncoding}: a table
+ * must use a single `valueEncoding` for its lifetime. There is no dual-read
+ * fallback and no migration path between encodings — pick one per table.
+ */
+type CloudflareValueCodec = {
+    readonly sqlColumnType: 'TEXT' | 'BLOB';
+    encode(value: Uint8Array): SqlStorageValue;
+    decode(value: SqlStorageValue, key: string): Uint8Array;
+};
+/**
+ * Resolve a {@link CloudflareValueEncoding} to its {@link CloudflareValueCodec}.
+ *
+ * `valueEncoding` is a durable, per-table format choice (see
+ * {@link CloudflareValueCodec}'s docs on the cross-mode contract), so an
+ * unrecognized value is rejected outright rather than silently falling back
+ * to `'base64'` — the TypeScript type only guards callers who type-check;
+ * a caller passing an unvalidated string (a config value, a typo'd literal
+ * from plain JavaScript) must not have that typo silently pick the wrong
+ * on-disk format for a table.
+ */
+export declare function resolveCloudflareValueCodec(encoding: CloudflareValueEncoding): CloudflareValueCodec;
+export {};

package/dist/storage/cloudflare-value-codec.js

@@ -0,0 +1,46 @@
+const BASE64_CHUNK_SIZE = 32768;
+function bytesToBase64(bytes) {
+  let binary = "";
+  for (let offset = 0;offset < bytes.length; offset += BASE64_CHUNK_SIZE) {
+    const chunk = bytes.subarray(offset, offset + BASE64_CHUNK_SIZE);
+    binary += String.fromCharCode(...chunk);
+  }
+  return btoa(binary);
+}
+function base64ToBytes(base64) {
+  const binary = atob(base64), bytes = new Uint8Array(binary.length);
+  for (let index = 0;index < binary.length; index += 1)
+    bytes[index] = binary.charCodeAt(index);
+  return bytes;
+}
+function unexpectedValueTypeError(key, expectedEncoding, actualType) {
+  return Error(`Cloudflare Durable Object SQLite storage: key "${key}" holds a value of type ${actualType}, but this instance is configured for valueEncoding: '${expectedEncoding}'. A table must use a single, ` + "consistent valueEncoding for its lifetime \u2014 this row was written by an instance configured " + "with a different valueEncoding. Pick one encoding per table (or per-instance configured table name) and do not change it; there is no automatic migration between encodings.");
+}
+const base64Codec = {
+  sqlColumnType: "TEXT",
+  encode(value) {
+    return bytesToBase64(value);
+  },
+  decode(value, key) {
+    if (typeof value !== "string")
+      throw unexpectedValueTypeError(key, "base64", value === null ? "null" : typeof value);
+    return base64ToBytes(value);
+  }
+}, blobCodec = {
+  sqlColumnType: "BLOB",
+  encode(value) {
+    return new Uint8Array(value).buffer;
+  },
+  decode(value, key) {
+    if (!(value instanceof ArrayBuffer))
+      throw unexpectedValueTypeError(key, "blob", value === null ? "null" : typeof value);
+    return new Uint8Array(value);
+  }
+};
+export function resolveCloudflareValueCodec(encoding) {
+  if (encoding === "base64")
+    return base64Codec;
+  if (encoding === "blob")
+    return blobCodec;
+  throw Error(`Cloudflare Durable Object SQLite storage: valueEncoding must be 'base64' or 'blob', received ${JSON.stringify(encoding)}.`);
+}

package/dist/storage/cloudflare.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Cloudflare Durable Object SQLite storage adapter.
+ *
+ * Wraps a Durable Object's `ctx.storage.sql` binding (structurally typed as
+ * {@link Sql} — see `cloudflare-durable-object-sql.ts`) in the same `Storage`
+ * interface every other adapter implements, over a single key/value table.
+ * `@cloudflare/workers-types` is never imported: the structural `Sql`/
+ * `SqlStorageCursor` shape is enough to both type this adapter and drive it
+ * in tests with a `bun:sqlite`-backed double.
+ *
+ * This module has zero runtime-specific imports of its own — the `sql`
+ * binding is injected by the caller — so it is bundleable for Bun, Node, and
+ * the Cloudflare Workers (`workerd`) runtime alike. Import from
+ * `@lostgradient/weft/storage/cloudflare`.
+ *
+ * @module storage/cloudflare
+ */
+import type { Sql } from './cloudflare-durable-object-sql.ts';
+import { type CloudflareValueEncoding } from './cloudflare-value-codec.ts';
+import { type DeleteRangeOptions } from './delete-range.ts';
+import { type BatchOperation, type ConditionalBatchCondition, type ScanOptions, type Storage, type StorageCapabilities } from './interface.ts';
+export type { Sql, SqlStorageCursor, SqlStorageValue } from './cloudflare-durable-object-sql.ts';
+export type { CloudflareValueEncoding } from './cloudflare-value-codec.ts';
+/**
+ * Configuration for {@link CloudflareDurableObjectSQLiteStorage}.
+ *
+ * @example
+ * ```ts
+ * import type { CloudflareDurableObjectSQLiteStorageOptions } from '@lostgradient/weft/storage/cloudflare';
+ * import type { Sql } from '@lostgradient/weft/storage/cloudflare';
+ *
+ * declare const sql: Sql;
+ * const options: CloudflareDurableObjectSQLiteStorageOptions = { sql, table: 'weft_kv' };
+ * void options;
+ * ```
+ */
+export type CloudflareDurableObjectSQLiteStorageOptions = {
+    /** The Durable Object's `ctx.storage.sql` binding, or a structurally compatible double. */
+    sql: Sql;
+    /**
+     * Table name for the single key/value table this adapter reads and writes.
+     * Validated as a strict SQL identifier at construction; defaults to `kv`.
+     */
+    table?: string;
+    /**
+     * How values are stored in the `value` column. Defaults to `'base64'`
+     * (base64-encoded `TEXT`), which keeps this adapter's SQL binding contract
+     * to the TEXT/number/null value types the Durable Object SQL binding
+     * guarantees. Opt into `'blob'` to bind and store raw `ArrayBuffer`/`BLOB`
+     * values instead, avoiding base64's ~4/3 size expansion for large values —
+     * this requires the wider binding contract the real Durable Object SQL
+     * binding also supports.
+     *
+     * A table's `value` column holds whichever encoding wrote each row: pick
+     * one `valueEncoding` for a table's lifetime and do not change it. Reading
+     * a row written under the other encoding fails fast with a descriptive
+     * error rather than silently misinterpreting the bytes — see the
+     * `documentation/guides/storage.md` Cloudflare section for the full
+     * cross-mode contract.
+     */
+    valueEncoding?: CloudflareValueEncoding;
+};
+/**
+ * Storage adapter over a Cloudflare Durable Object's `ctx.storage.sql`
+ * binding.
+ *
+ * A **non-owning** view: the `sql` binding is injected, the Durable Object
+ * owns its storage connection, and `[Symbol.dispose]` is a no-op — there is
+ * nothing here to close.
+ *
+ * Schema is one `kv(key TEXT PRIMARY KEY, value ...)` table (name
+ * configurable via `table`). By default (`valueEncoding: 'base64'`) values
+ * are stored as base64-encoded text, keeping this adapter's SQL binding
+ * contract to the TEXT/number/null value types the Durable Object SQL
+ * binding guarantees. Set `valueEncoding: 'blob'` to bind and store raw
+ * `ArrayBuffer`/`BLOB` values instead — see
+ * {@link CloudflareDurableObjectSQLiteStorageOptions.valueEncoding}.
+ *
+ * `ctx.storage.sql.exec()` is synchronous — Durable Object storage is
+ * transactional only up to the next `await`/yield point in the calling code.
+ * Every method here that needs that guarantee (`batch`, `conditionalBatch`,
+ * `scan`) runs its `exec()` calls with no `await` in between, so a single
+ * `Storage` call from this adapter is one atomic unit of Durable Object
+ * storage work.
+ *
+ * `deletePrefix()` and `deleteRange()` are native single-statement `DELETE`s
+ * (not a scan-then-batch fallback), so `capabilities().boundedRangeDelete`
+ * is honestly `true`.
+ *
+ * @example
+ * ```ts
+ * import { CloudflareDurableObjectSQLiteStorage, type Sql } from '@lostgradient/weft/storage/cloudflare';
+ * import { Engine, workflow, type WorkflowContext } from '@lostgradient/weft';
+ *
+ * // Injected by the Durable Object runtime: `ctx.storage.sql` inside a
+ * // `DurableObject` subclass.
+ * declare const sql: Sql;
+ *
+ * const storage = new CloudflareDurableObjectSQLiteStorage({ sql });
+ *
+ * // Durable Objects drive their own event loop; there is no host process to
+ * // own background intervals, so the engine runs in manual maintenance mode
+ * // and the Durable Object alarm (or a Worker Cron Trigger) drives
+ * // `engine.runMaintenance()` explicitly.
+ * const engine = await Engine.create({
+ *   storage,
+ *   backgroundTasks: 'manual',
+ *   startScheduler: false,
+ * });
+ *
+ * engine.register(
+ *   workflow({ name: 'echo' }).execute(async function* (ctx: WorkflowContext, input: unknown) {
+ *     return input;
+ *   }),
+ * );
+ * ```
+ */
+export declare class CloudflareDurableObjectSQLiteStorage implements Storage {
+    #private;
+    constructor(options: CloudflareDurableObjectSQLiteStorageOptions);
+    capabilities(): StorageCapabilities;
+    get(key: string): Promise<Uint8Array | null>;
+    put(key: string, value: Uint8Array): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    count(prefix: string): Promise<number>;
+    deletePrefix(prefix: string): Promise<number>;
+    deleteRange(prefix: string, options: DeleteRangeOptions): Promise<number>;
+    scan(prefix: string, options?: ScanOptions): AsyncIterable<[string, Uint8Array]>;
+    keys(prefix: string, options?: ScanOptions): AsyncIterable<string>;
+    batch(operations: BatchOperation[]): Promise<void>;
+    conditionalBatch(conditions: ConditionalBatchCondition[], operations: BatchOperation[]): Promise<boolean>;
+    /**
+     * No-op. This adapter is a non-owning view over an injected `sql` binding
+     * — the Durable Object owns its storage connection, so there is nothing
+     * here to close. Disposing this adapter never touches `sql` beyond the
+     * ordinary reads/writes issued by the methods above.
+     */
+    [Symbol.dispose](): void;
+}

package/dist/storage/cloudflare.js

@@ -0,0 +1,127 @@
+import {
+  resolveCloudflareValueCodec
+} from "./cloudflare-value-codec.js";
+import { normalizeDeleteRangeOptions } from "./delete-range.js";
+import {
+  assertStorageBatchOperationCount,
+  storageValuesEqual
+} from "./interface.js";
+import { assertSqlIdentifier } from "./sql-identifier.js";
+import {
+  buildSqliteKeyRangeDelete,
+  buildSqliteKeyRangeQuery,
+  buildSqlitePrefixRangeParameters
+} from "./sqlite-key-value-queries.js";
+const DEFAULT_TABLE = "kv", DEFAULT_VALUE_ENCODING = "base64";
+
+export class CloudflareDurableObjectSQLiteStorage {
+  #sql;
+  #table;
+  #codec;
+  constructor(options) {
+    const { sql, table = DEFAULT_TABLE, valueEncoding = DEFAULT_VALUE_ENCODING } = options;
+    assertSqlIdentifier(table, "table", "Cloudflare Durable Object SQLite");
+    this.#sql = sql;
+    this.#table = table;
+    this.#codec = resolveCloudflareValueCodec(valueEncoding);
+    this.#sql.exec(`CREATE TABLE IF NOT EXISTS ${this.#table} (
+  key TEXT PRIMARY KEY,
+  value ${this.#codec.sqlColumnType} NOT NULL
+)`);
+  }
+  capabilities() {
+    return {
+      persistence: "local",
+      readAfterWrite: "linearizable",
+      scanConsistency: "snapshot",
+      atomicBatch: !0,
+      conditionalBatch: !0,
+      boundedRangeDelete: !0
+    };
+  }
+  async get(key) {
+    return this.#getSync(key);
+  }
+  async put(key, value) {
+    this.#putSync(key, value);
+  }
+  async delete(key) {
+    this.#deleteSync(key);
+  }
+  async has(key) {
+    return [
+      ...this.#sql.exec(`SELECT 1 AS present FROM ${this.#table} WHERE key = ? LIMIT 1`, key)
+    ].length > 0;
+  }
+  async count(prefix) {
+    const [rangeStart, rangeEnd] = buildSqlitePrefixRangeParameters(prefix);
+    return [
+      ...this.#sql.exec(`SELECT COUNT(*) AS count FROM ${this.#table} WHERE key >= ? AND key < ?`, rangeStart, rangeEnd)
+    ][0]?.count ?? 0;
+  }
+  async deletePrefix(prefix) {
+    const [rangeStart, rangeEnd] = buildSqlitePrefixRangeParameters(prefix);
+    this.#sql.exec(`DELETE FROM ${this.#table} WHERE key >= ? AND key < ?`, rangeStart, rangeEnd);
+    return this.#logicalChangeCount();
+  }
+  async deleteRange(prefix, options) {
+    const normalized = normalizeDeleteRangeOptions(options), { parameters, sql } = buildSqliteKeyRangeDelete(prefix, normalized, this.#table);
+    this.#sql.exec(sql, ...parameters);
+    return this.#logicalChangeCount();
+  }
+  #logicalChangeCount() {
+    return [...this.#sql.exec("SELECT changes() AS value")][0]?.value ?? 0;
+  }
+  async* scan(prefix, options = {}) {
+    const { parameters, sqlSuffix } = buildSqliteKeyRangeQuery(prefix, options), rows = [
+      ...this.#sql.exec(`SELECT key, value FROM ${this.#table} ${sqlSuffix}`, ...parameters)
+    ];
+    for (const row of rows)
+      yield [row.key, this.#codec.decode(row.value, row.key)];
+  }
+  async* keys(prefix, options = {}) {
+    const { parameters, sqlSuffix } = buildSqliteKeyRangeQuery(prefix, options), rows = [
+      ...this.#sql.exec(`SELECT key FROM ${this.#table} ${sqlSuffix}`, ...parameters)
+    ];
+    for (const row of rows)
+      yield row.key;
+  }
+  async batch(operations) {
+    assertStorageBatchOperationCount("batch operations", operations.length);
+    if (operations.length === 0)
+      return;
+    for (const operation of operations)
+      this.#applyOperation(operation);
+  }
+  async conditionalBatch(conditions, operations) {
+    assertStorageBatchOperationCount("conditionalBatch conditions", conditions.length);
+    assertStorageBatchOperationCount("conditionalBatch operations", operations.length);
+    for (const condition of conditions) {
+      const currentValue = this.#getSync(condition.key);
+      if (!storageValuesEqual(currentValue, condition.expectedValue))
+        return !1;
+    }
+    for (const operation of operations)
+      this.#applyOperation(operation);
+    return !0;
+  }
+  #getSync(key) {
+    const row = [
+      ...this.#sql.exec(`SELECT value FROM ${this.#table} WHERE key = ?`, key)
+    ][0];
+    return row ? this.#codec.decode(row.value, key) : null;
+  }
+  #putSync(key, value) {
+    this.#sql.exec(`INSERT INTO ${this.#table} (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value`, key, this.#codec.encode(value));
+  }
+  #deleteSync(key) {
+    this.#sql.exec(`DELETE FROM ${this.#table} WHERE key = ?`, key);
+  }
+  #applyOperation(operation) {
+    if (operation.type === "put")
+      this.#putSync(operation.key, operation.value);
+    else
+      this.#deleteSync(operation.key);
+  }
+  [Symbol.dispose]() {}
+}

package/dist/storage/compressed-storage.js

@@ -1,2 +1,2 @@
 // @bun
-var n=Object.defineProperty;var l=(W)=>W;function s(W,F){this[W]=l.bind(null,F)}var UW=(W,F)=>{for(var X in F)n(W,X,{get:F[X],enumerable:!0,configurable:!0,set:s.bind(F,X)})};var P=(W,F)=>()=>(W&&(F=W(W=0)),F);var VW=import.meta.require,PW=(W,F,X)=>{if(F!=null){if(typeof F!=="object"&&typeof F!=="function")throw TypeError('Object expected to be assigned to "using" declaration');let Y;if(X)Y=F[Symbol.asyncDispose];if(Y===void 0)Y=F[Symbol.dispose];if(typeof Y!=="function")throw TypeError("Object not disposable");W.push([X,Y,F])}else if(X)W.push([X]);return F},qW=(W,F,X)=>{let Y=($)=>F=X?new SuppressedError($,F,"An error was suppressed during disposal"):(X=!0,$),U=($)=>{while($=W.pop())try{var j=$[1]&&$[1].call($[2]);if($[0])return Promise.resolve(j).then(U,(D)=>(Y(D),U()))}catch(D){Y(D)}if(X)throw F};return U()};function S(W,F,X){if(!W.capabilities()[F])throw Error(`Feature "${X}" requires storage capability "${F}", but this storage backend does not provide it.`)}function d(W){let F=W.capabilities(),X=[];if(F.persistence!=="local"&&F.persistence!=="remote")X.push(`persistence must be "local" or "remote" (got "${F.persistence}")`);if(F.readAfterWrite!=="linearizable")X.push(`readAfterWrite must be "linearizable" (got "${F.readAfterWrite}")`);if(F.scanConsistency!=="snapshot")X.push(`scanConsistency must be "snapshot" (got "${F.scanConsistency}")`);if(!F.atomicBatch)X.push("atomicBatch must be true");if(!F.conditionalBatch)X.push("conditionalBatch must be true");if(X.length>0)throw Error(`Storage is not durable enough for recovery: ${X.join("; ")}.`)}var Z="default";async function B(W,F){return await W.get(F)!==null}async function*z(W,F,X){for await(let[Y]of W.scan(F,X))yield Y}async function x(W,F){let X=0;for await(let Y of z(W,F))X++;return X}async function v(W,F){let X=[];for await(let Y of z(W,F))X.push({type:"delete",key:Y});if(X.length===0)return 0;return await W.batch(X),X.length}async function CW(W,F,X){let Y=[];for await(let U of z(W,F,X))Y.push({type:"delete",key:U});if(Y.length===0)return 0;return await W.batch(Y),Y.length}var a;var O=P(()=>{a=["actrec:","archive:","async-act:","attr:","audit:bulk:","blob:","budget:","budget-charged:","ev:","fleet-event-by-workflow:","fleet-event:","fleet-event-tail","idx:","lease:","liveness:","offload:","op:","review:","schedule:","schedule-due:","schedule-run:","sig:","sigres:","sigseq:","start-idem:","state:","tag:","tool-effect:","upd:","upk:","upr:","wf:","wf-cleanup:","wf-cleanup-needed:","wf-concurrency:","wf-concurrency-holder:","wf-deadline:","wf-delayed:","wf-finalizer-state:","wf-has-services:","wf-headers:","wf-idx-","wf-teardown:","wf-teardown-deadletter:","wf-teardown-needed:","wf-terminal:"]});function G(W,F){if(F>_)throw new h(W,F)}function HW(W){return W.length>0?W.slice(0,-1)+String.fromCharCode(W.charCodeAt(W.length-1)+1):"\xFF"}function EW(W,F={}){if(F.gt!==void 0&&W<=F.gt)return!1;if(F.gte!==void 0&&W<F.gte)return!1;if(F.lt!==void 0&&W>=F.lt)return!1;if(F.lte!==void 0&&W>F.lte)return!1;return!0}function BW(W,F){if(W===null||F===null)return W===F;if(W.byteLength!==F.byteLength)return!1;for(let X=0;X<W.byteLength;X++)if(W[X]!==F[X])return!1;return!0}async function xW(W,F){if(W.has)return W.has(F);return B(W,F)}function vW(W,F,X){if(W.keys)return W.keys(F,X);return z(W,F,X)}async function OW(W,F){if(W.count)return W.count(F);return x(W,F)}async function TW(W,F){if(W.deletePrefix)return W.deletePrefix(F);return v(W,F)}async function hW(W,F){G("batch operations",F.length),await W.batch(F)}async function AW(W,F,X){if(G("conditionalBatch conditions",F.length),G("conditionalBatch operations",X.length),S(W,"conditionalBatch","storageConditionalBatch"),!W.conditionalBatch)throw Error("This storage backend reports conditionalBatch capability but does not implement the conditionalBatch() method.");return W.conditionalBatch(F,X)}function J(W){return encodeURIComponent(W)}function RW(W){return decodeURIComponent(W)}function bW(W){try{return decodeURIComponent(W)}catch{return null}}var _=1e4,NW=1e4,h,K=(W)=>String(W).padStart(16,"0"),i="0",t="1",T=(W,F,X,Y)=>`sig:${J(W)}:${J(F)}:${Y}:${J(X)}`,cW;var A=P(()=>{O();h=class h extends Error{code="StorageBatchOperationLimitExceededError";cap=_;count;target;constructor(W,F){super(`${W} count ${F} exceeds MAX_BATCH_OPERATIONS (${_}).`);this.name="StorageBatchOperationLimitExceededError",this.target=W,this.count=F}};cW={workflow:(W)=>`wf:${J(W)}`,checkpoint:(W)=>`wf:${J(W)}:ckpt`,checkpointHistory:(W,F)=>`wf:${J(W)}:ckpt:${String(F).padStart(10,"0")}`,timelinePrefix:(W)=>`wf:${J(W)}:timeline:`,timeline:(W,F)=>`wf:${J(W)}:timeline:${String(F).padStart(10,"0")}`,schedule:(W)=>`schedule:${J(W)}`,scheduleTick:(W,F)=>`schedule-due:${String(W).padStart(16,"0")}:${J(F)}`,scheduleRun:(W)=>`schedule-run:${J(W)}`,operation:(W,F,X)=>`op:${W}:${K(F)}:${X}`,operationInflight:(W)=>`op:inflight:${W}`,operationQueued:(W)=>`op:queued:${W}`,operationResolved:(W)=>`op:resolved:${W}`,operationDeadLetterPrefix:()=>"op:dead-letter:",operationDeadLetter:(W)=>`op:dead-letter:${W}`,bulkOperationAuditPrefix:()=>"audit:bulk:",bulkOperationAudit:(W,F,X)=>`audit:bulk:${K(W)}:${J(F)}:${J(X)}`,operationResolvedByTimePrefix:()=>"op:resolved-by-time:",operationResolvedByTime:(W,F)=>`op:resolved-by-time:${K(W)}:${J(F)}`,asyncActivity:(W,F)=>`async-act:v1:${J(W)}:${J(F)}`,asyncActivityResolution:(W,F)=>`async-act:v1:${J(W)}:${J(F)}:resolution`,activityReconciliationPrefix:(W)=>`actrec:v1:${J(W)}:`,activityReconciliation:(W,F,X)=>`actrec:v1:${J(W)}:${J(F)}:${X}`,eventPrefix:(W)=>`ev:${J(W)}:`,event:(W,F)=>`ev:${J(W)}:${String(F).padStart(10,"0")}`,eventHead:(W)=>`ev:${J(W)}:head`,eventWatermark:(W)=>`ev:${J(W)}:watermark`,fleetEventPrefix:()=>"fleet-event:",fleetEvent:(W)=>`fleet-event:${String(W).padStart(10,"0")}`,fleetEventTail:()=>"fleet-event-tail",fleetEventByWorkflowPrefix:(W)=>`fleet-event-by-workflow:${J(W)}:`,fleetEventByWorkflow:(W,F)=>`fleet-event-by-workflow:${J(W)}:${String(F).padStart(10,"0")}`,signal:(W,F,X)=>T(W,F,X,t),startSignal:(W,F,X)=>T(W,F,X,i),signalSequence:(W)=>`sigseq:v1:${J(W)}`,signalAcceptedResponsePrefix:(W)=>`sigres:v1:${J(W)}:`,signalAcceptedResponse:(W,F,X)=>`sigres:v1:${J(W)}:${J(F)}:${J(X)}`,deadline:(W,F)=>`wf-deadline:${K(W)}:${J(F)}`,terminalCleanup:(W,F)=>`wf-cleanup:${K(W)}:${J(F)}`,teardownTimer:(W,F)=>`wf-teardown:${K(W)}:${J(F)}`,delayedStart:(W,F)=>`wf-delayed:${K(W)}:${J(F)}`,terminalWorkflowPrefix:()=>"wf-terminal:",terminalWorkflow:(W,F)=>`wf-terminal:${K(W)}:${J(F)}`,attribute:(W)=>`attr:${J(W)}`,attributeIndex:(W,F,X)=>`idx:${W}:${F}:${J(X)}`,tagIndex:(W,F)=>`tag:${J(W)}:${J(F)}`,updatePrefix:(W)=>`upd:${J(W)}:`,update:(W,F)=>`upd:${J(W)}:${F}`,updateResponse:(W)=>`upr:${W}`,updateIdempotency:(W,F)=>`upk:${J(W)}:${F}`,startIdempotency:(W)=>`start-idem:${J(W)}`,startIdempotencySignalId:(W)=>`start-idem:${W}`,livenessPrefix:()=>"liveness:",liveness:(W)=>`liveness:${J(W)}`,leasePrefix:()=>"lease:",leaseEpoch:()=>"lease:epoch",leaseHolder:()=>"lease:holder",budget:(W,F,X)=>`budget:${W}:${F}:${X}`,review:(W,F)=>`review:${J(W)}:${F}`,workflowHeaders:(W)=>`wf-headers:${J(W)}`,childCancellationPrefix:(W)=>`child-cancel:${J(W)}:`,childCancellation:(W,F)=>`child-cancel:${J(W)}:${J(F)}`,terminalCleanupNeeded:(W)=>`wf-cleanup-needed:${J(W)}`,workflowConcurrency:(W,F)=>`wf-concurrency:${J(W)}:${J(F)}`,workflowConcurrencyHolder:(W)=>`wf-concurrency-holder:${J(W)}`,workflowHasServices:(W)=>`wf-has-services:${J(W)}`,finalizerState:(W)=>`wf-finalizer-state:${J(W)}`,teardownOwed:(W)=>`wf-teardown-needed:${J(W)}`,teardownDeadLetter:(W)=>`wf-teardown-deadletter:${J(W)}`,offload:(W,F)=>`offload:${J(W)}:${F}`,archive:(W,F)=>`archive:${J(W)}:${F}`,stateExecution:(W,F)=>`state:execution:${J(W)}:${J(F)}`,stateWorkflow:(W,F)=>`state:workflow-scope:${Z}:${J(W)}:${J(F)}`,streamChunkPrefix:(W,F)=>`blob:${J(W)}:${F}:chunk:`,streamChunk:(W,F,X)=>`blob:${J(W)}:${F}:chunk:${String(X).padStart(10,"0")}`,streamTail:(W,F)=>`blob:${J(W)}:${F}:tail`,streamMetadata:(W,F)=>`blob:${J(W)}:${F}:meta`,budgetCharged:(W)=>`budget-charged:${W}`,toolEffect:(W,F,X)=>`tool-effect:${J(W)}:${F}:${X}`,workflowVisibilityStatus:(W,F)=>`wf-idx-status:${J(W)}:${J(F)}`,workflowVisibilityType:(W,F)=>`wf-idx-type:${J(W)}:${J(F)}`,workflowVisibilityCreated:(W,F)=>`wf-idx-created:${K(W)}:${J(F)}`,workflowVisibilityUpdated:(W,F)=>`wf-idx-updated:${K(W)}:${J(F)}`,workflowVisibilityDeadline:(W,F)=>`wf-idx-deadline:${K(W)}:${J(F)}`,workflowVisibilityManifest:(W)=>`wf-idx-manifest:${J(W)}`,workflowVisibilityMetaVersion:()=>"wf-idx-meta:version",workflowVisibilityMetaBuiltAt:()=>"wf-idx-meta:built-at",workflowVisibilityMetaCursor:()=>"wf-idx-meta:cursor"}});function L(){return typeof(V&&"bun"in V?V.bun:globalThis.Bun)<"u"}function r(){if(V&&"process"in V)return V.process;return globalThis.process}function fW(W){if(L())return Bun.sleep(W);return new Promise((F)=>setTimeout(F,W))}function R(W){let F=e;for(let X=0;X<W.length;X++)F^=BigInt(W[X]),F=F*o&WW;return F.toString(16).padStart(16,"0")}function IW(W){return R(W)}function pW(W){return R(FW.encode(W))}function M(W){let X=r()?.getBuiltinModule;if(typeof X!=="function")return;return X(W)}function kW(W){if(L())return Bun.file(W).size;let F=M("node:fs");if(!F)throw Error("fileSize() requires Bun or Node 22.5+ (process.getBuiltinModule). Not available in browser or edge runtimes.");try{return F.statSync(W).size}catch(X){if(typeof X==="object"&&X!==null&&"code"in X&&X.code==="ENOENT")return 0;throw X}}function b(){let W=M("node:zlib");if(!W)throw Error("gzip/gunzip require Bun or Node 22.5+ (process.getBuiltinModule). "+"Not available in browser or edge runtimes \u2014 use CompressionStream directly.");return W}function c(W){if(L())return new Uint8Array(Bun.gzipSync(new Uint8Array(W)));return new Uint8Array(b().gzipSync(W))}function y(W){if(L())return new Uint8Array(Bun.gunzipSync(new Uint8Array(W)));return new Uint8Array(b().gunzipSync(W))}function m(){return M("node:zlib")}var V,e=0xcbf29ce484222325n,o=0x00000100000001b3n,WW=0xffffffffffffffffn,FW;var g=P(()=>{FW=new TextEncoder});function u(){let W=m();if(!W)throw Error("Brotli compression requires Bun or Node 22.5+ with process.getBuiltinModule support. Use gzip compression for browser/edge runtimes.");return W}function XW(W){return new Uint8Array(u().brotliCompressSync(W))}function JW(W){return new Uint8Array(u().brotliDecompressSync(W))}function p(W){return YW(W)}function YW(W){switch(W){case"gzip":return{algorithm:"gzip",compress(F){return c(F)}};case"brotli":return{algorithm:"brotli",compress(F){return XW(F)}};case"none":return{algorithm:"none",compress(F){return F}}}}async function H(W,F,X){if(W.length<X||F.algorithm==="none"){let j=new Uint8Array(W.length+Q);return j[0]=C,j[1]=N,j.set(W,Q),j}let Y=await F.compress(W);if(Y.length+Q>=W.length+Q){let j=new Uint8Array(W.length+Q);return j[0]=C,j[1]=N,j.set(W,Q),j}let U=F.algorithm==="gzip"?f:I,$=new Uint8Array(Y.length+Q);return $[0]=C,$[1]=U,$.set(Y,Q),$}async function E(W){if(W.length<Q)throw Error("Compression payload missing 2-byte header.");if(W[0]!==C)throw Error("Compression payload missing magic byte 0xC1.");let F=W[1],X=W.slice(Q);switch(F){case N:return X;case f:return y(X);case I:return JW(X);default:throw Error(`Compression payload uses unsupported algorithm byte 0x${F.toString(16).padStart(2,"0")}.`)}}function k(W){return{threshold:W?.threshold??$W,algorithm:W?.algorithm??jW}}var C=193,N=0,f=1,I=2,Q=2,$W=4096,jW="gzip";var w=P(()=>{g()});var KW;var QW=P(()=>{w();A();KW=class KW{#W;#F;#X;constructor(W,F){this.#W=W;let X=k(F);if(this.#F=p(X.algorithm),this.#X=X.threshold,W.query){let Y=W.query.bind(W);Object.defineProperty(this,"query",{value:Y,enumerable:!0,configurable:!0})}}capabilities(){let W=this.#W.capabilities();return{...W.persistence===void 0?{}:{persistence:W.persistence},readAfterWrite:W.readAfterWrite,scanConsistency:W.scanConsistency,atomicBatch:W.atomicBatch,conditionalBatch:!1,boundedRangeDelete:!1}}async get(W){let F=await this.#W.get(W);if(!F)return null;return E(F)}async put(W,F){let X=await H(F,this.#F,this.#X);return this.#W.put(W,X)}async delete(W){return this.#W.delete(W)}async*scan(W,F){for await(let[X,Y]of this.#W.scan(W,F))yield[X,await E(Y)]}async batch(W){G("batch operations",W.length);let F=await Promise.all(W.map(async(X)=>{if(X.type==="put")return{type:"put",key:X.key,value:await H(X.value,this.#F,this.#X)};return X}));return this.#W.batch(F)}[Symbol.dispose](){this.#W[Symbol.dispose]()}}});QW();export{KW as CompressedStorage};
+var i=import.meta.require,t=(W,F,X)=>{if(F!=null){if(typeof F!=="object"&&typeof F!=="function")throw TypeError('Object expected to be assigned to "using" declaration');let Y;if(X)Y=F[Symbol.asyncDispose];if(Y===void 0)Y=F[Symbol.dispose];if(typeof Y!=="function")throw TypeError("Object not disposable");W.push([X,Y,F])}else if(X)W.push([X]);return F},r=(W,F,X)=>{let Y=($)=>F=X?new SuppressedError($,F,"An error was suppressed during disposal"):(X=!0,$),U=($)=>{while($=W.pop())try{var j=$[1]&&$[1].call($[2]);if($[0])return Promise.resolve(j).then(U,(C)=>(Y(C),U()))}catch(C){Y(C)}if(X)throw F};return U()};function G(W,F,X){if(!W.capabilities()[F])throw Error(`Feature "${X}" requires storage capability "${F}", but this storage backend does not provide it.`)}function g(W){let F=W.capabilities(),X=[];if(F.persistence!=="local"&&F.persistence!=="remote")X.push(`persistence must be "local" or "remote" (got "${F.persistence}")`);if(F.readAfterWrite!=="linearizable")X.push(`readAfterWrite must be "linearizable" (got "${F.readAfterWrite}")`);if(F.scanConsistency!=="snapshot")X.push(`scanConsistency must be "snapshot" (got "${F.scanConsistency}")`);if(!F.atomicBatch)X.push("atomicBatch must be true");if(!F.conditionalBatch)X.push("conditionalBatch must be true");if(X.length>0)throw Error(`Storage is not durable enough for recovery: ${X.join("; ")}.`)}var D="default";async function M(W,F){return await W.get(F)!==null}async function*P(W,F,X){for await(let[Y]of W.scan(F,X))yield Y}async function N(W,F){let X=0;for await(let Y of P(W,F))X++;return X}async function H(W,F){let X=[];for await(let Y of P(W,F))X.push({type:"delete",key:Y});if(X.length===0)return 0;return await W.batch(X),X.length}async function FW(W,F,X){let Y=[];for await(let U of P(W,F,X))Y.push({type:"delete",key:U});if(Y.length===0)return 0;return await W.batch(Y),Y.length}var u=["actrec:","archive:","async-act:","attr:","audit:bulk:","blob:","budget:","budget-charged:","ev:","fleet-event-by-workflow:","fleet-event:","fleet-event-tail","idx:","lease:","liveness:","offload:","op:","review:","schedule:","schedule-due:","schedule-run:","sig:","sigres:","sigseq:","start-idem:","state:","tag:","tool-effect:","upd:","upk:","upr:","wf:","wf-cleanup:","wf-cleanup-needed:","wf-concurrency:","wf-concurrency-holder:","wf-deadline:","wf-delayed:","wf-finalizer-state:","wf-has-services:","wf-headers:","wf-idx-","wf-teardown:","wf-teardown-deadletter:","wf-teardown-needed:","wf-terminal:"];var L=1e4,KW=1e4;class B extends Error{code="StorageBatchOperationLimitExceededError";cap=L;count;target;constructor(W,F){super(`${W} count ${F} exceeds MAX_BATCH_OPERATIONS (${L}).`);this.name="StorageBatchOperationLimitExceededError",this.target=W,this.count=F}}function q(W,F){if(F>L)throw new B(W,F)}function QW(W){return W.length>0?W.slice(0,-1)+String.fromCharCode(W.charCodeAt(W.length-1)+1):"\xFF"}function UW(W,F={}){if(F.gt!==void 0&&W<=F.gt)return!1;if(F.gte!==void 0&&W<F.gte)return!1;if(F.lt!==void 0&&W>=F.lt)return!1;if(F.lte!==void 0&&W>F.lte)return!1;return!0}function VW(W,F){if(W===null||F===null)return W===F;if(W.byteLength!==F.byteLength)return!1;for(let X=0;X<W.byteLength;X++)if(W[X]!==F[X])return!1;return!0}async function PW(W,F){if(W.has)return W.has(F);return M(W,F)}function qW(W,F,X){if(W.keys)return W.keys(F,X);return P(W,F,X)}async function zW(W,F){if(W.count)return W.count(F);return N(W,F)}async function CW(W,F){if(W.deletePrefix)return W.deletePrefix(F);return H(W,F)}async function GW(W,F){q("batch operations",F.length),await W.batch(F)}async function DW(W,F,X){if(q("conditionalBatch conditions",F.length),q("conditionalBatch operations",X.length),G(W,"conditionalBatch","storageConditionalBatch"),!W.conditionalBatch)throw Error("This storage backend reports conditionalBatch capability but does not implement the conditionalBatch() method.");return W.conditionalBatch(F,X)}function J(W){return encodeURIComponent(W)}function LW(W){return decodeURIComponent(W)}function SW(W){try{return decodeURIComponent(W)}catch{return null}}var K=(W)=>String(W).padStart(16,"0"),f="0",I="1",E=(W,F,X,Y)=>`sig:${J(W)}:${J(F)}:${Y}:${J(X)}`,ZW={workflow:(W)=>`wf:${J(W)}`,checkpoint:(W)=>`wf:${J(W)}:ckpt`,checkpointHistory:(W,F)=>`wf:${J(W)}:ckpt:${String(F).padStart(10,"0")}`,timelinePrefix:(W)=>`wf:${J(W)}:timeline:`,timeline:(W,F)=>`wf:${J(W)}:timeline:${String(F).padStart(10,"0")}`,schedule:(W)=>`schedule:${J(W)}`,scheduleTick:(W,F)=>`schedule-due:${String(W).padStart(16,"0")}:${J(F)}`,scheduleRun:(W)=>`schedule-run:${J(W)}`,operation:(W,F,X)=>`op:${W}:${K(F)}:${X}`,operationInflight:(W)=>`op:inflight:${W}`,operationQueued:(W)=>`op:queued:${W}`,operationResolved:(W)=>`op:resolved:${W}`,operationDeadLetterPrefix:()=>"op:dead-letter:",operationDeadLetter:(W)=>`op:dead-letter:${W}`,bulkOperationAuditPrefix:()=>"audit:bulk:",bulkOperationAudit:(W,F,X)=>`audit:bulk:${K(W)}:${J(F)}:${J(X)}`,operationResolvedByTimePrefix:()=>"op:resolved-by-time:",operationResolvedByTime:(W,F)=>`op:resolved-by-time:${K(W)}:${J(F)}`,asyncActivity:(W,F)=>`async-act:v1:${J(W)}:${J(F)}`,asyncActivityResolution:(W,F)=>`async-act:v1:${J(W)}:${J(F)}:resolution`,activityReconciliationPrefix:(W)=>`actrec:v1:${J(W)}:`,activityReconciliation:(W,F,X)=>`actrec:v1:${J(W)}:${J(F)}:${X}`,eventPrefix:(W)=>`ev:${J(W)}:`,event:(W,F)=>`ev:${J(W)}:${String(F).padStart(10,"0")}`,eventHead:(W)=>`ev:${J(W)}:head`,eventWatermark:(W)=>`ev:${J(W)}:watermark`,fleetEventPrefix:()=>"fleet-event:",fleetEvent:(W)=>`fleet-event:${String(W).padStart(10,"0")}`,fleetEventTail:()=>"fleet-event-tail",fleetEventByWorkflowPrefix:(W)=>`fleet-event-by-workflow:${J(W)}:`,fleetEventByWorkflow:(W,F)=>`fleet-event-by-workflow:${J(W)}:${String(F).padStart(10,"0")}`,signal:(W,F,X)=>E(W,F,X,I),startSignal:(W,F,X)=>E(W,F,X,f),signalSequence:(W)=>`sigseq:v1:${J(W)}`,signalAcceptedResponsePrefix:(W)=>`sigres:v1:${J(W)}:`,signalAcceptedResponse:(W,F,X)=>`sigres:v1:${J(W)}:${J(F)}:${J(X)}`,deadline:(W,F)=>`wf-deadline:${K(W)}:${J(F)}`,terminalCleanup:(W,F)=>`wf-cleanup:${K(W)}:${J(F)}`,teardownTimer:(W,F)=>`wf-teardown:${K(W)}:${J(F)}`,delayedStart:(W,F)=>`wf-delayed:${K(W)}:${J(F)}`,terminalWorkflowPrefix:()=>"wf-terminal:",terminalWorkflow:(W,F)=>`wf-terminal:${K(W)}:${J(F)}`,attribute:(W)=>`attr:${J(W)}`,attributeIndex:(W,F,X)=>`idx:${W}:${F}:${J(X)}`,tagIndex:(W,F)=>`tag:${J(W)}:${J(F)}`,updatePrefix:(W)=>`upd:${J(W)}:`,update:(W,F)=>`upd:${J(W)}:${F}`,updateResponse:(W)=>`upr:${W}`,updateIdempotency:(W,F)=>`upk:${J(W)}:${F}`,startIdempotency:(W)=>`start-idem:${J(W)}`,startIdempotencySignalId:(W)=>`start-idem:${W}`,livenessPrefix:()=>"liveness:",liveness:(W)=>`liveness:${J(W)}`,leasePrefix:()=>"lease:",leaseEpoch:()=>"lease:epoch",leaseHolder:()=>"lease:holder",budget:(W,F,X)=>`budget:${W}:${F}:${X}`,review:(W,F)=>`review:${J(W)}:${F}`,workflowHeaders:(W)=>`wf-headers:${J(W)}`,childCancellationPrefix:(W)=>`child-cancel:${J(W)}:`,childCancellation:(W,F)=>`child-cancel:${J(W)}:${J(F)}`,terminalCleanupNeeded:(W)=>`wf-cleanup-needed:${J(W)}`,workflowConcurrency:(W,F)=>`wf-concurrency:${J(W)}:${J(F)}`,workflowConcurrencyHolder:(W)=>`wf-concurrency-holder:${J(W)}`,workflowHasServices:(W)=>`wf-has-services:${J(W)}`,finalizerState:(W)=>`wf-finalizer-state:${J(W)}`,teardownOwed:(W)=>`wf-teardown-needed:${J(W)}`,teardownDeadLetter:(W)=>`wf-teardown-deadletter:${J(W)}`,offload:(W,F)=>`offload:${J(W)}:${F}`,archive:(W,F)=>`archive:${J(W)}:${F}`,stateExecution:(W,F)=>`state:execution:${J(W)}:${J(F)}`,stateWorkflow:(W,F)=>`state:workflow-scope:${D}:${J(W)}:${J(F)}`,streamChunkPrefix:(W,F)=>`blob:${J(W)}:${F}:chunk:`,streamChunk:(W,F,X)=>`blob:${J(W)}:${F}:chunk:${String(X).padStart(10,"0")}`,streamTail:(W,F)=>`blob:${J(W)}:${F}:tail`,streamMetadata:(W,F)=>`blob:${J(W)}:${F}:meta`,budgetCharged:(W)=>`budget-charged:${W}`,toolEffect:(W,F,X)=>`tool-effect:${J(W)}:${F}:${X}`,workflowVisibilityStatus:(W,F)=>`wf-idx-status:${J(W)}:${J(F)}`,workflowVisibilityType:(W,F)=>`wf-idx-type:${J(W)}:${J(F)}`,workflowVisibilityCreated:(W,F)=>`wf-idx-created:${K(W)}:${J(F)}`,workflowVisibilityUpdated:(W,F)=>`wf-idx-updated:${K(W)}:${J(F)}`,workflowVisibilityDeadline:(W,F)=>`wf-idx-deadline:${K(W)}:${J(F)}`,workflowVisibilityManifest:(W)=>`wf-idx-manifest:${J(W)}`,workflowVisibilityMetaVersion:()=>"wf-idx-meta:version",workflowVisibilityMetaBuiltAt:()=>"wf-idx-meta:built-at",workflowVisibilityMetaCursor:()=>"wf-idx-meta:cursor"};var V;function p(){if(V&&"bun"in V)return V.bun;return globalThis.Bun}function x(){return typeof p()<"u"}function k(){if(V&&"process"in V)return V.process;return globalThis.process}function v(W){let X=k()?.getBuiltinModule;if(typeof X!=="function")return;return X(W)}function O(){let W=v("node:zlib");if(!W)throw Error("gzip/gunzip require Bun or Node 22.5+ (process.getBuiltinModule). "+"Not available in browser or edge runtimes \u2014 use CompressionStream directly.");return W}function T(W){if(x())return new Uint8Array(Bun.gzipSync(new Uint8Array(W)));return new Uint8Array(O().gzipSync(W))}function h(W){if(x())return new Uint8Array(Bun.gunzipSync(new Uint8Array(W)));return new Uint8Array(O().gunzipSync(W))}function A(){return v("node:zlib")}function R(){let W=A();if(!W)throw Error("Brotli compression requires Bun or Node 22.5+ with process.getBuiltinModule support. Use gzip compression for browser/edge runtimes.");return W}function w(W){return new Uint8Array(R().brotliCompressSync(W))}function n(W){return new Uint8Array(R().brotliDecompressSync(W))}var z=193,S=0,b=1,c=2,Q=2;function y(W){return l(W)}function l(W){switch(W){case"gzip":return{algorithm:"gzip",compress(F){return T(F)}};case"brotli":return{algorithm:"brotli",compress(F){return w(F)}};case"none":return{algorithm:"none",compress(F){return F}}}}async function Z(W,F,X){if(W.length<X||F.algorithm==="none"){let j=new Uint8Array(W.length+Q);return j[0]=z,j[1]=S,j.set(W,Q),j}let Y=await F.compress(W);if(Y.length+Q>=W.length+Q){let j=new Uint8Array(W.length+Q);return j[0]=z,j[1]=S,j.set(W,Q),j}let U=F.algorithm==="gzip"?b:c,$=new Uint8Array(Y.length+Q);return $[0]=z,$[1]=U,$.set(Y,Q),$}async function _(W){if(W.length<Q)throw Error("Compression payload missing 2-byte header.");if(W[0]!==z)throw Error("Compression payload missing magic byte 0xC1.");let F=W[1],X=W.slice(Q);switch(F){case S:return X;case b:return h(X);case c:return n(X);default:throw Error(`Compression payload uses unsupported algorithm byte 0x${F.toString(16).padStart(2,"0")}.`)}}var s=4096,d="gzip";function m(W){return{threshold:W?.threshold??s,algorithm:W?.algorithm??d}}class a{#W;#F;#X;constructor(W,F){this.#W=W;let X=m(F);if(this.#F=y(X.algorithm),this.#X=X.threshold,W.query){let Y=W.query.bind(W);Object.defineProperty(this,"query",{value:Y,enumerable:!0,configurable:!0})}}capabilities(){let W=this.#W.capabilities();return{...W.persistence===void 0?{}:{persistence:W.persistence},readAfterWrite:W.readAfterWrite,scanConsistency:W.scanConsistency,atomicBatch:W.atomicBatch,conditionalBatch:!1,boundedRangeDelete:!1}}async get(W){let F=await this.#W.get(W);if(!F)return null;return _(F)}async put(W,F){let X=await Z(F,this.#F,this.#X);return this.#W.put(W,X)}async delete(W){return this.#W.delete(W)}async*scan(W,F){for await(let[X,Y]of this.#W.scan(W,F))yield[X,await _(Y)]}async batch(W){q("batch operations",W.length);let F=await Promise.all(W.map(async(X)=>{if(X.type==="put")return{type:"put",key:X.key,value:await Z(X.value,this.#F,this.#X)};return X}));return this.#W.batch(F)}[Symbol.dispose](){this.#W[Symbol.dispose]()}}export{a as CompressedStorage};