effect-cf 0.15.0 → 0.17.0

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-import { a as WorkerConfig, i as layer$16, n as Binding_exports, o as WorkerEnvironment, r as Service$2, t as Hyperdrive_exports } from "./Hyperdrive-89hg_Fck.mjs";
-import { Cause, Clock, ConfigProvider, Context, Data, DateTime, Duration, Effect, Exit, Layer, ManagedRuntime, Option, Queue, Schema } from "effect";
-import { FetchHttpClient, HttpServerRequest, HttpServerResponse } from "effect/unstable/http";
+import { a as WorkerConfig, i as layer$18, n as Binding_exports, o as WorkerEnvironment, r as Service$2, t as Hyperdrive_exports } from "./Hyperdrive-89hg_Fck.mjs";
+import { Cause, Clock, Config, ConfigProvider, Context, Data, DateTime, Duration, Effect, Exit, Layer, ManagedRuntime, Option, Queue, Result, Schema } from "effect";
+import { FetchHttpClient, HttpClient, HttpClientRequest, HttpServerRequest, HttpServerResponse } from "effect/unstable/http";
 import { OtlpLogger, OtlpMetrics, OtlpSerialization, OtlpTracer } from "effect/unstable/observability";
 import { D1Client } from "@effect/sql-d1";
 import { DurableObject, RpcStub, RpcTarget, WorkerEntrypoint, WorkflowEntrypoint } from "cloudflare:workers";
@@ -11,13 +11,13 @@ import * as RpcServer from "effect/unstable/rpc/RpcServer";
 import { SqliteClient } from "@effect/sql-sqlite-do";
 //#region src/WorkersAi.ts
 var WorkersAi_exports = /* @__PURE__ */ __exportAll({
-	Tag: () => Tag$15,
+	Tag: () => Tag$17,
 	WorkersAiOperationError: () => WorkersAiOperationError,
 	embeddingResponse: () => embeddingResponse,
 	isWorkersAiBinding: () => isWorkersAiBinding,
-	layer: () => layer$15,
-	make: () => make$15,
-	makeClient: () => makeClient$11
+	layer: () => layer$17,
+	make: () => make$17,
+	makeClient: () => makeClient$13
 });
 const expectedWorkersAiBinding = "Workers AI binding with run(), gateway(), and models()";
 /** Error raised when a Workers AI operation fails. */
@@ -41,7 +41,7 @@ const embeddingResponse = (value) => ({
 	data: value.data ?? [],
 	shape: value.shape ?? []
 });
