@danceroutine/tango-core 0.1.0 → 1.0.0

package/dist/{http-DOLwwAYt.js → http-D20MQa6p.js}

@@ -1,6 +1,6 @@
 import { __export } from "./chunk-BkvOhyD0.js";
-import { TangoError } from "./TangoError-NPkVPfuH.js";
-import { isArrayBuffer, isBlob, isFile, isFormData, isReadableStream, isURLSearchParams, isUint8Array } from "./runtime-DPpCYEe_.js";
+import { TangoError } from "./TangoError-DdQVQNZU.js";
+import { isArrayBuffer, isBlob, isFile, isFormData, isNil, isReadableStream, isURLSearchParams, isUint8Array } from "./runtime-B8KkgD3R.js";
 
 //#region src/http/TangoBody.ts
 var TangoBody = class TangoBody {
@@ -14,18 +14,30 @@ var TangoBody = class TangoBody {
 		this.bodyUsedInternal = false;
 		this.headers = headers;
 	}
+	/**
+	* Narrow an unknown value to `TangoBody`.
+	*/
 	static isTangoBody(value) {
 		return typeof value === "object" && value !== null && value.__tangoBrand === TangoBody.BRAND;
 	}
+	/**
+	* Expose the original body source for cloning and adapter integration.
+	*/
 	get bodySource() {
 		return this.bodySourceInternal;
 	}
+	/**
+	* Report whether a reader method has already consumed this body.
+	*/
 	get bodyUsed() {
 		return this.bodyUsedInternal;
 	}
+	/**
+	* Describe the current body shape in a way that is useful for diagnostics.
+	*/
 	get bodyType() {
 		const body = this.bodySourceInternal;
-		if (body == null) return "null";
+		if (isNil(body)) return "null";
 		if (typeof body === "string") return "string";
 		if (isArrayBuffer(body)) return "ArrayBuffer";
 		if (isUint8Array(body)) return "Uint8Array";
@@ -46,6 +58,97 @@ var TangoBody = class TangoBody {
 		return false;
 	}
 	/**
+	* Deep clone utility for body values. Preserves types and values as in the legacy implementation.
+	* If the source is a stream, the stream will be cloned if readable, otherwise throws.
+	*/
+	static deepCloneBody(body) {
+		if (isNil(body)) return null;
+		if (typeof body === "string") return body;
+		if (isArrayBuffer(body)) return body.slice(0);
+		if (isUint8Array(body)) return new Uint8Array(body);
+		if (isBlob(body)) return body.slice(0, body.size, body.type);
+		if (isFormData(body)) {
+			const cloned = new FormData();
+			for (const [k, v] of body) if (isFile(v)) {
+				const file = new File([v], v.name, {
+					type: v.type,
+					lastModified: v.lastModified
+				});
+				cloned.append(k, file);
+			} else cloned.append(k, v);
+			return cloned;
+		}
+		if (isReadableStream(body)) throw new TypeError("Cannot deep clone a ReadableStream directly; use TangoBody.clone()");
+		if (TangoBody.isJsonValue(body)) return JSON.parse(JSON.stringify(body));
+		return null;
+	}
+	/**
+	* Read a `ReadableStream` into an `ArrayBuffer`.
+	*/
+	static async readStreamToArrayBuffer(stream) {
+		const chunks = [];
+		const reader = stream.getReader();
+		let total = 0;
+		while (true) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			chunks.push(value);
+			total += value.length;
+		}
+		const joined = new Uint8Array(total);
+		let off = 0;
+		for (const chunk of chunks) {
+			joined.set(chunk, off);
+			off += chunk.length;
+		}
+		return joined.buffer.slice(0, joined.byteLength);
+	}
+	/**
+	* Read a `ReadableStream` into a `Uint8Array`.
+	*/
+	static async readStreamToUint8Array(stream) {
+		const buf = await TangoBody.readStreamToArrayBuffer(stream);
+		return new Uint8Array(buf);
+	}
+	/**
+	* Read a `ReadableStream` into UTF-8 text.
+	*/
+	static async readStreamToText(stream) {
+		const arr = await TangoBody.readStreamToUint8Array(stream);
+		return new TextDecoder().decode(arr);
+	}
+	/**
+	* Determine the content type for this body, if possible.
+	* Respects an explicitly passed header, otherwise infers from value type.
+	*/
+	static detectContentType(body, providedType) {
+		if (providedType) return providedType;
+		if (isNil(body)) return undefined;
+		if (typeof body === "string") return "text/plain; charset=utf-8";
+		if (isArrayBuffer(body) || isUint8Array(body)) return "application/octet-stream";
+		if (isBlob(body)) {
+			if (body.type) return body.type;
+			return "application/octet-stream";
+		}
+		if (isFormData(body)) return undefined;
+		if (typeof body === "object" && TangoBody.isJsonValue(body)) return "application/json; charset=utf-8";
+		if (isReadableStream(body)) return undefined;
+		return undefined;
+	}
+	/**
+	* Attempt to determine the content length, in bytes, for this body.
+	* Only available for certain body types, otherwise returns undefined.
+	*/
+	static async getContentLength(body) {
+		if (isNil(body)) return 0;
+		if (typeof body === "string") return new TextEncoder().encode(body).length;
+		if (isUint8Array(body)) return body.byteLength;
+		if (isArrayBuffer(body)) return body.byteLength;
+		if (isBlob(body)) return body.size;
+		if (TangoBody.isJsonValue(body)) return new TextEncoder().encode(JSON.stringify(body)).length;
+		return undefined;
+	}
+	/**
 	* Reads the body as an ArrayBuffer.
 	*/
 	async arrayBuffer() {
@@ -126,13 +229,12 @@ else throw new TypeError("Body is not valid for FormData");
 				for (const part of parts) {
 					const trimmed = part.trim();
 					if (!trimmed || trimmed === "--" || trimmed === "") continue;
-					const [rawHeaders, ...rawBodyParts] = trimmed.split(/\r?\n\r?\n/);
+					const [rawHeaders = "", ...rawBodyParts] = trimmed.split(/\r?\n\r?\n/);
 					const body = rawBodyParts.join("\n\n").replace(/\r?\n$/, "");
-					if (!rawHeaders) continue;
 					const dispositionMatch = /Content-Disposition:\s*form-data;\s*name="([^"]+)"/i.exec(rawHeaders);
 					if (!dispositionMatch) continue;
 					const name = dispositionMatch[1];
-					if (typeof name === "string") form.append(name, body);
+					form.append(name, body);
 				}
 				return form;
 			}
