@cloudflare/workers-utils 0.18.0 → 0.19.0

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { T as TailConsumer, au as WorkerMetadata, R as RawConfig } from './config-_M2XwEUI.mjs';
+import { T as TailConsumer, au as WorkerMetadata, R as RawConfig } from './config-CnJQHRQs.mjs';
 import { AssetConfig } from '@cloudflare/workers-shared';
 import { Cloudflare } from 'cloudflare';
 

package/dist/{chunk-A4F3D336.mjs → chunk-XXCQEG76.mjs}

@@ -12,7 +12,7 @@ var UserError = class extends Error {
   constructor(message, options) {
     super(message, options);
     Object.setPrototypeOf(this, new.target.prototype);
-    this.telemetryMessage = options?.telemetryMessage === true ? message : options?.telemetryMessage;
+    this.telemetryMessage = typeof options?.telemetryMessage === "string" ? options.telemetryMessage : options?.telemetryMessage ? message : void 0;
   }
 };
 var DeprecationError = class extends UserError {
@@ -25,13 +25,14 @@ ${message}`, options);
   }
 };
 var FatalError = class extends UserError {
-  constructor(message, code, options) {
-    super(message, options);
-    this.code = code;
-  }
   static {
     __name(this, "FatalError");
   }
+  code;
+  constructor(message, options) {
+    super(message, options);
+    this.code = options.code;
+  }
 };
 var CommandLineArgsError = class extends UserError {
   static {
@@ -39,10 +40,6 @@ var CommandLineArgsError = class extends UserError {
   }
 };
 var JsonFriendlyFatalError = class extends FatalError {
-  constructor(message, code, options) {
-    super(message, code, options);
-    this.code = code;
-  }
   static {
     __name(this, "JsonFriendlyFatalError");
   }
@@ -57,16 +54,11 @@ var MissingConfigError = class extends Error {
     this.telemetryMessage = `Missing config value for ${key}`;
   }
 };
-function createFatalError(message, isJson, code, telemetryMessage) {
+function createFatalError(message, isJson, options) {
   if (isJson) {
-    return new JsonFriendlyFatalError(
-      JSON.stringify(message),
-      code,
-      telemetryMessage
-    );
-  } else {
-    return new FatalError(`${message}`, code, telemetryMessage);
+    return new JsonFriendlyFatalError(JSON.stringify(message), options);
   }
+  return new FatalError(`${message}`, options);
 }
 __name(createFatalError, "createFatalError");
 
@@ -2456,7 +2448,8 @@ function readFileSyncToBuffer(file2) {
         {
           text: message.replace(file2, resolve(file2))
         }
-      ]
+      ],
+      telemetryMessage: false
     });
   }
 }
@@ -2784,32 +2777,41 @@ function findRedirectedWranglerConfig(cwd, userConfigPath) {
   } catch (e) {
     throw new UserError(
       `Failed to parse the deploy configuration file at ${path.relative(".", deployConfigPath)}`,
-      { cause: e }
+      { cause: e, telemetryMessage: false }
     );
   }
   if (!redirectedConfigPath) {
-    throw new UserError(esm_default`
+    throw new UserError(
+      esm_default`
 			A deploy configuration file was found at "${path.relative(".", deployConfigPath)}".
 			But this is not valid - the required "configPath" property was not found.
 			Instead this file contains:
 			\`\`\`
 			${deployConfigFile}
 			\`\`\`
-		`);
+		`,
+      { telemetryMessage: false }
+    );
   }
   if (!existsSync(redirectedConfigPath)) {
-    throw new UserError(esm_default`
+    throw new UserError(
+      esm_default`
 				There is a deploy configuration at "${path.relative(".", deployConfigPath)}".
 				But the redirected configuration path it points to, "${path.relative(".", redirectedConfigPath)}", does not exist.
-			`);
+			`,
+      { telemetryMessage: false }
+    );
   }
   if (userConfigPath) {
     if (path.join(path.dirname(userConfigPath), PATH_TO_DEPLOY_CONFIG) !== deployConfigPath) {
-      throw new UserError(esm_default`
+      throw new UserError(
+        esm_default`
 					Found both a user configuration file at "${path.relative(".", userConfigPath)}"
 					and a deploy configuration file at "${path.relative(".", deployConfigPath)}".
 					But these do not share the same base path so it is not clear which should be used.
-				`);
+				`,
+        { telemetryMessage: false }
+      );
     }
   }
   return {

package/dist/{config-_M2XwEUI.d.mts → config-CnJQHRQs.d.mts}

@@ -1530,11 +1530,13 @@ interface EnvironmentNonInheritable {
      */
     vars: Record<string, string | Json>;
     /**
-     * Secrets configuration (experimental).
+     * Secrets configuration.
      *
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#secrets-configuration-property
+     *
      * @nonInheritable
      */
     secrets?: {
@@ -2123,7 +2125,7 @@ interface EnvironmentNonInheritable {
         binding: string;
         /** The Flagship app ID to bind to. */
         app_id: string;
-        /** Whether to use the remote Flagship service for flag evaluation in local dev. */
+        /** Set to `true` to suppress the remote binding warning in local dev. Flagship bindings are always remote. */
         remote?: boolean;
     }[];
     /**

package/dist/index.d.mts

@@ -1,8 +1,9 @@
-import { B as Binding, R as RawConfig, C as Config, W as WorkerMetadataBinding } from './config-_M2XwEUI.mjs';
-export { at as AssetConfigMetadata, A as Assets, ay as BinaryFile, q as CacheOptions, H as CfAIBinding, a0 as CfAISearch, $ as CfAISearchNamespace, ab as CfAnalyticsEngineDataset, a2 as CfArtifacts, ag as CfAssetsBinding, G as CfBrowserBinding, aj as CfCapnp, Y as CfD1Database, M as CfDataBlobBindings, ac as CfDispatchNamespace, N as CfDurableObject, al as CfDurableObjectMigrations, a4 as CfFlagship, a3 as CfHelloWorld, a7 as CfHyperdrive, I as CfImagesBinding, x as CfKvNamespace, ae as CfLogfwdr, af as CfLogfwdrBinding, ad as CfMTlsCertificate, J as CfMediaBinding, v as CfModule, u as CfModuleType, ah as CfPipeline, am as CfPlacement, V as CfQueue, X as CfR2Bucket, a6 as CfRateLimit, t as CfScriptFormat, a1 as CfSecretsStoreSecrets, y as CfSendEmailBindings, a8 as CfService, K as CfStreamBinding, an as CfTailConsumer, F as CfTextBlobBindings, ak as CfUnsafe, ai as CfUnsafeBinding, ao as CfUserLimits, w as CfVars, _ as CfVectorize, L as CfVersionMetadataBinding, aa as CfVpcNetwork, a9 as CfVpcService, z as CfWasmModuleBindings, aq as CfWorkerContext, ap as CfWorkerInit, a5 as CfWorkerLoader, ar as CfWorkerSourceMap, Q as CfWorkflow, i as CloudchamberConfig, c as ConfigFields, o as ConfigModuleRuleType, j as ContainerApp, s as ContainerEngine, g as CustomDomainRoute, p as DispatchNamespaceOutbound, r as DockerConfiguration, k as DurableObjectBindings, D as DurableObjectMigration, aC as ENVIRONMENT_TAG_PREFIX, E as Environment, m as EnvironmentNonInheritable, ax as File, aA as INHERIT_SYMBOL, aE as JSON_CONFIG_FORMATS, as as Json, O as Observability, aD as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, b as RawDevConfig, d as RawEnvironment, a as RedirectedRawConfig, h as Route, n as Rule, aB as SERVICE_TAG_PREFIX, aw as ServiceFetch, av as ServiceMetadataRes, S as StreamingTailConsumer, T as TailConsumer, az as Trigger, U as UserLimits, au as WorkerMetadata, l as WorkflowBinding, Z as ZoneIdRoute, f as ZoneNameRoute, e as defaultWranglerConfig } from './config-_M2XwEUI.mjs';
+import { B as Binding, R as RawConfig, C as Config, W as WorkerMetadataBinding } from './config-CnJQHRQs.mjs';
+export { at as AssetConfigMetadata, A as Assets, ay as BinaryFile, q as CacheOptions, H as CfAIBinding, a0 as CfAISearch, $ as CfAISearchNamespace, ab as CfAnalyticsEngineDataset, a2 as CfArtifacts, ag as CfAssetsBinding, G as CfBrowserBinding, aj as CfCapnp, Y as CfD1Database, M as CfDataBlobBindings, ac as CfDispatchNamespace, N as CfDurableObject, al as CfDurableObjectMigrations, a4 as CfFlagship, a3 as CfHelloWorld, a7 as CfHyperdrive, I as CfImagesBinding, x as CfKvNamespace, ae as CfLogfwdr, af as CfLogfwdrBinding, ad as CfMTlsCertificate, J as CfMediaBinding, v as CfModule, u as CfModuleType, ah as CfPipeline, am as CfPlacement, V as CfQueue, X as CfR2Bucket, a6 as CfRateLimit, t as CfScriptFormat, a1 as CfSecretsStoreSecrets, y as CfSendEmailBindings, a8 as CfService, K as CfStreamBinding, an as CfTailConsumer, F as CfTextBlobBindings, ak as CfUnsafe, ai as CfUnsafeBinding, ao as CfUserLimits, w as CfVars, _ as CfVectorize, L as CfVersionMetadataBinding, aa as CfVpcNetwork, a9 as CfVpcService, z as CfWasmModuleBindings, aq as CfWorkerContext, ap as CfWorkerInit, a5 as CfWorkerLoader, ar as CfWorkerSourceMap, Q as CfWorkflow, i as CloudchamberConfig, c as ConfigFields, o as ConfigModuleRuleType, j as ContainerApp, s as ContainerEngine, g as CustomDomainRoute, p as DispatchNamespaceOutbound, r as DockerConfiguration, k as DurableObjectBindings, D as DurableObjectMigration, aC as ENVIRONMENT_TAG_PREFIX, E as Environment, m as EnvironmentNonInheritable, ax as File, aA as INHERIT_SYMBOL, aE as JSON_CONFIG_FORMATS, as as Json, O as Observability, aD as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, b as RawDevConfig, d as RawEnvironment, a as RedirectedRawConfig, h as Route, n as Rule, aB as SERVICE_TAG_PREFIX, aw as ServiceFetch, av as ServiceMetadataRes, S as StreamingTailConsumer, T as TailConsumer, az as Trigger, U as UserLimits, au as WorkerMetadata, l as WorkflowBinding, Z as ZoneIdRoute, f as ZoneNameRoute, e as defaultWranglerConfig } from './config-CnJQHRQs.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 '@cloudflare/workers-shared';
 import 'cloudflare';
 
@@ -181,7 +182,11 @@ declare class PatchConfigError extends Error {
  * Set to `true` to duplicate `message`.
  *  */
 type TelemetryMessage = {
-    telemetryMessage?: string | true;
+    telemetryMessage: string | boolean;
+};
+type UserErrorOptions = ErrorOptions & TelemetryMessage;
+type FatalErrorOptions = UserErrorOptions & {
+    code?: number;
 };
 /**
  * Base class for errors where the user has done something wrong. These are not
@@ -191,14 +196,14 @@ type TelemetryMessage = {
  */
 declare class UserError extends Error {
     telemetryMessage: string | undefined;
-    constructor(message?: string | undefined, options?: (ErrorOptions & TelemetryMessage) | undefined);
+    constructor(message: string, options: UserErrorOptions);
 }
 declare class DeprecationError extends UserError {
-    constructor(message: string, options?: TelemetryMessage);
+    constructor(message: string, options: TelemetryMessage);
 }
 declare class FatalError extends UserError {
-    readonly code?: number | undefined;
-    constructor(message?: string, code?: number | undefined, options?: TelemetryMessage);
+    readonly code: number | undefined;
+    constructor(message: string, options: FatalErrorOptions);
 }
 declare class CommandLineArgsError extends UserError {
 }
@@ -207,12 +212,12 @@ declare class CommandLineArgsError extends UserError {
  *
  * To use, pass stringify'd json into the constructor like so:
  * ```js
- * throw new JsonFriendlyFatalError(JSON.stringify({ error: messageToDisplay });
+ * throw new JsonFriendlyFatalError(JSON.stringify({ error: messageToDisplay }), {
+ *   telemetryMessage: false,
+ * });
  * ```
  */
 declare class JsonFriendlyFatalError extends FatalError {
-    readonly code?: number | undefined;
-    constructor(message?: string, code?: number | undefined, options?: TelemetryMessage);
 }
 declare class MissingConfigError extends Error {
     telemetryMessage: string | undefined;
@@ -223,14 +228,15 @@ declare class MissingConfigError extends Error {
  *
  * If `isJson` is true, then the `message` is JSON stringified.
  */
-declare function createFatalError(message: unknown, isJson: boolean, code?: number, telemetryMessage?: TelemetryMessage): Error;
+declare function createFatalError(message: unknown, isJson: boolean, options: FatalErrorOptions): Error;
 
 type Message = {
     text: string;
     location?: Location;
     notes?: Message[];
     kind?: "warning" | "error";
-} & TelemetryMessage;
+};
+type MessageInit = Message & TelemetryMessage;
 type Location = ParseFile & {
     line: number;
     column: number;
@@ -250,13 +256,13 @@ declare class ParseError extends UserError implements Message {
     readonly notes: Message[];
     readonly location?: Location;
     readonly kind: "warning" | "error";
-    constructor({ text, notes, location, kind, telemetryMessage }: Message);
+    constructor({ text, notes, location, kind, telemetryMessage }: MessageInit);
 }
 declare class APIError extends ParseError {
     #private;
     code?: number;
     accountTag?: string;
-    constructor({ status, ...rest }: Message & {
+    constructor({ status, ...rest }: MessageInit & {
         status?: number;
     });
     get status(): number | undefined;
@@ -831,4 +837,54 @@ declare function removeDir(dirPath: string, options?: {
  */
 declare function removeDirSync(dirPath: string): void;
 
-export { APIError, Binding, COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, CommandLineArgsError, type CompatDate, type ComplianceConfig, Config, type ConfigBindingFieldName, type ConfigBindingOptions, DeprecationError, Diagnostics, FatalError, JsonFriendlyFatalError, type Location, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, type PackageJSON, ParseError, type ParseFile, PatchConfigError, RawConfig, type ResolveConfigPathOptions, type TelemetryMessage, UserError, WorkerMetadataBinding, assertNever, bucketFormatMessage, configFileName, configFormat, createFatalError, experimental_patchConfig, experimental_readRawConfig, findWranglerConfig, formatConfigSnippet, friendlyBindingNames, 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, getLocalExplorerEnabledFromEnv, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTodaysCompatDate, getTraceHeader, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, hasProperty, indexLocation, isCompatDate, isDirectory, isDockerfile, isOptionalProperty, isPagesConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, searchLocation, validatePagesConfig };
+/**
+ * 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 {
+    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;
+}): Promise<ChildProcess>;
+
+interface TunnelResult {
+    publicUrl: URL;
+}
+interface Tunnel {
+    ready: () => Promise<TunnelResult>;
+    dispose: () => void;
+    extendExpiry: (ms?: number) => void;
+}
+interface TunnelOptions {
+    origin: URL;
+    timeoutMs?: number;
+    expiryMs?: number;
+    reminderIntervalMs?: number;
+    extendHint?: string;
+    logger?: Logger;
+}
+/**
+ * Start a Cloudflare Quick Tunnel for a local dev origin.
+ *
+ * Spawns `cloudflared tunnel --url <origin>` and waits for the public URL
+ * to appear in its stderr output. Returns a controller with a `ready()`
+ * promise that resolves once the tunnel URL is available, and a `dispose()`
+ * function to stop the tunnel.
+ */
+declare function startTunnel(options: TunnelOptions): Tunnel;
+
+export { APIError, Binding, COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, CommandLineArgsError, type CompatDate, type ComplianceConfig, Config, type ConfigBindingFieldName, type ConfigBindingOptions, DeprecationError, Diagnostics, FatalError, JsonFriendlyFatalError, type Location, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, type PackageJSON, ParseError, type ParseFile, PatchConfigError, RawConfig, type ResolveConfigPathOptions, type TelemetryMessage, type Tunnel, type TunnelOptions, UserError, WorkerMetadataBinding, assertNever, bucketFormatMessage, configFileName, configFormat, createFatalError, experimental_patchConfig, experimental_readRawConfig, findWranglerConfig, formatConfigSnippet, friendlyBindingNames, 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, getLocalExplorerEnabledFromEnv, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTodaysCompatDate, getTraceHeader, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, hasProperty, indexLocation, isCompatDate, isDirectory, isDockerfile, isOptionalProperty, isPagesConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, searchLocation, spawnCloudflared, startTunnel, validatePagesConfig };