@geekmidas/client 10.0.0-alpha.9 → 10.0.0-alpha.91

package/dist/telemetry.cjs

@@ -0,0 +1,128 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/telemetry.ts
+/** A `sampleRate` outside 0–1, which no sampler can honour. */
+var InvalidClientSampleRate = class extends Error {
+	sampleRate;
+	constructor(sampleRate) {
+		super(`telemetry.sampleRate must be a number from 0 (no page views) to 1 (every page view), got ${sampleRate}. Pass the stage's sample rate, such as 0.1.`);
+		this.sampleRate = sampleRate;
+		this.name = "InvalidClientSampleRate";
+	}
+};
+const OTEL_GLOBAL = Symbol.for("opentelemetry.js.api.1");
+const setter = { set(carrier, key, value) {
+	carrier[key] = value;
+} };
+/**
+* The headers the registered propagator writes for the active context, or
+* undefined when there is no SDK or no span to continue.
+*/
+function fromActiveContext() {
+	const api = globalThis[OTEL_GLOBAL];
+	if (!api?.propagation || !api.context) return void 0;
+	const carrier = {};
+	try {
+		api.propagation.inject(api.context.active(), carrier, setter);
+	} catch {
+		return;
+	}
+	return carrier.traceparent ? carrier : void 0;
+}
+/** `bytes` crypto-random bytes as lowercase hex, never all zeros. */
+function randomHex(bytes) {
+	const buffer = new Uint8Array(bytes);
+	do
+		globalThis.crypto.getRandomValues(buffer);
+	while (buffer.every((byte) => byte === 0));
+	let hex = "";
+	for (const byte of buffer) hex += byte.toString(16).padStart(2, "0");
+	return hex;
+}
+/**
+* Whether a trace is sampled at `rate`, from its id.
+*
+* The same rule as OpenTelemetry's `TraceIdRatioBasedSampler`: the id's four
+* 32-bit words XORed together, under `rate` of the 32-bit range. The trace id
+* is random, so this samples `rate` of page views — and the API, applying the
+* same rule to the same id at the same rate, keeps exactly the page views kept
+* here rather than a random `rate` of them.
+*/
+function sampledAt(traceId, rate) {
+	if (rate >= 1) return true;
+	if (rate <= 0) return false;
+	let accumulation = 0;
+	for (let i = 0; i < traceId.length; i += 8) accumulation = (accumulation ^ parseInt(traceId.slice(i, i + 8), 16)) >>> 0;
+	return accumulation < Math.floor(rate * 4294967295);
+}
+let browserPageView;
+/**
+* The page view a request belongs to: the page load's in a browser, shared by
+* every client on the page, or this client's own elsewhere — a server process
+* outlives any one user action, so one trace for all of it would mean nothing.
+*/
+function pageViewFor(own) {
+	if (!(typeof window !== "undefined" && typeof document !== "undefined")) return own();
+	browserPageView ??= { traceId: randomHex(16) };
+	return browserPageView;
+}
+/** The origin of `url`, resolved the way `fetch` would, or undefined. */
+function originOf(url) {
+	try {
+		const base = globalThis.location?.href;
+		return new URL(url, base).origin;
+	} catch {
+		return;
+	}
+}
+let fetchRequests;
+/**
+* Whether something instruments `fetch` in this process: OpenTelemetry's
+* undici instrumentation, or an APM built on it, listening on undici's
+* diagnostics channel. It opens each request's CLIENT span and appends that
+* span's `traceparent` itself, so one written here as well would reach the API
+* as two values joined — `a, b` — which no propagator reads.
+*
+* Asked through `process.getBuiltinModule`, so a browser bundle imports no
+* Node module; anywhere without it, nothing is listening.
+*/
+function fetchIsInstrumented() {
+	if (fetchRequests === void 0) {
+		const getBuiltinModule = globalThis.process?.getBuiltinModule;
+		fetchRequests = (getBuiltinModule?.("node:diagnostics_channel"))?.channel("undici:request:create") ?? null;
+	}
+	return fetchRequests?.hasSubscribers === true;
+}
+/**
+* An injector for a client whose API is at `baseURL`, or undefined when
+* telemetry is off.
+*/
+function traceContextInjector(baseURL, telemetry) {
+	if (!telemetry) return void 0;
+	const sampleRate = telemetry === true ? 1 : telemetry.sampleRate ?? 1;
+	if (!Number.isFinite(sampleRate) || sampleRate < 0 || sampleRate > 1) throw new InvalidClientSampleRate(sampleRate);
+	const apiOrigin = originOf(baseURL || "/");
+	let own;
+	const ownPageView = () => {
+		own ??= { traceId: randomHex(16) };
+		return own;
+	};
+	return (url, headers) => {
+		if (!apiOrigin || originOf(url) !== apiOrigin) return;
+		if (Object.keys(headers).some((h) => h.toLowerCase() === "traceparent")) return;
+		if (fetchIsInstrumented()) return;
+		const active = fromActiveContext();
+		if (active) {
+			Object.assign(headers, active);
+			return;
+		}
+		const { traceId } = pageViewFor(ownPageView);
+		const flags = sampledAt(traceId, sampleRate) ? "01" : "00";
+		headers.traceparent = `00-${traceId}-${randomHex(8)}-${flags}`;
+	};
+}
+//#endregion
+exports.InvalidClientSampleRate = InvalidClientSampleRate;
+exports.sampledAt = sampledAt;
+exports.traceContextInjector = traceContextInjector;
+
+//# sourceMappingURL=telemetry.cjs.map

