@siglo/http 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Jerico de guzman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# @siglo/http
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Enterprise-grade, resilient, W3C-traced HTTP client steps for Siglo workflows.
+
+## Key Features
+
+- **Coordinated Retries & Backoff**: Smart status code classifier (`429`, `502`, `503`, `504`) with `Retry-After` parsing (both integer seconds and RFC 1123 HTTP dates) and full jitter.
+- **ASL Network Egress Perimeter**: Automatic validation against Siglo's AsyncLocalStorage (ASL) network security policies (`allowNetwork`) with host verification.
+- **W3C Distributed Tracing**: Automatic injection of W3C `traceparent` and `tracestate` headers linked to active OpenTelemetry spans.
+- **Standard Schema Validation**: Native validation of request payloads and response bodies with Standard Schema (`zod`, `valibot`, `arktype`, etc.).
+- **Sagas & Rollback Compensation**: Declarative `.compensateWithHttp()` automatically registers REST rollbacks in Siglo's CompensationManager.
+- **Deterministic Testing**: `@siglo/http/testing` includes `createMockHttpServer` for mocking requests without launching network listeners.
+
+## Installation
+
+```bash
+npm install @siglo/http
+```
+
+## Basic Usage
+
+```typescript
+import { flow } from '@siglo/core';
+import { httpStep } from '@siglo/http';
+
+export const getUser = httpStep('getUser', {
+  url: 'https://api.example.com/users/123',
+  method: 'GET',
+});
+
+const workflow = flow(getUser);
+const result = await workflow.run({});
+```
+
+The package re-exports the official `StandardSchemaV1` and `StandardJSONSchemaV1`
+types from `@standard-schema/spec`, including `StandardSchemaV1.InferInput<S>` and
+`StandardSchemaV1.InferOutput<S>`. Runtime validation preserves transformed values
+(including `undefined`) and supports structured diagnostic path segments. Native
+JSON Schema conversion is a separate capability from runtime validation.

package/dist/client/fetch.d.ts

@@ -0,0 +1,46 @@
+import { InspectionCapturePolicy } from '@siglo/core';
+import { Span } from '@opentelemetry/api';
+import { HttpMethod, HttpMetadata } from '../types';
+export interface ExecuteHttpRequestOptions {
+    capture?: InspectionCapturePolicy;
+    stepName: string;
+    url: string;
+    method?: HttpMethod;
+    headers?: Record<string, string>;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    responseType?: 'json' | 'text' | 'blob' | 'arrayBuffer';
+    retryOnStatus?: number[];
+    maxRetries?: number;
+    allowNotFound?: boolean;
+    timeoutMs?: number;
+    signal?: any;
+    span?: Span;
+    clock?: {
+        now(): number;
+    };
+    sleep?: (ms: number) => Promise<void>;
+    customFetch?: typeof globalThis.fetch;
+}
+export interface HttpResponseResult<T = any> {
+    data: T;
+    metadata: HttpMetadata;
+    notFound?: boolean;
+}
+/**
+ * Resolves an AbortSignal from a candidate which could be an AbortSignal or a Siglo getter function.
+ */
+export declare function resolveAbortSignal(candidate: any): AbortSignal | undefined;
+/**
+ * Builds the full URL including query parameters.
+ */
+export declare function buildUrlWithQuery(baseUrl: string, query?: Record<string, string | number | boolean | undefined>): string;
+/**
+ * Formats a cURL command string representation for debugging and observability.
+ */
+export declare function generateCurlCommand(url: string, method: string, headers: Record<string, string>, body: unknown): string;
+/**
+ * Core resilient HTTP client execution with retry, backoff, tracing, and timeout.
+ */
+export declare function executeHttpRequest<T = any>(options: ExecuteHttpRequestOptions): Promise<HttpResponseResult<T>>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/client/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/client/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,uBAAuB,EAAqB,MAAM,aAAa,CAAC;AAE9G,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAgBpD,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IACxD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,CAAA;KAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG;IACzC,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,GAAG,GAAG,WAAW,GAAG,SAAS,CAmB1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC5D,MAAM,CA0BR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,OAAO,GACZ,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAC9C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAwRhC"}

package/dist/client/fetch.js

