@cloudflare/workers-utils 0.11.2 → 0.18.0

package/dist/index.d.mts

@@ -1,7 +1,8 @@
-import { B as Binding, R as RawConfig, C as Config, W as WorkerMetadataBinding } from './config-DAxLpjUL.mjs';
-export { al as AssetConfigMetadata, A as Assets, aq as BinaryFile, G as CfAIBinding, a3 as CfAnalyticsEngineDataset, a8 as CfAssetsBinding, F as CfBrowserBinding, ab as CfCapnp, Q as CfD1Database, K as CfDataBlobBindings, a4 as CfDispatchNamespace, L as CfDurableObject, ad as CfDurableObjectMigrations, Y as CfHelloWorld, a0 as CfHyperdrive, H as CfImagesBinding, w as CfKvNamespace, a6 as CfLogfwdr, a7 as CfLogfwdrBinding, a5 as CfMTlsCertificate, I as CfMediaBinding, u as CfModule, t as CfModuleType, a9 as CfPipeline, ae as CfPlacement, N as CfQueue, P as CfR2Bucket, $ as CfRateLimit, s as CfScriptFormat, X as CfSecretsStoreSecrets, x as CfSendEmailBindings, a1 as CfService, af as CfTailConsumer, z as CfTextBlobBindings, ac as CfUnsafe, aa as CfUnsafeBinding, ag as CfUserLimits, v as CfVars, V as CfVectorize, J as CfVersionMetadataBinding, a2 as CfVpcService, y as CfWasmModuleBindings, ai as CfWorkerContext, ah as CfWorkerInit, _ as CfWorkerLoader, aj as CfWorkerSourceMap, M as CfWorkflow, i as CloudchamberConfig, c as ConfigFields, o as ConfigModuleRuleType, j as ContainerApp, r as ContainerEngine, g as CustomDomainRoute, p as DispatchNamespaceOutbound, q as DockerConfiguration, k as DurableObjectBindings, D as DurableObjectMigration, au as ENVIRONMENT_TAG_PREFIX, E as Environment, m as EnvironmentNonInheritable, ap as File, as as INHERIT_SYMBOL, aw as JSON_CONFIG_FORMATS, ak as Json, O as Observability, av as PATH_TO_DEPLOY_CONFIG, b as RawDevConfig, d as RawEnvironment, a as RedirectedRawConfig, h as Route, n as Rule, at as SERVICE_TAG_PREFIX, ao as ServiceFetch, an as ServiceMetadataRes, S as StreamingTailConsumer, T as TailConsumer, ar as Trigger, U as UserLimits, am as WorkerMetadata, l as WorkflowBinding, Z as ZoneIdRoute, f as ZoneNameRoute, e as defaultWranglerConfig } from './config-DAxLpjUL.mjs';
+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 * as jsoncParser from 'jsonc-parser';
 export { constructWranglerConfig } from './browser.mjs';
+export { Counter, MetricsRegistry } from './prometheus-metrics.mjs';
 import '@cloudflare/workers-shared';
 import 'cloudflare';
 
