@rocicorp/zero 1.8.0-canary.3 → 1.8.0-canary.5

package/out/zero-cache/src/custom/fetch.js

@@ -1,15 +1,17 @@
-import { assert, unreachable } from "../../../shared/src/asserts.js";
+import { unreachable } from "../../../shared/src/asserts.js";
 import { sleep } from "../../../shared/src/sleep.js";
 import "../../../shared/src/valita.js";
 import { getErrorMessage } from "../../../shared/src/error.js";
 import { must } from "../../../shared/src/must.js";
 import { PushFailed, TransformFailed } from "../../../zero-protocol/src/error-kind-enum.js";
 import { ZeroCache } from "../../../zero-protocol/src/error-origin-enum.js";
-import { HTTP, Internal, Parse } from "../../../zero-protocol/src/error-reason-enum.js";
-import { isProtocolError } from "../../../zero-protocol/src/error.js";
+import { HTTP, Internal, Parse, UnsupportedPushVersion } from "../../../zero-protocol/src/error-reason-enum.js";
+import { errorBodySchema, isProtocolError } from "../../../zero-protocol/src/error.js";
+import { pushErrorSchema } from "../../../zero-protocol/src/push.js";
 import { upstreamSchema } from "../types/shards.js";
 import { randInt } from "../../../shared/src/rand.js";
 import { ProtocolErrorWithLevel } from "../types/error-with-level.js";
+import { apiAttemptDuration, apiAttempts, apiInFlight, apiRequestDuration, apiRequests } from "./metrics.js";
 import { context, propagation } from "@opentelemetry/api";
 import "urlpattern-polyfill";
 //#region ../zero-cache/src/custom/fetch.ts
@@ -40,128 +42,178 @@ var getBodyPreview = async (res, lc) => {
 	}
 };
 var MAX_ATTEMPTS = 4;
