@cloudflare/workers-utils 0.33.1 → 0.35.0

package/dist/index.d.mts

@@ -1,16 +1,22 @@
-import { C as ComputedFields, B as Binding, R as RawConfig, b as Config, E as Exports, D as DurableObjectExport, W as WorkerEntrypointExport, c as ContainerApp, d as WorkerMetadataBinding, L as Logger, e as Route } from './config-CRUFg2tu.mjs';
-export { A as ARTIFACTS_EVENT_TYPES, H as Access, bS as ApiCredentials, v as ArtifactsEventTrigger, u as ArtifactsEventType, aL as AssetConfigMetadata, G as Assets, aM as AssetsOptions, b4 as AsyncHook, a$ as BinaryFile, bl as COMPLIANCE_REGION_CONFIG_PUBLIC, bm as COMPLIANCE_REGION_CONFIG_UNKNOWN, I as CacheOptions, a1 as CfAIBinding, ae as CfAISearch, ad as CfAISearchNamespace, b1 as CfAccount, ag as CfAgentMemory, as as CfAnalyticsEngineDataset, ai as CfArtifacts, ax as CfAssetsBinding, a0 as CfBrowserBinding, aA as CfCapnp, ab as CfD1Database, a6 as CfDataBlobBindings, ao as CfDevPluginCfg, at as CfDispatchNamespace, a7 as CfDurableObject, aC as CfDurableObjectMigrations, aD as CfExports, ak as CfFlagship, aj as CfHelloWorld, an as CfHyperdrive, a2 as CfImagesBinding, X as CfKvNamespace, av as CfLogfwdr, aw as CfLogfwdrBinding, au as CfMTlsCertificate, a3 as CfMediaBinding, Q as CfModule, N as CfModuleType, ay as CfPipeline, aE as CfPlacement, a9 as CfQueue, aa as CfR2Bucket, am as CfRateLimit, M as CfScriptFormat, ah as CfSecretsStoreSecrets, Y as CfSendEmailBindings, ap as CfService, a4 as CfStreamBinding, aF as CfTailConsumer, $ as CfTextBlobBindings, aB as CfUnsafe, az as CfUnsafeBinding, aG as CfUserLimits, V as CfVars, ac as CfVectorize, a5 as CfVersionMetadataBinding, ar as CfVpcNetwork, aq as CfVpcService, _ as CfWasmModuleBindings, af as CfWebSearch, aI as CfWorkerContext, aH as CfWorkerInit, al as CfWorkerLoader, aJ as CfWorkerSourceMap, a8 as CfWorkflow, p as CloudchamberConfig, bk as ComplianceConfig, g as ConfigFields, z as ConfigModuleRuleType, s as ConfiguredExport, K as ContainerEngine, o as CustomDomainRoute, F as DispatchNamespaceOutbound, J as DockerConfiguration, t as DurableObjectBindings, r as DurableObjectExportStorage, q as DurableObjectMigration, bb as ENVIRONMENT_TAG_PREFIX, b8 as Entry, l as Environment, x as EnvironmentNonInheritable, aQ as ExportsReconciliationEntryBase, aT as ExportsReconciliationErrorDetail, aR as ExportsReconciliationInfo, aU as ExportsReconciliationRename, aX as ExportsReconciliationResult, aV as ExportsReconciliationTransfer, aW as ExportsReconciliationTransferPending, aS as ExportsReconciliationWarning, ca as FetchKVGetValueFetcher, bV as FetchListResultFetcher, bW as FetchPagedListResultFetcher, bT as FetchResult, bU as FetchResultFetcher, a_ as File, b3 as Hook, b2 as HookValues, b9 as INHERIT_SYMBOL, bd as JSON_CONFIG_FORMATS, aK as Json, j as LOGGER_LEVELS, aO as LegacyAssetPaths, m as LocalS3Credentials, b5 as LogLevel, k as LoggerLevel, b6 as NodeJSCompatMode, O as Observability, bc as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, f as RawDevConfig, h as RawEnvironment, a as RedirectedRawConfig, y as Rule, ba as SERVICE_TAG_PREFIX, aZ as ServiceFetch, aY as ServiceMetadataRes, b7 as StartDevWorkerInput, S as StreamingTailConsumer, T as TailConsumer, b0 as Trigger, U as UserLimits, aN as ValidatedAssetsOptions, aP as WorkerMetadata, w as WorkflowBinding, Z as ZoneIdRoute, n as ZoneNameRoute, c7 as addAuthorizationHeader, i as defaultWranglerConfig, c4 as extractAccountTag, c3 as extractWAFBlockRayId, bY as fetchInternalBase, c9 as fetchKVGetValueBase, b_ as fetchListResultBase, bZ as fetchResultBase, bN as getBrowserRenderingHeadfulFromEnv, by as getBuildConditionsFromEnv, bz as getBuildPlatformFromEnv, be as getC3CommandFromEnv, bw as getCIGeneratePreviewAlias, bt as getCIMatchTag, bu as getCIOverrideName, bv as getCIOverrideNetworkModeHost, bO as getCfFetchEnabledFromEnv, bP as getCfFetchPathFromEnv, bo as getCloudflareApiBaseUrl, bj as getCloudflareApiEnvironmentFromEnv, bn as getCloudflareComplianceRegion, bJ as getCloudflareEnv, bF as getCloudflareIncludeProcessEnvFromEnv, bE as getCloudflareLoadDevVarsFromDotEnv, bR as getCloudflaredPathFromEnv, bp as getComplianceRegionSubdomain, bB as getD1ExtraLocationChoices, bH as getDisableConfigWatching, bC as getDockerPath, bL as getLocalExplorerEnabledFromEnv, bM as getLocalObservabilityEnabledFromEnv, bh as getNoSkillsUpdatePromptsFromEnv, bK as getOpenNextDeployFromEnv, br as getOutputFileDirectoryFromEnv, bs as getOutputFilePathFromEnv, bA as getRegistryPath, bq as getSanitizeLogs, bD as getSubdomainMixedStateCheckDisabled, bG as getTraceHeader, bx as getWorkersCIBranchName, bQ as getWranglerCacheDirFromEnv, bI as getWranglerHideBanner, bi as getWranglerSendErrorReportsFromEnv, bg as getWranglerSendMetricsFromEnv, cb as hasCursor, c5 as hasMorePages, bf as isDoNotTrackEnabled, c0 as isWAFBlockResponse, cc as maybeAddTraceHeader, c2 as parseRetryAfterMs, c1 as parseRetryAfterValue, bX as performApiFetchBase, c6 as renderError, c8 as throwFetchError, b$ as truncate } from './config-CRUFg2tu.mjs';
+import { C as ComputedFields, B as Binding, R as RawConfig, b as Config, E as Exports, D as DurableObjectExport, W as WorkerEntrypointExport, c as ContainerApp, d as WorkerMetadataBinding, e as CfTailConsumer, L as Logger, f as Route } from './compliance-j3-tqeao.mjs';
+export { A as ARTIFACTS_EVENT_TYPES, g as Access, h as ApiCredentials, i as ArtifactsEventTrigger, j as ArtifactsEventType, k as AssetConfigMetadata, l as Assets, m as AssetsOptions, n as AsyncHook, o as BinaryFile, p as COMPLIANCE_REGION_CONFIG_PUBLIC, q as COMPLIANCE_REGION_CONFIG_UNKNOWN, r as CacheOptions, s as CfAIBinding, t as CfAISearch, u as CfAISearchNamespace, v as CfAccount, w as CfAgentMemory, x as CfAnalyticsEngineDataset, y as CfArtifacts, z as CfAssetsBinding, F as CfBrowserBinding, G as CfCapnp, H as CfD1Database, I as CfDataBlobBindings, J as CfDevPluginCfg, K as CfDispatchNamespace, M as CfDurableObject, N as CfDurableObjectMigrations, O as CfExports, P as CfFlagship, Q as CfHelloWorld, S as CfHyperdrive, T as CfImagesBinding, U as CfKvNamespace, V as CfLogfwdr, X as CfLogfwdrBinding, Y as CfMTlsCertificate, Z as CfMediaBinding, _ as CfModule, $ as CfModuleType, a0 as CfPipeline, a1 as CfPlacement, a2 as CfQueue, a3 as CfR2Bucket, a4 as CfRateLimit, a5 as CfScriptFormat, a6 as CfSecretsStoreSecrets, a7 as CfSendEmailBindings, a8 as CfService, a9 as CfStreamBinding, aa as CfTextBlobBindings, ab as CfUnsafe, ac as CfUnsafeBinding, ad as CfUserLimits, ae as CfVars, af as CfVectorize, ag as CfVersionMetadataBinding, ah as CfVpcNetwork, ai as CfVpcService, aj as CfWasmModuleBindings, ak as CfWebSearch, al as CfWorkerContext, am as CfWorkerInit, an as CfWorkerLoader, ao as CfWorkerSourceMap, ap as CfWorkflow, aq as CloudchamberConfig, ar as ComplianceConfig, as as ConfigFields, at as ConfigModuleRuleType, au as ConfiguredExport, av as ContainerEngine, aw as CustomDomainRoute, ax as DispatchNamespaceOutbound, ay as DockerConfiguration, az as DurableObjectBindings, aA as DurableObjectExportStorage, aB as DurableObjectMigration, aC as ENVIRONMENT_TAG_PREFIX, aD as Entry, aE as Environment, aF as EnvironmentNonInheritable, aG as ExportsReconciliationEntryBase, aH as ExportsReconciliationErrorDetail, aI as ExportsReconciliationInfo, aJ as ExportsReconciliationRename, aK as ExportsReconciliationResult, aL as ExportsReconciliationTransfer, aM as ExportsReconciliationTransferPending, aN as ExportsReconciliationWarning, aO as FetchKVGetValueFetcher, aP as FetchListResultFetcher, aQ as FetchPagedListResultFetcher, aR as FetchResult, aS as FetchResultFetcher, aT as File, aU as Hook, aV as HookValues, aW as INHERIT_SYMBOL, aX as JSON_CONFIG_FORMATS, aY as Json, aZ as LOGGER_LEVELS, a_ as LegacyAssetPaths, a$ as LocalS3Credentials, b0 as LogLevel, b1 as LoggerLevel, b2 as NodeJSCompatMode, b3 as Observability, b4 as PATH_TO_DEPLOY_CONFIG, b5 as PreviewsConfig, b6 as RawDevConfig, b7 as RawEnvironment, a as RedirectedRawConfig, b8 as Rule, b9 as SERVICE_TAG_PREFIX, ba as ServiceFetch, bb as ServiceMetadataRes, bc as StartDevWorkerInput, bd as StreamingTailConsumer, be as TailConsumer, bf as Trigger, bg as UserLimits, bh as ValidatedAssetsOptions, bi as WorkerMetadata, bj as WorkflowBinding, bk as ZoneIdRoute, bl as ZoneNameRoute, bm as addAuthorizationHeader, bn as defaultWranglerConfig, bo as extractAccountTag, bp as extractWAFBlockRayId, bq as fetchInternalBase, br as fetchKVGetValueBase, bs as fetchListResultBase, bt as fetchResultBase, bu as getBrowserRenderingHeadfulFromEnv, bv as getBuildConditionsFromEnv, bw as getBuildPlatformFromEnv, bx as getC3CommandFromEnv, by as getCIGeneratePreviewAlias, bz as getCIMatchTag, bA as getCIOverrideName, bB as getCIOverrideNetworkModeHost, bC as getCfFetchEnabledFromEnv, bD as getCfFetchPathFromEnv, bE as getCloudflareApiBaseUrl, bF as getCloudflareApiEnvironmentFromEnv, bG as getCloudflareComplianceRegion, bH as getCloudflareEnv, bI as getCloudflareIncludeProcessEnvFromEnv, bJ as getCloudflareLoadDevVarsFromDotEnv, bK as getCloudflaredPathFromEnv, bL as getComplianceRegionSubdomain, bM as getD1ExtraLocationChoices, bN as getDisableConfigWatching, bO as getLocalExplorerEnabledFromEnv, bP as getLocalObservabilityEnabledFromEnv, bQ as getNoSkillsUpdatePromptsFromEnv, bR as getOpenNextDeployFromEnv, bS as getOutputFileDirectoryFromEnv, bT as getOutputFilePathFromEnv, bU as getRegistryPath, bV as getSanitizeLogs, bW as getSubdomainMixedStateCheckDisabled, bX as getTraceHeader, bY as getWorkersCIBranchName, bZ as getWranglerCacheDirFromEnv, b_ as getWranglerHideBanner, b$ as getWranglerSendErrorReportsFromEnv, c0 as getWranglerSendMetricsFromEnv, c1 as hasCursor, c2 as hasMorePages, c3 as isDoNotTrackEnabled, c4 as isWAFBlockResponse, c5 as maybeAddTraceHeader, c6 as parseRetryAfterMs, c7 as parseRetryAfterValue, c8 as performApiFetchBase, c9 as renderError, ca as throwFetchError, cb as truncate } from './compliance-j3-tqeao.mjs';
 import * as jsoncParser from 'jsonc-parser';
