@cloudflare/workers-utils 0.26.0 → 0.28.0

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { T as TailConsumer, aK as WorkerMetadata, R as RawConfig } from './config-D5W7gaPI.mjs';
+import { T as TailConsumer, aK as WorkerMetadata, R as RawConfig } from './config-BadLPAp8.mjs';
 import { AssetConfig } from '@cloudflare/workers-shared';
 import { Cloudflare } from 'cloudflare';
 import 'node:url';

package/dist/browser.mjs

@@ -1,2 +1,2 @@
-export { constructWranglerConfig } from './chunk-ELQRF72O.mjs';
-import './chunk-DDRU76YD.mjs';
+export { constructWranglerConfig } from './chunk-J6JRMPLM.mjs';
+import './chunk-Q72B4Q5Z.mjs';

package/dist/{chunk-OTBYAUQ6.mjs → chunk-34VZWBGB.mjs}

@@ -1,5 +1,5 @@
-import { isDirectory } from './chunk-OC543JY3.mjs';
-import { __name } from './chunk-DDRU76YD.mjs';
+import { isDirectory } from './chunk-53IMCORZ.mjs';
+import { __name } from './chunk-Q72B4Q5Z.mjs';
 import os from 'node:os';
 import path from 'node:path';
 

package/dist/{chunk-OC543JY3.mjs → chunk-53IMCORZ.mjs}

@@ -1,4 +1,4 @@
-import { __name } from './chunk-DDRU76YD.mjs';
+import { __name } from './chunk-Q72B4Q5Z.mjs';
 import fs from 'node:fs';
 
 function isDirectory(path) {

package/dist/{chunk-ELQRF72O.mjs → chunk-J6JRMPLM.mjs}

@@ -1,4 +1,4 @@
-import { __name } from './chunk-DDRU76YD.mjs';
+import { __name } from './chunk-Q72B4Q5Z.mjs';
 import assert from 'node:assert';
 
 function isCompatDate(str) {

package/dist/{chunk-DDRU76YD.mjs → chunk-Q72B4Q5Z.mjs}

@@ -14,6 +14,10 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 var __commonJS = (cb, mod) => function __require2() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -31,4 +35,4 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-export { __commonJS, __name, __require, __toESM };
+export { __commonJS, __export, __name, __require, __toESM };

package/dist/{chunk-27EBTAT2.mjs → chunk-Y3JVLYM6.mjs}

@@ -1,4 +1,4 @@
-import { __name } from './chunk-DDRU76YD.mjs';
+import { __name } from './chunk-Q72B4Q5Z.mjs';
 import { readFileSync as readFileSync$1, statSync, existsSync } from 'node:fs';
 import path, { resolve, isAbsolute, dirname, join } from 'node:path';
 
@@ -2702,17 +2702,29 @@ __name(up, "up");
 
 // ../../node_modules/.pnpm/empathic@2.0.0/node_modules/empathic/find.mjs
 function file(name, options) {
-  let dir, tmp;
+  let dir2, tmp;
   let start = options && options.cwd || "";
-  for (dir of up(start, options)) {
+  for (dir2 of up(start, options)) {
     try {
-      tmp = join(dir, name);
+      tmp = join(dir2, name);
       if (statSync(tmp).isFile()) return tmp;
     } catch {
     }
   }
 }
 __name(file, "file");
+function dir(name, options) {
+  let dir2, tmp;
+  let start = options && options.cwd || "";
+  for (dir2 of up(start, options)) {
+    try {
+      tmp = join(dir2, name);
+      if (statSync(tmp).isDirectory()) return tmp;
+    } catch {
+    }
+  }
+}
+__name(dir, "dir");
 
 // ../../node_modules/.pnpm/ts-dedent@2.2.0/node_modules/ts-dedent/esm/index.js
 function dedent(templ) {
@@ -3179,4 +3191,4 @@ smol-toml/dist/index.js:
    *)
 */
 
-export { APIError, CommandLineArgsError, DeprecationError, ENVIRONMENT_TAG_PREFIX, FatalError, INHERIT_SYMBOL, JSON_CONFIG_FORMATS, JsonFriendlyFatalError, MissingConfigError, PATH_TO_DEPLOY_CONFIG, ParseError, SERVICE_TAG_PREFIX, UserError, applyEdits, configFileName, configFormat, createFatalError, dedent, dist_default, experimental_readRawConfig, findWranglerConfig, format2 as format, formatConfigSnippet, indexLocation, isRedirectedConfig, isRedirectedRawConfig, modify, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, partitionExports, readFileSync, readFileSyncToBuffer, resolveWranglerConfigPath, searchLocation };
+export { APIError, CommandLineArgsError, DeprecationError, ENVIRONMENT_TAG_PREFIX, FatalError, INHERIT_SYMBOL, JSON_CONFIG_FORMATS, JsonFriendlyFatalError, MissingConfigError, PATH_TO_DEPLOY_CONFIG, ParseError, SERVICE_TAG_PREFIX, UserError, applyEdits, configFileName, configFormat, createFatalError, dedent, dir, dist_default, experimental_readRawConfig, findWranglerConfig, format2 as format, formatConfigSnippet, indexLocation, isRedirectedConfig, isRedirectedRawConfig, modify, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, partitionExports, readFileSync, readFileSyncToBuffer, resolveWranglerConfigPath, searchLocation };

package/dist/{chunk-TJ6ANXA2.mjs → chunk-Z62CVNHJ.mjs}

@@ -1,4 +1,4 @@
-import { __name } from './chunk-DDRU76YD.mjs';
+import { __name } from './chunk-Q72B4Q5Z.mjs';
 
 // src/prometheus-metrics.ts
 var MetricsRegistry = class {

package/dist/{config-D5W7gaPI.d.mts → config-BadLPAp8.d.mts}

@@ -286,6 +286,7 @@ type Logger = {
         warn: typeof console.warn;
         error: typeof console.error;
     };
+    console?<M extends Exclude<keyof Console, "Console">>(method: M, ...args: Parameters<Console[M]>): void;
 };
 
 type ApiCredentials = {
@@ -530,7 +531,7 @@ interface CfWorkflow {
 }
 interface CfQueue {
     binding: string;
-    queue_name: string;
+    queue_name?: string | typeof INHERIT_SYMBOL;
     delivery_delay?: number;
     remote?: boolean;
     raw?: boolean;
@@ -595,7 +596,7 @@ interface CfHelloWorld {
 }
 interface CfFlagship {
     binding: string;
-    app_id: string;
+    app_id?: string | typeof INHERIT_SYMBOL;
     remote?: boolean;
 }
 interface CfWorkerLoader {
@@ -659,7 +660,7 @@ interface CfAnalyticsEngineDataset {
 }
 interface CfDispatchNamespace {
     binding: string;
-    namespace: string;
+    namespace?: string | typeof INHERIT_SYMBOL;
     outbound?: {
         service: string;
         environment?: string;
@@ -811,7 +812,6 @@ interface CfWorkerInit {
 }
 interface CfWorkerContext {
     env: string | undefined;
-    useServiceEnvironments: boolean | undefined;
     zone: string | undefined;
     host: string | undefined;
     routes: Route[] | undefined;
@@ -1519,7 +1519,6 @@ interface StartDevWorkerInput {
     };
     legacy?: {
         site?: Hook<Config["site"], [Config]>;
-        useServiceEnvironments?: boolean;
     };
     unsafe?: Omit<CfUnsafe, "bindings">;
     assets?: string;
@@ -1552,7 +1551,7 @@ type Entry = {
 /**
  * Wrangler configuration types. The JSDoc on these fields is also the source
  * of truth for the equivalent fields in `@cloudflare/config`
- * (`packages/config/src/types.ts` — `UserConfig` — and the binding option
+ * (`packages/config/src/types.ts` — `WorkerConfig` — and the binding option
  * interfaces in `packages/config/src/config.ts`). When editing prose here,
  * mirror the changes there.
  */
@@ -2438,7 +2437,7 @@ interface EnvironmentNonInheritable {
             /** The binding name used to refer to the Queue in the Worker. */
             binding: string;
             /** The name of this Queue. */
-            queue: string;
+            queue?: string;
             /** The number of seconds to wait before delivering a message */
             delivery_delay?: number;
             /** Whether the Queue producer should be remote or not in local development */
@@ -2865,7 +2864,7 @@ interface EnvironmentNonInheritable {
         /** The binding name used to refer to the bound service. */
         binding: string;
         /** The namespace to bind to. */
-        namespace: string;
+        namespace?: string;
         /** Details about the outbound Worker which will handle outbound requests from your namespace */
         outbound?: DispatchNamespaceOutbound;
         /** Whether the Dispatch Namespace should be remote or not in local development */
@@ -2956,7 +2955,7 @@ interface EnvironmentNonInheritable {
         /** The binding name used to refer to the bound Flagship service. */
         binding: string;
         /** The Flagship app ID to bind to. */
-        app_id: string;
+        app_id?: string;
         /** Set to `true` to suppress the remote binding warning in local dev. Flagship bindings are always remote. */
         remote?: boolean;
     }[];
@@ -3213,13 +3212,6 @@ interface ComputedFields {
     targetEnvironment: string | undefined;
 }
 interface ConfigFields<Dev extends RawDevConfig> {
-    /**
-     * A boolean to enable "legacy" style wrangler environments (from Wrangler v1).
-     * These have been superseded by Services, but there may be projects that won't
-     * (or can't) use them. If you're using a legacy environment, you can set this
-     * to `true` to enable it.
-     */
-    legacy_env: boolean;
     /**
      * Whether Wrangler should send usage metrics to Cloudflare for this project.
      *
@@ -3244,6 +3236,15 @@ interface ConfigFields<Dev extends RawDevConfig> {
     dependencies_instrumentation: {
         /** Whether dependency instrumentation is enabled. Defaults to `true`. */
         enabled: boolean;
+        /**
+         * An optional list of package name patterns to exclude from the
+         * collected dependency metadata.
+         *
+         * Each entry can be an exact package name (e.g. `"lodash"`) or a glob
+         * pattern using `*` as a wildcard (e.g. `"@internal/*"` to exclude all
+         * packages under the `@internal` scope).
+         */
+        exclude_packages?: string[];
     } | undefined;
     /**
      * Options to configure the development server that your worker will use.
@@ -3339,6 +3340,19 @@ interface ConfigFields<Dev extends RawDevConfig> {
      * @nonInheritable
      */
     keep_vars?: boolean;
+    /**
+     * The inbound email addresses handled by the Worker being deployed.
+     *
+     * Each entry is a literal recipient address (e.g. `"support@example.com"`)
+     * or a `*@domain` catch-all (e.g. `"*@example.com"`). Every entry creates an
+     * Email Routing rule whose action routes mail to this Worker.
+     *
+     * This field is top-level only and applies to every environment of the
+     * Worker; it cannot be set under `env.*`.
+     *
+     * @nonInheritable
+     */
+    addresses?: string[];
 }
 interface PagesConfigFields {
     /**

package/dist/fs-helpers.mjs

@@ -1,2 +1,2 @@
-export { isDirectory, removeDir, removeDirSync } from './chunk-OC543JY3.mjs';
-import './chunk-DDRU76YD.mjs';
+export { isDirectory, removeDir, removeDirSync } from './chunk-53IMCORZ.mjs';
+import './chunk-Q72B4Q5Z.mjs';

package/dist/global-wrangler-config-path.mjs

@@ -1,3 +1,3 @@
-export { getGlobalConfigPath, getGlobalWranglerCachePath } from './chunk-OTBYAUQ6.mjs';
-import './chunk-OC543JY3.mjs';
-import './chunk-DDRU76YD.mjs';
+export { getGlobalConfigPath, getGlobalWranglerCachePath } from './chunk-34VZWBGB.mjs';
+import './chunk-53IMCORZ.mjs';
+import './chunk-Q72B4Q5Z.mjs';

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as ComputedFields, B as Binding, R as RawConfig, b as Config, E as Exports, D as DurableObjectExport, W as WorkerEntrypointExport, c as WorkerMetadataBinding, L as Logger, d as Route } from './config-D5W7gaPI.mjs';
-export { bK as ApiCredentials, aG as AssetConfigMetadata, A as Assets, aH as AssetsOptions, a$ as AsyncHook, aW as BinaryFile, be as COMPLIANCE_REGION_CONFIG_PUBLIC, bf as COMPLIANCE_REGION_CONFIG_UNKNOWN, y as CacheOptions, X as CfAIBinding, a9 as CfAISearch, a8 as CfAISearchNamespace, aY as CfAccount, ab as CfAgentMemory, an as CfAnalyticsEngineDataset, ad as CfArtifacts, as as CfAssetsBinding, V as CfBrowserBinding, av as CfCapnp, a6 as CfD1Database, a1 as CfDataBlobBindings, aj as CfDevPluginCfg, ao as CfDispatchNamespace, a2 as CfDurableObject, ax as CfDurableObjectMigrations, ay as CfExports, af as CfFlagship, ae as CfHelloWorld, ai as CfHyperdrive, Y as CfImagesBinding, K as CfKvNamespace, aq as CfLogfwdr, ar as CfLogfwdrBinding, ap as CfMTlsCertificate, _ as CfMediaBinding, I as CfModule, H as CfModuleType, at as CfPipeline, az as CfPlacement, a4 as CfQueue, a5 as CfR2Bucket, ah as CfRateLimit, G as CfScriptFormat, ac as CfSecretsStoreSecrets, M as CfSendEmailBindings, ak as CfService, $ as CfStreamBinding, aA as CfTailConsumer, Q as CfTextBlobBindings, aw as CfUnsafe, au as CfUnsafeBinding, aB as CfUserLimits, J as CfVars, a7 as CfVectorize, a0 as CfVersionMetadataBinding, am as CfVpcNetwork, al as CfVpcService, N as CfWasmModuleBindings, aa as CfWebSearch, aD as CfWorkerContext, aC as CfWorkerInit, ag as CfWorkerLoader, aE as CfWorkerSourceMap, a3 as CfWorkflow, n as CloudchamberConfig, bd as ComplianceConfig, f as ConfigFields, w as ConfigModuleRuleType, r as ConfiguredExport, o as ContainerApp, F as ContainerEngine, m as CustomDomainRoute, x as DispatchNamespaceOutbound, z as DockerConfiguration, s as DurableObjectBindings, q as DurableObjectExportStorage, p as DurableObjectMigration, b6 as ENVIRONMENT_TAG_PREFIX, b3 as Entry, k as Environment, u as EnvironmentNonInheritable, aL as ExportsReconciliationEntryBase, aO as ExportsReconciliationErrorDetail, aM as ExportsReconciliationInfo, aP as ExportsReconciliationRename, aS as ExportsReconciliationResult, aQ as ExportsReconciliationTransfer, aR as ExportsReconciliationTransferPending, aN as ExportsReconciliationWarning, c0 as FetchKVGetValueFetcher, bN as FetchListResultFetcher, bO as FetchPagedListResultFetcher, bL as FetchResult, bM as FetchResultFetcher, aV as File, a_ as Hook, aZ as HookValues, b4 as INHERIT_SYMBOL, b8 as JSON_CONFIG_FORMATS, aF as Json, i as LOGGER_LEVELS, aJ as LegacyAssetPaths, b0 as LogLevel, j as LoggerLevel, b1 as NodeJSCompatMode, O as Observability, b7 as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, e as RawDevConfig, g as RawEnvironment, a as RedirectedRawConfig, v as Rule, b5 as SERVICE_TAG_PREFIX, aU as ServiceFetch, aT as ServiceMetadataRes, b2 as StartDevWorkerInput, S as StreamingTailConsumer, T as TailConsumer, aX as Trigger, U as UserLimits, aI as ValidatedAssetsOptions, aK as WorkerMetadata, t as WorkflowBinding, Z as ZoneIdRoute, l as ZoneNameRoute, bZ as addAuthorizationHeader, h as defaultWranglerConfig, bW as extractAccountTag, bV as extractWAFBlockRayId, bQ as fetchInternalBase, b$ as fetchKVGetValueBase, bS as fetchListResultBase, bR as fetchResultBase, bF as getBrowserRenderingHeadfulFromEnv, br as getBuildConditionsFromEnv, bs as getBuildPlatformFromEnv, b9 as getC3CommandFromEnv, bp as getCIGeneratePreviewAlias, bm as getCIMatchTag, bn as getCIOverrideName, bo as getCIOverrideNetworkModeHost, bG as getCfFetchEnabledFromEnv, bH as getCfFetchPathFromEnv, bh as getCloudflareApiBaseUrl, bc as getCloudflareApiEnvironmentFromEnv, bg as getCloudflareComplianceRegion, bC as getCloudflareEnv, by as getCloudflareIncludeProcessEnvFromEnv, bx as getCloudflareLoadDevVarsFromDotEnv, bJ as getCloudflaredPathFromEnv, bi as getComplianceRegionSubdomain, bu as getD1ExtraLocationChoices, bA as getDisableConfigWatching, bv as getDockerPath, bE as getLocalExplorerEnabledFromEnv, bD as getOpenNextDeployFromEnv, bk as getOutputFileDirectoryFromEnv, bl as getOutputFilePathFromEnv, bt as getRegistryPath, bj as getSanitizeLogs, bw as getSubdomainMixedStateCheckDisabled, bz as getTraceHeader, bq as getWorkersCIBranchName, bI as getWranglerCacheDirFromEnv, bB as getWranglerHideBanner, bb as getWranglerSendErrorReportsFromEnv, ba as getWranglerSendMetricsFromEnv, c1 as hasCursor, bX as hasMorePages, bU as isWAFBlockResponse, c2 as maybeAddTraceHeader, bP as performApiFetchBase, bY as renderError, b_ as throwFetchError, bT as truncate } from './config-D5W7gaPI.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 WorkerMetadataBinding, L as Logger, d as Route } from './config-BadLPAp8.mjs';
+export { bK as ApiCredentials, aG as AssetConfigMetadata, A as Assets, aH as AssetsOptions, a$ as AsyncHook, aW as BinaryFile, be as COMPLIANCE_REGION_CONFIG_PUBLIC, bf as COMPLIANCE_REGION_CONFIG_UNKNOWN, y as CacheOptions, X as CfAIBinding, a9 as CfAISearch, a8 as CfAISearchNamespace, aY as CfAccount, ab as CfAgentMemory, an as CfAnalyticsEngineDataset, ad as CfArtifacts, as as CfAssetsBinding, V as CfBrowserBinding, av as CfCapnp, a6 as CfD1Database, a1 as CfDataBlobBindings, aj as CfDevPluginCfg, ao as CfDispatchNamespace, a2 as CfDurableObject, ax as CfDurableObjectMigrations, ay as CfExports, af as CfFlagship, ae as CfHelloWorld, ai as CfHyperdrive, Y as CfImagesBinding, K as CfKvNamespace, aq as CfLogfwdr, ar as CfLogfwdrBinding, ap as CfMTlsCertificate, _ as CfMediaBinding, I as CfModule, H as CfModuleType, at as CfPipeline, az as CfPlacement, a4 as CfQueue, a5 as CfR2Bucket, ah as CfRateLimit, G as CfScriptFormat, ac as CfSecretsStoreSecrets, M as CfSendEmailBindings, ak as CfService, $ as CfStreamBinding, aA as CfTailConsumer, Q as CfTextBlobBindings, aw as CfUnsafe, au as CfUnsafeBinding, aB as CfUserLimits, J as CfVars, a7 as CfVectorize, a0 as CfVersionMetadataBinding, am as CfVpcNetwork, al as CfVpcService, N as CfWasmModuleBindings, aa as CfWebSearch, aD as CfWorkerContext, aC as CfWorkerInit, ag as CfWorkerLoader, aE as CfWorkerSourceMap, a3 as CfWorkflow, n as CloudchamberConfig, bd as ComplianceConfig, f as ConfigFields, w as ConfigModuleRuleType, r as ConfiguredExport, o as ContainerApp, F as ContainerEngine, m as CustomDomainRoute, x as DispatchNamespaceOutbound, z as DockerConfiguration, s as DurableObjectBindings, q as DurableObjectExportStorage, p as DurableObjectMigration, b6 as ENVIRONMENT_TAG_PREFIX, b3 as Entry, k as Environment, u as EnvironmentNonInheritable, aL as ExportsReconciliationEntryBase, aO as ExportsReconciliationErrorDetail, aM as ExportsReconciliationInfo, aP as ExportsReconciliationRename, aS as ExportsReconciliationResult, aQ as ExportsReconciliationTransfer, aR as ExportsReconciliationTransferPending, aN as ExportsReconciliationWarning, c0 as FetchKVGetValueFetcher, bN as FetchListResultFetcher, bO as FetchPagedListResultFetcher, bL as FetchResult, bM as FetchResultFetcher, aV as File, a_ as Hook, aZ as HookValues, b4 as INHERIT_SYMBOL, b8 as JSON_CONFIG_FORMATS, aF as Json, i as LOGGER_LEVELS, aJ as LegacyAssetPaths, b0 as LogLevel, j as LoggerLevel, b1 as NodeJSCompatMode, O as Observability, b7 as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, e as RawDevConfig, g as RawEnvironment, a as RedirectedRawConfig, v as Rule, b5 as SERVICE_TAG_PREFIX, aU as ServiceFetch, aT as ServiceMetadataRes, b2 as StartDevWorkerInput, S as StreamingTailConsumer, T as TailConsumer, aX as Trigger, U as UserLimits, aI as ValidatedAssetsOptions, aK as WorkerMetadata, t as WorkflowBinding, Z as ZoneIdRoute, l as ZoneNameRoute, bZ as addAuthorizationHeader, h as defaultWranglerConfig, bW as extractAccountTag, bV as extractWAFBlockRayId, bQ as fetchInternalBase, b$ as fetchKVGetValueBase, bS as fetchListResultBase, bR as fetchResultBase, bF as getBrowserRenderingHeadfulFromEnv, br as getBuildConditionsFromEnv, bs as getBuildPlatformFromEnv, b9 as getC3CommandFromEnv, bp as getCIGeneratePreviewAlias, bm as getCIMatchTag, bn as getCIOverrideName, bo as getCIOverrideNetworkModeHost, bG as getCfFetchEnabledFromEnv, bH as getCfFetchPathFromEnv, bh as getCloudflareApiBaseUrl, bc as getCloudflareApiEnvironmentFromEnv, bg as getCloudflareComplianceRegion, bC as getCloudflareEnv, by as getCloudflareIncludeProcessEnvFromEnv, bx as getCloudflareLoadDevVarsFromDotEnv, bJ as getCloudflaredPathFromEnv, bi as getComplianceRegionSubdomain, bu as getD1ExtraLocationChoices, bA as getDisableConfigWatching, bv as getDockerPath, bE as getLocalExplorerEnabledFromEnv, bD as getOpenNextDeployFromEnv, bk as getOutputFileDirectoryFromEnv, bl as getOutputFilePathFromEnv, bt as getRegistryPath, bj as getSanitizeLogs, bw as getSubdomainMixedStateCheckDisabled, bz as getTraceHeader, bq as getWorkersCIBranchName, bI as getWranglerCacheDirFromEnv, bB as getWranglerHideBanner, bb as getWranglerSendErrorReportsFromEnv, ba as getWranglerSendMetricsFromEnv, c1 as hasCursor, bX as hasMorePages, bU as isWAFBlockResponse, c2 as maybeAddTraceHeader, bP as performApiFetchBase, bY as renderError, b_ as throwFetchError, bT as truncate } from './config-BadLPAp8.mjs';
 import * as jsoncParser from 'jsonc-parser';
 export { constructWranglerConfig } from './browser.mjs';
 export { GetGlobalConfigPathOptions, getGlobalConfigPath, getGlobalWranglerCachePath } from './global-wrangler-config-path.mjs';
@@ -102,7 +102,6 @@ declare function getBindingTypeFriendlyName(bindingType: Binding["type"]): strin
 type NormalizeAndValidateConfigArgs = {
     name?: string;
     env?: string;
-    "legacy-env"?: boolean;
     "dispatch-namespace"?: string;
     remote?: boolean;
     localProtocol?: string;
@@ -541,6 +540,8 @@ type VariableNames =
  | "WRANGLER_AUTH_URL"
 /** Custom OAuth client ID (usually auto-configured). */
  | "WRANGLER_CLIENT_ID"
+/** Custom OAuth client ID for the `cf` CLI's OAuth app (usually auto-configured). */
+ | "CLOUDFLARE_CLIENT_ID"
 /** Custom token URL (usually auto-configured). */
  | "WRANGLER_TOKEN_URL"
 /** Custom token revocation URL (usually auto-configured). */
@@ -648,6 +649,38 @@ declare function isCompatDate(str: string): str is CompatDate;
  */
 declare function getTodaysCompatDate(): CompatDate;
 
+/**
+ * A file-backed key/value cache scoped to a consumer's cache directory.
+ *
+ * The mechanism is generic (JSON blobs keyed by file name); the only
+ * consumer-specific input is the logger used for debug output, so the whole
+ * bundle is built by {@link createConfigCache}. Wrangler wraps this with its
+ * logger singleton in `src/config-cache.ts`; `@cloudflare/workers-auth` builds
+ * its own instance with the logger injected into `createWranglerAuth`.
+ */
+interface ConfigCache {
+    getCacheFolder: () => string;
+    getConfigCache: <T>(fileName: string) => Partial<T>;
+    saveToConfigCache: <T>(fileName: string, newValues: Partial<T>) => void;
+    purgeConfigCaches: () => void;
+}
+interface ConfigCacheOptions {
+    /**
+     * Namespace for the cache directory, so different Cloudflare CLIs get
+     * isolated caches (`<node_modules>/.cache/<namespace>` or
+     * `.<namespace>/cache`). Defaults to `"wrangler"` for backward compatibility.
+     *
+     * `purgeConfigCaches()` deletes the whole cache folder, so a non-default
+     * namespace also ensures e.g. `cf login`/`logout` never wipes wrangler's
+     * cache.
+     */
+    namespace?: string;
+}
+/**
+ * Build a file-backed config cache bound to the given logger.
+ */
+declare function createConfigCache(logger: Logger, options?: ConfigCacheOptions): ConfigCache;
+
 /**
  * A short-lived directory. Automatically removed when the process exits, but
  * can be removed earlier by calling `remove()`.
@@ -753,6 +786,76 @@ type NpmVersionCheckResult = {
  */
 declare function fetchLatestNpmVersion(name: string, version: string): Promise<NpmVersionCheckResult>;
 
+/**
+ * Returns whether the process can handle interactive input (e.g. hotkeys).
+ *
+ * A process is considered interactive when **both** conditions are met:
+ * - It is **not** running in a Cloudflare CI environment (Pages or Workers CI).
+ * - `stdin` and `stdout` are connected to a TTY (not piped from/to another process).
+ *
+ * Note: generic CI environments (e.g. GitHub Actions) do **not** disable interactivity,
+ * because a real PTY may still be attached and hotkeys should still work.
+ *
+ * Use this for features that require a TTY but should remain functional in generic CI:
+ * - Registering hotkeys (e.g. `x` to exit `wrangler dev`)
+ * - Enabling raw mode / keypress handling
+ * - Showing animated spinners or progress indicators
+ * - Reading secrets from an interactive prompt vs stdin
+ *
+ * Use {@link isNonInteractiveOrCI} instead when user input should be suppressed
+ * in **all** CI environments.
+ *
+ * @returns `true` if the process is interactive, `false` otherwise.
+ */
+declare function isInteractive(): boolean;
+/**
+ * Returns whether the process should not prompt the user.
+ *
+ * Returns `true` when the process is non-interactive (no TTY) **or** running
+ * in any CI environment (detected via `ci-info`). This is stricter than
+ * {@link isInteractive} which only checks for Cloudflare-specific CI,
+ * because user prompts should never appear in CI even when a PTY is attached.
+ *
+ * Use this for anything that should be suppressed or adapted in CI:
+ * - User prompts (confirmations, text input, select dialogs)
+ * - OAuth login flows
+ * - Output format decisions (JSON in CI, pretty when interactive)
+ * - Banner / decoration display
+ * - Redacting sensitive info (account names, emails) in CI logs
+ * - Writing config changes back to disk (e.g. provisioned resource IDs)
+ *
+ * @returns `true` if the process is non-interactive or running in CI.
+ */
+declare function isNonInteractiveOrCI(): boolean;
+/**
+ * Whether the process is running in any CI environment (per `ci-info`).
+ *
+ * Distinct from {@link isNonInteractiveOrCI}: this ignores TTY state, so it is
+ * `true` only for genuine CI, not for merely non-interactive contexts (agents,
+ * piped commands). Used for behaviour that should key off CI specifically — e.g.
+ * redacting account names / emails in public CI logs while still showing them to
+ * non-interactive local tooling.
+ *
+ * Exposed from this package (rather than having consumers `import "ci-info"`
+ * directly) so the value flows through the mockable `ci-info` boundary and
+ * consumers don't take a fresh, unmockable dependency on it.
+ */
+declare function isCI(): boolean;
+
+/**
+ * Wrapper around the `open` package that gracefully handles environments where
+ * a browser opener (e.g. `xdg-open` on Linux) is unavailable. In those cases
+ * the URL is printed so the user can copy-paste it manually, rather than
+ * crashing with a confusing "file not found" error.
+ *
+ * The consumer's `logger` is passed in rather than imported: this package is
+ * shared across CLIs and has no logger singleton of its own.
+ *
+ * @param url the URL to point the browser at
+ * @param logger the consumer's logger, used to surface the manual-open fallback
+ */
+declare function openInBrowser(url: string, logger: Logger): Promise<void>;
+
 declare function retryOnAPIFailure<T>(action: () => T | Promise<T>, logger: Logger, backoff?: number, attempts?: number, abortSignal?: AbortSignal): Promise<T>;
 
 declare function formatTime(duration: number): string;
@@ -796,7 +899,7 @@ declare function getHostFromUrl(urlLike: string): string | undefined;
  */
 interface PackageManager {
     /** The package manager identifier. */
-    type: "npm" | "yarn" | "pnpm" | "bun";
+    type: "npm" | "yarn" | "pnpm" | "bun" | "nub";
     /** The command used to execute packages (e.g. `npx`, `pnpm`, `bunx`). */
     npx: string;
     /** The command segments used to download and execute packages (e.g. `["npx"]`, `["pnpm", "dlx"]`). */
@@ -840,6 +943,15 @@ declare const BunPackageManager: {
     readonly dlx: ["bunx"];
     readonly lockFiles: ["bun.lockb", "bun.lock"];
 };
+/**
+ * Manage packages using nub.
+ */
+declare const NubPackageManager: {
+    readonly type: "nub";
+    readonly npx: "nubx";
+    readonly dlx: ["nubx"];
+    readonly lockFiles: ["nub.lock"];
+};
 
 /**
  * Checks whether the provided worker name is valid, this means that:
@@ -909,4 +1021,4 @@ declare function getWorkerNameFromProject(projectPath: string): string;
  */
 declare const friendlyBindingNames: Record<ConfigBindingFieldName, string>;
 
-export { APIError, Binding, type BindingLocalSupport, BunPackageManager, CommandLineArgsError, type CompatDate, Config, type ConfigBindingFieldName, type ConfigBindingOptions, DeprecationError, Diagnostics, DurableObjectExport, type EphemeralDirectory, type ExportType, Exports, FatalError, JsonFriendlyFatalError, type Location, Logger, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, NpmPackageManager, type NpmVersionCheckResult, type PackageJSON, type PackageManager, ParseError, type ParseFile, type PartitionedExports, PatchConfigError, PnpmPackageManager, RawConfig, type ResolveConfigPathOptions, Route, type TelemetryMessage, type Tunnel, type TunnelOptions, UserError, WorkerEntrypointExport, WorkerMetadataBinding, YarnPackageManager, assertNever, bucketFormatMessage, checkWorkerNameValidity, configFileName, configFormat, createFatalError, experimental_patchConfig, experimental_readRawConfig, fetchLatestNpmVersion, findWranglerConfig, formatConfigSnippet, formatTime, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getDurableObjectExports, getEnvironmentVariableFactory, getHostFromRoute, getHostFromUrl, getInstalledPackageVersion, getPackagePath, getTodaysCompatDate, getWorkerName, getWorkerNameFromProject, getWranglerHiddenDirPath, getWranglerTmpDir, getZoneFromRoute, hasDurableObjectExports, hasProperty, indexLocation, isCompatDate, isDockerfile, isOptionalProperty, isPackageInstalled, isPagesConfig, isRedirectedConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, partitionExports, readFileSync, readFileSyncToBuffer, resolveWranglerConfigPath, retryOnAPIFailure, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, toValidWorkerName, validatePagesConfig };
+export { APIError, Binding, type BindingLocalSupport, BunPackageManager, CommandLineArgsError, type CompatDate, Config, type ConfigBindingFieldName, type ConfigBindingOptions, type ConfigCache, type ConfigCacheOptions, DeprecationError, Diagnostics, DurableObjectExport, type EphemeralDirectory, type ExportType, Exports, FatalError, JsonFriendlyFatalError, type Location, Logger, type Message, MissingConfigError, 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, UserError, WorkerEntrypointExport, WorkerMetadataBinding, YarnPackageManager, assertNever, bucketFormatMessage, checkWorkerNameValidity, configFileName, configFormat, createConfigCache, createFatalError, experimental_patchConfig, experimental_readRawConfig, fetchLatestNpmVersion, findWranglerConfig, formatConfigSnippet, formatTime, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getDurableObjectExports, getEnvironmentVariableFactory, getHostFromRoute, getHostFromUrl, getInstalledPackageVersion, getPackagePath, getTodaysCompatDate, getWorkerName, getWorkerNameFromProject, getWranglerHiddenDirPath, getWranglerTmpDir, getZoneFromRoute, hasDurableObjectExports, hasProperty, indexLocation, isCI, isCompatDate, isDockerfile, isInteractive, isNonInteractiveOrCI, isOptionalProperty, isPackageInstalled, isPagesConfig, isRedirectedConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, openInBrowser, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, partitionExports, readFileSync, readFileSyncToBuffer, resolveWranglerConfigPath, retryOnAPIFailure, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, toValidWorkerName, validatePagesConfig };