@cloudflare/workers-utils 0.25.1 → 0.27.0

package/dist/browser.d.mts

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

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

@@ -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/{config-B_-PmLum.d.mts → config-CkPlrcrD.d.mts}

@@ -799,10 +799,18 @@ interface CfWorkerInit {
     } | undefined;
     observability: Observability | undefined;
     cache: CacheOptions | undefined;
+    /**
+     * The list of npm package dependencies collected from the project's package.json.
+     * Sent to the API for instrumentation and analytics purposes.
+     */
+    package_dependencies?: Array<{
+        name: string;
+        packageJsonVersion: string;
+        installedVersion: string;
+    }> | undefined;
 }
 interface CfWorkerContext {
     env: string | undefined;
-    useServiceEnvironments: boolean | undefined;
     zone: string | undefined;
     host: string | undefined;
     routes: Route[] | undefined;
@@ -1107,6 +1115,11 @@ type WorkerMetadataPut = {
     containers?: {
         class_name: string;
     }[];
+    package_dependencies?: Array<{
+        name: string;
+        packageJsonVersion: string;
+        installedVersion: string;
+    }>;
     [key: string]: unknown;
 };
 type WorkerMetadataVersionsPost = WorkerMetadataPut & {
@@ -1505,7 +1518,6 @@ interface StartDevWorkerInput {
     };
     legacy?: {
         site?: Hook<Config["site"], [Config]>;
-        useServiceEnvironments?: boolean;
     };
     unsafe?: Omit<CfUnsafe, "bindings">;
     assets?: string;
@@ -3199,13 +3211,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.
      *
@@ -3213,6 +3218,24 @@ interface ConfigFields<Dev extends RawDevConfig> {
      * Otherwise, Wrangler will use the user's preference.
      */
     send_metrics: boolean | undefined;
+    /**
+     * Configuration for npm package dependency instrumentation.
+     *
+     * Controls whether Wrangler should collect and send npm package dependency
+     * metadata when deploying or uploading a Worker version.
+     *
+     * When `enabled` is set to `false`, Wrangler will not include
+     * `package_dependencies` in the upload payload. Defaults to enabled when
+     * not specified.
+     *
+     * Note: This is considered build metadata, so managed separately from the
+     *       telemetry one and not disabled when
+     *       `send_metrics`/`WRANGLER_SEND_METRICS` is set to `false`
+     */
+    dependencies_instrumentation: {
+        /** Whether dependency instrumentation is enabled. Defaults to `true`. */
+        enabled: boolean;
+    } | undefined;
     /**
      * Options to configure the development server that your worker will use.
      *

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-B_-PmLum.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-B_-PmLum.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-CkPlrcrD.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-CkPlrcrD.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;
@@ -309,6 +308,7 @@ declare function parseTOML(tomlContent: string, filePath?: string): unknown;
 type PackageJSON = {
     name?: string;
     version?: string;
+    private?: boolean;
     devDependencies?: Record<string, unknown>;
     dependencies?: Record<string, unknown>;
     scripts?: Record<string, unknown>;
@@ -423,6 +423,40 @@ type TypeofType = "string" | "number" | "bigint" | "boolean" | "symbol" | "undef
 
 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
+ *
+ * @param packageName - The npm package name to resolve
+ * @param projectPath - The project directory to resolve from
+ * @returns The resolved directory path, or `undefined` if the package is not installed
+ */
+declare function getPackagePath(packageName: string, projectPath: string): string | undefined;
+/**
+ * Checks whether an npm package is installed in a target project.
+ *
+ * @param packageName - The name of the target package
+ * @param projectPath - The path of the project to check
+ * @returns `true` if the package is installed, `false` otherwise
+ */
+declare function isPackageInstalled(packageName: string, projectPath: string): boolean;
+/**
+ * Gets the exact version of an npm package installed in a project by resolving
+ * it from node_modules and reading its package.json.
+ *
+ * @param packageName - The name of the target package
+ * @param projectPath - The path of the project to check
+ * @param opts - Options
+ * @param opts.stopAtProjectPath - If `true`, stop walking up at the project's path
+ * @returns The installed version string, or `undefined` if the package is not installed
+ */
+declare function getInstalledPackageVersion(packageName: string, projectPath: string, opts?: {
+    stopAtProjectPath?: boolean;
+}): string | undefined;
+
 /**
  * Maps a set of bindings defined as worker metadata bindings (straight from the Cloudflare API) to bindings defined in the local format.
  *
@@ -506,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). */
@@ -613,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()`.
@@ -718,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;
@@ -874,4 +1012,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, getTodaysCompatDate, getWorkerName, getWorkerNameFromProject, getWranglerHiddenDirPath, getWranglerTmpDir, getZoneFromRoute, hasDurableObjectExports, hasProperty, indexLocation, isCompatDate, isDockerfile, isOptionalProperty, 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, 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 };