+import { UserError, TelemetryMessage } from './errors.mjs';
+export { CommandLineArgsError, DeprecationError, FatalError, JsonFriendlyFatalError, MissingConfigError, createFatalError } from './errors.mjs';
 export { constructWranglerConfig } from './browser.mjs';
 export { GetGlobalConfigPathOptions, getGlobalConfigPath, getGlobalWranglerCachePath } from './global-wrangler-config-path.mjs';
+import { CompatDate } from './compatibility-date.mjs';
+export { NODEJS_COMPAT_DEFAULT_ON_DATE, NODEJS_COMPAT_V2_SWITCH_OVER_DATE, getTodaysCompatDate, isCompatDate, isNodejsCompatDefaultOn, resolveNodejsCompat, stripRedundantNodejsCompatFlags } from './compatibility-date.mjs';
 export { isDirectory, removeDir, removeDirSync } from './fs-helpers.mjs';
 export { Counter, MetricsRegistry } from './prometheus-metrics.mjs';
 import { ChildProcess } from 'node:child_process';
-import { z } from 'zod';
+export { _forceColour, formatZodError } from './zod-format.mjs';
+export { getDockerPath } from './docker-path.mjs';
 import 'node:url';
 import 'undici';
 import '@cloudflare/workers-shared';
 import 'cloudflare';