@@ -0,0 +1,330 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAbortSignal = resolveAbortSignal;
+exports.buildUrlWithQuery = buildUrlWithQuery;
+exports.generateCurlCommand = generateCurlCommand;
+exports.executeHttpRequest = executeHttpRequest;
+const core_1 = require("@siglo/core");
+const core_2 = require("@siglo/core");
+const retry_1 = require("./retry");
+const trace_1 = require("./trace");
+const asl_bridge_1 = require("../policy/asl-bridge");
+/**
+ * Resolves an AbortSignal from a candidate which could be an AbortSignal or a Siglo getter function.
+ */
+function resolveAbortSignal(candidate) {
+    if (!candidate)
+        return undefined;
+    if (typeof candidate === 'function') {
+        try {
+            const res = candidate();
+            if (res && (res instanceof AbortSignal || typeof res.addEventListener === 'function')) {
+                return res;
+            }
+        }
+        catch {
+            // Ignore getter call error
+        }
+        if (candidate.val && (candidate.val instanceof AbortSignal || typeof candidate.val.addEventListener === 'function')) {
+            return candidate.val;
+        }
+    }
+    if (candidate instanceof AbortSignal || typeof candidate.addEventListener === 'function') {
+        return candidate;
+    }
+    return undefined;
+}
+/**
+ * Builds the full URL including query parameters.
+ */
+function buildUrlWithQuery(baseUrl, query) {
+    if (!query || Object.keys(query).length === 0) {
+        return baseUrl;
+    }
+    try {
+        const url = new URL(baseUrl);
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined) {
+                url.searchParams.append(key, String(value));
+            }
+        }
+        return url.toString();
+    }
+    catch {
+        // If not a full URL (e.g. relative), use string concatenation
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined) {
+                params.append(key, String(value));
+            }
+        }
+        const queryString = params.toString();
+        if (!queryString)
+            return baseUrl;
+        const separator = baseUrl.includes('?') ? '&' : '?';
+        return `${baseUrl}${separator}${queryString}`;
+    }
+}
+/**
+ * Formats a cURL command string representation for debugging and observability.
+ */
+function generateCurlCommand(url, method, headers, body) {
+    const parts = ['curl', '-X', method.toUpperCase(), `'${url}'`];
+    for (const [key, val] of Object.entries(headers)) {
+        // Redact Authorization headers or sensitive tokens in cURL string for security
+        const sanitizedVal = key.toLowerCase() === 'authorization' || key.toLowerCase() === 'proxy-authorization'
+            ? '[REDACTED]'
+            : val;
+        parts.push(`-H '${key}: ${sanitizedVal}'`);
+    }
+    if (body !== undefined && body !== null && method.toUpperCase() !== 'GET' && method.toUpperCase() !== 'HEAD') {
+        const bodyStr = typeof body === 'string' ? body : JSON.stringify(body);
+        parts.push(`-d '${bodyStr}'`);
+    }
+    return parts.join(' ');
+}
+/**
+ * Core resilient HTTP client execution with retry, backoff, tracing, and timeout.
+ */
+async function executeHttpRequest(options) {
+    const { stepName, url: rawUrl, method = 'GET', headers: rawHeaders = {}, query, body, responseType = 'json', retryOnStatus = [...retry_1.DEFAULT_RETRY_STATUSES], maxRetries = 3, allowNotFound = false, timeoutMs, signal: rawSignal, span: customSpan, clock, sleep: customSleep, customFetch } = options;
+    const externalSignal = resolveAbortSignal(rawSignal);
+    const fetchFn = customFetch || globalThis.fetch;
+    const sleepFn = customSleep || ((ms) => new Promise(resolve => setTimeout(resolve, ms)));
+    const nowFn = clock ? clock.now.bind(clock) : () => Date.now();
+    const finalUrl = buildUrlWithQuery(rawUrl, query);
+    const hostInfo = (0, asl_bridge_1.extractHostInfo)(finalUrl);
+    const normalizedMethod = method.toUpperCase();
+    const headers = { ...rawHeaders };
+    // Set default Content-Type for JSON body if not present
+    let requestBody = undefined;
+    if (body !== undefined && body !== null && normalizedMethod !== 'GET' && normalizedMethod !== 'HEAD') {
+        const hasContentType = Object.keys(headers).some(k => k.toLowerCase() === 'content-type');
+        if (typeof body === 'object' && !(body instanceof ArrayBuffer) && !(body instanceof Uint8Array)) {
+            if (!hasContentType) {
+                headers['Content-Type'] = 'application/json';
+            }
+            requestBody = JSON.stringify(body);
+        }
+        else {
+            requestBody = body;
+        }
+    }
+    // W3C Trace context injection
+    (0, trace_1.injectTraceHeaders)(headers, customSpan);
+    const traceId = (0, trace_1.getActiveTraceId)(customSpan);
+    // Record active span attributes
+    (0, trace_1.recordRequestSpanAttributes)(normalizedMethod, finalUrl, hostInfo.hostname, customSpan);
+    const cUrl = generateCurlCommand(finalUrl, normalizedMethod, headers, body);
+    let retryAttempts = 0;
+    const startTime = nowFn();
+    while (true) {
+        const attemptStarted = nowFn();
+        let responseObserved = false;
+        let inspected = false;
+        let responseStatus;
+        const content = {
+            ...(0, core_1.captureInspection)(options.capture, 'requestHeaders', rawHeaders),
+            ...(0, core_1.captureInspection)(options.capture, 'requestBody', body),
+        };
+        const inspectAttempt = (status, retryDelayMs, retryAfterMs, retryDelaySource, failed = false) => {
+            inspected = true;
+            (0, core_1.recordInspection)({
+                version: 1, kind: 'http', outcome: !failed && status !== undefined && status < 400 ? 'success' : 'failure',
+                method: normalizedMethod, url: finalUrl, status, requestAttempt: retryAttempts + 1,
+                content, durationMs: Math.max(0, nowFn() - attemptStarted), retryDelayMs, retryAfterMs, retryDelaySource, traceId, policy: status === undefined ? 'unknown' : 'allowed'
+            });
+        };
+        // Setup cooperative AbortController combining externalSignal and step timeout
+        const controller = new AbortController();
+        let timeoutId = undefined;
+        let timedOut = false;
+        if (timeoutMs && timeoutMs > 0) {
+            timeoutId = setTimeout(() => {
+                timedOut = true;
+                controller.abort(new Error(`HTTP request timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+        }
+        const onExternalAbort = () => {
+            controller.abort(externalSignal?.reason);
+        };
+        if (externalSignal) {
+            if (externalSignal.aborted) {
+                controller.abort(externalSignal.reason);
+            }
+            else if (typeof externalSignal.addEventListener === 'function') {
+                externalSignal.addEventListener('abort', onExternalAbort, { once: true });
+            }
+        }
+        try {
+            const response = await fetchFn(finalUrl, {
+                method: normalizedMethod,
+                headers,
+                body: requestBody,
+                signal: controller.signal
+            });
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (externalSignal && typeof externalSignal.removeEventListener === 'function') {
+                externalSignal.removeEventListener('abort', onExternalAbort);
+            }
+            responseObserved = true;
+            responseStatus = response.status;
+            (0, trace_1.recordResponseSpanAttributes)(response.status, customSpan);
+            const durationMs = nowFn() - startTime;
+            const responseHeaders = {};
+            response.headers.forEach((val, key) => {
+                responseHeaders[key] = val;
+            });
+            Object.assign(content, (0, core_1.captureInspection)(options.capture, 'responseHeaders', responseHeaders));
+            const metadata = {
+                status: response.status,
+                statusText: response.statusText,
+                durationMs,
+                url: finalUrl,
+                method: normalizedMethod,
+                headers: responseHeaders,
+                traceId,
+                retryAttempts,
+                cUrl
+            };
+            const retryAfterMs = (0, retry_1.parseRetryAfter)(response.headers.get('retry-after'), nowFn);
+            // Handle 404 with allowNotFound
+            if (response.status === 404 && allowNotFound) {
+                inspectAttempt(response.status);
+                return {
+                    data: null,
+                    notFound: true,
+                    metadata
+                };
+            }
+            // Check if status is retryable (e.g. 429, 502, 503, 504)
+            if ((0, retry_1.isRetryableStatus)(response.status, retryOnStatus)) {
+                if (retryAttempts < maxRetries) {
+                    const delayMs = retryAfterMs ?? (0, retry_1.calculateBackoffDelay)(retryAttempts + 1);
+                    inspectAttempt(response.status, delayMs, retryAfterMs, retryAfterMs === undefined ? 'backoff' : 'retry-after');
+                    retryAttempts++;
+                    await sleepFn(delayMs);
+                    continue;
+                }
+                // Exhausted retries on retryable status
+                const errorText = await response.text().catch(() => '');
+                Object.assign(content, (0, core_1.captureInspection)(options.capture, 'responseBody', errorText));
+                inspectAttempt(response.status, undefined, retryAfterMs);
+                const error = new core_2.SigloError(`HTTP ${response.status} ${response.statusText}${errorText ? `: ${errorText}` : ''}`, {
+                    stepName,
+                    phase: 'action',
+                    retryable: true,
+                    status: response.status,
+                    metadata: { httpMetadata: metadata }
+                });
+                error.status = response.status;
+                error.httpMetadata = metadata;
+                throw error;
+            }
+            // Handle other non-2xx status codes (fatal client/server errors)
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => '');
+                Object.assign(content, (0, core_1.captureInspection)(options.capture, 'responseBody', errorText));
+                inspectAttempt(response.status, undefined, retryAfterMs);
+                const error = new core_2.SigloError(`HTTP ${response.status} ${response.statusText}${errorText ? `: ${errorText}` : ''}`, {
+                    stepName,
+                    phase: 'action',
+                    retryable: false,
+                    status: response.status,
+                    metadata: { httpMetadata: metadata }
+                });
+                error.status = response.status;
+                error.httpMetadata = metadata;
+                throw error;
+            }
+            // Parse successful response body
+            let parsedData;
+            if (response.status === 204) {
+                parsedData = null;
+            }
+            else if (responseType === 'text') {
+                parsedData = await response.text();
+            }
+            else if (responseType === 'blob') {
+                parsedData = await response.blob();
+            }
+            else if (responseType === 'arrayBuffer') {
+                parsedData = await response.arrayBuffer();
+            }
+            else {
+                // Default: 'json'
+                const text = await response.text();
+                Object.assign(content, (0, core_1.captureInspection)(options.capture, 'responseBody', text));
+                parsedData = text.trim().length > 0 ? JSON.parse(text) : {};
+            }
+            Object.assign(content, (0, core_1.captureInspection)(options.capture, 'responseBody', parsedData));
+            inspectAttempt(response.status, undefined, retryAfterMs);
+            return {
+                data: parsedData,
+                metadata
+            };
+        }
+        catch (err) {
+            const transportRetryDelay = !responseObserved && !timedOut && !externalSignal?.aborted &&
+                err?.name !== 'AbortError' && !err?.message?.includes('aborted') && !(err instanceof core_2.SigloError) &&
+                (0, retry_1.isTransientNetworkError)(err) && retryAttempts < maxRetries
+                ? (0, retry_1.calculateBackoffDelay)(retryAttempts + 1) : undefined;
+            if (!inspected)
+                inspectAttempt(responseStatus, transportRetryDelay, undefined, transportRetryDelay === undefined ? undefined : 'backoff', true);
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (externalSignal && typeof externalSignal.removeEventListener === 'function') {
+                externalSignal.removeEventListener('abort', onExternalAbort);
+            }
+            if (timedOut) {
+                throw new core_2.StepTimeoutException(stepName, timeoutMs || 0, {
+                    stepName,
+                    phase: 'action',
+                    cause: err
+                });
+            }
+            if (err?.name === 'AbortError' || err?.message?.includes('aborted') || externalSignal?.aborted) {
+                throw new core_2.CancellationException(err?.message || 'HTTP request aborted', {
+                    stepName,
+                    phase: 'action',
+                    cause: err
+                });
+            }
+            // If already a SigloError, rethrow
+            if (err instanceof core_2.SigloError) {
+                throw err;
+            }
+            // Check if transient network transport error
+            if ((0, retry_1.isTransientNetworkError)(err) && retryAttempts < maxRetries) {
+                retryAttempts++;
+                const delayMs = transportRetryDelay ?? (0, retry_1.calculateBackoffDelay)(retryAttempts);
+                await sleepFn(delayMs);
+                continue;
+            }
+            // Fatal network or unhandled failure
+            const durationMs = nowFn() - startTime;
+            const metadata = {
+                status: 0,
+                statusText: err?.code || 'FETCH_ERROR',
+                durationMs,
+                url: finalUrl,
+                method: normalizedMethod,
+                headers: {},
+                traceId,
+                retryAttempts,
+                cUrl
+            };
+            const error = new core_2.SigloError(`HTTP request failed to ${finalUrl}: ${err?.message || err}`, {
+                stepName,
+                phase: 'action',
+                retryable: (0, retry_1.isTransientNetworkError)(err),
+                cause: err,
+                metadata: { httpMetadata: metadata }
+            });
+            error.httpMetadata = metadata;
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/dist/client/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/client/fetch.ts"],"names":[],"mappings":";;AAgDA,gDAmBC;AAKD,8CA6BC;AAKD,kDAuBC;AAKD,gDA0RC;AAhaD,sCAA8G;AAC9G,sCAAsF;AAGtF,mCAMiB;AACjB,mCAKiB;AACjB,qDAAuD;AA4BvD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,SAAc;IAC/C,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;YACxB,IAAI,GAAG,IAAI,CAAC,GAAG,YAAY,WAAW,IAAI,OAAO,GAAG,CAAC,gBAAgB,KAAK,UAAU,CAAC,EAAE,CAAC;gBACtF,OAAO,GAAG,CAAC;YACb,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;QACD,IAAI,SAAS,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,YAAY,WAAW,IAAI,OAAO,SAAS,CAAC,GAAG,CAAC,gBAAgB,KAAK,UAAU,CAAC,EAAE,CAAC;YACpH,OAAO,SAAS,CAAC,GAAG,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,SAAS,YAAY,WAAW,IAAI,OAAO,SAAS,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACzF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,OAAe,EACf,KAA6D;IAE7D,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;QAC9D,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,WAAW;YAAE,OAAO,OAAO,CAAC;QACjC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACpD,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,EAAE,CAAC;IAChD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CACjC,GAAW,EACX,MAAc,EACd,OAA+B,EAC/B,IAAa;IAEb,MAAM,KAAK,GAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;IAEzE,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,+EAA+E;QAC/E,MAAM,YAAY,GAChB,GAAG,CAAC,WAAW,EAAE,KAAK,eAAe,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,qBAAqB;YAClF,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,GAAG,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,YAAY,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QAC7G,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACtC,OAAkC;IAElC,MAAM,EACJ,QAAQ,EACR,GAAG,EAAE,MAAM,EACX,MAAM,GAAG,KAAK,EACd,OAAO,EAAE,UAAU,GAAG,EAAE,EACxB,KAAK,EACL,IAAI,EACJ,YAAY,GAAG,MAAM,EACrB,aAAa,GAAG,CAAC,GAAG,8BAAsB,CAAC,EAC3C,UAAU,GAAG,CAAC,EACd,aAAa,GAAG,KAAK,EACrB,SAAS,EACT,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,UAAU,EAChB,KAAK,EACL,KAAK,EAAE,WAAW,EAClB,WAAW,EACZ,GAAG,OAAO,CAAC;IAEZ,MAAM,cAAc,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,WAAW,IAAI,UAAU,CAAC,KAAK,CAAC;IAChD,MAAM,OAAO,GAAG,WAAW,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACjG,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAE/D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAA,4BAAe,EAAC,QAAQ,CAAC,CAAC;IAE3C,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAgB,CAAC;IAC5D,MAAM,OAAO,GAA2B,EAAE,GAAG,UAAU,EAAE,CAAC;IAE1D,wDAAwD;IACxD,IAAI,WAAW,GAAQ,SAAS,CAAC;IACjC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,gBAAgB,KAAK,KAAK,IAAI,gBAAgB,KAAK,MAAM,EAAE,CAAC;QACrG,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,cAAc,CAAC,CAAC;QAC1F,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,YAAY,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,YAAY,UAAU,CAAC,EAAE,CAAC;YAChG,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;YAC/C,CAAC;YACD,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAA,0BAAkB,EAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAA,wBAAgB,EAAC,UAAU,CAAC,CAAC;IAE7C,gCAAgC;IAChC,IAAA,mCAA2B,EAAC,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEvF,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5E,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,MAAM,SAAS,GAAG,KAAK,EAAE,CAAC;IAE1B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,cAAc,GAAG,KAAK,EAAE,CAAC;QAC/B,IAAI,gBAAgB,GAAG,KAAK,CAAC;QAC7B,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,cAAkC,CAAC;QACvC,MAAM,OAAO,GAAsB;YACjC,GAAG,IAAA,wBAAiB,EAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,UAAU,CAAC;YACnE,GAAG,IAAA,wBAAiB,EAAC,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC;SAC3D,CAAC;QACF,MAAM,cAAc,GAAG,CAAC,MAAe,EAAE,YAAqB,EAAE,YAAqB,EAAE,gBAA4C,EAAE,MAAM,GAAG,KAAK,EAAE,EAAE;YAAG,SAAS,GAAG,IAAI,CAAC;YAAC,IAAA,uBAAgB,EAAC;gBAC3L,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;gBAC1G,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,GAAG,CAAC;gBAClF,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;aACxK,CAAC,CAAC;QAAC,CAAC,CAAC;QACN,8EAA8E;QAC9E,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,SAAS,GAAQ,SAAS,CAAC;QAC/B,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,IAAI,SAAS,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAC/B,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC1B,QAAQ,GAAG,IAAI,CAAC;gBAChB,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,gCAAgC,SAAS,IAAI,CAAC,CAAC,CAAC;YAC7E,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;QAED,MAAM,eAAe,GAAG,GAAG,EAAE;YAC3B,UAAU,CAAC,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC,CAAC;QAEF,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;gBAC3B,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAC1C,CAAC;iBAAM,IAAI,OAAO,cAAc,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;gBACjE,cAAc,CAAC,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE;gBACvC,MAAM,EAAE,gBAAgB;gBACxB,OAAO;gBACP,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,SAAS;gBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,cAAc,IAAI,OAAO,cAAc,CAAC,mBAAmB,KAAK,UAAU,EAAE,CAAC;gBAC/E,cAAc,CAAC,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YAC/D,CAAC;YAED,gBAAgB,GAAG,IAAI,CAAC;YACxB,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;YACjC,IAAA,oCAA4B,EAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAE1D,MAAM,UAAU,GAAG,KAAK,EAAE,GAAG,SAAS,CAAC;YACvC,MAAM,eAAe,GAA2B,EAAE,CAAC;YACnD,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBACpC,eAAe,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YAC7B,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAA,wBAAiB,EAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAC,CAAC;YAC/F,MAAM,QAAQ,GAAiB;gBAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,UAAU;gBACV,GAAG,EAAE,QAAQ;gBACb,MAAM,EAAE,gBAAgB;gBACxB,OAAO,EAAE,eAAe;gBACxB,OAAO;gBACP,aAAa;gBACb,IAAI;aACL,CAAC;YAEF,MAAM,YAAY,GAAG,IAAA,uBAAe,EAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,CAAC;YAEjF,gCAAgC;YAChC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;gBAC7C,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAChC,OAAO;oBACL,IAAI,EAAE,IAAW;oBACjB,QAAQ,EAAE,IAAI;oBACd,QAAQ;iBACT,CAAC;YACJ,CAAC;YAED,yDAAyD;YACzD,IAAI,IAAA,yBAAiB,EAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC;gBACtD,IAAI,aAAa,GAAG,UAAU,EAAE,CAAC;oBAC/B,MAAM,OAAO,GAAG,YAAY,IAAI,IAAA,6BAAqB,EAAC,aAAa,GAAG,CAAC,CAAC,CAAC;oBACzE,cAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;oBAC/G,aAAa,EAAE,CAAC;oBAChB,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;oBACvB,SAAS;gBACX,CAAC;gBAED,wCAAwC;gBACxC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACxD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAA,wBAAiB,EAAC,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;gBACtF,cAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;gBACzD,MAAM,KAAK,GAAG,IAAI,iBAAU,CAC1B,QAAQ,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACpF;oBACE,QAAQ;oBACR,KAAK,EAAE,QAAQ;oBACf,SAAS,EAAE,IAAI;oBACf,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,QAAQ,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE;iBACrC,CACF,CAAC;gBACD,KAAa,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;gBACvC,KAAa,CAAC,YAAY,GAAG,QAAQ,CAAC;gBACvC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,iEAAiE;YACjE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACxD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAA,wBAAiB,EAAC,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;gBACtF,cAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;gBACzD,MAAM,KAAK,GAAG,IAAI,iBAAU,CAC1B,QAAQ,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACpF;oBACE,QAAQ;oBACR,KAAK,EAAE,QAAQ;oBACf,SAAS,EAAE,KAAK;oBAChB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,QAAQ,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE;iBACrC,CACF,CAAC;gBACD,KAAa,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;gBACvC,KAAa,CAAC,YAAY,GAAG,QAAQ,CAAC;gBACvC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,iCAAiC;YACjC,IAAI,UAAe,CAAC;YACpB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;iBAAM,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;gBACnC,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrC,CAAC;iBAAM,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;gBACnC,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrC,CAAC;iBAAM,IAAI,YAAY,KAAK,aAAa,EAAE,CAAC;gBAC1C,UAAU,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,kBAAkB;gBAClB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAA,wBAAiB,EAAC,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC;gBACjF,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,CAAC;YAED,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAA,wBAAiB,EAAC,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC;YACvF,cAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;YACzD,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,QAAQ;aACT,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,mBAAmB,GAAG,CAAC,gBAAgB,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,EAAE,OAAO;gBACpF,GAAG,EAAE,IAAI,KAAK,YAAY,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,YAAY,iBAAU,CAAC;gBAChG,IAAA,+BAAuB,EAAC,GAAG,CAAC,IAAI,aAAa,GAAG,UAAU;gBACxD,CAAC,CAAC,IAAA,6BAAqB,EAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3D,IAAI,CAAC,SAAS;gBAAE,cAAc,CAAC,cAAc,EAAE,mBAAmB,EAAE,SAAS,EAC3E,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACnE,IAAI,SAAS;gBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,cAAc,IAAI,OAAO,cAAc,CAAC,mBAAmB,KAAK,UAAU,EAAE,CAAC;gBAC/E,cAAc,CAAC,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YAC/D,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,2BAAoB,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,EAAE;oBACvD,QAAQ;oBACR,KAAK,EAAE,QAAQ;oBACf,KAAK,EAAE,GAAG;iBACX,CAAC,CAAC;YACL,CAAC;YAED,IAAI,GAAG,EAAE,IAAI,KAAK,YAAY,IAAI,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC;gBAC/F,MAAM,IAAI,4BAAqB,CAAC,GAAG,EAAE,OAAO,IAAI,sBAAsB,EAAE;oBACtE,QAAQ;oBACR,KAAK,EAAE,QAAQ;oBACf,KAAK,EAAE,GAAG;iBACX,CAAC,CAAC;YACL,CAAC;YAED,mCAAmC;YACnC,IAAI,GAAG,YAAY,iBAAU,EAAE,CAAC;gBAC9B,MAAM,GAAG,CAAC;YACZ,CAAC;YAED,6CAA6C;YAC7C,IAAI,IAAA,+BAAuB,EAAC,GAAG,CAAC,IAAI,aAAa,GAAG,UAAU,EAAE,CAAC;gBAC/D,aAAa,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,mBAAmB,IAAI,IAAA,6BAAqB,EAAC,aAAa,CAAC,CAAC;gBAC5E,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;gBACvB,SAAS;YACX,CAAC;YAED,qCAAqC;YACrC,MAAM,UAAU,GAAG,KAAK,EAAE,GAAG,SAAS,CAAC;YACvC,MAAM,QAAQ,GAAiB;gBAC7B,MAAM,EAAE,CAAC;gBACT,UAAU,EAAE,GAAG,EAAE,IAAI,IAAI,aAAa;gBACtC,UAAU;gBACV,GAAG,EAAE,QAAQ;gBACb,MAAM,EAAE,gBAAgB;gBACxB,OAAO,EAAE,EAAE;gBACX,OAAO;gBACP,aAAa;gBACb,IAAI;aACL,CAAC;YAEF,MAAM,KAAK,GAAG,IAAI,iBAAU,CAAC,0BAA0B,QAAQ,KAAK,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,EAAE;gBACzF,QAAQ;gBACR,KAAK,EAAE,QAAQ;gBACf,SAAS,EAAE,IAAA,+BAAuB,EAAC,GAAG,CAAC;gBACvC,KAAK,EAAE,GAAG;gBACV,QAAQ,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE;aACrC,CAAC,CAAC;YACF,KAAa,CAAC,YAAY,GAAG,QAAQ,CAAC;YACvC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/client/retry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Parses the HTTP `Retry-After` header value into milliseconds.
+ *
+ * Supports:
+ * - Scenario A: Integer seconds (e.g. "120")
+ * - Scenario B: RFC 1123 HTTP Date (e.g. "Wed, 21 Oct 2026 07:28:00 GMT")
+ *
+ * @param headerValue The raw header string or null/undefined
+ * @param now Optional timestamp provider (useful with FakeClock in tests)
+ * @returns Delay in milliseconds, or undefined if absent/invalid
+ */
+export declare function parseRetryAfter(headerValue: string | null | undefined, now?: () => number): number | undefined;
+export declare const DEFAULT_RETRY_STATUSES: readonly number[];
+/**
+ * Checks if a given status code is configured as retryable.
+ */
+export declare function isRetryableStatus(status: number, retryOnStatus?: number[]): boolean;
+/**
+ * Checks if an error is a transient transport/network error suitable for retry.
+ */
+export declare function isTransientNetworkError(error: any): boolean;
+/**
+ * Calculates exponential backoff with full decorrelated jitter.
+ *
+ * @param attempt 0-indexed attempt count
+ * @param baseDelayMs Base delay in milliseconds (defaults to 100ms)
+ * @param maxDelayMs Maximum backoff cap (defaults to 10000ms)
+ */
+export declare function calculateBackoffDelay(attempt: number, baseDelayMs?: number, maxDelayMs?: number): number;
+//# sourceMappingURL=retry.d.ts.map

package/dist/client/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/client/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,GAAG,GAAE,MAAM,MAAyB,GACnC,MAAM,GAAG,SAAS,CAwBpB;AAED,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAyB,CAAC;AAE9E;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,EAAgC,GAAG,OAAO,CAEhH;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAsB3D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAY,EACzB,UAAU,GAAE,MAAc,GACzB,MAAM,CAIR"}

package/dist/client/retry.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RETRY_STATUSES = void 0;
+exports.parseRetryAfter = parseRetryAfter;
+exports.isRetryableStatus = isRetryableStatus;
+exports.isTransientNetworkError = isTransientNetworkError;
+exports.calculateBackoffDelay = calculateBackoffDelay;
+/**
+ * Parses the HTTP `Retry-After` header value into milliseconds.
+ *
+ * Supports:
+ * - Scenario A: Integer seconds (e.g. "120")
+ * - Scenario B: RFC 1123 HTTP Date (e.g. "Wed, 21 Oct 2026 07:28:00 GMT")
+ *
+ * @param headerValue The raw header string or null/undefined
+ * @param now Optional timestamp provider (useful with FakeClock in tests)
+ * @returns Delay in milliseconds, or undefined if absent/invalid
+ */
+function parseRetryAfter(headerValue, now = () => Date.now()) {
+    if (!headerValue || typeof headerValue !== 'string') {
+        return undefined;
+    }
+    const trimmed = headerValue.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    // Scenario A: Integer / decimal seconds (e.g. "120" or "1.5")
+    const seconds = Number(trimmed);
+    if (Number.isFinite(seconds)) {
+        return seconds >= 0 && Number.isFinite(seconds * 1000) ? Math.round(seconds * 1000) : undefined;
+    }
+    // Scenario B: RFC 1123 HTTP Date (e.g. "Wed, 21 Oct 2026 07:28:00 GMT")
+    const parsedDate = Date.parse(trimmed);
+    if (!Number.isNaN(parsedDate)) {
+        const delay = parsedDate - now();
+        return Math.max(0, delay);
+    }
+    return undefined;
+}
+exports.DEFAULT_RETRY_STATUSES = [429, 502, 503, 504];
+/**
+ * Checks if a given status code is configured as retryable.
+ */
+function isRetryableStatus(status, retryOnStatus = [...exports.DEFAULT_RETRY_STATUSES]) {
+    return retryOnStatus.includes(status);
+}
+/**
+ * Checks if an error is a transient transport/network error suitable for retry.
+ */
+function isTransientNetworkError(error) {
+    if (!error)
+        return false;
+    const code = error.code || error.cause?.code;
+    if (typeof code === 'string') {
+        const transientCodes = ['ECONNRESET', 'ETIMEDOUT', 'EAI_AGAIN', 'UND_ERR_CONNECT_TIMEOUT', 'ENOTFOUND', 'ECONNREFUSED'];
+        if (transientCodes.includes(code)) {
+            return true;
+        }
+    }
+    const message = (error.message || '').toLowerCase();
+    if (message.includes('fetch failed') ||
+        message.includes('network') ||
+        message.includes('socket hung up') ||
+        message.includes('econnreset') ||
+        message.includes('etimedout')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Calculates exponential backoff with full decorrelated jitter.
+ *
+ * @param attempt 0-indexed attempt count
+ * @param baseDelayMs Base delay in milliseconds (defaults to 100ms)
+ * @param maxDelayMs Maximum backoff cap (defaults to 10000ms)
+ */
+function calculateBackoffDelay(attempt, baseDelayMs = 100, maxDelayMs = 10000) {
+    const exponential = Math.min(maxDelayMs, baseDelayMs * Math.pow(2, attempt));
+    // Full jitter: random between 0 and exponential
+    return Math.floor(Math.random() * (exponential + 1));
+}
+//# sourceMappingURL=retry.js.map

package/dist/client/retry.js.map

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

package/dist/client/trace.d.ts

@@ -0,0 +1,23 @@
+export interface TraceContextHeaders {
+    traceparent?: string;
+    tracestate?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Injects W3C distributed trace context (traceparent and tracestate) into request headers
+ * from the active OpenTelemetry span and context.
+ */
+export declare function injectTraceHeaders(carrier?: Record<string, string>, customSpan?: any): Record<string, string>;
+/**
+ * Attaches standard HTTP semantic convention attributes to the active OpenTelemetry span.
+ */
+export declare function recordRequestSpanAttributes(method: string, url: string, serverAddress: string, customSpan?: any): void;
+/**
+ * Attaches standard response semantic convention attributes to the active OpenTelemetry span.
+ */
+export declare function recordResponseSpanAttributes(statusCode: number, customSpan?: any): void;
+/**
+ * Extracts current active traceId if present.
+ */
+export declare function getActiveTraceId(customSpan?: any): string | undefined;
+//# sourceMappingURL=trace.d.ts.map

package/dist/client/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/client/trace.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,UAAU,CAAC,EAAE,GAAG,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiCxB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,GAAG,GACf,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,GAAG,GACf,IAAI,CAeN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,CAAC,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAkBrE"}