@cloudflare/workers-utils 0.23.0 → 0.23.2

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-import { C as ComputedFields, B as Binding, R as RawConfig, b as Config, W as WorkerMetadataBinding, c as Route } from './config-BT23LDfr.mjs';
-export { aw as AssetConfigMetadata, A as Assets, ax as AssetsOptions, aD as BinaryFile, r as CacheOptions, I as CfAIBinding, a1 as CfAISearch, a0 as CfAISearchNamespace, a3 as CfAgentMemory, ae as CfAnalyticsEngineDataset, a5 as CfArtifacts, aj as CfAssetsBinding, H as CfBrowserBinding, am as CfCapnp, _ as CfD1Database, N as CfDataBlobBindings, af as CfDispatchNamespace, Q as CfDurableObject, ao as CfDurableObjectMigrations, a7 as CfFlagship, a6 as CfHelloWorld, aa as CfHyperdrive, J as CfImagesBinding, y as CfKvNamespace, ah as CfLogfwdr, ai as CfLogfwdrBinding, ag as CfMTlsCertificate, K as CfMediaBinding, w as CfModule, v as CfModuleType, ak as CfPipeline, ap as CfPlacement, X as CfQueue, Y as CfR2Bucket, a9 as CfRateLimit, u as CfScriptFormat, a4 as CfSecretsStoreSecrets, z as CfSendEmailBindings, ab as CfService, L as CfStreamBinding, aq as CfTailConsumer, G as CfTextBlobBindings, an as CfUnsafe, al as CfUnsafeBinding, ar as CfUserLimits, x as CfVars, $ as CfVectorize, M as CfVersionMetadataBinding, ad as CfVpcNetwork, ac as CfVpcService, F as CfWasmModuleBindings, a2 as CfWebSearch, at as CfWorkerContext, as as CfWorkerInit, a8 as CfWorkerLoader, au as CfWorkerSourceMap, V as CfWorkflow, j as CloudchamberConfig, e as ConfigFields, p as ConfigModuleRuleType, k as ContainerApp, t as ContainerEngine, i as CustomDomainRoute, q as DispatchNamespaceOutbound, s as DockerConfiguration, l as DurableObjectBindings, D as DurableObjectMigration, aI as ENVIRONMENT_TAG_PREFIX, aF as Entry, E as Environment, n as EnvironmentNonInheritable, aC as File, aG as INHERIT_SYMBOL, aK as JSON_CONFIG_FORMATS, av as Json, ay as LegacyAssetPaths, O as Observability, aJ as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, d as RawDevConfig, f as RawEnvironment, a as RedirectedRawConfig, o as Rule, aH as SERVICE_TAG_PREFIX, aB as ServiceFetch, aA as ServiceMetadataRes, S as StreamingTailConsumer, T as TailConsumer, aE as Trigger, U as UserLimits, az as WorkerMetadata, m as WorkflowBinding, Z as ZoneIdRoute, h as ZoneNameRoute, g as defaultWranglerConfig } from './config-BT23LDfr.mjs';
+import { C as ComputedFields, B as Binding, R as RawConfig, b as Config, W as WorkerMetadataBinding, L as Logger, c as Route } from './config-8UymS5SL.mjs';
+export { bw as ApiCredentials, aA as AssetConfigMetadata, A as Assets, aB as AssetsOptions, aN as AsyncHook, aI as BinaryFile, b0 as COMPLIANCE_REGION_CONFIG_PUBLIC, b1 as COMPLIANCE_REGION_CONFIG_UNKNOWN, t as CacheOptions, K as CfAIBinding, a4 as CfAISearch, a3 as CfAISearchNamespace, aK as CfAccount, a6 as CfAgentMemory, ai as CfAnalyticsEngineDataset, a8 as CfArtifacts, an as CfAssetsBinding, J as CfBrowserBinding, aq as CfCapnp, a1 as CfD1Database, X as CfDataBlobBindings, ae as CfDevPluginCfg, aj as CfDispatchNamespace, Y as CfDurableObject, as as CfDurableObjectMigrations, aa as CfFlagship, a9 as CfHelloWorld, ad as CfHyperdrive, M as CfImagesBinding, F as CfKvNamespace, al as CfLogfwdr, am as CfLogfwdrBinding, ak as CfMTlsCertificate, N as CfMediaBinding, y as CfModule, x as CfModuleType, ao as CfPipeline, at as CfPlacement, $ as CfQueue, a0 as CfR2Bucket, ac as CfRateLimit, w as CfScriptFormat, a7 as CfSecretsStoreSecrets, G as CfSendEmailBindings, af as CfService, Q as CfStreamBinding, au as CfTailConsumer, I as CfTextBlobBindings, ar as CfUnsafe, ap as CfUnsafeBinding, av as CfUserLimits, z as CfVars, a2 as CfVectorize, V as CfVersionMetadataBinding, ah as CfVpcNetwork, ag as CfVpcService, H as CfWasmModuleBindings, a5 as CfWebSearch, ax as CfWorkerContext, aw as CfWorkerInit, ab as CfWorkerLoader, ay as CfWorkerSourceMap, _ as CfWorkflow, l as CloudchamberConfig, a$ as ComplianceConfig, e as ConfigFields, r as ConfigModuleRuleType, m as ContainerApp, v as ContainerEngine, k as CustomDomainRoute, s as DispatchNamespaceOutbound, u as DockerConfiguration, n as DurableObjectBindings, D as DurableObjectMigration, aU as ENVIRONMENT_TAG_PREFIX, aR as Entry, E as Environment, p as EnvironmentNonInheritable, bO as FetchKVGetValueFetcher, bz as FetchListResultFetcher, bA as FetchPagedListResultFetcher, bx as FetchResult, by as FetchResultFetcher, aH as File, aM as Hook, aL as HookValues, aS as INHERIT_SYMBOL, aW as JSON_CONFIG_FORMATS, az as Json, h as LOGGER_LEVELS, aD as LegacyAssetPaths, aO as LogLevel, i as LoggerLevel, aP as NodeJSCompatMode, O as Observability, aV as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, d as RawDevConfig, f as RawEnvironment, a as RedirectedRawConfig, q as Rule, aT as SERVICE_TAG_PREFIX, aG as ServiceFetch, aF as ServiceMetadataRes, aQ as StartDevWorkerInput, S as StreamingTailConsumer, T as TailConsumer, aJ as Trigger, U as UserLimits, aC as ValidatedAssetsOptions, aE as WorkerMetadata, o as WorkflowBinding, Z as ZoneIdRoute, j as ZoneNameRoute, bL as addAuthorizationHeader, g as defaultWranglerConfig, bI as extractAccountTag, bH as extractWAFBlockRayId, bC as fetchInternalBase, bN as fetchKVGetValueBase, bE as fetchListResultBase, bD as fetchResultBase, br as getBrowserRenderingHeadfulFromEnv, bd as getBuildConditionsFromEnv, be as getBuildPlatformFromEnv, aX as getC3CommandFromEnv, bb as getCIGeneratePreviewAlias, b8 as getCIMatchTag, b9 as getCIOverrideName, ba as getCIOverrideNetworkModeHost, bs as getCfFetchEnabledFromEnv, bt as getCfFetchPathFromEnv, b3 as getCloudflareApiBaseUrl, a_ as getCloudflareApiEnvironmentFromEnv, b2 as getCloudflareComplianceRegion, bo as getCloudflareEnv, bk as getCloudflareIncludeProcessEnvFromEnv, bj as getCloudflareLoadDevVarsFromDotEnv, bv as getCloudflaredPathFromEnv, b4 as getComplianceRegionSubdomain, bg as getD1ExtraLocationChoices, bm as getDisableConfigWatching, bh as getDockerPath, bq as getLocalExplorerEnabledFromEnv, bp as getOpenNextDeployFromEnv, b6 as getOutputFileDirectoryFromEnv, b7 as getOutputFilePathFromEnv, bf as getRegistryPath, b5 as getSanitizeLogs, bi as getSubdomainMixedStateCheckDisabled, bl as getTraceHeader, bc as getWorkersCIBranchName, bu as getWranglerCacheDirFromEnv, bn as getWranglerHideBanner, aZ as getWranglerSendErrorReportsFromEnv, aY as getWranglerSendMetricsFromEnv, bP as hasCursor, bJ as hasMorePages, bG as isWAFBlockResponse, bQ as maybeAddTraceHeader, bB as performApiFetchBase, bK as renderError, bM as throwFetchError, bF as truncate } from './config-8UymS5SL.mjs';
 import * as jsoncParser from 'jsonc-parser';
 export { constructWranglerConfig } from './browser.mjs';
 export { Counter, MetricsRegistry } from './prometheus-metrics.mjs';
 import { ChildProcess } from 'node:child_process';
-import { URLSearchParams } from 'node:url';
-import { RequestInit, Response, Headers } from 'undici';
+import 'node:url';
+import 'undici';
 import '@cloudflare/workers-shared';
 import 'cloudflare';
 
@@ -557,248 +557,35 @@ declare function getEnvironmentVariableFactory<Choices extends readonly string[]
     readonly choices?: Choices;
 }): () => ElementType<Choices>;
 
+interface GetGlobalConfigPathOptions {
+    /**
+     * The application namespace. Defaults to `"wrangler"`.
+     */
+    appName?: string;
+    /**
+     * Whether to prepend a `.` to `appName` when resolving the XDG path and the
+     * legacy `$HOME` directory. Defaults to `true` to match wrangler's
+     * historical behaviour (`.wrangler`).
+     */
+    leadingDot?: boolean;
+    /**
+     * When `true` (the default, matching wrangler's historical behaviour), a
+     * pre-existing `~/.<appName>` directory takes precedence over the XDG path.
+     * Pass `false` to always use the XDG-compliant path.
+     */
+    useLegacyHomeDir?: boolean;
+}
 /**
- * `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: () => "staging" | "production";
-/**
- * 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)
+ * Resolve the global config directory for a Cloudflare CLI.
  *
- * 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.
+ * Defaults to wrangler's directory (`.wrangler`) so existing callers are
+ * unaffected, but accepts an `appName` so other first-party CLIs (e.g. `cf`)
+ * can reuse the same XDG-compliant resolution under their own namespace.
  */
