effect-cf 0.0.1

package/README.md

@@ -0,0 +1,79 @@
+# effect-cf
+
+Effect-native primitives for Cloudflare Workers and bindings.
+
+## Design Goal
+
+Cloudflare services should be described as `Context`, `Layer`, and `Effect` values and executed through package-owned Cloudflare entrypoint/runtime boundaries. Consumer code should stay in `Effect`; bindings and storage helpers wrap Promise-returning Cloudflare APIs so applications do not call `Effect.runPromise` or manually bridge Promises.
+
+The low-level Worker entrypoint factory is exported as `Worker.make`. It returns a `WorkerEntrypoint` class with a `fetch` handler and optional typed RPC methods. Durable Object support starts with `DurableObject.make`, which routes Durable Object lifecycle methods and RPC handlers through one managed runtime for each Durable Object instance.
+
+RPC contracts can be described as classes with `Worker.Tag` and `DurableObject.Tag`. Contract classes expose `.make(...)` for runtime entrypoint creation and `.Binding(...)` / `.Namespace(...)` for typed bindings. Bindings infer call types from the same code-owned contract classes. Definition-backed calls encode/decode arguments and success values with their Effect schemas at Worker and Durable Object boundaries.
+
+Binding helpers expose two RPC paths:
+
+- `call(...)` awaits one RPC result inside `Effect`. Use it for ordinary structured-cloneable values.
+- `rpc(...)` returns Cloudflare's native RPC thenable/stub without awaiting it, preserving promise pipelining.
+- `scopedCall(...)` awaits the result and registers any `Symbol.dispose` disposer with the current Effect `Scope`.
+
+Client APIs use Cloudflare-style provider types, so object results expose pipelined property and method access. `ServerApi` remains available when a plain implementation-shaped `(...args) => Promise<A>` contract is needed.
+
+## Current Exports
+
+- `Worker` - WorkerEntrypoint class factory, schema-backed RPC contract tags, and service binding helpers
+- `DurableObject` - Durable Object class factory, schema-backed RPC contract tags, and namespace helpers
+- `WorkerDefinition`, `DurableObjectDefinition` - compatibility exports for the lower-level definition modules
+- `DurableObjectNamespace` - typed Durable Object namespace binding helper
+- `DurableObjectState`, `DurableObjectStorage` - small Effect wrappers for Durable Object state, alarms, SQL, and embedded KV storage
+- `DurableObjectWebSocket` - Durable Object WebSocket upgrade helpers built on `WebSocketPair` and `acceptWebSocket`
+- `Binding` - low-level binding service helper
+- `Kv` - typed KV namespace helper
+- `Rpc` - Cloudflare RPC type helpers, `RpcTarget` / `RpcStub` re-exports, and scoped disposal utilities
+- `ServiceBinding` - typed Worker-to-Worker service binding helper
+- `WorkerEnvironment` - request environment service
+
+## RPC Values
+
+Definition-backed RPC methods are intended for schema-backed structured values. If a Cloudflare RPC method returns a lifecycle-managed RPC object or stub, expose that through a lower-level binding API instead of a `WorkerDefinition` / `DurableObjectDefinition` method so disposal remains explicit.
+
+## Durable Object WebSocket Example
+
+```ts
+const request = yield * Worker.NativeRequest;
+
+if (!Worker.isWebSocketUpgrade(request)) {
+  return new Response("Expected WebSocket upgrade", { status: 426 });
+}
+
+const upgrade =
+  yield *
+  DurableObjectWebSocket.acceptUpgrade({
+    tags: ["room:general"],
+    attachment: { roomId: "general" },
+  });
+
+return upgrade.response;
+```
+
+## Durable Object Example
+
+```ts
+export class Counter extends DurableObject.Tag<Counter>()("Counter", {
+  get: DurableObject.method({ success: S.Number }),
+}) {}
+
+export const CounterDurableObject = Counter.make(Layer.empty, {
+  rpc: {
+    get: () =>
+      Effect.gen(function* () {
+        const state = yield* DurableObjectState.DurableObjectState;
+        const row = yield* (yield* state.storage.sql.exec<{ count: number }>(
+          "SELECT 0 AS count",
+        )).one();
+        return row.count;
+      }),
+  },
+});
+```
+
+Define the Wrangler binding and SQLite migration in the application. This package intentionally does not replace `wrangler.jsonc`.

package/dist/chunk-CfYAbeIz.mjs

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };