@pellux/goodvibes-transport-http 0.18.3 → 0.30.0

package/dist/http-core.d.ts.map

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

package/dist/http-core.js

@@ -1,88 +1,90 @@
-// Synced from goodvibes-tui/src/runtime/transports/http-json-transport.ts
+import { ConfigurationError, ContractError, GoodVibesSdkError, HttpStatusError, createHttpStatusError } from '@pellux/goodvibes-errors';
 import { sleepWithSignal } from './backoff.js';
-import { mergeHeaders, resolveAuthToken, resolveHeaders } from './auth.js';
-import { getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, resolveHttpRetryPolicy, } from './retry.js';
+import { mergeHeaderRecord, normalizeAuthToken, resolveAuthToken, resolveHeaders } from './auth.js';
+import { applyPerMethodPolicy, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, resolveHttpRetryPolicy, } from './retry.js';
 import { buildUrl, createTransportPaths } from './paths.js';
+import { composeMiddleware, createUuidV4, injectTraceparentAsync, invokeTransportObserver, transportErrorFromUnknown, } from '@pellux/goodvibes-transport-core';
+/**
+ * Generate a UUID v4 idempotency key.
+ * Uses `crypto.randomUUID()` when available (Bun, browsers, Workers, Node 14.17+).
+ * Falls back to a manual RFC 4122 v4 implementation otherwise.
+ */
+export function generateIdempotencyKey() {
+    return createUuidV4();
+}
+/** Methods that are safe to send idempotency keys for (all non-GET requests). */
+const IDEMPOTENCY_KEY_METHODS = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);
 function isPlainObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
