@nightintelligence/cloudflare-workers-utils 0.35.0-patch2 → 0.35.0-patch3

package/dist/zod-format.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"zod-format.mjs"}
+{"version":3,"sources":["../src/zod-format.ts"],"names":["$colors"],"mappings":"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","file":"zod-format.mjs","sourcesContent":["// noinspection JSUnusedAssignment\n// ^ WebStorm incorrectly thinks some variables might not have been initialised\n//   before use without this. TypeScript is better at catching these errors. :)\n\nimport assert from \"node:assert\";\nimport util from \"node:util\";\nimport {\n\t$ as $colors,\n\tblue,\n\tcyan,\n\tdim,\n\tgreen,\n\tmagenta,\n\tred,\n\tyellow,\n} from \"kleur/colors\";\nimport type { z } from \"zod\";\n\nconst originalEnabled = $colors.enabled;\n\n// `kleur` is marked as a dev dependency, so will get bundled. We'd still like\n// to be able to control whether it's enabled in tests though. Therefore, export\n// a function that toggles the enabled state of our bundled version.\nexport function _forceColour(enabled = originalEnabled) {\n\t$colors.enabled = enabled;\n}\n\n// This file contains a `formatZodError(error, input)` function for formatting\n// a Zod `error` that came from parsing a specific `input`. This works by\n// building an \"annotated\" version of the `input`, with roughly the same shape,\n// but including messages from the `error`. This is then printed to a string.\n//\n// When the Zod `error` includes an issue at a specific path, that path is\n// replaced with an `Annotation` in the \"annotated\" version. This `Annotation`,\n// includes any messages for that path, along with the actual value at that\n// path. `Annotation`s may be grouped if they are part of a union. In this case,\n// they'll be printed in a different colour and with a group ID to indicate that\n// only one of the issues needs to be fixed for all issues in the group to be\n// resolved.\n//\n// This is best illustrated with some examples:\n//\n// # Primitive Input\n//\n// ```\n// const schema = z.boolean();\n// const input = 42;\n// const error = schema.safeParse(input).error;\n//       ↳ ZodError [\n//           {\n//             \"code\": \"invalid_type\",\n//             \"expected\": \"boolean\",\n//             \"received\": \"number\",\n//             \"path\": [],\n//             \"message\": \"Expected boolean, received number\"\n//           }\n//         ]\n//\n// /* Annotated */\n// {\n//   [Symbol(kMessages)]: [ 'Expected boolean, received number' ],\n//   [Symbol(kActual)]: 42\n// }\n//\n// const formatted = formatZodError(error, input);\n//       ↳ 42\n//         ^ Expected boolean, received number\n// ```\n//\n// In this example, we only have a single issue, with `\"path\": []`. This path\n// represents the root, so the root of the input has been replaced with an\n// annotation in the annotated version.\n//\n// ### Object Input\n//\n// ````\n// const schema = z.object({ a: z.number(), b: z.number(), c: z.object({ d: z.number() })});\n// const input = { a: false, b: 42, c: { d: \"not a number\" } };\n// const error = schema.safeParse(input).error;\n//       ↳ ZodError: [\n//           {\n//             \"code\": \"invalid_type\",\n//             \"expected\": \"number\",\n//             \"received\": \"boolean\",\n//             \"path\": [ \"a\" ],\n//             \"message\": \"Expected number, received boolean\"\n//           },\n//           {\n//             \"code\": \"invalid_type\",\n//             \"expected\": \"number\",\n//             \"received\": \"string\",\n//             \"path\": [ \"c\", \"d\" ],\n//             \"message\": \"Expected number, received boolean\"\n//           }\n//         ]\n//\n// /* Annotated after 1st issue */\n// {\n//   a: {\n//     [Symbol(kMessages)]: [ 'Expected number, received boolean' ],\n//     [Symbol(kActual)]: false\n//   },\n//   b: undefined,\n//   c: undefined,\n// }\n//\n// /* Annotated after 2nd issue */\n// {\n//   a: {\n//     [Symbol(kMessages)]: [ 'Expected number, received boolean' ],\n//     [Symbol(kActual)]: false\n//   },\n//   b: undefined,\n//   c: {\n//     d: {\n//       [Symbol(kMessages)]: [ 'Expected number, received string' ],\n//       [Symbol(kActual)]: 'not a number'\n//     }\n//   }\n// }\n//\n// const formatted = formatZodError(error, input);\n//       ↳ {\n//           a: false,\n//              ^ Expected number, received boolean\n//           ...,\n//           c: {\n//             d: true,\n//                ^ Expected number, received boolean\n//           },\n//         }\n// ````\n//\n// If the error contains multiple issues, we annotate them one at a time.\n// For object inputs, the annotated object starts out with the same keys as\n// the object, just with `undefined` values. Keys with values that are\n// `undefined` at the end of annotation will be printed as \"...\". Annotations\n// are inserted on paths where there are issues. Note annotations are\n// effectively the leaves of the annotated tree.\n//\n// ### Array Input\n//\n// ```\n// const schema = z.array(z.number());\n// const input = [1, 2, false, 4];\n// const error = schema.safeParse(input).error;\n//       ↳ ZodError: [\n//            {\n//              \"code\": \"invalid_type\",\n//              \"expected\": \"number\",\n//              \"received\": \"boolean\",\n//              \"path\": [ 2 ],\n//              \"message\": \"Expected number, received boolean\"\n//            }\n//          ]\n//\n// /* Annotated */\n// [\n//   <2 empty items>,\n//   {\n//     [Symbol(kMessages)]: [ 'Expected number, received boolean' ],\n//     [Symbol(kActual)]: false\n//   },\n//   <1 empty item>\n// ]\n//\n// const formatted = formatZodError(error, input);\n//       ↳ [\n//           ...,\n//           /* [2] */ false,\n//                     ^ Expected number, received boolean\n//           ...,\n//         ]\n// ```\n//\n// In this case the annotated value is now an array, rather than a plain-object,\n// to match the shape of the input. Note it has the same length as the input,\n// including empty items for array indices that don't have errors. Empty items\n// will be coalesced and printed as \"...\".\n//\n// ### Union Schema and Groups\n//\n// ```\n// const schema = z.union([z.object({ a: z.number() }), z.object({ b: z.string() })]);\n// const input = { c: false };\n// const error = schema.safeParse(input).error;\n//       ↳ [\n//           {\n//             \"code\": \"invalid_union\",\n//             \"path\": [],\n//             \"message\": \"Invalid input\",\n//             \"unionErrors\": [\n//               {\n//                 \"name\": \"ZodError\",\n//                 \"issues\": [\n//                   {\n//                     \"code\": \"invalid_type\",\n//                     \"expected\": \"number\",\n//                     \"received\": \"undefined\",\n//                     \"path\": [ \"a\" ],\n//                     \"message\": \"Required\"\n//                   }\n//                 ]\n//               },\n//               {\n//                 \"name\": \"ZodError\",\n//                 \"issues\": [\n//                   {\n//                     \"code\": \"invalid_type\",\n//                     \"expected\": \"string\",\n//                     \"received\": \"undefined\",\n//                     \"path\": [ \"b\" ],\n//                     \"message\": \"Required\"\n//                   }\n//                 ]\n//               }\n//             ]\n//           }\n//         ]\n//\n// /* Annotated */\n// {\n//   c: undefined,\n//   a: {\n//     [Symbol(kMessages)]: [ 'Required' ],\n//     [Symbol(kActual)]: undefined,\n//     [Symbol(kGroupId)]: 0\n//   },\n//   b: {\n//     [Symbol(kMessages)]: [ 'Required' ],\n//     [Symbol(kActual)]: undefined,\n//     [Symbol(kGroupId)]: 0\n//   }\n// }\n//\n// const formatted = formatZodError(error, input);\n//       ↳ {\n//           ...,\n//           a: undefined,\n//              ^1 Required *or*\n//           b: undefined,\n//              ^1 Required\n//         }\n// ```\n//\n// In this case, fixing either of the reported issues would solve the problem.\n// To indicate this, we \"group\" issues contained within `unionErrors`. See how\n// annotations have a `[Symbol(kGroupId)]: 0`. Group IDs are 0-indexed\n// internally but 1-indexed when displayed (see \"^1\"). Each group's messages\n// are displayed in a different colour to visually group them. Note the\n// unhelpful \"Invalid input\" message has been hidden. Required options that\n// are not present in the `input` are added to the end of the annotated input.\n//\n\nconst kMessages = Symbol(\"kMessages\");\nconst kActual = Symbol(\"kActual\");\nconst kGroupId = Symbol(\"kGroupId\");\n\n// Set of Zod error messages attached to a specific path in the input\ninterface Annotation {\n\t// Error messages at this specific path in the annotated tree. A path may have\n\t// multiple messages associated with it if the schema is a union/intersection.\n\t[kMessages]: string[];\n\t// The input value at this specific path\n\t[kActual]: unknown;\n\t// Optional 0-indexed group for this annotation. Fixing a single issue in a\n\t// group will usually fix all other issues in the group. Grouped annotations\n\t// are displayed in a different colour with their 1-indexed group ID.\n\t[kGroupId]?: number;\n}\n\n// Object with the same shape as the input, but with undefined at the leaves,\n// or an annotation iff there's an issue at that specific path.\ntype Annotated =\n\t| undefined\n\t| Annotation\n\t| { [key: string]: Annotated }\n\t| Annotated[];\n\n// `green` is a success colour, so only use it for groups if really needed\nconst groupColours = [yellow, /* (green) */ cyan, blue, magenta, green];\n\n// Maps group IDs to the number of annotations in that group. Used to determine\n// whether this isn't the last annotation in a group, and \"or\" should be printed\n// with the message.\nconst GroupCountsMap = Map<number /* [kGroupId] */, number /* count */>;\ntype GroupCountsMap = InstanceType<typeof GroupCountsMap>;\n\nfunction isAnnotation(value: unknown): value is Annotation {\n\treturn (\n\t\ttypeof value === \"object\" &&\n\t\tvalue !== null &&\n\t\tkMessages in value &&\n\t\tkActual in value\n\t);\n}\n\nfunction isRecord(value: unknown): value is Record<string | number, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction arrayShallowEqual<T>(a: T[], b: T[]) {\n\tif (a.length !== b.length) {\n\t\treturn false;\n\t}\n\tfor (let i = 0; i < a.length; i++) {\n\t\tif (a[i] !== b[i]) {\n\t\t\treturn false;\n\t\t}\n\t}\n\treturn true;\n}\n\nfunction issueEqual(a: z.core.$ZodIssue, b: z.core.$ZodIssue) {\n\t// We consider issues to be equal if their messages and paths are\n\treturn a.message === b.message && arrayShallowEqual(a.path, b.path);\n}\n\nfunction hasMultipleDistinctMessages(\n\tissues: z.core.$ZodIssue[],\n\tatDepth: number\n) {\n\t// Returns true iff `issues` has issues that aren't \"the same\" at the\n\t// specified depth or below\n\tlet firstIssue: z.core.$ZodIssue | undefined;\n\tfor (const issue of issues) {\n\t\tif (issue.path.length < atDepth) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (firstIssue === undefined) {\n\t\t\tfirstIssue = issue;\n\t\t} else if (!issueEqual(firstIssue, issue)) {\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n}\n\nfunction annotate(\n\tgroupCounts: GroupCountsMap,\n\tannotated: Annotated,\n\tinput: unknown,\n\tissue: z.core.$ZodIssue,\n\tpath: (string | number)[],\n\tgroupId?: number\n): Annotated {\n\tif (path.length === 0) {\n\t\t// Empty path, `input` has incorrect shape\n\n\t\t// If this is an `invalid_union` error, make sure we include all sub-issues\n\t\tif (issue.code === \"invalid_union\") {\n\t\t\t// In zod v4, `issue.errors` is `$ZodIssue[][]` where each inner\n\t\t\t// array holds the issues for one union branch.\n\t\t\tconst allBranchIssues = issue.errors;\n\t\t\tconst unionIssues = allBranchIssues.flat();\n\n\t\t\t// In zod v4, discriminated unions with an invalid discriminator\n\t\t\t// produce an `invalid_union` issue with an empty `errors` array\n\t\t\t// and the error message on the issue itself. Fall through to\n\t\t\t// treat it as a regular annotation in that case.\n\t\t\tif (unionIssues.length > 0) {\n\t\t\t\t// If the `input` is an object/array with multiple distinct messages,\n\t\t\t\t// annotate it as a group\n\t\t\t\t// In zod v4, branch issue paths are already relative to the union\n\t\t\t\t// issue, so use depth 1 (deeper than current level 0) rather than\n\t\t\t\t// issue.path.length + 1.\n\t\t\t\tconst multipleDistinct = hasMultipleDistinctMessages(unionIssues, 1);\n\n\t\t\t\tlet newGroupId: number | undefined;\n\t\t\t\tif (isRecord(input) && multipleDistinct) {\n\t\t\t\t\tnewGroupId = groupCounts.size;\n\t\t\t\t\tgroupCounts.set(newGroupId, 0);\n\t\t\t\t}\n\n\t\t\t\tfor (const branchIssues of allBranchIssues) {\n\t\t\t\t\tfor (const unionIssue of branchIssues) {\n\t\t\t\t\t\t// In zod v4, branch issue paths are already relative to the\n\t\t\t\t\t\t// union issue (not absolute), so use them directly.\n\t\t\t\t\t\tconst unionPath = unionIssue.path as (string | number)[];\n\t\t\t\t\t\t// If we have multiple distinct messages at deeper levels, and this\n\t\t\t\t\t\t// issue is for the current path, skip it, so we don't end up annotating\n\t\t\t\t\t\t// the current path and sub-paths\n\t\t\t\t\t\tif (multipleDistinct && unionPath.length === 0) {\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tannotated = annotate(\n\t\t\t\t\t\t\tgroupCounts,\n\t\t\t\t\t\t\tannotated,\n\t\t\t\t\t\t\tinput,\n\t\t\t\t\t\t\tunionIssue,\n\t\t\t\t\t\t\tunionPath,\n\t\t\t\t\t\t\tnewGroupId\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn annotated;\n\t\t\t}\n\t\t}\n\n\t\tconst message = issue.message;\n\t\t// If we've already annotated this path (existing annotation or union)...\n\t\tif (annotated !== undefined) {\n\t\t\t// ...and if this is a new message for an existing annotation...\n\t\t\tif (isAnnotation(annotated) && !annotated[kMessages].includes(message)) {\n\t\t\t\t// ...add it\n\t\t\t\tannotated[kMessages].push(message);\n\t\t\t}\n\t\t\treturn annotated;\n\t\t}\n\n\t\t// Creating a new annotation\n\n\t\t// If this new annotation is part of a group...\n\t\tif (groupId !== undefined) {\n\t\t\t// ...increment that group's count\n\t\t\tconst current = groupCounts.get(groupId);\n\t\t\tassert(current !== undefined);\n\t\t\tgroupCounts.set(groupId, current + 1);\n\t\t}\n\n\t\treturn <Annotation>{\n\t\t\t[kMessages]: [message],\n\t\t\t[kActual]: input,\n\t\t\t[kGroupId]: groupId,\n\t\t};\n\t}\n\n\t// Non-empty path, `input` should be an object or array\n\tconst [head, ...tail] = path;\n\tassert(isRecord(input), \"Expected object/array input for nested issue\");\n\tif (annotated === undefined) {\n\t\t// Initialise `annotated` to look like `input`, with empty slots for keys\n\t\tif (Array.isArray(input)) {\n\t\t\tannotated = new Array(input.length);\n\t\t} else {\n\t\t\tconst entries = Object.keys(input).map((key) => [key, undefined]);\n\t\t\tannotated = Object.fromEntries(entries);\n\t\t}\n\t}\n\tassert(isRecord(annotated), \"Expected object/array for nested issue\");\n\t// Recursively annotate\n\tannotated[head] = annotate(\n\t\tgroupCounts,\n\t\tannotated[head],\n\t\tinput[head],\n\t\tissue,\n\t\ttail,\n\t\tgroupId\n\t);\n\treturn annotated;\n}\n\ninterface PrintExtras {\n\tprefix?: string;\n\tsuffix?: string;\n}\nfunction print(\n\tinspectOptions: util.InspectOptions,\n\tgroupCounts: GroupCountsMap,\n\tannotated: Annotated,\n\tindent = \"\",\n\textras?: PrintExtras\n): string {\n\tconst prefix = extras?.prefix ?? \"\";\n\tconst suffix = extras?.suffix ?? \"\";\n\n\tif (isAnnotation(annotated)) {\n\t\tconst prefixIndent = indent + \" \".repeat(prefix.length);\n\n\t\t// Print actual value\n\t\tconst actual = util.inspect(annotated[kActual], inspectOptions);\n\t\tconst actualIndented = actual\n\t\t\t.split(\"\\n\")\n\t\t\t.map((line, i) => (i > 0 ? prefixIndent + line : line))\n\t\t\t.join(\"\\n\");\n\n\t\t// Print message\n\t\tlet messageColour = red;\n\t\tlet messagePrefix = prefixIndent + \"^\";\n\t\tlet groupOr = \"\";\n\t\tif (annotated[kGroupId] !== undefined) {\n\t\t\t// If this annotation was part of a group, set the message colour based\n\t\t\t// on the group, and include the group ID in the prefix\n\t\t\tmessageColour = groupColours[annotated[kGroupId] % groupColours.length];\n\t\t\tmessagePrefix += annotated[kGroupId] + 1;\n\t\t\tconst remaining = groupCounts.get(annotated[kGroupId]);\n\t\t\tassert(remaining !== undefined);\n\t\t\tif (remaining > 1) {\n\t\t\t\tgroupOr = \" *or*\";\n\t\t\t}\n\t\t\tgroupCounts.set(annotated[kGroupId], remaining - 1);\n\t\t}\n\t\tmessagePrefix += \" \";\n\n\t\tconst messageIndent = \" \".repeat(messagePrefix.length);\n\t\tconst messageIndented = annotated[kMessages]\n\t\t\t.flatMap((m) => m.split(\"\\n\"))\n\t\t\t.map((line, i) => (i > 0 ? messageIndent + line : line))\n\t\t\t.join(\"\\n\");\n\n\t\t// Print final annotation\n\t\tconst error = messageColour(`${messagePrefix}${messageIndented}${groupOr}`);\n\t\treturn `${indent}${dim(prefix)}${actualIndented}${dim(suffix)}\\n${error}`;\n\t} else if (Array.isArray(annotated)) {\n\t\t// Print array recursively\n\t\tlet result = `${indent}${dim(`${prefix}[`)}\\n`;\n\t\tconst arrayIndent = indent + \"  \";\n\t\tfor (let i = 0; i < annotated.length; i++) {\n\t\t\tconst value = annotated[i];\n\t\t\t// Add `...` if the last item wasn't an `...`\n\t\t\tif (value === undefined && (i === 0 || annotated[i - 1] !== undefined)) {\n\t\t\t\tresult += `${arrayIndent}${dim(\"...,\")}\\n`;\n\t\t\t}\n\t\t\tif (value !== undefined) {\n\t\t\t\tresult += print(inspectOptions, groupCounts, value, arrayIndent, {\n\t\t\t\t\tprefix: `/* [${i}] */ `,\n\t\t\t\t\tsuffix: \",\",\n\t\t\t\t});\n\t\t\t\tresult += \"\\n\";\n\t\t\t}\n\t\t}\n\t\tresult += `${indent}${dim(`]${suffix}`)}`;\n\t\treturn result;\n\t} else if (isRecord(annotated)) {\n\t\t// Print object recursively\n\t\tlet result = `${indent}${dim(`${prefix}{`)}\\n`;\n\t\tconst objectIndent = indent + \"  \";\n\t\tconst entries = Object.entries(annotated);\n\t\tfor (let i = 0; i < entries.length; i++) {\n\t\t\tconst [key, value] = entries[i];\n\t\t\t// Add `...` if the last item wasn't an `...`\n\t\t\tif (value === undefined && (i === 0 || entries[i - 1][1] !== undefined)) {\n\t\t\t\tresult += `${objectIndent}${dim(\"...,\")}\\n`;\n\t\t\t}\n\t\t\tif (value !== undefined) {\n\t\t\t\tresult += print(inspectOptions, groupCounts, value, objectIndent, {\n\t\t\t\t\tprefix: `${key}: `,\n\t\t\t\t\tsuffix: \",\",\n\t\t\t\t});\n\t\t\t\tresult += \"\\n\";\n\t\t\t}\n\t\t}\n\t\tresult += `${indent}${dim(`}${suffix}`)}`;\n\t\treturn result;\n\t}\n\n\treturn \"\";\n}\n\nexport function formatZodError(error: z.ZodError, input: unknown): string {\n\t// Shallow copy and sort array, with `invalid_union` errors first, so we don't\n\t// annotate the input with an `invalid_type` error instead\n\tconst sortedIssues = Array.from(error.issues).sort((a, b) => {\n\t\tif (a.code !== b.code) {\n\t\t\tif (a.code === \"invalid_union\") {\n\t\t\t\treturn -1;\n\t\t\t}\n\t\t\tif (b.code === \"invalid_union\") {\n\t\t\t\treturn 1;\n\t\t\t}\n\t\t}\n\t\treturn 0;\n\t});\n\n\t// Build annotated input\n\tlet annotated: Annotated;\n\tconst groupCounts = new GroupCountsMap();\n\tfor (const issue of sortedIssues) {\n\t\tannotated = annotate(\n\t\t\tgroupCounts,\n\t\t\tannotated,\n\t\t\tinput,\n\t\t\tissue,\n\t\t\tissue.path as (string | number)[]\n\t\t);\n\t}\n\n\t// Print to pretty string\n\t// Build inspect options on each call to `formatZodError()` so we can toggle\n\t// colours per-call\n\tconst inspectOptions: util.InspectOptions = {\n\t\tdepth: 0,\n\t\tcolors: $colors.enabled,\n\t};\n\treturn print(inspectOptions, groupCounts, annotated);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nightintelligence/cloudflare-workers-utils",
-  "version": "0.35.0-patch2",
+  "version": "0.35.0-patch3",
   "description": "Internal utility package for workers-sdk. Not intended for external use — APIs may change without notice.",
   "homepage": "https://github.com/cloudflare/workers-sdk/tree/main/packages/workers-utils#readme",
   "bugs": {

package/dist/chunk-3D4BXUZX.mjs

@@ -1,54 +0,0 @@
-import { __name } from './chunk-6LYDFTTF.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 };
-//# sourceMappingURL=chunk-3D4BXUZX.mjs.map
-//# sourceMappingURL=chunk-3D4BXUZX.mjs.map

package/dist/chunk-3D4BXUZX.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/prometheus-metrics.ts"],"names":[],"mappings":";;;AAuCO,IAAM,kBAAN,MAAsB;AAAA,EAvC7B;AAuC6B,IAAA,MAAA,CAAA,IAAA,EAAA,iBAAA,CAAA;AAAA;AAAA,EACpB,WAA2B,EAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASpC,aAAA,CAAc,MAAc,IAAA,EAAuB;AAClD,IAAA,MAAM,KAAA,GAAsB,EAAE,IAAA,EAAM,IAAA,EAAM,OAAO,CAAA,EAAE;AACnD,IAAA,IAAA,CAAK,QAAA,CAAS,KAAK,KAAK,CAAA;AACxB,IAAA,OAAO;AAAA,MACN,qBAAK,MAAA,CAAA,MAAM;AACV,QAAA,KAAA,CAAM,KAAA,EAAA;AAAA,MACP,CAAA,EAFK,KAAA,CAAA;AAAA,MAGL,GAAA,0BAAM,MAAA,KAAmB;AACxB,QAAA,IAAI,SAAS,CAAA,EAAG;AACf,UAAA,MAAM,IAAI,MAAM,+BAA+B,CAAA;AAAA,QAChD;AACA,QAAA,KAAA,CAAM,KAAA,IAAS,MAAA;AAAA,MAChB,CAAA,EALK,KAAA;AAAA,KAMN;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAA,GAAkB;AACjB,IAAA,OAAO,IAAA,CAAK,QAAA,CACV,GAAA,CAAI,CAAC,CAAA,KAAM;AACX,MAAA,IAAI,MAAA,GAAS,EAAA;AACb,MAAA,IAAI,CAAA,CAAE,IAAA,CAAK,MAAA,GAAS,CAAA,EAAG;AACtB,QAAA,MAAA,IAAU,CAAA,OAAA,EAAU,CAAA,CAAE,IAAI,CAAA,CAAA,EAAI,EAAE,IAAI;AAAA,CAAA;AAAA,MACrC;AACA,MAAA,MAAA,IAAU,CAAA,OAAA,EAAU,EAAE,IAAI,CAAA;AAAA,CAAA;AAC1B,MAAA,MAAA,IAAU,CAAA,EAAG,CAAA,CAAE,IAAI,CAAA,CAAA,EAAI,EAAE,KAAK;AAAA,CAAA;AAC9B,MAAA,OAAO,MAAA;AAAA,IACR,CAAC,CAAA,CACA,IAAA,CAAK,EAAE,CAAA;AAAA,EACV;AACD","file":"chunk-3D4BXUZX.mjs","sourcesContent":["/**\n * Lightweight Prometheus metrics registry for push-based counter metrics.\n *\n * Designed for ephemeral per-request usage in Cloudflare Workers that push\n * metrics to a Prometheus push gateway. Replaces the deprecated `promjs` library.\n *\n * @example\n * ```ts\n * const metrics = new MetricsRegistry();\n * const reqCounter = metrics.createCounter(\n *   \"service_request_total\",\n *   \"Total requests\"\n * );\n * reqCounter.inc();\n *\n * // Push to Prometheus gateway\n * ctx.waitUntil(\n *   fetch(prometheusUrl, {\n *     method: \"POST\",\n *     headers: { Authorization: `Bearer ${token}` },\n *     body: metrics.metrics(),\n *   })\n * );\n * ```\n */\n\nexport interface Counter {\n\t/** Increment the counter by 1. */\n\tinc(): void;\n\t/** Increment the counter by the given non-negative amount. */\n\tadd(amount: number): void;\n}\n\ninterface CounterEntry {\n\tname: string;\n\thelp: string;\n\tvalue: number;\n}\n\nexport class MetricsRegistry {\n\tprivate counters: CounterEntry[] = [];\n\n\t/**\n\t * Create and register a new counter metric.\n\t *\n\t * @param name - The metric name (e.g. \"service_request_total\")\n\t * @param help - A human-readable description of the metric\n\t * @returns A Counter that can be incremented\n\t */\n\tcreateCounter(name: string, help: string): Counter {\n\t\tconst entry: CounterEntry = { name, help, value: 0 };\n\t\tthis.counters.push(entry);\n\t\treturn {\n\t\t\tinc: () => {\n\t\t\t\tentry.value++;\n\t\t\t},\n\t\t\tadd: (amount: number) => {\n\t\t\t\tif (amount < 0) {\n\t\t\t\t\tthrow new Error(\"Counter value cannot decrease\");\n\t\t\t\t}\n\t\t\t\tentry.value += amount;\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * Serialize all registered metrics in Prometheus text exposition format.\n\t *\n\t * @see https://prometheus.io/docs/instrumenting/exposition_formats/#text-based-format\n\t */\n\tmetrics(): string {\n\t\treturn this.counters\n\t\t\t.map((c) => {\n\t\t\t\tlet result = \"\";\n\t\t\t\tif (c.help.length > 0) {\n\t\t\t\t\tresult += `# HELP ${c.name} ${c.help}\\n`;\n\t\t\t\t}\n\t\t\t\tresult += `# TYPE ${c.name} counter\\n`;\n\t\t\t\tresult += `${c.name} ${c.value}\\n`;\n\t\t\t\treturn result;\n\t\t\t})\n\t\t\t.join(\"\");\n\t}\n}\n"]}