@danceroutine/tango-core 1.11.1 → 1.11.2

package/dist/{http-63cMANMG.js → http-6e0y_vd6.js}

@@ -1,8 +1,10 @@
-import { __export } from "./chunk-BkvOhyD0.js";
-import { TangoError } from "./TangoError-DdQVQNZU.js";
-import { isArrayBuffer, isBlob, isFile, isFormData, isNil, isReadableStream, isURLSearchParams, isUint8Array } from "./runtime-B8KkgD3R.js";
-
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
+import { t as TangoError } from "./TangoError-Cvgnm026.js";
+import { _ as isNil, d as isURLSearchParams, f as isFormData, g as isArrayBuffer, h as isUint8Array, l as isFile, m as isBlob, u as isReadableStream } from "./runtime-BAG_EKuM.js";
 //#region src/http/TangoBody.ts
+/**
+* Unified body reader/clone utility for Tango request/response wrappers.
+*/
 var TangoBody = class TangoBody {
 	static BRAND = "tango.http.body";
 	__tangoBrand = TangoBody.BRAND;
@@ -123,17 +125,16 @@ var TangoBody = class TangoBody {
 	*/
 	static detectContentType(body, providedType) {
 		if (providedType) return providedType;
-		if (isNil(body)) return undefined;
+		if (isNil(body)) return void 0;
 		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 (isFormData(body)) return void 0;
 		if (typeof body === "object" && TangoBody.isJsonValue(body)) return "application/json; charset=utf-8";
-		if (isReadableStream(body)) return undefined;
-		return undefined;
+		if (isReadableStream(body)) return void 0;
 	}
 	/**
 	* Attempt to determine the content length, in bytes, for this body.
@@ -146,7 +147,6 @@ var TangoBody = class TangoBody {
 		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.
@@ -204,20 +204,19 @@ var TangoBody = class TangoBody {
 	async formData() {
 		return this.consumeBody(async (input) => {
 			if (isFormData(input)) return input;
-			let contentType = undefined;
+			let contentType = void 0;
 			if (this.headers && typeof this.headers.get === "function") {
-				const raw$1 = this.headers.get("Content-Type");
-				if (typeof raw$1 === "string") contentType = raw$1.toLowerCase();
+				const raw = this.headers.get("Content-Type");
+				if (typeof raw === "string") contentType = raw.toLowerCase();
 			}
 			let raw;
 			if (typeof input === "string") raw = input;
-else if (isArrayBuffer(input)) raw = new TextDecoder().decode(input);
-else if (isUint8Array(input)) raw = new TextDecoder().decode(input);
-else throw new TypeError("Body is not valid for FormData");
+			else if (isArrayBuffer(input)) raw = new TextDecoder().decode(input);
+			else if (isUint8Array(input)) raw = new TextDecoder().decode(input);
+			else throw new TypeError("Body is not valid for FormData");
 			if (contentType && contentType.includes("application/x-www-form-urlencoded")) {
 				const form = new FormData();
-				const params = new URLSearchParams(raw);
-				params.forEach((value, key) => form.append(key, value));
+				new URLSearchParams(raw).forEach((value, key) => form.append(key, value));
 				return form;
 			}
 			if (contentType && contentType.startsWith("multipart/form-data")) {
@@ -291,8 +290,7 @@ else throw new TypeError("Body is not valid for FormData");
 			this.bodySourceInternal = streamForOriginal;
 			return new TangoBody(streamForClone, this.headers);
 		}
-		const cloneSource = TangoBody.deepCloneBody(this.bodySourceInternal);
-		return new TangoBody(cloneSource, this.headers);
+		return new TangoBody(TangoBody.deepCloneBody(this.bodySourceInternal), this.headers);
 	}
 	/**
 	* Helper for all readers. Only allows reading once.
@@ -303,9 +301,22 @@ else throw new TypeError("Body is not valid for FormData");
 		return parser(this.bodySourceInternal);
 	}
 };
-
 //#endregion
 //#region src/http/TangoHeaders.ts
+/**
+* TangoHeaders extends the Web Headers class, adding ergonomic helpers
+* for common HTTP header patterns, convenience features, and a consistent API for
+* setting, appending, and deleting headers and cookies. This is designed to be
+* used by TangoResponse and other Tango HTTP utilities.
+* Additionally, provides helpers for safely setting Content-Length based on a known body,
+* and setting Content-Disposition for inline or attachment filenames.
+*
+* Includes helpers for request tracing and correlation headers:
+*   - X-Request-Id
+*   - traceparent (W3C Trace Context)
+*   - Server-Timing
+*   - X-Response-Time
+*/
 var TangoHeaders = class TangoHeaders extends Headers {
 	static BRAND = "tango.http.headers";
 	__tangoBrand = TangoHeaders.BRAND;
@@ -322,7 +333,7 @@ var TangoHeaders = class TangoHeaders extends Headers {
 		let cookie = encodeURIComponent(name) + "=" + encodeURIComponent(value ?? "");
 		if (options.domain) cookie += `; Domain=${options.domain}`;
 		if (options.path) cookie += `; Path=${options.path}`;
-else cookie += "; 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";
@@ -415,7 +426,7 @@ else cookie += "; Path=/";
 		if (fields.length === 0) return;
 		const key = "Vary";
 		const prev = this.get(key);
-		const nextSet = new Set();
+		const nextSet = /* @__PURE__ */ new Set();
 		if (prev) {
 			for (const v of prev.split(",")) if (v.trim()) nextSet.add(v.trim());
 		}
@@ -443,7 +454,7 @@ else cookie += "; Path=/";
 	deleteCookie(name, options) {
 		this.setCookie(name, "", {
 			...options,
-			expires: new Date(0),
+			expires: /* @__PURE__ */ new Date(0),
 			maxAge: 0
 		});
 	}
@@ -483,8 +494,7 @@ else cookie += "; Path=/";
 		if (this.has("Content-Type")) return;
 		if (typeof file === "string" && filename) {
 			const dotIndex = filename.lastIndexOf(".");
-			const ext = dotIndex >= 0 ? filename.slice(dotIndex + 1).toLowerCase() : "";
-			const map = {
+			const mime = {
 				txt: "text/plain",
 				text: "text/plain",
 				html: "text/html",
@@ -500,15 +510,14 @@ else cookie += "; Path=/";
 				svg: "image/svg+xml",
 				ico: "image/x-icon",
 				md: "text/markdown"
-			};
-			const mime = map[ext];
+			}[dotIndex >= 0 ? filename.slice(dotIndex + 1).toLowerCase() : ""];
 			if (mime) this.set("Content-Type", mime);
-else this.set("Content-Type", "application/octet-stream");
+			else this.set("Content-Type", "application/octet-stream");
 			return;
 		}
 		if (isBlob(file)) {
 			if (file.type && file.type !== "") this.set("Content-Type", file.type);
-else this.set("Content-Type", "application/octet-stream");
+			else this.set("Content-Type", "application/octet-stream");
 			return;
 		}
 		this.set("Content-Type", "application/octet-stream");
@@ -520,15 +529,15 @@ else this.set("Content-Type", "application/octet-stream");
 	* Mirrors logic from TangoResponse.ts, but generalized for use anywhere.
 	*/
 	setContentLengthFromBody(body) {
-		if (this.has("Content-Length") || body === null || body === undefined) return;
+		if (this.has("Content-Length") || body === null || body === void 0) return;
 		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 (TangoHeaders.hasNumberSize(body)) len = body.size;
-else if (TangoHeaders.hasNumberLength(body) && typeof body !== "string" && !isArrayBuffer(body) && !isUint8Array(body)) len = 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 (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());
 	}
 	/**
@@ -562,7 +571,7 @@ else if (TangoHeaders.hasNumberLength(body) && typeof body !== "string" && !isAr
 		if (desc) metric += `;desc="${desc.replace(/"/g, "\\\"")}"`;
 		const prev = this.get("Server-Timing");
 		if (prev && prev.length > 0) this.set("Server-Timing", prev + ", " + metric);
-else this.set("Server-Timing", metric);
+		else this.set("Server-Timing", metric);
 		return this;
 	}
 	/**
@@ -573,7 +582,7 @@ else this.set("Server-Timing", metric);
 	appendServerTimingRaw(value) {
 		const prev = this.get("Server-Timing");
 		if (prev && prev.length > 0) this.set("Server-Timing", prev + ", " + value);
-else this.set("Server-Timing", value);
+		else this.set("Server-Timing", value);
 		return this;
 	}
 	/**
@@ -609,9 +618,12 @@ else this.set("Server-Timing", value);
 		return this.get("X-Response-Time");
 	}
 };
-
 //#endregion
 //#region src/http/TangoQueryParams.ts
+/**
+* Immutable query parameter helper that normalizes framework-specific shapes
+* into one Tango-owned API.
+*/
 var TangoQueryParams = class TangoQueryParams {
 	static BRAND = "tango.http.query_params";
 	__tangoBrand = TangoQueryParams.BRAND;
@@ -629,7 +641,7 @@ var TangoQueryParams = class TangoQueryParams {
 	* Build query params from a `URLSearchParams` instance.
 	*/
 	static fromURLSearchParams(params) {
-		const values = new Map();
+		const values = /* @__PURE__ */ new Map();
 		for (const [key, value] of params.entries()) {
 			const current = values.get(key);
 			if (current) {
@@ -644,7 +656,7 @@ var TangoQueryParams = class TangoQueryParams {
 	* Build query params from framework record-style search params.
 	*/
 	static fromRecord(params) {
-		const values = new Map();
+		const values = /* @__PURE__ */ new Map();
 		for (const [key, value] of Object.entries(params)) {
 			if (Array.isArray(value)) {
 				const normalized = value.filter((entry) => typeof entry === "string");
@@ -712,10 +724,10 @@ var TangoQueryParams = class TangoQueryParams {
 	* `undefined`, `null`, and empty arrays remove the key entirely.
 	*/
 	withValues(updates) {
-		const next = new Map();
+		const next = /* @__PURE__ */ new Map();
 		for (const [key, values] of this.values.entries()) next.set(key, [...values]);
 		for (const [key, value] of Object.entries(updates)) {
-			if (value === undefined || value === null) {
+			if (value === void 0 || value === null) {
 				next.delete(key);
 				continue;
 			}
@@ -740,7 +752,7 @@ var TangoQueryParams = class TangoQueryParams {
 	*/
 	getTrimmed(name) {
 		const value = this.get(name)?.trim();
-		return value ? value : undefined;
+		return value ? value : void 0;
 	}
 	/**
 	* Get the free-text search param using Tango's default key.
@@ -757,9 +769,12 @@ var TangoQueryParams = class TangoQueryParams {
 		return value.split(",").map((token) => token.trim()).filter((token) => token.length > 0);
 	}
 };
-
 //#endregion
 //#region src/http/TangoRequest.ts
+/**
+* Framework request wrapper that normalizes JSON-like bodies and preserves
+* fetch `Request` compatibility for downstream handlers.
+*/
 var TangoRequest = class TangoRequest {
 	static BRAND = "tango.http.request";
 	__tangoBrand = TangoRequest.BRAND;
@@ -767,7 +782,7 @@ var TangoRequest = class TangoRequest {
 	bodySourceValue;
 	queryParamsValue;
 	constructor(input, init = {}) {
-		const sourceRequest = typeof input === "string" ? undefined : input;
+		const sourceRequest = typeof input === "string" ? void 0 : 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);
@@ -784,7 +799,7 @@ var TangoRequest = class TangoRequest {
 			referrerPolicy: init.referrerPolicy ?? sourceRequest?.referrerPolicy,
 			signal: init.signal ?? sourceRequest?.signal
 		};
-		if (normalizedBody !== undefined) {
+		if (normalizedBody !== void 0) {
 			requestInit.body = normalizedBody;
 			if (isReadableStream(normalizedBody)) requestInit.duplex = "half";
 		}
@@ -946,8 +961,8 @@ var TangoRequest = class TangoRequest {
 		return new TangoRequest(this.request.clone());
 	}
 	normalizeBody(body, headers, method) {
-		if (method === "GET" || method === "HEAD") return undefined;
-		if (isNil(body)) return undefined;
+		if (method === "GET" || method === "HEAD") return;
+		if (isNil(body)) return;
 		if (typeof body === "string") return body;
 		if (isArrayBuffer(body) || isUint8Array(body) || isBlob(body)) return body;
 		if (isURLSearchParams(body) || isFormData(body) || isReadableStream(body)) return body;
@@ -956,9 +971,11 @@ var TangoRequest = class TangoRequest {
 		return serialized;
 	}
 };
-
 //#endregion
 //#region src/http/TangoResponse.ts
+/**
+* Framework response wrapper with fetch-compatible surface plus ergonomic helpers.
+*/
 var TangoResponse = class TangoResponse {
 	static BRAND = "tango.http.response";
 	__tangoBrand = TangoResponse.BRAND;
@@ -978,7 +995,7 @@ var TangoResponse = class TangoResponse {
 		this.statusText = init.statusText || "";
 		this.type = init.type || "default";
 		this.url = init.url || "";
-		this.okValue = typeof init.ok === "boolean" ? init.ok : undefined;
+		this.okValue = typeof init.ok === "boolean" ? init.ok : void 0;
 		this.tangoBody = new TangoBody(init.body ?? null, this.headers);
 		this.body = isReadableStream(this.tangoBody.bodySource) ? this.tangoBody.bodySource : null;
 	}
@@ -1046,7 +1063,7 @@ var TangoResponse = class TangoResponse {
 		headers.set("Location", url);
 		return new TangoResponse({
 			...init,
-			body: undefined,
+			body: void 0,
 			status,
 			headers,
 			redirected: true,
@@ -1060,7 +1077,7 @@ var TangoResponse = class TangoResponse {
 		const headers = new TangoHeaders(init?.headers);
 		return new TangoResponse({
 			...init,
-			body: undefined,
+			body: void 0,
 			status: 204,
 			headers
 		});
@@ -1072,7 +1089,7 @@ var TangoResponse = class TangoResponse {
 		const headers = new TangoHeaders(init?.headers);
 		if (location) headers.set("Location", location);
 		let respBody;
-		if (body !== undefined) {
+		if (body !== void 0) {
 			respBody = JSON.stringify(body);
 			if (!headers.has("Content-Type")) headers.set("Content-Type", "application/json; charset=utf-8");
 		}
@@ -1298,22 +1315,22 @@ var TangoResponse = class TangoResponse {
 		if (!headers.has("Content-Type")) headers.set("Content-Type", "application/problem+json; charset=utf-8");
 		let code = "error";
 		let message = "An error occurred";
-		let details = undefined;
+		let details = void 0;
 		let fields;
 		if (TangoError.isTangoError(problem)) {
-			const envelope$1 = problem.toErrorEnvelope();
+			const envelope = problem.toErrorEnvelope();
 			status = problem.status;
-			code = envelope$1.error.code;
-			message = envelope$1.error.message;
-			details = envelope$1.error.details;
-			fields = envelope$1.error.fields;
+			code = envelope.error.code;
+			message = envelope.error.message;
+			details = envelope.error.details;
+			fields = envelope.error.fields;
 		} else if (TangoError.isProblemDetails(problem)) {
 			code = problem.code;
 			message = problem.message;
 			details = problem.details;
 			fields = problem.fields;
 		} else if (typeof problem === "string") message = problem;
-else if (problem && typeof problem === "object") {
+		else if (problem && typeof problem === "object") {
 			const extracted = problem;
 			details = extracted.details;
 			fields = extracted.fields;
@@ -1321,7 +1338,7 @@ else if (problem && typeof problem === "object") {
 		const envelope = { error: {
 			code,
 			message,
-			...details === undefined ? {} : { details },
+			...details === void 0 ? {} : { details },
 			...fields ? { fields } : {}
 		} };
 		const body = JSON.stringify(envelope);
@@ -1340,7 +1357,7 @@ else if (problem && typeof problem === "object") {
 		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);
+		else if (!headers.has("Content-Type")) headers.setContentTypeByFile(file, opts?.filename);
 		if (!headers.has("Content-Length")) headers.setContentLengthFromBody(file);
 		return new TangoResponse({
 			...opts?.init,
@@ -1354,9 +1371,9 @@ else if (!headers.has("Content-Type")) headers.setContentTypeByFile(file, opts?.
 	static download(file, opts) {
 		const headers = new TangoHeaders(opts?.init?.headers ?? {});
 		if (opts?.filename) headers.setContentDispositionAttachment(opts.filename);
-else headers.set("Content-Disposition", "attachment");
+		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);
+		else if (!headers.has("Content-Type")) headers.setContentTypeByFile(file, opts?.filename);
 		if (!headers.has("Content-Length")) headers.setContentLengthFromBody(file);
 		return new TangoResponse({
 			...opts?.init,
@@ -1482,7 +1499,7 @@ else if (!headers.has("Content-Type")) headers.setContentTypeByFile(file, opts?.
 	*/
 	withServerTiming(timing) {
 		if (Array.isArray(timing)) this.headers.set("Server-Timing", timing.join(", "));
-else if (typeof timing === "string") this.headers.set("Server-Timing", timing);
+		else if (typeof timing === "string") this.headers.set("Server-Timing", timing);
 		return this;
 	}
 	/**
@@ -1492,7 +1509,7 @@ else if (typeof timing === "string") this.headers.set("Server-Timing", timing);
 	*/
 	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);
+		else if (typeof time === "string") this.headers.set("X-Response-Time", time);
 		return this;
 	}
 	/**
@@ -1502,12 +1519,11 @@ else if (typeof time === "string") this.headers.set("X-Response-Time", time);
 	*/
 	propagateTraceHeaders(input) {
 		const incoming = new TangoHeaders(input);
-		const traceHeaderNames = [
+		for (const name of [
 			"x-request-id",
 			"traceparent",
 			"server-timing"
-		];
-		for (const name of traceHeaderNames) {
+		]) {
 			const value = incoming.get(name);
 			if (!isNil(value)) this.headers.set(name, value);
 		}
@@ -1518,9 +1534,8 @@ else if (typeof time === "string") this.headers.set("X-Response-Time", time);
 	*/
 	clone() {
 		if (this.bodyUsed) throw new TypeError("Body has already been used");
-		const clonedBody = this.tangoBody.clone();
 		return new TangoResponse({
-			body: clonedBody.bodySource,
+			body: this.tangoBody.clone().bodySource,
 			headers: this.headers.clone(),
 			ok: this.okValue,
 			redirected: this.redirected,
@@ -1606,23 +1621,24 @@ else if (typeof time === "string") this.headers.set("X-Response-Time", time);
 	* This method is _not_ part of the web Response interface, and is intentionally private/internal.
 	*/
 	__peekBodyForTestOnly() {
-		const nodeEnv = typeof process !== "undefined" ? process.env?.NODE_ENV : undefined;
+		const nodeEnv = typeof process !== "undefined" ? process.env?.NODE_ENV : void 0;
 		if (nodeEnv === "production" || nodeEnv === "prod") throw new Error("peekBody() is not available in production builds. For test/debug use only.");
 		return this.tangoBody.bodySource;
 	}
 };
-
 //#endregion
 //#region src/http/index.ts
-var http_exports = {};
-__export(http_exports, {
+/**
+* Domain boundary barrel: centralizes this subdomain's public contract.
+*/
+var http_exports = /* @__PURE__ */ __exportAll({
 	TangoBody: () => TangoBody,
 	TangoHeaders: () => TangoHeaders,
 	TangoQueryParams: () => TangoQueryParams,
 	TangoRequest: () => TangoRequest,
 	TangoResponse: () => TangoResponse
 });
-
 //#endregion
-export { TangoBody, TangoHeaders, TangoQueryParams, TangoRequest, TangoResponse, http_exports };
-//# sourceMappingURL=http-63cMANMG.js.map
+export { TangoHeaders as a, TangoQueryParams as i, TangoResponse as n, TangoBody as o, TangoRequest as r, http_exports as t };
+
+//# sourceMappingURL=http-6e0y_vd6.js.map