@cloudflare/config 0.2.1 → 0.3.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as StreamBinding, A as AnalyticsEngineDatasetBinding, B as ImagesBinding, C as ScheduledTrigger, D as AiBinding, E as AgentMemoryBinding, F as D1Binding, G as MtlsCertificateBinding, H as KvBinding, I as DispatchNamespaceBinding, J as R2Binding, K as PipelineBinding, L as DurableObjectBinding, M as AssetsBinding, N as Bindings, O as AiSearchBinding, P as BrowserBinding, Q as SendEmailBinding, R as FlagshipBinding, S as QueueConsumerTrigger, T as triggers, U as LogfwdrBinding, V as JsonBinding, W as MediaBinding, X as SecretBinding, Y as RateLimitBinding, Z as SecretsStoreSecretBinding, _ as WorkerEntrypointExport, _t as bindings, a as ConfigContext, at as TypedQueueBinding, b as EmailTrigger, c as defineWorker, ct as UnsafeBinding, d as DurableObjectCreatedExport, dt as VpcNetworkBinding, et as TextBinding, f as DurableObjectDeletedExport, ft as VpcServiceBinding, g as Exports, gt as WorkflowBinding, h as DurableObjectTransferredExport, ht as WorkerLoaderBinding, i as UnwrapConfig, it as TypedPipelineBinding, j as ArtifactsBinding, k as AiSearchNamespaceBinding, l as resolveWorkerDefinition, lt as VectorizeBinding, m as DurableObjectRenamedExport, mt as WorkerBinding, n as InferEnv, nt as TypedDurableObjectBinding, o as TypedWorkerDefinition, ot as TypedWorkerBinding, p as DurableObjectExpectingTransferExport, pt as WebSearchBinding, q as QueueBinding, r as InferMainModule, rt as TypedKvBinding, s as UserConfigExport, st as TypedWorkflowBinding, t as InferDurableNamespaces, tt as TypedAiBinding, u as UserConfig, ut as VersionMetadataBinding, v as WorkerEntrypointExportOptions, w as Triggers, x as FetchTrigger, y as exports, z as HyperdriveBinding } from "./public-m7PNfSwY.mjs";
+import { $ as RateLimitBinding, A as AgentMemoryBinding, B as DispatchNamespaceBinding, C as exports, D as ScheduledTrigger, E as QueueConsumerTrigger, F as ArtifactsBinding, G as JsonBinding, H as FlagshipBinding, I as AssetsBinding, J as MediaBinding, K as KvBinding, L as Bindings, M as AiSearchBinding, N as AiSearchNamespaceBinding, O as Triggers, P as AnalyticsEngineDatasetBinding, Q as R2Binding, R as BrowserBinding, S as WorkerEntrypointExportOptions, T as FetchTrigger, U as HyperdriveBinding, V as DurableObjectBinding, W as ImagesBinding, X as PipelineBinding, Y as MtlsCertificateBinding, Z as QueueBinding, _ as DurableObjectExpectingTransferExport, _t as WebSearchBinding, a as InferMainModule, at as TypedAiBinding, b as Exports, bt as WorkflowBinding, c as WorkerConfigExport, ct as TypedPipelineBinding, d as SettingsConfig, dt as TypedWorkflowBinding, et as SecretBinding, f as WorkerConfig, ft as UnsafeBinding, g as DurableObjectDeletedExport, gt as VpcServiceBinding, h as DurableObjectCreatedExport, ht as VpcNetworkBinding, i as InferEnv, it as TextBinding, j as AiBinding, k as triggers, l as WorkerConfigInput, lt as TypedQueueBinding, m as resolveExportDefinition, mt as VersionMetadataBinding, n as defineSettings, nt as SendEmailBinding, o as UnwrapConfig, ot as TypedDurableObjectBinding, p as ConfigContext, pt as VectorizeBinding, q as LogfwdrBinding, r as InferDurableNamespaces, rt as StreamBinding, s as TypedWorkerDefinition, st as TypedKvBinding, t as SettingsConfigInput, tt as SecretsStoreSecretBinding, u as defineWorker, ut as TypedWorkerBinding, v as DurableObjectRenamedExport, vt as WorkerBinding, w as EmailTrigger, x as WorkerEntrypointExport, xt as bindings, y as DurableObjectTransferredExport, yt as WorkerLoaderBinding, z as D1Binding } from "./public-myuV_kLK.mjs";
 import * as z from "zod";
 import { RawConfig } from "@cloudflare/workers-utils";
 