-async function fetchFromAPIServer(validator, source, lc, ctx, shard, body) {
-	const fetchFromAPIServerID = randInt(1, Number.MAX_SAFE_INTEGER).toString(36);
-	lc = lc.withContext("fetchFromAPIServerID", fetchFromAPIServerID).withContext("source", source);
-	const fetchConfig = source === "push" ? ctx.mutateContext : ctx.queryContext;
-	const url = must(fetchConfig.url, `Fetch config for ${source} is missing URL`);
-	const headerOptions = fetchConfig.headerOptions;
-	lc.debug?.("fetchFromAPIServer called", { url });
-	if (!urlMatch(url, fetchConfig.allowedUrlPatterns ?? [])) throw new ProtocolErrorWithLevel(source === "push" ? {
-		kind: PushFailed,
-		origin: ZeroCache,
-		reason: Internal,
-		message: `URL "${url}" is not allowed by the ZERO_MUTATE_URL configuration`,
-		mutationIDs: []
-	} : {
-		kind: TransformFailed,
-		origin: ZeroCache,
-		reason: Internal,
-		message: `URL "${url}" is not allowed by the ZERO_QUERY_URL configuration`,
-		queryIDs: []
-	}, "warn");
-	const headers = { "Content-Type": "application/json" };
-	if (headerOptions.apiKey) headers["X-Api-Key"] = headerOptions.apiKey;
-	Object.assign(headers, headerOptions.customHeaders, headerOptions.requestHeaders);
-	if (ctx.auth?.raw) headers["Authorization"] = `Bearer ${ctx.auth.raw}`;
-	if (headerOptions.cookie) headers["Cookie"] = headerOptions.cookie;
-	if (headerOptions.origin) headers["Origin"] = headerOptions.origin;
-	propagation.inject(context.active(), headers);
-	const urlObj = new URL(url);
-	const params = new URLSearchParams(urlObj.search);
-	for (const reserved of reservedParams) assert(!params.has(reserved), `The push URL cannot contain the reserved query param "${reserved}"`);
-	params.append("schema", upstreamSchema(shard));
-	params.append("appID", shard.appID);
-	urlObj.search = params.toString();
-	const finalUrl = urlObj.toString();
-	for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
-		lc = lc.withContext("fetchFromAPIServerAttempt", attempt);
-		lc.debug?.("fetch from API server attempt");
-		const shouldRetry = async () => {
-			if (attempt < MAX_ATTEMPTS) {
-				const delayMs = getBackoffDelayMs(attempt);
-				lc.debug?.(`fetch from API server retrying in ${delayMs} ms`);
-				await sleep(delayMs);
-				return true;
-			}
-			lc.debug?.("fetch from API server reached max attempts, not retrying");
-			return false;
-		};
-		try {
-			const response = await fetch(finalUrl, {
-				method: "POST",
-				headers,
-				body: JSON.stringify(body)
+async function fetchFromAPIServer(validator, source, lc, ctx, shard, body, metricsOpts) {
+	const metricAttrs = metricsOpts.operation === "cleanup" && metricsOpts.cleanupType !== void 0 ? {
+		operation: metricsOpts.operation,
+		cleanup_type: metricsOpts.cleanupType
+	} : { operation: metricsOpts.operation };
+	const requestStart = performance.now();
+	let requestMetricAttrs;
+	let attemptCount = 0;
+	apiInFlight().add(1, metricAttrs);
+	try {
+		const fetchFromAPIServerID = randInt(1, Number.MAX_SAFE_INTEGER).toString(36);
+		lc = lc.withContext("fetchFromAPIServerID", fetchFromAPIServerID).withContext("source", source);
+		const fetchConfig = source === "push" ? ctx.mutateContext : ctx.queryContext;
+		const url = must(fetchConfig.url, `Fetch config for ${source} is missing URL`);
+		const headerOptions = fetchConfig.headerOptions;
+		lc.debug?.("fetchFromAPIServer called", { url });
+		if (!urlMatch(url, fetchConfig.allowedUrlPatterns ?? [])) {
+			const errorBody = apiFailedBody(source, Internal, source === "push" ? `URL "${url}" is not allowed by the ZERO_MUTATE_URL configuration` : `URL "${url}" is not allowed by the ZERO_QUERY_URL configuration`);
+			requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {
+				result: "url_not_allowed",
+				attemptCount,
+				errorBody
 			});
-			if (!response.ok) {
-				const bodyPreview = await getBodyPreview(response, lc);
-				lc.warn?.("fetch from API server returned non-OK status", {
-					url: finalUrl,
-					status: response.status,
-					bodyPreview
-				});
-				if ((response.status === 502 || response.status === 504) && await shouldRetry()) continue;
-				throw new ProtocolErrorWithLevel(source === "push" ? {
-					kind: PushFailed,
-					origin: ZeroCache,
-					reason: HTTP,
-					status: response.status,
-					bodyPreview,
-					message: `Fetch from API server returned non-OK status ${response.status}`,
-					mutationIDs: []
-				} : {
-					kind: TransformFailed,
-					origin: ZeroCache,
-					reason: HTTP,
-					status: response.status,
-					bodyPreview,
-					message: `Fetch from API server returned non-OK status ${response.status}`,
-					queryIDs: []
-				}, "warn");
-			}
+			throw new ProtocolErrorWithLevel(errorBody, "warn");
+		}
+		const headers = { "Content-Type": "application/json" };
+		if (headerOptions.apiKey) headers["X-Api-Key"] = headerOptions.apiKey;
+		Object.assign(headers, headerOptions.customHeaders, headerOptions.requestHeaders);
+		if (ctx.auth?.raw) headers["Authorization"] = `Bearer ${ctx.auth.raw}`;
+		if (headerOptions.cookie) headers["Cookie"] = headerOptions.cookie;
+		if (headerOptions.origin) headers["Origin"] = headerOptions.origin;
+		propagation.inject(context.active(), headers);
+		const urlObj = new URL(url);
+		const params = new URLSearchParams(urlObj.search);
+		for (const reserved of reservedParams) if (params.has(reserved)) {
+			requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {
+				result: "config_error",
+				attemptCount
+			});
+			throw new Error(`The push URL cannot contain the reserved query param "${reserved}"`);
+		}
+		params.append("schema", upstreamSchema(shard));
+		params.append("appID", shard.appID);
+		urlObj.search = params.toString();
+		const finalUrl = urlObj.toString();
+		for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
+			attemptCount = attempt;
+			lc = lc.withContext("fetchFromAPIServerAttempt", attempt);
+			lc.debug?.("fetch from API server attempt");
+			const sleepBeforeRetry = async () => {
+				if (attempt < MAX_ATTEMPTS) {
+					const delayMs = getBackoffDelayMs(attempt);
+					lc.debug?.(`fetch from API server retrying in ${delayMs} ms`);
+					await sleep(delayMs);
+					return true;
+				}
+				lc.debug?.("fetch from API server reached max attempts, not retrying");
+				return false;
+			};
+			const attemptStart = performance.now();
 			try {
-				const json = await response.json();
-				const result = validator.parse(json, { mode: "passthrough" });
-				lc.debug?.("fetch from API server succeeded");
-				return result;
+				const response = await fetch(finalUrl, {
+					method: "POST",
+					headers,
+					body: JSON.stringify(body)
+				});
+				if (!response.ok) {
+					const bodyPreview = await getBodyPreview(response, lc);
+					lc.warn?.("fetch from API server returned non-OK status", {
+						url: finalUrl,
+						status: response.status,
+						bodyPreview
+					});
+					const willRetry = (response.status === 502 || response.status === 504) && attempt < MAX_ATTEMPTS;
+					recordApiAttempt(performance.now() - attemptStart, metricAttrs, {
+						attempt,
+						result: "http_error",
+						willRetry,
+						response
+					});
+					if (willRetry && await sleepBeforeRetry()) continue;
+					const errorBody = apiFailedBody(source, HTTP, `Fetch from API server returned non-OK status ${response.status}`, response, bodyPreview);
+					requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {
+						result: "http_error",
+						attemptCount,
+						response,
+						errorBody
+					});
+					throw new ProtocolErrorWithLevel(errorBody, "warn");
+				}
+				try {
+					const json = await response.json();
+					const result = validator.parse(json, { mode: "passthrough" });
+					const apiError = apiErrorFromResult(result);
+					if (apiError) {
+						recordApiAttempt(performance.now() - attemptStart, metricAttrs, {
+							attempt,
+							result: "api_error",
+							willRetry: false,
+							response,
+							errorBody: apiError
+						});
+						requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {
+							result: "api_error",
+							attemptCount,
+							response,
+							errorBody: apiError
+						});
+					} else {
+						recordApiAttempt(performance.now() - attemptStart, metricAttrs, {
+							attempt,
+							result: "success",
+							willRetry: false,
+							response
+						});
+						requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {
+							result: "success",
+							attemptCount,
+							response
+						});
+					}
+					lc.debug?.("fetch from API server succeeded");
+					return result;
+				} catch (error) {
+					lc.warn?.("failed to parse response", { url: finalUrl }, error);
+					const errorBody = apiFailedBody(source, Parse, `Failed to parse response from API server: ${getErrorMessage(error)}`);
+					recordApiAttempt(performance.now() - attemptStart, metricAttrs, {
+						attempt,
+						result: "parse_error",
+						willRetry: false,
+						response,
+						errorBody
+					});
+					requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {
+						result: "parse_error",
+						attemptCount,
+						response,
+						errorBody
+					});
+					throw new ProtocolErrorWithLevel(errorBody, "warn", { cause: error });
+				}
 			} catch (error) {
-				lc.warn?.("failed to parse response", { url: finalUrl }, error);
-				throw new ProtocolErrorWithLevel(source === "push" ? {
-					kind: PushFailed,
-					origin: ZeroCache,
-					reason: Parse,
-					message: `Failed to parse response from API server: ${getErrorMessage(error)}`,
-					mutationIDs: []
-				} : {
-					kind: TransformFailed,
-					origin: ZeroCache,
-					reason: Parse,
-					message: `Failed to parse response from API server: ${getErrorMessage(error)}`,
-					queryIDs: []
-				}, "warn", { cause: error });
+				if (isProtocolError(error)) throw error;
+				const isFetchFailed = error instanceof TypeError && error.message === "fetch failed";
+				let logLevel = isFetchFailed ? "warn" : "error";
+				lc[logLevel]?.("fetch from API server threw error", { url: finalUrl }, error);
+				const willRetry = isFetchFailed && attempt < MAX_ATTEMPTS;
+				recordApiAttempt(performance.now() - attemptStart, metricAttrs, {
+					attempt,
+					result: "fetch_error",
+					willRetry
+				});
+				if (willRetry && await sleepBeforeRetry()) continue;
+				const errorBody = apiFailedBody(source, Internal, `Fetch from API server threw error: ${getErrorMessage(error)}`);
+				requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {
+					result: "fetch_error",
+					attemptCount,
+					errorBody
+				});
+				throw new ProtocolErrorWithLevel(errorBody, logLevel, { cause: error });
 			}
-		} catch (error) {
-			if (isProtocolError(error)) throw error;
-			const isFetchFailed = error instanceof TypeError && error.message === "fetch failed";
-			let logLevel = isFetchFailed ? "warn" : "error";
-			lc[logLevel]?.("fetch from API server threw error", { url: finalUrl }, error);
-			if (isFetchFailed && await shouldRetry()) continue;
-			throw new ProtocolErrorWithLevel(source === "push" ? {
-				kind: PushFailed,
-				origin: ZeroCache,
-				reason: Internal,
-				message: `Fetch from API server threw error: ${getErrorMessage(error)}`,
-				mutationIDs: []
-			} : {
-				kind: TransformFailed,
-				origin: ZeroCache,
-				reason: Internal,
-				message: `Fetch from API server threw error: ${getErrorMessage(error)}`,
-				queryIDs: []
-			}, logLevel, { cause: error });
 		}
+		unreachable();
+	} finally {
+		const attrs = requestMetricAttrs ?? apiRequestMetricAttrs(metricAttrs, {
+			result: attemptCount === 0 ? "config_error" : "fetch_error",
+			attemptCount
+		});
+		apiRequests().add(1, attrs);
+		apiRequestDuration().recordMs(performance.now() - requestStart, attrs);
+		apiInFlight().add(-1, metricAttrs);
 	}