-function isRecord(value) {
-    return typeof value === 'object' && value !== null;
-}
-function applyHeaderSource(target, source) {
-    if (!source)
-        return;
-    if (source instanceof Headers) {
-        source.forEach((value, key) => {
-            target[key] = value;
-        });
-        return;
-    }
-    if (Array.isArray(source)) {
-        for (const [key, value] of source) {
-            target[key] = value;
-        }
-        return;
-    }
-    for (const [key, value] of Object.entries(source)) {
-        if (value !== undefined) {
-            target[key] = value;
-        }
-    }
-}
-function mergeHeaderRecord(...sources) {
-    const merged = {};
-    for (const source of sources) {
-        applyHeaderSource(merged, source);
+export function inferTransportHint(status, url, retryAfterMs) {
+    if (status === 0)
+        return `Transport could not reach ${url}. Verify the baseUrl is reachable.`;
+    if (status === 401)
+        return 'Check your authentication token or credentials.';
+    if (status === 403)
+        return 'Valid credentials but insufficient permissions for this operation.';
+    if (status === 404)
+        return 'The requested resource was not found.';
+    if (status === 408)
+        return 'The request timed out. Consider retrying.';
+    if (status === 429) {
+        return retryAfterMs !== undefined
+            ? `Rate limit exceeded. Retry after ${retryAfterMs}ms.`
+            : 'Rate limit exceeded. Back off and retry.';
     }
-    return merged;
+    if (status >= 500)
+        return 'Remote server error. The service may be temporarily unavailable.';
+    return undefined;
 }
-function readErrorMessage(status, url, body) {
-    if (isRecord(body) && typeof body.error === 'string' && body.error.trim()) {
-        return body.error.trim();
-    }
-    if (typeof body === 'string' && body.trim()) {
-        return body.trim();
-    }
-    return `Transport request failed with status ${status} for ${url}`;
-}
-function createTransportError(status, url, method, body) {
-    return Object.assign(new Error(readErrorMessage(status, url, body)), {
-        transport: {
-            status,
-            body,
-            url,
-            method,
-        },
+export function createTransportError(status, url, method, body, retryAfterMs) {
+    const inferred = inferTransportHint(status, url, retryAfterMs);
+    const baseError = createHttpStatusError(status, url, method, body, inferred);
+    const transportPayload = {
+        status,
+        body,
+        url,
+        method,
+        ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+    };
+    return Object.assign(baseError, {
+        transport: transportPayload,
+        ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
     });
 }
-function createNetworkTransportError(error, url, method) {
+export function createNetworkTransportError(error, url, method) {
     const message = error instanceof Error && error.message.trim()
         ? error.message.trim()
         : `Transport request failed before receiving a response for ${url}`;
-    return Object.assign(new Error(message), {
+    const hint = `Transport could not reach ${url}. Verify the baseUrl is reachable.`;
+    const networkError = new HttpStatusError(message, {
+        category: 'network',
+        source: 'transport',
+        recoverable: true,
+        url,
+        method,
+        body: { error: message },
+        hint,
         cause: error,
-        transport: {
-            status: 0,
-            body: { error: message },
-            url,
-            method,
-        },
     });
+    const transportPayload = {
+        status: 0,
+        body: { error: message },
+        url,
+        method,
+        cause: error,
+    };
+    return Object.assign(networkError, { transport: transportPayload });
 }
 function toStringValue(value, key) {
     if (value === undefined || value === null) {
-        throw new Error(`Missing required path parameter "${key}"`);
+        throw new ContractError(`Missing required path parameter "${key}". Ensure the input object includes a non-null value for this field before invoking the route.`);
     }
     return String(value);
 }
 function addQueryValue(url, key, value) {
-    if (value === undefined)
-        return;
-    if (value === null) {
-        url.searchParams.append(key, 'null');
+    if (value === undefined || value === null)
         return;
-    }
     if (Array.isArray(value)) {
         for (const item of value) {
             addQueryValue(url, key, item);
@@ -90,18 +92,28 @@ function addQueryValue(url, key, value) {
         return;
     }
     if (typeof value === 'object') {
+        // Contract query parameters are primitive or repeated primitive values.
+        // Object values are preserved as JSON strings so callers do not silently
+        // lose structured filters when a route explicitly accepts them.
         url.searchParams.append(key, JSON.stringify(value));
         return;
     }
     url.searchParams.append(key, String(value));
 }
+function hasHeader(headers, name) {
+    const normalized = name.toLowerCase();
+    return Object.keys(headers).some((key) => key.toLowerCase() === normalized);
+}
 function splitContractInput(path, input = {}) {
     const remaining = { ...input };
-    const interpolatedPath = path.replace(/\{([^}]+)\}/g, (_match, key) => {
+    const interpolatedPath = path.replace(/\{([A-Za-z_][A-Za-z0-9_.-]*)\}/g, (_match, key) => {
         const value = toStringValue(remaining[key], key);
         delete remaining[key];
         return encodeURIComponent(value);
     });
+    if (/[{}]/.test(interpolatedPath)) {
+        throw new ContractError(`Malformed contract path "${path}". Path parameters must use "{name}" with identifier-like names.`);
+    }
     return { interpolatedPath, remaining };
 }
 export function createJsonRequestInit(token, body, method = 'GET', headers = {}, signal, defaultHeaders = {}) {
@@ -117,10 +129,27 @@ export const createJsonInit = createJsonRequestInit;
 export function createFetch(fetchImpl, fallbackFetch) {
     const resolved = fetchImpl ?? fallbackFetch ?? globalThis.fetch;
     if (typeof resolved !== 'function') {
-        throw new Error('Fetch implementation is required');
+        throw new ConfigurationError('Fetch implementation is required. Pass a fetch option (e.g. options.fetch) or ensure globalThis.fetch is available in your runtime.');
     }
     return resolved.bind(globalThis);
 }
+function parseRetryAfterMs(headers) {
+    const retryAfter = headers.get('retry-after');
+    if (!retryAfter)
+        return undefined;
+    // Numeric seconds
+    const seconds = Number(retryAfter);
+    if (!Number.isNaN(seconds) && seconds >= 0) {
+        return Math.ceil(seconds * 1000);
+    }
+    // HTTP-date
+    const date = new Date(retryAfter);
+    if (!Number.isNaN(date.getTime())) {
+        const ms = date.getTime() - Date.now();
+        return ms > 0 ? ms : 0;
+    }
+    return undefined;
+}
 export async function readJsonBody(response) {
     const text = await response.text();
     if (!text.trim())
@@ -128,10 +157,16 @@ export async function readJsonBody(response) {
     try {
         return JSON.parse(text);
     }
-    catch {
+    catch (error) {
+        void error;
         return text;
     }
 }
+/**
+ * @internal Low-level one-shot helper retained for legacy internal callers.
+ * Public code should use `createHttpTransport(...).requestJson()` so auth,
+ * middleware, retry policy, idempotency keys, and observers are applied.
+ */
 export async function requestJson(fetchImpl, url, init = {}) {
     let response;
     try {
@@ -142,7 +177,8 @@ export async function requestJson(fetchImpl, url, init = {}) {
     }
     const body = await readJsonBody(response);
     if (!response.ok) {
-        throw createTransportError(response.status, url, init.method ?? 'GET', body);
+        const retryAfterMs = parseRetryAfterMs(response.headers);
+        throw createTransportError(response.status, url, init.method ?? 'GET', body, retryAfterMs);
     }
     return body;
 }
@@ -150,31 +186,156 @@ export function createHttpJsonTransport(options) {
     const baseUrl = options.baseUrl.trim();
     const fetchImpl = createFetch(options.fetchImpl, options.fetch);
     const authToken = options.authToken ?? null;
+    // Normalize at the boundary: downstream always works with a single resolver.
+    const getAuthToken = options.getAuthToken ?? normalizeAuthToken(options.authToken ?? undefined);
     const defaultHeaders = options.headers;
     const retryPolicy = options.retry;
     const paths = createTransportPaths(baseUrl);
+    const observer = options.observer;
+    // Persistent middleware chain — mutated via use().
+    const middlewareChain = [...(options.middleware ?? [])];
     const requestJsonForTransport = async (pathOrUrl, requestOptions = {}) => {
         const url = pathOrUrl.startsWith('http://') || pathOrUrl.startsWith('https://')
             ? pathOrUrl
             : buildUrl(baseUrl, pathOrUrl);
         const method = requestOptions.method ?? (requestOptions.body === undefined ? 'GET' : 'POST');
-        const resolvedRetry = resolveHttpRetryPolicy(retryPolicy, requestOptions.retry);
+        const methodId = requestOptions.methodId;
+        // Resolve idempotent flag from request options (set by contract-client from contract.idempotent).
+        const contractIdempotent = requestOptions.idempotent === true;
+        // Apply per-method retry policy override if a methodId is provided.
+        const baseRetry = resolveHttpRetryPolicy(retryPolicy, requestOptions.retry);
+        const resolvedRetry = methodId ? applyPerMethodPolicy(baseRetry, methodId) : baseRetry;
+        // Determine idempotency: non-GET mutations without an explicit idempotent flag do NOT retry.
+        // This is enforced below by gating the retry check on method type.
+        const isMutatingMethod = IDEMPOTENCY_KEY_METHODS.has(method.toUpperCase());
+        const idempotencyKey = isMutatingMethod ? generateIdempotencyKey() : undefined;
         let attempt = 0;
         while (true) {
             attempt += 1;
-            const token = await resolveAuthToken(authToken, options.getAuthToken);
-            const headers = await resolveHeaders(defaultHeaders, options.getHeaders);
+            const token = (await getAuthToken()) ?? null;
+            const resolvedHeaders = await resolveHeaders(defaultHeaders, options.getHeaders);
+            // Build merged headers record: default + per-request, then inject cross-cutting headers.
+            const mergedHeaders = mergeHeaderRecord(resolvedHeaders ?? {}, requestOptions.headers ?? {});
+            if (token) {
+                mergedHeaders['Authorization'] = `Bearer ${token}`;
+            }
+            if (requestOptions.body !== undefined) {
+                mergedHeaders['Content-Type'] = 'application/json';
+            }
+            // Inject W3C traceparent if OTel is active. This path is async so pure
+            // ESM OpenTelemetry providers can be loaded before the request is sent.
+            await injectTraceparentAsync(mergedHeaders);
+            // Inject idempotency key for mutating methods.
+            if (idempotencyKey && !hasHeader(mergedHeaders, 'Idempotency-Key')) {
+                mergedHeaders['Idempotency-Key'] = idempotencyKey;
+            }
+            // Notify observer before dispatching the request.
+            invokeTransportObserver(() => observer?.onTransportActivity?.({ direction: 'send', url, kind: 'http' }));
+            const sendAt = Date.now();
+            // Build the middleware context for this attempt.
+            const ctx = {
+                method,
+                url,
+                headers: mergedHeaders,
+                body: requestOptions.body,
+                options: requestOptions,
+                signal: requestOptions.signal,
+            };
+            // Build the inner fetch that middleware wraps (and also used directly without middleware).
+            const innerFetch = async (c) => {
+                const init = {
+                    method: c.method,
+                    credentials: 'include',
+                    signal: c.signal,
+                    headers: c.headers,
+                    ...(c.body !== undefined ? { body: JSON.stringify(c.body) } : {}),
+                };
+                let response;
+                try {
+                    response = await fetchImpl(c.url, init);
+                }
+                catch (error) {
+                    throw createNetworkTransportError(error, c.url, c.method);
+                }
+                const body = await readJsonBody(response);
+                if (!response.ok) {
+                    const retryAfterMs = parseRetryAfterMs(response.headers);
+                    throw createTransportError(response.status, c.url, c.method, body, retryAfterMs);
+                }
+                // Return synthetic Response carrying parsed body so callers can .json() it.
+                return new Response(JSON.stringify(body), { status: response.status });
+            };
             try {
-                return await requestJson(fetchImpl, url, createJsonRequestInit(token, requestOptions.body, method, mergeHeaders(headers, requestOptions.headers), requestOptions.signal));
+                if (middlewareChain.length > 0) {
+                    // Middleware path — compose chain around innerFetch.
+                    const composed = composeMiddleware(middlewareChain, innerFetch);
+                    await composed(ctx);
+                    if (ctx.error)
+                        throw ctx.error;
+                    if (!ctx.response) {
+                        throw new GoodVibesSdkError('HTTP middleware chain completed without producing a response.', {
+                            category: 'protocol',
+                            source: 'transport',
+                            recoverable: false,
+                            url,
+                            method,
+                        });
+                    }
+                    const result = await ctx.response.json();
+                    invokeTransportObserver(() => observer?.onTransportActivity?.({
+                        direction: 'recv',
+                        url,
+                        kind: 'http',
+                        durationMs: ctx.durationMs,
+                    }));
+                    return result;
+                }
+                // No-middleware fast path — directly invoke innerFetch with ctx.
+                const rawResponse = await innerFetch(ctx);
+                const result = await rawResponse.json();
+                // Notify observer after a successful response.
+                invokeTransportObserver(() => observer?.onTransportActivity?.({
+                    direction: 'recv',
+                    url,
+                    kind: 'http',
+                    durationMs: Date.now() - sendAt,
+                }));
+                return result;
             }
             catch (error) {
-                const status = typeof error === 'object' && error !== null && 'transport' in error
-                    ? error.transport?.status
+                // Wrap middleware errors as SDKError{kind:'unknown'} with middleware identity in cause.
+                // ALL errors originating from the middleware chain are wrapped — including HttpStatusError.
+                const wrappedError = (() => {
+                    if (ctx.middlewareError) {
+                        // Error came from within the middleware chain — wrap regardless of error type.
+                        const msg = transportErrorFromUnknown(error, 'transport middleware error').message;
+                        const middlewareName = ctx.activeMiddlewareName ?? 'unknown';
+                        const wrapped = new GoodVibesSdkError(`Transport middleware error: ${msg}`, {
+                            category: 'unknown',
+                            source: 'transport',
+                            recoverable: false,
+                            cause: { middleware: middlewareName, originalError: error },
+                        });
+                        return wrapped;
+                    }
+                    if (error instanceof GoodVibesSdkError)
+                        return error;
+                    return error;
+                })();
+                // Notify observer of the transport error before deciding to retry or rethrow.
+                invokeTransportObserver(() => observer?.onError?.(transportErrorFromUnknown(wrappedError, 'HTTP transport error')));
+                const status = typeof wrappedError === 'object' && wrappedError !== null && 'transport' in wrappedError
+                    ? wrappedError.transport?.status
                     : undefined;
-                const shouldRetry = attempt < resolvedRetry.maxAttempts && ((typeof status === 'number' && status > 0 && isRetryableHttpStatus(method, status, resolvedRetry))
+                // Mutating methods (POST/PUT/PATCH/DELETE) without idempotent contract mark:
+                // do NOT retry on 5xx to avoid duplicate side effects.
+                // Precedence: explicit perMethodPolicy > contract.idempotent flag > HTTP-verb default.
+                const hasPerMethodOverride = methodId !== undefined && baseRetry.perMethodPolicy[methodId] !== undefined;
+                const canRetry = !isMutatingMethod || hasPerMethodOverride || contractIdempotent;
+                const shouldRetry = canRetry && attempt < resolvedRetry.maxAttempts && ((typeof status === 'number' && status > 0 && isRetryableHttpStatus(method, status, resolvedRetry))
                     || (typeof status === 'number' && status === 0 && isRetryableNetworkError(method, resolvedRetry)));
                 if (!shouldRetry) {
-                    throw error;
+                    throw wrappedError;
                 }
                 await sleepWithSignal(getHttpRetryDelay(attempt + 1, resolvedRetry), requestOptions.signal);
             }
@@ -209,9 +370,12 @@ export function createHttpJsonTransport(options) {
             return buildUrl(baseUrl, path);
         },
         async getAuthToken() {
-            return await resolveAuthToken(authToken, options.getAuthToken);
+            return (await getAuthToken()) ?? null;
         },
         requestJson: requestJsonForTransport,
         resolveContractRequest,
+        use(middleware) {
+            middlewareChain.push(middleware);
+        },
     };
 }

package/dist/http.d.ts

@@ -2,11 +2,11 @@ import { type AuthTokenResolver, type HeaderResolver, type MaybePromise, mergeHe
 import { type BackoffPolicy, type ResolvedBackoffPolicy, computeBackoffDelay, normalizeBackoffPolicy, sleepWithSignal } from './backoff.js';
 import { type HttpRetryPolicy, type ResolvedHttpRetryPolicy, DEFAULT_HTTP_RETRY_POLICY, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, normalizeHttpRetryPolicy, resolveHttpRetryPolicy } from './retry.js';
 import { type ResolvedStreamReconnectPolicy, type StreamReconnectPolicy, DEFAULT_STREAM_RECONNECT_POLICY, getStreamReconnectDelay, normalizeStreamReconnectPolicy } from './reconnect.js';
-import { createFetch, createJsonInit, createJsonRequestInit, readJsonBody, type HttpJsonRequestOptions, type HttpJsonTransport, type HttpJsonTransportOptions, type JsonObject, type JsonValue, type ResolvedContractRequest } from './http-core.js';
-export type { AuthTokenResolver, BackoffPolicy, HeaderResolver, HttpJsonRequestOptions, HttpRetryPolicy, JsonObject, JsonValue, MaybePromise, ResolvedBackoffPolicy, ResolvedContractRequest, ResolvedHttpRetryPolicy, ResolvedStreamReconnectPolicy, StreamReconnectPolicy, };
+import { createFetch, createJsonInit, createJsonRequestInit, generateIdempotencyKey, readJsonBody, requestJson, type HttpJsonRequestOptions, type HttpJsonTransport, type HttpJsonTransportOptions, type JsonObject, type JsonValue, type ResolvedContractRequest, type TransportContext, type TransportMiddleware, type TransportJsonError } from './http-core.js';
+export type { AuthTokenResolver, BackoffPolicy, HeaderResolver, HttpJsonRequestOptions, HttpRetryPolicy, JsonObject, JsonValue, MaybePromise, ResolvedBackoffPolicy, ResolvedContractRequest, ResolvedHttpRetryPolicy, ResolvedStreamReconnectPolicy, StreamReconnectPolicy, TransportContext, TransportJsonError, TransportMiddleware, };
 export type HttpTransportOptions = HttpJsonTransportOptions;
 export type HttpTransport = HttpJsonTransport;
-export { createFetch, createJsonInit, createJsonRequestInit, readJsonBody, mergeHeaders, resolveAuthToken, resolveHeaders, computeBackoffDelay, normalizeBackoffPolicy, sleepWithSignal, DEFAULT_HTTP_RETRY_POLICY, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, normalizeHttpRetryPolicy, resolveHttpRetryPolicy, DEFAULT_STREAM_RECONNECT_POLICY, getStreamReconnectDelay, normalizeStreamReconnectPolicy, };
+export { createFetch, createJsonInit, createJsonRequestInit, generateIdempotencyKey, readJsonBody, requestJson, mergeHeaders, resolveAuthToken, resolveHeaders, computeBackoffDelay, normalizeBackoffPolicy, sleepWithSignal, DEFAULT_HTTP_RETRY_POLICY, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, normalizeHttpRetryPolicy, resolveHttpRetryPolicy, DEFAULT_STREAM_RECONNECT_POLICY, getStreamReconnectDelay, normalizeStreamReconnectPolicy, };
 export declare function normalizeTransportError(error: unknown): Error;
 export declare function createHttpTransport(options: HttpTransportOptions): HttpTransport;
 //# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC1B,+BAA+B,EAC/B,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EAEX,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,uBAAuB,EAC7B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,UAAU,EACV,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,EAC7B,qBAAqB,GACtB,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC9C,OAAO,EACL,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,+BAA+B,EAC/B,uBAAuB,EACvB,8BAA8B,GAC/B,CAAC;AAsBF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAkB7D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAmBhF"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC1B,+BAA+B,EAC/B,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EAEX,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EAEtB,YAAY,EACZ,WAAW,EACX,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,UAAU,EACV,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,EAC7B,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC9C,OAAO,EACL,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,+BAA+B,EAC/B,uBAAuB,EACvB,8BAA8B,GAC/B,CAAC;AAwBF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CA8D7D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAmBhF"}

package/dist/http.js

@@ -1,10 +1,10 @@
-import { ConfigurationError, ContractError, createHttpStatusError } from '@pellux/goodvibes-errors';
+import { ConfigurationError, ContractError, GoodVibesSdkError, HttpStatusError, createHttpStatusError } from '@pellux/goodvibes-errors';
 import { mergeHeaders, resolveAuthToken, resolveHeaders, } from './auth.js';
 import { computeBackoffDelay, normalizeBackoffPolicy, sleepWithSignal, } from './backoff.js';
 import { DEFAULT_HTTP_RETRY_POLICY, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, normalizeHttpRetryPolicy, resolveHttpRetryPolicy, } from './retry.js';
 import { DEFAULT_STREAM_RECONNECT_POLICY, getStreamReconnectDelay, normalizeStreamReconnectPolicy, } from './reconnect.js';
-import { createFetch, createHttpJsonTransport, createJsonInit, createJsonRequestInit, readJsonBody, } from './http-core.js';
-export { createFetch, createJsonInit, createJsonRequestInit, readJsonBody, mergeHeaders, resolveAuthToken, resolveHeaders, computeBackoffDelay, normalizeBackoffPolicy, sleepWithSignal, DEFAULT_HTTP_RETRY_POLICY, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, normalizeHttpRetryPolicy, resolveHttpRetryPolicy, DEFAULT_STREAM_RECONNECT_POLICY, getStreamReconnectDelay, normalizeStreamReconnectPolicy, };
+import { createFetch, createHttpJsonTransport, createJsonInit, createJsonRequestInit, generateIdempotencyKey, inferTransportHint, readJsonBody, requestJson, } from './http-core.js';
+export { createFetch, createJsonInit, createJsonRequestInit, generateIdempotencyKey, readJsonBody, requestJson, mergeHeaders, resolveAuthToken, resolveHeaders, computeBackoffDelay, normalizeBackoffPolicy, sleepWithSignal, DEFAULT_HTTP_RETRY_POLICY, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, normalizeHttpRetryPolicy, resolveHttpRetryPolicy, DEFAULT_STREAM_RECONNECT_POLICY, getStreamReconnectDelay, normalizeStreamReconnectPolicy, };
 function isTransportError(error) {
     return Boolean(error
         && typeof error === 'object'
@@ -14,10 +14,45 @@ function isTransportError(error) {
         && typeof error.transport.url === 'string');
 }
 export function normalizeTransportError(error) {
+    // Fast path: already a structured SDK error — return directly, no re-wrapping needed.
+    // Covers HttpStatusError (subclass) and GoodVibesSdkError (e.g. SSE stream errors) alike.
+    if (error instanceof GoodVibesSdkError) {
+        return error;
+    }
     if (isTransportError(error)) {
-        return createHttpStatusError(error.transport.status, error.transport.url, typeof error.transport.method === 'string' ? error.transport.method : 'GET', error.transport.body);
+        const { status, url, body, method, retryAfterMs, cause } = error.transport;
+        const resolvedMethod = typeof method === 'string' ? method : 'GET';
+        const hint = inferTransportHint(status, url, retryAfterMs);
+        if (status === 0) {
+            // Network-level failure: no HTTP response received
+            const networkError = new HttpStatusError(error instanceof Error ? error.message : `Transport could not reach ${url}`, {
+                status: undefined,
+                url,
+                method: resolvedMethod,
+                body,
+                category: 'network',
+                source: 'transport',
+                recoverable: true,
+                hint,
+                ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+            });
+            if (cause !== undefined) {
+                Object.defineProperty(networkError, 'cause', { value: cause, writable: true, configurable: true });
+            }
+            return Object.assign(networkError, { transport: error.transport });
+        }
+        const baseError = createHttpStatusError(status, url, resolvedMethod, body);
+        // Only apply inferred hint if the daemon body didn't supply one already
+        const effectiveHint = baseError.hint ?? hint;
+        return Object.assign(baseError, {
+            transport: error.transport,
+            ...(effectiveHint !== undefined ? { hint: effectiveHint } : {}),
+            ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+        });
     }
     if (error instanceof Error) {
+        // Defensive string-match fallback for non-SDK errors that slip through.
+        // With structured throws in http-core.ts, these paths are rarely exercised.
         if (error.message === 'Fetch implementation is required' || error.message === 'Transport baseUrl is required') {
             return new ConfigurationError(error.message);
         }
@@ -25,7 +60,13 @@ export function normalizeTransportError(error) {
             return new ContractError(error.message);
         }
     }
-    return error instanceof Error ? error : new Error(String(error));
+    return error instanceof Error
+        ? error
+        : new GoodVibesSdkError(`Transport operation failed with a non-Error value: ${String(error)}`, {
+            category: 'network',
+            source: 'transport',
+            recoverable: true,
+        });
 }
 export function createHttpTransport(options) {
     const transport = createHttpJsonTransport(options);

package/dist/index.d.ts

@@ -1,17 +1,21 @@
 export type { ContractInvokeOptions, ContractRouteDefinition, ContractRouteLike, ContractStreamOptions, } from './contract-client.js';
 export { buildContractInput, invokeContractRoute, openContractRouteStream, requireContractRoute, } from './contract-client.js';
-export type { HttpJsonRequestOptions, HttpTransport, HttpTransportOptions, JsonObject, JsonValue, ResolvedContractRequest, } from './http.js';
-export { createFetch, createHttpTransport, createJsonInit, createJsonRequestInit, normalizeTransportError, readJsonBody, } from './http.js';
+export type { JsonSchemaValidationFailure, MethodArgs, RequiredKeys, WithoutKeys } from './client-plumbing.js';
+export { clientInputRecord, firstJsonSchemaFailure, mergeClientInput, splitClientArgs } from './client-plumbing.js';
+export type { HttpJsonRequestOptions, HttpTransport, HttpTransportOptions, JsonObject, JsonValue, ResolvedContractRequest, TransportJsonError, } from './http.js';
+export { createFetch, createHttpTransport, createJsonInit, createJsonRequestInit, normalizeTransportError, readJsonBody, requestJson, } from './http.js';
+export type { TransportContext, TransportMiddleware } from './http-core.js';
+export { generateIdempotencyKey } from './http-core.js';
 export type { ServerSentEventHandlers, ServerSentEventOptions } from './sse.js';
 export { openServerSentEventStream } from './sse.js';
 export type { ServerSentEventHandlers as RawServerSentEventHandlers, ServerSentEventOptions as RawServerSentEventOptions } from './sse-stream.js';
-export { openServerSentEventStream as openRawServerSentEventStream } from './sse-stream.js';
-export type { AuthTokenResolver, HeaderResolver, MaybePromise } from './auth.js';
-export { mergeHeaders, resolveAuthToken, resolveHeaders } from './auth.js';
+export { openRawServerSentEventStream } from './sse-stream.js';
+export type { AuthTokenInput, AuthTokenResolver, HeaderResolver, MaybePromise } from './auth.js';
+export { mergeHeaderRecord, mergeHeaders, normalizeAuthToken, resolveAuthToken, resolveHeaders } from './auth.js';
 export type { BackoffPolicy, ResolvedBackoffPolicy } from './backoff.js';
 export { computeBackoffDelay, normalizeBackoffPolicy, sleepWithSignal } from './backoff.js';
-export type { HttpRetryPolicy, ResolvedHttpRetryPolicy } from './retry.js';
-export { DEFAULT_HTTP_RETRY_POLICY, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, normalizeHttpRetryPolicy, resolveHttpRetryPolicy } from './retry.js';
+export type { HttpRetryPolicy, PerMethodRetryPolicy, ResolvedHttpRetryPolicy } from './retry.js';
+export { DEFAULT_HTTP_RETRY_POLICY, applyPerMethodPolicy, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, normalizeHttpRetryPolicy, resolveHttpRetryPolicy } from './retry.js';
 export type { StreamReconnectPolicy, ResolvedStreamReconnectPolicy } from './reconnect.js';
 export { DEFAULT_STREAM_RECONNECT_POLICY, getStreamReconnectDelay, normalizeStreamReconnectPolicy } from './reconnect.js';
 export type { TransportPaths } from './paths.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,uBAAuB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EAAE,uBAAuB,IAAI,0BAA0B,EAAE,sBAAsB,IAAI,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAClJ,OAAO,EAAE,yBAAyB,IAAI,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3E,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC5F,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC5K,YAAY,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,+BAA+B,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAC1H,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,2BAA2B,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC/G,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpH,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EAAE,uBAAuB,IAAI,0BAA0B,EAAE,sBAAsB,IAAI,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAClJ,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAClH,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC5F,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAClM,YAAY,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,+BAA+B,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAC1H,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,9 +1,11 @@
 export { buildContractInput, invokeContractRoute, openContractRouteStream, requireContractRoute, } from './contract-client.js';
-export { createFetch, createHttpTransport, createJsonInit, createJsonRequestInit, normalizeTransportError, readJsonBody, } from './http.js';
+export { clientInputRecord, firstJsonSchemaFailure, mergeClientInput, splitClientArgs } from './client-plumbing.js';
+export { createFetch, createHttpTransport, createJsonInit, createJsonRequestInit, normalizeTransportError, readJsonBody, requestJson, } from './http.js';
+export { generateIdempotencyKey } from './http-core.js';
 export { openServerSentEventStream } from './sse.js';
-export { openServerSentEventStream as openRawServerSentEventStream } from './sse-stream.js';
-export { mergeHeaders, resolveAuthToken, resolveHeaders } from './auth.js';
+export { openRawServerSentEventStream } from './sse-stream.js';
+export { mergeHeaderRecord, mergeHeaders, normalizeAuthToken, resolveAuthToken, resolveHeaders } from './auth.js';
 export { computeBackoffDelay, normalizeBackoffPolicy, sleepWithSignal } from './backoff.js';
-export { DEFAULT_HTTP_RETRY_POLICY, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, normalizeHttpRetryPolicy, resolveHttpRetryPolicy } from './retry.js';
+export { DEFAULT_HTTP_RETRY_POLICY, applyPerMethodPolicy, getHttpRetryDelay, isRetryableHttpStatus, isRetryableNetworkError, normalizeHttpRetryPolicy, resolveHttpRetryPolicy } from './retry.js';
 export { DEFAULT_STREAM_RECONNECT_POLICY, getStreamReconnectDelay, normalizeStreamReconnectPolicy } from './reconnect.js';
 export { buildUrl, createTransportPaths, normalizeBaseUrl } from './paths.js';

package/dist/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CA8BpE"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CA8BpE"}

package/dist/paths.js

@@ -1,9 +1,10 @@
+import { ConfigurationError } from '@pellux/goodvibes-errors';
 export function normalizeBaseUrl(baseUrl) {
     const normalized = baseUrl.trim();
     if (!normalized) {
-        throw new Error('Transport baseUrl is required');
+        throw new ConfigurationError('Transport baseUrl is required. Pass a non-empty baseUrl string to your transport or SDK options.', { code: 'SDK_TRANSPORT_BASE_URL_REQUIRED' });
     }
-    return normalized.endsWith('/') ? normalized.slice(0, -1) : normalized;
+    return normalized.replace(/\/+$/, '');
 }
 export function buildUrl(baseUrl, path) {
     const normalized = normalizeBaseUrl(baseUrl);

package/dist/reconnect.d.ts

@@ -5,6 +5,8 @@ export interface StreamReconnectPolicy extends BackoffPolicy {
 export interface ResolvedStreamReconnectPolicy extends ResolvedBackoffPolicy {
     readonly enabled: boolean;
 }
+/** Maximum reconnect attempts when reconnect is enabled and the caller does not set a limit. */
+export declare const DEFAULT_STREAM_MAX_ATTEMPTS = 10;
 export declare const DEFAULT_STREAM_RECONNECT_POLICY: ResolvedStreamReconnectPolicy;
 export declare function normalizeStreamReconnectPolicy(policy?: StreamReconnectPolicy): ResolvedStreamReconnectPolicy;
 export declare function getStreamReconnectDelay(attempt: number, policy: ResolvedStreamReconnectPolicy): number;