@cloudflare/config 0.4.0 → 0.5.0

package/dist/index.d.mts

@@ -3,6 +3,64 @@ import * as z from "zod";
 import { RawConfig } from "@cloudflare/workers-utils";
 
 //#region src/schema.d.ts
+declare const AssetsSchema: z.ZodObject<{
+  htmlHandling: z.ZodOptional<z.ZodEnum<{
+    "auto-trailing-slash": "auto-trailing-slash";
+    "drop-trailing-slash": "drop-trailing-slash";
+    "force-trailing-slash": "force-trailing-slash";
+    none: "none";
+  }>>;
+  notFoundHandling: z.ZodOptional<z.ZodEnum<{
+    none: "none";
+    "single-page-application": "single-page-application";
+    "404-page": "404-page";
+  }>>;
+  runWorkerFirst: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodBoolean]>>;
+}, z.core.$strict>;
+declare const BrowserBindingSchema: z.ZodObject<{
+  type: z.ZodLiteral<"browser">;
+  remote: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const WorkerBindingSchema: z.ZodObject<{
+  type: z.ZodLiteral<"worker">;
+  workerName: z.ZodString;
+  exportName: z.ZodOptional<z.ZodString>;
+  props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  remote: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const D1BindingSchema: z.ZodObject<{
+  type: z.ZodLiteral<"d1">;
+  name: z.ZodOptional<z.ZodString>;
+  id: z.ZodOptional<z.ZodString>;
+  remote: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const KVBindingSchema: z.ZodObject<{
+  type: z.ZodLiteral<"kv">;
+  id: z.ZodOptional<z.ZodString>;
+  remote: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const QueueBindingSchema: z.ZodObject<{
+  type: z.ZodLiteral<"queue">;
+  name: z.ZodOptional<z.ZodString>;
+  deliveryDelay: z.ZodOptional<z.ZodNumber>;
+  remote: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const R2BindingSchema: z.ZodObject<{
+  type: z.ZodLiteral<"r2">;
+  name: z.ZodOptional<z.ZodString>;
+  jurisdiction: z.ZodOptional<z.ZodString>;
+  remote: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const FlagshipBindingSchema: z.ZodObject<{
+  type: z.ZodLiteral<"flagship">;
+  id: z.ZodOptional<z.ZodString>;
+  remote: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const HyperdriveBindingSchema: z.ZodObject<{
+  type: z.ZodLiteral<"hyperdrive">;
+  id: z.ZodString;
+  localConnectionString: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
 declare const KnownBindingSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   type: z.ZodLiteral<"agent-memory">;
   namespace: z.ZodString;
@@ -153,6 +211,83 @@ declare const UnsafeBindingSchema: z.ZodObject<{
 }, z.core.$loose>;
 type BindingInput = z.input<typeof KnownBindingSchema> | z.input<typeof UnsafeBindingSchema>;
 type BindingOutput = z.output<typeof KnownBindingSchema> | z.output<typeof UnsafeBindingSchema>;
+declare const BindingSchema: z.ZodType<BindingOutput, BindingInput>;
+declare function validateSingletonBindings(env: Record<string, {
+  type: string;
+}>, ctx: z.RefinementCtx): void;
+declare const DurableObjectCreatedExportSchema: z.ZodObject<{
+  type: z.ZodLiteral<"durable-object">;
+  state: z.ZodOptional<z.ZodLiteral<"created">>;
+  storage: z.ZodEnum<{
+    sqlite: "sqlite";
+    "legacy-kv": "legacy-kv";
+  }>;
+}, z.core.$strict>;
+declare const DurableObjectDeletedExportSchema: z.ZodObject<{
+  type: z.ZodLiteral<"durable-object">;
+  state: z.ZodLiteral<"deleted">;
+}, z.core.$strict>;
+declare const DurableObjectRenamedExportSchema: z.ZodObject<{
+  type: z.ZodLiteral<"durable-object">;
+  state: z.ZodLiteral<"renamed">;
+  renamedTo: z.ZodString;
+}, z.core.$strict>;
+declare const DurableObjectTransferredExportSchema: z.ZodObject<{
+  type: z.ZodLiteral<"durable-object">;
+  state: z.ZodLiteral<"transferred">;
+  transferredTo: z.ZodString;
+}, z.core.$strict>;
+declare const DurableObjectExpectingTransferExportSchema: z.ZodObject<{
+  type: z.ZodLiteral<"durable-object">;
+  state: z.ZodLiteral<"expecting-transfer">;
+  storage: z.ZodEnum<{
+    sqlite: "sqlite";
+    "legacy-kv": "legacy-kv";
+  }>;
+  transferFrom: z.ZodString;
+}, z.core.$strict>;
+declare const WorkerEntrypointExportSchema: z.ZodObject<{
+  type: z.ZodLiteral<"worker">;
+  cache: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodBoolean;
+  }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const ExportSchema: z.ZodUnion<readonly [z.ZodObject<{
+  type: z.ZodLiteral<"durable-object">;
+  state: z.ZodOptional<z.ZodLiteral<"created">>;
+  storage: z.ZodEnum<{
+    sqlite: "sqlite";
+    "legacy-kv": "legacy-kv";
+  }>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"durable-object">;
+  state: z.ZodLiteral<"deleted">;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"durable-object">;
+  state: z.ZodLiteral<"renamed">;
+  renamedTo: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"durable-object">;
+  state: z.ZodLiteral<"transferred">;
+  transferredTo: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"durable-object">;
+  state: z.ZodLiteral<"expecting-transfer">;
+  storage: z.ZodEnum<{
+    sqlite: "sqlite";
+    "legacy-kv": "legacy-kv";
+  }>;
+  transferFrom: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"worker">;
+  cache: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodBoolean;
+  }, z.core.$strict>>;
+}, z.core.$strict>]>;
+declare const TailConsumerSchema: z.ZodObject<{
+  workerName: z.ZodString;
+  streaming: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
 /**
  * Input Worker schema — the shape that user-authored `cloudflare.config.ts`
  * files are validated against. Adds an optional `entrypoint` field to the
@@ -767,4 +902,4 @@ declare function loadAndValidateConfig(configPath: string, ctx: ConfigContext, o
   include?: string[];
 }): Promise<LoadAndValidateConfigResult>;
 //#endregion
-export { AgentMemoryBinding, AiBinding, AiSearchBinding, AiSearchNamespaceBinding, AnalyticsEngineDatasetBinding, ArtifactsBinding, AssetsBinding, Bindings, BrowserBinding, ConfigContext, ConfigExportsSchema, D1Binding, DispatchNamespaceBinding, DurableObjectBinding, DurableObjectCreatedExport, DurableObjectDeletedExport, DurableObjectExpectingTransferExport, DurableObjectRenamedExport, DurableObjectTransferredExport, EmailTrigger, Exports, FetchTrigger, FlagshipBinding, HyperdriveBinding, ImagesBinding, InferDurableNamespaces, InferEnv, InferMainModule, InputWorkerSchema, JsonBinding, KvBinding, type LoadAndValidateConfigResult, type LoadConfigResult, LogfwdrBinding, MediaBinding, type ModuleType, ModuleTypeSchema, MtlsCertificateBinding, OutputWorkerSchema, type ParsedConfigExports, type ParsedInputWorkerConfig, type ParsedOutputWorkerConfig, type ParsedSettingsConfig, PipelineBinding, QueueBinding, QueueConsumerTrigger, R2Binding, RateLimitBinding, ScheduledTrigger, SecretBinding, SecretsStoreSecretBinding, SendEmailBinding, SettingsConfig, SettingsConfigInput, SettingsSchema, StreamBinding, TextBinding, Triggers, TypedAiBinding, TypedDurableObjectBinding, TypedKvBinding, TypedPipelineBinding, TypedQueueBinding, TypedWorkerBinding, TypedWorkerDefinition, TypedWorkflowBinding, UnsafeBinding, UnwrapConfig, VectorizeBinding, VersionMetadataBinding, VpcNetworkBinding, VpcServiceBinding, WebSearchBinding, WorkerBinding, WorkerConfig, WorkerConfigExport, WorkerConfigInput, WorkerEntrypointExport, WorkerEntrypointExportOptions, WorkerLoaderBinding, WorkflowBinding, bindings, convertToWranglerConfig, defineSettings, defineWorker, exports, generateTypes, loadAndValidateConfig, loadConfig, registerConfigHooks, resolveExportDefinition, triggers };
+export { AgentMemoryBinding, AiBinding, AiSearchBinding, AiSearchNamespaceBinding, AnalyticsEngineDatasetBinding, ArtifactsBinding, AssetsBinding, AssetsSchema, BindingSchema, Bindings, BrowserBinding, BrowserBindingSchema, ConfigContext, ConfigExportsSchema, D1Binding, D1BindingSchema, DispatchNamespaceBinding, DurableObjectBinding, DurableObjectCreatedExport, DurableObjectCreatedExportSchema, DurableObjectDeletedExport, DurableObjectDeletedExportSchema, DurableObjectExpectingTransferExport, DurableObjectExpectingTransferExportSchema, DurableObjectRenamedExport, DurableObjectRenamedExportSchema, DurableObjectTransferredExport, DurableObjectTransferredExportSchema, EmailTrigger, ExportSchema, Exports, FetchTrigger, FlagshipBinding, FlagshipBindingSchema, HyperdriveBinding, HyperdriveBindingSchema, ImagesBinding, InferDurableNamespaces, InferEnv, InferMainModule, InputWorkerSchema, JsonBinding, KVBindingSchema, KnownBindingSchema, KvBinding, type LoadAndValidateConfigResult, type LoadConfigResult, LogfwdrBinding, MediaBinding, type ModuleType, ModuleTypeSchema, MtlsCertificateBinding, OutputWorkerSchema, type ParsedConfigExports, type ParsedInputWorkerConfig, type ParsedOutputWorkerConfig, type ParsedSettingsConfig, PipelineBinding, QueueBinding, QueueBindingSchema, QueueConsumerTrigger, R2Binding, R2BindingSchema, RateLimitBinding, ScheduledTrigger, SecretBinding, SecretsStoreSecretBinding, SendEmailBinding, SettingsConfig, SettingsConfigInput, SettingsSchema, StreamBinding, TailConsumerSchema, TextBinding, Triggers, TypedAiBinding, TypedDurableObjectBinding, TypedKvBinding, TypedPipelineBinding, TypedQueueBinding, TypedWorkerBinding, TypedWorkerDefinition, TypedWorkflowBinding, UnsafeBinding, UnsafeBindingSchema, UnwrapConfig, VectorizeBinding, VersionMetadataBinding, VpcNetworkBinding, VpcServiceBinding, WebSearchBinding, WorkerBinding, WorkerBindingSchema, WorkerConfig, WorkerConfigExport, WorkerConfigInput, WorkerEntrypointExport, WorkerEntrypointExportOptions, WorkerEntrypointExportSchema, WorkerLoaderBinding, WorkflowBinding, bindings, convertToWranglerConfig, defineSettings, defineWorker, exports, generateTypes, loadAndValidateConfig, loadConfig, registerConfigHooks, resolveExportDefinition, triggers, validateSingletonBindings };

package/dist/index.mjs

@@ -28,6 +28,50 @@ const AssetsSchema = z.strictObject({
 	]).optional(),
 	runWorkerFirst: z.union([z.array(z.string()), z.boolean()]).optional()
 });
+const BrowserBindingSchema = z.strictObject({
+	type: z.literal("browser"),
+	remote: z.boolean().optional()
+});
+const WorkerBindingSchema = z.strictObject({
+	type: z.literal("worker"),
+	workerName: z.string(),
+	exportName: z.string().optional(),
+	props: z.record(z.string(), z.unknown()).optional(),
+	remote: z.boolean().optional()
+});
+const D1BindingSchema = z.strictObject({
+	type: z.literal("d1"),
+	name: z.string().optional(),
+	id: z.string().optional(),
+	remote: z.boolean().optional()
+});
+const KVBindingSchema = z.strictObject({
+	type: z.literal("kv"),
+	id: z.string().optional(),
+	remote: z.boolean().optional()
+});
+const QueueBindingSchema = z.strictObject({
+	type: z.literal("queue"),
+	name: z.string().optional(),
+	deliveryDelay: z.number().optional(),
+	remote: z.boolean().optional()
+});
+const R2BindingSchema = z.strictObject({
+	type: z.literal("r2"),
+	name: z.string().optional(),
+	jurisdiction: z.string().optional(),
+	remote: z.boolean().optional()
+});
+const FlagshipBindingSchema = z.strictObject({
+	type: z.literal("flagship"),
+	id: z.string().optional(),
+	remote: z.boolean().optional()
+});
+const HyperdriveBindingSchema = z.strictObject({
+	type: z.literal("hyperdrive"),
+	id: z.string(),
+	localConnectionString: z.string().optional()
+});
 const KnownBindingSchema = z.discriminatedUnion("type", [
 	z.strictObject({
 		type: z.literal("agent-memory"),
@@ -58,16 +102,8 @@ const KnownBindingSchema = z.discriminatedUnion("type", [
 		remote: z.boolean().optional()
 	}),
 	z.strictObject({ type: z.literal("assets") }),
-	z.strictObject({
-		type: z.literal("browser"),
-		remote: z.boolean().optional()
-	}),
-	z.strictObject({
-		type: z.literal("d1"),
-		name: z.string().optional(),
-		id: z.string().optional(),
-		remote: z.boolean().optional()
-	}),
+	BrowserBindingSchema,
+	D1BindingSchema,
 	z.strictObject({
 		type: z.literal("dispatch-namespace"),
 		namespace: z.string().optional(),
@@ -82,16 +118,8 @@ const KnownBindingSchema = z.discriminatedUnion("type", [
 		workerName: z.string(),
 		exportName: z.string()
 	}),
-	z.strictObject({
-		type: z.literal("flagship"),
-		id: z.string().optional(),
-		remote: z.boolean().optional()
-	}),
-	z.strictObject({
-		type: z.literal("hyperdrive"),
-		id: z.string(),
-		localConnectionString: z.string().optional()
-	}),
+	FlagshipBindingSchema,
+	HyperdriveBindingSchema,
 	z.strictObject({
 		type: z.literal("images"),
 		remote: z.boolean().optional()
@@ -100,11 +128,7 @@ const KnownBindingSchema = z.discriminatedUnion("type", [
 		type: z.literal("json"),
 		value: z.json()
 	}),
-	z.strictObject({
-		type: z.literal("kv"),
-		id: z.string().optional(),
-		remote: z.boolean().optional()
-	}),
+	KVBindingSchema,
 	z.strictObject({
 		type: z.literal("logfwdr"),
 		destination: z.string()
@@ -123,12 +147,7 @@ const KnownBindingSchema = z.discriminatedUnion("type", [
 		name: z.string(),
 		remote: z.boolean().optional()
 	}),
-	z.strictObject({
-		type: z.literal("queue"),
-		name: z.string().optional(),
-		deliveryDelay: z.number().optional(),
-		remote: z.boolean().optional()
-	}),
+	QueueBindingSchema,
 	z.strictObject({
 		type: z.literal("rate-limit"),
 		namespace: z.string(),
@@ -137,12 +156,7 @@ const KnownBindingSchema = z.discriminatedUnion("type", [
 			period: z.union([z.literal(10), z.literal(60)])
 		})
 	}),
-	z.strictObject({
-		type: z.literal("r2"),
-		name: z.string().optional(),
-		jurisdiction: z.string().optional(),
-		remote: z.boolean().optional()
-	}),
+	R2BindingSchema,
 	z.strictObject({ type: z.literal("secret") }),
 	z.strictObject({
 		type: z.literal("secrets-store-secret"),
@@ -191,13 +205,7 @@ const KnownBindingSchema = z.discriminatedUnion("type", [
 		type: z.literal("web-search"),
 		remote: z.boolean().optional()
 	}),
-	z.strictObject({
-		type: z.literal("worker"),
-		workerName: z.string(),
-		exportName: z.string().optional(),
-		props: z.record(z.string(), z.unknown()).optional(),
-		remote: z.boolean().optional()
-	}),
+	WorkerBindingSchema,
 	z.strictObject({ type: z.literal("worker-loader") })
 ]);
 const UnsafeBindingSchema = z.looseObject({
@@ -239,7 +247,7 @@ const SINGLETON_BINDING_TYPES = new Set([
 	"web-search"
 ]);
 const listFormatter = new Intl.ListFormat("en-US");
-const EnvSchema = z.record(z.string(), BindingSchema).superRefine((env, ctx) => {
+function validateSingletonBindings(env, ctx) {
 	const seen = /* @__PURE__ */ new Set();
 	const duplicates = /* @__PURE__ */ new Set();
 	for (const binding of Object.values(env)) {
@@ -253,37 +261,44 @@ const EnvSchema = z.record(z.string(), BindingSchema).superRefine((env, ctx) =>
 		code: "custom",
 		message: `${listFormatter.format([...duplicates].sort())} bindings can only be defined once`
 	});
-}).optional();
+}
+const EnvSchema = z.record(z.string(), BindingSchema).superRefine(validateSingletonBindings).optional();
+const DurableObjectCreatedExportSchema = z.strictObject({
+	type: z.literal("durable-object"),
+	state: z.literal("created").optional(),
+	storage: z.enum(["sqlite", "legacy-kv"])
+});
+const DurableObjectDeletedExportSchema = z.strictObject({
+	type: z.literal("durable-object"),
+	state: z.literal("deleted")
+});
+const DurableObjectRenamedExportSchema = z.strictObject({
+	type: z.literal("durable-object"),
+	state: z.literal("renamed"),
+	renamedTo: z.string()
+});
+const DurableObjectTransferredExportSchema = z.strictObject({
+	type: z.literal("durable-object"),
+	state: z.literal("transferred"),
+	transferredTo: z.string()
+});
+const DurableObjectExpectingTransferExportSchema = z.strictObject({
+	type: z.literal("durable-object"),
+	state: z.literal("expecting-transfer"),
+	storage: z.enum(["sqlite", "legacy-kv"]),
+	transferFrom: z.string()
+});
+const WorkerEntrypointExportSchema = z.strictObject({
+	type: z.literal("worker"),
+	cache: z.strictObject({ enabled: z.boolean() }).optional()
+});
 const ExportSchema = z.union([
-	z.strictObject({
-		type: z.literal("durable-object"),
-		state: z.literal("created").optional(),
-		storage: z.enum(["sqlite", "legacy-kv"])
-	}),
-	z.strictObject({
-		type: z.literal("durable-object"),
-		state: z.literal("deleted")
-	}),
-	z.strictObject({
-		type: z.literal("durable-object"),
-		state: z.literal("renamed"),
-		renamedTo: z.string()
-	}),
-	z.strictObject({
-		type: z.literal("durable-object"),
-		state: z.literal("transferred"),
-		transferredTo: z.string()
-	}),
-	z.strictObject({
-		type: z.literal("durable-object"),
-		state: z.literal("expecting-transfer"),
-		storage: z.enum(["sqlite", "legacy-kv"]),
-		transferFrom: z.string()
-	}),
-	z.strictObject({
-		type: z.literal("worker"),
-		cache: z.strictObject({ enabled: z.boolean() }).optional()
-	})
+	DurableObjectCreatedExportSchema,
+	DurableObjectDeletedExportSchema,
+	DurableObjectRenamedExportSchema,
+	DurableObjectTransferredExportSchema,
+	DurableObjectExpectingTransferExportSchema,
+	WorkerEntrypointExportSchema
 ]);
 const LimitsSchema = z.strictObject({
 	cpuMs: z.number().optional(),
@@ -3691,4 +3706,4 @@ async function loadAndValidateConfig(configPath, ctx, options) {
 }
 
 //#endregion
-export { ConfigExportsSchema, InputWorkerSchema, ModuleTypeSchema, OutputWorkerSchema, SettingsSchema, bindings, convertToWranglerConfig, defineSettings, defineWorker, exports$1 as exports, generateTypes, loadAndValidateConfig, loadConfig, registerConfigHooks, resolveExportDefinition, triggers };
+export { AssetsSchema, BindingSchema, BrowserBindingSchema, ConfigExportsSchema, D1BindingSchema, DurableObjectCreatedExportSchema, DurableObjectDeletedExportSchema, DurableObjectExpectingTransferExportSchema, DurableObjectRenamedExportSchema, DurableObjectTransferredExportSchema, ExportSchema, FlagshipBindingSchema, HyperdriveBindingSchema, InputWorkerSchema, KVBindingSchema, KnownBindingSchema, ModuleTypeSchema, OutputWorkerSchema, QueueBindingSchema, R2BindingSchema, SettingsSchema, TailConsumerSchema, UnsafeBindingSchema, WorkerBindingSchema, WorkerEntrypointExportSchema, bindings, convertToWranglerConfig, defineSettings, defineWorker, exports$1 as exports, generateTypes, loadAndValidateConfig, loadConfig, registerConfigHooks, resolveExportDefinition, triggers, validateSingletonBindings };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudflare/config",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Definitions and utilities for configuring Cloudflare Workers and related products. This is not yet stable enough for external use — APIs may change without notice.",
   "homepage": "https://github.com/cloudflare/workers-sdk/tree/main/packages/config#readme",
   "bugs": {
@@ -31,13 +31,13 @@
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^5.20260730.1",
+    "@cloudflare/workers-types": "^5.20260804.1",
     "ts-dedent": "^2.2.0",
     "tsdown": "0.16.3",
     "typescript": "5.8.3",
     "vitest": "4.1.0",
     "@cloudflare/workers-tsconfig": "0.0.0",
-    "@cloudflare/workers-utils": "0.30.0"
+    "@cloudflare/workers-utils": "0.31.2"
   },
   "workers-sdk": {
     "prerelease": true