@cloudflare/workers-utils 0.23.0 → 0.23.2

package/dist/browser.d.mts

@@ -1,6 +1,8 @@
-import { T as TailConsumer, az as WorkerMetadata, R as RawConfig } from './config-BT23LDfr.mjs';
+import { T as TailConsumer, aE as WorkerMetadata, R as RawConfig } from './config-8UymS5SL.mjs';
 import { AssetConfig } from '@cloudflare/workers-shared';
 import { Cloudflare } from 'cloudflare';
+import 'node:url';
+import 'undici';
 
 type RoutesRes = {
     id: string;

package/dist/{config-BT23LDfr.d.mts → config-8UymS5SL.d.mts}

@@ -1,5 +1,345 @@
+import { URLSearchParams } from 'node:url';
+import { RequestInit, Response as Response$1, Headers, MockAgent } from 'undici';
 import { RouterConfig, AssetConfig } from '@cloudflare/workers-shared';
 
+interface FetchError {
+    code: number;
+    documentation_url?: string;
+    message: string;
+    error_chain?: FetchError[];
+}
+
+/**
+ * `WRANGLER_C3_COMMAND` can override the command used by `wrangler init` when delegating to C3.
+ *
+ * By default this will use `create cloudflare`.
+ *
+ * To run against the beta release of C3 use:
+ *
+ * ```sh
+ * # Tell Wrangler to use the beta version of create-cloudflare
+ * WRANGLER_C3_COMMAND="create cloudflare@beta" npx wrangler init
+ * ```
+ *
+ * To test the integration between wrangler and C3 locally, use:
+ *
+ * ```sh
+ * # Ensure both Wrangler and C3 are built
+ * npm run build
+ * # Tell Wrangler to use the local version of create-cloudflare
+ * WRANGLER_C3_COMMAND="exec ./packages/create-cloudflare" npx wrangler init temp
+ * ```
+ *
+ * Note that you cannot use `WRANGLER_C3_COMMAND="create cloudflare@2"` if you are
+ * running Wrangler from inside the monorepo as the bin paths get messed up.
+ */
+declare const getC3CommandFromEnv: () => string;
+/**
+ * `WRANGLER_SEND_METRICS` can override whether we attempt to send metrics information to Sparrow.
+ */
+declare const getWranglerSendMetricsFromEnv: () => boolean | undefined;
+/**
+ * `WRANGLER_SEND_ERROR_REPORTS` controls whether we attempt to send error reports to Sentry.
+ *
+ * Defaults to `false` to avoid noisy false-positive reports. Users can opt in
+ * by setting `WRANGLER_SEND_ERROR_REPORTS=true`.
+ */
+declare const getWranglerSendErrorReportsFromEnv: () => boolean;
+/**
+ * Set `WRANGLER_API_ENVIRONMENT` environment variable to "staging" to tell Wrangler to hit the staging APIs rather than production.
+ */
+declare const getCloudflareApiEnvironmentFromEnv: () => "production" | "staging";
+/**
+ * The compliance region to use for the API requests.
+ */
+type ComplianceConfig = Partial<Pick<Config, "compliance_region">>;
+/** Used for commands that explicitly do not support compliance regions other than "public" */
+declare const COMPLIANCE_REGION_CONFIG_PUBLIC: ComplianceConfig;
+/**
+ * Used for commands where there is no configuration available and
+ * we rely upon the CLOUDFLARE_COMPLIANCE_REGION environment variable
+ * to determine the compliance region.
+ */
+declare const COMPLIANCE_REGION_CONFIG_UNKNOWN: ComplianceConfig;
+/**
+ * Set `CLOUDFLARE_COMPLIANCE_REGION` environment variable to "fedramp_high"
+ * or set the `compliance_region` property in the Wrangler configuration
+ * to tell Wrangler to run in FedRAMP High compliance region mode, rather than "public" mode.
+ */
+declare const getCloudflareComplianceRegion: (complianceConfig: ComplianceConfig) => "public" | "fedramp_high";
+/**
+ * `CLOUDFLARE_API_BASE_URL` specifies the URL to the Cloudflare API.
+ *
+ * If this environment variable is not set, it will default to a URL computed from the
+ * Cloudflare compliance region and the API environment.
+ */
+declare const getCloudflareApiBaseUrl: (complianceConfig: ComplianceConfig) => string;
+/**
+ * Compute the subdomain for the compliance region.
+ */
+declare function getComplianceRegionSubdomain(complianceConfig: ComplianceConfig): string;
+/**
+ * `WRANGLER_LOG_SANITIZE` specifies whether we sanitize debug logs.
+ *
+ * By default we do, since debug logs could be added to GitHub issues and shouldn't include sensitive information.
+ */
+declare const getSanitizeLogs: () => boolean;
+/**
+ * `WRANGLER_OUTPUT_FILE_DIRECTORY` specifies a directory where we should write a file containing output data in ND-JSON format.
+ *
+ * If this is set a random file will be created in this directory, and certain Wrangler commands will write entries to this file.
+ * This is overridden by the `WRANGLER_OUTPUT_FILE_PATH` environment variable.
+ */
+declare const getOutputFileDirectoryFromEnv: () => string | undefined;
+/**
+ * `WRANGLER_OUTPUT_FILE_PATH` specifies a path to a file where we should write output data in ND-JSON format.
+ *
+ * If this is set certain Wrangler commands will write entries to this file.
+ * This overrides the `WRANGLER_OUTPUT_FILE_DIRECTORY` environment variable.
+ */
+declare const getOutputFilePathFromEnv: () => string | undefined;
+/**
+ * `WRANGLER_CI_MATCH_TAG` specifies a Worker tag
+ *
+ * If this is set, Wrangler will ensure the Worker being targeted has this tag
+ */
+declare const getCIMatchTag: () => string | undefined;
+/**
+ * `WRANGLER_CI_OVERRIDE_NAME` specifies a Worker name
+ *
+ * If this is set, Wrangler will override the Worker name with this one
+ */
+declare const getCIOverrideName: () => string | undefined;
+/**
+ * `WRANGLER_CI_OVERRIDE_NETWORK_MODE_HOST` specifies whether --network=host should be set
+ *
+ * If this is set to true, Wrangler will use the --network=host flag when calling out to docker to build container images
+ */
+declare const getCIOverrideNetworkModeHost: () => string | undefined;
+/**
+ * `WRANGLER_CI_GENERATE_PREVIEW_ALIAS` specifies whether to generate a preview alias during version upload
+ *
+ * If this is set to true, Wrangler will attempt to autogenerate the preview alias by using the branch
+ * name. If the branch name is too long and an alias cannot be created, a warning will be printed to the console.
+ */
+declare const getCIGeneratePreviewAlias: () => "true" | "false";
+/**
+ * `WORKERS_CI_BRANCH` is the branch name exposed by Workers CI
+ *
+ */
+declare const getWorkersCIBranchName: () => string | undefined;
+/**
+ * `WRANGLER_BUILD_CONDITIONS` specifies the "build conditions" to use when importing packages at build time.
+ *
+ * See https://nodejs.org/api/packages.html#conditional-exports
+ * and https://esbuild.github.io/api/#how-conditions-work.
+ *
+ * If this is set, Wrangler will configure esbuild to use this list of conditions.
+ * The format is a string of comma separated conditions.
+ */
+declare const getBuildConditionsFromEnv: () => string | undefined;
+/**
+ * `WRANGLER_BUILD_PLATFORM` specifies the "build platform" to use when importing packages at build time.
+ *
+ * See https://esbuild.github.io/api/#platform
+ * and https://esbuild.github.io/api/#how-conditions-work.
+ *
+ * If this is set, Wrangler will configure esbuild to use this platform.
+ */
+declare const getBuildPlatformFromEnv: () => string | undefined;
+/**
+ * `WRANGLER_REGISTRY_PATH` specifies the file based dev registry folder
+ */
+declare const getRegistryPath: () => string;
+/**
+ * `WRANGLER_D1_EXTRA_LOCATION_CHOICES` is an internal variable to let D1 team target their testing environments.
+ *
+ * External accounts cannot access testing environments, so should not set this variable.
+ */
+declare const getD1ExtraLocationChoices: () => string | undefined;
+/**
+ * `WRANGLER_DOCKER_BIN` specifies the path to a docker binary.
+ *
+ * By default it's `docker`.
+ */
+declare const getDockerPath: () => string;
+declare const getSubdomainMixedStateCheckDisabled: () => boolean;
+/**
+/**
+ * `CLOUDFLARE_LOAD_DEV_VARS_FROM_DOT_ENV` specifies whether to load vars for local dev from `.env` files.
+ */
+declare const getCloudflareLoadDevVarsFromDotEnv: () => boolean;
+/**
+ * `CLOUDFLARE_INCLUDE_PROCESS_ENV` specifies whether to include the `process.env` in vars loaded from `.env` for local development.
+ */
+declare const getCloudflareIncludeProcessEnvFromEnv: () => boolean;
+declare const getTraceHeader: () => string | undefined;
+declare const getDisableConfigWatching: () => boolean;
+/**
+ * Hide the Wrangler version banner and command status (deprecated/experimental) warnings
+ */
+declare const getWranglerHideBanner: () => boolean;
+/**
+ * `CLOUDFLARE_ENV` specifies the currently selected Wrangler/Cloudflare environment.
+ */
+declare const getCloudflareEnv: () => string | undefined;
+/**
+ * `OPEN_NEXT_DEPLOY` is an environment variables that indicates that the current process is being
+ * run by the open-next deploy command
+ */
+declare const getOpenNextDeployFromEnv: () => string | undefined;
+/**
+ * `X_LOCAL_EXPLORER` enables the local explorer UI at /cdn-cgi/explorer.
+ */
+declare const getLocalExplorerEnabledFromEnv: () => boolean;
+/**
+ * `X_BROWSER_HEADFUL` opens the browser in headful (visible) mode when using the
+ * Browser Run API in local development.
+ *
+ * Set to "true" to enable:
+ *
+ * ```sh
+ * X_BROWSER_HEADFUL=true vite dev
+ * ```
+ *
+ * Note: when using `@cloudflare/playwright`, two Chrome windows may appear — the initial blank
+ * page and the one created by `browser.newPage()`. This is expected due to how Playwright handles
+ * browser contexts via CDP.
+ */
+declare const getBrowserRenderingHeadfulFromEnv: () => boolean;
+/**
+ * `CLOUDFLARE_CF_FETCH_ENABLED` controls whether Miniflare fetches the `cf.json` file
+ * containing request.cf properties from workers.cloudflare.com.
+ *
+ * - If set to "false", disables fetching and uses fallback data (no files created)
+ * - If set to "true" or not set, uses the default behavior (fetches and caches cf.json)
+ *
+ * This is particularly useful for non-JavaScript projects that don't want
+ * a node_modules directory created automatically.
+ *
+ * Example:
+ * ```sh
+ * # Disable cf fetching entirely
+ * CLOUDFLARE_CF_FETCH_ENABLED=false npx wrangler dev
+ * ```
+ */
+declare const getCfFetchEnabledFromEnv: () => boolean;
+/**
+ * `CLOUDFLARE_CF_FETCH_PATH` specifies a custom path for caching the cf.json file.
+ *
+ * - If set, uses the specified path instead of the default node_modules/.mf/cf.json
+ * - If not set, uses the default location (node_modules/.mf/cf.json)
+ *
+ * Example:
+ * ```sh
+ * # Use a custom cache location
+ * CLOUDFLARE_CF_FETCH_PATH=/tmp/cf-cache.json npx wrangler dev
+ * ```
+ */
+declare const getCfFetchPathFromEnv: () => string | undefined;
+/**
+ * `WRANGLER_CACHE_DIR` specifies a custom directory for Wrangler's cache files.
+ * This overrides the default `node_modules/.cache/wrangler` location.
+ * Useful for Yarn PnP or projects without node_modules.
+ */
+declare const getWranglerCacheDirFromEnv: () => string | undefined;
+/**
+ * `CLOUDFLARED_PATH` specifies a custom path to a cloudflared binary.
+ *
+ * If set, Wrangler will use this cloudflared binary instead of downloading one.
+ * The path must point to an existing executable file.
+ */
+declare const getCloudflaredPathFromEnv: () => string | undefined;
+
+declare const LOGGER_LEVELS: {
+    readonly none: -1;
+    readonly error: 0;
+    readonly warn: 1;
+    readonly info: 2;
+    readonly log: 3;
+    readonly debug: 4;
+};
+type LoggerLevel = keyof typeof LOGGER_LEVELS;
+type Logger = {
+    loggerLevel?: LoggerLevel;
+    debug: typeof console.debug;
+    debugWithSanitization?: (label: string, ...args: unknown[]) => void;
+    log: typeof console.log;
+    info: typeof console.info;
+    warn: typeof console.warn;
+    error: typeof console.error;
+    once?: {
+        info: typeof console.info;
+        log: typeof console.log;
+        warn: typeof console.warn;
+        error: typeof console.error;
+    };
+};
+
+type ApiCredentials = {
+    apiToken: string;
+} | {
+    authKey: string;
+    authEmail: string;
+};
+interface FetchResult<ResponseType = unknown> {
+    success: boolean;
+    result: ResponseType;
+    errors: FetchError[];
+    messages?: (string | {
+        code?: number;
+        message: string;
+    })[];
+    result_info?: unknown;
+}
+type FetchResultFetcher = <ResponseType>(complianceConfig: ComplianceConfig, resource: string, init?: RequestInit, queryParams?: URLSearchParams, abortSignal?: AbortSignal) => Promise<ResponseType>;
+type FetchListResultFetcher = <ResponseType>(complianceConfig: ComplianceConfig, resource: string, init?: RequestInit, queryParams?: URLSearchParams) => Promise<ResponseType[]>;
+type FetchPagedListResultFetcher = <ResponseType>(complianceConfig: ComplianceConfig, resource: string, init?: RequestInit, queryParams?: URLSearchParams) => Promise<ResponseType[]>;
+/**
+ *
+ * Note this requires its caller to handle credentials
+ * (need to call requireLoggedIn and requireApiToken)
+ */
+declare function performApiFetchBase(complianceConfig: ComplianceConfig, resource: string, init: RequestInit | undefined, userAgent: string, logger: Logger, queryParams?: URLSearchParams, abortSignal?: AbortSignal, credentials?: ApiCredentials): Promise<Response$1>;
+declare function fetchInternalBase<ResponseType>(complianceConfig: ComplianceConfig, resource: string, init: RequestInit | undefined, userAgent: string, logger: Logger, queryParams?: URLSearchParams, abortSignal?: AbortSignal, credentials?: ApiCredentials): Promise<{
+    response: ResponseType;
+    status: number;
+}>;
+declare function fetchResultBase<ResponseType>(complianceConfig: ComplianceConfig, resource: string, init: RequestInit | undefined, userAgent: string, logger: Logger, queryParams?: URLSearchParams, abortSignal?: AbortSignal, credentials?: ApiCredentials): Promise<ResponseType>;
+declare function fetchListResultBase<ResponseType>(complianceConfig: ComplianceConfig, resource: string, init: RequestInit | undefined, userAgent: string, logger: Logger, queryParams?: URLSearchParams, credentials?: ApiCredentials): Promise<ResponseType[]>;
+declare function truncate(text: string, maxLength: number): string;
+declare function isWAFBlockResponse(headers: Headers): boolean;
+declare function extractWAFBlockRayId(headers: Headers): string | undefined;
+declare function extractAccountTag(resource: string): string | undefined;
+interface PageResultInfo {
+    page: number;
+    per_page: number;
+    count: number;
+    total_count: number;
+}
+declare function hasMorePages(result_info: unknown): result_info is PageResultInfo;
+declare function renderError(err: FetchError | {
+    code?: number;
+    message?: string;
+    documentation_url?: string;
+}, level?: number): string;
+declare function addAuthorizationHeader(headers: Headers, auth: ApiCredentials, overrideExisting?: boolean): void;
+declare function throwFetchError(resource: string, response: FetchResult<unknown>, status: number): never;
+/**
+ * Fetch a raw KV value from the Cloudflare API.
+ *
+ * This is special-cased because it's the only API endpoint that returns raw
+ * binary data instead of a JSON envelope.
+ *
+ * Note: callers must call encodeURIComponent on `key` before passing it.
+ */
+declare function fetchKVGetValueBase(complianceConfig: ComplianceConfig, accountId: string, namespaceId: string, key: string, userAgent: string, logger: Logger, credentials: ApiCredentials): Promise<ArrayBuffer>;
+type FetchKVGetValueFetcher = (complianceConfig: ComplianceConfig, accountId: string, namespaceId: string, key: string) => Promise<ArrayBuffer>;
+declare function hasCursor(result_info: unknown): result_info is {
+    cursor: string;
+};
+declare function maybeAddTraceHeader(headers: Headers): void;
+
 /**
  * A symbol to inherit a binding from the deployed worker.
  */
@@ -262,6 +602,24 @@ interface CfHyperdrive {
     id: string;
     localConnectionString?: string;
 }
+interface CfDevPluginCfg {
+    plugin: {
+        /**
+         * Package is the bare specifier of the package that exposes plugins to integrate into Miniflare via a named `plugins` export.
+         * @example "@cloudflare/my-external-miniflare-plugin"
+         */
+        package: string;
+        /**
+         * Plugin is the name of the plugin exposed by the package.
+         * @example "my-unsafe-plugin"
+         */
+        name: string;
+    };
+    /**
+     * dev-only options to pass to the plugin.
+     */
+    options?: Record<string, unknown>;
+}
 interface CfService {
     binding: string;
     service: string;
@@ -270,6 +628,7 @@ interface CfService {
     props?: Record<string, unknown>;
     remote?: boolean;
     cross_account_grant?: string;
+    dev?: CfDevPluginCfg;
 }
 interface CfVpcService {
     binding: string;
@@ -320,24 +679,7 @@ interface CfPipeline {
 interface CfUnsafeBinding {
     name: string;
     type: string;
-    dev?: {
-        plugin: {
-            /**
-             * Package is the bare specifier of the package that exposes plugins to integrate into Miniflare via a named `plugins` export.
-             * @example "@cloudflare/my-external-miniflare-plugin"
-             */
-            package: string;
-            /**
-             * Plugin is the name of the plugin exposed by the package.
-             * @example "my-unsafe-plugin"
-             */
-            name: string;
-        };
-        /**
-         * dev-only options to pass to the plugin.
-         */
-        options?: Record<string, unknown>;
-    };
+    dev?: CfDevPluginCfg;
 }
 type CfUnsafeMetadata = Record<string, unknown>;
 type CfCapnp = {
@@ -683,6 +1025,16 @@ type AssetsOptions = {
     _headers?: string;
     run_worker_first?: boolean | string[];
 };
+/**
+ * The result of validating and resolving the assets directory, before the
+ * full {@link AssetsOptions} are resolved. Produced by the validation half of
+ * `getAssetsOptions` and consumed by `resolveAssetOptions`.
+ */
+type ValidatedAssetsOptions = {
+    directory: string;
+    binding?: string;
+    directoryExists: boolean;
+};
 /**
  * Information about the assets that should be uploaded
  */
@@ -904,6 +1256,180 @@ type Binding = {
 } | {
     type: "inherit";
 };
+interface CfAccount {
+    /**
+     * An API token.
+     *
+     * @link https://api.cloudflare.com/#user-api-tokens-properties
+     */
+    apiToken: ApiCredentials;
+    /**
+     * An account ID.
+     */
+    accountId: string;
+}
+type HookValues = string | number | boolean | object | undefined | null;
+type Hook<T extends HookValues, Args extends unknown[] = []> = T | ((...args: Args) => T);
+type AsyncHook<T extends HookValues, Args extends unknown[] = []> = Hook<T, Args> | Hook<Promise<T>, Args>;
+type LogLevel = "debug" | "info" | "log" | "warn" | "error" | "none";
+type NodeJSCompatMode = "als" | "v1" | "v2" | null;
+interface StartDevWorkerInput {
+    /** The name of the worker. */
+    name?: string;
+    /**
+     * The javascript or typescript entry-point of the worker.
+     * This is the `main` property of a Wrangler configuration file.
+     */
+    entrypoint?: string;
+    /** The configuration path of the worker, or a normalized configuration object. */
+    config?: string | Config;
+    /** The compatibility date for the workerd runtime. */
+    compatibilityDate?: string;
+    /** The compatibility flags for the workerd runtime. */
+    compatibilityFlags?: string[];
+    /** Specify the compliance region mode of the Worker. */
+    complianceRegion?: Config["compliance_region"];
+    /** Configuration for Python modules. */
+    pythonModules?: {
+        /** A list of glob patterns to exclude files from the python_modules directory when bundling. */
+        exclude?: string[];
+    };
+    env?: string;
+    /**
+     * An array of paths to the .env files to load for this worker, relative to the project directory.
+     *
+     * If not specified, defaults to the standard `.env` files as given from Wrangler.
+     * The project directory is where the Wrangler configuration file is located or the current working directory otherwise.
+     */
+    envFiles?: string[];
+    /** The bindings available to the worker. The specified binding type will be exposed to the worker on the `env` object under the same key. */
+    bindings?: Record<string, Binding>;
+    /**
+     * Default bindings that can be overridden by config bindings.
+     * Useful for injecting environment-specific defaults like CF_PAGES variables.
+     */
+    defaultBindings?: Record<string, Extract<Binding, {
+        type: "plain_text";
+    }>>;
+    migrations?: DurableObjectMigration[];
+    containers?: ContainerApp[];
+    /** The triggers which will cause the worker's exported default handlers to be called. */
+    triggers?: Trigger[];
+    tailConsumers?: CfTailConsumer[];
+    streamingTailConsumers?: CfTailConsumer[];
+    /**
+     * Whether Wrangler should send usage metrics to Cloudflare for this project.
+     *
+     * When defined this will override any user settings.
+     * Otherwise, Wrangler will use the user's preference.
+     */
+    sendMetrics?: boolean;
+    /** Options applying to the worker's build step. Applies to deploy and dev. */
+    build?: {
+        /** Whether the worker and its dependencies are bundled. Defaults to true. */
+        bundle?: boolean;
+        additionalModules?: CfModule[];
+        findAdditionalModules?: boolean;
+        processEntrypoint?: boolean;
+        /** Specifies types of modules matched by globs. */
+        moduleRules?: Rule[];
+        /** Replace global identifiers with constant expressions, e.g. { debug: 'true', version: '"1.0.0"' }. Only takes effect if bundle: true. */
+        define?: Record<string, string>;
+        /** Alias modules */
+        alias?: Record<string, string>;
+        /** Whether the bundled worker is minified. Only takes effect if bundle: true. */
+        minify?: boolean;
+        /** Whether to keep function names after JavaScript transpilations. */
+        keepNames?: boolean;
+        /** Options controlling a custom build step. */
+        custom?: {
+            /** Custom shell command to run before bundling. Runs even if bundle. */
+            command?: string;
+            /** The cwd to run the command in. */
+            workingDirectory?: string;
+            /** Filepath(s) to watch for changes. Upon changes, the command will be rerun. */
+            watch?: string | string[];
+        };
+        jsxFactory?: string;
+        jsxFragment?: string;
+        tsconfig?: string;
+        nodejsCompatMode?: Hook<NodeJSCompatMode, [Config]>;
+        moduleRoot?: string;
+    };
+    /** Options applying to the worker's development preview environment. */
+    dev?: {
+        /** Options applying to the worker's inspector server. False disables the inspector server. */
+        inspector?: {
+            hostname?: string;
+            port?: number;
+            secure?: boolean;
+        } | false;
+        /** Whether the worker runs on the edge or locally. */
+        remote?: boolean | "minimal";
+        /** Cloudflare Account credentials. Can be provided upfront or as a function which will be called only when required. */
+        auth?: AsyncHook<CfAccount, [Pick<Config, "account_id">]>;
+        /** Whether local storage (KV, Durable Objects, R2, D1, etc) is persisted. You can also specify the directory to persist data to. Set to `false` to disable persistence. */
+        persist?: string | false;
+        /** Controls which logs are logged. */
+        logLevel?: LogLevel;
+        /** Whether the worker server restarts upon source/config file changes. */
+        watch?: boolean;
+        /** Whether a script tag is inserted on text/html responses which will reload the page upon file changes. Defaults to false. */
+        liveReload?: boolean;
+        /** The local address to reach your worker. Applies to remote: true (remote mode) and remote: false (local mode). */
+        server?: {
+            hostname?: string;
+            port?: number;
+            secure?: boolean;
+            httpsKeyPath?: string;
+            httpsCertPath?: string;
+        };
+        /** Controls what request.url looks like inside the worker. */
+        origin?: {
+            hostname?: string;
+            secure?: boolean;
+        };
+        /** A hook for outbound fetch calls from within the worker. */
+        outboundService?: ServiceFetch;
+        /** An undici MockAgent to declaratively mock fetch calls to particular resources. */
+        mockFetch?: MockAgent;
+        testScheduled?: boolean;
+        /** Treat this as the primary worker in a multiworker setup (i.e. the first Worker in Miniflare's options) */
+        multiworkerPrimary?: boolean;
+        /** Whether to infer the local request origin from configured routes. */
+        inferOriginFromRoutes?: boolean;
+        /** Whether local requests should be matched against configured routes. */
+        routeRequestsByRoutes?: boolean;
+        containerBuildId?: string;
+        /** Whether to build and connect to containers during local dev. Requires Docker daemon to be running. Defaults to true. */
+        enableContainers?: boolean;
+        /** Path to the dev registry directory */
+        registry?: string;
+        /** Path to the docker executable. Defaults to 'docker' */
+        dockerPath?: string;
+        /** Options for the container engine */
+        containerEngine?: ContainerEngine;
+        /** Re-generate your worker types when your Wrangler configuration file changes */
+        generateTypes?: boolean;
+        /**
+         * Experimental: Use `cloudflare.config.ts` + optional `wrangler.config.ts`
+         * instead of `wrangler.json[c]` / `wrangler.toml`.
+         */
+        experimentalNewConfig?: boolean;
+        /** Tunnel configuration for this dev session. */
+        tunnel?: {
+            enabled: boolean;
+            name?: string;
+        };
+    };
+    legacy?: {
+        site?: Hook<Config["site"], [Config]>;
+        useServiceEnvironments?: boolean;
+    };
+    unsafe?: Omit<CfUnsafe, "bindings">;
+    assets?: string;
+    experimental?: Record<string, never>;
+}
 /**
  * An entry point for the Worker.
  *
@@ -2723,4 +3249,4 @@ interface EnvironmentMap {
 }
 declare const defaultWranglerConfig: Config;
 
-export { type CfVectorize as $, type Assets as A, type Binding as B, type ComputedFields as C, type DurableObjectMigration as D, type Environment as E, type CfWasmModuleBindings as F, type CfTextBlobBindings as G, type CfBrowserBinding as H, type CfAIBinding as I, type CfImagesBinding as J, type CfMediaBinding as K, type CfStreamBinding as L, type CfVersionMetadataBinding as M, type CfDataBlobBindings as N, type Observability as O, type PreviewsConfig as P, type CfDurableObject as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfWorkflow as V, type WorkerMetadataBinding as W, type CfQueue as X, type CfR2Bucket as Y, type ZoneIdRoute as Z, type CfD1Database as _, type RedirectedRawConfig as a, type CfAISearchNamespace as a0, type CfAISearch as a1, type CfWebSearch as a2, type CfAgentMemory as a3, type CfSecretsStoreSecrets as a4, type CfArtifacts as a5, type CfHelloWorld as a6, type CfFlagship as a7, type CfWorkerLoader as a8, type CfRateLimit as a9, type ServiceMetadataRes as aA, type ServiceFetch as aB, type File as aC, type BinaryFile as aD, type Trigger as aE, type Entry as aF, INHERIT_SYMBOL as aG, SERVICE_TAG_PREFIX as aH, ENVIRONMENT_TAG_PREFIX as aI, PATH_TO_DEPLOY_CONFIG as aJ, JSON_CONFIG_FORMATS as aK, type CfHyperdrive as aa, type CfService as ab, type CfVpcService as ac, type CfVpcNetwork as ad, type CfAnalyticsEngineDataset as ae, type CfDispatchNamespace as af, type CfMTlsCertificate as ag, type CfLogfwdr as ah, type CfLogfwdrBinding as ai, type CfAssetsBinding as aj, type CfPipeline as ak, type CfUnsafeBinding as al, type CfCapnp as am, type CfUnsafe as an, type CfDurableObjectMigrations as ao, type CfPlacement as ap, type CfTailConsumer as aq, type CfUserLimits as ar, type CfWorkerInit as as, type CfWorkerContext as at, type CfWorkerSourceMap as au, type Json as av, type AssetConfigMetadata as aw, type AssetsOptions as ax, type LegacyAssetPaths as ay, type WorkerMetadata as az, type Config as b, type Route as c, type RawDevConfig as d, type ConfigFields as e, type RawEnvironment as f, defaultWranglerConfig as g, type ZoneNameRoute as h, type CustomDomainRoute as i, type CloudchamberConfig as j, type ContainerApp as k, type DurableObjectBindings as l, type WorkflowBinding as m, type EnvironmentNonInheritable as n, type Rule as o, type ConfigModuleRuleType as p, type DispatchNamespaceOutbound as q, type CacheOptions as r, type DockerConfiguration as s, type ContainerEngine as t, type CfScriptFormat as u, type CfModuleType as v, type CfModule as w, type CfVars as x, type CfKvNamespace as y, type CfSendEmailBindings as z };
+export { type CfQueue as $, type Assets as A, type Binding as B, type ComputedFields as C, type DurableObjectMigration as D, type Environment as E, type CfKvNamespace as F, type CfSendEmailBindings as G, type CfWasmModuleBindings as H, type CfTextBlobBindings as I, type CfBrowserBinding as J, type CfAIBinding as K, type Logger as L, type CfImagesBinding as M, type CfMediaBinding as N, type Observability as O, type PreviewsConfig as P, type CfStreamBinding as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfVersionMetadataBinding as V, type WorkerMetadataBinding as W, type CfDataBlobBindings as X, type CfDurableObject as Y, type ZoneIdRoute as Z, type CfWorkflow as _, type RedirectedRawConfig as a, type ComplianceConfig as a$, type CfR2Bucket as a0, type CfD1Database as a1, type CfVectorize as a2, type CfAISearchNamespace as a3, type CfAISearch as a4, type CfWebSearch as a5, type CfAgentMemory as a6, type CfSecretsStoreSecrets as a7, type CfArtifacts as a8, type CfHelloWorld as a9, type AssetConfigMetadata as aA, type AssetsOptions as aB, type ValidatedAssetsOptions as aC, type LegacyAssetPaths as aD, type WorkerMetadata as aE, type ServiceMetadataRes as aF, type ServiceFetch as aG, type File as aH, type BinaryFile as aI, type Trigger as aJ, type CfAccount as aK, type HookValues as aL, type Hook as aM, type AsyncHook as aN, type LogLevel as aO, type NodeJSCompatMode as aP, type StartDevWorkerInput as aQ, type Entry as aR, INHERIT_SYMBOL as aS, SERVICE_TAG_PREFIX as aT, ENVIRONMENT_TAG_PREFIX as aU, PATH_TO_DEPLOY_CONFIG as aV, JSON_CONFIG_FORMATS as aW, getC3CommandFromEnv as aX, getWranglerSendMetricsFromEnv as aY, getWranglerSendErrorReportsFromEnv as aZ, getCloudflareApiEnvironmentFromEnv as a_, type CfFlagship as aa, type CfWorkerLoader as ab, type CfRateLimit as ac, type CfHyperdrive as ad, type CfDevPluginCfg as ae, type CfService as af, type CfVpcService as ag, type CfVpcNetwork as ah, type CfAnalyticsEngineDataset as ai, type CfDispatchNamespace as aj, type CfMTlsCertificate as ak, type CfLogfwdr as al, type CfLogfwdrBinding as am, type CfAssetsBinding as an, type CfPipeline as ao, type CfUnsafeBinding as ap, type CfCapnp as aq, type CfUnsafe as ar, type CfDurableObjectMigrations as as, type CfPlacement as at, type CfTailConsumer as au, type CfUserLimits as av, type CfWorkerInit as aw, type CfWorkerContext as ax, type CfWorkerSourceMap as ay, type Json as az, type Config as b, COMPLIANCE_REGION_CONFIG_PUBLIC as b0, COMPLIANCE_REGION_CONFIG_UNKNOWN as b1, getCloudflareComplianceRegion as b2, getCloudflareApiBaseUrl as b3, getComplianceRegionSubdomain as b4, getSanitizeLogs as b5, getOutputFileDirectoryFromEnv as b6, getOutputFilePathFromEnv as b7, getCIMatchTag as b8, getCIOverrideName as b9, type FetchPagedListResultFetcher as bA, performApiFetchBase as bB, fetchInternalBase as bC, fetchResultBase as bD, fetchListResultBase as bE, truncate as bF, isWAFBlockResponse as bG, extractWAFBlockRayId as bH, extractAccountTag as bI, hasMorePages as bJ, renderError as bK, addAuthorizationHeader as bL, throwFetchError as bM, fetchKVGetValueBase as bN, type FetchKVGetValueFetcher as bO, hasCursor as bP, maybeAddTraceHeader as bQ, getCIOverrideNetworkModeHost as ba, getCIGeneratePreviewAlias as bb, getWorkersCIBranchName as bc, getBuildConditionsFromEnv as bd, getBuildPlatformFromEnv as be, getRegistryPath as bf, getD1ExtraLocationChoices as bg, getDockerPath as bh, getSubdomainMixedStateCheckDisabled as bi, getCloudflareLoadDevVarsFromDotEnv as bj, getCloudflareIncludeProcessEnvFromEnv as bk, getTraceHeader as bl, getDisableConfigWatching as bm, getWranglerHideBanner as bn, getCloudflareEnv as bo, getOpenNextDeployFromEnv as bp, getLocalExplorerEnabledFromEnv as bq, getBrowserRenderingHeadfulFromEnv as br, getCfFetchEnabledFromEnv as bs, getCfFetchPathFromEnv as bt, getWranglerCacheDirFromEnv as bu, getCloudflaredPathFromEnv as bv, type ApiCredentials as bw, type FetchResult as bx, type FetchResultFetcher as by, type FetchListResultFetcher as bz, type Route as c, type RawDevConfig as d, type ConfigFields as e, type RawEnvironment as f, defaultWranglerConfig as g, LOGGER_LEVELS as h, type LoggerLevel as i, type ZoneNameRoute as j, type CustomDomainRoute as k, type CloudchamberConfig as l, type ContainerApp as m, type DurableObjectBindings as n, type WorkflowBinding as o, type EnvironmentNonInheritable as p, type Rule as q, type ConfigModuleRuleType as r, type DispatchNamespaceOutbound as s, type CacheOptions as t, type DockerConfiguration as u, type ContainerEngine as v, type CfScriptFormat as w, type CfModuleType as x, type CfModule as y, type CfVars as z };