package/dist/telemetry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.cjs","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":["/**\n * W3C trace context on the requests a client makes to its own API, so a user\n * action in the browser and the API request it causes are one trace.\n *\n * Two levels, chosen per request:\n *\n * - **An OpenTelemetry context is active** — a browser SDK has a span open, or\n *   this runs on a server (a Next.js server component, an API calling another\n *   API) inside a request span. The globally registered propagator writes the\n *   headers, so the current span is the parent: `traceparent`, `tracestate`,\n *   and whatever else that propagator carries.\n * - **Otherwise** (level 1): one trace id per page view — per page load in a\n *   browser, per client in Node — a fresh span id per request, and a sampled\n *   flag decided once per page view from {@link ClientTelemetryOptions.sampleRate}.\n *\n * Nothing is sent to any origin but the API's own: a trace id is an identifier,\n * and a third party has no business correlating a user's requests by it. And\n * nothing at all where a `fetch` instrumentation is listening (a server with\n * OpenTelemetry's undici instrumentation): it writes the request's own\n * context, and two `traceparent` headers would be read as none.\n *\n * `@opentelemetry/api` is not imported. Every copy of it — whichever version\n * an app bundles — registers its globals on `globalThis` under\n * `Symbol.for('opentelemetry.js.api.1')`, which is how two copies in one page\n * already share a provider. Reading the propagator and context manager from\n * there costs a browser bundle nothing when no SDK is loaded, and still finds\n * the SDK when one is.\n */\n\n/** Telemetry on a client: `true` for the defaults, or these options. */\nexport interface ClientTelemetryOptions {\n\t/**\n\t * The fraction of page views whose requests are sampled, from 0 to 1, when\n\t * no OpenTelemetry context is active. Decided once per page view, so a\n\t * page's requests are all kept or all dropped together.\n\t *\n\t * Use the stage's rate. The API caps an incoming sampled flag at its own\n\t * rate anyway, and decides from the trace id the same way this does, so a\n\t * page view sampled here at the API's rate is sampled there too.\n\t * @default 1\n\t */\n\tsampleRate?: number;\n}\n\n/** A `sampleRate` outside 0–1, which no sampler can honour. */\nexport class InvalidClientSampleRate extends Error {\n\tconstructor(readonly sampleRate: number) {\n\t\tsuper(\n\t\t\t`telemetry.sampleRate must be a number from 0 (no page views) to 1 (every page view), got ${sampleRate}. Pass the stage's sample rate, such as 0.1.`,\n\t\t);\n\t\tthis.name = 'InvalidClientSampleRate';\n\t}\n}\n\n/** Adds trace headers to a request to `url`, when it is the API's own. */\nexport type TraceContextInjector = (\n\turl: string,\n\theaders: Record<string, string>,\n) => void;\n\n/** The slice of `@opentelemetry/api`'s global registry this reads. */\ninterface OtelGlobal {\n\tcontext?: { active(): unknown };\n\tpropagation?: {\n\t\tinject(\n\t\t\tcontext: unknown,\n\t\t\tcarrier: Record<string, string>,\n\t\t\tsetter: {\n\t\t\t\tset(carrier: Record<string, string>, key: string, value: string): void;\n\t\t\t},\n\t\t): void;\n\t};\n}\n\nconst OTEL_GLOBAL = Symbol.for('opentelemetry.js.api.1');\n\nconst setter = {\n\tset(carrier: Record<string, string>, key: string, value: string) {\n\t\tcarrier[key] = value;\n\t},\n};\n\n/**\n * The headers the registered propagator writes for the active context, or\n * undefined when there is no SDK or no span to continue.\n */\nfunction fromActiveContext(): Record<string, string> | undefined {\n\tconst api = (globalThis as Record<symbol, OtelGlobal | undefined>)[\n\t\tOTEL_GLOBAL\n\t];\n\tif (!api?.propagation || !api.context) return undefined;\n\n\tconst carrier: Record<string, string> = {};\n\ttry {\n\t\tapi.propagation.inject(api.context.active(), carrier, setter);\n\t} catch {\n\t\treturn undefined;\n\t}\n\t// The W3C propagator writes nothing without a valid, unsuppressed span.\n\treturn carrier.traceparent ? carrier : undefined;\n}\n\n/** `bytes` crypto-random bytes as lowercase hex, never all zeros. */\nfunction randomHex(bytes: number): string {\n\tconst buffer = new Uint8Array(bytes);\n\tdo {\n\t\tglobalThis.crypto.getRandomValues(buffer);\n\t} while (buffer.every((byte) => byte === 0));\n\tlet hex = '';\n\tfor (const byte of buffer) hex += byte.toString(16).padStart(2, '0');\n\treturn hex;\n}\n\n/**\n * Whether a trace is sampled at `rate`, from its id.\n *\n * The same rule as OpenTelemetry's `TraceIdRatioBasedSampler`: the id's four\n * 32-bit words XORed together, under `rate` of the 32-bit range. The trace id\n * is random, so this samples `rate` of page views — and the API, applying the\n * same rule to the same id at the same rate, keeps exactly the page views kept\n * here rather than a random `rate` of them.\n */\nexport function sampledAt(traceId: string, rate: number): boolean {\n\tif (rate >= 1) return true;\n\tif (rate <= 0) return false;\n\tlet accumulation = 0;\n\tfor (let i = 0; i < traceId.length; i += 8) {\n\t\taccumulation = (accumulation ^ parseInt(traceId.slice(i, i + 8), 16)) >>> 0;\n\t}\n\treturn accumulation < Math.floor(rate * 0xffffffff);\n}\n\n/** A page view: one trace id for every request made during it. */\ninterface PageView {\n\ttraceId: string;\n}\n\nlet browserPageView: PageView | undefined;\n\n/**\n * The page view a request belongs to: the page load's in a browser, shared by\n * every client on the page, or this client's own elsewhere — a server process\n * outlives any one user action, so one trace for all of it would mean nothing.\n */\nfunction pageViewFor(own: () => PageView): PageView {\n\tconst browser =\n\t\ttypeof window !== 'undefined' && typeof document !== 'undefined';\n\tif (!browser) return own();\n\tbrowserPageView ??= { traceId: randomHex(16) };\n\treturn browserPageView;\n}\n\n/** The origin of `url`, resolved the way `fetch` would, or undefined. */\nfunction originOf(url: string): string | undefined {\n\ttry {\n\t\tconst base = (globalThis as { location?: { href?: string } }).location\n\t\t\t?.href;\n\t\treturn new URL(url, base).origin;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\n/** The slice of `node:diagnostics_channel` this reads. */\ninterface DiagnosticsChannels {\n\tchannel(name: string): { hasSubscribers: boolean };\n}\n\nlet fetchRequests: { hasSubscribers: boolean } | null | undefined;\n\n/**\n * Whether something instruments `fetch` in this process: OpenTelemetry's\n * undici instrumentation, or an APM built on it, listening on undici's\n * diagnostics channel. It opens each request's CLIENT span and appends that\n * span's `traceparent` itself, so one written here as well would reach the API\n * as two values joined — `a, b` — which no propagator reads.\n *\n * Asked through `process.getBuiltinModule`, so a browser bundle imports no\n * Node module; anywhere without it, nothing is listening.\n */\nfunction fetchIsInstrumented(): boolean {\n\tif (fetchRequests === undefined) {\n\t\tconst getBuiltinModule = (\n\t\t\tglobalThis as {\n\t\t\t\tprocess?: { getBuiltinModule?: (id: string) => unknown };\n\t\t\t}\n\t\t).process?.getBuiltinModule;\n\t\tconst channels = getBuiltinModule?.('node:diagnostics_channel') as\n\t\t\t| DiagnosticsChannels\n\t\t\t| undefined;\n\t\tfetchRequests = channels?.channel('undici:request:create') ?? null;\n\t}\n\treturn fetchRequests?.hasSubscribers === true;\n}\n\n/**\n * An injector for a client whose API is at `baseURL`, or undefined when\n * telemetry is off.\n */\nexport function traceContextInjector(\n\tbaseURL: string,\n\ttelemetry: boolean | ClientTelemetryOptions | undefined,\n): TraceContextInjector | undefined {\n\tif (!telemetry) return undefined;\n\n\tconst sampleRate = telemetry === true ? 1 : (telemetry.sampleRate ?? 1);\n\tif (!Number.isFinite(sampleRate) || sampleRate < 0 || sampleRate > 1) {\n\t\tthrow new InvalidClientSampleRate(sampleRate);\n\t}\n\n\tconst apiOrigin = originOf(baseURL || '/');\n\tlet own: PageView | undefined;\n\tconst ownPageView = () => {\n\t\town ??= { traceId: randomHex(16) };\n\t\treturn own;\n\t};\n\n\treturn (url, headers) => {\n\t\t// Only the API's own origin: never a third party, and never anything\n\t\t// whose origin cannot be told.\n\t\tif (!apiOrigin || originOf(url) !== apiOrigin) return;\n\t\t// A caller that set its own context keeps it.\n\t\tif (Object.keys(headers).some((h) => h.toLowerCase() === 'traceparent'))\n\t\t\treturn;\n\t\t// A fetch instrumentation writes the request's own context.\n\t\tif (fetchIsInstrumented()) return;\n\n\t\tconst active = fromActiveContext();\n\t\tif (active) {\n\t\t\tObject.assign(headers, active);\n\t\t\treturn;\n\t\t}\n\n\t\tconst { traceId } = pageViewFor(ownPageView);\n\t\tconst flags = sampledAt(traceId, sampleRate) ? '01' : '00';\n\t\theaders.traceparent = `00-${traceId}-${randomHex(8)}-${flags}`;\n\t};\n}\n"],"mappings":"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"}

package/dist/telemetry.d.cts

@@ -0,0 +1,2 @@
+import { a as traceContextInjector, i as sampledAt, n as InvalidClientSampleRate, r as TraceContextInjector, t as ClientTelemetryOptions } from "./telemetry-g3BE86Wd.cjs";
+export { ClientTelemetryOptions, InvalidClientSampleRate, TraceContextInjector, sampledAt, traceContextInjector };

package/dist/telemetry.d.mts

@@ -0,0 +1,2 @@
+import { a as traceContextInjector, i as sampledAt, n as InvalidClientSampleRate, r as TraceContextInjector, t as ClientTelemetryOptions } from "./telemetry-g3BE86Wd.mjs";
+export { ClientTelemetryOptions, InvalidClientSampleRate, TraceContextInjector, sampledAt, traceContextInjector };

package/dist/telemetry.mjs

@@ -0,0 +1,125 @@
+//#region src/telemetry.ts
+/** A `sampleRate` outside 0–1, which no sampler can honour. */
+var InvalidClientSampleRate = class extends Error {
+	sampleRate;
+	constructor(sampleRate) {
+		super(`telemetry.sampleRate must be a number from 0 (no page views) to 1 (every page view), got ${sampleRate}. Pass the stage's sample rate, such as 0.1.`);
+		this.sampleRate = sampleRate;
+		this.name = "InvalidClientSampleRate";
+	}
+};
+const OTEL_GLOBAL = Symbol.for("opentelemetry.js.api.1");
+const setter = { set(carrier, key, value) {
+	carrier[key] = value;
+} };
+/**
+* The headers the registered propagator writes for the active context, or
+* undefined when there is no SDK or no span to continue.
+*/
+function fromActiveContext() {
+	const api = globalThis[OTEL_GLOBAL];
+	if (!api?.propagation || !api.context) return void 0;
+	const carrier = {};
+	try {
+		api.propagation.inject(api.context.active(), carrier, setter);
+	} catch {
+		return;
+	}
+	return carrier.traceparent ? carrier : void 0;
+}
+/** `bytes` crypto-random bytes as lowercase hex, never all zeros. */
+function randomHex(bytes) {
+	const buffer = new Uint8Array(bytes);
+	do
+		globalThis.crypto.getRandomValues(buffer);
+	while (buffer.every((byte) => byte === 0));
+	let hex = "";
+	for (const byte of buffer) hex += byte.toString(16).padStart(2, "0");
+	return hex;
+}
+/**
+* Whether a trace is sampled at `rate`, from its id.
+*
+* The same rule as OpenTelemetry's `TraceIdRatioBasedSampler`: the id's four
+* 32-bit words XORed together, under `rate` of the 32-bit range. The trace id
+* is random, so this samples `rate` of page views — and the API, applying the
+* same rule to the same id at the same rate, keeps exactly the page views kept
+* here rather than a random `rate` of them.
+*/
+function sampledAt(traceId, rate) {
+	if (rate >= 1) return true;
+	if (rate <= 0) return false;
+	let accumulation = 0;
+	for (let i = 0; i < traceId.length; i += 8) accumulation = (accumulation ^ parseInt(traceId.slice(i, i + 8), 16)) >>> 0;
+	return accumulation < Math.floor(rate * 4294967295);
+}
+let browserPageView;
+/**
+* The page view a request belongs to: the page load's in a browser, shared by
+* every client on the page, or this client's own elsewhere — a server process
+* outlives any one user action, so one trace for all of it would mean nothing.
+*/
+function pageViewFor(own) {
+	if (!(typeof window !== "undefined" && typeof document !== "undefined")) return own();
+	browserPageView ??= { traceId: randomHex(16) };
+	return browserPageView;
+}
+/** The origin of `url`, resolved the way `fetch` would, or undefined. */
+function originOf(url) {
+	try {
+		const base = globalThis.location?.href;
+		return new URL(url, base).origin;
+	} catch {
+		return;
+	}
+}
+let fetchRequests;
+/**
+* Whether something instruments `fetch` in this process: OpenTelemetry's
+* undici instrumentation, or an APM built on it, listening on undici's
+* diagnostics channel. It opens each request's CLIENT span and appends that
+* span's `traceparent` itself, so one written here as well would reach the API
+* as two values joined — `a, b` — which no propagator reads.
+*
+* Asked through `process.getBuiltinModule`, so a browser bundle imports no
+* Node module; anywhere without it, nothing is listening.
+*/
+function fetchIsInstrumented() {
+	if (fetchRequests === void 0) {
+		const getBuiltinModule = globalThis.process?.getBuiltinModule;
+		fetchRequests = (getBuiltinModule?.("node:diagnostics_channel"))?.channel("undici:request:create") ?? null;
+	}
+	return fetchRequests?.hasSubscribers === true;
+}
+/**
+* An injector for a client whose API is at `baseURL`, or undefined when
+* telemetry is off.
+*/
+function traceContextInjector(baseURL, telemetry) {
+	if (!telemetry) return void 0;
+	const sampleRate = telemetry === true ? 1 : telemetry.sampleRate ?? 1;
+	if (!Number.isFinite(sampleRate) || sampleRate < 0 || sampleRate > 1) throw new InvalidClientSampleRate(sampleRate);
+	const apiOrigin = originOf(baseURL || "/");
+	let own;
+	const ownPageView = () => {
+		own ??= { traceId: randomHex(16) };
+		return own;
+	};
+	return (url, headers) => {
+		if (!apiOrigin || originOf(url) !== apiOrigin) return;
+		if (Object.keys(headers).some((h) => h.toLowerCase() === "traceparent")) return;
+		if (fetchIsInstrumented()) return;
+		const active = fromActiveContext();
+		if (active) {
+			Object.assign(headers, active);
+			return;
+		}
+		const { traceId } = pageViewFor(ownPageView);
+		const flags = sampledAt(traceId, sampleRate) ? "01" : "00";
+		headers.traceparent = `00-${traceId}-${randomHex(8)}-${flags}`;
+	};
+}
+//#endregion
+export { InvalidClientSampleRate, sampledAt, traceContextInjector };
+
+//# sourceMappingURL=telemetry.mjs.map

package/dist/telemetry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.mjs","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":["/**\n * W3C trace context on the requests a client makes to its own API, so a user\n * action in the browser and the API request it causes are one trace.\n *\n * Two levels, chosen per request:\n *\n * - **An OpenTelemetry context is active** — a browser SDK has a span open, or\n *   this runs on a server (a Next.js server component, an API calling another\n *   API) inside a request span. The globally registered propagator writes the\n *   headers, so the current span is the parent: `traceparent`, `tracestate`,\n *   and whatever else that propagator carries.\n * - **Otherwise** (level 1): one trace id per page view — per page load in a\n *   browser, per client in Node — a fresh span id per request, and a sampled\n *   flag decided once per page view from {@link ClientTelemetryOptions.sampleRate}.\n *\n * Nothing is sent to any origin but the API's own: a trace id is an identifier,\n * and a third party has no business correlating a user's requests by it. And\n * nothing at all where a `fetch` instrumentation is listening (a server with\n * OpenTelemetry's undici instrumentation): it writes the request's own\n * context, and two `traceparent` headers would be read as none.\n *\n * `@opentelemetry/api` is not imported. Every copy of it — whichever version\n * an app bundles — registers its globals on `globalThis` under\n * `Symbol.for('opentelemetry.js.api.1')`, which is how two copies in one page\n * already share a provider. Reading the propagator and context manager from\n * there costs a browser bundle nothing when no SDK is loaded, and still finds\n * the SDK when one is.\n */\n\n/** Telemetry on a client: `true` for the defaults, or these options. */\nexport interface ClientTelemetryOptions {\n\t/**\n\t * The fraction of page views whose requests are sampled, from 0 to 1, when\n\t * no OpenTelemetry context is active. Decided once per page view, so a\n\t * page's requests are all kept or all dropped together.\n\t *\n\t * Use the stage's rate. The API caps an incoming sampled flag at its own\n\t * rate anyway, and decides from the trace id the same way this does, so a\n\t * page view sampled here at the API's rate is sampled there too.\n\t * @default 1\n\t */\n\tsampleRate?: number;\n}\n\n/** A `sampleRate` outside 0–1, which no sampler can honour. */\nexport class InvalidClientSampleRate extends Error {\n\tconstructor(readonly sampleRate: number) {\n\t\tsuper(\n\t\t\t`telemetry.sampleRate must be a number from 0 (no page views) to 1 (every page view), got ${sampleRate}. Pass the stage's sample rate, such as 0.1.`,\n\t\t);\n\t\tthis.name = 'InvalidClientSampleRate';\n\t}\n}\n\n/** Adds trace headers to a request to `url`, when it is the API's own. */\nexport type TraceContextInjector = (\n\turl: string,\n\theaders: Record<string, string>,\n) => void;\n\n/** The slice of `@opentelemetry/api`'s global registry this reads. */\ninterface OtelGlobal {\n\tcontext?: { active(): unknown };\n\tpropagation?: {\n\t\tinject(\n\t\t\tcontext: unknown,\n\t\t\tcarrier: Record<string, string>,\n\t\t\tsetter: {\n\t\t\t\tset(carrier: Record<string, string>, key: string, value: string): void;\n\t\t\t},\n\t\t): void;\n\t};\n}\n\nconst OTEL_GLOBAL = Symbol.for('opentelemetry.js.api.1');\n\nconst setter = {\n\tset(carrier: Record<string, string>, key: string, value: string) {\n\t\tcarrier[key] = value;\n\t},\n};\n\n/**\n * The headers the registered propagator writes for the active context, or\n * undefined when there is no SDK or no span to continue.\n */\nfunction fromActiveContext(): Record<string, string> | undefined {\n\tconst api = (globalThis as Record<symbol, OtelGlobal | undefined>)[\n\t\tOTEL_GLOBAL\n\t];\n\tif (!api?.propagation || !api.context) return undefined;\n\n\tconst carrier: Record<string, string> = {};\n\ttry {\n\t\tapi.propagation.inject(api.context.active(), carrier, setter);\n\t} catch {\n\t\treturn undefined;\n\t}\n\t// The W3C propagator writes nothing without a valid, unsuppressed span.\n\treturn carrier.traceparent ? carrier : undefined;\n}\n\n/** `bytes` crypto-random bytes as lowercase hex, never all zeros. */\nfunction randomHex(bytes: number): string {\n\tconst buffer = new Uint8Array(bytes);\n\tdo {\n\t\tglobalThis.crypto.getRandomValues(buffer);\n\t} while (buffer.every((byte) => byte === 0));\n\tlet hex = '';\n\tfor (const byte of buffer) hex += byte.toString(16).padStart(2, '0');\n\treturn hex;\n}\n\n/**\n * Whether a trace is sampled at `rate`, from its id.\n *\n * The same rule as OpenTelemetry's `TraceIdRatioBasedSampler`: the id's four\n * 32-bit words XORed together, under `rate` of the 32-bit range. The trace id\n * is random, so this samples `rate` of page views — and the API, applying the\n * same rule to the same id at the same rate, keeps exactly the page views kept\n * here rather than a random `rate` of them.\n */\nexport function sampledAt(traceId: string, rate: number): boolean {\n\tif (rate >= 1) return true;\n\tif (rate <= 0) return false;\n\tlet accumulation = 0;\n\tfor (let i = 0; i < traceId.length; i += 8) {\n\t\taccumulation = (accumulation ^ parseInt(traceId.slice(i, i + 8), 16)) >>> 0;\n\t}\n\treturn accumulation < Math.floor(rate * 0xffffffff);\n}\n\n/** A page view: one trace id for every request made during it. */\ninterface PageView {\n\ttraceId: string;\n}\n\nlet browserPageView: PageView | undefined;\n\n/**\n * The page view a request belongs to: the page load's in a browser, shared by\n * every client on the page, or this client's own elsewhere — a server process\n * outlives any one user action, so one trace for all of it would mean nothing.\n */\nfunction pageViewFor(own: () => PageView): PageView {\n\tconst browser =\n\t\ttypeof window !== 'undefined' && typeof document !== 'undefined';\n\tif (!browser) return own();\n\tbrowserPageView ??= { traceId: randomHex(16) };\n\treturn browserPageView;\n}\n\n/** The origin of `url`, resolved the way `fetch` would, or undefined. */\nfunction originOf(url: string): string | undefined {\n\ttry {\n\t\tconst base = (globalThis as { location?: { href?: string } }).location\n\t\t\t?.href;\n\t\treturn new URL(url, base).origin;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\n/** The slice of `node:diagnostics_channel` this reads. */\ninterface DiagnosticsChannels {\n\tchannel(name: string): { hasSubscribers: boolean };\n}\n\nlet fetchRequests: { hasSubscribers: boolean } | null | undefined;\n\n/**\n * Whether something instruments `fetch` in this process: OpenTelemetry's\n * undici instrumentation, or an APM built on it, listening on undici's\n * diagnostics channel. It opens each request's CLIENT span and appends that\n * span's `traceparent` itself, so one written here as well would reach the API\n * as two values joined — `a, b` — which no propagator reads.\n *\n * Asked through `process.getBuiltinModule`, so a browser bundle imports no\n * Node module; anywhere without it, nothing is listening.\n */\nfunction fetchIsInstrumented(): boolean {\n\tif (fetchRequests === undefined) {\n\t\tconst getBuiltinModule = (\n\t\t\tglobalThis as {\n\t\t\t\tprocess?: { getBuiltinModule?: (id: string) => unknown };\n\t\t\t}\n\t\t).process?.getBuiltinModule;\n\t\tconst channels = getBuiltinModule?.('node:diagnostics_channel') as\n\t\t\t| DiagnosticsChannels\n\t\t\t| undefined;\n\t\tfetchRequests = channels?.channel('undici:request:create') ?? null;\n\t}\n\treturn fetchRequests?.hasSubscribers === true;\n}\n\n/**\n * An injector for a client whose API is at `baseURL`, or undefined when\n * telemetry is off.\n */\nexport function traceContextInjector(\n\tbaseURL: string,\n\ttelemetry: boolean | ClientTelemetryOptions | undefined,\n): TraceContextInjector | undefined {\n\tif (!telemetry) return undefined;\n\n\tconst sampleRate = telemetry === true ? 1 : (telemetry.sampleRate ?? 1);\n\tif (!Number.isFinite(sampleRate) || sampleRate < 0 || sampleRate > 1) {\n\t\tthrow new InvalidClientSampleRate(sampleRate);\n\t}\n\n\tconst apiOrigin = originOf(baseURL || '/');\n\tlet own: PageView | undefined;\n\tconst ownPageView = () => {\n\t\town ??= { traceId: randomHex(16) };\n\t\treturn own;\n\t};\n\n\treturn (url, headers) => {\n\t\t// Only the API's own origin: never a third party, and never anything\n\t\t// whose origin cannot be told.\n\t\tif (!apiOrigin || originOf(url) !== apiOrigin) return;\n\t\t// A caller that set its own context keeps it.\n\t\tif (Object.keys(headers).some((h) => h.toLowerCase() === 'traceparent'))\n\t\t\treturn;\n\t\t// A fetch instrumentation writes the request's own context.\n\t\tif (fetchIsInstrumented()) return;\n\n\t\tconst active = fromActiveContext();\n\t\tif (active) {\n\t\t\tObject.assign(headers, active);\n\t\t\treturn;\n\t\t}\n\n\t\tconst { traceId } = pageViewFor(ownPageView);\n\t\tconst flags = sampledAt(traceId, sampleRate) ? '01' : '00';\n\t\theaders.traceparent = `00-${traceId}-${randomHex(8)}-${flags}`;\n\t};\n}\n"],"mappings":";;AA6CA,IAAa,0BAAb,cAA6C,MAAM;CAC7B;CAArB,YAAY,YAA6B;EACxC,MACC,4FAA4F,WAAW,6CACxG;EAHoB,KAAA,aAAA;EAIpB,KAAK,OAAO;CACb;AACD;AAsBA,MAAM,cAAc,OAAO,IAAI,wBAAwB;AAEvD,MAAM,SAAS,EACd,IAAI,SAAiC,KAAa,OAAe;CAChE,QAAQ,OAAO;AAChB,EACD;;;;;AAMA,SAAS,oBAAwD;CAChE,MAAM,MAAO,WACZ;CAED,IAAI,CAAC,KAAK,eAAe,CAAC,IAAI,SAAS,OAAO,KAAA;CAE9C,MAAM,UAAkC,CAAC;CACzC,IAAI;EACH,IAAI,YAAY,OAAO,IAAI,QAAQ,OAAO,GAAG,SAAS,MAAM;CAC7D,QAAQ;EACP;CACD;CAEA,OAAO,QAAQ,cAAc,UAAU,KAAA;AACxC;;AAGA,SAAS,UAAU,OAAuB;CACzC,MAAM,SAAS,IAAI,WAAW,KAAK;CACnC;EACC,WAAW,OAAO,gBAAgB,MAAM;QAChC,OAAO,OAAO,SAAS,SAAS,CAAC;CAC1C,IAAI,MAAM;CACV,KAAK,MAAM,QAAQ,QAAQ,OAAO,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG;CACnE,OAAO;AACR;;;;;;;;;;AAWA,SAAgB,UAAU,SAAiB,MAAuB;CACjE,IAAI,QAAQ,GAAG,OAAO;CACtB,IAAI,QAAQ,GAAG,OAAO;CACtB,IAAI,eAAe;CACnB,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,GACxC,gBAAgB,eAAe,SAAS,QAAQ,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO;CAE3E,OAAO,eAAe,KAAK,MAAM,OAAO,UAAU;AACnD;AAOA,IAAI;;;;;;AAOJ,SAAS,YAAY,KAA+B;CAGnD,IAAI,EADH,OAAO,WAAW,eAAe,OAAO,aAAa,cACxC,OAAO,IAAI;CACzB,oBAAoB,EAAE,SAAS,UAAU,EAAE,EAAE;CAC7C,OAAO;AACR;;AAGA,SAAS,SAAS,KAAiC;CAClD,IAAI;EACH,MAAM,OAAQ,WAAgD,UAC3D;EACH,OAAO,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;CAC3B,QAAQ;EACP;CACD;AACD;AAOA,IAAI;;;;;;;;;;;AAYJ,SAAS,sBAA+B;CACvC,IAAI,kBAAkB,KAAA,GAAW;EAChC,MAAM,mBACL,WAGC,SAAS;EAIX,iBAHiB,mBAAmB,0BAA0B,EAAA,EAGpC,QAAQ,uBAAuB,KAAK;CAC/D;CACA,OAAO,eAAe,mBAAmB;AAC1C;;;;;AAMA,SAAgB,qBACf,SACA,WACmC;CACnC,IAAI,CAAC,WAAW,OAAO,KAAA;CAEvB,MAAM,aAAa,cAAc,OAAO,IAAK,UAAU,cAAc;CACrE,IAAI,CAAC,OAAO,SAAS,UAAU,KAAK,aAAa,KAAK,aAAa,GAClE,MAAM,IAAI,wBAAwB,UAAU;CAG7C,MAAM,YAAY,SAAS,WAAW,GAAG;CACzC,IAAI;CACJ,MAAM,oBAAoB;EACzB,QAAQ,EAAE,SAAS,UAAU,EAAE,EAAE;EACjC,OAAO;CACR;CAEA,QAAQ,KAAK,YAAY;EAGxB,IAAI,CAAC,aAAa,SAAS,GAAG,MAAM,WAAW;EAE/C,IAAI,OAAO,KAAK,OAAO,CAAC,CAAC,MAAM,MAAM,EAAE,YAAY,MAAM,aAAa,GACrE;EAED,IAAI,oBAAoB,GAAG;EAE3B,MAAM,SAAS,kBAAkB;EACjC,IAAI,QAAQ;GACX,OAAO,OAAO,SAAS,MAAM;GAC7B;EACD;EAEA,MAAM,EAAE,YAAY,YAAY,WAAW;EAC3C,MAAM,QAAQ,UAAU,SAAS,UAAU,IAAI,OAAO;EACtD,QAAQ,cAAc,MAAM,QAAQ,GAAG,UAAU,CAAC,EAAE,GAAG;CACxD;AACD"}

package/dist/types.cjs

@@ -1 +0,0 @@
-require('./types-a8gm_IaQ.cjs');

package/dist/types.d.cts

@@ -1,2 +1,122 @@
-import { EndpointString, ErrorTransformer, ExtractEndpointConfig, ExtractEndpointResponse, ExtractMethod, ExtractPathParams, ExtractQueryParams, ExtractRequestBody, ExtractResponse, FetcherOptions, FilterEndpointByMethod, FilteredRequestConfig, IsConfigRequired, MutationEndpoint, OpenAPIRoutes, ParseEndpoint, QueryEndpoint, RequestConfig, TypedApiFunction, TypedEndpoint, ValidEndpoint, WrappedApiFunction, WrappedResult } from "./types-DMQMHePI.cjs";
-export { EndpointString, ErrorTransformer, ExtractEndpointConfig, ExtractEndpointResponse, ExtractMethod, ExtractPathParams, ExtractQueryParams, ExtractRequestBody, ExtractResponse, FetcherOptions, FilterEndpointByMethod, FilteredRequestConfig, IsConfigRequired, MutationEndpoint, OpenAPIRoutes, ParseEndpoint, QueryEndpoint, RequestConfig, TypedApiFunction, TypedEndpoint, ValidEndpoint, WrappedApiFunction, WrappedResult };
+import { t as ClientTelemetryOptions } from "./telemetry-g3BE86Wd.cjs";
+//#region src/types.d.ts
+export type OpenAPIRoutes<Paths> = keyof Paths;
+type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'head' | 'options';
+export type ExtractMethod<Paths, Route extends OpenAPIRoutes<Paths>> = Extract<keyof Paths[Route], HttpMethod>;
+export type ExtractPathParams<Paths, Route extends OpenAPIRoutes<Paths>> = Paths[Route] extends {
+  parameters?: {
+    path?: infer P;
+  };
+} ? P : never;
+export type ExtractQueryParams<Paths, Route extends OpenAPIRoutes<Paths>, Method extends ExtractMethod<Paths, Route>> = Paths[Route][Method] extends {
+  parameters?: {
+    query?: infer Q;
+  };
+} ? Q : never;
+export type ExtractRequestBody<Paths, Route extends OpenAPIRoutes<Paths>, Method extends ExtractMethod<Paths, Route>> = Paths[Route][Method] extends {
+  requestBody?: infer RB;
+} ? [NonNullable<RB>] extends [never] ? never : NonNullable<RB> extends {
+  content?: {
+    'application/json'?: infer B;
+  };
+} ? B : never : never;
+export type ExtractResponse<Paths, Route extends OpenAPIRoutes<Paths>, Method extends ExtractMethod<Paths, Route>> = Paths[Route][Method] extends {
+  responses?: {
+    200?: {
+      content?: {
+        'application/json'?: infer R;
+      };
+    };
+  };
+} ? R : Paths[Route][Method] extends {
+  responses?: {
+    201?: {
+      content?: {
+        'application/json'?: infer R;
+      };
+    };
+  };
+} ? R : never;
+export type RequestConfig<Paths, Route extends OpenAPIRoutes<Paths>, Method extends ExtractMethod<Paths, Route>> = {
+  params?: ExtractPathParams<Paths, Route>;
+  query?: ExtractQueryParams<Paths, Route, Method>;
+  body?: ExtractRequestBody<Paths, Route, Method>;
+  headers?: Record<string, string>;
+};
+export type EndpointString = `${Uppercase<string>} ${string}`;
+export type ValidEndpoint<Paths> = { [Route in keyof Paths]: { [Method in Extract<keyof Paths[Route], HttpMethod>]: `${Uppercase<string & Method>} ${string & Route}`; }[Extract<keyof Paths[Route], HttpMethod>]; }[keyof Paths];
+export type TypedEndpoint<Paths> = ValidEndpoint<Paths> extends (infer E) ? (E extends string ? E : never) : never;
+export type FilterEndpointByMethod<Paths, Method extends string> = ValidEndpoint<Paths> extends (infer E) ? E extends `${Method} ${string}` ? E : never : never;
+export type QueryEndpoint<Paths> = FilterEndpointByMethod<Paths, 'GET'>;
+export type MutationEndpoint<Paths> = FilterEndpointByMethod<Paths, 'POST'> | FilterEndpointByMethod<Paths, 'PATCH'> | FilterEndpointByMethod<Paths, 'PUT'> | FilterEndpointByMethod<Paths, 'DELETE'>;
+export type ParseEndpoint<T extends EndpointString> = T extends `${infer Method} ${infer Route}` ? {
+  method: Lowercase<Method>;
+  route: Route;
+} : never;
+export type ExtractEndpointResponse<Paths, T extends EndpointString> = T extends `${infer Method} ${infer Route}` ? Route extends OpenAPIRoutes<Paths> ? Lowercase<Method> extends ExtractMethod<Paths, Route> ? ExtractResponse<Paths, Route, Lowercase<Method>> : never : never : never;
+export type ExtractEndpointConfig<Paths, T extends EndpointString> = T extends `${infer Method} ${infer Route}` ? Route extends OpenAPIRoutes<Paths> ? Lowercase<Method> extends ExtractMethod<Paths, Route> ? RequestConfig<Paths, Route, Lowercase<Method>> : never : never : never;
+/**
+ * Build a request config type where:
+ * - `params` is required if the endpoint has path parameters
+ * - `body` is required if the endpoint has a request body
+ * - `query` is required if it has a required key, optional otherwise
+ * - `headers` is always optional
+ */
+export type FilteredRequestConfig<Paths, T extends EndpointString> = T extends `${infer Method} ${infer Route}` ? Route extends OpenAPIRoutes<Paths> ? Lowercase<Method> extends ExtractMethod<Paths, Route> ? BuildRequestConfig<ExtractPathParams<Paths, Route>, ExtractQueryParams<Paths, Route, Lowercase<Method>>, ExtractRequestBody<Paths, Route, Lowercase<Method>>> : never : never : never;
+/**
+ * Helper to build request config with correct required/optional fields.
+ * Uses [T] extends [never] pattern to prevent distribution over union types,
+ * which would cause the entire type to become `never`.
+ */
+type BuildRequestConfig<TParams, TQuery, TBody> = SimplifyIntersection<([TParams] extends [never] ? {} : {
+  params: TParams;
+}) & ([TBody] extends [never] ? {} : {
+  body: TBody;
+}) & ([TQuery] extends [never] ? {} : {} extends TQuery ? {
+  query?: TQuery;
+} : {
+  query: TQuery;
+}) & {
+  headers?: Record<string, string>;
+}>;
+/**
+ * Simplify intersection types for better IDE display
+ */
+type SimplifyIntersection<T> = { [K in keyof T]: T[K]; };
+/** Whether a query has a key the caller must supply. */
+type HasRequiredQuery<TQuery> = [TQuery] extends [never] ? false : {} extends TQuery ? false : true;
+/**
+ * Check if the config object is required (has any required fields)
+ */
+export type IsConfigRequired<Paths, T extends EndpointString> = T extends `${infer Method} ${infer Route}` ? Route extends OpenAPIRoutes<Paths> ? Lowercase<Method> extends ExtractMethod<Paths, Route> ? ExtractPathParams<Paths, Route> extends never ? ExtractRequestBody<Paths, Route, Lowercase<Method>> extends never ? HasRequiredQuery<ExtractQueryParams<Paths, Route, Lowercase<Method>>> : true : true : false : false : false;
+/**
+ * Typed function signature for the API client.
+ * Config is required when endpoint has path params or body.
+ */
+export type TypedApiFunction<Paths> = <T extends TypedEndpoint<Paths>>(endpoint: T, ...args: IsConfigRequired<Paths, T> extends true ? [config: FilteredRequestConfig<Paths, T>] : [config?: FilteredRequestConfig<Paths, T>]) => Promise<ExtractEndpointResponse<Paths, T>>;
+export interface FetcherOptions {
+  baseURL?: string;
+  headers?: Record<string, string>;
+  onRequest?: (config: RequestInit) => RequestInit | Promise<RequestInit>;
+  onResponse?: (response: Response) => Response | Promise<Response>;
+  onError?: (error: Error) => void | Promise<void>;
+  fetch?: typeof fetch;
+  /**
+   * W3C trace context (`traceparent`, `tracestate`) on every request to
+   * `baseURL`'s origin — never another. Continues the active OpenTelemetry
+   * span when there is one; otherwise a trace per page view, sampled at
+   * `sampleRate`. Off unless set.
+   */
+  telemetry?: boolean | ClientTelemetryOptions;
+}
+export type WrappedResult<T, E = unknown> = {
+  ok: true;
+  data: T;
+} | {
+  ok: false;
+  error: E;
+};
+export type ErrorTransformer<E> = (error: unknown) => E | Promise<E>;
+export type WrappedApiFunction<Paths, E = unknown> = <T extends TypedEndpoint<Paths>>(endpoint: T, ...args: IsConfigRequired<Paths, T> extends true ? [config: FilteredRequestConfig<Paths, T>] : [config?: FilteredRequestConfig<Paths, T>]) => Promise<WrappedResult<ExtractEndpointResponse<Paths, T>, E>>;
+//#endregion
+//# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":"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"}

package/dist/types.d.mts

@@ -1,2 +1,122 @@
-import { EndpointString, ErrorTransformer, ExtractEndpointConfig, ExtractEndpointResponse, ExtractMethod, ExtractPathParams, ExtractQueryParams, ExtractRequestBody, ExtractResponse, FetcherOptions, FilterEndpointByMethod, FilteredRequestConfig, IsConfigRequired, MutationEndpoint, OpenAPIRoutes, ParseEndpoint, QueryEndpoint, RequestConfig, TypedApiFunction, TypedEndpoint, ValidEndpoint, WrappedApiFunction, WrappedResult } from "./types-BMGM6sZc.mjs";
-export { EndpointString, ErrorTransformer, ExtractEndpointConfig, ExtractEndpointResponse, ExtractMethod, ExtractPathParams, ExtractQueryParams, ExtractRequestBody, ExtractResponse, FetcherOptions, FilterEndpointByMethod, FilteredRequestConfig, IsConfigRequired, MutationEndpoint, OpenAPIRoutes, ParseEndpoint, QueryEndpoint, RequestConfig, TypedApiFunction, TypedEndpoint, ValidEndpoint, WrappedApiFunction, WrappedResult };
+import { t as ClientTelemetryOptions } from "./telemetry-g3BE86Wd.mjs";
+//#region src/types.d.ts
+export type OpenAPIRoutes<Paths> = keyof Paths;
+type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'head' | 'options';
+export type ExtractMethod<Paths, Route extends OpenAPIRoutes<Paths>> = Extract<keyof Paths[Route], HttpMethod>;
+export type ExtractPathParams<Paths, Route extends OpenAPIRoutes<Paths>> = Paths[Route] extends {
+  parameters?: {
+    path?: infer P;
+  };
+} ? P : never;
+export type ExtractQueryParams<Paths, Route extends OpenAPIRoutes<Paths>, Method extends ExtractMethod<Paths, Route>> = Paths[Route][Method] extends {
+  parameters?: {
+    query?: infer Q;
+  };
+} ? Q : never;
+export type ExtractRequestBody<Paths, Route extends OpenAPIRoutes<Paths>, Method extends ExtractMethod<Paths, Route>> = Paths[Route][Method] extends {
+  requestBody?: infer RB;
+} ? [NonNullable<RB>] extends [never] ? never : NonNullable<RB> extends {
+  content?: {
+    'application/json'?: infer B;
+  };
+} ? B : never : never;
+export type ExtractResponse<Paths, Route extends OpenAPIRoutes<Paths>, Method extends ExtractMethod<Paths, Route>> = Paths[Route][Method] extends {
+  responses?: {
+    200?: {
+      content?: {
+        'application/json'?: infer R;
+      };
+    };
+  };
+} ? R : Paths[Route][Method] extends {
+  responses?: {
+    201?: {
+      content?: {
+        'application/json'?: infer R;
+      };
+    };
+  };
+} ? R : never;
+export type RequestConfig<Paths, Route extends OpenAPIRoutes<Paths>, Method extends ExtractMethod<Paths, Route>> = {
+  params?: ExtractPathParams<Paths, Route>;
+  query?: ExtractQueryParams<Paths, Route, Method>;
+  body?: ExtractRequestBody<Paths, Route, Method>;
+  headers?: Record<string, string>;
+};
+export type EndpointString = `${Uppercase<string>} ${string}`;
+export type ValidEndpoint<Paths> = { [Route in keyof Paths]: { [Method in Extract<keyof Paths[Route], HttpMethod>]: `${Uppercase<string & Method>} ${string & Route}`; }[Extract<keyof Paths[Route], HttpMethod>]; }[keyof Paths];
+export type TypedEndpoint<Paths> = ValidEndpoint<Paths> extends (infer E) ? (E extends string ? E : never) : never;
+export type FilterEndpointByMethod<Paths, Method extends string> = ValidEndpoint<Paths> extends (infer E) ? E extends `${Method} ${string}` ? E : never : never;
+export type QueryEndpoint<Paths> = FilterEndpointByMethod<Paths, 'GET'>;
+export type MutationEndpoint<Paths> = FilterEndpointByMethod<Paths, 'POST'> | FilterEndpointByMethod<Paths, 'PATCH'> | FilterEndpointByMethod<Paths, 'PUT'> | FilterEndpointByMethod<Paths, 'DELETE'>;
+export type ParseEndpoint<T extends EndpointString> = T extends `${infer Method} ${infer Route}` ? {
+  method: Lowercase<Method>;
+  route: Route;
+} : never;
+export type ExtractEndpointResponse<Paths, T extends EndpointString> = T extends `${infer Method} ${infer Route}` ? Route extends OpenAPIRoutes<Paths> ? Lowercase<Method> extends ExtractMethod<Paths, Route> ? ExtractResponse<Paths, Route, Lowercase<Method>> : never : never : never;
+export type ExtractEndpointConfig<Paths, T extends EndpointString> = T extends `${infer Method} ${infer Route}` ? Route extends OpenAPIRoutes<Paths> ? Lowercase<Method> extends ExtractMethod<Paths, Route> ? RequestConfig<Paths, Route, Lowercase<Method>> : never : never : never;
+/**
+ * Build a request config type where:
+ * - `params` is required if the endpoint has path parameters
+ * - `body` is required if the endpoint has a request body
+ * - `query` is required if it has a required key, optional otherwise
+ * - `headers` is always optional
+ */
+export type FilteredRequestConfig<Paths, T extends EndpointString> = T extends `${infer Method} ${infer Route}` ? Route extends OpenAPIRoutes<Paths> ? Lowercase<Method> extends ExtractMethod<Paths, Route> ? BuildRequestConfig<ExtractPathParams<Paths, Route>, ExtractQueryParams<Paths, Route, Lowercase<Method>>, ExtractRequestBody<Paths, Route, Lowercase<Method>>> : never : never : never;
+/**
+ * Helper to build request config with correct required/optional fields.
+ * Uses [T] extends [never] pattern to prevent distribution over union types,
+ * which would cause the entire type to become `never`.
+ */
+type BuildRequestConfig<TParams, TQuery, TBody> = SimplifyIntersection<([TParams] extends [never] ? {} : {
+  params: TParams;
+}) & ([TBody] extends [never] ? {} : {
+  body: TBody;
+}) & ([TQuery] extends [never] ? {} : {} extends TQuery ? {
+  query?: TQuery;
+} : {
+  query: TQuery;
+}) & {
+  headers?: Record<string, string>;
+}>;
+/**
+ * Simplify intersection types for better IDE display
+ */
+type SimplifyIntersection<T> = { [K in keyof T]: T[K]; };
+/** Whether a query has a key the caller must supply. */
+type HasRequiredQuery<TQuery> = [TQuery] extends [never] ? false : {} extends TQuery ? false : true;
+/**
+ * Check if the config object is required (has any required fields)
+ */
+export type IsConfigRequired<Paths, T extends EndpointString> = T extends `${infer Method} ${infer Route}` ? Route extends OpenAPIRoutes<Paths> ? Lowercase<Method> extends ExtractMethod<Paths, Route> ? ExtractPathParams<Paths, Route> extends never ? ExtractRequestBody<Paths, Route, Lowercase<Method>> extends never ? HasRequiredQuery<ExtractQueryParams<Paths, Route, Lowercase<Method>>> : true : true : false : false : false;
+/**
+ * Typed function signature for the API client.
+ * Config is required when endpoint has path params or body.
+ */
+export type TypedApiFunction<Paths> = <T extends TypedEndpoint<Paths>>(endpoint: T, ...args: IsConfigRequired<Paths, T> extends true ? [config: FilteredRequestConfig<Paths, T>] : [config?: FilteredRequestConfig<Paths, T>]) => Promise<ExtractEndpointResponse<Paths, T>>;
+export interface FetcherOptions {
+  baseURL?: string;
+  headers?: Record<string, string>;
+  onRequest?: (config: RequestInit) => RequestInit | Promise<RequestInit>;
+  onResponse?: (response: Response) => Response | Promise<Response>;
+  onError?: (error: Error) => void | Promise<void>;
+  fetch?: typeof fetch;
+  /**
+   * W3C trace context (`traceparent`, `tracestate`) on every request to
+   * `baseURL`'s origin — never another. Continues the active OpenTelemetry
+   * span when there is one; otherwise a trace per page view, sampled at
+   * `sampleRate`. Off unless set.
+   */
+  telemetry?: boolean | ClientTelemetryOptions;
+}
+export type WrappedResult<T, E = unknown> = {
+  ok: true;
+  data: T;
+} | {
+  ok: false;
+  error: E;
+};
+export type ErrorTransformer<E> = (error: unknown) => E | Promise<E>;
+export type WrappedApiFunction<Paths, E = unknown> = <T extends TypedEndpoint<Paths>>(endpoint: T, ...args: IsConfigRequired<Paths, T> extends true ? [config: FilteredRequestConfig<Paths, T>] : [config?: FilteredRequestConfig<Paths, T>]) => Promise<WrappedResult<ExtractEndpointResponse<Paths, T>, E>>;
+//#endregion
+//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":"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"}

package/dist/types.mjs

@@ -1 +1 @@
-import "./types-BH8WgGrm.mjs";
+export {};