-const makeClient$11 = (definition) => (ai) => {
+const makeClient$13 = (definition) => (ai) => {
 	const run = ((model, input, options) => tryWorkersAiPromise(definition.binding, "run", () => ai.run(model, input, options)));
 	return {
 		definition,
@@ -53,11 +53,11 @@ const makeClient$11 = (definition) => (ai) => {
 		unsafeRaw: Effect.succeed(ai)
 	};
 };
-const layer$15 = (tag, definition) => layer$16(tag, definition.binding, (value) => isWorkersAiBinding(value), makeClient$11(definition), { expected: expectedWorkersAiBinding });
-const make$15 = (id) => Tag$15()(id);
-const Tag$15 = () => (id) => {
+const layer$17 = (tag, definition) => layer$18(tag, definition.binding, (value) => isWorkersAiBinding(value), makeClient$13(definition), { expected: expectedWorkersAiBinding });
+const make$17 = (id) => Tag$17()(id);
+const Tag$17 = () => (id) => {
 	const tag = Context.Service()(id);
-	const makeLayer = (definition) => layer$15(tag, definition);
+	const makeLayer = (definition) => layer$17(tag, definition);
 	return Object.assign(tag, {
 		id,
 		layer: makeLayer
@@ -67,11 +67,11 @@ const Tag$15 = () => (id) => {
 //#region src/AiGateway.ts
 var AiGateway_exports = /* @__PURE__ */ __exportAll({
 	AiGatewayOperationError: () => AiGatewayOperationError,
-	Tag: () => Tag$14,
+	Tag: () => Tag$16,
 	isAiGatewayBinding: () => isAiGatewayBinding,
-	layer: () => layer$14,
-	make: () => make$14,
-	makeClient: () => makeClient$10,
+	layer: () => layer$16,
+	make: () => make$16,
+	makeClient: () => makeClient$12,
 	makeClientFromAi: () => makeClientFromAi,
 	makeHttpClient: () => makeHttpClient
 });
@@ -98,7 +98,7 @@ const providerUrl = (baseUrl, path = "") => {
 };
 const gatewayUrl = (definition) => `https://gateway.ai.cloudflare.com/v1/${definition.accountId}/${definition.gatewayId}/`;
 const isAiGatewayBinding = (value) => isWorkersAiBinding(value);
-const makeClient$10 = (definition, gateway) => ({
+const makeClient$12 = (definition, gateway) => ({
 	definition,
 	run: (data, options) => tryAiGatewayPromise(definition.binding, "run", () => gateway.run(Array.isArray(data) ? [...data] : data, options)),
 	getUrl: (provider) => tryAiGatewayPromise(definition.binding, "getUrl", () => gateway.getUrl(provider)),
@@ -115,11 +115,11 @@ const makeClientFromAi = (definition, ai) => {
 	const withGateway = (operation) => gateway.pipe(Effect.flatMap(operation));
 	return {
 		definition,
-		run: (data, options) => withGateway((raw) => makeClient$10(definition, raw).run(data, options)),
-		getUrl: (provider) => withGateway((raw) => makeClient$10(definition, raw).getUrl(provider)),
-		fetch: (options) => withGateway((raw) => makeClient$10(definition, raw).fetch(options)),
-		patchLog: (logId, data) => withGateway((raw) => makeClient$10(definition, raw).patchLog(logId, data)),
-		getLog: (logId) => withGateway((raw) => makeClient$10(definition, raw).getLog(logId)),
+		run: (data, options) => withGateway((raw) => makeClient$12(definition, raw).run(data, options)),
+		getUrl: (provider) => withGateway((raw) => makeClient$12(definition, raw).getUrl(provider)),
+		fetch: (options) => withGateway((raw) => makeClient$12(definition, raw).fetch(options)),
+		patchLog: (logId, data) => withGateway((raw) => makeClient$12(definition, raw).patchLog(logId, data)),
+		getLog: (logId) => withGateway((raw) => makeClient$12(definition, raw).getLog(logId)),
 		unsafeRaw: gateway
 	};
 };
@@ -159,25 +159,291 @@ const makeHttpClient = (definition, request = fetch) => {
 		unsafeRaw: Effect.fail(aiGatewayError(binding, "unsafeRaw", /* @__PURE__ */ new TypeError("HTTP AI Gateway clients have no raw binding")))
 	};
 };
-const layer$14 = (tag, definition) => layer$16(tag, definition.binding, isAiGatewayBinding, (ai) => makeClientFromAi(definition, ai), { expected: expectedAiGatewayBinding });
-const make$14 = (id) => Tag$14()(id);
-const Tag$14 = () => (id) => {
+const layer$16 = (tag, definition) => layer$18(tag, definition.binding, isAiGatewayBinding, (ai) => makeClientFromAi(definition, ai), { expected: expectedAiGatewayBinding });
+const make$16 = (id) => Tag$16()(id);
+const Tag$16 = () => (id) => {
 	const tag = Context.Service()(id);
-	const makeLayer = (definition) => layer$14(tag, definition);
+	const makeLayer = (definition) => layer$16(tag, definition);
 	return Object.assign(tag, {
 		id,
 		layer: makeLayer
 	});
 };
 //#endregion
+//#region src/AnalyticsEngine.ts
+var AnalyticsEngine_exports = /* @__PURE__ */ __exportAll({
+	AnalyticsEngineDataPointSchema: () => AnalyticsEngineDataPointSchema,
+	AnalyticsEngineFieldValueSchema: () => AnalyticsEngineFieldValueSchema,
+	AnalyticsEngineOperationError: () => AnalyticsEngineOperationError,
+	AnalyticsEngineQueryError: () => AnalyticsEngineQueryError,
+	AnalyticsEngineWriteValidationError: () => AnalyticsEngineWriteValidationError,
+	QueryTag: () => QueryTag,
+	Tag: () => Tag$15,
+	isAnalyticsEngineDataset: () => isAnalyticsEngineDataset,
+	layer: () => layer$15,
+	make: () => make$15,
+	makeClient: () => makeClient$11,
+	makeQuery: () => makeQuery,
+	makeQueryClient: () => makeQueryClient,
+	queryConfig: () => queryConfig,
+	queryFetchLayer: () => queryFetchLayer,
+	queryFetchLayerConfig: () => queryFetchLayerConfig,
+	queryLayer: () => queryLayer,
+	queryLayerConfig: () => queryLayerConfig,
+	writeLimits: () => writeLimits
+});
+const expectedAnalyticsEngineDataset = "Analytics Engine dataset binding with writeDataPoint()";
+const defaultQueryApiBaseUrl = "https://api.cloudflare.com/client/v4";
+const textEncoder = new TextEncoder();
+const writeLimits = {
+	maxBlobs: 20,
+	maxDoubles: 20,
+	maxIndexes: 1,
+	maxBlobBytes: 16 * 1024,
+	maxIndexBytes: 96,
+	maxDataPointsPerInvocation: 250
+};
+const queryColumnSchema = Schema.Struct({
+	name: Schema.String,
+	type: Schema.String
+});
+const queryRowSchema = Schema.Record(Schema.String, Schema.Unknown);
+const queryResponseSchema = Schema.Struct({
+	meta: Schema.Array(queryColumnSchema),
+	data: Schema.Array(queryRowSchema),
+	rows: Schema.Number
+});
+const AnalyticsEngineFieldValueSchema = Schema.NullOr(Schema.Union([Schema.String, Schema.instanceOf(ArrayBuffer)]));
+const AnalyticsEngineDataPointSchema = Schema.Struct({
+	indexes: Schema.optional(Schema.Array(AnalyticsEngineFieldValueSchema)),
+	doubles: Schema.optional(Schema.Array(Schema.Finite)),
+	blobs: Schema.optional(Schema.Array(AnalyticsEngineFieldValueSchema))
+});
+const decodeQueryResponse = Schema.decodeUnknownEffect(queryResponseSchema);
+const decodeDataPoint = Schema.decodeUnknownEffect(AnalyticsEngineDataPointSchema);
+/** Error raised when an Analytics Engine operation fails. */
+var AnalyticsEngineOperationError = class extends Data.TaggedError("AnalyticsEngineOperationError") {};
+/** Error raised when an Analytics Engine write input violates Cloudflare limits. */
+var AnalyticsEngineWriteValidationError = class extends Data.TaggedError("AnalyticsEngineWriteValidationError") {};
+/** Error raised when an Analytics Engine SQL API query fails. */
+var AnalyticsEngineQueryError = class extends Data.TaggedError("AnalyticsEngineQueryError") {};
+const analyticsEngineError = (binding, operation, cause) => new AnalyticsEngineOperationError({
+	binding,
+	operation,
+	cause
+});
+const analyticsEngineWriteValidationError = (binding, operation, violations, cause) => new AnalyticsEngineWriteValidationError({
+	binding,
+	operation,
+	violations,
+	cause
+});
+const analyticsEngineQueryError = (definition, operation, message, options) => new AnalyticsEngineQueryError({
+	operation,
+	accountId: definition.accountId,
+	message,
+	status: options?.status,
+	body: options?.body,
+	cause: options?.cause
+});
+const tryAnalyticsEngineSync = (binding, operation, evaluate) => Effect.try({
+	try: evaluate,
+	catch: (cause) => analyticsEngineError(binding, operation, cause)
+});
+const normalizeBatchSize = (batchSize) => {
+	if (batchSize === void 0 || !Number.isFinite(batchSize) || batchSize <= 0) return writeLimits.maxDataPointsPerInvocation;
+	return Math.min(Math.floor(batchSize), writeLimits.maxDataPointsPerInvocation);
+};
+const resolveWritePolicy = (defaults, options) => ({
+	onInvalid: options?.onInvalid ?? defaults?.onInvalid ?? "error",
+	batchSize: normalizeBatchSize(options?.batchSize ?? defaults?.batchSize)
+});
+const fieldPath = (prefix, field) => prefix === "" ? field : `${prefix}.${field}`;
+const indexedPath = (prefix, field, index) => `${fieldPath(prefix, field)}[${index}]`;
+const byteLength = (value) => {
+	if (value === null) return 0;
+	return typeof value === "string" ? textEncoder.encode(value).byteLength : value.byteLength;
+};
+const lengthViolation = (path, label, actual, limit) => ({
+	path,
+	message: `${label} exceeds Cloudflare Analytics Engine limit`,
+	actual,
+	limit
+});
+const validateDataPointLimits = (dataPoint, pathPrefix = "") => {
+	const violations = [];
+	if (dataPoint.blobs !== void 0 && dataPoint.blobs.length > writeLimits.maxBlobs) violations.push(lengthViolation(fieldPath(pathPrefix, "blobs"), "blobs", dataPoint.blobs.length, writeLimits.maxBlobs));
+	if (dataPoint.doubles !== void 0 && dataPoint.doubles.length > writeLimits.maxDoubles) violations.push(lengthViolation(fieldPath(pathPrefix, "doubles"), "doubles", dataPoint.doubles.length, writeLimits.maxDoubles));
+	if (dataPoint.indexes !== void 0 && dataPoint.indexes.length > writeLimits.maxIndexes) violations.push(lengthViolation(fieldPath(pathPrefix, "indexes"), "indexes", dataPoint.indexes.length, writeLimits.maxIndexes));
+	if (dataPoint.blobs !== void 0) {
+		const blobBytes = dataPoint.blobs.reduce((total, value) => total + byteLength(value), 0);
+		if (blobBytes > writeLimits.maxBlobBytes) violations.push(lengthViolation(fieldPath(pathPrefix, "blobs"), "blob bytes", blobBytes, writeLimits.maxBlobBytes));
+	}
+	if (dataPoint.indexes !== void 0) for (let index = 0; index < dataPoint.indexes.length; index++) {
+		const indexBytes = byteLength(dataPoint.indexes[index] ?? null);
+		if (indexBytes > writeLimits.maxIndexBytes) violations.push(lengthViolation(indexedPath(pathPrefix, "indexes", index), "index bytes", indexBytes, writeLimits.maxIndexBytes));
+	}
+	return violations;
+};
+const schemaViolation = (pathPrefix, cause) => ({
+	path: pathPrefix === "" ? "$" : pathPrefix,
+	message: cause.message
+});
+const toAnalyticsEngineDataPoint = (dataPoint) => ({
+	...dataPoint.indexes === void 0 ? {} : { indexes: [...dataPoint.indexes] },
+	...dataPoint.doubles === void 0 ? {} : { doubles: [...dataPoint.doubles] },
+	...dataPoint.blobs === void 0 ? {} : { blobs: [...dataPoint.blobs] }
+});
+const validateDataPoint = (binding, operation, dataPoint, pathPrefix = "") => Effect.gen(function* () {
+	const validated = toAnalyticsEngineDataPoint(yield* decodeDataPoint(dataPoint).pipe(Effect.mapError((cause) => analyticsEngineWriteValidationError(binding, operation, [schemaViolation(pathPrefix, cause)], cause))));
+	const violations = validateDataPointLimits(validated, pathPrefix);
+	if (violations.length > 0) return yield* Effect.fail(analyticsEngineWriteValidationError(binding, operation, violations));
+	return validated;
+});
+const validateOptionalDataPoint = (binding, operation, dataPoint) => dataPoint === void 0 ? Effect.succeed(void 0) : validateDataPoint(binding, operation, dataPoint);
+const validateDataPoints = (binding, operation, dataPoints, policy) => Effect.gen(function* () {
+	const points = dataPoints.length > writeLimits.maxDataPointsPerInvocation && policy.onInvalid === "drop" ? dataPoints.slice(0, writeLimits.maxDataPointsPerInvocation) : dataPoints;
+	const violations = [];
+	if (dataPoints.length > writeLimits.maxDataPointsPerInvocation && policy.onInvalid === "error") violations.push(lengthViolation("dataPoints", "data points per Worker invocation", dataPoints.length, writeLimits.maxDataPointsPerInvocation));
+	const validPoints = [];
+	for (let index = 0; index < points.length; index++) {
+		const result = yield* Effect.result(validateDataPoint(binding, operation, points[index], `dataPoints[${index}]`));
+		if (Result.isSuccess(result)) validPoints.push(result.success);
+		else if (policy.onInvalid === "error") violations.push(...result.failure.violations);
+	}
+	if (violations.length > 0) return yield* Effect.fail(analyticsEngineWriteValidationError(binding, operation, violations));
+	return validPoints;
+});
+const writeChunks = (binding, operation, dataset, dataPoints, batchSize) => Effect.gen(function* () {
+	const writeDataPoints = Reflect.get(dataset, "writeDataPoints");
+	for (let index = 0; index < dataPoints.length; index += batchSize) {
+		const chunk = dataPoints.slice(index, index + batchSize);
+		if (typeof writeDataPoints === "function") yield* tryAnalyticsEngineSync(binding, operation, () => writeDataPoints.call(dataset, chunk));
+		else for (const point of chunk) yield* tryAnalyticsEngineSync(binding, operation, () => dataset.writeDataPoint(point));
+	}
+});
+const queryApiUrl = (definition) => {
+	const baseUrl = new URL(definition.apiBaseUrl ?? defaultQueryApiBaseUrl);
+	baseUrl.pathname = `${baseUrl.pathname.replace(/\/+$/, "")}/accounts/${definition.accountId}/analytics_engine/sql`;
+	return baseUrl.href;
+};
+const queryRequest = (definition, sql, options) => {
+	let request = HttpClientRequest.post(queryApiUrl(definition)).pipe(HttpClientRequest.bodyText(sql, "text/plain;charset=UTF-8"));
+	if (options?.headers !== void 0) request = HttpClientRequest.setHeaders(request, options.headers);
+	return HttpClientRequest.bearerToken(request, definition.apiToken);
+};
+const responseText = (definition, response, operation) => response.text.pipe(Effect.catch((cause) => Effect.fail(analyticsEngineQueryError(definition, operation, "Failed to read Analytics Engine SQL API response body", { cause }))));
+const executeQueryRequest = (definition, httpClient, sql, options) => Effect.gen(function* () {
+	const response = yield* httpClient.execute(queryRequest(definition, sql, options)).pipe(Effect.mapError((cause) => analyticsEngineQueryError(definition, "query", "Analytics Engine SQL API request failed", { cause })));
+	if (response.status < 200 || response.status >= 300) {
+		const body = yield* responseText(definition, response, "queryErrorBody");
+		return yield* Effect.fail(analyticsEngineQueryError(definition, "query", `Analytics Engine SQL API returned HTTP ${response.status}`, {
+			status: response.status,
+			body
+		}));
+	}
+	return response;
+});
+const makeQueryClientWith = (definition, httpClient) => {
+	const raw = (sql, options) => executeQueryRequest(definition, httpClient, sql, options);
+	const query = (sql, options) => Effect.gen(function* () {
+		return yield* decodeQueryResponse(yield* (yield* raw(sql, options)).json.pipe(Effect.catch((cause) => Effect.fail(analyticsEngineQueryError(definition, "json", "Failed to read Analytics Engine SQL API JSON response body", { cause })))));
+	});
+	const queryResult = (row, sql, options) => Effect.gen(function* () {
+		const result = yield* query(sql, options);
+		const decodeRow = Schema.decodeUnknownEffect(row);
+		const data = [];
+		for (const value of result.data) data.push(yield* decodeRow(value));
+		return {
+			...result,
+			data,
+			rows: result.rows
+		};
+	});
+	return {
+		definition,
+		raw,
+		query,
+		queryResult,
+		queryRows: (row, sql, options) => queryResult(row, sql, options).pipe(Effect.map((result) => result.data)),
+		queryOne: (row, sql, options) => queryResult(row, sql, options).pipe(Effect.map((result) => result.data[0] === void 0 ? Option.none() : Option.some(result.data[0]))),
+		queryText: (sql, options) => raw(sql, options).pipe(Effect.flatMap((response) => responseText(definition, response, "text")))
+	};
+};
+const makeQueryClient = (definition) => Effect.map(HttpClient.HttpClient, (httpClient) => makeQueryClientWith(definition, httpClient));
+const isAnalyticsEngineDataset = (value) => {
+	if (typeof value !== "object" || value === null) return false;
+	return typeof Reflect.get(value, "writeDataPoint") === "function";
+};
+const makeClient$11 = (definition, defaults) => (dataset) => {
+	const writeDataPoint = (dataPoint, options) => {
+		const policy = resolveWritePolicy(defaults, options);
+		return validateOptionalDataPoint(definition.binding, "writeDataPoint", dataPoint).pipe(Effect.matchEffect({
+			onFailure: (error) => policy.onInvalid === "drop" ? Effect.succeed(void 0) : Effect.fail(error),
+			onSuccess: (point) => tryAnalyticsEngineSync(definition.binding, "writeDataPoint", () => dataset.writeDataPoint(point))
+		}));
+	};
+	const writeDataPoints = (dataPoints, options) => {
+		const policy = resolveWritePolicy(defaults, options);
+		return Effect.gen(function* () {
+			const validPoints = yield* validateDataPoints(definition.binding, "writeDataPoints", dataPoints, policy);
+			yield* writeChunks(definition.binding, "writeDataPoints", dataset, validPoints, policy.batchSize);
+		});
+	};
+	return {
+		definition,
+		writeDataPoint,
+		write: writeDataPoint,
+		writeDataPoints,
+		writeBatch: writeDataPoints,
+		unsafeRaw: Effect.succeed(dataset)
+	};
+};
+const queryConfig = (options) => Config.all({
+	accountId: options?.accountId ?? Config.string("CLOUDFLARE_ACCOUNT_ID"),
+	apiToken: options?.apiToken ?? Config.redacted("CLOUDFLARE_API_TOKEN"),
+	apiBaseUrl: options?.apiBaseUrl ?? Config.string("CLOUDFLARE_API_BASE_URL").pipe(Config.withDefault(defaultQueryApiBaseUrl))
+});
+const queryLayer = (tag, definition) => Layer.effect(tag, makeQueryClient(definition));
+const queryFetchLayer = (tag, definition) => queryLayer(tag, definition).pipe(Layer.provide(FetchHttpClient.layer));
+const queryLayerConfig = (tag, config = queryConfig()) => Layer.effect(tag, Effect.gen(function* () {
+	return yield* makeQueryClient(yield* config);
+}));
+const queryFetchLayerConfig = (tag, config = queryConfig()) => queryLayerConfig(tag, config).pipe(Layer.provide(FetchHttpClient.layer));
+const layer$15 = (tag, definition) => layer$18(tag, definition.binding, isAnalyticsEngineDataset, makeClient$11(definition, definition.write), { expected: expectedAnalyticsEngineDataset });
+const make$15 = (id) => Tag$15()(id);
+const makeQuery = (id) => QueryTag()(id);
+const Tag$15 = () => (id) => {
+	const tag = Context.Service()(id);
+	const makeLayer = (definition) => layer$15(tag, definition);
+	return Object.assign(tag, {
+		id,
+		layer: makeLayer
+	});
+};
+const QueryTag = () => (id) => {
+	const tag = Context.Service()(id);
+	const makeLayer = (definition) => queryLayer(tag, definition);
+	const makeFetchLayer = (definition) => queryFetchLayer(tag, definition);
+	const makeLayerConfig = (config) => queryLayerConfig(tag, config);
+	const makeFetchLayerConfig = (config) => queryFetchLayerConfig(tag, config);
+	return Object.assign(tag, {
+		id,
+		layer: makeLayer,
+		fetchLayer: makeFetchLayer,
+		layerConfig: makeLayerConfig,
+		fetchLayerConfig: makeFetchLayerConfig
+	});
+};
+//#endregion
 //#region src/BrowserRendering.ts
 var BrowserRendering_exports = /* @__PURE__ */ __exportAll({
 	BrowserRenderingOperationError: () => BrowserRenderingOperationError,
-	Tag: () => Tag$13,
+	Tag: () => Tag$14,
 	isBrowserRenderingBinding: () => isBrowserRenderingBinding,
-	layer: () => layer$13,
-	make: () => make$13,
-	makeClient: () => makeClient$9
+	layer: () => layer$14,
+	make: () => make$14,
+	makeClient: () => makeClient$10
 });
 const expectedBrowserRenderingBinding = "Browser Rendering binding resource";
 /** Error raised when a Browser Rendering operation fails. */
@@ -214,17 +480,17 @@ const wrapBrowser = (binding, browser) => ({
 	disconnect: browser.disconnect === void 0 ? Effect.void : tryBrowserRenderingSync(binding, "disconnect", () => browser.disconnect())
 });
 const isBrowserRenderingBinding = (value) => (typeof value === "object" || typeof value === "function") && value !== null;
-const makeClient$9 = (definition) => (binding) => ({
+const makeClient$10 = (definition) => (binding) => ({
 	definition,
 	launchWith: (launch, options) => tryBrowserRenderingPromise(definition.binding, "launch", () => launch(binding, options)).pipe(Effect.map((browser) => wrapBrowser(definition.binding, browser))),
 	connectWith: (connect, options) => tryBrowserRenderingPromise(definition.binding, "connect", () => connect(binding, options)).pipe(Effect.map((browser) => wrapBrowser(definition.binding, browser))),
 	unsafeRaw: Effect.succeed(binding)
 });
-const layer$13 = (tag, definition) => layer$16(tag, definition.binding, isBrowserRenderingBinding, makeClient$9(definition), { expected: expectedBrowserRenderingBinding });
-const make$13 = (id) => Tag$13()(id);
-const Tag$13 = () => (id) => {
+const layer$14 = (tag, definition) => layer$18(tag, definition.binding, isBrowserRenderingBinding, makeClient$10(definition), { expected: expectedBrowserRenderingBinding });
+const make$14 = (id) => Tag$14()(id);
+const Tag$14 = () => (id) => {
 	const tag = Context.Service()(id);
-	const makeLayer = (definition) => layer$13(tag, definition);
+	const makeLayer = (definition) => layer$14(tag, definition);
 	return Object.assign(tag, {
 		id,
 		layer: makeLayer
@@ -523,7 +789,7 @@ const runPromiseExitPreservingTypedFailures = async (effect) => {
 //#region src/CloudflareOtlp.ts
 var CloudflareOtlp_exports = /* @__PURE__ */ __exportAll({
 	durableObjectLayer: () => durableObjectLayer,
-	layer: () => layer$12,
+	layer: () => layer$13,
 	layerJson: () => layerJson,
 	layerProtobuf: () => layerProtobuf,
 	workerLayer: () => workerLayer
@@ -585,14 +851,14 @@ const makeLayer = (options = {}, runtimeAttributes = {}) => {
 * installed as the primary `ConfigProvider`; outside Cloudflare, the ambient
 * Effect `ConfigProvider` remains the fallback.
 */
-const layer$12 = (options = {}) => makeLayer(options);
+const layer$13 = (options = {}) => makeLayer(options);
 /** Base OTLP telemetry layer forced to JSON serialization. */
-const layerJson = (options = {}) => layer$12({
+const layerJson = (options = {}) => layer$13({
 	...options,
 	serialization: "json"
 });
 /** Base OTLP telemetry layer forced to protobuf serialization. */
-const layerProtobuf = (options = {}) => layer$12({
+const layerProtobuf = (options = {}) => layer$13({
 	...options,
 	serialization: "protobuf"
 });
@@ -619,6 +885,118 @@ const durableObjectLayer = (options = {}) => Layer.unwrap(Effect.map(DurableObje
 	"cloudflare.durable_object.id": options.includeObjectId ? state.id.toString() : void 0
 })));
 //#endregion
+//#region src/ContainerNamespace.ts
+var ContainerNamespace_exports = /* @__PURE__ */ __exportAll({
+	ContainerNamespace: () => ContainerNamespace,
+	ContainerOperationError: () => ContainerOperationError,
+	ContainerState: () => ContainerState,
+	Tag: () => Tag$13,
+	isContainerNamespaceResource: () => isContainerNamespaceResource,
+	layer: () => layer$12,
+	make: () => make$13,
+	makeClient: () => makeClient$9
+});
+const expectedContainerNamespace = "Container namespace binding with getByName()";
+/** Serializable state reported by a Cloudflare Container instance. */
+const ContainerState = Schema.Union([Schema.Struct({
+	lastChange: Schema.Finite,
+	status: Schema.Literals([
+		"running",
+		"stopping",
+		"stopped",
+		"healthy"
+	])
+}), Schema.Struct({
+	lastChange: Schema.Finite,
+	status: Schema.Literal("stopped_with_code"),
+	exitCode: Schema.optionalKey(Schema.Int)
+})]);
+/** Failure raised when invoking a named Container operation. */
+var ContainerOperationError = class extends Data.TaggedError("ContainerOperationError") {};
+const tryContainerPromise = (definition, instance, operation, evaluate) => Effect.tryPromise({
+	try: evaluate,
+	catch: (cause) => new ContainerOperationError({
+		binding: definition.binding,
+		instance,
+		operation,
+		cause
+	})
+});
+const makeInstanceClient = (definition, instance, stub) => ({
+	unsafeRaw: Effect.succeed(stub),
+	state: tryContainerPromise(definition, instance, "state", () => stub.getState()).pipe(Effect.flatMap(Schema.decodeUnknownEffect(ContainerState)), Effect.mapError((cause) => cause instanceof ContainerOperationError ? cause : new ContainerOperationError({
+		binding: definition.binding,
+		instance,
+		operation: "state",
+		cause
+	}))),
+	fetch: (input, init) => tryContainerPromise(definition, instance, "fetch", () => stub.fetch(input, init)),
+	start: (options, waitOptions) => tryContainerPromise(definition, instance, "start", () => stub.start(options, waitOptions)),
+	startAndWaitForPorts: (options) => tryContainerPromise(definition, instance, "startAndWaitForPorts", () => stub.startAndWaitForPorts(options)),
+	stop: (signal) => tryContainerPromise(definition, instance, "stop", () => stub.stop(signal)),
+	destroy: tryContainerPromise(definition, instance, "destroy", () => stub.destroy())
+});
+const isContainerNamespaceResource = (value) => typeof value === "object" && value !== null && typeof Reflect.get(value, "getByName") === "function";
+const makeClient$9 = (definition) => (namespace) => {
+	const getByName = (name, options) => Effect.try({
+		try: () => makeInstanceClient(definition, name, namespace.getByName(name, options)),
+		catch: (cause) => new ContainerOperationError({
+			binding: definition.binding,
+			instance: name,
+			operation: "getByName",
+			cause
+		})
+	});
+	const byName = (name, options) => {
+		const instance = getByName(name, options);
+		return {
+			unsafeRaw: Effect.flatMap(instance, (client) => client.unsafeRaw),
+			state: Effect.flatMap(instance, (client) => client.state),
+			fetch: (input, init) => Effect.flatMap(instance, (client) => client.fetch(input, init)),
+			start: (startOptions, waitOptions) => Effect.flatMap(instance, (client) => client.start(startOptions, waitOptions)),
+			startAndWaitForPorts: (startOptions) => Effect.flatMap(instance, (client) => client.startAndWaitForPorts(startOptions)),
+			stop: (signal) => Effect.flatMap(instance, (client) => client.stop(signal)),
+			destroy: Effect.flatMap(instance, (client) => client.destroy)
+		};
+	};
+	return {
+		definition,
+		getByName,
+		byName,
+		unsafeRaw: Effect.succeed(namespace)
+	};
+};
+const layer$12 = (tag, definition) => layer$18(tag, definition.binding, isContainerNamespaceResource, makeClient$9(definition), { expected: expectedContainerNamespace });
+const make$13 = (id) => Tag$13()(id);
+/** Creates a typed Effect service for a Cloudflare Container namespace. */
+const Tag$13 = () => (id) => {
+	const tag = Context.Service()(id);
+	const makeLayer = (definition) => layer$12(tag, definition);
+	const getByName = (name, options) => Effect.gen(function* () {
+		return yield* (yield* tag).getByName(name, options);
+	});
+	const byName = (name, options) => ({
+		state: Effect.flatMap(getByName(name, options), (instance) => instance.state),
+		fetch: (input, init) => Effect.flatMap(getByName(name, options), (instance) => instance.fetch(input, init)),
+		start: (startOptions, waitOptions) => Effect.flatMap(getByName(name, options), (instance) => instance.start(startOptions, waitOptions)),
+		startAndWaitForPorts: (startOptions) => Effect.flatMap(getByName(name, options), (instance) => instance.startAndWaitForPorts(startOptions)),
+		stop: (signal) => Effect.flatMap(getByName(name, options), (instance) => instance.stop(signal)),
+		destroy: Effect.flatMap(getByName(name, options), (instance) => instance.destroy),
+		unsafeRaw: Effect.flatMap(getByName(name, options), (instance) => instance.unsafeRaw)
+	});
+	const unsafeRaw = Effect.fn(function* () {
+		return yield* (yield* tag).unsafeRaw;
+	});
+	return Object.assign(tag, {
+		id,
+		layer: makeLayer,
+		getByName,
+		byName,
+		unsafeRaw
+	});
+};
+const ContainerNamespace = Tag$13;
+//#endregion
 //#region src/D1.ts
 var D1_exports = /* @__PURE__ */ __exportAll({
 	Service: () => Service$1,
@@ -726,7 +1104,7 @@ const makeClient$8 = (definition) => {
 		unsafeRaw: Effect.succeed(queue)
 	});
 };
-const layer$11 = (tag, definition) => layer$16(tag, definition.binding, (value) => isQueue(value), makeClient$8(definition), { expected: expectedQueueProducer });
+const layer$11 = (tag, definition) => layer$18(tag, definition.binding, (value) => isQueue(value), makeClient$8(definition), { expected: expectedQueueProducer });
 //#endregion
 //#region src/QueueDefinition.ts
 var QueueDefinition_exports = /* @__PURE__ */ __exportAll({
@@ -1069,7 +1447,7 @@ const makeClient$7 = (definition) => {
 		});
 	};
 };
-const layer$10 = (tag, definition) => layer$16(tag, definition.binding, (value) => isServiceBindingClient(value), makeClient$7(definition), { expected: expectedServiceBinding });
+const layer$10 = (tag, definition) => layer$18(tag, definition.binding, (value) => isServiceBindingClient(value), makeClient$7(definition), { expected: expectedServiceBinding });
 /**
 * Creates a typed Effect service for a Worker service binding.
 *
@@ -1446,7 +1824,7 @@ const makeClient$6 = (definition) => {
 		});
 	};
 };
-const layer$8 = (tag, definition) => layer$16(tag, definition.binding, (value) => isDurableObjectNamespaceClient(value), makeClient$6(definition), { expected: expectedDurableObjectNamespace });
+const layer$8 = (tag, definition) => layer$18(tag, definition.binding, (value) => isDurableObjectNamespaceClient(value), makeClient$6(definition), { expected: expectedDurableObjectNamespace });
 const makeDirectMethods = (rpcDefinition, helpers) => {
 	const methods = {};
 	if (rpcDefinition !== void 0) {
@@ -2161,7 +2539,7 @@ const makeClient$5 = (definition) => (email) => {
 		unsafeRaw: Effect.succeed(email)
 	};
 };
-const layer$5 = (tag, definition) => layer$16(tag, definition.binding, isEmailBinding, makeClient$5(definition), { expected: expectedSendEmailBinding });
+const layer$5 = (tag, definition) => layer$18(tag, definition.binding, isEmailBinding, makeClient$5(definition), { expected: expectedSendEmailBinding });
 const make$5 = (id) => Tag$6()(id);
 const Tag$6 = () => (id) => {
 	const tag = Context.Service()(id);
@@ -2268,7 +2646,7 @@ const makeClient$4 = (definition) => (images) => {
 		unsafeRaw: Effect.succeed(images)
 	};
 };
-const layer$4 = (tag, definition) => layer$16(tag, definition.binding, isImagesBinding, makeClient$4(definition), { expected: expectedImagesBinding });
+const layer$4 = (tag, definition) => layer$18(tag, definition.binding, isImagesBinding, makeClient$4(definition), { expected: expectedImagesBinding });
 const make$4 = (id) => Tag$5()(id);
 const Tag$5 = () => (id) => {
 	const tag = Context.Service()(id);
@@ -2363,7 +2741,7 @@ const makeClient$3 = (definition) => {
 		unsafeRaw: Effect.succeed(kv)
 	});
 };
-const layer$3 = (tag, definition) => layer$16(tag, definition.binding, isKvNamespace, makeClient$3(definition), { expected: expectedKvNamespace });
+const layer$3 = (tag, definition) => layer$18(tag, definition.binding, isKvNamespace, makeClient$3(definition), { expected: expectedKvNamespace });
 const makeDefinition$1 = (id, definition) => {
 	const kvDefinition = {
 		id,
@@ -2480,7 +2858,7 @@ const makeClient$2 = (definition) => {
 		};
 	};
 };
-const layer$2 = (tag, definition) => layer$16(tag, definition.binding, isR2Bucket, makeClient$2(definition), { expected: expectedR2Bucket });
+const layer$2 = (tag, definition) => layer$18(tag, definition.binding, isR2Bucket, makeClient$2(definition), { expected: expectedR2Bucket });
 const make$3 = (id) => Tag$3()(id);
 const Tag$3 = () => (id) => {
 	const tag = Context.Service()(id);
@@ -2566,7 +2944,7 @@ const makeClient$1 = (definition) => {
 		unsafeRaw: Effect.succeed(workflow)
 	});
 };
-const layer$1 = (tag, definition) => layer$16(tag, definition.binding, (value) => isWorkflow(value), makeClient$1(definition), { expected: expectedWorkflow });
+const layer$1 = (tag, definition) => layer$18(tag, definition.binding, (value) => isWorkflow(value), makeClient$1(definition), { expected: expectedWorkflow });
 //#endregion
 //#region src/WorkflowDefinition.ts
 var WorkflowDefinition_exports = /* @__PURE__ */ __exportAll({
@@ -2740,7 +3118,7 @@ const makeClient = (definition) => (index) => {
 		unsafeRaw: Effect.succeed(index)
 	};
 };
-const layer = (tag, definition) => layer$16(tag, definition.binding, isVectorizeBinding, makeClient(definition), { expected: expectedVectorizeBinding });
+const layer = (tag, definition) => layer$18(tag, definition.binding, isVectorizeBinding, makeClient(definition), { expected: expectedVectorizeBinding });
 const make = (id) => Tag()(id);
 const Tag = () => (id) => {
 	const tag = Context.Service()(id);
@@ -2751,4 +3129,4 @@ const Tag = () => (id) => {
 	});
 };
 //#endregion
-export { AiGateway_exports as AiGateway, Binding_exports as Binding, BrowserRendering_exports as BrowserRendering, CloudflareOtlp_exports as CloudflareOtlp, 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, 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, Binding_exports as Binding, BrowserRendering_exports as BrowserRendering, 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, 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effect-cf",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Effect-native primitives for Cloudflare Workers and bindings.",
   "license": "MIT",
   "repository": {
@@ -39,6 +39,7 @@
     "prepublishOnly": "vp run build"
   },
   "devDependencies": {
+    "@cloudflare/containers": "catalog:",
     "@cloudflare/vitest-pool-workers": "catalog:",
     "@cloudflare/workers-types": "catalog:",
     "@effect/platform-node": "4.0.0-beta.77",