effect-cf 0.25.3 → 0.27.0

package/dist/index.mjs

@@ -1,6 +1,8 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
-import { a as DurableObjectWebSocket_exports, c as causeMessage, d as WorkerConfig, f as WorkerEnvironment, i as fromExecutionContext, l as violationsMessage, n as DurableObjectState_exports, o as fromWebSocket, r as fromDurableObjectState, s as DurableObjectStorage_exports, t as DurableObjectState, u as Environment_exports } from "./DurableObjectState-CEh0DVw7.mjs";
-import { Clock, Config, ConfigProvider, Context, Data, DateTime, Duration, Effect, Exit, Function as Function$1, Layer, ManagedRuntime, Option, Predicate, Queue, Result, Schema } from "effect";
+import { a as WorkerEnvironment, i as WorkerConfig, n as violationsMessage, r as Environment_exports, t as causeMessage } from "./ErrorMessage-_lg53p3W.mjs";
+import { a as layer$19, i as Service$2, n as Artifacts_exports, r as Binding_exports } from "./Artifacts-BhWrdyqX.mjs";
+import { a as DurableObjectWebSocket_exports, i as fromExecutionContext, n as DurableObjectState_exports, o as fromWebSocket, r as fromDurableObjectState, s as DurableObjectStorage_exports, t as DurableObjectState } from "./DurableObjectState-Dux8KfjG.mjs";
+import { Clock, Config, ConfigProvider, Context, Data, DateTime, Duration, Effect, Exit, Function, Layer, ManagedRuntime, Option, Predicate, Queue, Result, Schema } from "effect";
 import { FetchHttpClient, HttpClient, HttpClientRequest, HttpEffect, HttpServerRequest, HttpServerResponse } from "effect/unstable/http";
 import { OtlpExporter, OtlpLogger, OtlpMetrics, OtlpSerialization, OtlpTracer } from "effect/unstable/observability";
 import { D1Client } from "@effect/sql-d1";
@@ -9,124 +11,6 @@ import * as RpcMessage from "effect/unstable/rpc/RpcMessage";
 import * as RpcSerialization from "effect/unstable/rpc/RpcSerialization";
 import * as RpcServer from "effect/unstable/rpc/RpcServer";
 import { SqliteClient } from "@effect/sql-sqlite-do";
