@cloudflare/config 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as TextBinding, A as ArtifactsBinding, B as JsonBinding, C as Triggers, D as AiSearchBinding, E as AiBinding, F as DispatchNamespaceBinding, G as PipelineBinding, H as LogfwdrBinding, I as DurableObjectBinding, J as RateLimitBinding, K as QueueBinding, L as FlagshipBinding, M as Bindings, N as BrowserBinding, O as AiSearchNamespaceBinding, P as D1Binding, Q as StreamBinding, R as HyperdriveBinding, S as ScheduledTrigger, T as AgentMemoryBinding, U as MediaBinding, V as KvBinding, W as MtlsCertificateBinding, X as SecretsStoreSecretBinding, Y as SecretBinding, Z as SendEmailBinding, _ as WorkerEntrypointExport, a as ConfigContext, at as TypedWorkerBinding, b as FetchTrigger, c as defineWorker, ct as VectorizeBinding, d as DurableObjectCreatedExport, dt as VpcServiceBinding, et as TypedAiBinding, f as DurableObjectDeletedExport, ft as WebSearchBinding, g as Exports, gt as bindings, h as DurableObjectTransferredExport, ht as WorkflowBinding, i as UnwrapConfig, it as TypedQueueBinding, j as AssetsBinding, k as AnalyticsEngineDatasetBinding, l as resolveWorkerDefinition, lt as VersionMetadataBinding, m as DurableObjectRenamedExport, mt as WorkerLoaderBinding, n as InferEnv, nt as TypedKvBinding, o as TypedWorkerDefinition, ot as TypedWorkflowBinding, p as DurableObjectExpectingTransferExport, pt as WorkerBinding, q as R2Binding, r as InferMainModule, rt as TypedPipelineBinding, s as UserConfigExport, st as UnsafeBinding, t as InferDurableNamespaces, tt as TypedDurableObjectBinding, u as UserConfig, ut as VpcNetworkBinding, v as WorkerEntrypointExportOptions, w as triggers, x as QueueConsumerTrigger, y as exports, z as ImagesBinding } from "./public-YTdTOrcv.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<{
@@ -179,6 +179,9 @@ declare const InputWorkerSchema: z.ZodObject<{
   }, 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>;