@@ -49,6 +50,8 @@ declare class Diagnostics {
     errors: string[];
     warnings: string[];
     children: Diagnostics[];
+    /** Set to true when an unexpected/unknown field is encountered during validation. */
+    hasUnexpectedFields: boolean;
     /**
      * Create a new Diagnostics object.
      * @param description A general description of this collection of messages.
@@ -60,6 +63,8 @@ declare class Diagnostics {
     addChild(diagnostics: Diagnostics): void;
     /** Does this or any of its children have errors. */
     hasErrors(): boolean;
+    /** Does this or any of its children have unexpected fields. */
+    hasUnexpectedFieldsInTree(): boolean;
     /** Render the errors of this and all its children. */
     renderErrors(): string;
     /** Does this or any of its children have warnings. */
@@ -83,7 +88,7 @@ declare const bucketFormatMessage = "Bucket names must begin and end with an alp
  * Config field names for bindings (e.g., "kv_namespaces", "d1_databases").
  * These are the keys used in Wrangler's config file
  */
-type ConfigBindingFieldName = "data_blobs" | "durable_objects" | "kv_namespaces" | "send_email" | "queues" | "d1_databases" | "vectorize" | "hyperdrive" | "r2_buckets" | "logfwdr" | "services" | "analytics_engine_datasets" | "text_blobs" | "browser" | "ai" | "images" | "media" | "version_metadata" | "unsafe" | "vars" | "wasm_modules" | "dispatch_namespaces" | "mtls_certificates" | "workflows" | "pipelines" | "secrets_store_secrets" | "ratelimits" | "assets" | "unsafe_hello_world" | "worker_loaders" | "vpc_services";
+type ConfigBindingFieldName = "data_blobs" | "durable_objects" | "kv_namespaces" | "send_email" | "queues" | "d1_databases" | "vectorize" | "ai_search_namespaces" | "ai_search" | "hyperdrive" | "r2_buckets" | "logfwdr" | "services" | "analytics_engine_datasets" | "text_blobs" | "browser" | "ai" | "images" | "stream" | "media" | "version_metadata" | "unsafe" | "vars" | "wasm_modules" | "dispatch_namespaces" | "mtls_certificates" | "workflows" | "pipelines" | "secrets_store_secrets" | "artifacts" | "ratelimits" | "assets" | "unsafe_hello_world" | "flagship" | "worker_loaders" | "vpc_services" | "vpc_networks";
 /**
  * @deprecated new code should use getBindingTypeFriendlyName() instead
  */
@@ -133,6 +138,8 @@ declare function normalizeAndValidateConfig(rawConfig: RawConfig, configPath: st
  */
 declare function isDockerfile(imagePath: string, configPath: string | undefined): boolean;
 
+type ConfigBindingOptions = Pick<Config, "ai" | "browser" | "d1_databases" | "dispatch_namespaces" | "durable_objects" | "queues" | "r2_buckets" | "services" | "kv_namespaces" | "mtls_certificates" | "vectorize" | "workflows" | "vpc_services">;
+
 declare function configFormat(configPath: string | undefined): "json" | "jsonc" | "toml" | "none";
 declare function configFileName(configPath: string | undefined): "wrangler.json" | "wrangler.jsonc" | "wrangler.toml" | "Wrangler configuration";
 declare function formatConfigSnippet(snippet: RawConfig, configPath: Config["configPath"], formatted?: boolean): string;
@@ -252,6 +259,7 @@ declare class APIError extends ParseError {
     constructor({ status, ...rest }: Message & {
         status?: number;
     });
+    get status(): number | undefined;
     isGatewayError(): boolean;
     isRetryable(): boolean;
     get reportable(): boolean;
@@ -432,6 +440,8 @@ type VariableNames =
  | "CLOUDFLARE_ENV"
 /** Custom directory for Wrangler's cache files (overrides `node_modules/.cache/wrangler`). */
  | "WRANGLER_CACHE_DIR"
+/** Custom path to cloudflared binary (overrides automatic binary management). */
+ | "CLOUDFLARED_PATH"
 /** Set to "staging" to use staging APIs instead of production. */
  | "WRANGLER_API_ENVIRONMENT"
 /** Custom auth domain (usually auto-configured). */
@@ -446,8 +456,14 @@ type VariableNames =
  | "WRANGLER_REVOKE_URL"
 /** Direct authorization token for API requests. */
  | "WRANGLER_CF_AUTHORIZATION_TOKEN"
+/** Cloudflare Access Service Token Client ID. Used to authenticate with Access-protected domains in non-interactive environments (e.g. CI). */
+ | "CLOUDFLARE_ACCESS_CLIENT_ID"
+/** Cloudflare Access Service Token Client Secret. Used with CLOUDFLARE_ACCESS_CLIENT_ID. */
+ | "CLOUDFLARE_ACCESS_CLIENT_SECRET"
 /** Enable the local explorer UI at /cdn-cgi/explorer (experimental, default: false). */
  | "X_LOCAL_EXPLORER"
+/** Open the browser in headful (visible) mode when using the Browser Run API in local dev (default: false). */
+ | "X_BROWSER_HEADFUL"
 /** Override command used by `wrangler init` (default: "create cloudflare"). */
  | "WRANGLER_C3_COMMAND"
 /** Enable/disable telemetry data collection. */
@@ -694,9 +710,23 @@ declare const getCloudflareEnv: () => string | undefined;
 declare const getOpenNextDeployFromEnv: () => string | undefined;
 /**
  * `X_LOCAL_EXPLORER` enables the local explorer UI at /cdn-cgi/explorer.
- * This is an experimental feature flag. Defaults to false when not set.
  */
 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.
@@ -733,6 +763,13 @@ declare const getCfFetchPathFromEnv: () => string | undefined;
  * Useful for Yarn PnP or projects without node_modules.
  */
 declare const getWranglerCacheDirFromEnv: () => string | undefined;
+/**
+ * `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.
+ */
+declare const getCloudflaredPathFromEnv: () => string | undefined;
 
 declare function getGlobalWranglerConfigPath(): string;
 
@@ -743,24 +780,6 @@ type DD = `${number}${number}`;
  * Represents a valid compatibility date, a string such as `2025-09-27`
  */
 type CompatDate = `${YYYY}-${MM}-${DD}`;
-type GetCompatDateOptions = {
-    projectPath?: string;
-};
-type GetCompatDateResult = {
-    date: CompatDate;
-    source: "workerd" | "fallback";
-};
-/**
- * Gets the compatibility date of the locally installed workerd package.
- *
- * If the package is not found the fallback date of 2025-09-27 is returned instead.
- *
- * Additionally, if the workerd date is set to the future then the current date is returned instead.
- *
- * @param options.projectPath the path to the project
- * @returns an object including the compatibility date and its source
- */
-declare function getLocalWorkerdCompatibilityDate({ projectPath, }?: GetCompatDateOptions): GetCompatDateResult;
 /**
  * Discern whether a string represents a compatibility date (`YYYY-MM-DD`)
  *
@@ -769,12 +788,9 @@ declare function getLocalWorkerdCompatibilityDate({ projectPath, }?: GetCompatDa
  */
 declare function isCompatDate(str: string): str is CompatDate;
 /**
- * Returns the date formatted as a compatibility date
- *
- * @param date The target date to convert
- * @returns The date as a CompatDate string (a string following the format `YYYY-MM-DD`)
+ * Returns today's date as a compatibility date string (`YYYY-MM-DD`).
  */
-declare function formatCompatibilityDate(date: Date): CompatDate;
+declare function getTodaysCompatDate(): CompatDate;
 
 /**
  * Returns whether the given path is a directory
@@ -815,4 +831,4 @@ 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, DeprecationError, 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, formatCompatibilityDate, formatConfigSnippet, friendlyBindingNames, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getBuildConditionsFromEnv, getBuildPlatformFromEnv, getC3CommandFromEnv, getCIGeneratePreviewAlias, getCIMatchTag, getCIOverrideName, getCIOverrideNetworkModeHost, getCfFetchEnabledFromEnv, getCfFetchPathFromEnv, getCloudflareApiBaseUrl, getCloudflareApiEnvironmentFromEnv, getCloudflareComplianceRegion, getCloudflareEnv, getCloudflareIncludeProcessEnvFromEnv, getCloudflareLoadDevVarsFromDotEnv, getComplianceRegionSubdomain, getD1ExtraLocationChoices, getDisableConfigWatching, getDockerPath, getEnvironmentVariableFactory, getGlobalWranglerConfigPath, getLocalExplorerEnabledFromEnv, getLocalWorkerdCompatibilityDate, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, 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 };
+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 };