magicbell-js 1.5.0 → 1.7.0

package/dist/commonjs/user-client/http/transport/request-fetch-adapter.js

@@ -3,6 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RequestFetchAdapter = void 0;
 const error_js_1 = require("../error.js");
 const line_decoder_js_1 = require("../utils/line-decoder.js");
+/**
+ * Fetch API-based HTTP adapter for executing requests.
+ * Uses the native Fetch API to provide a consistent interface for both regular and streaming requests.
+ * Handles headers, cookies, timeouts with AbortSignal, and error responses.
+ *
+ * @template T - The expected response type
+ */
 class RequestFetchAdapter {
     constructor(request) {
         Object.defineProperty(this, "request", {
@@ -19,9 +26,16 @@ class RequestFetchAdapter {
         });
         this.setMethod(request.method);
         this.setHeaders(request.getHeaders());
+        this.setCookies(request.getCookies());
         this.setBody(request.body);
         this.setTimeout(request.config.timeoutMs);
     }
+    /**
+     * Executes the HTTP request and returns the response.
+     * Fetches the full response body as an ArrayBuffer.
+     *
+     * @returns A promise resolving to the HTTP response with metadata and body
+     */
     async send() {
         const response = await fetch(this.request.constructFullUrl(), this.requestInit);
         const metadata = {
@@ -34,6 +48,13 @@ class RequestFetchAdapter {
             raw: await response.clone().arrayBuffer(),
         };
     }
+    /**
+     * Executes the HTTP request as a stream, yielding chunks as they arrive.
+     * Uses the Fetch API's ReadableStream and LineDecoder to split into lines.
+     *
+     * @returns An async generator yielding HTTP response chunks
+     * @throws Error if responseHeaders is enabled (streaming not supported with responseHeaders)
+     */
     async *stream() {
         const response = await fetch(this.request.constructFullUrl(), this.requestInit);
         const metadata = {
@@ -98,6 +119,22 @@ class RequestFetchAdapter {
             headers,
         };
     }
+    setCookies(cookies) {
+        if (!cookies || Object.keys(cookies).length === 0) {
+            return;
+        }
+        // Serialize cookies as a Cookie header
+        const cookieString = Object.entries(cookies)
+            .map(([key, value]) => `${key}=${value}`)
+            .join('; ');
+        this.requestInit = {
+            ...this.requestInit,
+            headers: {
+                ...this.requestInit.headers,
+                Cookie: cookieString,
+            },
+        };
+    }
     setTimeout(timeoutMs) {
         if (!timeoutMs) {
             return;

package/dist/commonjs/user-client/http/transport/request-fetch-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"request-fetch-adapter.js","sourceRoot":"","sources":["../../../../../src/user-client/http/transport/request-fetch-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"request-fetch-adapter.js","sourceRoot":"","sources":["../../../../../src/user-client/http/transport/request-fetch-adapter.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/user-client/http/transport/request.d.ts

@@ -2,11 +2,19 @@ import { ZodType } from 'zod';
 import { HttpRequest } from '../hooks/hook.js';
 import { ContentType, HttpMethod, RetryOptions, SdkConfig, ValidationOptions } from '../types.js';
 import { CreateRequestParameters, ErrorDefinition, RequestCursorPagination, RequestPagination, RequestParameter, ResponseDefinition } from './types.js';
+/**
+ * Represents an HTTP request with all necessary configuration and parameters.
+ * Handles path/query/header/cookie serialization, pagination, validation, and retry logic.
+ * This is the core request object passed through the handler chain for execution.
+ *
+ * @template PageSchema - The type of paginated data returned by this request
+ */
 export declare class Request<PageSchema = unknown[]> {
     baseUrl: string;
     headers: Map<string, RequestParameter>;
     queryParams: Map<string, RequestParameter>;
     pathParams: Map<string, RequestParameter>;
+    cookies: Map<string, RequestParameter>;
     body?: any;
     method: HttpMethod;
     path: string;
@@ -22,14 +30,73 @@ export declare class Request<PageSchema = unknown[]> {
     filenames?: string[];
     private readonly pathPattern;
     constructor(params: CreateRequestParameters<PageSchema>);
+    /**
+     * Adds a header parameter to the request with OpenAPI serialization rules.
+     *
+     * @param key - The header name
+     * @param param - The parameter configuration including value, style, and encoding options
+     */
     addHeaderParam(key: string, param: RequestParameter): void;
+    /**
+     * Adds a query parameter to the request with OpenAPI serialization rules.
+     *
+     * @param key - The query parameter name
+     * @param param - The parameter configuration including value, style, and encoding options
+     */
     addQueryParam(key: string, param: RequestParameter): void;
+    /**
+     * Adds a path parameter to the request with OpenAPI serialization rules.
+     *
+     * @param key - The path parameter name (matches template variable in path pattern)
+     * @param param - The parameter configuration including value, style, and encoding options
+     */
     addPathParam(key: string, param: RequestParameter): void;
+    /**
+     * Sets the request body if the value is defined.
+     *
+     * @param body - The request body to send
+     */
     addBody(body: any): void;
+    /**
+     * Updates this request from a modified hook request.
+     * Used after hooks modify the request to sync changes back to the internal Request object.
+     *
+     * @param hookRequest - The modified request from hook processing
+     */
     updateFromHookRequest(hookRequest: HttpRequest): void;
+    /**
+     * Constructs the complete URL by combining base URL, path with substituted parameters,
+     * and serialized query string.
+     *
+     * @returns The fully constructed URL ready for HTTP execution
+     */
     constructFullUrl(): string;
+    /**
+     * Creates a copy of this request with optional parameter overrides.
+     * Useful for pagination where you need to modify parameters while keeping the rest intact.
+     *
+     * @param overrides - Optional parameters to override in the copied request
+     * @returns A new Request instance with the specified overrides
+     */
     copy(overrides?: Partial<CreateRequestParameters>): Request<unknown[]>;
+    /**
+     * Serializes headers to a format suitable for HTTP execution.
+     *
+     * @returns Serialized headers as HeadersInit, or undefined if no headers
+     */
     getHeaders(): HeadersInit | undefined;
+    /**
+     * Serializes cookies to a format suitable for HTTP execution.
+     *
+     * @returns Serialized cookies as a record, or undefined if no cookies
+     */
+    getCookies(): Record<string, string> | undefined;
+    /**
+     * Advances pagination parameters to fetch the next page.
+     * Handles both cursor-based and limit-offset pagination strategies.
+     *
+     * @param cursor - The cursor value for cursor-based pagination (optional for limit-offset)
+     */
     nextPage(cursor?: string): void;
     private constructPath;
     private getOffsetParam;

package/dist/commonjs/user-client/http/transport/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../../../src/user-client/http/transport/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAK/C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,EACL,uBAAuB,EACvB,eAAe,EAEf,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,OAAO,CAAC,UAAU,GAAG,OAAO,EAAE;IAClC,OAAO,SAAM;IAEb,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAa;IAEnD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAa;IAEvD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAa;IAEtD,IAAI,CAAC,EAAE,GAAG,CAAC;IAEX,MAAM,EAAE,UAAU,CAAC;IAEnB,IAAI,EAAE,MAAM,CAAC;IAEb,MAAM,EAAE,SAAS,CAAC;IAElB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAEhC,MAAM,EAAE,eAAe,EAAE,CAAC;IAE1B,aAAa,EAAE,OAAO,CAAC;IAEvB,kBAAkB,EAAE,WAAW,CAAC;IAEhC,UAAU,EAAE,iBAAiB,CAAa;IAE1C,KAAK,EAAE,YAAY,CAAa;IAEhC,UAAU,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAEjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,MAAM,EAAE,uBAAuB,CAAC,UAAU,CAAC;IAqBvD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAoB1D,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAoBzD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAoBxD,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAQjB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAOrD,gBAAgB,IAAI,MAAM;IAQ1B,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAyBjD,UAAU,IAAI,WAAW,GAAG,SAAS;IAQrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBtC,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;CAiBrB"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../../../src/user-client/http/transport/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,EACL,uBAAuB,EACvB,eAAe,EAEf,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,qBAAa,OAAO,CAAC,UAAU,GAAG,OAAO,EAAE;IAClC,OAAO,SAAM;IAEb,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAa;IAEnD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAa;IAEvD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAa;IAEtD,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAa;IAEnD,IAAI,CAAC,EAAE,GAAG,CAAC;IAEX,MAAM,EAAE,UAAU,CAAC;IAEnB,IAAI,EAAE,MAAM,CAAC;IAEb,MAAM,EAAE,SAAS,CAAC;IAElB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAEhC,MAAM,EAAE,eAAe,EAAE,CAAC;IAE1B,aAAa,EAAE,OAAO,CAAC;IAEvB,kBAAkB,EAAE,WAAW,CAAC;IAEhC,UAAU,EAAE,iBAAiB,CAAa;IAE1C,KAAK,EAAE,YAAY,CAAa;IAEhC,UAAU,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAEjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,MAAM,EAAE,uBAAuB,CAAC,UAAU,CAAC;IAsBvD;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAoB1D;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAoBzD;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAoBxD;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAQxB;;;;;OAKG;IACI,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAO5D;;;;;OAKG;IACI,gBAAgB,IAAI,MAAM;IAQjC;;;;;;OAMG;IACI,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IA0BxD;;;;OAIG;IACI,UAAU,IAAI,WAAW,GAAG,SAAS;IAQ5C;;;;OAIG;IACI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAQvD;;;;;OAKG;IACI,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBtC,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;CAqBrB"}

package/dist/commonjs/user-client/http/transport/request.js

@@ -2,10 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Request = void 0;
 const base_serializer_js_1 = require("../serialization/base-serializer.js");
+const cookie_serializer_js_1 = require("../serialization/cookie-serializer.js");
 const header_serializer_js_1 = require("../serialization/header-serializer.js");
 const path_serializer_js_1 = require("../serialization/path-serializer.js");
 const query_serializer_js_1 = require("../serialization/query-serializer.js");
 const types_js_1 = require("./types.js");
+/**
+ * Represents an HTTP request with all necessary configuration and parameters.
+ * Handles path/query/header/cookie serialization, pagination, validation, and retry logic.
+ * This is the core request object passed through the handler chain for execution.
+ *
+ * @template PageSchema - The type of paginated data returned by this request
+ */
 class Request {
     constructor(params) {
         Object.defineProperty(this, "baseUrl", {
@@ -32,6 +40,12 @@ class Request {
             writable: true,
             value: new Map()
         });
+        Object.defineProperty(this, "cookies", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
         Object.defineProperty(this, "body", {
             enumerable: true,
             configurable: true,
@@ -125,6 +139,7 @@ class Request {
         this.pathParams = params.pathParams;
         this.headers = params.headers;
         this.queryParams = params.queryParams;
+        this.cookies = params.cookies;
         this.responses = params.responses;
         this.errors = params.errors;
         this.requestSchema = params.requestSchema;
@@ -135,6 +150,12 @@ class Request {
         this.filename = params.filename;
         this.filenames = params.filenames;
     }
+    /**
+     * Adds a header parameter to the request with OpenAPI serialization rules.
+     *
+     * @param key - The header name
+     * @param param - The parameter configuration including value, style, and encoding options
+     */
     addHeaderParam(key, param) {
         if (param.value === undefined) {
             return;
@@ -150,6 +171,12 @@ class Request {
         }
         this.headers.set(key, param);
     }
+    /**
+     * Adds a query parameter to the request with OpenAPI serialization rules.
+     *
+     * @param key - The query parameter name
+     * @param param - The parameter configuration including value, style, and encoding options
+     */
     addQueryParam(key, param) {
         if (param.value === undefined) {
             return;
@@ -165,6 +192,12 @@ class Request {
         }
         this.queryParams.set(key, param);
     }
+    /**
+     * Adds a path parameter to the request with OpenAPI serialization rules.
+     *
+     * @param key - The path parameter name (matches template variable in path pattern)
+     * @param param - The parameter configuration including value, style, and encoding options
+     */
     addPathParam(key, param) {
         if (param.value === undefined) {
             return;
@@ -180,26 +213,50 @@ class Request {
         }
         this.pathParams.set(key, param);
     }
+    /**
+     * Sets the request body if the value is defined.
+     *
+     * @param body - The request body to send
+     */
     addBody(body) {
         if (body === undefined) {
             return;
         }
         this.body = body;
     }
+    /**
+     * Updates this request from a modified hook request.
+     * Used after hooks modify the request to sync changes back to the internal Request object.
+     *
+     * @param hookRequest - The modified request from hook processing
+     */
     updateFromHookRequest(hookRequest) {
         this.baseUrl = hookRequest.baseUrl;
         this.method = hookRequest.method;
         this.path = hookRequest.path;
         this.body = hookRequest.body;
     }
+    /**
+     * Constructs the complete URL by combining base URL, path with substituted parameters,
+     * and serialized query string.
+     *
+     * @returns The fully constructed URL ready for HTTP execution
+     */
     constructFullUrl() {
         const queryString = new query_serializer_js_1.QuerySerializer().serialize(this.queryParams);
         const path = this.constructPath();
         const baseUrl = this.baseUrl;
         return `${baseUrl}${path}${queryString}`;
     }
+    /**
+     * Creates a copy of this request with optional parameter overrides.
+     * Useful for pagination where you need to modify parameters while keeping the rest intact.
+     *
+     * @param overrides - Optional parameters to override in the copied request
+     * @returns A new Request instance with the specified overrides
+     */
     copy(overrides) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
         const createRequestParams = {
             baseUrl: (_a = overrides === null || overrides === void 0 ? void 0 : overrides.baseUrl) !== null && _a !== void 0 ? _a : this.baseUrl,
             errors: (_b = overrides === null || overrides === void 0 ? void 0 : overrides.errors) !== null && _b !== void 0 ? _b : this.errors,
@@ -210,25 +267,48 @@ class Request {
             pathParams: (_g = overrides === null || overrides === void 0 ? void 0 : overrides.pathParams) !== null && _g !== void 0 ? _g : this.pathParams,
             queryParams: (_h = overrides === null || overrides === void 0 ? void 0 : overrides.queryParams) !== null && _h !== void 0 ? _h : this.queryParams,
             headers: (_j = overrides === null || overrides === void 0 ? void 0 : overrides.headers) !== null && _j !== void 0 ? _j : this.headers,
-            responses: (_k = overrides === null || overrides === void 0 ? void 0 : overrides.responses) !== null && _k !== void 0 ? _k : this.responses,
-            requestSchema: (_l = overrides === null || overrides === void 0 ? void 0 : overrides.requestSchema) !== null && _l !== void 0 ? _l : this.requestSchema,
-            requestContentType: (_m = overrides === null || overrides === void 0 ? void 0 : overrides.requestContentType) !== null && _m !== void 0 ? _m : this.requestContentType,
-            retry: (_o = overrides === null || overrides === void 0 ? void 0 : overrides.retry) !== null && _o !== void 0 ? _o : this.retry,
-            validation: (_p = overrides === null || overrides === void 0 ? void 0 : overrides.validation) !== null && _p !== void 0 ? _p : this.validation,
-            filename: (_q = overrides === null || overrides === void 0 ? void 0 : overrides.filename) !== null && _q !== void 0 ? _q : this.filename,
-            filenames: (_r = overrides === null || overrides === void 0 ? void 0 : overrides.filenames) !== null && _r !== void 0 ? _r : this.filenames,
+            cookies: (_k = overrides === null || overrides === void 0 ? void 0 : overrides.cookies) !== null && _k !== void 0 ? _k : this.cookies,
+            responses: (_l = overrides === null || overrides === void 0 ? void 0 : overrides.responses) !== null && _l !== void 0 ? _l : this.responses,
+            requestSchema: (_m = overrides === null || overrides === void 0 ? void 0 : overrides.requestSchema) !== null && _m !== void 0 ? _m : this.requestSchema,
+            requestContentType: (_o = overrides === null || overrides === void 0 ? void 0 : overrides.requestContentType) !== null && _o !== void 0 ? _o : this.requestContentType,
+            retry: (_p = overrides === null || overrides === void 0 ? void 0 : overrides.retry) !== null && _p !== void 0 ? _p : this.retry,
+            validation: (_q = overrides === null || overrides === void 0 ? void 0 : overrides.validation) !== null && _q !== void 0 ? _q : this.validation,
+            filename: (_r = overrides === null || overrides === void 0 ? void 0 : overrides.filename) !== null && _r !== void 0 ? _r : this.filename,
+            filenames: (_s = overrides === null || overrides === void 0 ? void 0 : overrides.filenames) !== null && _s !== void 0 ? _s : this.filenames,
         };
         return new Request({
             ...createRequestParams,
             ...overrides,
         });
     }
+    /**
+     * Serializes headers to a format suitable for HTTP execution.
+     *
+     * @returns Serialized headers as HeadersInit, or undefined if no headers
+     */
     getHeaders() {
         if (!this.headers || !this.headers.size) {
             return undefined;
         }
         return new header_serializer_js_1.HeaderSerializer().serialize(this.headers);
     }
+    /**
+     * Serializes cookies to a format suitable for HTTP execution.
+     *
+     * @returns Serialized cookies as a record, or undefined if no cookies
+     */
+    getCookies() {
+        if (!this.cookies || !this.cookies.size) {
+            return undefined;
+        }
+        return new cookie_serializer_js_1.CookieSerializer().serialize(this.cookies);
+    }
+    /**
+     * Advances pagination parameters to fetch the next page.
+     * Handles both cursor-based and limit-offset pagination strategies.
+     *
+     * @param cursor - The cursor value for cursor-based pagination (optional for limit-offset)
+     */
     nextPage(cursor) {
         if (!this.pagination) {
             return;
@@ -272,6 +352,9 @@ class Request {
         this.pathParams.forEach((val, _) => {
             allParams.push(val);
         });
+        this.cookies.forEach((val, _) => {
+            allParams.push(val);
+        });
         return allParams;
     }
 }

package/dist/commonjs/user-client/http/transport/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../../../src/user-client/http/transport/request.ts"],"names":[],"mappings":";;;AAGA,4EAAyE;AACzE,gFAAyE;AACzE,4EAAqE;AACrE,8EAAuE;AAEvE,yCAQoB;AAEpB,MAAa,OAAO;IAqClB,YAAY,MAA2C;QApChD;;;;mBAAU,EAAE;WAAC;QAEb;;;;mBAAyC,IAAI,GAAG,EAAE;WAAC;QAEnD;;;;mBAA6C,IAAI,GAAG,EAAE;WAAC;QAEvD;;;;mBAA4C,IAAI,GAAG,EAAE;WAAC;QAEtD;;;;;WAAW;QAEX;;;;;WAAmB;QAEnB;;;;;WAAa;QAEb;;;;;WAAkB;QAElB;;;;;WAAgC;QAEhC;;;;;WAA0B;QAE1B;;;;;WAAuB;QAEvB;;;;;WAAgC;QAEhC;;;;mBAAgC,EAAS;WAAC;QAE1C;;;;mBAAsB,EAAS;WAAC;QAEhC;;;;;WAAiF;QAEjF;;;;;WAAkB;QAElB;;;;;WAAqB;QAEX;;;;;WAAoB;QAGnC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC;QACpD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACpC,CAAC;IAED,cAAc,CAAC,GAAW,EAAE,KAAuB;QACjD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;QACxB,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,KAAK,GAAG,uCAAkB,CAAC,MAAM,CAAC;QAC1C,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,aAAa,CAAC,GAAW,EAAE,KAAuB;QAChD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,KAAK,GAAG,uCAAkB,CAAC,IAAI,CAAC;QACxC,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,YAAY,CAAC,GAAW,EAAE,KAAuB;QAC/C,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;QACxB,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,KAAK,GAAG,uCAAkB,CAAC,MAAM,CAAC;QAC1C,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,CAAC,IAAS;QACf,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEM,qBAAqB,CAAC,WAAwB;QACnD,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;IAEM,gBAAgB;QACrB,MAAM,WAAW,GAAG,IAAI,qCAAe,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3C,CAAC;IAEM,IAAI,CAAC,SAA4C;;QACtD,MAAM,mBAAmB,GAA4B;YACnD,OAAO,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,OAAO,mCAAI,IAAI,CAAC,OAAO;YAC3C,MAAM,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,MAAM,mCAAI,IAAI,CAAC,MAAM;YACxC,MAAM,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,MAAM,mCAAI,IAAI,CAAC,MAAM;YACxC,IAAI,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,IAAI,mCAAI,IAAI,CAAC,IAAI;YAClC,IAAI,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,IAAI,mCAAI,IAAI,CAAC,IAAI;YAClC,MAAM,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,MAAM,mCAAI,IAAI,CAAC,MAAM;YACxC,UAAU,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,mCAAI,IAAI,CAAC,UAAU;YACpD,WAAW,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,WAAW,mCAAI,IAAI,CAAC,WAAW;YACvD,OAAO,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,OAAO,mCAAI,IAAI,CAAC,OAAO;YAC3C,SAAS,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,SAAS,mCAAI,IAAI,CAAC,SAAS;YACjD,aAAa,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,aAAa,mCAAI,IAAI,CAAC,aAAa;YAC7D,kBAAkB,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,kBAAkB,mCAAI,IAAI,CAAC,kBAAkB;YAC5E,KAAK,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,KAAK,mCAAI,IAAI,CAAC,KAAK;YACrC,UAAU,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,mCAAI,IAAI,CAAC,UAAU;YACpD,QAAQ,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,QAAQ,mCAAI,IAAI,CAAC,QAAQ;YAC9C,SAAS,EAAE,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,SAAS,mCAAI,IAAI,CAAC,SAAS;SAClD,CAAC;QACF,OAAO,IAAI,OAAO,CAAC;YACjB,GAAG,mBAAmB;YACtB,GAAG,SAAS;SACb,CAAC,CAAC;IACL,CAAC;IAEM,UAAU;QACf,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,uCAAgB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IAEM,QAAQ,CAAC,MAAe;QAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,sDAAsD;QACtD,IAAI,IAAA,oCAAyB,EAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,IAAI,WAAW,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACxC,WAAW,CAAC,KAAK,GAAG,MAAM,CAAC;YAC7B,CAAC;YACD,OAAO;QACT,CAAC;QAED,iCAAiC;QACjC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1C,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACtE,CAAC;YACD,WAAW,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC3E,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,OAAO,IAAI,mCAAc,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3E,CAAC;IAEO,cAAc;QACpB,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxE,OAAO,WAAW,CAAC;IACrB,CAAC;IAEO,cAAc;QACpB,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxE,OAAO,WAAW,CAAC;IACrB,CAAC;IAEO,YAAY;QAClB,MAAM,SAAS,GAAuB,EAAE,CAAC;QAEzC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAC9B,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAClC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACjC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AArOD,0BAqOC"}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../../../src/user-client/http/transport/request.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/user-client/http/transport/transport-hook-adapter.d.ts

@@ -1,12 +1,62 @@
 import { HttpError } from '../hooks/hook.js';
 import { HttpResponse } from '../types.js';
 import { Request } from './request.js';
+/**
+ * Adapter that bridges between the internal Request representation and the Hook interface.
+ * Converts Request objects to HttpRequest format for hook processing, then converts
+ * modified HttpRequest objects back to Request format.
+ *
+ * @template T - The expected response type
+ */
 export declare class TransportHookAdapter<T> {
     private hook;
+    /**
+     * Invokes the custom hook before sending the request.
+     * Converts the Request to HttpRequest format, calls the hook, then converts back.
+     *
+     * @param request - The internal Request object
+     * @param params - Additional parameters to pass to the hook
+     * @returns The modified Request after hook processing
+     */
     beforeRequest(request: Request, params: Map<string, string>): Promise<Request>;
+    /**
+     * Invokes the custom hook after receiving a response.
+     * Converts the Request to HttpRequest format and calls the hook with the response.
+     *
+     * @param request - The internal Request object
+     * @param response - The HTTP response received
+     * @param params - Additional parameters to pass to the hook
+     * @returns The potentially modified response after hook processing
+     */
     afterResponse(request: Request, response: HttpResponse<T>, params: Map<string, string>): Promise<HttpResponse<T>>;
+    /**
+     * Invokes the custom hook when an error occurs.
+     * Converts the Request to HttpRequest format and calls the error hook.
+     *
+     * @param request - The internal Request object
+     * @param response - The HTTP response that triggered the error
+     * @param params - Additional parameters to pass to the hook
+     * @returns The HttpError from the hook
+     */
     onError(request: Request, response: HttpResponse<T>, params: Map<string, string>): Promise<HttpError>;
+    /**
+     * Converts the internal Request representation to the hook's HttpRequest format.
+     * Extracts parameter values from RequestParameter wrappers.
+     *
+     * @param request - The internal Request object
+     * @returns An HttpRequest object for hook processing
+     */
     private requestToHookRequest;
+    /**
+     * Converts hook parameter maps back to RequestParameter format.
+     * Preserves serialization metadata from the original parameters.
+     *
+     * @template T - The parameter value type
+     * @param hookParams - The parameter map from hook processing
+     * @param originalTransportParams - The original RequestParameter map for metadata
+     * @param encode - Whether to encode the parameters
+     * @returns A map of RequestParameter objects for transport
+     */
     private hookParamsToTransportParams;
 }
 //# sourceMappingURL=transport-hook-adapter.d.ts.map

package/dist/commonjs/user-client/http/transport/transport-hook-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport-hook-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/user-client/http/transport/transport-hook-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAe,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,qBAAa,oBAAoB,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAgC;IAE/B,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB9E,aAAa,CACxB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAKd,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAKlH,OAAO,CAAC,oBAAoB;IA4B5B,OAAO,CAAC,2BAA2B;CAqBpC"}
+{"version":3,"file":"transport-hook-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/user-client/http/transport/transport-hook-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAe,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;;;;;GAMG;AACH,qBAAa,oBAAoB,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAgC;IAE5C;;;;;;;OAOG;IACU,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB3F;;;;;;;;OAQG;IACU,aAAa,CACxB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAK3B;;;;;;;;OAQG;IACU,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAKlH;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IA4B5B;;;;;;;;;OASG;IACH,OAAO,CAAC,2BAA2B;CAqBpC"}

package/dist/commonjs/user-client/http/transport/transport-hook-adapter.js

@@ -3,6 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransportHookAdapter = void 0;
 const custom_hook_js_1 = require("../hooks/custom-hook.js");
 const base_serializer_js_1 = require("../serialization/base-serializer.js");
+/**
+ * Adapter that bridges between the internal Request representation and the Hook interface.
+ * Converts Request objects to HttpRequest format for hook processing, then converts
+ * modified HttpRequest objects back to Request format.
+ *
+ * @template T - The expected response type
+ */
 class TransportHookAdapter {
     constructor() {
         Object.defineProperty(this, "hook", {
@@ -12,6 +19,14 @@ class TransportHookAdapter {
             value: new custom_hook_js_1.CustomHook()
         });
     }
+    /**
+     * Invokes the custom hook before sending the request.
+     * Converts the Request to HttpRequest format, calls the hook, then converts back.
+     *
+     * @param request - The internal Request object
+     * @param params - Additional parameters to pass to the hook
+     * @returns The modified Request after hook processing
+     */
     async beforeRequest(request, params) {
         const hookRequest = this.requestToHookRequest(request);
         const newRequest = await this.hook.beforeRequest(hookRequest, params);
@@ -26,14 +41,39 @@ class TransportHookAdapter {
         });
         return newTransportRequest;
     }
+    /**
+     * Invokes the custom hook after receiving a response.
+     * Converts the Request to HttpRequest format and calls the hook with the response.
+     *
+     * @param request - The internal Request object
+     * @param response - The HTTP response received
+     * @param params - Additional parameters to pass to the hook
+     * @returns The potentially modified response after hook processing
+     */
     async afterResponse(request, response, params) {
         const hookRequest = this.requestToHookRequest(request);
         return this.hook.afterResponse(hookRequest, response, params);
     }
+    /**
+     * Invokes the custom hook when an error occurs.
+     * Converts the Request to HttpRequest format and calls the error hook.
+     *
+     * @param request - The internal Request object
+     * @param response - The HTTP response that triggered the error
+     * @param params - Additional parameters to pass to the hook
+     * @returns The HttpError from the hook
+     */
     async onError(request, response, params) {
         const hookRequest = this.requestToHookRequest(request);
         return this.hook.onError(hookRequest, response, params);
     }
+    /**
+     * Converts the internal Request representation to the hook's HttpRequest format.
+     * Extracts parameter values from RequestParameter wrappers.
+     *
+     * @param request - The internal Request object
+     * @returns An HttpRequest object for hook processing
+     */
     requestToHookRequest(request) {
         const hookHeaders = new Map();
         request.headers.forEach((header, key) => {
@@ -58,6 +98,16 @@ class TransportHookAdapter {
         };
         return hookRequest;
     }
+    /**
+     * Converts hook parameter maps back to RequestParameter format.
+     * Preserves serialization metadata from the original parameters.
+     *
+     * @template T - The parameter value type
+     * @param hookParams - The parameter map from hook processing
+     * @param originalTransportParams - The original RequestParameter map for metadata
+     * @param encode - Whether to encode the parameters
+     * @returns A map of RequestParameter objects for transport
+     */
     hookParamsToTransportParams(hookParams, originalTransportParams, encode) {
         const transportParams = new Map();
         hookParams.forEach((hookParamValue, hookParamKey) => {

package/dist/commonjs/user-client/http/transport/transport-hook-adapter.js.map

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