@@ -178,31 +280,6 @@ else throw new TypeError("Body is not valid for FormData");
 		return this.bodySourceInternal;
 	}
 	/**
-	* Deep clone utility for body values. Preserves types and values as in the legacy implementation.
-	* If the source is a stream, the stream will be cloned if readable, otherwise throws.
-	*/
-	static deepCloneBody(body) {
-		if (body == null || typeof body === "undefined") return null;
-		if (typeof body === "string") return body;
-		if (isArrayBuffer(body)) return body.slice(0);
-		if (isUint8Array(body)) return new Uint8Array(body);
-		if (isBlob(body)) return body.slice(0, body.size, body.type);
-		if (isFormData(body)) {
-			const cloned = new FormData();
-			for (const [k, v] of body) if (isFile(v)) {
-				const file = new File([v], v.name, {
-					type: v.type,
-					lastModified: v.lastModified
-				});
-				cloned.append(k, file);
-			} else cloned.append(k, v);
-			return cloned;
-		}
-		if (isReadableStream(body)) throw new TypeError("Cannot deep clone a ReadableStream directly; use TangoBody.clone()");
-		if (TangoBody.isJsonValue(body)) return JSON.parse(JSON.stringify(body));
-		return null;
-	}
-	/**
 	* Clone the body instance and stream if possible.
 	* If the source is a stream, the stream will be cloned if readable, otherwise throws.
 	*/
@@ -221,69 +298,10 @@ else throw new TypeError("Body is not valid for FormData");
 	* Helper for all readers. Only allows reading once.
 	*/
 	async consumeBody(parser) {
-		if (this.bodyUsedInternal) return Promise.reject(new TypeError("Body has already been consumed."));
+		if (this.bodyUsedInternal) throw new TypeError("Body has already been consumed.");
 		this.bodyUsedInternal = true;
 		return parser(this.bodySourceInternal);
 	}
-	static async readStreamToArrayBuffer(stream) {
-		const chunks = [];
-		const reader = stream.getReader();
-		let total = 0;
-		while (true) {
-			const { done, value } = await reader.read();
-			if (done) break;
-			if (value) {
-				chunks.push(value);
-				total += value.length;
-			}
-		}
-		const joined = new Uint8Array(total);
-		let off = 0;
-		for (const chunk of chunks) {
-			joined.set(chunk, off);
-			off += chunk.length;
-		}
-		return joined.buffer.slice(0, joined.byteLength);
-	}
-	static async readStreamToUint8Array(stream) {
-		const buf = await TangoBody.readStreamToArrayBuffer(stream);
-		return new Uint8Array(buf);
-	}
-	static async readStreamToText(stream) {
-		const arr = await TangoBody.readStreamToUint8Array(stream);
-		return new TextDecoder().decode(arr);
-	}
-	/**
-	* Determine the content type for this body, if possible.
-	* Respects an explicitly passed header, otherwise infers from value type.
-	*/
-	static detectContentType(body, providedType) {
-		if (providedType) return providedType;
-		if (body == null) return undefined;
-		if (typeof body === "string") return "text/plain; charset=utf-8";
-		if (isArrayBuffer(body) || isUint8Array(body)) return "application/octet-stream";
-		if (isBlob(body)) {
-			if (body.type) return body.type;
-			return "application/octet-stream";
-		}
-		if (isFormData(body)) return undefined;
-		if (typeof body === "object" && TangoBody.isJsonValue(body)) return "application/json; charset=utf-8";
-		if (isReadableStream(body)) return undefined;
-		return undefined;
-	}
-	/**
-	* Attempt to determine the content length, in bytes, for this body.
-	* Only available for certain body types, otherwise returns undefined.
-	*/
-	static async getContentLength(body) {
-		if (body == null) return 0;
-		if (typeof body === "string") return new TextEncoder().encode(body).length;
-		if (isUint8Array(body)) return body.byteLength;
-		if (isArrayBuffer(body)) return body.byteLength;
-		if (isBlob(body)) return body.size;
-		if (TangoBody.isJsonValue(body)) return new TextEncoder().encode(JSON.stringify(body)).length;
-		return undefined;
-	}
 };
 
 //#endregion
