@storic/cloudflare 0.1.0

package/README.md

@@ -0,0 +1,138 @@
+# @storic/cloudflare
+
+`JsEvaluator` implementation for Storic using Cloudflare [Dynamic Worker Loaders](https://developers.cloudflare.com/workers/runtime-apis/bindings/worker-loader/).
+
+Each evaluation generates a worker module with the expression and bindings injected directly into the source. The module is loaded into an isolated worker with no network access (`globalOutbound: null`), providing true sandboxing.
+
+## Installation
+
+```bash
+bun add @storic/cloudflare
+```
+
+## Setup
+
+### 1. Add the worker loader binding to your wrangler config
+
+```toml
+# wrangler.toml
+[[worker_loaders]]
+binding = "EVALUATOR"
+```
+
+### 2. Wire the layer in your worker
+
+```typescript
+import { Effect, Layer } from "effect";
+import { Store } from "@storic/core";
+import { CloudflareJsEvaluator, WorkerLoaderBinding } from "@storic/cloudflare";
+
+export default {
+  async fetch(request: Request, env: Env) {
+    const StoreLive = Store.layer.pipe(
+      Layer.provide(Layer.mergeAll(
+        SqlLive,
+        CloudflareJsEvaluator.layer.pipe(
+          Layer.provide(WorkerLoaderBinding.layer(env.EVALUATOR)),
+        ),
+      )),
+    );
+
+    // use StoreLive ...
+  },
+};
+```
+
+## How it works
+
+When `evaluate(jsExpr, bindings)` is called:
+
+1. Binding names are validated (must be valid JS identifiers)
+2. Binding values are JSON-serialized (must be serializable)
+3. The expression is wrapped in an IIFE with bindings as parameters/arguments
+4. A fresh dynamic worker is spawned via the Worker Loader API
+5. The expression evaluates at module initialization time
+6. The result is returned via a minimal `fetch` handler
+
+For example, evaluating `a + b` with `{ a: 10, b: 20 }` generates:
+
+```javascript
+let __result;
+let __error;
+
+try {
+  __result = ((a, b) => (a + b))(10, 20);
+} catch (e) {
+  __error = (e instanceof Error && e.message) ? e.message : String(e);
+}
+
+export default {
+  fetch() {
+    if (__error !== undefined) {
+      return Response.json({ error: __error }, { status: 400 });
+    }
+    const t = typeof __result;
+    if (t === "function" || t === "symbol" || t === "undefined") {
+      return Response.json(
+        { error: "Result is not JSON-serializable: got " + t },
+        { status: 400 },
+      );
+    }
+    try {
+      return Response.json({ result: __result });
+    } catch (e) {
+      const msg = (e instanceof Error && e.message) ? e.message : String(e);
+      return Response.json(
+        { error: "Result is not JSON-serializable: " + msg },
+        { status: 400 },
+      );
+    }
+  },
+};
+```
+
+This mirrors core's `new Function(...names, 'return (expr)')(...values)` pattern, but runs in an isolated worker with `globalOutbound: null` — no network access, no bindings, no access to the parent worker's environment.
+
+## API
+
+### `CloudflareJsEvaluator.layer`
+
+`Layer.Layer<JsEvaluator, never, WorkerLoaderBinding>`
+
+Provides the `JsEvaluator` service. Requires a `WorkerLoaderBinding`.
+
+### `WorkerLoaderBinding.layer(loader)`
+
+`(loader: WorkerLoader) => Layer.Layer<WorkerLoaderBinding>`
+
+Creates a `WorkerLoaderBinding` layer from the `env.EVALUATOR` binding in your worker.
+
+### `WorkerLoader`
+
+Minimal type for the Cloudflare Worker Loader binding. Matches the `get()` method from the [Worker Loader API](https://developers.cloudflare.com/workers/runtime-apis/bindings/worker-loader/).
+
+### `EvaluatorModuleError`
+
+Thrown synchronously by `generateEvaluatorModule` when bindings contain invalid identifier names or non-JSON-serializable values. Wrapped into a `TransformError` by the layer.
+
+## Notes
+
+- **Closed beta**: Dynamic Worker Loaders require [signing up for the closed beta](https://forms.gle/MoeDxE9wNiqdf8ri9). They work locally with `wrangler dev`.
+- **Bindings are JSON-serialized**: Functions, classes, symbols, `undefined`, `BigInt`, and circular references cannot be passed as bindings. Binding names must be valid JavaScript identifiers.
+- **Results must be JSON-serializable**: If the expression evaluates to a function, symbol, `undefined`, or other non-serializable value, the evaluator returns a `TransformError`.
+- **Fresh isolate per evaluation**: Each call uses a random worker ID to avoid stale cached results.
+- **Syntax errors**: If the expression has a syntax error, the dynamic worker module fails to parse and the error surfaces through the Worker Loader API (caught as a `TransformError`).
+
+## Testing
+
+```bash
+# Unit tests
+bun test test/
+
+# E2E tests (requires wrangler)
+bun run test:e2e
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @storic/cloudflare
+ *
+ * Helper utilities for using Storic with Cloudflare Durable Objects.
+ *
+ * Provides:
+ * - `doStoragePersistence` — Persistence implementation backed by DO's SqlStorage
+ * - `StoricDO` — Base class for DOs with automatic Store setup
+ * - `sqlStorageLayer` — Low-level SqlClient adapter (for advanced use)
+ */
+export { doStoragePersistence } from "./persistence.ts";
+export { StoricDO, StoricObject } from "./storic-object.ts";
+export { sqlStorageLayer } from "./sql-storage-client.ts";
+export { Store, Persistence, defineLens, SchemaRegistry, getTag, } from "@storic/core";
+export type { AnyTaggedStruct, EntityRecord, Lens, StoreConfig, PersistenceShape, PersistenceRecord, StoredRecord, IndexSpec, InitSpec, QueryParams, } from "@storic/core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EACL,KAAK,EACL,WAAW,EACX,UAAU,EACV,cAAc,EACd,MAAM,GACP,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,eAAe,EACf,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,WAAW,GACZ,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @storic/cloudflare
+ *
+ * Helper utilities for using Storic with Cloudflare Durable Objects.
+ *
+ * Provides:
+ * - `doStoragePersistence` — Persistence implementation backed by DO's SqlStorage
+ * - `StoricDO` — Base class for DOs with automatic Store setup
+ * - `sqlStorageLayer` — Low-level SqlClient adapter (for advanced use)
+ */
+// ─── Cloudflare-specific ────────────────────────────────────────────────────
+export { doStoragePersistence } from "./persistence.js";
+export { StoricDO, StoricObject } from "./storic-object.js";
+export { sqlStorageLayer } from "./sql-storage-client.js";
+// ─── Re-export core for convenience ─────────────────────────────────────────
+export { Store, Persistence, defineLens, SchemaRegistry, getTag, } from "@storic/core";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,+EAA+E;AAC/E,OAAO,EACL,KAAK,EACL,WAAW,EACX,UAAU,EACV,cAAc,EACd,MAAM,GACP,MAAM,cAAc,CAAC"}

package/dist/persistence.d.ts

@@ -0,0 +1,15 @@
+import * as Layer from "effect/Layer";
+import { Persistence } from "@storic/core";
+/**
+ * Persistence implementation backed by Cloudflare Durable Object's SqlStorage.
+ *
+ * @example
+ * ```ts
+ * import { doStoragePersistence } from "@storic/cloudflare";
+ *
+ * const persistenceLayer = doStoragePersistence(ctx.storage.sql);
+ * const storeLayer = Store.layer(config).pipe(Layer.provide(persistenceLayer));
+ * ```
+ */
+export declare const doStoragePersistence: (storage: SqlStorage) => Layer.Layer<Persistence, never, never>;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAC;AAyB7D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,iEA8NhC,CAAC"}

package/dist/persistence.js

@@ -0,0 +1,159 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { Persistence, PersistenceError } from "@storic/core";
+import { compileFilters } from "@storic/sql";
+import { sqlStorageLayer } from "./sql-storage-client.js";
+import { SqlClient } from "effect/unstable/sql/SqlClient";
+/**
+ * Parse a database row into a StoredRecord.
+ */
+function rowToStoredRecord(row) {
+    return {
+        id: row.id,
+        type: row.type,
+        data: JSON.parse(row.data),
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    };
+}
+/**
+ * Persistence implementation backed by Cloudflare Durable Object's SqlStorage.
+ *
+ * @example
+ * ```ts
+ * import { doStoragePersistence } from "@storic/cloudflare";
+ *
+ * const persistenceLayer = doStoragePersistence(ctx.storage.sql);
+ * const storeLayer = Store.layer(config).pipe(Layer.provide(persistenceLayer));
+ * ```
+ */
+export const doStoragePersistence = (storage) => {
+    const sqlLayer = sqlStorageLayer(storage);
+    return Layer.effect(Persistence, Effect.gen(function* () {
+        const sql = yield* SqlClient;
+        const initialize = (spec) => Effect.gen(function* () {
+            yield* sql.unsafe(`
+            CREATE TABLE IF NOT EXISTS entities (
+              id         TEXT PRIMARY KEY,
+              type       TEXT NOT NULL,
+              data       JSON NOT NULL,
+              created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+              updated_at INTEGER NOT NULL DEFAULT (unixepoch())
+            )
+          `);
+            yield* sql.unsafe(`
+            CREATE INDEX IF NOT EXISTS idx_entities_type ON entities(type)
+          `);
+            const expectedIndexes = new Set();
+            for (const idx of spec.indexes) {
+                expectedIndexes.add(idx.name);
+                yield* sql.unsafe(`CREATE INDEX IF NOT EXISTS "${idx.name}" ` +
+                    `ON entities(json_extract(data, '$.${idx.fieldPath}')) ` +
+                    `WHERE type = '${idx.typeDiscriminator}'`);
+            }
+            const existingIndexes = yield* sql `SELECT name FROM sqlite_master WHERE type = 'index' AND tbl_name = 'entities' AND name LIKE 'idx_%'`;
+            for (const { name } of existingIndexes) {
+                if (name !== "idx_entities_type" && !expectedIndexes.has(name)) {
+                    yield* sql.unsafe(`DROP INDEX "${name}"`);
+                }
+            }
+        }).pipe(Effect.mapError((error) => new PersistenceError({
+            message: `Initialization failed: ${error}`,
+            cause: error,
+        })));
+        const put = (record) => Effect.gen(function* () {
+            yield* sql `
+            INSERT INTO entities (id, type, data)
+            VALUES (${record.id}, ${record.type}, ${JSON.stringify(record.data)})
+          `;
+            const rows = yield* sql `SELECT * FROM entities WHERE id = ${record.id}`;
+            return rowToStoredRecord(rows[0]);
+        }).pipe(Effect.mapError((error) => new PersistenceError({
+            message: `Put failed for ${record.id}: ${error}`,
+            cause: error,
+        })));
+        const get = (id) => Effect.gen(function* () {
+            const rows = yield* sql `SELECT * FROM entities WHERE id = ${id}`;
+            if (rows.length === 0)
+                return null;
+            return rowToStoredRecord(rows[0]);
+        }).pipe(Effect.mapError((error) => new PersistenceError({
+            message: `Get failed for ${id}: ${error}`,
+            cause: error,
+        })));
+        const query = (params) => Effect.gen(function* () {
+            const compiled = compileFilters(params.filters);
+            let whereClause = `type IN (${params.types.map(() => "?").join(", ")})`;
+            const bindValues = [...params.types];
+            if (compiled) {
+                whereClause += ` AND ${compiled.sql}`;
+                bindValues.push(...compiled.values);
+            }
+            let stmt = `SELECT * FROM entities WHERE ${whereClause} ORDER BY created_at DESC`;
+            if (params.limit != null) {
+                stmt += ` LIMIT ${params.limit}`;
+            }
+            if (params.offset != null) {
+                stmt += ` OFFSET ${params.offset}`;
+            }
+            const rows = yield* sql.unsafe(stmt, bindValues);
+            return rows.map(rowToStoredRecord);
+        }).pipe(Effect.mapError((error) => new PersistenceError({
+            message: `Query failed: ${error}`,
+            cause: error,
+        })));
+        const update = (id, record) => Effect.gen(function* () {
+            yield* sql `
+            UPDATE entities
+            SET type = ${record.type},
+                data = ${JSON.stringify(record.data)},
+                updated_at = unixepoch()
+            WHERE id = ${id}
+          `;
+            const rows = yield* sql `SELECT * FROM entities WHERE id = ${id}`;
+            return rowToStoredRecord(rows[0]);
+        }).pipe(Effect.mapError((error) => new PersistenceError({
+            message: `Update failed for ${id}: ${error}`,
+            cause: error,
+        })));
+        const patch = (params) => Effect.gen(function* () {
+            if (params.patches.length === 0)
+                return 0;
+            let totalAffected = 0;
+            for (const entry of params.patches) {
+                const compiled = compileFilters(entry.filters);
+                let whereClause = `type = ?`;
+                const bindValues = [entry.type];
+                if (compiled) {
+                    whereClause += ` AND ${compiled.sql}`;
+                    bindValues.push(...compiled.values);
+                }
+                const result = yield* sql.unsafe(`UPDATE entities ` +
+                    `SET data = json_patch(data, ?), updated_at = unixepoch() ` +
+                    `WHERE ${whereClause} ` +
+                    `RETURNING id`, [JSON.stringify(entry.patch), ...bindValues]);
+                totalAffected += result.length;
+            }
+            return totalAffected;
+        }).pipe(Effect.mapError((error) => new PersistenceError({
+            message: `Patch failed: ${error}`,
+            cause: error,
+        })));
+        const remove = (id) => Effect.gen(function* () {
+            yield* sql `DELETE FROM entities WHERE id = ${id}`;
+        }).pipe(Effect.mapError((error) => new PersistenceError({
+            message: `Remove failed for ${id}: ${error}`,
+            cause: error,
+        })));
+        return Persistence.of({
+            initialize,
+            put,
+            get,
+            query,
+            update,
+            patch,
+            remove,
+        });
+    })).pipe(Layer.provide(sqlLayer));
+};
+//# sourceMappingURL=persistence.js.map

package/dist/persistence.js.map

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

package/dist/sql-storage-client.d.ts

@@ -0,0 +1,25 @@
+import * as Layer from "effect/Layer";
+import * as Client from "effect/unstable/sql/SqlClient";
+/**
+ * Create a `SqlClient` layer backed by a Durable Object's `SqlStorage`.
+ *
+ * @example
+ * ```ts
+ * import { DurableObject } from "cloudflare:workers";
+ * import { Store, sqlStorageLayer } from "@storic/cloudflare";
+ *
+ * export class MyDO extends DurableObject {
+ *   private store: Store;
+ *
+ *   constructor(ctx: DurableObjectState, env: Env) {
+ *     super(ctx, env);
+ *     const layer = Store.layer(config).pipe(
+ *       Layer.provide(sqlStorageLayer(ctx.storage.sql))
+ *     );
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export declare const sqlStorageLayer: (sql: SqlStorage) => Layer.Layer<Client.SqlClient, never, never>;
+//# sourceMappingURL=sql-storage-client.d.ts.map

package/dist/sql-storage-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-storage-client.d.ts","sourceRoot":"","sources":["../src/sql-storage-client.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAOtC,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAC;AAoExD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,kEAiC3B,CAAC"}

package/dist/sql-storage-client.js

@@ -0,0 +1,107 @@
+/**
+ * Effect SqlClient adapter for Cloudflare Durable Object's sync SqlStorage API.
+ *
+ * Wraps `ctx.storage.sql` (which is synchronous) into Effect's `SqlClient`
+ * interface so it can be used as the persistence layer for `Store.layer()`.
+ */
+import * as Effect from "effect/Effect";
+import { identity } from "effect/Function";
+import * as Layer from "effect/Layer";
+import * as Scope from "effect/Scope";
+import * as Semaphore from "effect/Semaphore";
+import * as ServiceMap from "effect/ServiceMap";
+import * as Fiber from "effect/Fiber";
+import * as Stream from "effect/Stream";
+import * as Reactivity from "effect/unstable/reactivity/Reactivity";
+import * as Client from "effect/unstable/sql/SqlClient";
+import { SqlError } from "effect/unstable/sql/SqlError";
+import * as Statement from "effect/unstable/sql/Statement";
+const ATTR_DB_SYSTEM_NAME = "db.system.name";
+// ─── SqlStorage Connection ──────────────────────────────────────────────────
+/**
+ * Create a Connection that delegates to the Durable Object's sync SqlStorage.
+ *
+ * `SqlStorage.exec(query, ...bindings)` returns a `SqlStorageCursor<T>` which
+ * is iterable and has `.toArray()`. The cursor returns rows as plain objects
+ * with column names as keys — the same shape Effect's SqlClient expects.
+ */
+function makeSqlStorageConnection(sql) {
+    const run = (query, params = []) => Effect.try({
+        try: () => sql.exec(query, ...params).toArray(),
+        catch: (cause) => new SqlError({ cause, message: "Failed to execute statement" }),
+    });
+    const runValues = (query, params = []) => Effect.try({
+        try: () => {
+            const cursor = sql.exec(query, ...params);
+            const columns = cursor.columnNames;
+            const rows = [];
+            for (const row of cursor) {
+                rows.push(columns.map((col) => row[col]));
+            }
+            return rows;
+        },
+        catch: (cause) => new SqlError({ cause, message: "Failed to execute statement" }),
+    });
+    return identity({
+        execute(query, params, transformRows) {
+            return transformRows
+                ? Effect.map(run(query, params), transformRows)
+                : run(query, params);
+        },
+        executeRaw(query, params) {
+            return run(query, params);
+        },
+        executeValues(query, params) {
+            return runValues(query, params);
+        },
+        executeUnprepared(query, params, transformRows) {
+            return this.execute(query, params, transformRows);
+        },
+        executeStream(_query, _params) {
+            return Stream.die("executeStream not supported on Durable Object SqlStorage");
+        },
+    });
+}
+// ─── Layer ──────────────────────────────────────────────────────────────────
+/**
+ * Create a `SqlClient` layer backed by a Durable Object's `SqlStorage`.
+ *
+ * @example
+ * ```ts
+ * import { DurableObject } from "cloudflare:workers";
+ * import { Store, sqlStorageLayer } from "@storic/cloudflare";
+ *
+ * export class MyDO extends DurableObject {
+ *   private store: Store;
+ *
+ *   constructor(ctx: DurableObjectState, env: Env) {
+ *     super(ctx, env);
+ *     const layer = Store.layer(config).pipe(
+ *       Layer.provide(sqlStorageLayer(ctx.storage.sql))
+ *     );
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export const sqlStorageLayer = (sql) => {
+    const connection = makeSqlStorageConnection(sql);
+    const compiler = Statement.makeCompilerSqlite();
+    return Layer.effectServices(Effect.gen(function* () {
+        const semaphore = yield* Semaphore.make(1);
+        const acquirer = semaphore.withPermits(1)(Effect.succeed(connection));
+        const transactionAcquirer = Effect.uninterruptibleMask((restore) => {
+            const fiber = Fiber.getCurrent();
+            const scope = ServiceMap.getUnsafe(fiber.services, Scope.Scope);
+            return Effect.as(Effect.tap(restore(semaphore.take(1)), () => Scope.addFinalizer(scope, semaphore.release(1))), connection);
+        });
+        const client = yield* Client.make({
+            acquirer,
+            compiler,
+            transactionAcquirer,
+            spanAttributes: [[ATTR_DB_SYSTEM_NAME, "sqlite"]],
+        });
+        return ServiceMap.make(Client.SqlClient, client);
+    })).pipe(Layer.provide(Reactivity.layer));
+};
+//# sourceMappingURL=sql-storage-client.js.map

package/dist/sql-storage-client.js.map

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

package/dist/storic-object.d.ts

@@ -0,0 +1,51 @@
+import { DurableObject } from "cloudflare:workers";
+import * as Effect from "effect/Effect";
+import { Store } from "@storic/core";
+import type { StoreConfig } from "@storic/core";
+/**
+ * Generic Durable Object that provides a Persistence layer.
+ *
+ * This is the "dumb store" — it knows nothing about schemas or lenses.
+ * All schema validation and lens transforms happen caller-side in the
+ * Store layer, which is composed on top of the Persistence this DO provides.
+ *
+ * @example
+ * ```ts
+ * import { DurableObject } from "cloudflare:workers";
+ * import { StoricDO, Store } from "@storic/cloudflare";
+ * import type { StoreConfig } from "@storic/cloudflare";
+ *
+ * const config: StoreConfig = { schemas: [PersonV1, PersonV2], lenses: [PersonV1toV2] };
+ *
+ * export class MyDO extends StoricDO<Env> {
+ *   get config(): StoreConfig {
+ *     return config;
+ *   }
+ *
+ *   async fetch(request: Request) {
+ *     const entities = await this.run(
+ *       Store.use((store) => store.loadEntities(PersonV2))
+ *     );
+ *     return Response.json(entities);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class StoricDO<Env = unknown, Props = {}> extends DurableObject<Env, Props> {
+    /**
+     * Override this getter to provide the Storic configuration.
+     * Schemas and lenses are defined here, outside the DO's storage concerns.
+     */
+    abstract get config(): StoreConfig;
+    private _runtime;
+    constructor(ctx: DurableObjectState, env: Env);
+    /**
+     * Run an Effect program with `Store` available in the context.
+     */
+    protected run<A, E>(effect: Effect.Effect<A, E, Store>): Promise<A>;
+}
+/**
+ * @deprecated Use `StoricDO` instead. This is an alias for backward compatibility.
+ */
+export declare const StoricObject: typeof StoricDO;
+//# sourceMappingURL=storic-object.d.ts.map

package/dist/storic-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storic-object.d.ts","sourceRoot":"","sources":["../src/storic-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,KAAK,EAAe,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,8BAAsB,QAAQ,CAC5B,GAAG,GAAG,OAAO,EACb,KAAK,GAAG,EAAE,CACV,SAAQ,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC;IACjC;;;OAGG;IACH,QAAQ,KAAK,MAAM,IAAI,WAAW,CAAC;IAEnC,OAAO,CAAC,QAAQ,CAA+C;IAE/D,YAAY,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,GAAG,EAkB5C;IAED;;OAEG;IACH,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAElE;CACF;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,iBAAW,CAAC"}

package/dist/storic-object.js

@@ -0,0 +1,61 @@
+import { DurableObject } from "cloudflare:workers";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as ManagedRuntime from "effect/ManagedRuntime";
+import { Store } from "@storic/core";
+import { doStoragePersistence } from "./persistence.js";
+/**
+ * Generic Durable Object that provides a Persistence layer.
+ *
+ * This is the "dumb store" — it knows nothing about schemas or lenses.
+ * All schema validation and lens transforms happen caller-side in the
+ * Store layer, which is composed on top of the Persistence this DO provides.
+ *
+ * @example
+ * ```ts
+ * import { DurableObject } from "cloudflare:workers";
+ * import { StoricDO, Store } from "@storic/cloudflare";
+ * import type { StoreConfig } from "@storic/cloudflare";
+ *
+ * const config: StoreConfig = { schemas: [PersonV1, PersonV2], lenses: [PersonV1toV2] };
+ *
+ * export class MyDO extends StoricDO<Env> {
+ *   get config(): StoreConfig {
+ *     return config;
+ *   }
+ *
+ *   async fetch(request: Request) {
+ *     const entities = await this.run(
+ *       Store.use((store) => store.loadEntities(PersonV2))
+ *     );
+ *     return Response.json(entities);
+ *   }
+ * }
+ * ```
+ */
+export class StoricDO extends DurableObject {
+    _runtime;
+    constructor(ctx, env) {
+        super(ctx, env);
+        this.ctx.blockConcurrencyWhile(async () => {
+            const persistenceLayer = doStoragePersistence(this.ctx.storage.sql);
+            // Store.layer handles schema registry, index computation, and
+            // delegates storage to the Persistence backend.
+            const storeLayer = Store.layer(this.config).pipe(Layer.provide(persistenceLayer), Layer.orDie);
+            this._runtime = ManagedRuntime.make(storeLayer);
+            // Force initialization inside blockConcurrencyWhile
+            await this._runtime.runPromise(Effect.void);
+        });
+    }
+    /**
+     * Run an Effect program with `Store` available in the context.
+     */
+    run(effect) {
+        return this._runtime.runPromise(effect);
+    }
+}
+/**
+ * @deprecated Use `StoricDO` instead. This is an alias for backward compatibility.
+ */
+export const StoricObject = StoricDO;
+//# sourceMappingURL=storic-object.js.map

package/dist/storic-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storic-object.js","sourceRoot":"","sources":["../src/storic-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,cAAc,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAe,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,OAAgB,QAGpB,SAAQ,aAAyB;IAOzB,QAAQ,CAA+C;IAE/D,YAAY,GAAuB,EAAE,GAAQ;QAC3C,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAEhB,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,KAAK,IAAI,EAAE;YACxC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAEpE,8DAA8D;YAC9D,gDAAgD;YAChD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAC9C,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAC/B,KAAK,CAAC,KAAK,CACZ,CAAC;YAEF,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEhD,oDAAoD;YACpD,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACO,GAAG,CAAO,MAAkC;QACpD,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@storic/cloudflare",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsgo --build",
+    "check": "tsgo --noEmit",
+    "test": "bun test test/",
+    "test:e2e": "bun test e2e/e2e.test.ts --timeout 60000"
+  },
+  "dependencies": {
+    "@storic/core": "workspace:*",
+    "@storic/sql": "workspace:*",
+    "effect": "4.0.0-beta.29"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260307.1",
+    "@types/bun": "^1.3.10",
+    "@types/node": "^22.0.0",
+    "@typescript/native-preview": "catalog:",
+    "wrangler": "^4.71.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,36 @@
+/**
+ * @storic/cloudflare
+ *
+ * Helper utilities for using Storic with Cloudflare Durable Objects.
+ *
+ * Provides:
+ * - `doStoragePersistence` — Persistence implementation backed by DO's SqlStorage
+ * - `StoricDO` — Base class for DOs with automatic Store setup
+ * - `sqlStorageLayer` — Low-level SqlClient adapter (for advanced use)
+ */
+
+// ─── Cloudflare-specific ────────────────────────────────────────────────────
+export { doStoragePersistence } from "./persistence.ts";
+export { StoricDO, StoricObject } from "./storic-object.ts";
+export { sqlStorageLayer } from "./sql-storage-client.ts";
+
+// ─── Re-export core for convenience ─────────────────────────────────────────
+export {
+  Store,
+  Persistence,
+  defineLens,
+  SchemaRegistry,
+  getTag,
+} from "@storic/core";
+export type {
+  AnyTaggedStruct,
+  EntityRecord,
+  Lens,
+  StoreConfig,
+  PersistenceShape,
+  PersistenceRecord,
+  StoredRecord,
+  IndexSpec,
+  InitSpec,
+  QueryParams,
+} from "@storic/core";

package/src/persistence.ts

@@ -0,0 +1,261 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { Persistence, PersistenceError } from "@storic/core";
+import { compileFilters } from "@storic/sql";
+import type {
+  InitSpec,
+  PatchParams,
+  PersistenceRecord,
+  QueryParams,
+  StoredRecord,
+} from "@storic/core";
+import { sqlStorageLayer } from "./sql-storage-client.ts";
+import { SqlClient } from "effect/unstable/sql/SqlClient";
+
+/**
+ * Parse a database row into a StoredRecord.
+ */
+function rowToStoredRecord(row: Record<string, unknown>): StoredRecord {
+  return {
+    id: row.id as string,
+    type: row.type as string,
+    data: JSON.parse(row.data as string) as Record<string, unknown>,
+    created_at: row.created_at as number,
+    updated_at: row.updated_at as number,
+  };
+}
+
+/**
+ * Persistence implementation backed by Cloudflare Durable Object's SqlStorage.
+ *
+ * @example
+ * ```ts
+ * import { doStoragePersistence } from "@storic/cloudflare";
+ *
+ * const persistenceLayer = doStoragePersistence(ctx.storage.sql);
+ * const storeLayer = Store.layer(config).pipe(Layer.provide(persistenceLayer));
+ * ```
+ */
+export const doStoragePersistence = (
+  storage: SqlStorage,
+): Layer.Layer<Persistence> => {
+  const sqlLayer = sqlStorageLayer(storage);
+
+  return Layer.effect(
+    Persistence,
+    Effect.gen(function* () {
+      const sql = yield* SqlClient;
+
+      const initialize = (spec: InitSpec) =>
+        Effect.gen(function* () {
+          yield* sql.unsafe(`
+            CREATE TABLE IF NOT EXISTS entities (
+              id         TEXT PRIMARY KEY,
+              type       TEXT NOT NULL,
+              data       JSON NOT NULL,
+              created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+              updated_at INTEGER NOT NULL DEFAULT (unixepoch())
+            )
+          `);
+          yield* sql.unsafe(`
+            CREATE INDEX IF NOT EXISTS idx_entities_type ON entities(type)
+          `);
+
+          const expectedIndexes = new Set<string>();
+
+          for (const idx of spec.indexes) {
+            expectedIndexes.add(idx.name);
+            yield* sql.unsafe(
+              `CREATE INDEX IF NOT EXISTS "${idx.name}" ` +
+                `ON entities(json_extract(data, '$.${idx.fieldPath}')) ` +
+                `WHERE type = '${idx.typeDiscriminator}'`,
+            );
+          }
+
+          const existingIndexes = yield* sql<{
+            name: string;
+          }>`SELECT name FROM sqlite_master WHERE type = 'index' AND tbl_name = 'entities' AND name LIKE 'idx_%'`;
+
+          for (const { name } of existingIndexes) {
+            if (name !== "idx_entities_type" && !expectedIndexes.has(name)) {
+              yield* sql.unsafe(`DROP INDEX "${name}"`);
+            }
+          }
+        }).pipe(
+          Effect.mapError(
+            (error) =>
+              new PersistenceError({
+                message: `Initialization failed: ${error}`,
+                cause: error,
+              }),
+          ),
+        );
+
+      const put = (record: PersistenceRecord) =>
+        Effect.gen(function* () {
+          yield* sql`
+            INSERT INTO entities (id, type, data)
+            VALUES (${record.id}, ${record.type}, ${JSON.stringify(record.data)})
+          `;
+
+          const rows = yield* sql<
+            Record<string, unknown>
+          >`SELECT * FROM entities WHERE id = ${record.id}`;
+
+          return rowToStoredRecord(rows[0]);
+        }).pipe(
+          Effect.mapError(
+            (error) =>
+              new PersistenceError({
+                message: `Put failed for ${record.id}: ${error}`,
+                cause: error,
+              }),
+          ),
+        );
+
+      const get = (id: string) =>
+        Effect.gen(function* () {
+          const rows = yield* sql<
+            Record<string, unknown>
+          >`SELECT * FROM entities WHERE id = ${id}`;
+
+          if (rows.length === 0) return null;
+          return rowToStoredRecord(rows[0]);
+        }).pipe(
+          Effect.mapError(
+            (error) =>
+              new PersistenceError({
+                message: `Get failed for ${id}: ${error}`,
+                cause: error,
+              }),
+          ),
+        );
+
+      const query = (params: QueryParams) =>
+        Effect.gen(function* () {
+          const compiled = compileFilters(params.filters);
+
+          let whereClause = `type IN (${params.types.map(() => "?").join(", ")})`;
+          const bindValues: unknown[] = [...params.types];
+
+          if (compiled) {
+            whereClause += ` AND ${compiled.sql}`;
+            bindValues.push(...compiled.values);
+          }
+
+          let stmt = `SELECT * FROM entities WHERE ${whereClause} ORDER BY created_at DESC`;
+
+          if (params.limit != null) {
+            stmt += ` LIMIT ${params.limit}`;
+          }
+          if (params.offset != null) {
+            stmt += ` OFFSET ${params.offset}`;
+          }
+
+          const rows = yield* sql.unsafe<Record<string, unknown>>(
+            stmt,
+            bindValues,
+          );
+
+          return rows.map(rowToStoredRecord);
+        }).pipe(
+          Effect.mapError(
+            (error) =>
+              new PersistenceError({
+                message: `Query failed: ${error}`,
+                cause: error,
+              }),
+          ),
+        );
+
+      const update = (
+        id: string,
+        record: { readonly type: string; readonly data: Record<string, unknown> },
+      ) =>
+        Effect.gen(function* () {
+          yield* sql`
+            UPDATE entities
+            SET type = ${record.type},
+                data = ${JSON.stringify(record.data)},
+                updated_at = unixepoch()
+            WHERE id = ${id}
+          `;
+
+          const rows = yield* sql<
+            Record<string, unknown>
+          >`SELECT * FROM entities WHERE id = ${id}`;
+
+          return rowToStoredRecord(rows[0]);
+        }).pipe(
+          Effect.mapError(
+            (error) =>
+              new PersistenceError({
+                message: `Update failed for ${id}: ${error}`,
+                cause: error,
+              }),
+          ),
+        );
+
+      const patch = (params: PatchParams) =>
+        Effect.gen(function* () {
+          if (params.patches.length === 0) return 0;
+
+          let totalAffected = 0;
+
+          for (const entry of params.patches) {
+            const compiled = compileFilters(entry.filters);
+
+            let whereClause = `type = ?`;
+            const bindValues: unknown[] = [entry.type];
+
+            if (compiled) {
+              whereClause += ` AND ${compiled.sql}`;
+              bindValues.push(...compiled.values);
+            }
+
+            const result = yield* sql.unsafe<Record<string, unknown>>(
+              `UPDATE entities ` +
+                `SET data = json_patch(data, ?), updated_at = unixepoch() ` +
+                `WHERE ${whereClause} ` +
+                `RETURNING id`,
+              [JSON.stringify(entry.patch), ...bindValues],
+            );
+            totalAffected += result.length;
+          }
+
+          return totalAffected;
+        }).pipe(
+          Effect.mapError(
+            (error) =>
+              new PersistenceError({
+                message: `Patch failed: ${error}`,
+                cause: error,
+              }),
+          ),
+        );
+
+      const remove = (id: string) =>
+        Effect.gen(function* () {
+          yield* sql`DELETE FROM entities WHERE id = ${id}`;
+        }).pipe(
+          Effect.mapError(
+            (error) =>
+              new PersistenceError({
+                message: `Remove failed for ${id}: ${error}`,
+                cause: error,
+              }),
+          ),
+        );
+
+      return Persistence.of({
+        initialize,
+        put,
+        get,
+        query,
+        update,
+        patch,
+        remove,
+      });
+    }),
+  ).pipe(Layer.provide(sqlLayer));
+};

package/src/sql-storage-client.ts

@@ -0,0 +1,138 @@
+/**
+ * Effect SqlClient adapter for Cloudflare Durable Object's sync SqlStorage API.
+ *
+ * Wraps `ctx.storage.sql` (which is synchronous) into Effect's `SqlClient`
+ * interface so it can be used as the persistence layer for `Store.layer()`.
+ */
+import * as Effect from "effect/Effect";
+import { identity } from "effect/Function";
+import * as Layer from "effect/Layer";
+import * as Scope from "effect/Scope";
+import * as Semaphore from "effect/Semaphore";
+import * as ServiceMap from "effect/ServiceMap";
+import * as Fiber from "effect/Fiber";
+import * as Stream from "effect/Stream";
+import * as Reactivity from "effect/unstable/reactivity/Reactivity";
+import * as Client from "effect/unstable/sql/SqlClient";
+import type { Connection } from "effect/unstable/sql/SqlConnection";
+import { SqlError } from "effect/unstable/sql/SqlError";
+import * as Statement from "effect/unstable/sql/Statement";
+
+const ATTR_DB_SYSTEM_NAME = "db.system.name";
+
+// ─── SqlStorage Connection ──────────────────────────────────────────────────
+
+/**
+ * Create a Connection that delegates to the Durable Object's sync SqlStorage.
+ *
+ * `SqlStorage.exec(query, ...bindings)` returns a `SqlStorageCursor<T>` which
+ * is iterable and has `.toArray()`. The cursor returns rows as plain objects
+ * with column names as keys — the same shape Effect's SqlClient expects.
+ */
+function makeSqlStorageConnection(sql: SqlStorage): Connection {
+  const run = (
+    query: string,
+    params: ReadonlyArray<unknown> = [],
+  ): Effect.Effect<Array<any>, SqlError> =>
+    Effect.try({
+      try: () => sql.exec(query, ...params).toArray(),
+      catch: (cause) =>
+        new SqlError({ cause, message: "Failed to execute statement" }),
+    });
+
+  const runValues = (
+    query: string,
+    params: ReadonlyArray<unknown> = [],
+  ): Effect.Effect<Array<Array<unknown>>, SqlError> =>
+    Effect.try({
+      try: () => {
+        const cursor = sql.exec(query, ...params);
+        const columns = cursor.columnNames;
+        const rows: Array<Array<unknown>> = [];
+        for (const row of cursor) {
+          rows.push(columns.map((col) => (row as Record<string, unknown>)[col]));
+        }
+        return rows;
+      },
+      catch: (cause) =>
+        new SqlError({ cause, message: "Failed to execute statement" }),
+    });
+
+  return identity<Connection>({
+    execute(query, params, transformRows) {
+      return transformRows
+        ? Effect.map(run(query, params), transformRows)
+        : run(query, params);
+    },
+    executeRaw(query, params) {
+      return run(query, params);
+    },
+    executeValues(query, params) {
+      return runValues(query, params);
+    },
+    executeUnprepared(query, params, transformRows) {
+      return this.execute(query, params, transformRows);
+    },
+    executeStream(_query, _params) {
+      return Stream.die("executeStream not supported on Durable Object SqlStorage");
+    },
+  });
+}
+
+// ─── Layer ──────────────────────────────────────────────────────────────────
+
+/**
+ * Create a `SqlClient` layer backed by a Durable Object's `SqlStorage`.
+ *
+ * @example
+ * ```ts
+ * import { DurableObject } from "cloudflare:workers";
+ * import { Store, sqlStorageLayer } from "@storic/cloudflare";
+ *
+ * export class MyDO extends DurableObject {
+ *   private store: Store;
+ *
+ *   constructor(ctx: DurableObjectState, env: Env) {
+ *     super(ctx, env);
+ *     const layer = Store.layer(config).pipe(
+ *       Layer.provide(sqlStorageLayer(ctx.storage.sql))
+ *     );
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export const sqlStorageLayer = (
+  sql: SqlStorage,
+): Layer.Layer<Client.SqlClient> => {
+  const connection = makeSqlStorageConnection(sql);
+  const compiler = Statement.makeCompilerSqlite();
+
+  return Layer.effectServices(
+    Effect.gen(function* () {
+      const semaphore = yield* Semaphore.make(1);
+
+      const acquirer = semaphore.withPermits(1)(Effect.succeed(connection));
+      const transactionAcquirer = Effect.uninterruptibleMask((restore) => {
+        const fiber = Fiber.getCurrent()!;
+        const scope = ServiceMap.getUnsafe(fiber.services, Scope.Scope);
+        return Effect.as(
+          Effect.tap(
+            restore(semaphore.take(1)),
+            () => Scope.addFinalizer(scope, semaphore.release(1)),
+          ),
+          connection,
+        );
+      });
+
+      const client = yield* Client.make({
+        acquirer,
+        compiler,
+        transactionAcquirer,
+        spanAttributes: [[ATTR_DB_SYSTEM_NAME, "sqlite"]],
+      });
+
+      return ServiceMap.make(Client.SqlClient, client);
+    }),
+  ).pipe(Layer.provide(Reactivity.layer));
+};

package/src/storic-object.ts

@@ -0,0 +1,81 @@
+import { DurableObject } from "cloudflare:workers";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as ManagedRuntime from "effect/ManagedRuntime";
+import { Store, Persistence } from "@storic/core";
+import type { StoreConfig } from "@storic/core";
+import { doStoragePersistence } from "./persistence.ts";
+
+/**
+ * Generic Durable Object that provides a Persistence layer.
+ *
+ * This is the "dumb store" — it knows nothing about schemas or lenses.
+ * All schema validation and lens transforms happen caller-side in the
+ * Store layer, which is composed on top of the Persistence this DO provides.
+ *
+ * @example
+ * ```ts
+ * import { DurableObject } from "cloudflare:workers";
+ * import { StoricDO, Store } from "@storic/cloudflare";
+ * import type { StoreConfig } from "@storic/cloudflare";
+ *
+ * const config: StoreConfig = { schemas: [PersonV1, PersonV2], lenses: [PersonV1toV2] };
+ *
+ * export class MyDO extends StoricDO<Env> {
+ *   get config(): StoreConfig {
+ *     return config;
+ *   }
+ *
+ *   async fetch(request: Request) {
+ *     const entities = await this.run(
+ *       Store.use((store) => store.loadEntities(PersonV2))
+ *     );
+ *     return Response.json(entities);
+ *   }
+ * }
+ * ```
+ */
+export abstract class StoricDO<
+  Env = unknown,
+  Props = {},
+> extends DurableObject<Env, Props> {
+  /**
+   * Override this getter to provide the Storic configuration.
+   * Schemas and lenses are defined here, outside the DO's storage concerns.
+   */
+  abstract get config(): StoreConfig;
+
+  private _runtime!: ManagedRuntime.ManagedRuntime<Store, never>;
+
+  constructor(ctx: DurableObjectState, env: Env) {
+    super(ctx, env);
+
+    this.ctx.blockConcurrencyWhile(async () => {
+      const persistenceLayer = doStoragePersistence(this.ctx.storage.sql);
+
+      // Store.layer handles schema registry, index computation, and
+      // delegates storage to the Persistence backend.
+      const storeLayer = Store.layer(this.config).pipe(
+        Layer.provide(persistenceLayer),
+        Layer.orDie,
+      );
+
+      this._runtime = ManagedRuntime.make(storeLayer);
+
+      // Force initialization inside blockConcurrencyWhile
+      await this._runtime.runPromise(Effect.void);
+    });
+  }
+
+  /**
+   * Run an Effect program with `Store` available in the context.
+   */
+  protected run<A, E>(effect: Effect.Effect<A, E, Store>): Promise<A> {
+    return this._runtime.runPromise(effect);
+  }
+}
+
+/**
+ * @deprecated Use `StoricDO` instead. This is an alias for backward compatibility.
+ */
+export const StoricObject = StoricDO;