@@ -244,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>>;
@@ -299,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";
@@ -319,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<{
@@ -339,6 +507,9 @@ declare const OutputWorkerSchema: z.ZodObject<{
   }, 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>;
@@ -404,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>>;
@@ -484,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.
  */
@@ -516,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 {
@@ -559,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
 /**
@@ -577,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
@@ -617,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, 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-CFHebTo4.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";
@@ -15,7 +15,7 @@ var __commonJS = (cb, mod) => function() {
 };
 
 //#endregion
-//#region ../workers-utils/dist/chunk-DDRU76YD.mjs
+//#region ../workers-utils/dist/chunk-Q72B4Q5Z.mjs
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", {
 	value,
@@ -23,7 +23,7 @@ var __name = (target, value) => __defProp(target, "name", {
 });
 
 //#endregion
-//#region ../workers-utils/dist/chunk-OC543JY3.mjs
+//#region ../workers-utils/dist/chunk-53IMCORZ.mjs
 function isDirectory(path$1) {
 	return fs2.statSync(path$1, { throwIfNoEntry: false })?.isDirectory() ?? false;
 }
@@ -50,7 +50,7 @@ function removeDirSync(dirPath) {
 __name(removeDirSync, "removeDirSync");
 
 //#endregion
-//#region ../workers-utils/dist/chunk-XPMIK7N6.mjs
+//#region ../workers-utils/dist/chunk-Y3JVLYM6.mjs
 function partitionExports(exports$2) {
 	const partitioned = {
 		"durable-object": {},
@@ -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()
 	}),
@@ -2894,6 +2913,10 @@ const TailConsumerSchema = z.strictObject({
 	streaming: z.boolean().optional()
 });
 const TriggerSchema = z.discriminatedUnion("type", [
+	z.strictObject({
+		type: z.literal("email"),
+		addresses: z.array(z.string())
+	}),
 	z.strictObject({
 		type: z.literal("fetch"),
 		pattern: z.string(),
@@ -2932,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(),
@@ -2947,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,
@@ -2959,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",
@@ -3066,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) {
@@ -3520,7 +3590,12 @@ function convertTriggers(config, result) {
 	const crons = [];
 	const routes = result.routes ? [...result.routes] : [];
 	const queueConsumers = result.queues?.consumers ? [...result.queues.consumers] : [];
+	let addresses;
 	for (const trigger of triggers$1) switch (trigger.type) {
+		case "email":
+			addresses ??= [];
+			addresses.push(...trigger.addresses);
+			break;
 		case "scheduled":
 			crons.push(trigger.schedule);
 			break;
@@ -3554,6 +3629,7 @@ function convertTriggers(config, result) {
 		...result.queues ?? {},
 		consumers: queueConsumers
 	};
+	if (addresses !== void 0) result.addresses = addresses;
 }
 function convertDomains(config, result) {
 	if (!config.domains || config.domains.length === 0) return;
@@ -3605,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
 	};
 }
@@ -3704,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-CFHebTo4.mjs → public-D2QZv1n6.mjs}

@@ -145,6 +145,7 @@ const bindings = {
 *     triggers.queue({ name: "my-queue" }),
 *     triggers.scheduled({ schedule: "0 * * * *" }),
 *     triggers.scheduled({ schedule: "30 0 * * *" }),
+*     triggers.email({ addresses: ["support@example.com"] }),
 *   ],
 * });
 * ```
@@ -161,6 +162,10 @@ const triggers = {
 	scheduled: (options) => ({
 		type: "scheduled",
 		...options
+	}),
+	email: (options) => ({
+		type: "email",
+		...options
 	})
 };
 
@@ -201,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",
@@ -221,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-YTdTOrcv.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.
    *
@@ -788,10 +788,27 @@ interface ScheduledTriggerOptions {
 interface ScheduledTrigger extends ScheduledTriggerOptions {
   type: "scheduled";
 }
+interface EmailTriggerOptions {
+  /**
+   * Inbound Email Routing addresses handled by this Worker.
+   *
+   * Each entry is a literal recipient address (e.g. `"support@example.com"`)
+   * or a `*@domain` catch-all (e.g. `"*@example.com"`).
+   */
+  addresses: string[];
+}
+/**
+ * Email trigger — invokes this Worker for the configured Email Routing
+ * addresses.
+ */
+interface EmailTrigger extends EmailTriggerOptions {
+  type: "email";
+}
 /**
- * Event triggers — fetch routes, queue consumers, and cron schedules
- * — that invoke this Worker. Construct entries with `triggers.fetch(...)`,
- * `triggers.queue(...)`, or `triggers.scheduled(...)`.
+ * Event triggers — fetch routes, queue consumers, cron schedules, and Email
+ * Routing addresses — that invoke this Worker. Construct entries with
+ * `triggers.fetch(...)`, `triggers.queue(...)`, `triggers.scheduled(...)`, or
+ * `triggers.email(...)`.
  *
  * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#triggers
  */
@@ -815,6 +832,11 @@ interface Triggers {
    * More details here https://developers.cloudflare.com/workers/platform/cron-triggers
    */
   scheduled(options: ScheduledTriggerOptions): ScheduledTrigger;
+  /**
+   * Email trigger — invokes this Worker for the configured Email Routing
+   * addresses.
+   */
+  email(options: EmailTriggerOptions): EmailTrigger;
 }
 /**
  * Triggers builder for configuring event triggers.
@@ -829,6 +851,7 @@ interface Triggers {
  *     triggers.queue({ name: "my-queue" }),
  *     triggers.scheduled({ schedule: "0 * * * *" }),
  *     triggers.scheduled({ schedule: "30 0 * * *" }),
+ *     triggers.email({ addresses: ["support@example.com"] }),
  *   ],
  * });
  * ```
@@ -983,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`.
@@ -991,7 +1040,7 @@ type Binding = AgentMemoryBinding | AiBinding | AiSearchBinding | AiSearchNamesp
 /**
  * Union of all trigger definitions accepted in `triggers`.
  */
-type Trigger = FetchTrigger | QueueConsumerTrigger | ScheduledTrigger;
+type Trigger = EmailTrigger | FetchTrigger | QueueConsumerTrigger | ScheduledTrigger;
 /**
  * Union of all export definitions accepted in `exports`. Worker entries
  * configure WorkerEntrypoint exports. Durable Object entries configure live
@@ -1005,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.
@@ -1073,9 +1121,10 @@ interface UserConfig {
    */
   domains?: string[];
   /**
-   * Event triggers — fetch routes, queue consumers, and cron schedules
+   * Event triggers — fetch routes, queue consumers, cron schedules, and Email
+   * Routing addresses
    * — that invoke this Worker. Construct entries with `triggers.fetch(...)`,
-   * `triggers.queue(...)`, or `triggers.scheduled(...)`.
+   * `triggers.queue(...)`, `triggers.scheduled(...)`, or `triggers.email(...)`.
    *
    * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#triggers
    */
@@ -1205,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.
    *
@@ -1263,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.
@@ -1310,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
 /**
@@ -1451,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.
  *
@@ -1521,4 +1593,21 @@ type InferMainModule<TUnwrappedConfig$1> = TUnwrappedConfig$1 extends {
   entrypoint: infer TModule extends WorkerModule;
 } ? TModule : DefaultModule;
 //#endregion
-export { TextBinding as $, ArtifactsBinding as A, JsonBinding as B, Triggers as C, AiSearchBinding as D, AiBinding as E, DispatchNamespaceBinding as F, PipelineBinding as G, LogfwdrBinding as H, DurableObjectBinding as I, RateLimitBinding as J, QueueBinding as K, FlagshipBinding as L, Bindings as M, BrowserBinding as N, AiSearchNamespaceBinding as O, D1Binding as P, StreamBinding$1 as Q, HyperdriveBinding as R, ScheduledTrigger as S, AgentMemoryBinding as T, MediaBinding$1 as U, KvBinding as V, MtlsCertificateBinding as W, SecretsStoreSecretBinding as X, SecretBinding as Y, SendEmailBinding as Z, WorkerEntrypointExport as _, ConfigContext as a, TypedWorkerBinding as at, FetchTrigger as b, defineWorker as c, VectorizeBinding as ct, DurableObjectCreatedExport as d, VpcServiceBinding as dt, TypedAiBinding as et, DurableObjectDeletedExport as f, WebSearchBinding as ft, Exports as g, bindings as gt, DurableObjectTransferredExport as h, WorkflowBinding as ht, UnwrapConfig as i, TypedQueueBinding as it, AssetsBinding as j, AnalyticsEngineDatasetBinding as k, resolveWorkerDefinition as l, VersionMetadataBinding as lt, DurableObjectRenamedExport as m, WorkerLoaderBinding as mt, InferEnv as n, TypedKvBinding as nt, TypedWorkerDefinition as o, TypedWorkflowBinding as ot, DurableObjectExpectingTransferExport as p, WorkerBinding as pt, R2Binding as q, InferMainModule as r, TypedPipelineBinding as rt, UserConfigExport as s, UnsafeBinding as st, InferDurableNamespaces as t, TypedDurableObjectBinding as tt, UserConfig as u, VpcNetworkBinding as ut, WorkerEntrypointExportOptions as v, triggers as w, QueueConsumerTrigger as x, exports as y, ImagesBinding$1 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 TextBinding, A as ArtifactsBinding, B as JsonBinding, C as Triggers, D as AiSearchBinding, E as AiBinding, F as DispatchNamespaceBinding, G as PipelineBinding, H as LogfwdrBinding, I as DurableObjectBinding, J as RateLimitBinding, K as QueueBinding, L as FlagshipBinding, M as Bindings, N as BrowserBinding, O as AiSearchNamespaceBinding, P as D1Binding, Q as StreamBinding, R as HyperdriveBinding, S as ScheduledTrigger, T as AgentMemoryBinding, U as MediaBinding, V as KvBinding, W as MtlsCertificateBinding, X as SecretsStoreSecretBinding, Y as SecretBinding, Z as SendEmailBinding, _ as WorkerEntrypointExport, a as ConfigContext, at as TypedWorkerBinding, b as FetchTrigger, c as defineWorker, ct as VectorizeBinding, d as DurableObjectCreatedExport, dt as VpcServiceBinding, et as TypedAiBinding, f as DurableObjectDeletedExport, ft as WebSearchBinding, g as Exports, gt as bindings, h as DurableObjectTransferredExport, ht as WorkflowBinding, i as UnwrapConfig, it as TypedQueueBinding, j as AssetsBinding, k as AnalyticsEngineDatasetBinding, lt as VersionMetadataBinding, m as DurableObjectRenamedExport, mt as WorkerLoaderBinding, n as InferEnv, nt as TypedKvBinding, o as TypedWorkerDefinition, ot as TypedWorkflowBinding, p as DurableObjectExpectingTransferExport, pt as WorkerBinding, q as R2Binding, r as InferMainModule, rt as TypedPipelineBinding, s as UserConfigExport, st as UnsafeBinding, t as InferDurableNamespaces, tt as TypedDurableObjectBinding, u as UserConfig, ut as VpcNetworkBinding, v as WorkerEntrypointExportOptions, w as triggers, x as QueueConsumerTrigger, y as exports, z as ImagesBinding } from "./public-YTdTOrcv.mjs";
-export { AgentMemoryBinding, AiBinding, AiSearchBinding, AiSearchNamespaceBinding, AnalyticsEngineDatasetBinding, ArtifactsBinding, AssetsBinding, Bindings, BrowserBinding, ConfigContext, D1Binding, DispatchNamespaceBinding, DurableObjectBinding, DurableObjectCreatedExport, DurableObjectDeletedExport, DurableObjectExpectingTransferExport, DurableObjectRenamedExport, DurableObjectTransferredExport, 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-CFHebTo4.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.0",
+  "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.20260710.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-tsconfig": "0.0.0",
-    "@cloudflare/workers-utils": "0.27.0"
+    "@cloudflare/workers-utils": "0.28.0"
   },
   "workers-sdk": {
     "prerelease": true