-//#region src/Binding.ts
-var Binding_exports = /* @__PURE__ */ __exportAll({
-	BindingNotFoundError: () => BindingNotFoundError,
-	BindingValidationError: () => BindingValidationError,
-	Service: () => Service$2,
-	TypeId: () => TypeId$3,
-	layer: () => layer$19
-});
-/** Internal type id marker used by binding helper services. */
-const TypeId$3 = "~effect-cf/Binding";
-/** Error raised when a configured binding does not exist on `env`. */
-var BindingNotFoundError = class extends Data.TaggedError("BindingNotFoundError") {};
-/** Error raised when a binding exists but does not match the expected shape. */
-var BindingValidationError = class extends Data.TaggedError("BindingValidationError") {};
-const defaultExpected = "Cloudflare binding resource";
-const isPropertyTarget$1 = (value) => (typeof value === "object" || typeof value === "function") && value !== null;
-const getObjectName = (value) => {
-	const tag = (() => {
-		try {
-			return Object.prototype.toString.call(value).slice(8, -1);
-		} catch {
-			return typeof value;
-		}
-	})();
-	const constructorName = (() => {
-		try {
-			return "constructor" in value && typeof value.constructor === "function" && typeof value.constructor.name === "string" ? value.constructor.name : void 0;
-		} catch {
-			return;
-		}
-	})();
-	if (tag !== "Object") return tag;
-	if (constructorName !== void 0 && constructorName !== "" && constructorName !== "Object") return constructorName;
-	return tag;
-};
-const propertyNames = (value) => {
-	const names = /* @__PURE__ */ new Set();
-	for (const target of [value, Object.getPrototypeOf(value)]) {
-		if (target === null || target === Object.prototype || target === Function.prototype) continue;
-		try {
-			for (const name of Object.getOwnPropertyNames(target)) names.add(name);
-		} catch {
-			continue;
-		}
-	}
-	return [...names].filter((name) => name !== "constructor").sort();
-};
-const isMethod = (value, name) => {
-	try {
-		return typeof Reflect.get(value, name) === "function";
-	} catch {
-		return false;
-	}
-};
-const describeActual = (value) => {
-	if (value === null) return "null";
-	if (typeof value !== "object" && typeof value !== "function") return typeof value;
-	const names = propertyNames(value);
-	const methods = names.filter((name) => isMethod(value, name));
-	const properties = names.filter((name) => !methods.includes(name));
-	const details = [methods.length > 0 ? `methods ${methods.join(", ")}` : void 0, properties.length > 0 ? `properties ${properties.join(", ")}` : void 0].filter((detail) => detail !== void 0);
-	if (details.length === 0) return getObjectName(value);
-	return `${getObjectName(value)} with ${details.join("; ")}`;
-};
-const getBinding = (env, binding, isResource, options) => Effect.gen(function* () {
-	if (!isPropertyTarget$1(env)) {
-		const actual = describeActual(env);
-		return yield* Effect.fail(new BindingValidationError({
-			binding,
-			expected: "WorkerEnvironment object",
-			actual,
-			message: `Cloudflare binding "${binding}" failed validation. Expected WorkerEnvironment object; got ${actual}`
-		}));
-	}
-	const resource = Reflect.get(env, binding);
-	if (resource === void 0) return yield* Effect.fail(new BindingNotFoundError({
-		binding,
-		message: `Cloudflare binding "${binding}" was not found in WorkerEnvironment`
-	}));
-	if (!isResource(resource)) {
-		const expected = options?.expected ?? defaultExpected;
-		const actual = describeActual(resource);
-		return yield* Effect.fail(new BindingValidationError({
-			binding,
-			expected,
-			actual,
-			message: `Cloudflare binding "${binding}" failed validation. Expected ${expected}; got ${actual}`
-		}));
-	}
-	return resource;
-});
-/**
-* The overloads on {@link layer} and {@link Service} guarantee that
-* `Service = Resource` whenever `wrap` is absent, making the fallback cast
-* safe.
-*/
-const makeBindingLayer = (tag, binding, isResource, wrap, options) => Layer.effect(tag, Effect.gen(function* () {
-	const env = yield* WorkerEnvironment;
-	const resource = yield* getBinding(env, binding, isResource, options);
-	return wrap === void 0 ? resource : wrap(resource);
-}));
-function layer$19(tag, binding, isResource, wrap, options) {
-	return makeBindingLayer(tag, binding, isResource, wrap, options);
-}
-const Service$2 = () => {
-	function makeService(id, binding, isResource, wrap, options) {
-		const tag = Context.Service()(`effect-cf/Binding/${id}`);
-		const serviceLayer = makeBindingLayer(tag, binding, isResource, wrap, options);
-		return Object.assign(tag, {
-			[TypeId$3]: TypeId$3,
-			id,
-			binding,
-			layer: serviceLayer
-		});
-	}
-	return makeService;
-};
-//#endregion
 //#region src/WorkersAi.ts
 var WorkersAi_exports = /* @__PURE__ */ __exportAll({
 	Tag: () => Tag$16,
@@ -2933,8 +2817,8 @@ const makeSteps = (steps) => ({
 });
 /** Empty Images transformation pipeline. */
 const empty = makeSteps([]);
-const transform = Function$1.dual(2, (steps, transformValue) => makeSteps([...steps.steps, Step.Transform({ transform: transformValue })]));
-const draw = Function$1.dual(2, (steps, drawValue) => makeSteps([...steps.steps, Step.Draw(drawValue)]));
+const transform = Function.dual(2, (steps, transformValue) => makeSteps([...steps.steps, Step.Transform({ transform: transformValue })]));
+const draw = Function.dual(2, (steps, drawValue) => makeSteps([...steps.steps, Step.Draw(drawValue)]));
 const imagesError = (binding, operation, cause) => new ImagesOperationError({
 	binding,
 	operation,
@@ -3297,6 +3181,71 @@ const Tag$2 = () => (id) => {
 	});
 };
 //#endregion
+//#region src/WebTransport.ts
+var WebTransport_exports = /* @__PURE__ */ __exportAll({
+	InboundTransport: () => InboundTransport,
+	WebTransportUnsupportedError: () => WebTransportUnsupportedError,
+	capabilities: () => capabilities,
+	inboundSessionsUnsupported: () => inboundSessionsUnsupported,
+	inboundTransport: () => inboundTransport,
+	isHttp3: () => isHttp3
+});
+/**
+* Metadata Cloudflare's edge reports about the inbound client connection.
+*
+* `httpProtocol` and `clientTcpRtt` are declared in
+* `@cloudflare/workers-types`; `clientQuicRtt` is documented by Cloudflare
+* ("only present when the client connected over QUIC (HTTP/3)") but not yet
+* present in the published types, so it is decoded from the open
+* `Record<string, unknown>` side of `request.cf`.
+*/
+var InboundTransport = class extends Schema.Class("InboundTransport")({
+	/** The HTTP protocol the client used, e.g. `"HTTP/2"` or `"HTTP/3"`. */
+	httpProtocol: Schema.String,
+	/** Client round-trip time; only present for QUIC (HTTP/3) connections. */
+	clientQuicRtt: Schema.optional(Schema.Number),
+	/** Client round-trip time; only present for TCP (HTTP/1.x, HTTP/2) connections. */
+	clientTcpRtt: Schema.optional(Schema.Number)
+}) {};
+const decodeInboundTransport = Schema.decodeUnknownResult(InboundTransport);
+/**
+* Decodes the inbound transport metadata from `request.cf`.
+*
+* Returns `None` when the metadata is absent (for example in local `wrangler
+* dev` or when a Worker invokes another Worker directly) or does not match
+* the expected shape.
+*/
+const inboundTransport = (request) => Result.getSuccess(decodeInboundTransport(request.cf));
+/**
+* Returns `true` when the client reached Cloudflare's edge over QUIC
+* (HTTP/3). Prefers the documented QUIC signal (`clientQuicRtt` is only
+* present for QUIC connections) and falls back to the `httpProtocol` string.
+*
+* Note this describes the browser→edge hop only: the edge always terminates
+* QUIC, and the Worker still handles an ordinary `fetch` Request.
+*/
+const isHttp3 = (transport) => transport.clientQuicRtt !== void 0 || transport.httpProtocol === "HTTP/3";
+/** Feature-detects the WebTransport capabilities of the current runtime. */
+const capabilities = Effect.sync(() => ({
+	inboundSessions: false,
+	outboundSessions: typeof globalThis["WebTransport"] === "function"
+}));
+/** Raised when a WebTransport capability is unavailable in this runtime. */
+var WebTransportUnsupportedError = class extends Data.TaggedError("WebTransportUnsupportedError") {
+	get message() {
+		return this.capability === "inbound-sessions" ? "Cloudflare Workers cannot accept inbound WebTransport sessions: the edge terminates QUIC and no runtime session API exists (cloudflare/workerd#6451). Use Durable Object WebSockets for bidirectional push." : "This Workers runtime provides no WebTransport client: workerd has no QUIC stack and cloudflare:sockets is TCP-only.";
+	}
+};
+/**
+* The explicit typed boundary for inbound WebTransport sessions.
+*
+* Always fails with {@link WebTransportUnsupportedError} today. Route the
+* code path that would accept a session through this effect so the
+* limitation is visible in the type system and greppable when Cloudflare
+* ships a real API.
+*/
+const inboundSessionsUnsupported = Effect.fail(new WebTransportUnsupportedError({ capability: "inbound-sessions" }));
+//#endregion
 //#region src/WorkflowBinding.ts
 var WorkflowBinding_exports = /* @__PURE__ */ __exportAll({
 	WorkflowOperationError: () => WorkflowOperationError,
@@ -3546,4 +3495,4 @@ const waitForEvent = (name, options) => Effect.flatMap(WorkflowStep$1, (workflow
 const Tag = Tag$1;
 const implement = implement$1;
 //#endregion
-export { AiGateway_exports as AiGateway, AnalyticsEngine_exports as AnalyticsEngine, Binding_exports as Binding, BrowserRendering_exports as BrowserRendering, Cache_exports as Cache, CloudflareOtlp_exports as CloudflareOtlp, ContainerNamespace_exports as ContainerNamespace, D1_exports as D1, DurableObject_exports as DurableObject, DurableObjectAlarm_exports as DurableObjectAlarm, DurableObjectDefinition_exports as DurableObjectDefinition, DurableObjectNamespace_exports as DurableObjectNamespace, DurableObjectRpcWebSocket_exports as DurableObjectRpcWebSocket, DurableObjectSqlite_exports as DurableObjectSqlite, DurableObjectState_exports as DurableObjectState, DurableObjectStorage_exports as DurableObjectStorage, DurableObjectWebSocket_exports as DurableObjectWebSocket, Email_exports as Email, Environment_exports as Environment, Hyperdrive_exports as Hyperdrive, Images_exports as Images, Kv_exports as Kv, Queue_exports as Queue, QueueBinding_exports as QueueBinding, QueueDefinition_exports as QueueDefinition, R2_exports as R2, Rpc_exports as Rpc, RpcDefinition_exports as RpcDefinition, ServiceBinding_exports as ServiceBinding, Vectorize_exports as Vectorize, Worker_exports as Worker, WorkerConfig, WorkerDefinition_exports as WorkerDefinition, WorkerEnvironment, WorkersAi_exports as WorkersAi, Workflow_exports as Workflow, WorkflowBinding_exports as WorkflowBinding, WorkflowDefinition_exports as WorkflowDefinition };
+export { AiGateway_exports as AiGateway, AnalyticsEngine_exports as AnalyticsEngine, Artifacts_exports as Artifacts, Binding_exports as Binding, BrowserRendering_exports as BrowserRendering, Cache_exports as Cache, CloudflareOtlp_exports as CloudflareOtlp, ContainerNamespace_exports as ContainerNamespace, D1_exports as D1, DurableObject_exports as DurableObject, DurableObjectAlarm_exports as DurableObjectAlarm, DurableObjectDefinition_exports as DurableObjectDefinition, DurableObjectNamespace_exports as DurableObjectNamespace, DurableObjectRpcWebSocket_exports as DurableObjectRpcWebSocket, DurableObjectSqlite_exports as DurableObjectSqlite, DurableObjectState_exports as DurableObjectState, DurableObjectStorage_exports as DurableObjectStorage, DurableObjectWebSocket_exports as DurableObjectWebSocket, Email_exports as Email, Environment_exports as Environment, Hyperdrive_exports as Hyperdrive, Images_exports as Images, Kv_exports as Kv, Queue_exports as Queue, QueueBinding_exports as QueueBinding, QueueDefinition_exports as QueueDefinition, R2_exports as R2, Rpc_exports as Rpc, RpcDefinition_exports as RpcDefinition, ServiceBinding_exports as ServiceBinding, Vectorize_exports as Vectorize, WebTransport_exports as WebTransport, Worker_exports as Worker, WorkerConfig, WorkerDefinition_exports as WorkerDefinition, WorkerEnvironment, WorkersAi_exports as WorkersAi, Workflow_exports as Workflow, WorkflowBinding_exports as WorkflowBinding, WorkflowDefinition_exports as WorkflowDefinition };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effect-cf",
-  "version": "0.25.3",
+  "version": "0.27.0",
   "description": "Effect-native primitives for Cloudflare Workers and bindings.",
   "license": "MIT",
   "repository": {
@@ -27,6 +27,21 @@
       "import": "./dist/HyperdrivePg.mjs",
       "default": "./dist/HyperdrivePg.mjs"
     },
+    "./computer-artifacts": {
+      "types": "./dist/ComputerArtifacts.d.mts",
+      "import": "./dist/ComputerArtifacts.mjs",
+      "default": "./dist/ComputerArtifacts.mjs"
+    },
+    "./computer-workspace": {
+      "types": "./dist/ComputerWorkspace.d.mts",
+      "import": "./dist/ComputerWorkspace.mjs",
+      "default": "./dist/ComputerWorkspace.mjs"
+    },
+    "./computer-workspace-host": {
+      "types": "./dist/ComputerWorkspaceHost.d.mts",
+      "import": "./dist/ComputerWorkspaceHost.mjs",
+      "default": "./dist/ComputerWorkspaceHost.mjs"
+    },
     "./vitest": {
       "types": "./dist/Vitest.d.mts",
       "import": "./dist/Vitest.mjs",
@@ -45,6 +60,7 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
+    "@cloudflare/computer": "0.2.0",
     "@cloudflare/containers": "catalog:",
     "@cloudflare/vitest-pool-workers": "catalog:",
     "@cloudflare/workers-types": "catalog:",
@@ -53,11 +69,14 @@
     "@effect/sql-pg": "catalog:",
     "@effect/sql-sqlite-do": "catalog:",
     "@effect/vitest": "catalog:",
+    "@platformatic/vfs": "^0.4.0",
     "effect": "catalog:",
+    "esbuild": "^0.28.1",
     "vite-plus": "catalog:",
     "vitest": "catalog:"
   },
   "peerDependencies": {
+    "@cloudflare/computer": "^0.2.0",
     "@cloudflare/vitest-pool-workers": "^0.21.3",
     "@cloudflare/workers-types": "^4.20260611.1",
     "@effect/sql-d1": "^4.0.0-beta.107 <4.0.0-rc.0",
@@ -66,6 +85,9 @@
     "effect": "^4.0.0-beta.107 <4.0.0-rc.0"
   },
   "peerDependenciesMeta": {
+    "@cloudflare/computer": {
+      "optional": true
+    },
     "@cloudflare/vitest-pool-workers": {
       "optional": true
     },