@vielzeug/courier 2.3.0 → 3.0.0

package/dist/index.js

@@ -1 +1,670 @@
-import{CourierAbortError as e,CourierDisposedError as t,CourierError as n,CourierHttpError as r,CourierNetworkError as i,CourierParseError as a,CourierSchemaValidationError as o,CourierTimeoutError as s}from"./errors.js";import{createCourier as c}from"./courier.js";import{withBearerAuth as l,withLogging as u,withRequestId as d}from"./interceptors.js";export{e as CourierAbortError,t as CourierDisposedError,n as CourierError,r as CourierHttpError,i as CourierNetworkError,a as CourierParseError,o as CourierSchemaValidationError,s as CourierTimeoutError,c as createCourier,l as withBearerAuth,u as withLogging,d as withRequestId};
+import { cache as e } from "@vielzeug/arsenal/cache";
+import { hash as t } from "@vielzeug/arsenal/object";
+import { abortError as n } from "@vielzeug/arsenal";
+//#region src/errors.ts
+var r = class extends Error {
+	static errorName = "CourierError";
+	constructor(e, t) {
+		super(e, t), this.name = new.target.errorName, Object.setPrototypeOf(this, new.target.prototype);
+	}
+}, i = class e extends r {
+	static errorName = "CourierHttpError";
+	url;
+	method;
+	status;
+	data;
+	headers;
+	constructor(e) {
+		super(e.message), this.url = e.url, this.method = e.method, this.status = e.status, this.data = e.data, this.headers = e.headers;
+	}
+	static fromResponse(t, n, r, i) {
+		return new e({
+			data: n,
+			headers: t.headers,
+			message: t.statusText || `HTTP ${t.status}`,
+			method: r,
+			status: t.status,
+			url: i
+		});
+	}
+	static is(t, n) {
+		return t instanceof e && (n === void 0 || t.status === n);
+	}
+}, a = class extends r {
+	static errorName = "CourierNetworkError";
+	url;
+	method;
+	constructor(e) {
+		super(e.message, { cause: e.cause }), this.url = e.url, this.method = e.method;
+	}
+}, o = class extends r {
+	static errorName = "CourierTimeoutError";
+	url;
+	method;
+	constructor(e) {
+		super(e.message, { cause: e.cause }), this.url = e.url, this.method = e.method;
+	}
+}, s = class extends r {
+	static errorName = "CourierAbortError";
+	url;
+	method;
+	constructor(e) {
+		super(e.message, { cause: e.cause }), this.url = e.url, this.method = e.method;
+	}
+}, c = class extends r {
+	static errorName = "CourierSchemaValidationError";
+	data;
+	constructor(e, t) {
+		super(e instanceof Error ? e.message : String(e), { cause: e }), this.data = t;
+	}
+}, l = class extends r {
+	static errorName = "CourierDisposedError";
+	constructor(e) {
+		super(`${e} disposed`);
+	}
+}, u = class extends r {
+	static errorName = "CourierParseError";
+};
+function d(e) {
+	try {
+		return typeof e == "object" && e && typeof e.name == "string" ? e.name : void 0;
+	} catch {
+		return;
+	}
+}
+function f(e) {
+	try {
+		return typeof e == "object" && e && typeof e.message == "string" ? e.message : String(e);
+	} catch {
+		return "Request failed";
+	}
+}
+function p(e, t, n, r) {
+	let i = f(e), c = d(r?.reason), l = d(e);
+	return c === "TimeoutError" || l === "TimeoutError" ? new o({
+		cause: e,
+		message: i,
+		method: t,
+		url: n
+	}) : c === "AbortError" || l === "AbortError" || r?.aborted ? new s({
+		cause: e,
+		message: i,
+		method: t,
+		url: n
+	}) : new a({
+		cause: e,
+		message: i,
+		method: t,
+		url: n
+	});
+}
+//#endregion
+//#region src/transport.ts
+function m(e, t, n) {
+	let r = Object.freeze({ ...t }), i = Object.freeze({ ...n });
+	return Object.freeze({
+		headers: r,
+		init: i,
+		url: e,
+		withHeaders(t) {
+			let n = { ...r };
+			for (let [e, r] of Object.entries(t)) {
+				let t = e.toLowerCase();
+				r === void 0 ? delete n[t] : n[t] = r;
+			}
+			return m(e, n, i);
+		},
+		withInit(t) {
+			return m(e, r, {
+				...i,
+				...t
+			});
+		}
+	});
+}
+function h(...e) {
+	let t = e.filter((e) => e != null);
+	if (t.length !== 0) return t.length === 1 ? t[0] : AbortSignal.any(t);
+}
+var g = 3e4, _ = 2147483647;
+function v(e) {
+	if (e !== Infinity && (!Number.isInteger(e) || e <= 0 || e > _)) throw new r(`[courier] timeout must be an integer from 1 to ${_}, or Infinity`);
+}
+function y(e, t) {
+	return e === Infinity ? t ?? void 0 : h(AbortSignal.timeout(e), t);
+}
+function b(e = {}) {
+	let { baseUrl: t = "", fetch: n = globalThis.fetch, headers: r = {}, middleware: i = [], timeout: a = g } = e;
+	v(a);
+	let o = Object.fromEntries(new Headers(r).entries()), s = /* @__PURE__ */ new Set(), c = new AbortController(), l = !1, u = async (e) => {
+		try {
+			return await n(e.url, {
+				...e.init,
+				headers: e.headers
+			});
+		} catch (t) {
+			throw p(t, (e.init.method ?? "GET").toUpperCase(), e.url, e.init.signal);
+		}
+	}, d = i.length === 0 ? u : i.reduceRight((e, t) => (n) => t(n, e), u);
+	function f(e) {
+		let t = e ? Object.fromEntries(new Headers(e).entries()) : void 0;
+		return {
+			...o,
+			...t
+		};
+	}
+	function h(e) {
+		return s.add(e), () => s.delete(e);
+	}
+	function _(e) {
+		return d(m(e.url, e.headers, e.init));
+	}
+	function y() {
+		for (let e of [...s]) e.abort();
+		s.clear();
+	}
+	function b() {
+		if (!l) {
+			l = !0, c.abort();
+			for (let e of s) e.abort();
+			s.clear();
+		}
+	}
+	return {
+		baseUrl: t,
+		cancelAll: y,
+		dispatch: _,
+		get disposalSignal() {
+			return c.signal;
+		},
+		dispose: b,
+		get disposed() {
+			return l;
+		},
+		mergeHeaders: f,
+		timeout: a,
+		track: h
+	};
+}
+//#endregion
+//#region src/_cache.ts
+var x = 100, S = 3e4;
+function C(e, t) {
+	if (e !== Infinity && (!Number.isFinite(e) || e < 0)) throw new r(`${t} must be a non-negative finite number or Infinity`);
+	return e;
+}
+function w(e) {
+	if (e !== Infinity && (!Number.isInteger(e) || e < 1)) throw new r("cache.capacity must be a positive integer or Infinity");
+	return e;
+}
+function T(e) {
+	if (!Array.isArray(e) || e.length === 0) throw new r("cache.key must be a non-empty array");
+	for (let t of e) {
+		if (t !== null && ![
+			"boolean",
+			"number",
+			"string"
+		].includes(typeof t)) throw new r("cache.key atoms must be strings, finite numbers, booleans, or null");
+		if (typeof t == "number" && !Number.isFinite(t)) throw new r("cache.key numbers must be finite");
+	}
+	return t(e);
+}
+function E(e, t) {
+	return t.length <= e.length && t.every((t, n) => t === e[n]);
+}
+function D(e, t, n) {
+	return t ? t.aborted ? Promise.reject(p(t.reason, "GET", n, t)) : new Promise((r, i) => {
+		let a = () => i(p(t.reason, "GET", n, t));
+		t.addEventListener("abort", a, { once: !0 }), e.then((e) => {
+			t.removeEventListener("abort", a), r(e);
+		}, (e) => {
+			t.removeEventListener("abort", a), i(e);
+		});
+	}) : e;
+}
+function O(t) {
+	let n = C(t?.ttlMs ?? S, "cache.ttlMs"), r = e({ capacity: w(t?.capacity ?? x) }), i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Set(), o = (e) => ({
+		id: T(e.key),
+		key: Object.freeze([...e.key]),
+		ttlMs: C(e.ttlMs ?? n, "cache.ttlMs")
+	}), s = (e, t) => {
+		let n = r.get(e);
+		if (n) {
+			if (t !== Infinity && Date.now() - n.cachedAt >= t) {
+				r.delete(e);
+				return;
+			}
+			return n;
+		}
+	}, c = (e, t) => {
+		t === "prefetch" ? e.owners-- : e.waiters--, !(e.settled || e.owners > 0 || e.waiters > 0) && (e.cacheable = !1, i.get(e.id) === e && i.delete(e.id), e.controller.abort());
+	}, l = (e, t, n, o) => {
+		let s = new AbortController(), c = {
+			cacheable: !0,
+			controller: s,
+			id: e,
+			key: t,
+			owners: 0,
+			promise: void 0,
+			settled: !1,
+			ttlMs: n,
+			waiters: 0
+		}, l;
+		try {
+			l = Promise.resolve(o(s.signal));
+		} catch (e) {
+			l = Promise.reject(e);
+		}
+		return c.promise = l.then((n) => (c.cacheable && !s.signal.aborted && r.set(e, {
+			cachedAt: Date.now(),
+			data: n,
+			key: t
+		}, { ttlMs: c.ttlMs }), n)).finally(() => {
+			c.settled = !0, a.delete(c), i.get(e) === c && i.delete(e);
+		}), i.set(e, c), a.add(c), c;
+	}, u = (e, t) => {
+		let n = o(e), r = s(n.id, n.ttlMs);
+		if (r) return {
+			...n,
+			stored: r
+		};
+		let a = i.get(n.id) ?? l(n.id, n.key, n.ttlMs, t);
+		return a.ttlMs = Math.min(a.ttlMs, n.ttlMs), {
+			...n,
+			entry: a
+		};
+	};
+	return {
+		cancelAll() {
+			for (let e of a) e.cacheable = !1, e.controller.abort();
+			i.clear();
+		},
+		clear() {
+			r.clear();
+			for (let e of a) e.cacheable = !1;
+			i.clear();
+		},
+		dispose() {
+			r.clear();
+			for (let e of a) e.cacheable = !1, e.controller.abort();
+			i.clear(), a.clear();
+		},
+		invalidate(e) {
+			T(e);
+			for (let [t, n] of r.entries()) E(n.key, e) && r.delete(t);
+			for (let t of a) E(t.key, e) && (t.cacheable = !1, i.get(t.id) === t && i.delete(t.id));
+		},
+		prefetch({ cache: e, load: t }) {
+			let n = u(e, t);
+			return "stored" in n ? Promise.resolve() : (n.entry.owners++, n.entry.promise.then(() => void 0, () => void 0).finally(() => c(n.entry, "prefetch")));
+		},
+		read({ cache: e, load: t, signal: n, timeout: r, url: i }) {
+			v(r);
+			let a = y(r, n);
+			if (a?.aborted) return Promise.reject(p(a.reason, "GET", i, a));
+			let o = u(e, t);
+			return "stored" in o ? Promise.resolve(o.stored.data) : (o.entry.waiters++, D(o.entry.promise, a, i).finally(() => c(o.entry, "waiter")));
+		}
+	};
+}
+//#endregion
+//#region src/response.ts
+async function k(e) {
+	let t = (await e.text()).trim();
+	return t ? JSON.parse(t) : void 0;
+}
+function A(e, t, r) {
+	if (!e.body) return r(), e;
+	if (e.body.locked) throw new u("Raw response body is already locked");
+	let i = e.body.getReader(), a = !1, o, s = () => {
+		a || (a = !0, t?.removeEventListener("abort", c), r());
+	}, c = () => {
+		let e = n(t, "The operation was aborted.");
+		try {
+			o?.error(e);
+		} catch {}
+		s(), i.cancel(e).catch(() => void 0);
+	}, l = new ReadableStream({
+		cancel: async (e) => {
+			try {
+				await i.cancel(e);
+			} finally {
+				s();
+			}
+		},
+		pull: async (e) => {
+			try {
+				let t = await i.read();
+				if (a) return;
+				t.done ? (e.close(), s()) : e.enqueue(t.value);
+			} catch (t) {
+				a || e.error(t), s();
+			}
+		},
+		start: (e) => {
+			o = e, t?.aborted ? c() : t?.addEventListener("abort", c, { once: !0 });
+		}
+	});
+	return j(new Response(l, {
+		headers: e.headers,
+		status: e.status,
+		statusText: e.statusText
+	}), e);
+}
+function j(e, t) {
+	let n = e.clone.bind(e);
+	return Object.defineProperties(e, {
+		clone: { value: () => j(n(), t) },
+		redirected: { value: t.redirected },
+		type: { value: t.type },
+		url: { value: t.url }
+	}), e;
+}
+async function M(e, t = "auto") {
+	if (t === "raw") return e;
+	if (e.status === 204 || e.status === 205) return;
+	if (t === "json") return k(e);
+	if (t === "text") return e.text();
+	if (t === "blob") return e.blob();
+	if (t === "arrayBuffer") return e.arrayBuffer();
+	let n = e.headers.get("content-type") ?? "";
+	return n.includes("application/json") || n.includes("+json") ? k(e) : n.startsWith("text/") ? e.text() : n.startsWith("image/") || n.startsWith("audio/") || n.startsWith("video/") ? e.blob() : e.text();
+}
+//#endregion
+//#region src/serialize.ts
+function N(e, t, n, r, i) {
+	if (n !== void 0 && !I(n)) {
+		let a = JSON.stringify(n);
+		if (a === void 0) throw TypeError("request body is not JSON-serializable");
+		return {
+			...i,
+			body: a,
+			headers: {
+				"content-type": "application/json",
+				...t
+			},
+			method: e.toUpperCase(),
+			signal: r
+		};
+	}
+	return {
+		...i,
+		...n !== void 0 && { body: n },
+		...F(n) && { duplex: "half" },
+		headers: t,
+		method: e.toUpperCase(),
+		signal: r
+	};
+}
+function P(e) {
+	try {
+		return Object.prototype.toString.call(e);
+	} catch {
+		return "";
+	}
+}
+function F(e) {
+	return P(e) === "[object ReadableStream]" && typeof e.getReader == "function";
+}
+function I(e) {
+	return typeof e == "string" || ArrayBuffer.isView(e) ? !0 : [
+		"[object ArrayBuffer]",
+		"[object Blob]",
+		"[object FormData]",
+		"[object URLSearchParams]",
+		"[object ReadableStream]"
+	].includes(P(e));
+}
+//#endregion
+//#region src/url.ts
+function L(e, t, n, r) {
+	let i = e.replace(/\/+$/, ""), a = i ? t.replace(/^\/+/, "") : t;
+	a = a.replace(/\{([^}]+)\}/g, (e, r) => {
+		let i = n?.[r];
+		if (i == null) throw new u(`unresolved path param {${r}} in '${t}'`);
+		return encodeURIComponent(String(i));
+	});
+	let o = i && a ? `${i}/${a}` : i || a;
+	if (!r) return o;
+	let s = new URLSearchParams();
+	for (let [e, t] of Object.entries(r)) if (t !== void 0) {
+		if (Array.isArray(t)) {
+			for (let n of t) n !== void 0 && s.append(e, n === null ? "" : String(n));
+			continue;
+		}
+		s.append(e, t === null ? "" : String(t));
+	}
+	let c = s.toString();
+	if (!c) return o;
+	let l = o.indexOf("#"), d = l === -1 ? o : o.slice(0, l), f = l === -1 ? "" : o.slice(l);
+	return `${d}${d.includes("?") ? "&" : "?"}${c}${f}`;
+}
+//#endregion
+//#region src/courier.ts
+function R(e = {}) {
+	let { cache: t, ...n } = e, a = b(n), o = O(t), s = /* @__PURE__ */ new Set(), d = /* @__PURE__ */ new Set();
+	function f(e) {
+		if (d.size === 0) return;
+		let t = Object.freeze(e);
+		for (let e of [...d]) try {
+			e(t);
+		} catch {}
+	}
+	function m(e, t) {
+		if (a.disposed || t?.signal?.aborted) return () => {};
+		d.add(e);
+		let n = () => {
+			d.delete(e), s.delete(n), t?.signal?.removeEventListener("abort", n);
+		};
+		return t?.signal && (s.add(n), t.signal.addEventListener("abort", n, { once: !0 })), n;
+	}
+	async function g(e, t, n, o, s, l) {
+		let d = t.signal, f = await a.dispatch({
+			headers: e,
+			init: t,
+			url: n
+		});
+		if (!f.ok) {
+			let e = f.headers.get("content-type")?.includes("json") ?? !1, t;
+			try {
+				t = await f.text();
+			} catch (e) {
+				throw d?.aborted ? p(e, o, n, d) : new u(e instanceof Error ? e.message : String(e), { cause: e });
+			}
+			let r = t;
+			if (t && e) try {
+				r = JSON.parse(t);
+			} catch {}
+			throw i.fromResponse(f, r, o, n);
+		}
+		let m;
+		try {
+			m = await M(f, s ?? "auto");
+		} catch (e) {
+			throw d?.aborted ? p(e, o, n, d) : e instanceof r ? e : new u(e instanceof Error ? e.message : String(e), { cause: e });
+		}
+		if (l) try {
+			return {
+				result: l.parse(m),
+				status: f.status
+			};
+		} catch (e) {
+			throw new c(e, m);
+		}
+		return {
+			result: m,
+			status: f.status
+		};
+	}
+	function _(e, t) {
+		try {
+			return L(a.baseUrl, e, t.params, t.query);
+		} catch (e) {
+			throw e instanceof r ? e : new u(e instanceof Error ? e.message : String(e), { cause: e });
+		}
+	}
+	async function x(e, t = {}) {
+		if (a.disposed) throw new l("Courier");
+		let n = (t.method ?? "GET").toUpperCase(), r = _(e, t), { body: i, fetchInit: o, headers: s, responseType: c, schema: d, signal: p, timeout: m } = t;
+		if ((n === "GET" || n === "HEAD") && i !== void 0) throw new u(`${n} requests cannot include a body`);
+		if (c === "raw" && d !== void 0) throw new u("Raw responses cannot use a schema");
+		m !== void 0 && v(m);
+		let b = new AbortController(), x = a.track(b), S = y(m ?? a.timeout, h(p, b.signal)), C = performance.now(), w = !1;
+		f({
+			method: n,
+			type: "request-start",
+			url: r
+		});
+		try {
+			let e;
+			try {
+				e = N(n, a.mergeHeaders(s), i, S, o ?? {});
+			} catch (e) {
+				throw new u(e instanceof Error ? e.message : String(e), { cause: e });
+			}
+			let { headers: t, ...l } = e, { result: p, status: m } = await g(t, l, r, n, c, d);
+			if (c === "raw" && p instanceof Response) {
+				let e = A(p, S, x);
+				return w = !0, f({
+					duration: performance.now() - C,
+					method: n,
+					status: m,
+					type: "request-success",
+					url: r
+				}), e;
+			}
+			return f({
+				duration: performance.now() - C,
+				method: n,
+				status: m,
+				type: "request-success",
+				url: r
+			}), p;
+		} catch (e) {
+			throw f({
+				error: e,
+				method: n,
+				type: "request-error",
+				url: r
+			}), e;
+		} finally {
+			w || x();
+		}
+	}
+	let S = (e, t, n) => x(t, {
+		...n,
+		method: e
+	});
+	function C(e, t) {
+		try {
+			let n = t ?? {}, { cache: r, signal: i, timeout: s, ...c } = n;
+			if (!r) return S("GET", e, {
+				...c,
+				signal: i,
+				timeout: s
+			});
+			let l = _(e, n);
+			return o.read({
+				cache: r,
+				load: (t) => S("GET", e, {
+					...c,
+					signal: t
+				}),
+				signal: i,
+				timeout: s ?? a.timeout,
+				url: l
+			});
+		} catch (e) {
+			return Promise.reject(e);
+		}
+	}
+	function w(e, t) {
+		if (a.disposed) throw new l("Courier");
+		let { cache: n, ...r } = t;
+		return _(e, t), o.prefetch({
+			cache: n,
+			load: (t) => S("GET", e, {
+				...r,
+				signal: t
+			})
+		});
+	}
+	return {
+		cancelAll() {
+			o.cancelAll(), a.cancelAll();
+		},
+		clearCache() {
+			o.clear();
+		},
+		delete: (e, t) => S("DELETE", e, t),
+		get disposalSignal() {
+			return a.disposalSignal;
+		},
+		dispose() {
+			if (!a.disposed) {
+				f({ type: "dispose" });
+				for (let e of [...s]) e();
+				d.clear(), o.dispose(), a.dispose();
+			}
+		},
+		get disposed() {
+			return a.disposed;
+		},
+		get: C,
+		invalidateCache(e) {
+			o.invalidate(e);
+		},
+		patch: (e, t) => S("PATCH", e, t),
+		post: (e, t) => S("POST", e, t),
+		prefetch: w,
+		put: (e, t) => S("PUT", e, t),
+		request: x,
+		tap: m,
+		[Symbol.dispose]() {
+			this.dispose();
+		}
+	};
+}
+//#endregion
+//#region src/interceptors.ts
+function z(e) {
+	return async (t, n) => {
+		let r = typeof e == "function" ? await e() : e;
+		return n(t.withHeaders({ authorization: r ? `Bearer ${r}` : void 0 }));
+	};
+}
+function B(e) {
+	let t = e?.header ?? "x-request-id", n = e?.generate ?? (() => crypto.randomUUID());
+	return (e, r) => r(e.withHeaders({ [t]: n() }));
+}
+function V(e) {
+	let t = e.logger, n = (e, n) => {
+		try {
+			t(e, n);
+		} catch {}
+	};
+	return async (e, t) => {
+		let r = performance.now(), i = (e.init.method ?? "GET").toUpperCase();
+		try {
+			let a = await t(e), o = Math.round(performance.now() - r);
+			return n(`${i} ${e.url} ${a.status} (${o}ms)`, {
+				duration: o,
+				method: i,
+				status: a.status,
+				url: e.url
+			}), a;
+		} catch (t) {
+			let a = Math.round(performance.now() - r);
+			throw n(`${i} ${e.url} ERR (${a}ms)`, {
+				duration: a,
+				method: i,
+				status: 0,
+				url: e.url
+			}), t;
+		}
+	};
+}
+//#endregion
+export { s as CourierAbortError, l as CourierDisposedError, r as CourierError, i as CourierHttpError, a as CourierNetworkError, u as CourierParseError, c as CourierSchemaValidationError, o as CourierTimeoutError, R as createCourier, z as withBearerAuth, V as withLogging, B as withRequestId };
+
+//# sourceMappingURL=index.js.map