@@ -37,7 +37,7 @@ declare const KnownBindingSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   remote: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>, z.ZodObject<{
   type: z.ZodLiteral<"dispatch-namespace">;
-  namespace: z.ZodString;
+  namespace: z.ZodOptional<z.ZodString>;
   outbound: z.ZodOptional<z.ZodObject<{
     workerName: z.ZodString;
     parameters: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -49,7 +49,7 @@ declare const KnownBindingSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   exportName: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
   type: z.ZodLiteral<"flagship">;
-  id: z.ZodString;
+  id: z.ZodOptional<z.ZodString>;
   remote: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>, z.ZodObject<{
   type: z.ZodLiteral<"hyperdrive">;
@@ -81,7 +81,7 @@ declare const KnownBindingSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   remote: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>, z.ZodObject<{
   type: z.ZodLiteral<"queue">;
-  name: z.ZodString;
+  name: z.ZodOptional<z.ZodString>;
   deliveryDelay: z.ZodOptional<z.ZodNumber>;
   remote: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>, z.ZodObject<{
@@ -159,8 +159,8 @@ type BindingOutput = z.output<typeof KnownBindingSchema> | z.output<typeof Unsaf
  * base schema.
  */
 declare const InputWorkerSchema: z.ZodObject<{
+  type: z.ZodLiteral<"worker">;
   name: z.ZodString;
-  accountId: z.ZodOptional<z.ZodString>;
   compatibilityDate: z.ZodString;
   compatibilityFlags: z.ZodOptional<z.ZodArray<z.ZodString>>;
   assets: z.ZodOptional<z.ZodObject<{
@@ -247,10 +247,168 @@ declare const InputWorkerSchema: z.ZodObject<{
   }, z.core.$strict>>;
   workersDev: z.ZodOptional<z.ZodBoolean>;
   previewUrls: z.ZodOptional<z.ZodBoolean>;
+  firstPartyWorker: z.ZodOptional<z.ZodBoolean>;
+  unsafe: z.ZodOptional<z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    capnp: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+      basePath: z.ZodString;
+      sourceSchemas: z.ZodArray<z.ZodString>;
+      compiledSchema: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strict>, z.ZodObject<{
+      basePath: z.ZodOptional<z.ZodNever>;
+      sourceSchemas: z.ZodOptional<z.ZodNever>;
+      compiledSchema: z.ZodString;
+    }, z.core.$strict>]>>;
+  }, z.core.$strict>>;
+  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<BindingOutput, BindingInput, z.core.$ZodTypeInternals<BindingOutput, BindingInput>>>>;
+  exports: z.ZodOptional<z.ZodRecord<z.ZodString, 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>]>>>;
+  entrypoint: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    default: z.ZodString;
+  }, z.core.$strict>]>, z.ZodTransform<string, string | {
+    default: string;
+  }>>>;
+}, z.core.$strict>;
+type ParsedInputWorkerConfig = z.output<typeof InputWorkerSchema>;
+/**
+ * Settings schema — validates the named `settings` export of a
+ * `cloudflare.config.ts`. Holds account/deployment settings shared by the other exports.
+ */
+declare const SettingsSchema: z.ZodObject<{
+  type: z.ZodLiteral<"settings">;
+  accountId: z.ZodOptional<z.ZodString>;
   complianceRegion: z.ZodOptional<z.ZodEnum<{
     public: "public";
     "fedramp-high": "fedramp-high";
   }>>;
+}, z.core.$strict>;
+type ParsedSettingsConfig = z.output<typeof SettingsSchema>;
+/**
+ * Schema for the resolved config exports, keyed by export
+ * name. Each value is discriminated on its `type` field. Reserves the
+ * `settings` export name exclusively for settings configs: a `settings`
+ * config must live on the `settings` export, and the `settings` export
+ * may only hold a `settings` config.
+ */
+declare const ConfigExportsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"worker">;
+  name: z.ZodString;
+  compatibilityDate: z.ZodString;
+  compatibilityFlags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  assets: z.ZodOptional<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>>;
+  domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  triggers: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"email">;
+    addresses: z.ZodArray<z.ZodString>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"fetch">;
+    pattern: z.ZodString;
+    zone: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"queue">;
+    name: z.ZodString;
+    deadLetterQueue: z.ZodOptional<z.ZodString>;
+    maxBatchSize: z.ZodOptional<z.ZodNumber>;
+    maxBatchTimeout: z.ZodOptional<z.ZodNumber>;
+    maxConcurrency: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    retryDelay: z.ZodOptional<z.ZodNumber>;
+    visibilityTimeoutMs: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"scheduled">;
+    schedule: z.ZodString;
+  }, z.core.$strict>], "type">>>;
+  tailConsumers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    workerName: z.ZodString;
+    streaming: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>>;
+  cache: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodBoolean;
+    crossVersionCache: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>;
+  placement: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+    mode: z.ZodEnum<{
+      off: "off";
+      smart: "smart";
+    }>;
+    hint: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>, z.ZodObject<{
+    mode: z.ZodOptional<z.ZodLiteral<"targeted">>;
+    region: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    mode: z.ZodOptional<z.ZodLiteral<"targeted">>;
+    host: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    mode: z.ZodOptional<z.ZodLiteral<"targeted">>;
+    hostname: z.ZodString;
+  }, z.core.$strict>]>>;
+  limits: z.ZodOptional<z.ZodObject<{
+    cpuMs: z.ZodOptional<z.ZodNumber>;
+    subrequests: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>>;
+  logpush: z.ZodOptional<z.ZodBoolean>;
+  observability: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    headSamplingRate: z.ZodOptional<z.ZodNumber>;
+    logs: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      headSamplingRate: z.ZodOptional<z.ZodNumber>;
+      invocationLogs: z.ZodOptional<z.ZodBoolean>;
+      persist: z.ZodOptional<z.ZodBoolean>;
+      destinations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    traces: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      headSamplingRate: z.ZodOptional<z.ZodNumber>;
+      persist: z.ZodOptional<z.ZodBoolean>;
+      destinations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>>;
+  workersDev: z.ZodOptional<z.ZodBoolean>;
+  previewUrls: z.ZodOptional<z.ZodBoolean>;
   firstPartyWorker: z.ZodOptional<z.ZodBoolean>;
   unsafe: z.ZodOptional<z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -302,8 +460,15 @@ declare const InputWorkerSchema: z.ZodObject<{
   }, z.core.$strict>]>, z.ZodTransform<string, string | {
     default: string;
   }>>>;
