@cloudflare/workers-utils 0.12.0 → 0.19.0

package/README.md

@@ -1,3 +1,5 @@
 # `@cloudflare/worker-utils`
 
-This package contains common utilities used across the dash, Wrangler, and other tooling
+> Internal utility package for workers-sdk. Not intended for external use — APIs may change without notice.
+
+This package contains common utilities used across the dash, Wrangler, and other tooling.

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { T as TailConsumer, an as WorkerMetadata, R as RawConfig } from './config-BQZJPwXe.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/browser.mjs

@@ -1,2 +1,3 @@
-export { constructWranglerConfig } from './chunk-4233U5MA.mjs';
-import './chunk-LDFBMPMW.mjs';
+export { constructWranglerConfig } from './chunk-BLWXWFJK.mjs';
+import './chunk-OZQVB3L3.mjs';
+import './chunk-DCOBXSFB.mjs';

package/dist/{chunk-4233U5MA.mjs → chunk-BLWXWFJK.mjs}

@@ -1,38 +1,7 @@
-import { __name, ENVIRONMENT_TAG_PREFIX, SERVICE_TAG_PREFIX } from './chunk-LDFBMPMW.mjs';
+import { ENVIRONMENT_TAG_PREFIX, SERVICE_TAG_PREFIX } from './chunk-OZQVB3L3.mjs';
+import { __name } from './chunk-DCOBXSFB.mjs';
 import assert from 'node:assert';
-import module from 'node:module';
-import path from 'node:path';
 
-function getLocalWorkerdCompatibilityDate({
-  projectPath = process.cwd()
-} = {}) {
-  try {
-    const projectRequire = module.createRequire(
-      path.join(projectPath, "package.json")
-    );
-    const miniflareEntry = projectRequire.resolve("miniflare");
-    const miniflareRequire = module.createRequire(miniflareEntry);
-    const miniflareWorkerd = miniflareRequire("workerd");
-    const workerdDate = miniflareWorkerd.compatibilityDate;
-    return {
-      date: toSafeCompatibilityDate(new Date(workerdDate)),
-      source: "workerd"
-    };
-  } catch {
-  }
-  return {
-    date: "2025-09-27",
-    source: "fallback"
-  };
-}
-__name(getLocalWorkerdCompatibilityDate, "getLocalWorkerdCompatibilityDate");
-function toSafeCompatibilityDate(date) {
-  if (date.getTime() > Date.now()) {
-    return formatCompatibilityDate(/* @__PURE__ */ new Date());
-  }
-  return formatCompatibilityDate(date);
-}
-__name(toSafeCompatibilityDate, "toSafeCompatibilityDate");
 function isCompatDate(str) {
   return /^\d{4}-\d{2}-\d{2}$/.test(str);
 }
@@ -43,6 +12,10 @@ function formatCompatibilityDate(date) {
   return compatDate;
 }
 __name(formatCompatibilityDate, "formatCompatibilityDate");
+function getTodaysCompatDate() {
+  return formatCompatibilityDate(/* @__PURE__ */ new Date());
+}
+__name(getTodaysCompatDate, "getTodaysCompatDate");
 
 // src/assert-never.ts
 function assertNever(_value) {
@@ -125,6 +98,13 @@ function mapWorkerMetadataBindings(bindings) {
           };
         }
         break;