-declare const getWranglerCacheDirFromEnv: () => string | undefined;
+declare function getGlobalConfigPath({ appName, leadingDot, useLegacyHomeDir, }?: GetGlobalConfigPathOptions): string;
 /**
- * `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.
+ * @deprecated Use {@link getGlobalConfigPath} instead.
  */
-declare const getCloudflaredPathFromEnv: () => string | undefined;
-
 declare function getGlobalWranglerConfigPath(): string;
 
 type YYYY = `${number}${number}${number}${number}`;
@@ -888,30 +675,6 @@ declare function sweepStaleWranglerTmpDirs(tmpRoot: string): void;
  */
 declare function getWranglerTmpDir(projectRoot: string | undefined, prefix: string, cleanup?: boolean): EphemeralDirectory;
 
-/**
- * cloudflared binary management for Wrangler tunnel commands.
- *
- * This module handles downloading, caching, and running the cloudflared binary.
- * It uses the Cloudflare update worker (update.argotunnel.com) to resolve
- * the latest version and download URL, matching cloudflared's own update mechanism.
- */
-
-interface Logger$1 {
-    log: typeof console.log;
-    warn: typeof console.warn;
-    debug: typeof console.debug;
-}
-/**
- * Spawn cloudflared process with automatic binary management
- */
-declare function spawnCloudflared(args: string[], options?: {
-    stdio?: "inherit" | "pipe";
-    env?: Record<string, string>;
-    skipVersionCheck?: boolean;
-    confirmDownload?: (message: string) => Promise<boolean>;
-    logger?: Logger$1;
-}): Promise<ChildProcess>;
-
 interface QuickTunnelResult {
     mode: "quick";
     publicUrl: URL;
@@ -933,7 +696,7 @@ interface TunnelOptions {
     expiryMs?: number;
     reminderIntervalMs?: number;
     extendHint?: string;
-    logger?: Logger$1;
+    logger?: Pick<Logger, "debug" | "log" | "warn">;
 }
 /**
  * Start a Cloudflare Quick Tunnel for a local dev origin.
@@ -945,74 +708,24 @@ interface TunnelOptions {
  */
 declare function startTunnel(options: TunnelOptions): Tunnel;
 
-interface FetchError {
-    code: number;
-    documentation_url?: string;
-    message: string;
-    error_chain?: FetchError[];
-}
-
-type Logger = {
-    debug: (...args: unknown[]) => void;
-    debugWithSanitization: (label: string, ...args: unknown[]) => void;
-    log: (...args: unknown[]) => void;
-    info: (...args: unknown[]) => void;
-    warn: (...args: unknown[]) => void;
-    error: (...args: unknown[]) => void;
-};
-
-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[]>;
 /**
+ * cloudflared binary management for Wrangler tunnel commands.
  *
- * Note this requires its caller to handle credentials
- * (need to call requireLoggedIn and requireApiToken)
+ * This module handles downloading, caching, and running the cloudflared binary.
+ * It uses the Cloudflare update worker (update.argotunnel.com) to resolve
+ * the latest version and download URL, matching cloudflared's own update mechanism.
  */
-declare function performApiFetchBase(complianceConfig: ComplianceConfig, resource: string, init: RequestInit | undefined, userAgent: string, logger: Logger, queryParams?: URLSearchParams, abortSignal?: AbortSignal, credentials?: ApiCredentials): Promise<Response>;
-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;
-declare function hasCursor(result_info: unknown): result_info is {
-    cursor: string;
-};
-declare function maybeAddTraceHeader(headers: Headers): void;
+
+/**
+ * Spawn cloudflared process with automatic binary management
+ */
+declare function spawnCloudflared(args: string[], options?: {
+    stdio?: "inherit" | "pipe";
+    env?: Record<string, string>;
+    skipVersionCheck?: boolean;
+    confirmDownload?: (message: string) => Promise<boolean>;
+    logger?: Pick<Logger, "debug" | "log" | "warn">;
+}): Promise<ChildProcess>;
 
 type NpmVersionCheckResult = {
     status: "up-to-date";
@@ -1075,4 +788,4 @@ declare function getZoneFromRoute(route: Route): string | undefined;
  */
 declare function getHostFromUrl(urlLike: string): string | undefined;
 
-export { APIError, type ApiCredentials, Binding, type BindingLocalSupport, COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, CommandLineArgsError, type CompatDate, type ComplianceConfig, Config, type ConfigBindingFieldName, type ConfigBindingOptions, DeprecationError, Diagnostics, type EphemeralDirectory, FatalError, type FetchListResultFetcher, type FetchResult, type FetchResultFetcher, JsonFriendlyFatalError, type Location, type Logger, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, type NpmVersionCheckResult, type PackageJSON, ParseError, type ParseFile, PatchConfigError, RawConfig, type ResolveConfigPathOptions, Route, type TelemetryMessage, type Tunnel, type TunnelOptions, UserError, WorkerMetadataBinding, addAuthorizationHeader, assertNever, bucketFormatMessage, configFileName, configFormat, createFatalError, experimental_patchConfig, experimental_readRawConfig, extractAccountTag, extractWAFBlockRayId, fetchInternalBase, fetchLatestNpmVersion, fetchListResultBase, fetchResultBase, findWranglerConfig, formatConfigSnippet, formatTime, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getBrowserRenderingHeadfulFromEnv, getBuildConditionsFromEnv, getBuildPlatformFromEnv, getC3CommandFromEnv, getCIGeneratePreviewAlias, getCIMatchTag, getCIOverrideName, getCIOverrideNetworkModeHost, getCfFetchEnabledFromEnv, getCfFetchPathFromEnv, getCloudflareApiBaseUrl, getCloudflareApiEnvironmentFromEnv, getCloudflareComplianceRegion, getCloudflareEnv, getCloudflareIncludeProcessEnvFromEnv, getCloudflareLoadDevVarsFromDotEnv, getCloudflaredPathFromEnv, getComplianceRegionSubdomain, getD1ExtraLocationChoices, getDisableConfigWatching, getDockerPath, getEnvironmentVariableFactory, getGlobalWranglerConfigPath, getHostFromRoute, getHostFromUrl, getLocalExplorerEnabledFromEnv, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTodaysCompatDate, getTraceHeader, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHiddenDirPath, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, getWranglerTmpDir, getZoneFromRoute, hasCursor, hasMorePages, hasProperty, indexLocation, isCompatDate, isDirectory, isDockerfile, isOptionalProperty, isPagesConfig, isRedirectedConfig, isRequiredProperty, isValidR2BucketName, isWAFBlockResponse, mapWorkerMetadataBindings, maybeAddTraceHeader, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, performApiFetchBase, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, renderError, resolveWranglerConfigPath, retryOnAPIFailure, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, throwFetchError, truncate, validatePagesConfig };
+export { APIError, Binding, type BindingLocalSupport, CommandLineArgsError, type CompatDate, Config, type ConfigBindingFieldName, type ConfigBindingOptions, DeprecationError, Diagnostics, type EphemeralDirectory, FatalError, type GetGlobalConfigPathOptions, JsonFriendlyFatalError, type Location, Logger, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, type NpmVersionCheckResult, type PackageJSON, ParseError, type ParseFile, PatchConfigError, RawConfig, type ResolveConfigPathOptions, Route, type TelemetryMessage, type Tunnel, type TunnelOptions, UserError, WorkerMetadataBinding, assertNever, bucketFormatMessage, configFileName, configFormat, createFatalError, experimental_patchConfig, experimental_readRawConfig, fetchLatestNpmVersion, findWranglerConfig, formatConfigSnippet, formatTime, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getEnvironmentVariableFactory, getGlobalConfigPath, getGlobalWranglerConfigPath, getHostFromRoute, getHostFromUrl, getTodaysCompatDate, getWranglerHiddenDirPath, getWranglerTmpDir, getZoneFromRoute, hasProperty, indexLocation, isCompatDate, isDirectory, isDockerfile, isOptionalProperty, isPagesConfig, isRedirectedConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, retryOnAPIFailure, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, validatePagesConfig };

package/dist/index.mjs

@@ -5930,14 +5930,24 @@ __reExport(mod_esm_exports, __toESM(require_mod_cjs3(), 1));
 var mod_esm_default = import_mod_cjs.default;
 
 // src/global-wrangler-config-path.ts
+function getGlobalConfigPath({
+  appName = "wrangler",
+  leadingDot = true,
+  useLegacyHomeDir = true
+} = {}) {
+  const dirName = `${leadingDot ? "." : ""}${appName}`;
+  const configDir = mod_esm_default(dirName).config();
+  if (useLegacyHomeDir) {
+    const legacyConfigDir = path3.join(os.homedir(), dirName);
+    if (isDirectory(legacyConfigDir)) {
+      return legacyConfigDir;
+    }
+  }
+  return configDir;
+}
+__name(getGlobalConfigPath, "getGlobalConfigPath");
 function getGlobalWranglerConfigPath() {
-  const configDir = mod_esm_default(".wrangler").config();
-  const legacyConfigDir = path3.join(os.homedir(), ".wrangler");
-  if (isDirectory(legacyConfigDir)) {
-    return legacyConfigDir;
-  } else {
-    return configDir;
-  }
+  return getGlobalConfigPath();
 }
 __name(getGlobalWranglerConfigPath, "getGlobalWranglerConfigPath");
 
@@ -10133,6 +10143,55 @@ var validateServiceBinding = /* @__PURE__ */ __name((diagnostics, field, value)
     );
     isValid2 = false;
   }
+  if (hasProperty(value, "dev") && value.dev !== void 0) {
+    if (typeof value.dev !== "object" || value.dev === null || Array.isArray(value.dev)) {
+      diagnostics.errors.push(
+        `"${field}" bindings should have an object "dev" field but got ${JSON.stringify(
+          value.dev
+        )}.`
+      );
+      isValid2 = false;
+    } else {
+      if (!hasProperty(value.dev, "plugin") || typeof value.dev.plugin !== "object" || value.dev.plugin === null || Array.isArray(value.dev.plugin)) {
+        diagnostics.errors.push(
+          `"${field}.dev" should have an object "plugin" field but got ${JSON.stringify(
+            value.dev.plugin
+          )}.`
+        );
+        isValid2 = false;
+      } else {
+        if (!isRequiredProperty(value.dev.plugin, "package", "string")) {
+          diagnostics.errors.push(
+            `"${field}.dev.plugin" should have a string "package" field but got ${JSON.stringify(
+              value.dev.plugin.package
+            )}.`
+          );
+          isValid2 = false;
+        }
+        if (!isRequiredProperty(value.dev.plugin, "name", "string")) {
+          diagnostics.errors.push(
+            `"${field}.dev.plugin" should have a string "name" field but got ${JSON.stringify(
+              value.dev.plugin.name
+            )}.`
+          );
+          isValid2 = false;
+        }
+      }
+      if (hasProperty(value.dev, "options") && value.dev.options !== void 0 && (typeof value.dev.options !== "object" || value.dev.options === null || Array.isArray(value.dev.options))) {
+        diagnostics.errors.push(
+          `"${field}.dev.options" should be an object but got ${JSON.stringify(
+            value.dev.options
+          )}.`
+        );
+        isValid2 = false;
+      }
+    }
+    if (value.remote === true) {
+      diagnostics.warnings.push(
+        `"${field}" binding has both "dev" and "remote" set; "remote" is ignored when "dev" is present and the binding is routed through the local Miniflare plugin.`
+      );
+    }
+  }
   if (!isRemoteValid(value, field, diagnostics)) {
     isValid2 = false;
   }
@@ -12357,7 +12416,7 @@ __name(maybeThrowFriendlyError, "maybeThrowFriendlyError");
 function logHeaders(headers, logger) {
   const clone = cloneHeaders(headers);
   clone.delete("Authorization");
-  logger.debugWithSanitization(
+  logger.debugWithSanitization?.(
     "HEADERS:",
     JSON.stringify(Object.fromEntries(clone), null, 2)
   );
@@ -12378,11 +12437,11 @@ async function performApiFetchBase(complianceConfig, resource, init = {}, userAg
   logger.debug(
     `-- START CF API REQUEST: ${method} ${getCloudflareApiBaseUrl(complianceConfig)}${resource}`
   );
-  logger.debugWithSanitization("QUERY STRING:", queryString);
+  logger.debugWithSanitization?.("QUERY STRING:", queryString);
   logHeaders(headers, logger);
-  logger.debugWithSanitization("INIT:", JSON.stringify({ ...init }, null, 2));
+  logger.debugWithSanitization?.("INIT:", JSON.stringify({ ...init }, null, 2));
   if (init.body instanceof FormData) {
-    logger.debugWithSanitization(
+    logger.debugWithSanitization?.(
       "BODY:",
       await new Response(init.body).text(),
       null,
@@ -12420,7 +12479,7 @@ async function fetchInternalBase(complianceConfig, resource, init = {}, userAgen
     response.status
   );
   logHeaders(response.headers, logger);
-  logger.debugWithSanitization("RESPONSE:", jsonText);
+  logger.debugWithSanitization?.("RESPONSE:", jsonText);
   logger.debug("-- END CF API RESPONSE");
   if (!jsonText && (response.status === 204 || response.status === 205)) {
     return {
@@ -12659,6 +12718,27 @@ function throwWAFBlockError(headers, method, resource, status, statusText) {
   });
 }
 __name(throwWAFBlockError, "throwWAFBlockError");
+async function fetchKVGetValueBase(complianceConfig, accountId, namespaceId, key, userAgent, logger, credentials) {
+  const headers = new Headers();
+  addAuthorizationHeader(headers, credentials);
+  headers.set("User-Agent", userAgent);
+  maybeAddTraceHeader(headers);
+  const resource = `${getCloudflareApiBaseUrl(complianceConfig)}/accounts/${accountId}/storage/kv/namespaces/${namespaceId}/values/${key}`;
+  logger.debug(`-- START CF API REQUEST: GET ${resource}`);
+  logger.debug("-- END CF API REQUEST");
+  const response = await fetch(resource, {
+    method: "GET",
+    headers
+  });
+  if (response.ok) {
+    return await response.arrayBuffer();
+  } else {
+    throw new Error(
+      `Failed to fetch ${resource} - ${response.status}: ${response.statusText}`
+    );
+  }
+}
+__name(fetchKVGetValueBase, "fetchKVGetValueBase");
 function hasCursor(result_info) {
   const cursor = result_info?.cursor;
   return cursor !== void 0 && cursor !== null && cursor !== "";
@@ -12706,6 +12786,16 @@ async function fetchLatestNpmVersion(name, version) {
   return { status: "update-available", latest: result.latest };
 }
 __name(fetchLatestNpmVersion, "fetchLatestNpmVersion");
+
+// src/logger.ts
+var LOGGER_LEVELS = {
+  none: -1,
+  error: 0,
+  warn: 1,
+  info: 2,
+  log: 3,
+  debug: 4
+};
 var MAX_ATTEMPTS = 3;
 async function retryOnAPIFailure(action, logger, backoff = 0, attempts = MAX_ATTEMPTS, abortSignal) {
   try {
@@ -12811,4 +12901,4 @@ safe-buffer/index.js:
   (*! safe-buffer. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> *)
 */
 
-export { COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, Diagnostics, PatchConfigError, addAuthorizationHeader, bucketFormatMessage, defaultWranglerConfig, experimental_patchConfig, extractAccountTag, extractWAFBlockRayId, fetchInternalBase, fetchLatestNpmVersion, fetchListResultBase, fetchResultBase, formatTime, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getBrowserRenderingHeadfulFromEnv, getBuildConditionsFromEnv, getBuildPlatformFromEnv, getC3CommandFromEnv, getCIGeneratePreviewAlias, getCIMatchTag, getCIOverrideName, getCIOverrideNetworkModeHost, getCfFetchEnabledFromEnv, getCfFetchPathFromEnv, getCloudflareApiBaseUrl, getCloudflareApiEnvironmentFromEnv, getCloudflareComplianceRegion, getCloudflareEnv, getCloudflareIncludeProcessEnvFromEnv, getCloudflareLoadDevVarsFromDotEnv, getCloudflaredPathFromEnv, getComplianceRegionSubdomain, getD1ExtraLocationChoices, getDisableConfigWatching, getDockerPath, getEnvironmentVariableFactory, getGlobalWranglerConfigPath, getHostFromRoute, getHostFromUrl, getLocalExplorerEnabledFromEnv, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTraceHeader, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHiddenDirPath, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, getWranglerTmpDir, getZoneFromRoute, hasCursor, hasMorePages, hasProperty, isDockerfile, isOptionalProperty, isPagesConfig, isRequiredProperty, isValidR2BucketName, isWAFBlockResponse, maybeAddTraceHeader, normalizeAndValidateConfig, performApiFetchBase, renderError, retryOnAPIFailure, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, throwFetchError, truncate, validatePagesConfig };
+export { COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, Diagnostics, LOGGER_LEVELS, PatchConfigError, addAuthorizationHeader, bucketFormatMessage, defaultWranglerConfig, experimental_patchConfig, extractAccountTag, extractWAFBlockRayId, fetchInternalBase, fetchKVGetValueBase, fetchLatestNpmVersion, fetchListResultBase, fetchResultBase, formatTime, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getBrowserRenderingHeadfulFromEnv, getBuildConditionsFromEnv, getBuildPlatformFromEnv, getC3CommandFromEnv, getCIGeneratePreviewAlias, getCIMatchTag, getCIOverrideName, getCIOverrideNetworkModeHost, getCfFetchEnabledFromEnv, getCfFetchPathFromEnv, getCloudflareApiBaseUrl, getCloudflareApiEnvironmentFromEnv, getCloudflareComplianceRegion, getCloudflareEnv, getCloudflareIncludeProcessEnvFromEnv, getCloudflareLoadDevVarsFromDotEnv, getCloudflaredPathFromEnv, getComplianceRegionSubdomain, getD1ExtraLocationChoices, getDisableConfigWatching, getDockerPath, getEnvironmentVariableFactory, getGlobalConfigPath, getGlobalWranglerConfigPath, getHostFromRoute, getHostFromUrl, getLocalExplorerEnabledFromEnv, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTraceHeader, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHiddenDirPath, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, getWranglerTmpDir, getZoneFromRoute, hasCursor, hasMorePages, hasProperty, isDockerfile, isOptionalProperty, isPagesConfig, isRequiredProperty, isValidR2BucketName, isWAFBlockResponse, maybeAddTraceHeader, normalizeAndValidateConfig, performApiFetchBase, renderError, retryOnAPIFailure, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, throwFetchError, truncate, validatePagesConfig };