@@ -291,13 +309,40 @@ else throw new TypeError("Body is not valid for FormData");
 var TangoHeaders = class TangoHeaders extends Headers {
 	static BRAND = "tango.http.headers";
 	__tangoBrand = TangoHeaders.BRAND;
-	constructor(headers) {
-		super(headers);
-	}
+	/**
+	* Narrow an unknown value to `TangoHeaders`.
+	*/
 	static isTangoHeaders(value) {
 		return typeof value === "object" && value !== null && value.__tangoBrand === TangoHeaders.BRAND;
 	}
 	/**
+	* Serialize a cookie for the Set-Cookie header line.
+	*/
+	static serializeCookie(name, value, options = {}) {
+		let cookie = encodeURIComponent(name) + "=" + encodeURIComponent(value ?? "");
+		if (options.domain) cookie += `; Domain=${options.domain}`;
+		if (options.path) cookie += `; Path=${options.path}`;
+else cookie += "; Path=/";
+		if (options.expires) cookie += `; Expires=${options.expires.toUTCString()}`;
+		if (typeof options.maxAge === "number") cookie += `; Max-Age=${options.maxAge}`;
+		if (options.secure) cookie += "; Secure";
+		if (options.httpOnly) cookie += "; HttpOnly";
+		if (options.sameSite) cookie += `; SameSite=${options.sameSite}`;
+		if (options.priority) cookie += `; Priority=${options.priority}`;
+		if (options.partitioned) cookie += "; Partitioned";
+		return cookie;
+	}
+	static hasNumberSize(value) {
+		return typeof value === "object" && value !== null && typeof value.size === "number";
+	}
+	static hasNumberLength(value) {
+		return typeof value === "object" && value !== null && typeof value.length === "number";
+	}
+	static isNodeBuffer(value) {
+		const maybeBuffer = Buffer;
+		return typeof Buffer !== "undefined" && typeof maybeBuffer.isBuffer === "function" && maybeBuffer.isBuffer(value);
+	}
+	/**
 	* Sets the Content-Disposition header with type "inline" and the specified filename.
 	* This is useful to indicate that the content should be displayed inline in the browser,
 	* but with a suggested filename for saving.
@@ -318,19 +363,22 @@ var TangoHeaders = class TangoHeaders extends Headers {
 		const encoded = encodeURIComponent(filename);
 		this.set("Content-Disposition", `attachment; filename="${encoded}"; filename*=UTF-8''${encoded}`);
 	}
+	/**
+	* Create a copy that preserves all header names and values.
+	*/
 	clone() {
 		const copy = new TangoHeaders();
 		for (const [name, value] of this.entries()) copy.append(name, value);
 		return copy;
 	}
 	/**
-	* Set a header, replacing any existing value.
+	* Set a header, replacing the existing value.
 	*/
 	setHeader(name, value) {
 		this.set(name, value);
 	}
 	/**
-	* Append a header, adding to any existing value(s) for the name.
+	* Append a header, adding to existing value(s) for the name.
 	*/
 	appendHeader(name, value) {
 		this.append(name, value);
@@ -400,23 +448,6 @@ var TangoHeaders = class TangoHeaders extends Headers {
 		});
 	}
 	/**
-	* Serialize a cookie for the Set-Cookie header line.
-	*/
-	static serializeCookie(name, value, options = {}) {
-		let cookie = encodeURIComponent(name) + "=" + encodeURIComponent(value ?? "");
-		if (options.domain) cookie += `; Domain=${options.domain}`;
-		if (options.path) cookie += `; Path=${options.path}`;
-else cookie += "; Path=/";
-		if (options.expires) cookie += `; Expires=${options.expires.toUTCString()}`;
-		if (typeof options.maxAge === "number") cookie += `; Max-Age=${options.maxAge}`;
-		if (options.secure) cookie += "; Secure";
-		if (options.httpOnly) cookie += "; HttpOnly";
-		if (options.sameSite) cookie += `; SameSite=${options.sameSite}`;
-		if (options.priority) cookie += `; Priority=${options.priority}`;
-		if (options.partitioned) cookie += "; Partitioned";
-		return cookie;
-	}
-	/**
 	* Add or override Cache-Control header with helpers for common policies.
 	*/
 	cacheControl(control) {
@@ -451,7 +482,8 @@ else cookie += "; Path=/";
 	setContentTypeByFile(file, filename) {
 		if (this.has("Content-Type")) return;
 		if (typeof file === "string" && filename) {
-			const ext = filename.split(".").pop()?.toLowerCase() ?? "";
+			const dotIndex = filename.lastIndexOf(".");
+			const ext = dotIndex >= 0 ? filename.slice(dotIndex + 1).toLowerCase() : "";
 			const map = {
 				txt: "text/plain",
 				text: "text/plain",
@@ -492,11 +524,11 @@ else this.set("Content-Type", "application/octet-stream");
 		let len;
 		if (typeof body === "string") len = new TextEncoder().encode(body).length;
 else if (isArrayBuffer(body)) len = body.byteLength;
+else if (TangoHeaders.isNodeBuffer(body)) len = body.length;
 else if (isUint8Array(body)) len = body.byteLength;
 else if (isBlob(body)) len = body.size;
-else if (typeof Buffer !== "undefined" && typeof Buffer.isBuffer === "function" && Buffer.isBuffer(body)) len = body.length;
-else if (typeof body?.size === "number") len = body.size;
-else if (typeof body?.length === "number" && typeof body !== "string" && !isArrayBuffer(body) && !isUint8Array(body)) len = body.length;
+else if (TangoHeaders.hasNumberSize(body)) len = body.size;
+else if (TangoHeaders.hasNumberLength(body) && typeof body !== "string" && !isArrayBuffer(body) && !isUint8Array(body)) len = body.length;
 		if (typeof len === "number") this.set("Content-Length", len.toString());
 	}
 	/**
@@ -579,112 +611,314 @@ else this.set("Server-Timing", value);
 };
 
 //#endregion
-//#region src/http/TangoRequest.ts
-var TangoRequest = class TangoRequest {
-	static BRAND = "tango.http.request";
-	__tangoBrand = TangoRequest.BRAND;
-	request;
-	bodySourceValue;
-	constructor(input, init = {}) {
-		const sourceRequest = typeof input === "string" ? undefined : input;
-		const method = (init.method ?? sourceRequest?.method ?? "GET").toUpperCase();
-		const headers = new Headers(init.headers ?? sourceRequest?.headers);
-		const normalizedBody = this.normalizeBody(init.body, headers, method);
-		const requestInit = {
-			method,
-			headers,
-			redirect: init.redirect ?? sourceRequest?.redirect,
-			cache: init.cache ?? sourceRequest?.cache,
-			credentials: init.credentials ?? sourceRequest?.credentials,
-			integrity: init.integrity ?? sourceRequest?.integrity,
-			keepalive: init.keepalive ?? sourceRequest?.keepalive,
-			mode: init.mode ?? sourceRequest?.mode,
-			referrer: init.referrer ?? sourceRequest?.referrer,
-			referrerPolicy: init.referrerPolicy ?? sourceRequest?.referrerPolicy,
-			signal: init.signal ?? sourceRequest?.signal
-		};
-		if (normalizedBody !== undefined) requestInit.body = normalizedBody;
-		this.request = new Request(input, requestInit);
-		this.bodySourceValue = normalizedBody ?? null;
-	}
-	static isTangoRequest(value) {
-		return typeof value === "object" && value !== null && value.__tangoBrand === TangoRequest.BRAND;
+//#region src/http/TangoQueryParams.ts
+var TangoQueryParams = class TangoQueryParams {
+	static BRAND = "tango.http.query_params";
+	__tangoBrand = TangoQueryParams.BRAND;
+	values;
+	constructor(values) {
+		this.values = values;
 	}
-	get cache() {
-		return this.request.cache;
+	/**
+	* Narrow an unknown value to `TangoQueryParams`.
+	*/
+	static isTangoQueryParams(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === TangoQueryParams.BRAND;
 	}
-	get credentials() {
-		return this.request.credentials;
+	/**
+	* Build query params from a `URLSearchParams` instance.
+	*/
+	static fromURLSearchParams(params) {
+		const values = new Map();
+		for (const [key, value] of params.entries()) {
+			const current = values.get(key);
+			if (current) {
+				current.push(value);
+				continue;
+			}
+			values.set(key, [value]);
+		}
+		return new TangoQueryParams(values);
 	}
-	get destination() {
-		return this.request.destination;
+	/**
+	* Build query params from framework record-style search params.
+	*/
+	static fromRecord(params) {
+		const values = new Map();
+		for (const [key, value] of Object.entries(params)) {
+			if (Array.isArray(value)) {
+				const normalized = value.filter((entry) => typeof entry === "string");
+				if (normalized.length > 0) values.set(key, normalized);
+				continue;
+			}
+			if (typeof value === "string") values.set(key, [value]);
+		}
+		return new TangoQueryParams(values);
 	}
+	/**
+	* Build query params from a full URL string or URL object.
+	*/
+	static fromURL(input) {
+		const url = typeof input === "string" ? new URL(input) : input;
+		return TangoQueryParams.fromURLSearchParams(url.searchParams);
+	}
+	/**
+	* Build query params from a request-like object with a URL.
+	*/
+	static fromRequest(request) {
+		return TangoQueryParams.fromURL(request.url);
+	}
+	/**
+	* Get the first value for a query param.
+	*/
+	get(name) {
+		return this.values.get(name)?.[0];
+	}
+	/**
+	* Get all values for a query param.
+	*/
+	getAll(name) {
+		return [...this.values.get(name) ?? []];
+	}
+	/**
+	* Check whether a query param exists.
+	*/
+	has(name) {
+		return (this.values.get(name)?.length ?? 0) > 0;
+	}
+	/**
+	* Iterate key -> values entries.
+	*/
+	*entries() {
+		for (const [key, values] of this.values.entries()) yield [key, [...values]];
+	}
+	/**
+	* Iterate keys present in the query params.
+	*/
+	*keys() {
+		yield* this.values.keys();
+	}
+	/**
+	* Convert back to a native `URLSearchParams` object.
+	*/
+	toURLSearchParams() {
+		const params = new URLSearchParams();
+		for (const [key, values] of this.values.entries()) for (const value of values) params.append(key, value);
+		return params;
+	}
+	/**
+	* Get a trimmed value, omitting blank strings.
+	*/
+	getTrimmed(name) {
+		const value = this.get(name)?.trim();
+		return value ? value : undefined;
+	}
+	/**
+	* Get the free-text search param using Tango's default key.
+	*/
+	getSearch(key = "search") {
+		return this.getTrimmed(key);
+	}
+	/**
+	* Get the ordering param as trimmed field tokens.
+	*/
+	getOrdering(key = "ordering") {
+		const value = this.get(key);
+		if (!value) return [];
+		return value.split(",").map((token) => token.trim()).filter((token) => token.length > 0);
+	}
+};
+
+//#endregion
+//#region src/http/TangoRequest.ts
+var TangoRequest = class TangoRequest {
+	static BRAND = "tango.http.request";
+	__tangoBrand = TangoRequest.BRAND;
+	request;
+	bodySourceValue;
+	queryParamsValue;
+	constructor(input, init = {}) {
+		const sourceRequest = typeof input === "string" ? undefined : input;
+		const method = (init.method ?? sourceRequest?.method ?? "GET").toUpperCase();
+		const headers = new Headers(init.headers ?? sourceRequest?.headers);
+		const normalizedBody = this.normalizeBody(init.body, headers, method);
+		const requestInit = {
+			method,
+			headers,
+			redirect: init.redirect ?? sourceRequest?.redirect,
+			cache: init.cache ?? sourceRequest?.cache,
+			credentials: init.credentials ?? sourceRequest?.credentials,
+			integrity: init.integrity ?? sourceRequest?.integrity,
+			keepalive: init.keepalive ?? sourceRequest?.keepalive,
+			mode: init.mode ?? sourceRequest?.mode,
+			referrer: init.referrer ?? sourceRequest?.referrer,
+			referrerPolicy: init.referrerPolicy ?? sourceRequest?.referrerPolicy,
+			signal: init.signal ?? sourceRequest?.signal
+		};
+		if (normalizedBody !== undefined) {
+			requestInit.body = normalizedBody;
+			if (isReadableStream(normalizedBody)) requestInit.duplex = "half";
+		}
+		this.request = new Request(input, requestInit);
+		this.bodySourceValue = normalizedBody ?? null;
+	}
+	/**
+	* Narrow an unknown value to `TangoRequest`.
+	*/
+	static isTangoRequest(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === TangoRequest.BRAND;
+	}
+	/**
+	* Expose the request cache mode from the underlying fetch request.
+	*/
+	get cache() {
+		return this.request.cache;
+	}
+	/**
+	* Expose the request credentials mode from the underlying fetch request.
+	*/
+	get credentials() {
+		return this.request.credentials;
+	}
+	/**
+	* Expose the request destination from the underlying fetch request.
+	*/
+	get destination() {
+		return this.request.destination;
+	}
+	/**
+	* Expose the request headers from the underlying fetch request.
+	*/
 	get headers() {
 		return this.request.headers;
 	}
+	/**
+	* Expose the request integrity value from the underlying fetch request.
+	*/
 	get integrity() {
 		return this.request.integrity;
 	}
+	/**
+	* Expose the request keepalive flag from the underlying fetch request.
+	*/
 	get keepalive() {
 		return this.request.keepalive;
 	}
+	/**
+	* Expose the normalized HTTP method.
+	*/
 	get method() {
 		return this.request.method;
 	}
+	/**
+	* Expose the request mode from the underlying fetch request.
+	*/
 	get mode() {
 		return this.request.mode;
 	}
+	/**
+	* Expose the redirect policy from the underlying fetch request.
+	*/
 	get redirect() {
 		return this.request.redirect;
 	}
+	/**
+	* Expose the referrer from the underlying fetch request.
+	*/
 	get referrer() {
 		return this.request.referrer;
 	}
+	/**
+	* Expose the referrer policy from the underlying fetch request.
+	*/
 	get referrerPolicy() {
 		return this.request.referrerPolicy;
 	}
+	/**
+	* Expose the abort signal from the underlying fetch request.
+	*/
 	get signal() {
 		return this.request.signal;
 	}
+	/**
+	* Expose the absolute request URL.
+	*/
 	get url() {
 		return this.request.url;
 	}
+	/**
+	* Expose the readable request body stream when one exists.
+	*/
 	get body() {
 		return this.request.body;
 	}
+	/**
+	* Report whether the body has been consumed.
+	*/
 	get bodyUsed() {
 		return this.request.bodyUsed;
 	}
+	/**
+	* Expose the pre-normalized body value used to build the request.
+	*/
 	get bodySource() {
 		return this.bodySourceValue;
 	}
+	/**
+	* Expose normalized query parameters derived from the request URL.
+	*/
+	get queryParams() {
+		this.queryParamsValue ??= TangoQueryParams.fromURL(this.request.url);
+		return this.queryParamsValue;
+	}
+	/**
+	* Read the request body as an array buffer.
+	*/
 	async arrayBuffer() {
 		return this.request.arrayBuffer();
 	}
+	/**
+	* Read the request body as a blob.
+	*/
 	async blob() {
 		return this.request.blob();
 	}
+	/**
+	* Read the request body as bytes, including runtimes without `Request.bytes()`.
+	*/
 	async bytes() {
 		const requestWithBytes = this.request;
 		if (typeof requestWithBytes.bytes === "function") return requestWithBytes.bytes();
 		const buffer = await this.request.arrayBuffer();
 		return new Uint8Array(buffer);
 	}
+	/**
+	* Read the request body as form data.
+	*/
 	async formData() {
 		return this.request.formData();
 	}
+	/**
+	* Parse the request body as JSON.
+	*/
 	async json() {
 		return this.request.json();
 	}
+	/**
+	* Read the request body as text.
+	*/
 	async text() {
 		return this.request.text();
 	}
+	/**
+	* Clone the request so downstream code can consume it independently.
+	*/
 	clone() {
 		return new TangoRequest(this.request.clone());
 	}
 	normalizeBody(body, headers, method) {
 		if (method === "GET" || method === "HEAD") return undefined;
-		if (body == null) return undefined;
+		if (isNil(body)) return undefined;
 		if (typeof body === "string") return body;
 		if (isArrayBuffer(body) || isUint8Array(body) || isBlob(body)) return body;
 		if (isURLSearchParams(body) || isFormData(body) || isReadableStream(body)) return body;
@@ -699,8 +933,6 @@ var TangoRequest = class TangoRequest {
 var TangoResponse = class TangoResponse {
 	static BRAND = "tango.http.response";
 	__tangoBrand = TangoResponse.BRAND;
-	tangoBody;
-	okValue;
 	headers;
 	redirected;
 	status;
@@ -708,12 +940,8 @@ var TangoResponse = class TangoResponse {
 	type;
 	url;
 	body;
-	static isTangoResponse(value) {
-		return typeof value === "object" && value !== null && value.__tangoBrand === TangoResponse.BRAND;
-	}
-	get bodySource() {
-		return this.tangoBody.bodySource;
-	}
+	tangoBody;
+	okValue;
 	constructor(init = {}) {
 		this.headers = new TangoHeaders(init.headers);
 		this.redirected = Boolean(init.redirected);
@@ -725,103 +953,15 @@ var TangoResponse = class TangoResponse {
 		this.tangoBody = new TangoBody(init.body ?? null, this.headers);
 		this.body = isReadableStream(this.tangoBody.bodySource) ? this.tangoBody.bodySource : null;
 	}
-	get ok() {
-		if (typeof this.okValue === "boolean") return this.okValue;
-		return this.status >= 200 && this.status < 300;
-	}
-	get bodyUsed() {
-		return this.tangoBody.bodyUsed;
-	}
-	setHeader(name, value) {
-		this.headers.set(name, value);
-	}
-	appendHeader(name, value) {
-		this.headers.append(name, value);
-	}
-	getHeader(name) {
-		return this.headers.get(name);
-	}
-	hasHeader(name) {
-		return this.headers.has(name);
-	}
-	deleteHeader(name) {
-		this.headers.delete(name);
-	}
-	vary(...fields) {
-		this.headers.vary(...fields);
-	}
-	setCookie(name, value, options) {
-		this.headers.setCookie(name, value, options);
-	}
-	appendCookie(name, value, options) {
-		this.headers.appendCookie(name, value, options);
-	}
-	deleteCookie(name, options) {
-		this.headers.deleteCookie(name, options);
-	}
-	cacheControl(control) {
-		this.headers.cacheControl(control);
-	}
-	location(url) {
-		this.headers.location(url);
-	}
-	contentType(mime) {
-		this.headers.contentType(mime);
-	}
-	/**
-	* Set the X-Request-Id header (request correlation).
-	* Returns this for fluent chaining.
-	*/
-	withRequestId(requestId) {
-		if (requestId != null && typeof requestId === "string" && requestId !== "") this.headers.set("X-Request-Id", requestId);
-		return this;
-	}
-	/**
-	* Set the traceparent header (W3C Trace Context propagation).
-	* Returns this for fluent chaining.
-	*/
-	withTraceparent(traceparent) {
-		if (traceparent != null && typeof traceparent === "string" && traceparent !== "") this.headers.set("traceparent", traceparent);
-		return this;
-	}
 	/**
-	* Set the Server-Timing header.
-	* Accepts a string or array of timing metrics.
-	* Returns this for fluent chaining.
+	* Narrow an unknown value to `TangoResponse`.
 	*/
-	withServerTiming(timing) {
-		if (Array.isArray(timing)) this.headers.set("Server-Timing", timing.join(", "));
-else if (typeof timing === "string") this.headers.set("Server-Timing", timing);
-		return this;
-	}
-	/**
-	* Set the X-Response-Time header (in ms).
-	* Numeric or formatted string (e.g. "76ms").
-	* Returns this for fluent chaining.
-	*/
-	withResponseTime(time) {
-		if (typeof time === "number") this.headers.set("X-Response-Time", `${time}ms`);
-else if (typeof time === "string") this.headers.set("X-Response-Time", time);
-		return this;
+	static isTangoResponse(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === TangoResponse.BRAND;
 	}
 	/**
-	* Propagate common tracing/correlation headers from provided Headers, TangoHeaders, or plain object.
-	* Known headers: x-request-id, traceparent, server-timing
-	* Returns this for fluent chaining.
+	* Create a JSON response with sensible content headers.
 	*/
-	propagateTraceHeaders(input) {
-		const incoming = new TangoHeaders(input);
-		const traceHeaderNames = [
-			"x-request-id",
-			"traceparent",
-			"server-timing"
-		];
-		for (const name of traceHeaderNames) {
-			const value = incoming.get(name);
-			if (value != null) this.headers.set(name, value);
-		}
-		return this;
-	}
 	static json(data, init) {
 		const headers = new TangoHeaders(init?.headers);
 		if (!headers.has("Content-Type")) headers.set("Content-Type", "application/json; charset=utf-8");
@@ -833,6 +973,9 @@ else if (typeof time === "string") this.headers.set("X-Response-Time", time);
 			headers
 		});
 	}
+	/**
+	* Create a plain-text response with sensible content headers.
+	*/
 	static text(text, init) {
 		const headers = new TangoHeaders(init?.headers);
 		if (!headers.has("Content-Type")) headers.set("Content-Type", "text/plain; charset=utf-8");
@@ -843,6 +986,9 @@ else if (typeof time === "string") this.headers.set("X-Response-Time", time);
 			headers
 		});
 	}
+	/**
+	* Create an HTML response with sensible content headers.
+	*/
 	static html(html, init) {
 		const headers = new TangoHeaders(init?.headers);
 		if (!headers.has("Content-Type")) headers.set("Content-Type", "text/html; charset=utf-8");
@@ -853,6 +999,9 @@ else if (typeof time === "string") this.headers.set("X-Response-Time", time);
 			headers
 		});
 	}
+	/**
+	* Create a streaming response without buffering the payload in memory.
+	*/
 	static stream(stream, init) {
 		return new TangoResponse({
 			...init,
@@ -860,6 +1009,9 @@ else if (typeof time === "string") this.headers.set("X-Response-Time", time);
 			headers: new TangoHeaders(init?.headers)
 		});
 	}
+	/**
+	* Create a redirect response and set the `Location` header.
+	*/
 	static redirect(url, status = 302, init) {
 		const headers = new TangoHeaders(init?.headers);
 		headers.set("Location", url);
@@ -872,6 +1024,9 @@ else if (typeof time === "string") this.headers.set("X-Response-Time", time);
 			url
 		});
 	}
+	/**
+	* Create an empty `204 No Content` response.
+	*/
 	static noContent(init) {
 		const headers = new TangoHeaders(init?.headers);
 		return new TangoResponse({
@@ -881,6 +1036,9 @@ else if (typeof time === "string") this.headers.set("X-Response-Time", time);
 			headers
 		});
 	}
+	/**
+	* Create a `201 Created` response and optionally attach a location or body.
+	*/
 	static created(location, body, init) {
 		const headers = new TangoHeaders(init?.headers);
 		if (location) headers.set("Location", location);
@@ -890,8 +1048,6 @@ else if (typeof time === "string") this.headers.set("X-Response-Time", time);
 			if (!headers.has("Content-Type")) headers.set("Content-Type", "application/json; charset=utf-8");
 		}
 		if (typeof respBody === "string" && !headers.has("Content-Length")) headers.set("Content-Length", new TextEncoder().encode(respBody).length.toString());
-else if (isArrayBuffer(respBody) && !headers.has("Content-Length")) headers.set("Content-Length", respBody.byteLength.toString());
-else if (isBlob(respBody) && !headers.has("Content-Length")) headers.set("Content-Length", respBody.size.toString());
 		return new TangoResponse({
 			...init,
 			body: respBody,
@@ -899,11 +1055,26 @@ else if (isBlob(respBody) && !headers.has("Content-Length")) headers.set("Conten
 			headers
 		});
 	}
+	/**
+	* Create a `405 Method Not Allowed` response and optionally populate `Allow`.
+	*/
+	static methodNotAllowed(allow, detail = "Method not allowed.", init) {
+		const headers = new TangoHeaders(init?.headers);
+		if (allow && allow.length > 0) headers.set("Allow", allow.join(", "));
+		return TangoResponse.json({ error: detail }, {
+			...init,
+			status: 405,
+			headers
+		});
+	}
+	/**
+	* Normalize a Tango error or problem-details object into an error response.
+	*/
 	static error(error, init) {
 		let code;
 		let message;
-		let details = undefined;
-		let fields = undefined;
+		let details;
+		let fields;
 		let status = init?.status ?? 500;
 		if (TangoError.isTangoError(error)) {
 			const envelope = error.toErrorEnvelope();
@@ -928,6 +1099,9 @@ else if (isBlob(respBody) && !headers.has("Content-Length")) headers.set("Conten
 			status
 		});
 	}
+	/**
+	* Create a `400 Bad Request` response from a string or structured error.
+	*/
 	static badRequest(detail, init) {
 		if (TangoError.isTangoError(detail) || TangoError.isProblemDetails(detail)) return TangoResponse.error(detail, {
 			...init,
@@ -948,6 +1122,9 @@ else if (isBlob(respBody) && !headers.has("Content-Length")) headers.set("Conten
 			status: 400
 		});
 	}
+	/**
+	* Create a `401 Unauthorized` response from a string or structured error.
+	*/
 	static unauthorized(detail, init) {
 		if (TangoError.isTangoError(detail) || TangoError.isProblemDetails(detail)) return TangoResponse.error(detail, {
 			...init,
@@ -968,6 +1145,9 @@ else if (isBlob(respBody) && !headers.has("Content-Length")) headers.set("Conten
 			status: 401
 		});
 	}
+	/**
+	* Create a `403 Forbidden` response from a string or structured error.
+	*/
 	static forbidden(detail, init) {
 		if (TangoError.isTangoError(detail) || TangoError.isProblemDetails(detail)) return TangoResponse.error(detail, {
 			...init,
@@ -988,6 +1168,9 @@ else if (isBlob(respBody) && !headers.has("Content-Length")) headers.set("Conten
 			status: 403
 		});
 	}
+	/**
+	* Create a `404 Not Found` response from a string or structured error.
+	*/
 	static notFound(detail, init) {
 		if (TangoError.isTangoError(detail) || TangoError.isProblemDetails(detail)) return TangoResponse.error(detail, {
 			...init,
@@ -1008,6 +1191,9 @@ else if (isBlob(respBody) && !headers.has("Content-Length")) headers.set("Conten
 			status: 404
 		});
 	}
+	/**
+	* Create a `409 Conflict` response from a string or structured error.
+	*/
 	static conflict(detail, init) {
 		if (TangoError.isTangoError(detail) || TangoError.isProblemDetails(detail)) return TangoResponse.error(detail, {
 			...init,
@@ -1028,6 +1214,9 @@ else if (isBlob(respBody) && !headers.has("Content-Length")) headers.set("Conten
 			status: 409
 		});
 	}
+	/**
+	* Create a `422 Unprocessable Entity` response from a string or structured error.
+	*/
 	static unprocessableEntity(detail, init) {
 		if (TangoError.isTangoError(detail) || TangoError.isProblemDetails(detail)) return TangoResponse.error(detail, {
 			...init,
@@ -1048,6 +1237,9 @@ else if (isBlob(respBody) && !headers.has("Content-Length")) headers.set("Conten
 			status: 422
 		});
 	}
+	/**
+	* Create a `429 Too Many Requests` response from a string or structured error.
+	*/
 	static tooManyRequests(detail, init) {
 		if (TangoError.isTangoError(detail) || TangoError.isProblemDetails(detail)) return TangoResponse.error(detail, {
 			...init,
@@ -1068,6 +1260,9 @@ else if (isBlob(respBody) && !headers.has("Content-Length")) headers.set("Conten
 			status: 429
 		});
 	}
+	/**
+	* Create a problem-details style error response with Tango's envelope shape.
+	*/
 	static problem(problem, init) {
 		let status = init?.status ?? 500;
 		const headers = new TangoHeaders(init?.headers);
@@ -1091,15 +1286,13 @@ else if (isBlob(respBody) && !headers.has("Content-Length")) headers.set("Conten
 		} else if (typeof problem === "string") message = problem;
 else if (problem && typeof problem === "object") {
 			const extracted = problem;
-			if (typeof extracted.code === "string") code = extracted.code;
-			if (typeof extracted.message === "string") message = extracted.message;
 			details = extracted.details;
 			fields = extracted.fields;
 		}
 		const envelope = { error: {
 			code,
 			message,
-			...details !== undefined ? { details } : {},
+			...details === undefined ? {} : { details },
 			...fields ? { fields } : {}
 		} };
 		const body = JSON.stringify(envelope);
@@ -1111,6 +1304,189 @@ else if (problem && typeof problem === "object") {
 			body
 		});
 	}
+	/**
+	* Returns a response for serving a file.
+	*/
+	static file(file, opts) {
+		const headers = new TangoHeaders(opts?.init?.headers ?? {});
+		if (opts?.filename) headers.setContentDispositionInline(opts.filename);
+		if (opts?.contentType && !headers.has("Content-Type")) headers.set("Content-Type", opts.contentType);
+else if (!headers.has("Content-Type")) headers.setContentTypeByFile(file, opts?.filename);
+		if (!headers.has("Content-Length")) headers.setContentLengthFromBody(file);
+		return new TangoResponse({
+			...opts?.init,
+			body: file,
+			headers
+		});
+	}
+	/**
+	* Returns a response that prompts the user to download the file.
+	*/
+	static download(file, opts) {
+		const headers = new TangoHeaders(opts?.init?.headers ?? {});
+		if (opts?.filename) headers.setContentDispositionAttachment(opts.filename);
+else headers.set("Content-Disposition", "attachment");
+		if (opts?.contentType && !headers.has("Content-Type")) headers.set("Content-Type", opts.contentType);
+else if (!headers.has("Content-Type")) headers.setContentTypeByFile(file, opts?.filename);
+		if (!headers.has("Content-Length")) headers.setContentLengthFromBody(file);
+		return new TangoResponse({
+			...opts?.init,
+			body: file,
+			headers
+		});
+	}
+	static normalizeWebBody(body) {
+		if (isNil(body) || typeof body === "string" || isBlob(body) || isFormData(body) || isArrayBuffer(body) || isUint8Array(body) || isURLSearchParams(body) || isReadableStream(body)) return body;
+		return JSON.stringify(body);
+	}
+	/**
+	* Expose the original body source for cloning and adapter integration.
+	*/
+	get bodySource() {
+		return this.tangoBody.bodySource;
+	}
+	/**
+	* Report whether the status code falls inside the 2xx range.
+	*/
+	get ok() {
+		if (typeof this.okValue === "boolean") return this.okValue;
+		return this.status >= 200 && this.status < 300;
+	}
+	/**
+	* Report whether the body has been consumed.
+	*/
+	get bodyUsed() {
+		return this.tangoBody.bodyUsed;
+	}
+	/**
+	* Replace a header value on the response.
+	*/
+	setHeader(name, value) {
+		this.headers.set(name, value);
+	}
+	/**
+	* Append another value for a repeated response header.
+	*/
+	appendHeader(name, value) {
+		this.headers.append(name, value);
+	}
+	/**
+	* Read a response header value.
+	*/
+	getHeader(name) {
+		return this.headers.get(name);
+	}
+	/**
+	* Check whether a response header is present.
+	*/
+	hasHeader(name) {
+		return this.headers.has(name);
+	}
+	/**
+	* Remove a response header.
+	*/
+	deleteHeader(name) {
+		this.headers.delete(name);
+	}
+	/**
+	* Merge one or more values into the `Vary` header.
+	*/
+	vary(...fields) {
+		this.headers.vary(...fields);
+	}
+	/**
+	* Add a `Set-Cookie` header that replaces prior application intent.
+	*/
+	setCookie(name, value, options) {
+		this.headers.setCookie(name, value, options);
+	}
+	/**
+	* Append another `Set-Cookie` header.
+	*/
+	appendCookie(name, value, options) {
+		this.headers.appendCookie(name, value, options);
+	}
+	/**
+	* Expire a cookie by issuing a matching deletion cookie header.
+	*/
+	deleteCookie(name, options) {
+		this.headers.deleteCookie(name, options);
+	}
+	/**
+	* Set the `Cache-Control` header through Tango's higher-level helper.
+	*/
+	cacheControl(control) {
+		this.headers.cacheControl(control);
+	}
+	/**
+	* Set the `Location` header on the response.
+	*/
+	location(url) {
+		this.headers.location(url);
+	}
+	/**
+	* Set the response content type.
+	*/
+	contentType(mime) {
+		this.headers.contentType(mime);
+	}
+	/**
+	* Set the X-Request-Id header (request correlation).
+	* Returns this for fluent chaining.
+	*/
+	withRequestId(requestId) {
+		if (!isNil(requestId) && typeof requestId === "string" && requestId !== "") this.headers.set("X-Request-Id", requestId);
+		return this;
+	}
+	/**
+	* Set the traceparent header (W3C Trace Context propagation).
+	* Returns this for fluent chaining.
+	*/
+	withTraceparent(traceparent) {
+		if (!isNil(traceparent) && typeof traceparent === "string" && traceparent !== "") this.headers.set("traceparent", traceparent);
+		return this;
+	}
+	/**
+	* Set the Server-Timing header.
+	* Accepts a string or array of timing metrics.
+	* Returns this for fluent chaining.
+	*/
+	withServerTiming(timing) {
+		if (Array.isArray(timing)) this.headers.set("Server-Timing", timing.join(", "));
+else if (typeof timing === "string") this.headers.set("Server-Timing", timing);
+		return this;
+	}
+	/**
+	* Set the X-Response-Time header (in ms).
+	* Numeric or formatted string (e.g. "76ms").
+	* Returns this for fluent chaining.
+	*/
+	withResponseTime(time) {
+		if (typeof time === "number") this.headers.set("X-Response-Time", `${time}ms`);
+else if (typeof time === "string") this.headers.set("X-Response-Time", time);
+		return this;
+	}
+	/**
+	* Propagate common tracing/correlation headers from provided Headers, TangoHeaders, or plain object.
+	* Known headers: x-request-id, traceparent, server-timing
+	* Returns this for fluent chaining.
+	*/
+	propagateTraceHeaders(input) {
+		const incoming = new TangoHeaders(input);
+		const traceHeaderNames = [
+			"x-request-id",
+			"traceparent",
+			"server-timing"
+		];
+		for (const name of traceHeaderNames) {
+			const value = incoming.get(name);
+			if (!isNil(value)) this.headers.set(name, value);
+		}
+		return this;
+	}
+	/**
+	* Clone the response so its body can be consumed independently.
+	*/
 	clone() {
 		if (this.bodyUsed) throw new TypeError("Body has already been used");
 		const clonedBody = this.tangoBody.clone();
@@ -1125,54 +1501,57 @@ else if (problem && typeof problem === "object") {
 			url: this.url
 		});
 	}
+	/**
+	* Convert this Tango-owned response into a native web `Response`.
+	*
+	* Adapters use this at the host-framework boundary so Tango can standardize
+	* on `TangoResponse` internally while Next.js and other hosts still receive
+	* a platform-native response object.
+	*/
+	toWebResponse() {
+		const responseForTransfer = !this.bodyUsed && isReadableStream(this.bodySource) ? this.clone() : this;
+		const body = TangoResponse.normalizeWebBody(responseForTransfer.bodySource);
+		return new Response(body, {
+			headers: new Headers(responseForTransfer.headers),
+			status: responseForTransfer.status,
+			statusText: responseForTransfer.statusText
+		});
+	}
+	/**
+	* Read the response body as an array buffer.
+	*/
 	async arrayBuffer() {
 		return this.tangoBody.arrayBuffer();
 	}
+	/**
+	* Read the response body as a blob.
+	*/
 	async blob() {
 		return this.tangoBody.blob();
 	}
+	/**
+	* Read the response body as bytes.
+	*/
 	async bytes() {
 		return this.tangoBody.bytes();
 	}
+	/**
+	* Read the response body as form data.
+	*/
 	async formData() {
 		return this.tangoBody.formData();
 	}
-	async json() {
-		return this.tangoBody.json();
-	}
-	async text() {
-		return this.tangoBody.text();
-	}
 	/**
-	* Returns a response for serving a file.
+	* Parse the response body as JSON.
 	*/
-	static file(file, opts) {
-		const headers = new TangoHeaders(opts?.init?.headers ?? {});
-		if (opts?.filename) headers.setContentDispositionInline(opts.filename);
-		if (opts?.contentType && !headers.has("Content-Type")) headers.set("Content-Type", opts.contentType);
-else if (!headers.has("Content-Type")) headers.setContentTypeByFile(file, opts?.filename);
-		if (!headers.has("Content-Length")) headers.setContentLengthFromBody(file);
-		return new TangoResponse({
-			...opts?.init,
-			body: file,
-			headers
-		});
+	async json() {
+		return this.tangoBody.json();
 	}
 	/**
-	* Returns a response that prompts the user to download the file.
+	* Read the response body as text.
 	*/
-	static download(file, opts) {
-		const headers = new TangoHeaders(opts?.init?.headers ?? {});
-		if (opts?.filename) headers.setContentDispositionAttachment(opts.filename);
-else headers.set("Content-Disposition", "attachment");
-		if (opts?.contentType && !headers.has("Content-Type")) headers.set("Content-Type", opts.contentType);
-else if (!headers.has("Content-Type")) headers.setContentTypeByFile(file, opts?.filename);
-		if (!headers.has("Content-Length")) headers.setContentLengthFromBody(file);
-		return new TangoResponse({
-			...opts?.init,
-			body: file,
-			headers
-		});
+	async text() {
+		return this.tangoBody.text();
 	}
 	/**
 	* Returns a plain object debug representation of this response: { status, headers: { ... }, bodyType: ... }.
@@ -1182,7 +1561,7 @@ else if (!headers.has("Content-Type")) headers.setContentTypeByFile(file, opts?.
 		return {
 			status: this.status,
 			headers: Object.fromEntries(this.headers.entries()),
-			bodyType: this.tangoBody ? this.tangoBody.bodyType : typeof this.bodySource
+			bodyType: this.tangoBody.bodyType
 		};
 	}
 	/**
@@ -1209,10 +1588,11 @@ var http_exports = {};
 __export(http_exports, {
 	TangoBody: () => TangoBody,
 	TangoHeaders: () => TangoHeaders,
+	TangoQueryParams: () => TangoQueryParams,
 	TangoRequest: () => TangoRequest,
 	TangoResponse: () => TangoResponse
 });
 
 //#endregion
-export { TangoBody, TangoHeaders, TangoRequest, TangoResponse, http_exports };
-//# sourceMappingURL=http-DOLwwAYt.js.map
+export { TangoBody, TangoHeaders, TangoQueryParams, TangoRequest, TangoResponse, http_exports };
+//# sourceMappingURL=http-D20MQa6p.js.map