-}, z.core.$strict>;
-type ParsedInputWorkerConfig = z.output<typeof InputWorkerSchema>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"settings">;
+  accountId: z.ZodOptional<z.ZodString>;
+  complianceRegion: z.ZodOptional<z.ZodEnum<{
+    public: "public";
+    "fedramp-high": "fedramp-high";
+  }>>;
+}, z.core.$strict>], "type">>;
+type ParsedConfigExports = z.output<typeof ConfigExportsSchema>;
 declare const ModuleTypeSchema: z.ZodEnum<{
   json: "json";
   text: "text";
@@ -322,8 +487,8 @@ type ModuleType = z.output<typeof ModuleTypeSchema>;
  * base schema.
  */
 declare const OutputWorkerSchema: z.ZodObject<{
+  type: z.ZodLiteral<"worker">;
   name: z.ZodString;
-  accountId: z.ZodOptional<z.ZodString>;
   compatibilityDate: z.ZodString;
   compatibilityFlags: z.ZodOptional<z.ZodArray<z.ZodString>>;
   assets: z.ZodOptional<z.ZodObject<{
@@ -410,10 +575,6 @@ declare const OutputWorkerSchema: z.ZodObject<{
   }, z.core.$strict>>;
   workersDev: z.ZodOptional<z.ZodBoolean>;
   previewUrls: z.ZodOptional<z.ZodBoolean>;
-  complianceRegion: z.ZodOptional<z.ZodEnum<{
-    public: "public";
-    "fedramp-high": "fedramp-high";
-  }>>;
   firstPartyWorker: z.ZodOptional<z.ZodBoolean>;
   unsafe: z.ZodOptional<z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -490,10 +651,18 @@ declare const BUILD_OUTPUT_VERSION = "v0";
  * Project-relative root.
  */
 declare const BUILD_OUTPUT_ROOT = ".cloudflare/output";
+/**
+ * Filename of the top-level (root) config holding shared settings.
+ */
+declare const ROOT_CONFIG_FILENAME = "config.json";
 /**
  * Filename of the per-Worker config.
  */
 declare const WORKER_CONFIG_FILENAME = "worker.config.json";
+/**
+ * Absolute path to the top-level `config.json` for the current project.
+ */
+declare function getRootConfigPath(root: string): string;
 /**
  * Clean the build output directory.
  */
@@ -522,6 +691,11 @@ declare function getWorkerAssetsDir(root: string, workerName: string): string;
  * - Assets-only mode: `manifest` is omitted (no bundle/ directory).
  */
 declare function writeOutputWorkerConfig(root: string, parsedConfig: ParsedInputWorkerConfig, manifest?: ParsedOutputWorkerConfig["manifest"]): Promise<void>;
+/**
+ * Write the top-level `config.json` holding shared settings to the Build
+ * Output API tree.
+ */
+declare function writeRootOutputConfig(root: string, settings: ParsedSettingsConfig): Promise<void>;
 //#endregion
 //#region src/generate.d.ts
 interface GenerateTypesOptions {
@@ -565,10 +739,12 @@ declare function generateTypes({
  * The caller is responsible for unwrapping any function/promise wrapper around
  * the config and validating it against `InputWorkerSchema` before passing it in.
  *
- * @param config The parsed (post-validation) config.
+ * @param workerConfig The parsed (post-validation) Worker config.
+ * @param settingsConfig The optional parsed settings config, whose fields
+ * are merged onto the result.
  * @returns The corresponding Wrangler `RawConfig`.
  */
-declare function convertToWranglerConfig(config: ParsedInputWorkerConfig): RawConfig;
+declare function convertToWranglerConfig(workerConfig: ParsedInputWorkerConfig, settingsConfig?: ParsedSettingsConfig): RawConfig;
 //#endregion
 //#region src/load.d.ts
 /**
@@ -583,18 +759,26 @@ declare function convertToWranglerConfig(config: ParsedInputWorkerConfig): RawCo
 /**
  * Dynamically import a worker config file from disk.
  *
- * Returns the module's default export, plus the set of file paths
- * imported during resolution. Callers are responsible for unwrapping
- * function/promise wrappers around the returned value and validating it
- * against `InputWorkerSchema`.
+ * Returns all of the module's exports (keyed by export name, including
+ * `default`), plus the set of file paths imported during resolution. Callers
+ * are responsible for unwrapping function/promise/definition wrappers around
+ * each export and validating them.
  *
  * @param configPath Filesystem path to the config file. Relative paths are
  *   resolved against `process.cwd()`.
+ * @param options.include When provided, only exports whose names are listed
+ *   survive into the returned `exports` map. Filtering happens before any
+ *   resolution or validation.
  */
-declare function loadConfig(configPath: string): Promise<LoadConfigResult>;
+declare function loadConfig(configPath: string, options?: {
+  include?: string[];
+}): Promise<LoadConfigResult>;
 interface LoadConfigResult {
-  /** The default export of the config module */
-  config: unknown;
+  /**
+   * All exports of the config module, keyed by export name (including
+   * `default`). Filtered by `options.include` when provided.
+   */
+  exports: Record<string, unknown>;
   /**
    * Absolute file paths imported while resolving the config.
    * `cf-worker` entrypoints are NOT included — they are
@@ -623,4 +807,21 @@ interface LoadConfigResult {
  */
 declare function registerConfigHooks(): () => void;
 //#endregion
-export { AgentMemoryBinding, AiBinding, AiSearchBinding, AiSearchNamespaceBinding, AnalyticsEngineDatasetBinding, ArtifactsBinding, AssetsBinding, BUILD_OUTPUT_ROOT, BUILD_OUTPUT_VERSION, Bindings, BrowserBinding, ConfigContext, D1Binding, DispatchNamespaceBinding, DurableObjectBinding, DurableObjectCreatedExport, DurableObjectDeletedExport, DurableObjectExpectingTransferExport, DurableObjectRenamedExport, DurableObjectTransferredExport, EmailTrigger, Exports, FetchTrigger, FlagshipBinding, HyperdriveBinding, ImagesBinding, InferDurableNamespaces, InferEnv, InferMainModule, InputWorkerSchema, JsonBinding, KvBinding, type LoadConfigResult, LogfwdrBinding, MediaBinding, type ModuleType, ModuleTypeSchema, MtlsCertificateBinding, OutputWorkerSchema, type ParsedInputWorkerConfig, type ParsedOutputWorkerConfig, PipelineBinding, QueueBinding, QueueConsumerTrigger, R2Binding, RateLimitBinding, ScheduledTrigger, SecretBinding, SecretsStoreSecretBinding, SendEmailBinding, StreamBinding, TextBinding, Triggers, TypedAiBinding, TypedDurableObjectBinding, TypedKvBinding, TypedPipelineBinding, TypedQueueBinding, TypedWorkerBinding, TypedWorkerDefinition, TypedWorkflowBinding, UnsafeBinding, UnwrapConfig, UserConfig, UserConfigExport, VectorizeBinding, VersionMetadataBinding, VpcNetworkBinding, VpcServiceBinding, WORKER_CONFIG_FILENAME, WebSearchBinding, WorkerBinding, WorkerEntrypointExport, WorkerEntrypointExportOptions, WorkerLoaderBinding, WorkflowBinding, bindings, cleanBuildOutputDir, convertToWranglerConfig, defineWorker, exports, generateTypes, getWorkerAssetsDir, getWorkerBundleDir, getWorkerConfigPath, getWorkersDir, loadConfig, registerConfigHooks, resolveWorkerDefinition, triggers, writeOutputWorkerConfig };
+//#region src/config-loader.d.ts
+interface LoadAndValidateConfigResult {
+  /**
+   * Zod result for the validated exports record, keyed by JS export name.
+   * Consumers format `result.error` themselves.
+   */
+  result: z.ZodSafeParseResult<ParsedConfigExports>;
+  /** Transitive deps imported while resolving the config (node_modules excluded). */
+  dependencies: Set<string>;
+}
+/**
+ * Load a `cloudflare.config.ts`, resolve all exports, and validate against {@link ConfigExportsSchema}.
+ */
+declare function loadAndValidateConfig(configPath: string, ctx: ConfigContext, options?: {
+  include?: string[];
+}): Promise<LoadAndValidateConfigResult>;
+//#endregion
+export { AgentMemoryBinding, AiBinding, AiSearchBinding, AiSearchNamespaceBinding, AnalyticsEngineDatasetBinding, ArtifactsBinding, AssetsBinding, BUILD_OUTPUT_ROOT, BUILD_OUTPUT_VERSION, 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, ROOT_CONFIG_FILENAME, 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, WORKER_CONFIG_FILENAME, WebSearchBinding, WorkerBinding, WorkerConfig, WorkerConfigExport, WorkerConfigInput, WorkerEntrypointExport, WorkerEntrypointExportOptions, WorkerLoaderBinding, WorkflowBinding, bindings, cleanBuildOutputDir, convertToWranglerConfig, defineSettings, defineWorker, exports, generateTypes, getRootConfigPath, getWorkerAssetsDir, getWorkerBundleDir, getWorkerConfigPath, getWorkersDir, loadAndValidateConfig, loadConfig, registerConfigHooks, resolveExportDefinition, triggers, writeOutputWorkerConfig, writeRootOutputConfig };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as bindings, i as triggers, n as resolveWorkerDefinition, r as exports$1, t as defineWorker } from "./public-mmLmXmLK.mjs";
+import { a as triggers, i as exports$1, n as defineWorker, o as bindings, r as resolveExportDefinition, t as defineSettings } from "./public-D2QZv1n6.mjs";
 import * as nodeModule from "node:module";
 import * as fsp from "node:fs/promises";
 import * as path from "node:path";
@@ -2519,6 +2519,10 @@ const BUILD_OUTPUT_VERSION = "v0";
 */
 const BUILD_OUTPUT_ROOT = ".cloudflare/output";
 /**
+* Filename of the top-level (root) config holding shared settings.
+*/
+const ROOT_CONFIG_FILENAME = "config.json";
+/**
 * Filename of the per-Worker config.
 */
 const WORKER_CONFIG_FILENAME = "worker.config.json";
@@ -2529,6 +2533,12 @@ function getBuildOutputDir(root) {
 	return path.resolve(root, BUILD_OUTPUT_ROOT);
 }
 /**
+* Absolute path to the top-level `config.json` for the current project.
+*/
+function getRootConfigPath(root) {
+	return path.join(getBuildOutputDir(root), BUILD_OUTPUT_VERSION, ROOT_CONFIG_FILENAME);
+}
+/**
 * Clean the build output directory.
 */
 async function cleanBuildOutputDir(root) {
@@ -2576,6 +2586,15 @@ async function writeOutputWorkerConfig(root, parsedConfig, manifest) {
 	const configPath = getWorkerConfigPath(root, outputConfig.name);
 	await fsp.writeFile(configPath, JSON.stringify(outputConfig));
 }
+/**
+* Write the top-level `config.json` holding shared settings to the Build
+* Output API tree.
+*/
+async function writeRootOutputConfig(root, settings) {
+	const configPath = getRootConfigPath(root);
+	await fsp.mkdir(path.dirname(configPath), { recursive: true });
+	await fsp.writeFile(configPath, JSON.stringify(settings));
+}
 
 //#endregion
 //#region src/schema.ts
@@ -2635,7 +2654,7 @@ const KnownBindingSchema = z.discriminatedUnion("type", [
 	}),
 	z.strictObject({
 		type: z.literal("dispatch-namespace"),
-		namespace: z.string(),
+		namespace: z.string().optional(),
 		outbound: z.strictObject({
 			workerName: z.string(),
 			parameters: z.array(z.string()).optional()
@@ -2649,7 +2668,7 @@ const KnownBindingSchema = z.discriminatedUnion("type", [
 	}),
 	z.strictObject({
 		type: z.literal("flagship"),
-		id: z.string(),
+		id: z.string().optional(),
 		remote: z.boolean().optional()
 	}),
 	z.strictObject({
@@ -2690,7 +2709,7 @@ const KnownBindingSchema = z.discriminatedUnion("type", [
 	}),
 	z.strictObject({
 		type: z.literal("queue"),
-		name: z.string(),
+		name: z.string().optional(),
 		deliveryDelay: z.number().optional(),
 		remote: z.boolean().optional()
 	}),
@@ -2936,8 +2955,8 @@ const UnsafeSchema = z.strictObject({
 * (user-authored) and output (on-disk) Worker configs.
 */
 const BaseWorkerSchema = z.strictObject({
+	type: z.literal("worker"),
 	name: z.string(),
-	accountId: z.string().optional(),
 	compatibilityDate: z.string(),
 	compatibilityFlags: z.array(z.string()).optional(),
 	assets: AssetsSchema.optional(),
@@ -2951,7 +2970,6 @@ const BaseWorkerSchema = z.strictObject({
 	observability: ObservabilitySchema.optional(),
 	workersDev: z.boolean().optional(),
 	previewUrls: z.boolean().optional(),
-	complianceRegion: z.enum(["public", "fedramp-high"]).optional(),
 	firstPartyWorker: z.boolean().optional(),
 	unsafe: UnsafeSchema.optional(),
 	env: EnvSchema,
@@ -2963,6 +2981,45 @@ const BaseWorkerSchema = z.strictObject({
 * base schema.
 */
 const InputWorkerSchema = BaseWorkerSchema.extend({ entrypoint: z.union([z.string(), z.strictObject({ default: z.string() })]).transform((value) => typeof value === "string" ? value : value.default).optional() });
+/**
+* Settings schema — validates the named `settings` export of a
+* `cloudflare.config.ts`. Holds account/deployment settings shared by the other exports.
+*/
+const SettingsSchema = z.strictObject({
+	type: z.literal("settings"),
+	accountId: z.string().optional(),
+	complianceRegion: z.enum(["public", "fedramp-high"]).optional()
+});
+/**
+* Discriminated union of the config kinds a single export may resolve to.
+*/
+const ConfigExportSchema = z.discriminatedUnion("type", [InputWorkerSchema, SettingsSchema]);
+const SETTINGS_EXPORT_NAME = "settings";
+/**
+* Schema for the resolved config exports, keyed by export
+* name. Each value is discriminated on its `type` field. Reserves the
+* `settings` export name exclusively for settings configs: a `settings`
+* config must live on the `settings` export, and the `settings` export
+* may only hold a `settings` config.
+*/
+const ConfigExportsSchema = z.record(z.string(), ConfigExportSchema).check((ctx) => {
+	for (const [key, value] of Object.entries(ctx.value)) {
+		const isSettingsName = key === SETTINGS_EXPORT_NAME;
+		const isSettingsType = value.type === "settings";
+		if (isSettingsType && !isSettingsName) ctx.issues.push({
+			code: "custom",
+			input: value,
+			path: [key],
+			message: `A \`settings\` config is only allowed on the \`${SETTINGS_EXPORT_NAME}\` export; found one on the \`${key}\` export.`
+		});
+		else if (isSettingsName && !isSettingsType) ctx.issues.push({
+			code: "custom",
+			input: value,
+			path: [key],
+			message: `The \`${SETTINGS_EXPORT_NAME}\` export is reserved for a \`settings\` config; found a \`${value.type}\` config.`
+		});
+	}
+});
 const ModuleTypeSchema = z.enum([
 	"esm",
 	"cjs",
@@ -3070,29 +3127,38 @@ function generateTypes({ configPath, packageName = "@cloudflare/config" }) {
 * The caller is responsible for unwrapping any function/promise wrapper around
 * the config and validating it against `InputWorkerSchema` before passing it in.
 *
-* @param config The parsed (post-validation) config.
+* @param workerConfig The parsed (post-validation) Worker config.
+* @param settingsConfig The optional parsed settings config, whose fields
+* are merged onto the result.
 * @returns The corresponding Wrangler `RawConfig`.
 */
-function convertToWranglerConfig(config) {
+function convertToWranglerConfig(workerConfig, settingsConfig) {
 	const result = {};
-	convertTopLevel(config, result);
-	convertBindingsAndAssets(config, result);
-	convertExports(config, result);
-	convertDomains(config, result);
-	convertTriggers(config, result);
-	convertTailConsumers(config, result);
+	convertTopLevel(workerConfig, result);
+	convertBindingsAndAssets(workerConfig, result);
+	convertExports(workerConfig, result);
+	convertDomains(workerConfig, result);
+	convertTriggers(workerConfig, result);
+	convertTailConsumers(workerConfig, result);
+	if (settingsConfig !== void 0) convertSettings(settingsConfig, result);
 	return result;
 }
+/**
+* Merge a parsed settings config's fields (`account_id`, `compliance_region`)
+* onto an existing Wrangler `RawConfig`.
+*/
+function convertSettings(settings, result) {
+	if (settings.accountId !== void 0) result.account_id = settings.accountId;
+	if (settings.complianceRegion !== void 0) result.compliance_region = settings.complianceRegion === "fedramp-high" ? "fedramp_high" : "public";
+}
 function convertTopLevel(config, result) {
 	if (config.name !== void 0) result.name = config.name;
 	if (typeof config.entrypoint === "string") result.main = config.entrypoint;
-	if (config.accountId !== void 0) result.account_id = config.accountId;
 	if (config.compatibilityDate !== void 0) result.compatibility_date = config.compatibilityDate;
 	if (config.compatibilityFlags !== void 0) result.compatibility_flags = config.compatibilityFlags;
 	if (config.workersDev !== void 0) result.workers_dev = config.workersDev;
 	if (config.previewUrls !== void 0) result.preview_urls = config.previewUrls;
 	if (config.logpush !== void 0) result.logpush = config.logpush;
-	if (config.complianceRegion !== void 0) result.compliance_region = config.complianceRegion === "fedramp-high" ? "fedramp_high" : "public";
 	if (config.firstPartyWorker !== void 0) result.first_party_worker = config.firstPartyWorker;
 	if (config.placement !== void 0) result.placement = config.placement;
 	if (config.limits !== void 0) {
@@ -3524,9 +3590,10 @@ function convertTriggers(config, result) {
 	const crons = [];
 	const routes = result.routes ? [...result.routes] : [];
 	const queueConsumers = result.queues?.consumers ? [...result.queues.consumers] : [];
-	const addresses = result.addresses ? [...result.addresses] : [];
+	let addresses;
 	for (const trigger of triggers$1) switch (trigger.type) {
 		case "email":
+			addresses ??= [];
 			addresses.push(...trigger.addresses);
 			break;
 		case "scheduled":
@@ -3562,7 +3629,7 @@ function convertTriggers(config, result) {
 		...result.queues ?? {},
 		consumers: queueConsumers
 	};
-	if (addresses.length) result.addresses = addresses;
+	if (addresses !== void 0) result.addresses = addresses;
 }
 function convertDomains(config, result) {
 	if (!config.domains || config.domains.length === 0) return;
@@ -3614,20 +3681,29 @@ const depsStore = new AsyncLocalStorage();
 /**
 * Dynamically import a worker config file from disk.
 *
-* Returns the module's default export, plus the set of file paths
-* imported during resolution. Callers are responsible for unwrapping
-* function/promise wrappers around the returned value and validating it
-* against `InputWorkerSchema`.
+* Returns all of the module's exports (keyed by export name, including
+* `default`), plus the set of file paths imported during resolution. Callers
+* are responsible for unwrapping function/promise/definition wrappers around
+* each export and validating them.
 *
 * @param configPath Filesystem path to the config file. Relative paths are
 *   resolved against `process.cwd()`.
+* @param options.include When provided, only exports whose names are listed
+*   survive into the returned `exports` map. Filtering happens before any
+*   resolution or validation.
 */
-async function loadConfig(configPath) {
+async function loadConfig(configPath, options) {
 	registerConfigHooks();
 	const url = pathToFileURL(configPath).href;
 	const dependencies = /* @__PURE__ */ new Set();
+	const mod = await depsStore.run(dependencies, () => import(url, { with: { [CF_ATTR]: CF_NO_CACHE_VALUE } }));
+	const exports$2 = {};
+	for (const [name, value] of Object.entries(mod)) {
+		if (options?.include && !options.include.includes(name)) continue;
+		exports$2[name] = value;
+	}
 	return {
-		config: (await depsStore.run(dependencies, () => import(url, { with: { [CF_ATTR]: CF_NO_CACHE_VALUE } }))).default,
+		exports: exports$2,
 		dependencies
 	};
 }
@@ -3713,4 +3789,19 @@ function cleanupImportAttributes(context) {
 }
 
 //#endregion
-export { BUILD_OUTPUT_ROOT, BUILD_OUTPUT_VERSION, InputWorkerSchema, ModuleTypeSchema, OutputWorkerSchema, WORKER_CONFIG_FILENAME, bindings, cleanBuildOutputDir, convertToWranglerConfig, defineWorker, exports$1 as exports, generateTypes, getWorkerAssetsDir, getWorkerBundleDir, getWorkerConfigPath, getWorkersDir, loadConfig, registerConfigHooks, resolveWorkerDefinition, triggers, writeOutputWorkerConfig };
+//#region src/config-loader.ts
+/**
+* Load a `cloudflare.config.ts`, resolve all exports, and validate against {@link ConfigExportsSchema}.
+*/
+async function loadAndValidateConfig(configPath, ctx, options) {
+	const { exports: exports$2, dependencies } = await loadConfig(configPath, options);
+	const resolved = {};
+	for (const [name, value] of Object.entries(exports$2)) resolved[name] = await resolveExportDefinition(value, ctx);
+	return {
+		result: ConfigExportsSchema.safeParse(resolved),
+		dependencies
+	};
+}
+
+//#endregion
+export { BUILD_OUTPUT_ROOT, BUILD_OUTPUT_VERSION, ConfigExportsSchema, InputWorkerSchema, ModuleTypeSchema, OutputWorkerSchema, ROOT_CONFIG_FILENAME, SettingsSchema, WORKER_CONFIG_FILENAME, bindings, cleanBuildOutputDir, convertToWranglerConfig, defineSettings, defineWorker, exports$1 as exports, generateTypes, getRootConfigPath, getWorkerAssetsDir, getWorkerBundleDir, getWorkerConfigPath, getWorkersDir, loadAndValidateConfig, loadConfig, registerConfigHooks, resolveExportDefinition, triggers, writeOutputWorkerConfig, writeRootOutputConfig };

package/dist/{public-mmLmXmLK.mjs → public-D2QZv1n6.mjs}

@@ -206,12 +206,43 @@ const exports = {
 	worker
 };
 
+//#endregion
+//#region src/definition.ts
+const DEFINITION = Symbol.for("@cloudflare/config:definition");
+/**
+* Unwrap an authored config from its value / promise / function shape, awaiting
+* the result. A function config is invoked with {@link ConfigContext}.
+*/
+async function unwrap(config, ctx) {
+	return typeof config === "function" ? await config(ctx) : await config;
+}
+/**
+* Resolve any `cloudflare.config.ts` export to its plain config value.
+*
+* A `define*` helper stores its authored config plus `type` under the
+* {@link DEFINITION} symbol; here we unwrap the config and stamp `type` back on.
+* Every other export — a raw object/promise/function — is unwrapped as-is and
+* already carries its own `type`. Discrimination happens afterwards via `type`.
+*/
+async function resolveExportDefinition(def, ctx) {
+	if (typeof def === "object" && def !== null && DEFINITION in def) {
+		const { config, type } = def[DEFINITION];
+		return {
+			...await unwrap(config, ctx),
+			type
+		};
+	}
+	return await unwrap(def, ctx);
+}
+
 //#endregion
 //#region src/worker-definition.ts
-const CONFIG = Symbol.for("@cloudflare/config:worker-config");
 function defineWorker(config) {
 	return {
-		[CONFIG]: config,
+		[DEFINITION]: {
+			config,
+			type: "worker"
+		},
 		durableObject(options) {
 			return {
 				type: "durable-object",
@@ -226,10 +257,19 @@ function defineWorker(config) {
 		}
 	};
 }
-async function resolveWorkerDefinition(def, ctx) {
-	const raw = typeof def === "object" && def !== null && CONFIG in def ? def[CONFIG] : def;
-	return await (typeof raw === "function" ? raw(ctx) : raw);
+
+//#endregion
+//#region src/settings-definition.ts
+/**
+* Declare shared settings.
+* Authored as a named `settings` export.
+*/
+function defineSettings(config) {
+	return { [DEFINITION]: {
+		config,
+		type: "settings"
+	} };
 }
 
 //#endregion
-export { bindings as a, triggers as i, resolveWorkerDefinition as n, exports as r, defineWorker as t };
+export { triggers as a, exports as i, defineWorker as n, bindings as o, resolveExportDefinition as r, defineSettings as t };

package/dist/{public-m7PNfSwY.d.mts → public-myuV_kLK.d.mts}

@@ -132,7 +132,7 @@ interface D1Binding extends D1BindingOptions {
 }
 interface DispatchNamespaceBindingOptions {
   /** The namespace to bind to. */
-  namespace: string;
+  namespace?: string;
   /** Details about the outbound Worker which will handle outbound requests from your namespace. */
   outbound?: {
     /** Name of the Worker handling the outbound requests. */
@@ -180,7 +180,7 @@ interface TypedDurableObjectBinding<TConfig$1, TExportName$1 extends string> ext
 }
 interface FlagshipBindingOptions {
   /** The Flagship app ID to bind to. */
-  id: string;
+  id?: string;
   /** Set to `true` to suppress the remote binding warning in local dev. Flagship bindings are always remote. */
   remote?: boolean;
 }
@@ -293,7 +293,7 @@ interface TypedPipelineBinding<TRecord extends PipelineRecord = PipelineRecord>
 }
 interface QueueBindingOptions {
   /** The name of this Queue. */
-  name: string;
+  name?: string;
   /** The number of seconds to wait before delivering a message. */
   deliveryDelay?: number;
   /** Whether the Queue producer should be remote or not in local development. */
@@ -600,7 +600,7 @@ interface Bindings {
    *
    * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#dispatch-namespace-bindings-workers-for-platforms
    */
-  dispatchNamespace(options: DispatchNamespaceBindingOptions): DispatchNamespaceBinding;
+  dispatchNamespace(options?: DispatchNamespaceBindingOptions): DispatchNamespaceBinding;
   /**
    * Binding to a Durable Object class. `workerName` is the name of the Worker
    * that defines the class; `exportName` is the exported class name.
@@ -609,7 +609,7 @@ interface Bindings {
    */
   durableObject(options: DurableObjectBindingOptions): DurableObjectBinding;
   /** Binding to a Flagship feature-flag service. */
-  flagship(options: FlagshipBindingOptions): FlagshipBinding;
+  flagship(options?: FlagshipBindingOptions): FlagshipBinding;
   /**
    * Binding to a Hyperdrive configuration.
    *
@@ -650,7 +650,7 @@ interface Bindings {
    *
    * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#queues
    */
-  queue<TBody = unknown>(options: QueueBindingOptions): TypedQueueBinding<TBody>;
+  queue<TBody = unknown>(options?: QueueBindingOptions): TypedQueueBinding<TBody>;
   /**
    * Binding to an R2 bucket.
    *
@@ -1006,6 +1006,32 @@ interface Exports {
  */
 declare const exports: Exports;
 //#endregion
+//#region src/definition.d.ts
+interface ConfigContext {
+  /**
+   * The mode the config is being evaluated in.
+   * Set via the `--mode` CLI flag.
+   * In Vite the mode defaults to `development` in `vite dev` and `production` in `vite build` ([more info](https://vite.dev/guide/env-and-mode.html#modes)).
+   * In Wrangler the mode defaults to `undefined`.
+   */
+  mode: string | undefined;
+}
+declare const DEFINITION: unique symbol;
+/**
+ * The authored config in any of its supported shapes: a plain value, a promise,
+ * or a function of {@link ConfigContext}.
+ */
+type ConfigInput<T$1> = T$1 | Promise<T$1> | ((ctx: ConfigContext) => T$1 | Promise<T$1>);
+/**
+ * Resolve any `cloudflare.config.ts` export to its plain config value.
+ *
+ * A `define*` helper stores its authored config plus `type` under the
+ * {@link DEFINITION} symbol; here we unwrap the config and stamp `type` back on.
+ * Every other export — a raw object/promise/function — is unwrapped as-is and
+ * already carries its own `type`. Discrimination happens afterwards via `type`.
+ */
+declare function resolveExportDefinition(def: unknown, ctx: ConfigContext): Promise<unknown>;
+//#endregion
 //#region src/types.d.ts
 /**
  * Union of all binding definitions accepted in `env`.
@@ -1028,19 +1054,18 @@ type Export = DurableObjectCreatedExport | DurableObjectDeletedExport | DurableO
  * Fields are validated at runtime by `InputWorkerSchema` and normalised before
  * being passed to downstream tooling.
  */
-interface UserConfig {
+interface WorkerConfig {
   /**
-   * The name of your Worker.
+   * Discriminates this config as a Worker config.
+   *
+   * Injected automatically by `defineWorker`; only needs to be written by
+   * hand when authoring a raw config object without the helper.
    */
-  name: string;
+  type: "worker";
   /**
-   * This is the ID of the account associated with your zone.
-   * You might have more than one account, so make sure to use
-   * the ID of the account associated with the zone/route you
-   * provide, if you provide one. It can also be specified through
-   * the CLOUDFLARE_ACCOUNT_ID environment variable.
+   * The name of your Worker.
    */
-  accountId?: string;
+  name: string;
   /**
    * A date in the form yyyy-mm-dd, which will be used to determine
    * which version of the Workers runtime is used.
@@ -1229,13 +1254,6 @@ interface UserConfig {
    * @default false
    */
   previewUrls?: boolean;
-  /**
-   * Specify the compliance region mode of the Worker.
-   *
-   * Although if the user does not specify a compliance region, the default is `public`,
-   * it can be set to `undefined` in configuration to delegate to the CLOUDFLARE_COMPLIANCE_REGION environment variable.
-   */
-  complianceRegion?: "public" | "fedramp-high";
   /**
    * Designates this Worker as an internal-only "first-party" Worker.
    *
@@ -1287,29 +1305,51 @@ interface UserConfig {
    */
   exports?: Record<string, Export>;
 }
-//#endregion
-//#region src/worker-definition.d.ts
-interface ConfigContext {
+/**
+ * Settings shared by the other exports.
+ * Authored as a named `settings` export via
+ * `defineSettings`.
+ */
+interface SettingsConfig {
   /**
-   * The mode the config is being evaluated in.
-   * Set via the `--mode` CLI flag.
-   * In Vite the mode defaults to `development` in `vite dev` and `production` in `vite build` ([more info](https://vite.dev/guide/env-and-mode.html#modes)).
-   * In Wrangler the mode defaults to `undefined`.
+   * Discriminates this config as a settings config.
+   *
+   * Injected automatically by `defineSettings`; only needs to be written by
+   * hand when authoring a raw config object without the helper.
    */
-  mode: string | undefined;
+  type: "settings";
+  /**
+   * This is the ID of the account associated with your zone.
+   * You might have more than one account, so make sure to use
+   * the ID of the account associated with the zone/route you
+   * provide, if you provide one. It can also be specified through
+   * the CLOUDFLARE_ACCOUNT_ID environment variable.
+   */
+  accountId?: string;
+  /**
+   * Specify the compliance region mode of the Worker.
+   *
+   * Although if the user does not specify a compliance region, the default is `public`,
+   * it can be set to `undefined` in configuration to delegate to the CLOUDFLARE_COMPLIANCE_REGION environment variable.
+   */
+  complianceRegion?: "public" | "fedramp-high";
 }
-declare const CONFIG: unique symbol;
+//#endregion
+//#region src/worker-definition.d.ts
 /**
- * Base shape of a Worker definition. Carries the resolved config and the
- * untyped cross-worker binding helpers.
+ * Base shape of a Worker definition. Carries the authored config (under
+ * {@link DEFINITION}) and the untyped cross-worker binding helpers.
  */
-interface WorkerDefinition<TConfig$1 extends UserConfig = UserConfig> extends Pick<Bindings, "durableObject" | "worker"> {
-  [CONFIG]: TConfig$1 | Promise<TConfig$1> | ((ctx: ConfigContext) => TConfig$1 | Promise<TConfig$1>);
+interface WorkerDefinition<TConfig$1 extends WorkerConfig = WorkerConfig> extends Pick<Bindings, "durableObject" | "worker"> {
+  [DEFINITION]: {
+    config: ConfigInput<Omit<TConfig$1, "type">>;
+    type: "worker";
+  };
 }
 /**
  * Worker definition with typed cross-worker binding helpers.
  */
-interface TypedWorkerDefinition<TConfig$1 extends UserConfig, TWorkerName extends string = InferWorkerName<TConfig$1>> extends WorkerDefinition<TConfig$1> {
+interface TypedWorkerDefinition<TConfig$1 extends WorkerConfig, TWorkerName extends string = InferWorkerName<TConfig$1>> extends WorkerDefinition<TConfig$1> {
   /**
    * Binding to a Durable Object class. `workerName` is the name of the Worker
    * that defines the class; `exportName` is the exported class name.
@@ -1334,10 +1374,18 @@ interface TypedWorkerDefinition<TConfig$1 extends UserConfig, TWorkerName extend
     remote?: boolean;
   }): TypedWorkerBinding<TConfig$1, TExportName$1 extends string ? TExportName$1 : "default">;
 }
-type UserConfigExport<T$1 extends UserConfig = UserConfig> = T$1 | Promise<T$1> | ((ctx: ConfigContext) => T$1 | Promise<T$1>);
-declare function defineWorker<const T$1 extends UserConfig>(config: (ctx: ConfigContext) => (UserConfig & T$1) | Promise<UserConfig & T$1>): TypedWorkerDefinition<T$1>;
-declare function defineWorker<const T$1 extends UserConfig>(config: (UserConfig & T$1) | Promise<UserConfig & T$1>): TypedWorkerDefinition<T$1>;
-declare function resolveWorkerDefinition(def: unknown, ctx: ConfigContext): Promise<unknown>;
+type WorkerConfigExport<T$1 extends WorkerConfig = WorkerConfig> = ConfigInput<T$1>;
+/**
+ * Authored Worker config shape — {@link WorkerConfig} without the `type`
+ * discriminant, which `defineWorker` injects.
+ */
+type WorkerConfigInput = Omit<WorkerConfig, "type">;
+declare function defineWorker<const T$1 extends WorkerConfigInput>(config: (ctx: ConfigContext) => (WorkerConfigInput & T$1) | Promise<WorkerConfigInput & T$1>): TypedWorkerDefinition<T$1 & {
+  type: "worker";
+}>;
+declare function defineWorker<const T$1 extends WorkerConfigInput>(config: (WorkerConfigInput & T$1) | Promise<WorkerConfigInput & T$1>): TypedWorkerDefinition<T$1 & {
+  type: "worker";
+}>;
 //#endregion
 //#region src/inference.d.ts
 /**
@@ -1475,7 +1523,7 @@ type InferWorkerEntrypointExports<TUnwrappedConfig$1> = Exclude<keyof InferMainM
  * Unwrap function and promise types to get the underlying config.
  * Use this to normalize a config before passing it to other inference utilities.
  */
-type UnwrapConfig<TConfig$1> = TConfig$1 extends WorkerDefinition<infer TUnwrappedConfig> ? TUnwrappedConfig : TConfig$1 extends UserConfigExport<infer TUnwrappedConfig> ? TUnwrappedConfig : never;
+type UnwrapConfig<TConfig$1> = TConfig$1 extends WorkerDefinition<infer TUnwrappedConfig> ? TUnwrappedConfig : TConfig$1 extends WorkerConfigExport<infer TUnwrappedConfig> ? TUnwrappedConfig : never;
 /**
  * Infer the `Env` interface type from a Worker config.
  *
@@ -1545,4 +1593,21 @@ type InferMainModule<TUnwrappedConfig$1> = TUnwrappedConfig$1 extends {
   entrypoint: infer TModule extends WorkerModule;
 } ? TModule : DefaultModule;
 //#endregion
-export { StreamBinding$1 as $, AnalyticsEngineDatasetBinding as A, ImagesBinding$1 as B, ScheduledTrigger as C, AiBinding as D, AgentMemoryBinding as E, D1Binding as F, MtlsCertificateBinding as G, KvBinding as H, DispatchNamespaceBinding as I, R2Binding as J, PipelineBinding as K, DurableObjectBinding as L, AssetsBinding as M, Bindings as N, AiSearchBinding as O, BrowserBinding as P, SendEmailBinding as Q, FlagshipBinding as R, QueueConsumerTrigger as S, triggers as T, LogfwdrBinding as U, JsonBinding as V, MediaBinding$1 as W, SecretBinding as X, RateLimitBinding as Y, SecretsStoreSecretBinding as Z, WorkerEntrypointExport as _, bindings as _t, ConfigContext as a, TypedQueueBinding as at, EmailTrigger as b, defineWorker as c, UnsafeBinding as ct, DurableObjectCreatedExport as d, VpcNetworkBinding as dt, TextBinding as et, DurableObjectDeletedExport as f, VpcServiceBinding as ft, Exports as g, WorkflowBinding as gt, DurableObjectTransferredExport as h, WorkerLoaderBinding as ht, UnwrapConfig as i, TypedPipelineBinding as it, ArtifactsBinding as j, AiSearchNamespaceBinding as k, resolveWorkerDefinition as l, VectorizeBinding as lt, DurableObjectRenamedExport as m, WorkerBinding as mt, InferEnv as n, TypedDurableObjectBinding as nt, TypedWorkerDefinition as o, TypedWorkerBinding as ot, DurableObjectExpectingTransferExport as p, WebSearchBinding as pt, QueueBinding as q, InferMainModule as r, TypedKvBinding as rt, UserConfigExport as s, TypedWorkflowBinding as st, InferDurableNamespaces as t, TypedAiBinding as tt, UserConfig as u, VersionMetadataBinding as ut, WorkerEntrypointExportOptions as v, Triggers as w, FetchTrigger as x, exports as y, HyperdriveBinding as z };
+//#region src/settings-definition.d.ts
+/**
+ * Authored settings config shape — {@link SettingsConfig} without the `type`
+ * discriminant, which `defineSettings` injects.
+ */
+type SettingsConfigInput = Omit<SettingsConfig, "type">;
+/**
+ * Declare shared settings.
+ * Authored as a named `settings` export.
+ */
+declare function defineSettings(config: ConfigInput<SettingsConfigInput>): {
+  [DEFINITION]: {
+    config: ConfigInput<SettingsConfigInput>;
+    type: string;
+  };
+};
+//#endregion
+export { RateLimitBinding as $, AgentMemoryBinding as A, DispatchNamespaceBinding as B, exports as C, ScheduledTrigger as D, QueueConsumerTrigger as E, ArtifactsBinding as F, JsonBinding as G, FlagshipBinding as H, AssetsBinding as I, MediaBinding$1 as J, KvBinding as K, Bindings as L, AiSearchBinding as M, AiSearchNamespaceBinding as N, Triggers as O, AnalyticsEngineDatasetBinding as P, R2Binding as Q, BrowserBinding as R, WorkerEntrypointExportOptions as S, FetchTrigger as T, HyperdriveBinding as U, DurableObjectBinding as V, ImagesBinding$1 as W, PipelineBinding as X, MtlsCertificateBinding as Y, QueueBinding as Z, DurableObjectExpectingTransferExport as _, WebSearchBinding as _t, InferMainModule as a, TypedAiBinding as at, Exports as b, WorkflowBinding as bt, WorkerConfigExport as c, TypedPipelineBinding as ct, SettingsConfig as d, TypedWorkflowBinding as dt, SecretBinding as et, WorkerConfig as f, UnsafeBinding as ft, DurableObjectDeletedExport as g, VpcServiceBinding as gt, DurableObjectCreatedExport as h, VpcNetworkBinding as ht, InferEnv as i, TextBinding as it, AiBinding as j, triggers as k, WorkerConfigInput as l, TypedQueueBinding as lt, resolveExportDefinition as m, VersionMetadataBinding as mt, defineSettings as n, SendEmailBinding as nt, UnwrapConfig as o, TypedDurableObjectBinding as ot, ConfigContext as p, VectorizeBinding as pt, LogfwdrBinding as q, InferDurableNamespaces as r, StreamBinding$1 as rt, TypedWorkerDefinition as s, TypedKvBinding as st, SettingsConfigInput as t, SecretsStoreSecretBinding as tt, defineWorker as u, TypedWorkerBinding as ut, DurableObjectRenamedExport as v, WorkerBinding as vt, EmailTrigger as w, WorkerEntrypointExport as x, bindings as xt, DurableObjectTransferredExport as y, WorkerLoaderBinding as yt, D1Binding as z };

package/dist/public.d.mts

@@ -1,2 +1,2 @@
-import { $ as StreamBinding, A as AnalyticsEngineDatasetBinding, B as ImagesBinding, C as ScheduledTrigger, D as AiBinding, E as AgentMemoryBinding, F as D1Binding, G as MtlsCertificateBinding, H as KvBinding, I as DispatchNamespaceBinding, J as R2Binding, K as PipelineBinding, L as DurableObjectBinding, M as AssetsBinding, N as Bindings, O as AiSearchBinding, P as BrowserBinding, Q as SendEmailBinding, R as FlagshipBinding, S as QueueConsumerTrigger, T as triggers, U as LogfwdrBinding, V as JsonBinding, W as MediaBinding, X as SecretBinding, Y as RateLimitBinding, Z as SecretsStoreSecretBinding, _ as WorkerEntrypointExport, _t as bindings, a as ConfigContext, at as TypedQueueBinding, b as EmailTrigger, c as defineWorker, ct as UnsafeBinding, d as DurableObjectCreatedExport, dt as VpcNetworkBinding, et as TextBinding, f as DurableObjectDeletedExport, ft as VpcServiceBinding, g as Exports, gt as WorkflowBinding, h as DurableObjectTransferredExport, ht as WorkerLoaderBinding, i as UnwrapConfig, it as TypedPipelineBinding, j as ArtifactsBinding, k as AiSearchNamespaceBinding, lt as VectorizeBinding, m as DurableObjectRenamedExport, mt as WorkerBinding, n as InferEnv, nt as TypedDurableObjectBinding, o as TypedWorkerDefinition, ot as TypedWorkerBinding, p as DurableObjectExpectingTransferExport, pt as WebSearchBinding, q as QueueBinding, r as InferMainModule, rt as TypedKvBinding, s as UserConfigExport, st as TypedWorkflowBinding, t as InferDurableNamespaces, tt as TypedAiBinding, u as UserConfig, ut as VersionMetadataBinding, v as WorkerEntrypointExportOptions, w as Triggers, x as FetchTrigger, y as exports, z as HyperdriveBinding } from "./public-m7PNfSwY.mjs";
-export { AgentMemoryBinding, AiBinding, AiSearchBinding, AiSearchNamespaceBinding, AnalyticsEngineDatasetBinding, ArtifactsBinding, AssetsBinding, Bindings, BrowserBinding, ConfigContext, D1Binding, DispatchNamespaceBinding, DurableObjectBinding, DurableObjectCreatedExport, DurableObjectDeletedExport, DurableObjectExpectingTransferExport, DurableObjectRenamedExport, DurableObjectTransferredExport, EmailTrigger, Exports, FetchTrigger, FlagshipBinding, HyperdriveBinding, ImagesBinding, InferDurableNamespaces, InferEnv, InferMainModule, JsonBinding, KvBinding, LogfwdrBinding, MediaBinding, MtlsCertificateBinding, PipelineBinding, QueueBinding, QueueConsumerTrigger, R2Binding, RateLimitBinding, ScheduledTrigger, SecretBinding, SecretsStoreSecretBinding, SendEmailBinding, StreamBinding, TextBinding, Triggers, TypedAiBinding, TypedDurableObjectBinding, TypedKvBinding, TypedPipelineBinding, TypedQueueBinding, TypedWorkerBinding, TypedWorkerDefinition, TypedWorkflowBinding, UnsafeBinding, UnwrapConfig, UserConfig, UserConfigExport, VectorizeBinding, VersionMetadataBinding, VpcNetworkBinding, VpcServiceBinding, WebSearchBinding, WorkerBinding, WorkerEntrypointExport, WorkerEntrypointExportOptions, WorkerLoaderBinding, WorkflowBinding, bindings, defineWorker, exports, triggers };
+import { $ as RateLimitBinding, A as AgentMemoryBinding, B as DispatchNamespaceBinding, C as exports, D as ScheduledTrigger, E as QueueConsumerTrigger, F as ArtifactsBinding, G as JsonBinding, H as FlagshipBinding, I as AssetsBinding, J as MediaBinding, K as KvBinding, L as Bindings, M as AiSearchBinding, N as AiSearchNamespaceBinding, O as Triggers, P as AnalyticsEngineDatasetBinding, Q as R2Binding, R as BrowserBinding, S as WorkerEntrypointExportOptions, T as FetchTrigger, U as HyperdriveBinding, V as DurableObjectBinding, W as ImagesBinding, X as PipelineBinding, Y as MtlsCertificateBinding, Z as QueueBinding, _ as DurableObjectExpectingTransferExport, _t as WebSearchBinding, a as InferMainModule, at as TypedAiBinding, b as Exports, bt as WorkflowBinding, c as WorkerConfigExport, ct as TypedPipelineBinding, d as SettingsConfig, dt as TypedWorkflowBinding, et as SecretBinding, f as WorkerConfig, ft as UnsafeBinding, g as DurableObjectDeletedExport, gt as VpcServiceBinding, h as DurableObjectCreatedExport, ht as VpcNetworkBinding, i as InferEnv, it as TextBinding, j as AiBinding, k as triggers, l as WorkerConfigInput, lt as TypedQueueBinding, mt as VersionMetadataBinding, n as defineSettings, nt as SendEmailBinding, o as UnwrapConfig, ot as TypedDurableObjectBinding, p as ConfigContext, pt as VectorizeBinding, q as LogfwdrBinding, r as InferDurableNamespaces, rt as StreamBinding, s as TypedWorkerDefinition, st as TypedKvBinding, t as SettingsConfigInput, tt as SecretsStoreSecretBinding, u as defineWorker, ut as TypedWorkerBinding, v as DurableObjectRenamedExport, vt as WorkerBinding, w as EmailTrigger, x as WorkerEntrypointExport, xt as bindings, y as DurableObjectTransferredExport, yt as WorkerLoaderBinding, z as D1Binding } from "./public-myuV_kLK.mjs";
+export { AgentMemoryBinding, AiBinding, AiSearchBinding, AiSearchNamespaceBinding, AnalyticsEngineDatasetBinding, ArtifactsBinding, AssetsBinding, Bindings, BrowserBinding, ConfigContext, D1Binding, DispatchNamespaceBinding, DurableObjectBinding, DurableObjectCreatedExport, DurableObjectDeletedExport, DurableObjectExpectingTransferExport, DurableObjectRenamedExport, DurableObjectTransferredExport, EmailTrigger, Exports, FetchTrigger, FlagshipBinding, HyperdriveBinding, ImagesBinding, InferDurableNamespaces, InferEnv, InferMainModule, JsonBinding, KvBinding, LogfwdrBinding, MediaBinding, MtlsCertificateBinding, PipelineBinding, QueueBinding, QueueConsumerTrigger, R2Binding, RateLimitBinding, ScheduledTrigger, SecretBinding, SecretsStoreSecretBinding, SendEmailBinding, SettingsConfig, SettingsConfigInput, 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, defineSettings, defineWorker, exports, triggers };

package/dist/public.mjs

@@ -1,3 +1,3 @@
-import { a as bindings, i as triggers, r as exports, t as defineWorker } from "./public-mmLmXmLK.mjs";
+import { a as triggers, i as exports, n as defineWorker, o as bindings, t as defineSettings } from "./public-D2QZv1n6.mjs";
 
-export { bindings, defineWorker, exports, triggers };
+export { bindings, defineSettings, defineWorker, exports, triggers };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudflare/config",
-  "version": "0.2.1",
+  "version": "0.3.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.20260714.1",
+    "@cloudflare/workers-types": "^5.20260721.1",
     "ts-dedent": "^2.2.0",
     "tsdown": "0.16.3",
     "typescript": "5.8.3",
     "vitest": "4.1.0",
-    "@cloudflare/workers-utils": "0.27.0",
-    "@cloudflare/workers-tsconfig": "0.0.0"
+    "@cloudflare/workers-tsconfig": "0.0.0",
+    "@cloudflare/workers-utils": "0.28.0"
   },
   "workers-sdk": {
     "prerelease": true