-	unreachable();
 }
 /**
 * Returns true if the url matches one of the allowedUrlPatterns.
@@ -189,6 +241,90 @@ function urlMatch(url, allowedUrlPatterns) {
 function getBackoffDelayMs(attempt) {
 	return Math.min(1e3, 100 * Math.pow(2, attempt - 1) + Math.random() * 100);
 }
+function apiFailedBody(source, reason, message, response, bodyPreview) {
+	if (source === "push") return reason === "http" ? {
+		kind: PushFailed,
+		origin: ZeroCache,
+		reason,
+		status: response?.status ?? 0,
+		...bodyPreview !== void 0 ? { bodyPreview } : {},
+		message,
+		mutationIDs: []
+	} : {
+		kind: PushFailed,
+		origin: ZeroCache,
+		reason,
+		message,
+		mutationIDs: []
+	};
+	return reason === "http" ? {
+		kind: TransformFailed,
+		origin: ZeroCache,
+		reason,
+		status: response?.status ?? 0,
+		...bodyPreview !== void 0 ? { bodyPreview } : {},
+		message,
+		queryIDs: []
+	} : {
+		kind: TransformFailed,
+		origin: ZeroCache,
+		reason,
+		message,
+		queryIDs: []
+	};
+}
+function apiErrorFromResult(result) {
+	const parsed = errorBodySchema.try(result, { mode: "passthrough" });
+	if (parsed.ok) return parsed.value;
+	if (Array.isArray(result) && result[0] === "transformFailed") {
+		const legacyTransformFailed = errorBodySchema.try(result[1], { mode: "passthrough" });
+		return legacyTransformFailed.ok ? legacyTransformFailed.value : void 0;
+	}
+	const legacyPushError = pushErrorSchema.try(result, { mode: "passthrough" });
+	return legacyPushError.ok ? {
+		kind: PushFailed,
+		reason: legacyPushErrorReason(legacyPushError.value.error)
+	} : void 0;
+}
+function legacyPushErrorReason(error) {
+	switch (error) {
+		case "http": return HTTP;
+		case "unsupportedPushVersion": return UnsupportedPushVersion;
+		case "unsupportedSchemaVersion":
+		case "zeroPusher": return Internal;
+	}
+}
+function apiRequestMetricAttrs(baseAttrs, { result, attemptCount, response, errorBody }) {
+	return {
+		...baseAttrs,
+		result,
+		attempt_count: attemptCount,
+		...apiResponseErrorMetricAttrs(response, errorBody)
+	};
+}
+function apiResponseErrorMetricAttrs(response, errorBody) {
+	const attrs = {};
+	if (response) {
+		attrs.http_status_code = response.status;
+		attrs.http_status_class = `${Math.floor(response.status / 100)}xx`;
+	}
+	if (errorBody) {
+		attrs.error_kind = errorBody.kind;
+		if (errorBody.reason !== void 0) attrs.error_reason = errorBody.reason;
+	}
+	return attrs;
+}
+function recordApiAttempt(durationMs, baseAttrs, { attempt, result, willRetry, response, errorBody }) {
+	const attrs = {
+		...baseAttrs,
+		attempt,
+		result,
+		will_retry: willRetry,
+		...apiResponseErrorMetricAttrs(response, errorBody)
+	};
+	apiAttempts().add(1, attrs);
+	apiAttemptDuration().recordMs(durationMs, attrs);
+}
 //#endregion
 export { compileUrlPattern, fetchFromAPIServer };
 

package/out/zero-cache/src/custom/fetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.js","names":[],"sources":["../../../../../zero-cache/src/custom/fetch.ts"],"sourcesContent":["import {context, propagation} from '@opentelemetry/api';\nimport type {LogContext, LogLevel} from '@rocicorp/logger';\nimport 'urlpattern-polyfill';\nimport {assert, unreachable} from '../../../shared/src/asserts.ts';\nimport {getErrorMessage} from '../../../shared/src/error.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport {randInt} from '../../../shared/src/rand.ts';\nimport {sleep} from '../../../shared/src/sleep.ts';\nimport {type Type} from '../../../shared/src/valita.ts';\nimport {ErrorKind} from '../../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../../zero-protocol/src/error-origin.ts';\nimport {ErrorReason} from '../../../zero-protocol/src/error-reason.ts';\nimport {isProtocolError} from '../../../zero-protocol/src/error.ts';\nimport type {ConnectionContext} from '../services/view-syncer/connection-context-manager.ts';\nimport {ProtocolErrorWithLevel} from '../types/error-with-level.ts';\nimport {upstreamSchema, type ShardID} from '../types/shards.ts';\n\nconst reservedParams = ['schema', 'appID'];\n\n/**\n * Compiles and validates a URLPattern from configuration.\n *\n * Patterns must be full URLs (e.g., \"https://api.example.com/endpoint\").\n * URLPattern automatically sets search and hash to wildcard ('*'),\n * which means query parameters and fragments are ignored during matching.\n *\n * @throws Error if the pattern is an invalid URLPattern\n */\nexport function compileUrlPattern(pattern: string): URLPattern {\n  try {\n    return new URLPattern(pattern);\n  } catch (e) {\n    throw new Error(\n      `Invalid URLPattern in URL configuration: \"${pattern}\". Error: ${e instanceof Error ? e.message : String(e)}`,\n    );\n  }\n}\n\nexport const getBodyPreview = async (\n  res: Response,\n  lc: LogContext,\n): Promise<string | undefined> => {\n  try {\n    const body = await res.clone().text();\n    if (body.length > 512) {\n      return body.slice(0, 512) + '...';\n    }\n    return body;\n  } catch (e) {\n    lc.warn?.(\n      'failed to get body preview',\n      {\n        url: res.url,\n      },\n      e,\n    );\n  }\n\n  return undefined;\n};\n\nconst MAX_ATTEMPTS = 4;\n\nexport async function fetchFromAPIServer<TValidator extends Type>(\n  validator: TValidator,\n  source: 'push' | 'transform',\n  lc: LogContext,\n  ctx: ConnectionContext,\n  shard: ShardID,\n  body: ReadonlyJSONValue,\n) {\n  const fetchFromAPIServerID = randInt(1, Number.MAX_SAFE_INTEGER).toString(36);\n  lc = lc\n    .withContext('fetchFromAPIServerID', fetchFromAPIServerID)\n    .withContext('source', source);\n\n  const fetchConfig = source === 'push' ? ctx.mutateContext : ctx.queryContext;\n  const url = must(\n    fetchConfig.url,\n    `Fetch config for ${source} is missing URL`,\n  );\n  const headerOptions = fetchConfig.headerOptions;\n\n  lc.debug?.('fetchFromAPIServer called', {\n    url,\n  });\n\n  if (!urlMatch(url, fetchConfig.allowedUrlPatterns ?? [])) {\n    throw new ProtocolErrorWithLevel(\n      source === 'push'\n        ? {\n            kind: ErrorKind.PushFailed,\n            origin: ErrorOrigin.ZeroCache,\n            reason: ErrorReason.Internal,\n            message: `URL \"${url}\" is not allowed by the ZERO_MUTATE_URL configuration`,\n            mutationIDs: [],\n          }\n        : {\n            kind: ErrorKind.TransformFailed,\n            origin: ErrorOrigin.ZeroCache,\n            reason: ErrorReason.Internal,\n            message: `URL \"${url}\" is not allowed by the ZERO_QUERY_URL configuration`,\n            queryIDs: [],\n          },\n      'warn',\n    );\n  }\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n  };\n\n  if (headerOptions.apiKey) {\n    headers['X-Api-Key'] = headerOptions.apiKey;\n  }\n  Object.assign(\n    headers,\n    headerOptions.customHeaders,\n    headerOptions.requestHeaders,\n  );\n  if (ctx.auth?.raw) {\n    headers['Authorization'] = `Bearer ${ctx.auth.raw}`;\n  }\n  if (headerOptions.cookie) {\n    headers['Cookie'] = headerOptions.cookie;\n  }\n  if (headerOptions.origin) {\n    headers['Origin'] = headerOptions.origin;\n  }\n  propagation.inject(context.active(), headers);\n\n  const urlObj = new URL(url);\n  const params = new URLSearchParams(urlObj.search);\n\n  for (const reserved of reservedParams) {\n    assert(\n      !params.has(reserved),\n      `The push URL cannot contain the reserved query param \"${reserved}\"`,\n    );\n  }\n\n  params.append('schema', upstreamSchema(shard));\n  params.append('appID', shard.appID);\n\n  urlObj.search = params.toString();\n\n  const finalUrl = urlObj.toString();\n\n  for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {\n    lc = lc.withContext('fetchFromAPIServerAttempt', attempt);\n    lc.debug?.('fetch from API server attempt');\n    const shouldRetry = async () => {\n      if (attempt < MAX_ATTEMPTS) {\n        const delayMs = getBackoffDelayMs(attempt);\n        lc.debug?.(`fetch from API server retrying in ${delayMs} ms`);\n        await sleep(delayMs);\n        return true;\n      }\n      lc.debug?.('fetch from API server reached max attempts, not retrying');\n      return false;\n    };\n    try {\n      const response = await fetch(finalUrl, {\n        method: 'POST',\n        headers,\n        body: JSON.stringify(body),\n      });\n\n      if (!response.ok) {\n        const bodyPreview = await getBodyPreview(response, lc);\n        lc.warn?.('fetch from API server returned non-OK status', {\n          url: finalUrl,\n          status: response.status,\n          bodyPreview,\n        });\n        // Bad Gateway or Gateway Timeout indicate the server was not reached\n        // We retry these if we have retries remaining.\n        if (\n          (response.status === 502 || response.status === 504) &&\n          (await shouldRetry())\n        ) {\n          continue;\n        }\n\n        throw new ProtocolErrorWithLevel(\n          source === 'push'\n            ? {\n                kind: ErrorKind.PushFailed,\n                origin: ErrorOrigin.ZeroCache,\n                reason: ErrorReason.HTTP,\n                status: response.status,\n                bodyPreview,\n                message: `Fetch from API server returned non-OK status ${response.status}`,\n                mutationIDs: [],\n              }\n            : {\n                kind: ErrorKind.TransformFailed,\n                origin: ErrorOrigin.ZeroCache,\n                reason: ErrorReason.HTTP,\n                status: response.status,\n                bodyPreview,\n                message: `Fetch from API server returned non-OK status ${response.status}`,\n                queryIDs: [],\n              },\n          'warn',\n        );\n      }\n\n      try {\n        const json = await response.json();\n        const result = validator.parse(json, {\n          mode: 'passthrough',\n        });\n        lc.debug?.('fetch from API server succeeded');\n        return result;\n      } catch (error) {\n        lc.warn?.(\n          'failed to parse response',\n          {\n            url: finalUrl,\n          },\n          error,\n        );\n\n        throw new ProtocolErrorWithLevel(\n          source === 'push'\n            ? {\n                kind: ErrorKind.PushFailed,\n                origin: ErrorOrigin.ZeroCache,\n                reason: ErrorReason.Parse,\n                message: `Failed to parse response from API server: ${getErrorMessage(error)}`,\n                mutationIDs: [],\n              }\n            : {\n                kind: ErrorKind.TransformFailed,\n                origin: ErrorOrigin.ZeroCache,\n                reason: ErrorReason.Parse,\n                message: `Failed to parse response from API server: ${getErrorMessage(error)}`,\n                queryIDs: [],\n              },\n          'warn',\n          {cause: error},\n        );\n      }\n    } catch (error) {\n      if (isProtocolError(error)) {\n        throw error;\n      }\n\n      const isFetchFailed =\n        error instanceof TypeError && error.message === 'fetch failed';\n      // unexpected/unknown errors should be logged at 'error' level so they\n      // are investigated\n      let logLevel: LogLevel = isFetchFailed ? 'warn' : 'error';\n      lc[logLevel]?.(\n        'fetch from API server threw error',\n        {url: finalUrl},\n        error,\n      );\n\n      if (isFetchFailed && (await shouldRetry())) {\n        continue;\n      }\n\n      throw new ProtocolErrorWithLevel(\n        source === 'push'\n          ? {\n              kind: ErrorKind.PushFailed,\n              origin: ErrorOrigin.ZeroCache,\n              reason: ErrorReason.Internal,\n              message: `Fetch from API server threw error: ${getErrorMessage(error)}`,\n              mutationIDs: [],\n            }\n          : {\n              kind: ErrorKind.TransformFailed,\n              origin: ErrorOrigin.ZeroCache,\n              reason: ErrorReason.Internal,\n              message: `Fetch from API server threw error: ${getErrorMessage(error)}`,\n              queryIDs: [],\n            },\n        logLevel,\n        {cause: error},\n      );\n    }\n  }\n  unreachable();\n}\n\n/**\n * Returns true if the url matches one of the allowedUrlPatterns.\n *\n * URLPattern automatically ignores query parameters and hash fragments during matching\n * because it sets search and hash to wildcard ('*') by default.\n *\n * Example URLPattern patterns:\n * - \"https://api.example.com/endpoint\" - Exact match for a specific URL\n * - \"https://*.example.com/endpoint\" - Matches any single subdomain (e.g., \"https://api.example.com/endpoint\")\n * - \"https://*.*.example.com/endpoint\" - Matches two subdomains (e.g., \"https://api.v1.example.com/endpoint\")\n * - \"https://api.example.com/*\" - Matches any path under /\n * - \"https://api.example.com/:version/endpoint\" - Matches with named parameter (e.g., \"https://api.example.com/v1/endpoint\")\n */\nexport function urlMatch(\n  url: string,\n  allowedUrlPatterns: readonly URLPattern[],\n): boolean {\n  for (const pattern of allowedUrlPatterns) {\n    if (pattern.test(url)) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Returns the delay in milliseconds for the next retry attempt using exponential backoff with jitter.\n *\n * The delay assumes the first retry is attempt 1.\n * The formula is: `min(1000, 100 * 2^(attempt - 1) + jitter)` where jitter is between 0 and 100ms.\n */\nfunction getBackoffDelayMs(attempt: number): number {\n  return Math.min(1000, 100 * Math.pow(2, attempt - 1) + Math.random() * 100);\n}\n"],"mappings":"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"}
+{"version":3,"file":"fetch.js","names":[],"sources":["../../../../../zero-cache/src/custom/fetch.ts"],"sourcesContent":["import {context, propagation} from '@opentelemetry/api';\nimport type {LogContext, LogLevel} from '@rocicorp/logger';\nimport 'urlpattern-polyfill';\nimport {unreachable} from '../../../shared/src/asserts.ts';\nimport {getErrorMessage} from '../../../shared/src/error.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport {randInt} from '../../../shared/src/rand.ts';\nimport {sleep} from '../../../shared/src/sleep.ts';\nimport {type Type} from '../../../shared/src/valita.ts';\nimport {ErrorKind} from '../../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../../zero-protocol/src/error-origin.ts';\nimport {ErrorReason} from '../../../zero-protocol/src/error-reason.ts';\nimport {\n  errorBodySchema,\n  isProtocolError,\n  type ErrorBody,\n} from '../../../zero-protocol/src/error.ts';\nimport {\n  pushErrorSchema,\n  type PushError,\n} from '../../../zero-protocol/src/push.ts';\nimport type {ConnectionContext} from '../services/view-syncer/connection-context-manager.ts';\nimport {ProtocolErrorWithLevel} from '../types/error-with-level.ts';\nimport {upstreamSchema, type ShardID} from '../types/shards.ts';\nimport {\n  apiAttemptDuration,\n  apiAttempts,\n  apiInFlight,\n  apiRequestDuration,\n  apiRequests,\n  type ApiAttemptMetricAttrs,\n  type ApiAttemptResult,\n  type ApiCleanupType,\n  type ApiMetricBaseAttrs,\n  type ApiOperation,\n  type ApiRequestMetricAttrs,\n  type ApiRequestResult,\n} from './metrics.ts';\n\nconst reservedParams = ['schema', 'appID'];\n\n/**\n * Compiles and validates a URLPattern from configuration.\n *\n * Patterns must be full URLs (e.g., \"https://api.example.com/endpoint\").\n * URLPattern automatically sets search and hash to wildcard ('*'),\n * which means query parameters and fragments are ignored during matching.\n *\n * @throws Error if the pattern is an invalid URLPattern\n */\nexport function compileUrlPattern(pattern: string): URLPattern {\n  try {\n    return new URLPattern(pattern);\n  } catch (e) {\n    throw new Error(\n      `Invalid URLPattern in URL configuration: \"${pattern}\". Error: ${e instanceof Error ? e.message : String(e)}`,\n    );\n  }\n}\n\nexport const getBodyPreview = async (\n  res: Response,\n  lc: LogContext,\n): Promise<string | undefined> => {\n  try {\n    const body = await res.clone().text();\n    if (body.length > 512) {\n      return body.slice(0, 512) + '...';\n    }\n    return body;\n  } catch (e) {\n    lc.warn?.(\n      'failed to get body preview',\n      {\n        url: res.url,\n      },\n      e,\n    );\n  }\n\n  return undefined;\n};\n\nconst MAX_ATTEMPTS = 4;\n\ntype ApiFailedReason =\n  | typeof ErrorReason.HTTP\n  | typeof ErrorReason.Parse\n  | typeof ErrorReason.Internal;\n\nexport type FetchMetricsOptions = {\n  operation: ApiOperation;\n  cleanupType?: ApiCleanupType | undefined;\n};\n\nexport async function fetchFromAPIServer<TValidator extends Type>(\n  validator: TValidator,\n  source: 'push' | 'transform',\n  lc: LogContext,\n  ctx: ConnectionContext,\n  shard: ShardID,\n  body: ReadonlyJSONValue,\n  metricsOpts: FetchMetricsOptions,\n) {\n  const metricAttrs: ApiMetricBaseAttrs =\n    metricsOpts.operation === 'cleanup' && metricsOpts.cleanupType !== undefined\n      ? {\n          operation: metricsOpts.operation,\n          cleanup_type: metricsOpts.cleanupType,\n        }\n      : {operation: metricsOpts.operation};\n  const requestStart = performance.now();\n  let requestMetricAttrs: ApiRequestMetricAttrs | undefined;\n  let attemptCount = 0;\n  apiInFlight().add(1, metricAttrs);\n\n  try {\n    const fetchFromAPIServerID = randInt(1, Number.MAX_SAFE_INTEGER).toString(\n      36,\n    );\n    lc = lc\n      .withContext('fetchFromAPIServerID', fetchFromAPIServerID)\n      .withContext('source', source);\n\n    const fetchConfig =\n      source === 'push' ? ctx.mutateContext : ctx.queryContext;\n    const url = must(\n      fetchConfig.url,\n      `Fetch config for ${source} is missing URL`,\n    );\n    const headerOptions = fetchConfig.headerOptions;\n\n    lc.debug?.('fetchFromAPIServer called', {\n      url,\n    });\n\n    if (!urlMatch(url, fetchConfig.allowedUrlPatterns ?? [])) {\n      const errorBody = apiFailedBody(\n        source,\n        ErrorReason.Internal,\n        source === 'push'\n          ? `URL \"${url}\" is not allowed by the ZERO_MUTATE_URL configuration`\n          : `URL \"${url}\" is not allowed by the ZERO_QUERY_URL configuration`,\n      );\n      requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {\n        result: 'url_not_allowed',\n        attemptCount,\n        errorBody,\n      });\n      throw new ProtocolErrorWithLevel(errorBody, 'warn');\n    }\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n    };\n\n    if (headerOptions.apiKey) {\n      headers['X-Api-Key'] = headerOptions.apiKey;\n    }\n    Object.assign(\n      headers,\n      headerOptions.customHeaders,\n      headerOptions.requestHeaders,\n    );\n    if (ctx.auth?.raw) {\n      headers['Authorization'] = `Bearer ${ctx.auth.raw}`;\n    }\n    if (headerOptions.cookie) {\n      headers['Cookie'] = headerOptions.cookie;\n    }\n    if (headerOptions.origin) {\n      headers['Origin'] = headerOptions.origin;\n    }\n    propagation.inject(context.active(), headers);\n\n    const urlObj = new URL(url);\n    const params = new URLSearchParams(urlObj.search);\n\n    for (const reserved of reservedParams) {\n      if (params.has(reserved)) {\n        requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {\n          result: 'config_error',\n          attemptCount,\n        });\n        throw new Error(\n          `The push URL cannot contain the reserved query param \"${reserved}\"`,\n        );\n      }\n    }\n\n    params.append('schema', upstreamSchema(shard));\n    params.append('appID', shard.appID);\n\n    urlObj.search = params.toString();\n\n    const finalUrl = urlObj.toString();\n\n    for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {\n      attemptCount = attempt;\n      lc = lc.withContext('fetchFromAPIServerAttempt', attempt);\n      lc.debug?.('fetch from API server attempt');\n      const sleepBeforeRetry = async () => {\n        if (attempt < MAX_ATTEMPTS) {\n          const delayMs = getBackoffDelayMs(attempt);\n          lc.debug?.(`fetch from API server retrying in ${delayMs} ms`);\n          await sleep(delayMs);\n          return true;\n        }\n        lc.debug?.('fetch from API server reached max attempts, not retrying');\n        return false;\n      };\n      const attemptStart = performance.now();\n      try {\n        const response = await fetch(finalUrl, {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(body),\n        });\n\n        if (!response.ok) {\n          const bodyPreview = await getBodyPreview(response, lc);\n          lc.warn?.('fetch from API server returned non-OK status', {\n            url: finalUrl,\n            status: response.status,\n            bodyPreview,\n          });\n          // Bad Gateway or Gateway Timeout indicate the server was not reached\n          // We retry these if we have retries remaining.\n          const willRetry =\n            (response.status === 502 || response.status === 504) &&\n            attempt < MAX_ATTEMPTS;\n          recordApiAttempt(performance.now() - attemptStart, metricAttrs, {\n            attempt,\n            result: 'http_error',\n            willRetry,\n            response,\n          });\n          if (willRetry && (await sleepBeforeRetry())) {\n            continue;\n          }\n\n          const errorBody = apiFailedBody(\n            source,\n            ErrorReason.HTTP,\n            `Fetch from API server returned non-OK status ${response.status}`,\n            response,\n            bodyPreview,\n          );\n          requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {\n            result: 'http_error',\n            attemptCount,\n            response,\n            errorBody,\n          });\n          throw new ProtocolErrorWithLevel(errorBody, 'warn');\n        }\n\n        try {\n          const json = await response.json();\n          const result = validator.parse(json, {\n            mode: 'passthrough',\n          });\n          const apiError = apiErrorFromResult(result);\n          if (apiError) {\n            recordApiAttempt(performance.now() - attemptStart, metricAttrs, {\n              attempt,\n              result: 'api_error',\n              willRetry: false,\n              response,\n              errorBody: apiError,\n            });\n            requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {\n              result: 'api_error',\n              attemptCount,\n              response,\n              errorBody: apiError,\n            });\n          } else {\n            recordApiAttempt(performance.now() - attemptStart, metricAttrs, {\n              attempt,\n              result: 'success',\n              willRetry: false,\n              response,\n            });\n            requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {\n              result: 'success',\n              attemptCount,\n              response,\n            });\n          }\n          lc.debug?.('fetch from API server succeeded');\n          return result;\n        } catch (error) {\n          lc.warn?.(\n            'failed to parse response',\n            {\n              url: finalUrl,\n            },\n            error,\n          );\n\n          const errorBody = apiFailedBody(\n            source,\n            ErrorReason.Parse,\n            `Failed to parse response from API server: ${getErrorMessage(error)}`,\n          );\n          recordApiAttempt(performance.now() - attemptStart, metricAttrs, {\n            attempt,\n            result: 'parse_error',\n            willRetry: false,\n            response,\n            errorBody,\n          });\n          requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {\n            result: 'parse_error',\n            attemptCount,\n            response,\n            errorBody,\n          });\n          throw new ProtocolErrorWithLevel(errorBody, 'warn', {cause: error});\n        }\n      } catch (error) {\n        if (isProtocolError(error)) {\n          throw error;\n        }\n\n        const isFetchFailed =\n          error instanceof TypeError && error.message === 'fetch failed';\n        // unexpected/unknown errors should be logged at 'error' level so they\n        // are investigated\n        let logLevel: LogLevel = isFetchFailed ? 'warn' : 'error';\n        lc[logLevel]?.(\n          'fetch from API server threw error',\n          {url: finalUrl},\n          error,\n        );\n\n        const willRetry = isFetchFailed && attempt < MAX_ATTEMPTS;\n        recordApiAttempt(performance.now() - attemptStart, metricAttrs, {\n          attempt,\n          result: 'fetch_error',\n          willRetry,\n        });\n\n        if (willRetry && (await sleepBeforeRetry())) {\n          continue;\n        }\n\n        const errorBody = apiFailedBody(\n          source,\n          ErrorReason.Internal,\n          `Fetch from API server threw error: ${getErrorMessage(error)}`,\n        );\n        requestMetricAttrs = apiRequestMetricAttrs(metricAttrs, {\n          result: 'fetch_error',\n          attemptCount,\n          errorBody,\n        });\n        throw new ProtocolErrorWithLevel(errorBody, logLevel, {cause: error});\n      }\n    }\n    unreachable();\n  } finally {\n    const attrs =\n      requestMetricAttrs ??\n      apiRequestMetricAttrs(metricAttrs, {\n        result: attemptCount === 0 ? 'config_error' : 'fetch_error',\n        attemptCount,\n      });\n    apiRequests().add(1, attrs);\n    apiRequestDuration().recordMs(performance.now() - requestStart, attrs);\n    apiInFlight().add(-1, metricAttrs);\n  }\n}\n\n/**\n * Returns true if the url matches one of the allowedUrlPatterns.\n *\n * URLPattern automatically ignores query parameters and hash fragments during matching\n * because it sets search and hash to wildcard ('*') by default.\n *\n * Example URLPattern patterns:\n * - \"https://api.example.com/endpoint\" - Exact match for a specific URL\n * - \"https://*.example.com/endpoint\" - Matches any single subdomain (e.g., \"https://api.example.com/endpoint\")\n * - \"https://*.*.example.com/endpoint\" - Matches two subdomains (e.g., \"https://api.v1.example.com/endpoint\")\n * - \"https://api.example.com/*\" - Matches any path under /\n * - \"https://api.example.com/:version/endpoint\" - Matches with named parameter (e.g., \"https://api.example.com/v1/endpoint\")\n */\nexport function urlMatch(\n  url: string,\n  allowedUrlPatterns: readonly URLPattern[],\n): boolean {\n  for (const pattern of allowedUrlPatterns) {\n    if (pattern.test(url)) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Returns the delay in milliseconds for the next retry attempt using exponential backoff with jitter.\n *\n * The delay assumes the first retry is attempt 1.\n * The formula is: `min(1000, 100 * 2^(attempt - 1) + jitter)` where jitter is between 0 and 100ms.\n */\nfunction getBackoffDelayMs(attempt: number): number {\n  return Math.min(1000, 100 * Math.pow(2, attempt - 1) + Math.random() * 100);\n}\n\nfunction apiFailedBody(\n  source: 'push' | 'transform',\n  reason: ApiFailedReason,\n  message: string,\n  response?: Response | undefined,\n  bodyPreview?: string | undefined,\n): ErrorBody {\n  if (source === 'push') {\n    return reason === ErrorReason.HTTP\n      ? {\n          kind: ErrorKind.PushFailed,\n          origin: ErrorOrigin.ZeroCache,\n          reason,\n          status: response?.status ?? 0,\n          ...(bodyPreview !== undefined ? {bodyPreview} : {}),\n          message,\n          mutationIDs: [],\n        }\n      : {\n          kind: ErrorKind.PushFailed,\n          origin: ErrorOrigin.ZeroCache,\n          reason,\n          message,\n          mutationIDs: [],\n        };\n  }\n\n  return reason === ErrorReason.HTTP\n    ? {\n        kind: ErrorKind.TransformFailed,\n        origin: ErrorOrigin.ZeroCache,\n        reason,\n        status: response?.status ?? 0,\n        ...(bodyPreview !== undefined ? {bodyPreview} : {}),\n        message,\n        queryIDs: [],\n      }\n    : {\n        kind: ErrorKind.TransformFailed,\n        origin: ErrorOrigin.ZeroCache,\n        reason,\n        message,\n        queryIDs: [],\n      };\n}\n\ntype ApiErrorMetricBody = {\n  kind: ErrorBody['kind'];\n  reason?: string | undefined;\n};\n\nfunction apiErrorFromResult(result: unknown): ApiErrorMetricBody | undefined {\n  const parsed = errorBodySchema.try(result, {mode: 'passthrough'});\n  if (parsed.ok) {\n    return parsed.value;\n  }\n\n  if (Array.isArray(result) && result[0] === 'transformFailed') {\n    const legacyTransformFailed = errorBodySchema.try(result[1], {\n      mode: 'passthrough',\n    });\n    return legacyTransformFailed.ok ? legacyTransformFailed.value : undefined;\n  }\n\n  const legacyPushError = pushErrorSchema.try(result, {mode: 'passthrough'});\n  return legacyPushError.ok\n    ? {\n        kind: ErrorKind.PushFailed,\n        reason: legacyPushErrorReason(legacyPushError.value.error),\n      }\n    : undefined;\n}\n\nfunction legacyPushErrorReason(error: PushError['error']): string {\n  switch (error) {\n    case 'http':\n      return ErrorReason.HTTP;\n    case 'unsupportedPushVersion':\n      return ErrorReason.UnsupportedPushVersion;\n    case 'unsupportedSchemaVersion':\n    case 'zeroPusher':\n      return ErrorReason.Internal;\n  }\n}\n\ntype ApiResponseErrorMetricAttrs = Pick<\n  ApiRequestMetricAttrs,\n  'http_status_code' | 'http_status_class' | 'error_kind' | 'error_reason'\n>;\n\ntype ApiRequestMetricAttrsOptions = {\n  result: ApiRequestResult;\n  attemptCount: number;\n  response?: Response | undefined;\n  errorBody?: ApiErrorMetricBody | undefined;\n};\n\ntype ApiAttemptMetricAttrsOptions = {\n  attempt: number;\n  result: ApiAttemptResult;\n  willRetry: boolean;\n  response?: Response | undefined;\n  errorBody?: ApiErrorMetricBody | undefined;\n};\n\nfunction apiRequestMetricAttrs(\n  baseAttrs: ApiMetricBaseAttrs,\n  {result, attemptCount, response, errorBody}: ApiRequestMetricAttrsOptions,\n): ApiRequestMetricAttrs {\n  return {\n    ...baseAttrs,\n    result,\n    attempt_count: attemptCount,\n    ...apiResponseErrorMetricAttrs(response, errorBody),\n  };\n}\n\nfunction apiResponseErrorMetricAttrs(\n  response: Response | undefined,\n  errorBody: ApiErrorMetricBody | undefined,\n): ApiResponseErrorMetricAttrs {\n  const attrs: ApiResponseErrorMetricAttrs = {};\n\n  if (response) {\n    attrs.http_status_code = response.status;\n    attrs.http_status_class = `${Math.floor(response.status / 100)}xx`;\n  }\n\n  if (errorBody) {\n    attrs.error_kind = errorBody.kind;\n    if (errorBody.reason !== undefined) {\n      attrs.error_reason = errorBody.reason;\n    }\n  }\n\n  return attrs;\n}\n\nfunction recordApiAttempt(\n  durationMs: number,\n  baseAttrs: ApiMetricBaseAttrs,\n  {\n    attempt,\n    result,\n    willRetry,\n    response,\n    errorBody,\n  }: ApiAttemptMetricAttrsOptions,\n) {\n  const attrs: ApiAttemptMetricAttrs = {\n    ...baseAttrs,\n    attempt,\n    result,\n    will_retry: willRetry,\n    ...apiResponseErrorMetricAttrs(response, errorBody),\n  };\n  apiAttempts().add(1, attrs);\n  apiAttemptDuration().recordMs(durationMs, attrs);\n}\n"],"mappings":"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"}

package/out/zero-cache/src/custom/metrics.d.ts

@@ -0,0 +1,31 @@
+export type ApiOperation = 'mutate' | 'query' | 'cleanup' | 'validate_auth';
+export type ApiCleanupType = 'single' | 'bulk';
+export type ApiMetricBaseAttrs = {
+    operation: ApiOperation;
+    cleanup_type?: ApiCleanupType | undefined;
+};
+export type ApiRequestResult = 'success' | 'api_error' | 'http_error' | 'parse_error' | 'fetch_error' | 'url_not_allowed' | 'config_error';
+export type ApiAttemptResult = 'success' | 'api_error' | 'http_error' | 'parse_error' | 'fetch_error';
+export type ApiRequestMetricAttrs = ApiMetricBaseAttrs & {
+    result: ApiRequestResult;
+    attempt_count: number;
+    http_status_code?: number | undefined;
+    http_status_class?: `${string}xx` | undefined;
+    error_kind?: string | undefined;
+    error_reason?: string | undefined;
+};
+export type ApiAttemptMetricAttrs = ApiMetricBaseAttrs & {
+    attempt: number;
+    result: ApiAttemptResult;
+    will_retry: boolean;
+    http_status_code?: number | undefined;
+    http_status_class?: `${string}xx` | undefined;
+    error_kind?: string | undefined;
+    error_reason?: string | undefined;
+};
+export declare function apiRequests(): import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+export declare function apiRequestDuration(): import("../observability/metrics.ts").LatencyHistogram;
+export declare function apiAttempts(): import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+export declare function apiAttemptDuration(): import("../observability/metrics.ts").LatencyHistogram;
+export declare function apiInFlight(): import("@opentelemetry/api").UpDownCounter<import("@opentelemetry/api").Attributes>;
+//# sourceMappingURL=metrics.d.ts.map

package/out/zero-cache/src/custom/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/custom/metrics.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,eAAe,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,YAAY,CAAC;IACxB,YAAY,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,WAAW,GACX,YAAY,GACZ,aAAa,GACb,aAAa,GACb,iBAAiB,GACjB,cAAc,CAAC;AAEnB,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,WAAW,GACX,YAAY,GACZ,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,GAAG;IACvD,MAAM,EAAE,gBAAgB,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,iBAAiB,CAAC,EAAE,GAAG,MAAM,IAAI,GAAG,SAAS,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,GAAG;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,iBAAiB,CAAC,EAAE,GAAG,MAAM,IAAI,GAAG,SAAS,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAOF,wBAAgB,WAAW,kFAM1B;AAED,wBAAgB,kBAAkB,2DAMjC;AAED,wBAAgB,WAAW,kFAM1B;AAED,wBAAgB,kBAAkB,2DAMjC;AAED,wBAAgB,WAAW,wFAM1B"}

package/out/zero-cache/src/custom/metrics.js

@@ -0,0 +1,47 @@
+import { getOrCreateCounter, getOrCreateHistogram, getOrCreateUpDownCounter } from "../observability/metrics.js";
+//#region ../zero-cache/src/custom/metrics.ts
+var API_DURATION_HISTOGRAM_BOUNDARIES_S = [
+	.001,
+	.002,
+	.005,
+	.01,
+	.02,
+	.05,
+	.1,
+	.2,
+	.5,
+	1,
+	2,
+	5,
+	10,
+	30,
+	60,
+	120
+];
+function apiRequests() {
+	return getOrCreateCounter("server", "api.requests", "API requests, labeled by operation and result.");
+}
+function apiRequestDuration() {
+	return getOrCreateHistogram("server", "api.request_duration", {
+		description: "End-to-end API request duration, including retries.",
+		unit: "s",
+		bucketBoundaries: API_DURATION_HISTOGRAM_BOUNDARIES_S
+	});
+}
+function apiAttempts() {
+	return getOrCreateCounter("server", "api.attempts", "API HTTP fetch attempts");
+}
+function apiAttemptDuration() {
+	return getOrCreateHistogram("server", "api.attempt_duration", {
+		description: "API HTTP fetch attempt duration, excluding retry sleep.",
+		unit: "s",
+		bucketBoundaries: API_DURATION_HISTOGRAM_BOUNDARIES_S
+	});
+}
+function apiInFlight() {
+	return getOrCreateUpDownCounter("server", "api.in_flight", "API requests currently in flight.");
+}
+//#endregion
+export { apiAttemptDuration, apiAttempts, apiInFlight, apiRequestDuration, apiRequests };
+
+//# sourceMappingURL=metrics.js.map

package/out/zero-cache/src/custom/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","names":[],"sources":["../../../../../zero-cache/src/custom/metrics.ts"],"sourcesContent":["import {\n  getOrCreateCounter,\n  getOrCreateHistogram,\n  getOrCreateUpDownCounter,\n} from '../observability/metrics.ts';\n\nexport type ApiOperation = 'mutate' | 'query' | 'cleanup' | 'validate_auth';\nexport type ApiCleanupType = 'single' | 'bulk';\n\nexport type ApiMetricBaseAttrs = {\n  operation: ApiOperation;\n  cleanup_type?: ApiCleanupType | undefined;\n};\n\nexport type ApiRequestResult =\n  | 'success'\n  | 'api_error'\n  | 'http_error'\n  | 'parse_error'\n  | 'fetch_error'\n  | 'url_not_allowed'\n  | 'config_error';\n\nexport type ApiAttemptResult =\n  | 'success'\n  | 'api_error'\n  | 'http_error'\n  | 'parse_error'\n  | 'fetch_error';\n\nexport type ApiRequestMetricAttrs = ApiMetricBaseAttrs & {\n  result: ApiRequestResult;\n  attempt_count: number;\n  http_status_code?: number | undefined;\n  http_status_class?: `${string}xx` | undefined;\n  error_kind?: string | undefined;\n  error_reason?: string | undefined;\n};\n\nexport type ApiAttemptMetricAttrs = ApiMetricBaseAttrs & {\n  attempt: number;\n  result: ApiAttemptResult;\n  will_retry: boolean;\n  http_status_code?: number | undefined;\n  http_status_class?: `${string}xx` | undefined;\n  error_kind?: string | undefined;\n  error_reason?: string | undefined;\n};\n\nconst API_DURATION_HISTOGRAM_BOUNDARIES_S = [\n  0.001, 0.002, 0.005, 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60,\n  120,\n];\n\nexport function apiRequests() {\n  return getOrCreateCounter(\n    'server',\n    'api.requests',\n    'API requests, labeled by operation and result.',\n  );\n}\n\nexport function apiRequestDuration() {\n  return getOrCreateHistogram('server', 'api.request_duration', {\n    description: 'End-to-end API request duration, including retries.',\n    unit: 's',\n    bucketBoundaries: API_DURATION_HISTOGRAM_BOUNDARIES_S,\n  });\n}\n\nexport function apiAttempts() {\n  return getOrCreateCounter(\n    'server',\n    'api.attempts',\n    'API HTTP fetch attempts',\n  );\n}\n\nexport function apiAttemptDuration() {\n  return getOrCreateHistogram('server', 'api.attempt_duration', {\n    description: 'API HTTP fetch attempt duration, excluding retry sleep.',\n    unit: 's',\n    bucketBoundaries: API_DURATION_HISTOGRAM_BOUNDARIES_S,\n  });\n}\n\nexport function apiInFlight() {\n  return getOrCreateUpDownCounter(\n    'server',\n    'api.in_flight',\n    'API requests currently in flight.',\n  );\n}\n"],"mappings":";;AAiDA,IAAM,sCAAsC;CAC1C;CAAO;CAAO;CAAO;CAAM;CAAM;CAAM;CAAK;CAAK;CAAK;CAAG;CAAG;CAAG;CAAI;CAAI;CACvE;AACF;AAEA,SAAgB,cAAc;CAC5B,OAAO,mBACL,UACA,gBACA,gDACF;AACF;AAEA,SAAgB,qBAAqB;CACnC,OAAO,qBAAqB,UAAU,wBAAwB;EAC5D,aAAa;EACb,MAAM;EACN,kBAAkB;CACpB,CAAC;AACH;AAEA,SAAgB,cAAc;CAC5B,OAAO,mBACL,UACA,gBACA,yBACF;AACF;AAEA,SAAgB,qBAAqB;CACnC,OAAO,qBAAqB,UAAU,wBAAwB;EAC5D,aAAa;EACb,MAAM;EACN,kBAAkB;CACpB,CAAC;AACH;AAEA,SAAgB,cAAc;CAC5B,OAAO,yBACL,UACA,iBACA,mCACF;AACF"}

package/out/zero-cache/src/custom-queries/transform-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform-query.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/custom-queries/transform-query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAKjD,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,8CAA8C,CAAC;AAItD,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,4BAA4B,CAAC;AAErE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,uDAAuD,CAAC;AAC/D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,oBAAoB,CAAC;AAIhD,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,oBAAoB,CAAC;CAClC,GACD,mBAAmB,CAAC;AAExB,MAAM,MAAM,uBAAuB,GAC/B;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;CAC7B,GACD,CAAC;IACC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,CAAC,oBAAoB,GAAG,YAAY,CAAC,EAAE,CAAC;CACjD,GAAG,CACA;IACE,MAAM,EAAE,IAAI,CAAC;CACd,GACD;IACE,MAAM,EAAE,KAAK,CAAC;IACd,UAAU,EAAE,oBAAoB,CAAC;CAClC,CACJ,CAAC,CAAC;AAEP;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,sBAAsB;;gBAKrB,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO;IAM1C;;;;;;;;OAQG;IACG,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAM5D,SAAS,CACb,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GACnC,OAAO,CAAC,uBAAuB,CAAC;CAwIpC"}
+{"version":3,"file":"transform-query.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/custom-queries/transform-query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAKjD,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,8CAA8C,CAAC;AAItD,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,4BAA4B,CAAC;AAErE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,uDAAuD,CAAC;AAC/D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,oBAAoB,CAAC;AAIhD,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,oBAAoB,CAAC;CAClC,GACD,mBAAmB,CAAC;AAExB,MAAM,MAAM,uBAAuB,GAC/B;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;CAC7B,GACD,CAAC;IACC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,CAAC,oBAAoB,GAAG,YAAY,CAAC,EAAE,CAAC;CACjD,GAAG,CACA;IACE,MAAM,EAAE,IAAI,CAAC;CACd,GACD;IACE,MAAM,EAAE,KAAK,CAAC;IACd,UAAU,EAAE,oBAAoB,CAAC;CAClC,CACJ,CAAC,CAAC;AAEP;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,sBAAsB;;gBAKrB,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO;IAM1C;;;;;;;;OAQG;IACG,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAM5D,SAAS,CACb,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GACnC,OAAO,CAAC,uBAAuB,CAAC;CAyIpC"}

package/out/zero-cache/src/custom-queries/transform-query.js

@@ -103,7 +103,7 @@ var CustomQueryTransformer = class {
 	async #requestTransform(ctx, request, operation) {
 		const queryIDs = request.map(({ id }) => id);
 		try {
-			const transformResponse = await startAsyncSpan(tracer, "customQueryTransformer.fetchFromAPIServer", () => fetchFromAPIServer(queryResponseSchema, "transform", this.#lc, ctx, this.#shard, ["transform", request]));
+			const transformResponse = await startAsyncSpan(tracer, "customQueryTransformer.fetchFromAPIServer", () => fetchFromAPIServer(queryResponseSchema, "transform", this.#lc, ctx, this.#shard, ["transform", request], { operation: operation === "validate" ? "validate_auth" : "query" }));
 			if ("kind" in transformResponse) return transformResponse.kind === "QueryResponse" ? {
 				kind: "QueryResponse",
 				queries: transformResponse.queries,