+      case "stream":
+        {
+          configObj.stream = {
+            binding: binding.name
+          };
+        }
+        break;
       case "media":
         {
           configObj.media = {
@@ -156,6 +136,17 @@ function mapWorkerMetadataBindings(bindings) {
           ];
         }
         break;
+      case "artifacts":
+        {
+          configObj.artifacts = [
+            ...configObj.artifacts ?? [],
+            {
+              binding: binding.name,
+              namespace: binding.namespace
+            }
+          ];
+        }
+        break;
       case "unsafe_hello_world": {
         configObj.unsafe_hello_world = [
           ...configObj.unsafe_hello_world ?? [],
@@ -166,6 +157,16 @@ function mapWorkerMetadataBindings(bindings) {
         ];
         break;
       }
+      case "flagship": {
+        configObj.flagship = [
+          ...configObj.flagship ?? [],
+          {
+            binding: binding.name,
+            app_id: binding.app_id
+          }
+        ];
+        break;
+      }
       case "service":
         {
           configObj.services = [
@@ -281,6 +282,24 @@ function mapWorkerMetadataBindings(bindings) {
           }
         ];
         break;
+      case "ai_search_namespace":
+        configObj.ai_search_namespaces = [
+          ...configObj.ai_search_namespaces ?? [],
+          {
+            binding: binding.name,
+            namespace: binding.namespace
+          }
+        ];
+        break;
+      case "ai_search":
+        configObj.ai_search = [
+          ...configObj.ai_search ?? [],
+          {
+            binding: binding.name,
+            instance_name: binding.instance_name
+          }
+        ];
+        break;
       case "hyperdrive":
         configObj.hyperdrive = [
           ...configObj.hyperdrive ?? [],
@@ -371,6 +390,21 @@ function mapWorkerMetadataBindings(bindings) {
           ];
         }
         break;
+      case "vpc_network":
+        {
+          if (binding.tunnel_id !== void 0) {
+            configObj.vpc_networks = [
+              ...configObj.vpc_networks ?? [],
+              { binding: binding.name, tunnel_id: binding.tunnel_id }
+            ];
+          } else if (binding.network_id !== void 0) {
+            configObj.vpc_networks = [
+              ...configObj.vpc_networks ?? [],
+              { binding: binding.name, network_id: binding.network_id }
+            ];
+          }
+        }
+        break;
       default: {
         configObj.unsafe = {
           bindings: [...configObj.unsafe?.bindings ?? [], binding],
@@ -399,7 +433,9 @@ function convertWorkerToWranglerConfig(config) {
     ...config.domains.map((c) => ({
       pattern: c.hostname,
       zone_name: c.zone_name,
-      custom_domain: true
+      custom_domain: true,
+      enabled: c.enabled,
+      previews_enabled: c.previews_enabled
     }))
   ];
   return {
@@ -407,7 +443,7 @@ function convertWorkerToWranglerConfig(config) {
     main: config.entrypoint,
     workers_dev: config.subdomain.enabled,
     preview_urls: config.subdomain.previews_enabled,
-    compatibility_date: config.compatibility_date ?? formatCompatibilityDate(/* @__PURE__ */ new Date()),
+    compatibility_date: config.compatibility_date ?? getTodaysCompatDate(),
     compatibility_flags: config.compatibility_flags,
     ...allRoutes.length ? { routes: allRoutes } : {},
     placement: config.placement?.mode === "smart" ? { mode: "smart" } : void 0,
@@ -468,4 +504,4 @@ function constructWranglerConfig(workerOrWorkers) {
 }
 __name(constructWranglerConfig, "constructWranglerConfig");
 
-export { assertNever, constructWranglerConfig, formatCompatibilityDate, getLocalWorkerdCompatibilityDate, isCompatDate, mapWorkerMetadataBindings };
+export { assertNever, constructWranglerConfig, getTodaysCompatDate, isCompatDate, mapWorkerMetadataBindings };

package/dist/{chunk-LDFBMPMW.mjs → chunk-DCOBXSFB.mjs}

@@ -36,11 +36,4 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// src/constants.ts
-var INHERIT_SYMBOL = Symbol.for("inherit_binding");
-var SERVICE_TAG_PREFIX = "cf:service=";
-var ENVIRONMENT_TAG_PREFIX = "cf:environment=";
-var PATH_TO_DEPLOY_CONFIG = ".wrangler/deploy/config.json";
-var JSON_CONFIG_FORMATS = ["json", "jsonc"];
-
-export { ENVIRONMENT_TAG_PREFIX, INHERIT_SYMBOL, JSON_CONFIG_FORMATS, PATH_TO_DEPLOY_CONFIG, SERVICE_TAG_PREFIX, __commonJS, __export, __name, __reExport, __require, __toESM };
+export { __commonJS, __export, __name, __reExport, __require, __toESM };

package/dist/chunk-O4YGOZSW.mjs

@@ -0,0 +1,52 @@
+import { __name } from './chunk-DCOBXSFB.mjs';
+
+// src/prometheus-metrics.ts
+var MetricsRegistry = class {
+  static {
+    __name(this, "MetricsRegistry");
+  }
+  counters = [];
+  /**
+   * Create and register a new counter metric.
+   *
+   * @param name - The metric name (e.g. "service_request_total")
+   * @param help - A human-readable description of the metric
+   * @returns A Counter that can be incremented
+   */
+  createCounter(name, help) {
+    const entry = { name, help, value: 0 };
+    this.counters.push(entry);
+    return {
+      inc: /* @__PURE__ */ __name(() => {
+        entry.value++;
+      }, "inc"),
+      add: /* @__PURE__ */ __name((amount) => {
+        if (amount < 0) {
+          throw new Error("Counter value cannot decrease");
+        }
+        entry.value += amount;
+      }, "add")
+    };
+  }
+  /**
+   * Serialize all registered metrics in Prometheus text exposition format.
+   *
+   * @see https://prometheus.io/docs/instrumenting/exposition_formats/#text-based-format
+   */
+  metrics() {
+    return this.counters.map((c) => {
+      let result = "";
+      if (c.help.length > 0) {
+        result += `# HELP ${c.name} ${c.help}
+`;
+      }
+      result += `# TYPE ${c.name} counter
+`;
+      result += `${c.name} ${c.value}
+`;
+      return result;
+    }).join("");
+  }
+};
+
+export { MetricsRegistry };

package/dist/chunk-OZQVB3L3.mjs

@@ -0,0 +1,8 @@
+// src/constants.ts
+var INHERIT_SYMBOL = Symbol.for("inherit_binding");
+var SERVICE_TAG_PREFIX = "cf:service=";
+var ENVIRONMENT_TAG_PREFIX = "cf:environment=";
+var PATH_TO_DEPLOY_CONFIG = ".wrangler/deploy/config.json";
+var JSON_CONFIG_FORMATS = ["json", "jsonc"];
+
+export { ENVIRONMENT_TAG_PREFIX, INHERIT_SYMBOL, JSON_CONFIG_FORMATS, PATH_TO_DEPLOY_CONFIG, SERVICE_TAG_PREFIX };

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

@@ -1,4 +1,5 @@
-import { __name, PATH_TO_DEPLOY_CONFIG } from './chunk-LDFBMPMW.mjs';
+import { PATH_TO_DEPLOY_CONFIG } from './chunk-OZQVB3L3.mjs';
+import { __name } from './chunk-DCOBXSFB.mjs';
 import fs, { readFileSync as readFileSync$1, statSync, existsSync } from 'node:fs';
 import path, { resolve, isAbsolute, dirname, join } from 'node:path';
 
@@ -11,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 {
@@ -24,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 {
@@ -38,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");
   }
@@ -56,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");
 
@@ -2373,6 +2366,9 @@ var APIError = class extends ParseError {
     this.name = this.constructor.name;
     this.#status = status;
   }
+  get status() {
+    return this.#status;
+  }
   isGatewayError() {
     if (this.#status !== void 0) {
       return [524].includes(this.#status);
@@ -2452,7 +2448,8 @@ function readFileSyncToBuffer(file2) {
         {
           text: message.replace(file2, resolve(file2))
         }
-      ]
+      ],
+      telemetryMessage: false
     });
   }
 }
@@ -2780,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 {