@danceroutine/tango-core 1.11.0 → 1.11.2

package/dist/errors-VacGsSaj.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors-VacGsSaj.js","names":["config: HttpErrorFactoryConfig","value: unknown","error: unknown","error: ZodLikeError","details: Record<string, string[]>","errorClass: new (...args: any[]) => T","handler: (error: T) => HttpError","ErrorClass: new (...args: any[]) => Error","message: string","value: unknown","message: string","details?: ErrorDetails","err: unknown","message: string","value: unknown","message: string","value: unknown","message: string","value: unknown","message: string","value: unknown"],"sources":["../src/errors/factories/HttpErrorFactory.ts","../src/errors/factories/index.ts","../src/errors/ConflictError.ts","../src/errors/ValidationError.ts","../src/errors/MultipleObjectsReturned.ts","../src/errors/NotFoundError.ts","../src/errors/PermissionDenied.ts","../src/errors/AuthenticationError.ts","../src/errors/index.ts"],"sourcesContent":["import { TangoError } from '../TangoError';\nimport type { HttpError } from '../HttpError';\nimport { isError, isObject } from '../../runtime/index';\n\nexport interface HttpErrorFactoryConfig {\n    /**\n     * When true, raw error messages are included in HTTP responses.\n     * When false, generic messages are returned for non-TangoError exceptions.\n     * Defaults to true (dev-friendly). Set to false in production.\n     */\n    exposeErrors?: boolean;\n}\n\ntype ZodLikeIssue = {\n    path?: unknown[];\n    message?: unknown;\n};\n\ntype ZodLikeError = Error & {\n    issues: ZodLikeIssue[];\n};\n\n/**\n * Converts errors into structured HTTP error responses.\n * Supports TangoError subclasses out of the box, and custom error handlers\n * can be registered for third-party or application-specific error types.\n *\n * @example\n * ```typescript\n * // Development (default) — exposes real error messages\n * const devFactory = new HttpErrorFactory();\n *\n * // Production — hides internal error details\n * const prodFactory = new HttpErrorFactory({ exposeErrors: false });\n *\n * // Register a custom handler for a third-party error\n * prodFactory.registerHandler(ZodError, (err) => ({\n *   status: 400,\n *   body: { error: 'Validation failed', details: err.flatten().fieldErrors },\n * }));\n *\n * // Quick one-shot conversion with dev defaults\n * const httpError = HttpErrorFactory.toHttpError(new NotFoundError('missing'));\n * ```\n */\nexport class HttpErrorFactory {\n    static readonly BRAND = 'tango.error_factory.http' as const;\n    readonly __tangoBrand: typeof HttpErrorFactory.BRAND = HttpErrorFactory.BRAND;\n\n    // oxlint-disable-next-line typescript/no-explicit-any\n    private handlers = new Map<new (...args: any[]) => Error, (error: Error) => HttpError>();\n    private exposeErrors: boolean;\n\n    constructor(config: HttpErrorFactoryConfig = {}) {\n        this.exposeErrors = config.exposeErrors ?? true;\n    }\n\n    /**\n     * Narrow an unknown value to `HttpErrorFactory`.\n     */\n    static isHttpErrorFactory(value: unknown): value is HttpErrorFactory {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === HttpErrorFactory.BRAND\n        );\n    }\n\n    /**\n     * Convert an unknown error into an `HttpError` using dev-friendly defaults.\n     * Shorthand for `new HttpErrorFactory().create(error)`.\n     */\n    static toHttpError(error: unknown): HttpError {\n        return new HttpErrorFactory().create(error);\n    }\n\n    private static isZodLikeValidationError(error: unknown): error is ZodLikeError {\n        return (\n            isError(error) &&\n            isObject(error) &&\n            Array.isArray((error as { issues?: unknown }).issues) &&\n            (error as { name?: unknown }).name === 'ZodError'\n        );\n    }\n\n    private static zodLikeErrorDetails(error: ZodLikeError): Record<string, string[]> {\n        const details: Record<string, string[]> = {};\n\n        for (const issue of error.issues) {\n            const key = Array.isArray(issue.path) && issue.path.length > 0 ? String(issue.path.join('.')) : '_schema';\n            const message = typeof issue.message === 'string' ? issue.message : 'Invalid value';\n\n            const existing = details[key];\n            if (existing) {\n                existing.push(message);\n            } else {\n                details[key] = [message];\n            }\n        }\n\n        return details;\n    }\n\n    /**\n     * Register a custom mapper for an application or third-party error type.\n     */\n\n    // oxlint-disable-next-line typescript/no-explicit-any\n    registerHandler<T extends Error>(errorClass: new (...args: any[]) => T, handler: (error: T) => HttpError): this {\n        this.handlers.set(errorClass, handler as (error: Error) => HttpError);\n        return this;\n    }\n\n    /**\n     * Convert an unknown error into the normalized HTTP error shape Tango uses.\n     */\n    create(error: unknown): HttpError {\n        if (TangoError.isTangoError(error)) {\n            return error.toHttpError();\n        }\n\n        if (HttpErrorFactory.isZodLikeValidationError(error)) {\n            return {\n                status: 400,\n                body: {\n                    error: error.message || 'Validation failed',\n                    details: HttpErrorFactory.zodLikeErrorDetails(error),\n                },\n            };\n        }\n\n        for (const [ErrorClass, handler] of this.handlers) {\n            if (this.isErrorClassInstance(error, ErrorClass)) {\n                return handler(error);\n            }\n        }\n\n        if (isError(error)) {\n            return {\n                status: 500,\n                body: {\n                    error: this.exposeErrors ? error.message : 'Internal Server Error',\n                    details: null,\n                },\n            };\n        }\n\n        return {\n            status: 500,\n            body: {\n                error: 'Unknown error occurred',\n                details: null,\n            },\n        };\n    }\n\n    // oxlint-disable-next-line typescript/no-explicit-any\n    private isErrorClassInstance(error: unknown, ErrorClass: new (...args: any[]) => Error): error is Error {\n        if (!isError(error)) {\n            return false;\n        }\n\n        const expectedBrand = (ErrorClass as { BRAND?: unknown }).BRAND;\n        if (\n            typeof expectedBrand === 'string' &&\n            isObject(error) &&\n            (error as { __tangoBrand?: unknown }).__tangoBrand === expectedBrand\n        ) {\n            return true;\n        }\n\n        const constructorName = (error as { constructor?: { name?: unknown } }).constructor?.name;\n        if (typeof constructorName === 'string' && constructorName === ErrorClass.name) {\n            return true;\n        }\n\n        const errorName = (error as { name?: unknown }).name;\n        if (typeof errorName === 'string' && errorName === ErrorClass.name) {\n            return true;\n        }\n\n        return false;\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { HttpErrorFactory, type HttpErrorFactoryConfig } from './HttpErrorFactory';\n","import { TangoError, type ErrorDetails } from './TangoError';\n\n/** Error for conflicting resource state (HTTP 409). */\nexport class ConflictError extends TangoError {\n    static readonly BRAND = 'tango.error.conflict' as const;\n    readonly __tangoBrand: typeof ConflictError.BRAND = ConflictError.BRAND;\n    status = 409;\n\n    /** Create a conflict error with optional custom message. */\n    constructor(message: string = 'Resource conflict') {\n        super(message);\n        this.name = 'ConflictError';\n        Object.setPrototypeOf(this, ConflictError.prototype);\n    }\n\n    /**\n     * Narrow an unknown value to `ConflictError`.\n     */\n    static isConflictError(value: unknown): value is ConflictError {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === ConflictError.BRAND\n        );\n    }\n\n    protected override getErrorName(): string {\n        return 'conflict';\n    }\n\n    protected override getDetails(): ErrorDetails {\n        return undefined;\n    }\n}\n","import { TangoError, type ErrorDetails } from './TangoError';\n\n/** Error for request validation failures (HTTP 400). */\nexport class ValidationError extends TangoError {\n    readonly __tangoValidationErrorBrand = 'tango.error.validation' as const;\n    status = 400;\n\n    constructor(\n        message: string,\n        public details?: ErrorDetails\n    ) {\n        super(message);\n        this.name = 'ValidationError';\n        Object.setPrototypeOf(this, ValidationError.prototype);\n    }\n\n    /**\n     * Narrow an unknown value to `ValidationError`, including common legacy shapes.\n     */\n    static isValidationError(err: unknown): err is ValidationError {\n        return (\n            (!!err &&\n                typeof err === 'object' &&\n                (err as { __tangoValidationErrorBrand?: string }).__tangoValidationErrorBrand ===\n                    'tango.error.validation') ||\n            (typeof err === 'object' &&\n                err !== null &&\n                'fields' in err &&\n                typeof (err as { fields: unknown }).fields === 'object')\n        );\n    }\n\n    protected override getErrorName(): string {\n        return 'ValidationError';\n    }\n\n    protected override getDetails(): ErrorDetails {\n        return this.details;\n    }\n}\n","import { TangoError, type ErrorDetails } from './TangoError';\n\n/** Error when a queryset lookup returns more than one row (HTTP 409). */\nexport class MultipleObjectsReturned extends TangoError {\n    static readonly BRAND = 'tango.error.multiple_objects_returned' as const;\n    readonly __tangoBrand: typeof MultipleObjectsReturned.BRAND = MultipleObjectsReturned.BRAND;\n    status = 409;\n\n    constructor(message: string = 'Multiple objects returned') {\n        super(message);\n        this.name = 'MultipleObjectsReturned';\n        Object.setPrototypeOf(this, MultipleObjectsReturned.prototype);\n    }\n\n    static isMultipleObjectsReturned(value: unknown): value is MultipleObjectsReturned {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === MultipleObjectsReturned.BRAND\n        );\n    }\n\n    protected override getErrorName(): string {\n        return 'multiple_objects_returned';\n    }\n\n    protected override getDetails(): ErrorDetails {\n        return undefined;\n    }\n}\n","import { TangoError, type ErrorDetails } from './TangoError';\n\n/** Error for missing resources (HTTP 404). */\nexport class NotFoundError extends TangoError {\n    static readonly BRAND = 'tango.error.not_found' as const;\n    readonly __tangoBrand: typeof NotFoundError.BRAND = NotFoundError.BRAND;\n    status = 404;\n\n    /** Create a not-found error with optional custom message. */\n    constructor(message: string = 'Resource not found') {\n        super(message);\n        this.name = 'NotFoundError';\n        Object.setPrototypeOf(this, NotFoundError.prototype);\n    }\n\n    /**\n     * Narrow an unknown value to `NotFoundError`.\n     */\n    static isNotFoundError(value: unknown): value is NotFoundError {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === NotFoundError.BRAND\n        );\n    }\n\n    protected override getErrorName(): string {\n        return 'not_found';\n    }\n\n    protected override getDetails(): ErrorDetails {\n        return undefined;\n    }\n}\n","import { TangoError, type ErrorDetails } from './TangoError';\n\n/** Error for authorization failures (HTTP 403). */\nexport class PermissionDenied extends TangoError {\n    static readonly BRAND = 'tango.error.permission_denied' as const;\n    readonly __tangoBrand: typeof PermissionDenied.BRAND = PermissionDenied.BRAND;\n    status = 403;\n\n    /** Create a permission-denied error with optional custom message. */\n    constructor(message: string = 'Permission denied') {\n        super(message);\n        this.name = 'PermissionDenied';\n        Object.setPrototypeOf(this, PermissionDenied.prototype);\n    }\n\n    /**\n     * Narrow an unknown value to `PermissionDenied`.\n     */\n    static isPermissionDenied(value: unknown): value is PermissionDenied {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === PermissionDenied.BRAND\n        );\n    }\n\n    protected override getErrorName(): string {\n        return 'permission_denied';\n    }\n\n    protected override getDetails(): ErrorDetails {\n        return undefined;\n    }\n}\n","import { TangoError, type ErrorDetails } from './TangoError';\n\n/** Error for missing/invalid authentication (HTTP 401). */\nexport class AuthenticationError extends TangoError {\n    static readonly BRAND = 'tango.error.authentication' as const;\n    readonly __tangoBrand: typeof AuthenticationError.BRAND = AuthenticationError.BRAND;\n    status = 401;\n\n    /** Create an authentication error with optional custom message. */\n    constructor(message: string = 'Authentication required') {\n        super(message);\n        this.name = 'AuthenticationError';\n        Object.setPrototypeOf(this, AuthenticationError.prototype);\n    }\n\n    /**\n     * Narrow an unknown value to `AuthenticationError`.\n     */\n    static isAuthenticationError(value: unknown): value is AuthenticationError {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === AuthenticationError.BRAND\n        );\n    }\n\n    protected override getErrorName(): string {\n        return 'authentication_error';\n    }\n\n    protected override getDetails(): ErrorDetails {\n        return undefined;\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nimport type { HttpError } from './HttpError';\nimport * as factories from './factories/index';\nimport { TangoError, type ErrorDetails, type ErrorEnvelope, type ProblemDetails } from './TangoError';\nimport { ConflictError } from './ConflictError';\nimport { ValidationError } from './ValidationError';\nimport { MultipleObjectsReturned } from './MultipleObjectsReturned';\nimport { NotFoundError } from './NotFoundError';\nimport { PermissionDenied } from './PermissionDenied';\nimport { AuthenticationError } from './AuthenticationError';\nimport { HttpErrorFactory, type HttpErrorFactoryConfig } from './factories/HttpErrorFactory';\n\nexport {\n    AuthenticationError,\n    ConflictError,\n    HttpErrorFactory,\n    MultipleObjectsReturned,\n    NotFoundError,\n    PermissionDenied,\n    TangoError,\n    ValidationError,\n    factories,\n};\n\nexport type { ErrorDetails, ErrorEnvelope, HttpError, HttpErrorFactoryConfig, ProblemDetails };\n"],"mappings":"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"}

package/dist/http/TangoBody.d.ts

@@ -1,110 +0,0 @@
-/**
- * The full type of body that TangoResponse/TangoBody supports.
- * Unlike the fetch spec BodyInit, this can be directly:
- * - a string, ArrayBuffer, Uint8Array, Blob, FormData, ReadableStream, or JSON-like object, or null/undefined.
- */
-type HeadersLike = {
-    get?: (arg: string) => string | null;
-};
-type TangoBodySource = BodyInit | JsonValue | null;
-/** Recursive JSON value contract used by Tango HTTP helpers. */
-export type JsonValue = string | number | boolean | null | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-/**
- * Unified body reader/clone utility for Tango request/response wrappers.
- */
-export declare class TangoBody {
-    static readonly BRAND: "tango.http.body";
-    readonly __tangoBrand: typeof TangoBody.BRAND;
-    private bodySourceInternal;
-    private bodyUsedInternal;
-    private headers?;
-    constructor(bodySource: TangoBodySource, headers?: HeadersLike);
-    /**
-     * Narrow an unknown value to `TangoBody`.
-     */
-    static isTangoBody(value: unknown): value is TangoBody;
-    /**
-     * Expose the original body source for cloning and adapter integration.
-     */
-    get bodySource(): TangoBodySource;
-    /**
-     * Report whether a reader method has already consumed this body.
-     */
-    get bodyUsed(): boolean;
-    /**
-     * Describe the current body shape in a way that is useful for diagnostics.
-     */
-    get bodyType(): string;
-    /**
-     * Returns true if value is a valid JSON value (recursively).
-     */
-    static isJsonValue(v: unknown): v is JsonValue;
-    /**
-     * 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: TangoBodySource): TangoBodySource;
-    /**
-     * Read a `ReadableStream` into an `ArrayBuffer`.
-     */
-    static readStreamToArrayBuffer(stream: ReadableStream<Uint8Array>): Promise<ArrayBuffer>;
-    /**
-     * Read a `ReadableStream` into a `Uint8Array`.
-     */
-    static readStreamToUint8Array(stream: ReadableStream<Uint8Array>): Promise<Uint8Array<ArrayBuffer>>;
-    /**
-     * Read a `ReadableStream` into UTF-8 text.
-     */
-    static readStreamToText(stream: ReadableStream<Uint8Array>): Promise<string>;
-    /**
-     * Determine the content type for this body, if possible.
-     * Respects an explicitly passed header, otherwise infers from value type.
-     */
-    static detectContentType(body: TangoBodySource, providedType?: string): string | undefined;
-    /**
-     * Attempt to determine the content length, in bytes, for this body.
-     * Only available for certain body types, otherwise returns undefined.
-     */
-    static getContentLength(body: TangoBodySource): Promise<number | undefined>;
-    /**
-     * Reads the body as an ArrayBuffer.
-     */
-    arrayBuffer(): Promise<ArrayBuffer>;
-    /**
-     * Reads the body as a Blob (browser only).
-     */
-    blob(): Promise<Blob>;
-    /**
-     * Reads the body as a Uint8Array.
-     */
-    bytes(): Promise<Uint8Array<ArrayBuffer>>;
-    /**
-     * Reads the body as FormData.
-     * Accepts FormData, or if type is urlencoded or multipart parses a string/bytes.
-     */
-    formData(): Promise<FormData>;
-    /**
-     * Reads and parses the body as JSON (if possible).
-     */
-    json<T = unknown>(): Promise<T>;
-    /**
-     * Reads the body as UTF-8 string.
-     */
-    text(): Promise<string>;
-    /**
-     * Returns the original body value (may be used for streaming or clone).
-     */
-    getRawBodyInit(): TangoBodySource;
-    /**
-     * Clone the body instance and stream if possible.
-     * If the source is a stream, the stream will be cloned if readable, otherwise throws.
-     */
-    clone(): TangoBody;
-    /**
-     * Helper for all readers. Only allows reading once.
-     */
-    private consumeBody;
-}
-export {};

package/dist/http/TangoHeaders.d.ts

@@ -1,191 +0,0 @@
-/**
- * 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
- */
-export declare class TangoHeaders extends Headers {
-    static readonly BRAND: "tango.http.headers";
-    readonly __tangoBrand: typeof TangoHeaders.BRAND;
-    /**
-     * Narrow an unknown value to `TangoHeaders`.
-     */
-    static isTangoHeaders(value: unknown): value is TangoHeaders;
-    /**
-     * Serialize a cookie for the Set-Cookie header line.
-     */
-    private static serializeCookie;
-    private static hasNumberSize;
-    private static hasNumberLength;
-    private static isNodeBuffer;
-    /**
-     * 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.
-     *
-     * @param filename The filename to include in the Content-Disposition header.
-     */
-    setContentDispositionInline(filename: string): void;
-    /**
-     * Sets the Content-Disposition header with type "attachment" and the specified filename.
-     * This is useful to indicate that the response should be downloaded as a file.
-     *
-     * @param filename The filename to include in the Content-Disposition header.
-     */
-    setContentDispositionAttachment(filename: string): void;
-    /**
-     * Create a copy that preserves all header names and values.
-     */
-    clone(): TangoHeaders;
-    /**
-     * Set a header, replacing the existing value.
-     */
-    setHeader(name: string, value: string): void;
-    /**
-     * Append a header, adding to existing value(s) for the name.
-     */
-    appendHeader(name: string, value: string): void;
-    /**
-     * Get a header value (first value if header is repeated).
-     */
-    getHeader(name: string): string | null;
-    /**
-     * Check if a header exists.
-     */
-    hasHeader(name: string): boolean;
-    /**
-     * Delete a header.
-     */
-    deleteHeader(name: string): void;
-    /**
-     * Ensure a header is present only once and fully replaces the old value.
-     */
-    ensureUnique(name: string, value: string): void;
-    /**
-     * Add a field (or fields) to the Vary header, merging with existing values.
-     */
-    vary(...fields: string[]): void;
-    /**
-     * Set a cookie header (for Set-Cookie).
-     * @param name
-     * @param value
-     * @param options
-     */
-    setCookie(name: string, value: string, options?: {
-        domain?: string;
-        expires?: Date;
-        httpOnly?: boolean;
-        maxAge?: number;
-        path?: string;
-        sameSite?: 'Strict' | 'Lax' | 'None';
-        secure?: boolean;
-        priority?: 'Low' | 'Medium' | 'High';
-        partitioned?: boolean;
-    }): void;
-    /**
-     * Append (additionally) a new cookie.
-     */
-    appendCookie(name: string, value: string, options?: {
-        domain?: string;
-        expires?: Date;
-        httpOnly?: boolean;
-        maxAge?: number;
-        path?: string;
-        sameSite?: 'Strict' | 'Lax' | 'None';
-        secure?: boolean;
-        priority?: 'Low' | 'Medium' | 'High';
-        partitioned?: boolean;
-    }): void;
-    /**
-     * Delete a cookie ("unset" it via expired date).
-     */
-    deleteCookie(name: string, options?: {
-        domain?: string;
-        path?: string;
-        sameSite?: 'Strict' | 'Lax' | 'None';
-        secure?: boolean;
-        priority?: 'Low' | 'Medium' | 'High';
-        partitioned?: boolean;
-    }): void;
-    /**
-     * Add or override Cache-Control header with helpers for common policies.
-     */
-    cacheControl(control: string | Record<string, string | number | boolean | undefined>): void;
-    /**
-     * Set the Location header.
-     */
-    location(url: string): void;
-    /**
-     * Set the Content-Type header.
-     */
-    contentType(mime: string): void;
-    /**
-     * Attempt to guess and set the Content-Type header from a file (string or Blob) and optional filename.
-     *
-     * @param file File-like input (string or Blob)
-     * @param filename Optional filename to help guess mime type by extension
-     */
-    setContentTypeByFile(file: unknown, filename?: string): void;
-    /**
-     * Sets the Content-Length header, inferring it from the body if not explicitly provided.
-     * If the body is a string, ArrayBuffer, Uint8Array, Blob/Buffer (or has a .size or .length property),
-     * the length is computed. For unsupported types, does nothing.
-     * Mirrors logic from TangoResponse.ts, but generalized for use anywhere.
-     */
-    setContentLengthFromBody(body: unknown): void;
-    /**
-     * Set or update the X-Request-Id header. Used for associating a request/response with a unique id.
-     * @param id The request id value to set.
-     */
-    withRequestId(id: string): this;
-    /**
-     * Set or update the traceparent header. Used for distributed trace context propagation (W3C Trace Context).
-     * @param value The traceparent value (should be a valid traceparent header value).
-     */
-    withTraceParent(value: string): this;
-    /**
-     * Set or append a value to the Server-Timing header.
-     * For a single metric, supply name, and optionally dur and desc.
-     * For advanced usage (many metrics), set the value directly or use appendServerTimingRaw.
-     *
-     * @param name Name of the server-timing metric (e.g., 'total', 'db').
-     * @param dur Optional duration in ms.
-     * @param desc Optional string description.
-     */
-    withServerTiming(name: string, dur?: number, desc?: string): this;
-    /**
-     * Directly append a raw Server-Timing metric value.
-     * This is useful for advanced cases where you have multiple metrics assembled.
-     * @param value The server-timing value chunk to append.
-     */
-    appendServerTimingRaw(value: string): this;
-    /**
-     * Set or update X-Response-Time header.
-     * @param ms Elapsed time in milliseconds (number or string for flexibility).
-     */
-    withResponseTime(ms: number | string): this;
-    /**
-     * Return the current value of X-Request-Id.
-     */
-    getRequestId(): string | null;
-    /**
-     * Return the current value of traceparent header.
-     */
-    getTraceParent(): string | null;
-    /**
-     * Return the current Server-Timing string, if set.
-     */
-    getServerTiming(): string | null;
-    /**
-     * Return the current X-Response-Time string, if set.
-     */
-    getResponseTime(): string | null;
-}

package/dist/http/TangoQueryParams.d.ts

@@ -1,81 +0,0 @@
-import type { TangoRequest } from './TangoRequest';
-type QueryParamRecord = Record<string, string | string[] | undefined>;
-type QueryParamMutationValue = string | number | readonly (string | number)[] | null | undefined;
-type QueryParamMutationRecord = Record<string, QueryParamMutationValue>;
-/**
- * Immutable query parameter helper that normalizes framework-specific shapes
- * into one Tango-owned API.
- */
-export declare class TangoQueryParams {
-    static readonly BRAND: "tango.http.query_params";
-    readonly __tangoBrand: typeof TangoQueryParams.BRAND;
-    private readonly values;
-    private constructor();
-    /**
-     * Narrow an unknown value to `TangoQueryParams`.
-     */
-    static isTangoQueryParams(value: unknown): value is TangoQueryParams;
-    /**
-     * Build query params from a `URLSearchParams` instance.
-     */
-    static fromURLSearchParams(params: URLSearchParams): TangoQueryParams;
-    /**
-     * Build query params from framework record-style search params.
-     */
-    static fromRecord(params: QueryParamRecord): TangoQueryParams;
-    /**
-     * Build query params from a full URL string or URL object.
-     */
-    static fromURL(input: string | URL): TangoQueryParams;
-    /**
-     * Build query params from a request-like object with a URL.
-     */
-    static fromRequest(request: Request | TangoRequest): TangoQueryParams;
-    /**
-     * Get the first value for a query param.
-     */
-    get(name: string): string | undefined;
-    /**
-     * Get all values for a query param.
-     */
-    getAll(name: string): string[];
-    /**
-     * Check whether a query param exists.
-     */
-    has(name: string): boolean;
-    /**
-     * Iterate key -> values entries.
-     */
-    entries(): IterableIterator<[string, string[]]>;
-    /**
-     * Iterate keys present in the query params.
-     */
-    keys(): IterableIterator<string>;
-    /**
-     * Convert back to a native `URLSearchParams` object.
-     */
-    toURLSearchParams(): URLSearchParams;
-    /**
-     * Return a new query param set with selected keys replaced or removed.
-     *
-     * `undefined`, `null`, and empty arrays remove the key entirely.
-     */
-    withValues(updates: QueryParamMutationRecord): TangoQueryParams;
-    /**
-     * Convert to a relative query string suitable for links.
-     */
-    toRelativeURL(): string;
-    /**
-     * Get a trimmed value, omitting blank strings.
-     */
-    getTrimmed(name: string): string | undefined;
-    /**
-     * Get the free-text search param using Tango's default key.
-     */
-    getSearch(key?: string): string | undefined;
-    /**
-     * Get the ordering param as trimmed field tokens.
-     */
-    getOrdering(key?: string): string[];
-}
-export {};

package/dist/http/TangoRequest.d.ts

@@ -1,130 +0,0 @@
-import type { JsonValue } from './TangoBody';
-import { TangoQueryParams } from './TangoQueryParams';
-type TangoRequestInit = {
-    method?: string;
-    headers?: HeadersInit;
-    body?: BodyInit | JsonValue | null;
-    redirect?: RequestRedirect;
-    cache?: RequestCache;
-    credentials?: RequestCredentials;
-    integrity?: string;
-    keepalive?: boolean;
-    mode?: RequestMode;
-    referrer?: string;
-    referrerPolicy?: ReferrerPolicy;
-    signal?: AbortSignal;
-};
-/**
- * Framework request wrapper that normalizes JSON-like bodies and preserves
- * fetch `Request` compatibility for downstream handlers.
- */
-export declare class TangoRequest implements Request {
-    static readonly BRAND: "tango.http.request";
-    readonly __tangoBrand: typeof TangoRequest.BRAND;
-    private request;
-    private bodySourceValue;
-    private queryParamsValue?;
-    constructor(input: string | Request, init?: TangoRequestInit);
-    /**
-     * Narrow an unknown value to `TangoRequest`.
-     */
-    static isTangoRequest(value: unknown): value is TangoRequest;
-    /**
-     * Expose the request cache mode from the underlying fetch request.
-     */
-    get cache(): RequestCache;
-    /**
-     * Expose the request credentials mode from the underlying fetch request.
-     */
-    get credentials(): RequestCredentials;
-    /**
-     * Expose the request destination from the underlying fetch request.
-     */
-    get destination(): RequestDestination;
-    /**
-     * Expose the request headers from the underlying fetch request.
-     */
-    get headers(): Headers;
-    /**
-     * Expose the request integrity value from the underlying fetch request.
-     */
-    get integrity(): string;
-    /**
-     * Expose the request keepalive flag from the underlying fetch request.
-     */
-    get keepalive(): boolean;
-    /**
-     * Expose the normalized HTTP method.
-     */
-    get method(): string;
-    /**
-     * Expose the request mode from the underlying fetch request.
-     */
-    get mode(): RequestMode;
-    /**
-     * Expose the redirect policy from the underlying fetch request.
-     */
-    get redirect(): RequestRedirect;
-    /**
-     * Expose the referrer from the underlying fetch request.
-     */
-    get referrer(): string;
-    /**
-     * Expose the referrer policy from the underlying fetch request.
-     */
-    get referrerPolicy(): ReferrerPolicy;
-    /**
-     * Expose the abort signal from the underlying fetch request.
-     */
-    get signal(): AbortSignal;
-    /**
-     * Expose the absolute request URL.
-     */
-    get url(): string;
-    /**
-     * Expose the readable request body stream when one exists.
-     */
-    get body(): Request['body'];
-    /**
-     * Report whether the body has been consumed.
-     */
-    get bodyUsed(): boolean;
-    /**
-     * Expose the pre-normalized body value used to build the request.
-     */
-    get bodySource(): BodyInit | JsonValue | null;
-    /**
-     * Expose normalized query parameters derived from the request URL.
-     */
-    get queryParams(): TangoQueryParams;
-    /**
-     * Read the request body as an array buffer.
-     */
-    arrayBuffer(): Promise<ArrayBuffer>;
-    /**
-     * Read the request body as a blob.
-     */
-    blob(): Promise<Blob>;
-    /**
-     * Read the request body as bytes, including runtimes without `Request.bytes()`.
-     */
-    bytes(): Promise<Uint8Array<ArrayBuffer>>;
-    /**
-     * Read the request body as form data.
-     */
-    formData(): Promise<FormData>;
-    /**
-     * Parse the request body as JSON.
-     */
-    json<T = unknown>(): Promise<T>;
-    /**
-     * Read the request body as text.
-     */
-    text(): Promise<string>;
-    /**
-     * Clone the request so downstream code can consume it independently.
-     */
-    clone(): TangoRequest;
-    private normalizeBody;
-}
-export {};