+import 'zod';
 
 type ResolveConfigPathOptions = {
     useRedirectIfAvailable?: boolean;
@@ -219,60 +225,6 @@ patch: RawConfig, isArrayInsertion?: boolean) => string;
 declare class PatchConfigError extends Error {
 }
 
-/**
- * This is used to provide telemetry with a sanitised error
- * message that could not have any user-identifying information.
- * Set to `true` to duplicate `message`.
- *  */
-type TelemetryMessage = {
-    telemetryMessage: string | boolean;
-};
-type UserErrorOptions = ErrorOptions & TelemetryMessage;
-type FatalErrorOptions = UserErrorOptions & {
-    code?: number;
-};
-/**
- * Base class for errors where the user has done something wrong. These are not
- * reported to Sentry. API errors are intentionally *not* `UserError`s, and are
- * reported to Sentry. This will help us understand which API errors need better
- * messaging.
- */
-declare class UserError extends Error {
-    telemetryMessage: string | undefined;
-    constructor(message: string, options: UserErrorOptions);
-}
-declare class DeprecationError extends UserError {
-    constructor(message: string, options: TelemetryMessage);
-}
-declare class FatalError extends UserError {
-    readonly code: number | undefined;
-    constructor(message: string, options: FatalErrorOptions);
-}
-declare class CommandLineArgsError extends UserError {
-}
-/**
- * JsonFriendlyFatalError is used to output JSON when wrangler crashes, useful for --json mode.
- *
- * To use, pass stringify'd json into the constructor like so:
- * ```js
- * throw new JsonFriendlyFatalError(JSON.stringify({ error: messageToDisplay }), {
- *   telemetryMessage: false,
- * });
- * ```
- */
-declare class JsonFriendlyFatalError extends FatalError {
-}
-declare class MissingConfigError extends Error {
-    telemetryMessage: string | undefined;
-    constructor(key: string);
-}
-/**
- * Create either a FatalError or JsonFriendlyFatalError depending upon `isJson` parameter.
- *
- * If `isJson` is true, then the `message` is JSON stringified.
- */
-declare function createFatalError(message: unknown, isJson: boolean, options: FatalErrorOptions): Error;
-
 type Message = {
     text: string;
     location?: Location;
@@ -400,7 +352,7 @@ declare function parseByteSize(s: string, base?: number | undefined): number;
 
 /**
  * Local-dev capability of each binding type. Source of truth for
- * `pickRemoteBindings()` and `warnOrError()`.
+ * `pickRemoteBindings()` and `validateBindingRemoteSetting()`.
  *
  * - `local-and-remote`: local simulator; `remote: true` opts into proxying.
  * - `local-only`: local simulator only; `remote: true` is a config error.
@@ -413,6 +365,13 @@ declare function parseByteSize(s: string, base?: number | undefined): number;
  */
 type BindingLocalSupport = "local-and-remote" | "local-only" | "remote" | "DO-NOT-USE-this-resource-will-never-have-a-local-simulator";
 declare function getBindingLocalSupport(type: Binding["type"]): BindingLocalSupport;
+/**
+ * Validates the user's `remote` setting for a given binding against the
+ * binding type's local-development capabilities. Throws `UserError` for
+ * invalid combinations and uses the caller-provided logger for
+ * valid-but-noteworthy ones.
+ */
+declare function validateBindingRemoteSetting(type: Binding["type"], remote: boolean | undefined, warn: (message: string) => void): void;
 
 /**
  * Pages now supports configuration via a Wrangler configuration file. As opposed to
@@ -462,11 +421,14 @@ declare function assertNever(_value: never): void;
 /**
  * Resolves the filesystem path for an installed npm package.
  *
- * Tries two strategies:
- * 1. `require.resolve("<pkg>/package.json")` -- works when the package exports its package.json
- * 2. `require.resolve("<pkg>")` -- fallback for packages that don't export package.json
+ * Tries three strategies in order:
+ * 1. `require.resolve("<pkg>/package.json")` — works when the package exports its `package.json`
+ * 2. `require.resolve("<pkg>")` — fallback for packages that don't export `package.json`
+ * 3. Direct `node_modules` filesystem lookup — fallback for ESM-only packages whose exports
+ *    map has no `"require"` or `"default"` condition (and no `"./package.json"` export),
+ *    which makes them invisible to `require.resolve`
  *
- * @param packageName - The npm package name to resolve
+ * @param packageName - The npm package name to resolve (supports scoped packages like `@scope/pkg`)
  * @param projectPath - The project directory to resolve from
  * @returns The resolved directory path, or `undefined` if the package is not installed
  */
@@ -503,6 +465,63 @@ declare function getInstalledPackageVersion(packageName: string, projectPath: st
  */
 declare function mapWorkerMetadataBindings(bindings: WorkerMetadataBinding[]): RawConfig;
 
+interface ConvertBindingsOptions {
+    /**
+     * Use preview IDs (preview_id, preview_bucket_name, preview_database_id) instead of production IDs when resolving a binding ID.
+     * This means that the rest of Wrangler does not need to be aware of preview IDs, and can just use regular IDs.
+     */
+    usePreviewIds?: boolean;
+    /**
+     * Exclude bindings that Pages doesn't support
+     */
+    pages?: boolean;
+}
+/**
+ * Convert Config to the Record<string, Binding> format for consistent internal use.
+ */
+declare function convertConfigToBindings(config: Partial<Pick<Config, ConfigBindingFieldName>>, options?: ConvertBindingsOptions): Record<string, Binding>;
+declare function isUnsafeBindingType(type: string): type is `unsafe_${string}`;
+/**
+ * What configuration key does this binding use for referring to it's binding name?
+ */
+declare const nameBindings: readonly ["durable_object_namespace", "logfwdr", "ratelimit", "unsafe_ratelimit", "send_email"];
+type FlatBinding<Type> = Extract<Binding, {
+    type: Type;
+}> & (Type extends (typeof nameBindings)[number] ? {
+    name: string;
+} : {
+    binding: string;
+});
+declare function extractBindingsOfType<Type extends Binding["type"]>(type: Type, bindings: Record<string, Binding> | undefined): FlatBinding<Type>[];
+/**
+ * Get bindings from a Config object in the standard Record<string, Binding> format.
+ */
+declare function getBindings(config: Config | undefined, options?: {
+    pages?: boolean;
+}): Record<string, Binding>;
+
+type PrintBindingsOptions = {
+    log: (message: string) => void;
+    tailConsumers?: CfTailConsumer[];
+    streamingTailConsumers?: CfTailConsumer[];
+    containers?: ContainerApp[];
+    registry?: Record<string, {
+        debugPortAddress?: string;
+    }> | null;
+    local?: boolean;
+    isMultiWorker?: boolean;
+    remoteBindingsDisabled?: boolean;
+    name?: string;
+    provisioning?: boolean;
+    warnIfNoBindings?: boolean;
+    unsafeMetadata?: Record<string, unknown>;
+};
+/**
+ * Print all the bindings a worker would have access to.
+ * Accepts the flat binding record used by StartDevWorkerInput["bindings"].
+ */
+declare function printBindings(bindings: Record<string, Binding> | undefined, options: PrintBindingsOptions): void;
+
 /**
  * Environment variables supported by Wrangler for configuration and authentication.
  * Each variable is documented with its individual JSDoc comment below.
@@ -672,85 +691,6 @@ declare function getEnvironmentVariableFactory<Choices extends readonly string[]
     readonly choices?: Choices;
 }): () => ElementType<Choices>;
 
-type YYYY = `${number}${number}${number}${number}`;
-type MM = `${number}${number}`;
-type DD = `${number}${number}`;
-/**
- * Represents a valid compatibility date, a string such as `2025-09-27`
- */
-type CompatDate = `${YYYY}-${MM}-${DD}`;
-/**
- * Discern whether a string represents a compatibility date (`YYYY-MM-DD`)
- *
- * @param str The target string
- * @returns true if the string represents a compatibility date, false otherwise
- */
-declare function isCompatDate(str: string): str is CompatDate;
-/**
- * Returns today's date as a compatibility date string (`YYYY-MM-DD`).
- */
-declare function getTodaysCompatDate(): CompatDate;
-/**
- * The compatibility date on which the `nodejs_compat` and `nodejs_compat_v2`
- * compatibility flags became enabled by default in workerd.
- *
- * From this date onwards, specifying either flag explicitly is a validation
- * error ("The compatibility flag nodejs_compat became the default as of
- * 2026-08-04 so does not need to be specified anymore"), so tooling must not
- * add them to configurations using such a compatibility date.
- *
- * @see https://github.com/cloudflare/workerd/blob/main/src/workerd/io/compatibility-date.capnp
- */
-declare const NODEJS_COMPAT_DEFAULT_ON_DATE = "2026-08-04";
-/**
- * Whether workerd enables Node.js compatibility by default for the given
- * compatibility date, i.e. without the `nodejs_compat` flag being specified.
- *
- * @param compatibilityDate The compatibility date to check
- * @returns true if the date is on or after {@link NODEJS_COMPAT_DEFAULT_ON_DATE}
- */
-declare function isNodejsCompatDefaultOn(compatibilityDate: string | undefined): boolean;
-/**
- * The compatibility date on which `nodejs_compat` started implying
- * `nodejs_compat_v2`.
- */
-declare const NODEJS_COMPAT_V2_SWITCH_OVER_DATE = "2024-09-23";
-/**
- * Resolves whether workerd will enable the `nodejs_compat` and
- * `nodejs_compat_v2` features, mirroring how workerd itself resolves them from
- * the compatibility date and flags:
- * - Both are enabled by default from {@link NODEJS_COMPAT_DEFAULT_ON_DATE}
- *   onwards, and each must be turned off separately from that date, with
- *   `no_nodejs_compat` and `no_nodejs_compat_v2` respectively.
- * - Before that date, `nodejs_compat` implies `nodejs_compat_v2` from
- *   {@link NODEJS_COMPAT_V2_SWITCH_OVER_DATE} onwards.
- *
- * @param compatibilityDate The compatibility date
- * @param compatibilityFlags The compatibility flags
- */
-declare function resolveNodejsCompat(compatibilityDate: string, compatibilityFlags: string[]): {
-    isNodejsCompatEnabled: boolean;
-    isNodejsCompatV2Enabled: boolean;
-};
-/**
- * Removes the `nodejs_compat` and `nodejs_compat_v2` flags from a list of
- * compatibility flags when the compatibility date already enables them.
- *
- * workerd rejects a compatibility flag that its compatibility date enables by
- * default, so from {@link NODEJS_COMPAT_DEFAULT_ON_DATE} onwards specifying
- * either flag stops a Worker from starting up. Removing them is a no-op for
- * such a date, so tooling can accept the redundant flags rather than failing.
- *
- * A flag is kept when its matching opt-out is specified too, since workerd
- * reports those as contradictory and the enable flag wins there - dropping it
- * would silently switch Node.js compatibility off instead.
- *
- * @param compatibilityDate The compatibility date
- * @param compatibilityFlags The compatibility flags
- * @returns The flags, without the ones the date makes redundant
- */
-declare function stripRedundantNodejsCompatFlags(compatibilityDate: string | undefined, compatibilityFlags: string[]): string[];
-
 /**
  * The compatibility date to use when the user has not specified one.
  *
@@ -979,6 +919,162 @@ declare function isCI(): boolean;
  */
 declare function openInBrowser(url: string, logger: Logger): Promise<void>;
 
+/**
+ * Write an entry to the output file.
+ *
+ * Control whether (and where) to write this file by setting either
+ * `WRANGLER_OUTPUT_FILE_DIRECTORY` or `WRANGLER_OUTPUT_FILE_PATH`.
+ *
+ * @param entry The structured output entry to append.
+ * @returns Nothing.
+ */
+declare function writeOutput(entry: OutputEntry): void;
+/**
+ * Clear the cached output file path.
+ *
+ * @returns Nothing.
+ */
+declare function clearOutputFilePath(): void;
+interface OutputEntryBase<T extends string> {
+    version: number;
+    type: T;
+}
+interface OutputEntryBundleSize {
+    /** The uncompressed size of the Worker bundle. */
+    raw_bytes: number;
+    /** The gzip-compressed size of the Worker bundle. */
+    gzip_bytes: number;
+}
+/**
+ * All the different types of entry that can be written to the output file.
+ */
+type OutputEntry = OutputEntrySession | OutputEntryDeployment | OutputEntryPreview | OutputEntryPagesDeployment | OutputEntryVersionUpload | OutputEntryVersionDeployment | OutputEntryPagesDeploymentDetailed | OutputEntryCommandFailed | OutputEntryAutoConfig;
+interface OutputEntrySession extends OutputEntryBase<"wrangler-session"> {
+    version: 1;
+    /** The semver version string taken from Wrangler's package.json. */
+    wrangler_version: string;
+    /** The arguments passed to Wrangler. */
+    command_line_args: string[];
+    /** The absolute path to a file that contains debug logs for this Wrangler instance. */
+    log_file_path: string;
+}
+interface OutputEntryDeployment extends OutputEntryBase<"deploy"> {
+    version: 1;
+    /** The name of the Worker. */
+    worker_name: string | null;
+    /** The GUID that identifies the Worker. This never changes even if the name is changed. */
+    worker_tag: string | null;
+    /** A GUID that identifies this deployed version of the Worker. This version is associated with an automatically created deployment, with this version set at 100%. */
+    version_id: string | null;
+    /** A list of URLs that represent the HTTP triggers associated with this deployment */
+    targets: string[] | undefined;
+    /** set if the worker's name was overridden */
+    worker_name_overridden: boolean;
+    /** wrangler environment used */
+    wrangler_environment: string | undefined;
+    /** Exact Worker bundle sizes in bytes. */
+    bundle_size?: OutputEntryBundleSize;
+}
+interface OutputEntryPreview extends OutputEntryBase<"preview"> {
+    version: 1;
+    /** The name of the Worker. */
+    worker_name: string | null;
+    /** The ID of the Preview resource. */
+    preview_id: string;
+    /** The human-readable name of the Preview resource. */
+    preview_name: string;
+    /** The slug of the Preview resource. */
+    preview_slug: string;
+    /** A list of URLs associated with the Preview resource. */
+    preview_urls: string[] | undefined;
+    /** The ID of the Preview deployment resource. */
+    deployment_id: string;
+    /** A list of URLs associated with the Preview deployment. */
+    deployment_urls: string[] | undefined;
+}
+interface OutputEntryAutoConfig extends OutputEntryBase<"autoconfig"> {
+    version: 1;
+    /** The command that triggered autoconfig */
+    command: "setup" | "deploy";
+    /** The summary of the autoconfig process */
+    summary: {
+        wranglerConfig?: {
+            name?: string;
+            compatibility_date?: string;
+        };
+        [key: string]: unknown;
+    };
+}
+interface OutputEntryPagesDeployment extends OutputEntryBase<"pages-deploy"> {
+    version: 1;
+    /** The name of the Pages project. */
+    pages_project: string | null;
+    /** A GUID that identifies this Pages deployment. */
+    deployment_id: string | null;
+    /** The URL associated with this deployment */
+    url: string | undefined;
+}
+interface OutputEntryPagesDeploymentDetailed extends OutputEntryBase<"pages-deploy-detailed"> {
+    version: 1;
+    /** The name of the Pages project. */
+    pages_project: string | null;
+    /** A GUID that identifies this Pages deployment. */
+    deployment_id: string | null;
+    /** The URL associated with this deployment */
+    url: string | undefined;
+    /** The Alias url, if it exists */
+    alias: string | undefined;
+    /** The environment being deployed to */
+    environment: "production" | "preview";
+    /** The production branch of the pages project */
+    production_branch: string;
+    deployment_trigger: {
+        metadata: {
+            /** Commit hash of the deployment trigger metadata for the pages project */
+            commit_hash: string;
+        };
+    };
+}
+interface OutputEntryVersionUpload extends OutputEntryBase<"version-upload"> {
+    version: 1;
+    /** The name of the Worker. */
+    worker_name: string | null;
+    /** The GUID that identifies the Worker. This never changes even if the name is changed. */
+    worker_tag: string | null;
+    /** A GUID that identifies this uploaded, but not yet deployed, version of the Worker. This version will need to be "deployed" to receive traffic. */
+    version_id: string | null;
+    /** The preview URL associated with this version upload */
+    preview_url: string | undefined;
+    /** The ephemeral aliased preview URL associated with this version upload */
+    preview_alias_url: string | undefined;
+    /** set if the worker's name was overridden */
+    worker_name_overridden: boolean;
+    /** wrangler environment used */
+    wrangler_environment: string | undefined;
+    /** Exact Worker bundle sizes in bytes. */
+    bundle_size?: OutputEntryBundleSize;
+}
+interface OutputEntryVersionDeployment extends OutputEntryBase<"version-deploy"> {
+    version: 1;
+    /** The name of the Worker. */
+    worker_name: string | null;
+    /** The GUID that identifies the Worker. This never changes even if the name is changed. */
+    worker_tag: string | null;
+    /** The ID of the gradual rollout deployment. */
+    deployment_id: string;
+    /** The percentage of traffic that goes to each version. */
+    version_traffic: Map<string, number>;
+}
+interface OutputEntryCommandFailed extends OutputEntryBase<"command-failed"> {
+    version: 1;
+    /** The code in the error. */
+    code: number | undefined;
+    /** The message in the error. */
+    message: string | undefined;
+    /** How many milliseconds to retry the operation after if available. */
+    retry_after_ms: number | undefined;
+}
+
 declare function retryOnAPIFailure<T>(action: () => T | Promise<T>, logger: Logger, backoff?: number, attempts?: number, abortSignal?: AbortSignal): Promise<T>;
 
 declare function formatTime(duration: number): string;
@@ -1139,9 +1235,6 @@ declare function getWorkerName(projectOrWorkerName: string | undefined, projectP
  */
 declare function getWorkerNameFromProject(projectPath: string): string;
 
-declare function _forceColour(enabled?: boolean): void;
-declare function formatZodError(error: z.ZodError, input: unknown): string;
-
 type DiscriminatedPath<Discriminator extends string> = string & {
     _discriminator: Discriminator;
 };
@@ -1167,4 +1260,4 @@ declare function toUrlPath(filePath: string): UrlPath;
  */
 declare const friendlyBindingNames: Record<ConfigBindingFieldName, string>;
 
-export { APIError, Binding, type BindingLocalSupport, BunPackageManager, CommandLineArgsError, type CompatDate, Config, type ConfigBindingFieldName, type ConfigBindingOptions, type ConfigCache, type ConfigCacheOptions, ContainerApp, DEFAULT_COMPAT_DATE, DeprecationError, Diagnostics, DurableObjectExport, type EphemeralDirectory, type ExportType, Exports, FatalError, JsonFriendlyFatalError, type Location, Logger, type Message, MissingConfigError, NODEJS_COMPAT_DEFAULT_ON_DATE, NODEJS_COMPAT_V2_SWITCH_OVER_DATE, type NormalizeAndValidateConfigArgs, NpmPackageManager, type NpmVersionCheckResult, NubPackageManager, type PackageJSON, type PackageManager, ParseError, type ParseFile, type PartitionedExports, PatchConfigError, PnpmPackageManager, RawConfig, type ResolveConfigPathOptions, Route, type TelemetryMessage, type Tunnel, type TunnelOptions, type UrlPath, UserError, WorkerEntrypointExport, WorkerMetadataBinding, YarnPackageManager, _forceColour, assertNever, bucketFormatMessage, checkWorkerNameValidity, configFileName, configFormat, createConfigCache, createFatalError, experimental_patchConfig, experimental_readRawConfig, fetchLatestNpmVersion, findWranglerConfig, formatConfigSnippet, formatTime, formatZodError, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getContainerDurableObjectClassNames, getContainerNameToClassNameMap, getDurableObjectExports, getEnvironmentVariableFactory, getHostFromRoute, getHostFromUrl, getInstalledPackageVersion, getPackagePath, getTodaysCompatDate, getWorkerName, getWorkerNameFromProject, getWranglerHiddenDirPath, getWranglerTmpDir, getZoneFromRoute, hasDurableObjectExports, hasProperty, indexLocation, isCI, isCompatDate, isDockerfile, isInteractive, isNodejsCompatDefaultOn, isNonInteractiveOrCI, isOptionalProperty, isPackageInstalled, isPagesConfig, isRedirectedConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, openInBrowser, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, partitionExports, readFileSync, readFileSyncToBuffer, resolveContainerClassName, resolveNodejsCompat, resolveWranglerConfigPath, retryOnAPIFailure, searchLocation, spawnCloudflared, startTunnel, stripRedundantNodejsCompatFlags, sweepStaleWranglerTmpDirs, toUrlPath, toValidWorkerName, validatePagesConfig };
+export { APIError, Binding, type BindingLocalSupport, BunPackageManager, CfTailConsumer, CompatDate, Config, type ConfigBindingFieldName, type ConfigBindingOptions, type ConfigCache, type ConfigCacheOptions, ContainerApp, type ConvertBindingsOptions, DEFAULT_COMPAT_DATE, Diagnostics, DurableObjectExport, type EphemeralDirectory, type ExportType, Exports, type Location, Logger, type Message, type NormalizeAndValidateConfigArgs, NpmPackageManager, type NpmVersionCheckResult, NubPackageManager, type OutputEntry, type PackageJSON, type PackageManager, ParseError, type ParseFile, type PartitionedExports, PatchConfigError, PnpmPackageManager, type PrintBindingsOptions, RawConfig, type ResolveConfigPathOptions, Route, TelemetryMessage, type Tunnel, type TunnelOptions, type UrlPath, UserError, WorkerEntrypointExport, WorkerMetadataBinding, YarnPackageManager, assertNever, bucketFormatMessage, checkWorkerNameValidity, clearOutputFilePath, configFileName, configFormat, convertConfigToBindings, createConfigCache, experimental_patchConfig, experimental_readRawConfig, extractBindingsOfType, fetchLatestNpmVersion, findWranglerConfig, formatConfigSnippet, formatTime, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBindings, getBooleanEnvironmentVariableFactory, getContainerDurableObjectClassNames, getContainerNameToClassNameMap, getDurableObjectExports, getEnvironmentVariableFactory, getHostFromRoute, getHostFromUrl, getInstalledPackageVersion, getPackagePath, getWorkerName, getWorkerNameFromProject, getWranglerHiddenDirPath, getWranglerTmpDir, getZoneFromRoute, hasDurableObjectExports, hasProperty, indexLocation, isCI, isDockerfile, isInteractive, isNonInteractiveOrCI, isOptionalProperty, isPackageInstalled, isPagesConfig, isRedirectedConfig, isRequiredProperty, isUnsafeBindingType, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, openInBrowser, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, partitionExports, printBindings, readFileSync, readFileSyncToBuffer, resolveContainerClassName, resolveWranglerConfigPath, retryOnAPIFailure, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, toUrlPath, toValidWorkerName, validateBindingRemoteSetting, validatePagesConfig, writeOutput };