magicbell-js 1.5.0 → 1.6.0

package/dist/commonjs/project-client/http/handlers/hook-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-handler.d.ts","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/hook-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGlD,OAAO,EAAe,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGxE,qBAAa,WAAY,YAAW,cAAc;IAGpC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,IAAI,CAAC,EAAE,cAAc,CAAC;gBAEO,IAAI,EAAE,IAAI;IAEjC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IA0CpD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAsBnE,OAAO,CAAC,aAAa;CAItB"}
+{"version":3,"file":"hook-handler.d.ts","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/hook-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGlD,OAAO,EAAe,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGxE;;;GAGG;AACH,qBAAa,WAAY,YAAW,cAAc;IAIpC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,gCAAgC;IAChC,IAAI,CAAC,EAAE,cAAc,CAAC;gBAEO,IAAI,EAAE,IAAI;IAEvC;;;;;;;OAOG;IACG,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IA0C3D;;;;;;;OAOG;IACI,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAsBnE;;;;;OAKG;IACH,OAAO,CAAC,aAAa;CAItB"}

package/dist/commonjs/project-client/http/handlers/hook-handler.js

@@ -4,6 +4,10 @@ exports.HookHandler = void 0;
 const error_js_1 = require("../error.js");
 const transport_hook_adapter_js_1 = require("../transport/transport-hook-adapter.js");
 const content_type_js_1 = require("../utils/content-type.js");
+/**
+ * Request handler that invokes custom hooks before requests and after responses.
+ * Enables request/response interception and custom error handling.
+ */
 class HookHandler {
     constructor(hook) {
         Object.defineProperty(this, "hook", {
@@ -12,6 +16,7 @@ class HookHandler {
             writable: true,
             value: hook
         });
+        /** Next handler in the chain */
         Object.defineProperty(this, "next", {
             enumerable: true,
             configurable: true,
@@ -19,6 +24,14 @@ class HookHandler {
             value: void 0
         });
     }
+    /**
+     * Handles a standard HTTP request with hook invocation.
+     * Calls beforeRequest hook, processes the request, and calls afterResponse or onError hooks.
+     * @template T - The expected response data type
+     * @param request - The HTTP request to process
+     * @returns A promise that resolves to the HTTP response
+     * @throws Error if no next handler is set, or if error handling fails
+     */
     async handle(request) {
         var _a;
         if (!this.next) {
@@ -47,6 +60,14 @@ class HookHandler {
         const decodedBody = new TextDecoder().decode(arrayBuffer);
         throw new error_js_1.HttpError(response.metadata, arrayBuffer, `Unexpected response body for error status.\nStatusCode: ${response.metadata.status}\nBody: ${decodedBody}`);
     }
+    /**
+     * Handles a streaming HTTP request with hook invocation.
+     * Calls beforeRequest hook and afterResponse/onError hooks for each chunk.
+     * @template T - The expected response data type for each chunk
+     * @param request - The HTTP request to process
+     * @returns An async generator that yields HTTP responses
+     * @throws Error if no next handler is set, or if error handling fails
+     */
     async *stream(request) {
         if (!this.next) {
             throw new Error('No next handler set in hook handler.');
@@ -64,6 +85,12 @@ class HookHandler {
             }
         }
     }
+    /**
+     * Extracts hook parameters from the request configuration.
+     * @template T - The response data type
+     * @param request - The HTTP request
+     * @returns A map of hook parameter names to values
+     */
     getHookParams(_request) {
         const hookParams = new Map();
         return hookParams;

package/dist/commonjs/project-client/http/handlers/hook-handler.js.map

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

package/dist/commonjs/project-client/http/handlers/request-validation-handler.d.ts

@@ -1,11 +1,48 @@
 import { Request } from '../transport/request.js';
 import { HttpResponse, RequestHandler } from '../types.js';
+/**
+ * Request handler that validates and serializes request bodies based on content type.
+ * Supports JSON, XML, text, binary, form data, and multipart form data.
+ */
 export declare class RequestValidationHandler implements RequestHandler {
+    /** Next handler in the chain */
     next?: RequestHandler;
+    /**
+     * Handles a standard HTTP request with validation.
+     * @template T - The expected response data type
+     * @param request - The HTTP request to validate
+     * @returns A promise that resolves to the HTTP response
+     * @throws Error if no next handler is set
+     */
     handle<T>(request: Request): Promise<HttpResponse<T>>;
+    /**
+     * Handles a streaming HTTP request with validation.
+     * @template T - The expected response data type for each chunk
+     * @param request - The HTTP request to validate
+     * @returns An async generator that yields HTTP responses
+     * @throws Error if no next handler is set
+     */
     stream<T>(request: Request): AsyncGenerator<HttpResponse<T>>;
+    /**
+     * Validates and serializes the request body based on its content type.
+     * @param request - The HTTP request to validate
+     * @throws ValidationError if Zod schema validation fails
+     */
     validateRequest(request: Request): void;
+    /**
+     * Converts request body to URL-encoded form data format.
+     * @param request - The HTTP request with body to convert
+     * @returns URL-encoded string representation of the body
+     */
     toFormUrlEncoded(request: Request): string;
+    /**
+     * Converts request body to multipart form data format.
+     * Handles files (ArrayBuffer), arrays, and regular values.
+     * @param body - The request body object
+     * @param filename - Optional filename for single file uploads
+     * @param filenames - Optional filenames array for array of file uploads
+     * @returns FormData object with serialized body
+     */
     toFormData(body: Record<string, any>, filename?: string, filenames?: string[]): FormData;
 }
 //# sourceMappingURL=request-validation-handler.d.ts.map

package/dist/commonjs/project-client/http/handlers/request-validation-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-validation-handler.d.ts","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/request-validation-handler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAe,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExE,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,IAAI,CAAC,EAAE,cAAc,CAAC;IAEhB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAUpD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAUnE,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IA2BvC,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAsC1C,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,QAAQ;CA0BzF"}
+{"version":3,"file":"request-validation-handler.d.ts","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/request-validation-handler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAe,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExE;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,gCAAgC;IAChC,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;;;OAMG;IACG,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAU3D;;;;;;OAMG;IACI,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAUnE;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IA2BvC;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAsC1C;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,QAAQ;CA0BzF"}

package/dist/commonjs/project-client/http/handlers/request-validation-handler.js

@@ -4,8 +4,13 @@ exports.RequestValidationHandler = void 0;
 const zod_1 = require("zod");
 const validation_error_js_1 = require("../errors/validation-error.js");
 const types_js_1 = require("../types.js");
+/**
+ * Request handler that validates and serializes request bodies based on content type.
+ * Supports JSON, XML, text, binary, form data, and multipart form data.
+ */
 class RequestValidationHandler {
     constructor() {
+        /** Next handler in the chain */
         Object.defineProperty(this, "next", {
             enumerable: true,
             configurable: true,
@@ -13,6 +18,13 @@ class RequestValidationHandler {
             value: void 0
         });
     }
+    /**
+     * Handles a standard HTTP request with validation.
+     * @template T - The expected response data type
+     * @param request - The HTTP request to validate
+     * @returns A promise that resolves to the HTTP response
+     * @throws Error if no next handler is set
+     */
     async handle(request) {
         if (!this.next) {
             throw new Error('No next handler set in ContentTypeHandler.');
@@ -20,6 +32,13 @@ class RequestValidationHandler {
         this.validateRequest(request);
         return this.next.handle(request);
     }
+    /**
+     * Handles a streaming HTTP request with validation.
+     * @template T - The expected response data type for each chunk
+     * @param request - The HTTP request to validate
+     * @returns An async generator that yields HTTP responses
+     * @throws Error if no next handler is set
+     */
     async *stream(request) {
         if (!this.next) {
             throw new Error('No next handler set in ContentTypeHandler.');
@@ -27,6 +46,11 @@ class RequestValidationHandler {
         this.validateRequest(request);
         yield* this.next.stream(request);
     }
+    /**
+     * Validates and serializes the request body based on its content type.
+     * @param request - The HTTP request to validate
+     * @throws ValidationError if Zod schema validation fails
+     */
     validateRequest(request) {
         var _a, _b;
         if (request.requestContentType === types_js_1.ContentType.Json) {
@@ -57,6 +81,11 @@ class RequestValidationHandler {
             request.body = JSON.stringify((_b = request.requestSchema) === null || _b === void 0 ? void 0 : _b.parse(request.body));
         }
     }
+    /**
+     * Converts request body to URL-encoded form data format.
+     * @param request - The HTTP request with body to convert
+     * @returns URL-encoded string representation of the body
+     */
     toFormUrlEncoded(request) {
         var _a;
         if (request.body === undefined) {
@@ -89,6 +118,14 @@ class RequestValidationHandler {
         }
         return '';
     }
+    /**
+     * Converts request body to multipart form data format.
+     * Handles files (ArrayBuffer), arrays, and regular values.
+     * @param body - The request body object
+     * @param filename - Optional filename for single file uploads
+     * @param filenames - Optional filenames array for array of file uploads
+     * @returns FormData object with serialized body
+     */
     toFormData(body, filename, filenames) {
         const formData = new FormData();
         Object.keys(body).forEach((key) => {

package/dist/commonjs/project-client/http/handlers/request-validation-handler.js.map

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

package/dist/commonjs/project-client/http/handlers/response-validation-handler.d.ts

@@ -1,8 +1,26 @@
 import { Request } from '../transport/request.js';
 import { HttpResponse, RequestHandler } from '../types.js';
+/**
+ * Request handler that validates and decodes HTTP response bodies.
+ * Supports multiple content types including JSON, XML, binary, form data, and event streams.
+ */
 export declare class ResponseValidationHandler implements RequestHandler {
+    /** Next handler in the chain */
     next?: RequestHandler;
+    /**
+     * Handles a standard HTTP request and validates its response.
+     * @template T - The expected response data type
+     * @param request - The HTTP request to process
+     * @returns A promise that resolves to the validated HTTP response
+     */
     handle<T>(request: Request): Promise<HttpResponse<T>>;
+    /**
+     * Handles a streaming HTTP request and validates response chunks.
+     * @template T - The expected response data type for each chunk
+     * @param request - The HTTP request to process
+     * @returns An async generator that yields validated HTTP responses
+     * @throws Error if response headers are enabled (streaming not supported with headers)
+     */
     stream<T>(request: Request): AsyncGenerator<HttpResponse<T>>;
     private splitByDataChunks;
     private decodeBody;
@@ -12,9 +30,34 @@ export declare class ResponseValidationHandler implements RequestHandler {
     private decodeFormUrlEncoded;
     private decodeEventStream;
     private decodeJson;
+    /**
+     * Validates response data against the expected schema if validation is enabled.
+     * @template T - The expected data type
+     * @param request - The HTTP request containing validation settings
+     * @param response - The response definition with schema
+     * @param data - The data to validate
+     * @returns The validated data (parsed if validation enabled, raw otherwise)
+     */
     private validate;
+    /**
+     * Checks if a response should contain data based on its schema and status.
+     * @template T - The response data type
+     * @param responseDefinition - The response definition
+     * @param response - The HTTP response
+     * @returns True if the response should have content, false otherwise
+     */
     private hasContent;
+    /**
+     * Parses URL-encoded data into an object.
+     * @param urlEncodedData - The URL-encoded string
+     * @returns An object with decoded key-value pairs
+     */
     private fromUrlEncoded;
+    /**
+     * Parses multipart form data into an object.
+     * @param arrayBuffer - The raw form data as ArrayBuffer
+     * @returns An object with form field names and values
+     */
     private fromFormData;
 }
 //# sourceMappingURL=response-validation-handler.d.ts.map

package/dist/commonjs/project-client/http/handlers/response-validation-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-validation-handler.d.ts","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/response-validation-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,OAAO,EAAe,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGxE,qBAAa,yBAA0B,YAAW,cAAc;IAC9D,IAAI,CAAC,EAAE,cAAc,CAAC;IAEhB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAMpD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAWnE,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,UAAU;IAgClB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,YAAY;CAoBrB"}
+{"version":3,"file":"response-validation-handler.d.ts","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/response-validation-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,OAAO,EAAe,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGxE;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,cAAc;IAC9D,gCAAgC;IAChC,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;;OAKG;IACG,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAM3D;;;;;;OAMG;IACI,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAWnE,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,UAAU;IAgClB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,UAAU;IAalB;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAOhB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IActB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAoBrB"}

package/dist/commonjs/project-client/http/handlers/response-validation-handler.js

@@ -4,8 +4,13 @@ exports.ResponseValidationHandler = void 0;
 const zod_1 = require("zod");
 const types_js_1 = require("../types.js");
 const response_matcher_js_1 = require("../utils/response-matcher.js");
+/**
+ * Request handler that validates and decodes HTTP response bodies.
+ * Supports multiple content types including JSON, XML, binary, form data, and event streams.
+ */
 class ResponseValidationHandler {
     constructor() {
+        /** Next handler in the chain */
         Object.defineProperty(this, "next", {
             enumerable: true,
             configurable: true,
@@ -13,10 +18,23 @@ class ResponseValidationHandler {
             value: void 0
         });
     }
+    /**
+     * Handles a standard HTTP request and validates its response.
+     * @template T - The expected response data type
+     * @param request - The HTTP request to process
+     * @returns A promise that resolves to the validated HTTP response
+     */
     async handle(request) {
         const response = await this.next.handle(request);
         return this.decodeBody(request, response);
     }
+    /**
+     * Handles a streaming HTTP request and validates response chunks.
+     * @template T - The expected response data type for each chunk
+     * @param request - The HTTP request to process
+     * @returns An async generator that yields validated HTTP responses
+     * @throws Error if response headers are enabled (streaming not supported with headers)
+     */
     async *stream(request) {
         const stream = this.next.stream(request);
         for await (const response of stream) {
@@ -114,6 +132,14 @@ class ResponseValidationHandler {
             data: this.validate(request, responseDefinition, json),
         };
     }
+    /**
+     * Validates response data against the expected schema if validation is enabled.
+     * @template T - The expected data type
+     * @param request - The HTTP request containing validation settings
+     * @param response - The response definition with schema
+     * @param data - The data to validate
+     * @returns The validated data (parsed if validation enabled, raw otherwise)
+     */
     validate(request, response, data) {
         var _a;
         if ((_a = request.validation) === null || _a === void 0 ? void 0 : _a.responseValidation) {
@@ -121,11 +147,23 @@ class ResponseValidationHandler {
         }
         return data;
     }
+    /**
+     * Checks if a response should contain data based on its schema and status.
+     * @template T - The response data type
+     * @param responseDefinition - The response definition
+     * @param response - The HTTP response
+     * @returns True if the response should have content, false otherwise
+     */
     hasContent(responseDefinition, response) {
         return (!!responseDefinition.schema &&
             !(responseDefinition.schema instanceof zod_1.ZodUndefined) &&
             response.metadata.status !== 204);
     }
+    /**
+     * Parses URL-encoded data into an object.
+     * @param urlEncodedData - The URL-encoded string
+     * @returns An object with decoded key-value pairs
+     */
     fromUrlEncoded(urlEncodedData) {
         const pairs = urlEncodedData.split('&');
         const result = {};
@@ -137,6 +175,11 @@ class ResponseValidationHandler {
         });
         return result;
     }
+    /**
+     * Parses multipart form data into an object.
+     * @param arrayBuffer - The raw form data as ArrayBuffer
+     * @returns An object with form field names and values
+     */
     fromFormData(arrayBuffer) {
         const decoder = new TextDecoder();
         const text = decoder.decode(arrayBuffer);

package/dist/commonjs/project-client/http/handlers/response-validation-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"response-validation-handler.js","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/response-validation-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"response-validation-handler.js","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/response-validation-handler.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/project-client/http/handlers/retry-handler.d.ts

@@ -1,10 +1,41 @@
 import { Request } from '../transport/request.js';
 import { HttpResponse, RequestHandler } from '../types.js';
+/**
+ * Request handler that automatically retries failed requests.
+ * Retries are triggered for server errors (5xx), timeouts (408), and rate limits (429).
+ */
 export declare class RetryHandler implements RequestHandler {
+    /** Next handler in the chain */
     next?: RequestHandler;
+    /**
+     * Handles a standard HTTP request with retry logic.
+     * Retries failed requests based on the configured retry settings.
+     * @template T - The expected response data type
+     * @param request - The HTTP request to process
+     * @returns A promise that resolves to the HTTP response
+     * @throws Error if no next handler is set, or if all retry attempts fail
+     */
     handle<T>(request: Request): Promise<HttpResponse<T>>;
+    /**
+     * Handles a streaming HTTP request with retry logic.
+     * @template T - The expected response data type for each chunk
+     * @param request - The HTTP request to process
+     * @returns An async generator that yields HTTP responses
+     * @throws Error if no next handler is set, or if all retry attempts fail
+     */
     stream<T>(request: Request): AsyncGenerator<HttpResponse<T>>;
+    /**
+     * Determines if an error should trigger a retry.
+     * Retries server errors (5xx), request timeouts (408), and rate limits (429).
+     * @param error - The error to check
+     * @returns True if the request should be retried, false otherwise
+     */
     private shouldRetry;
+    /**
+     * Delays execution for a specified duration before retrying.
+     * @param delayMs - The delay in milliseconds (optional)
+     * @returns A promise that resolves after the delay
+     */
     private delay;
 }
 //# sourceMappingURL=retry-handler.d.ts.map

package/dist/commonjs/project-client/http/handlers/retry-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry-handler.d.ts","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/retry-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,qBAAa,YAAa,YAAW,cAAc;IACjD,IAAI,CAAC,EAAE,cAAc,CAAC;IAEhB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAmBpD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAoBnE,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,KAAK;CASd"}
+{"version":3,"file":"retry-handler.d.ts","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/retry-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D;;;GAGG;AACH,qBAAa,YAAa,YAAW,cAAc;IACjD,gCAAgC;IAChC,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;;;;OAOG;IACG,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAmB3D;;;;;;OAMG;IACI,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAoBnE;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAOnB;;;;OAIG;IACH,OAAO,CAAC,KAAK;CASd"}

package/dist/commonjs/project-client/http/handlers/retry-handler.js

@@ -2,8 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RetryHandler = void 0;
 const error_js_1 = require("../error.js");
+/**
+ * Request handler that automatically retries failed requests.
+ * Retries are triggered for server errors (5xx), timeouts (408), and rate limits (429).
+ */
 class RetryHandler {
     constructor() {
+        /** Next handler in the chain */
         Object.defineProperty(this, "next", {
             enumerable: true,
             configurable: true,
@@ -11,6 +16,14 @@ class RetryHandler {
             value: void 0
         });
     }
+    /**
+     * Handles a standard HTTP request with retry logic.
+     * Retries failed requests based on the configured retry settings.
+     * @template T - The expected response data type
+     * @param request - The HTTP request to process
+     * @returns A promise that resolves to the HTTP response
+     * @throws Error if no next handler is set, or if all retry attempts fail
+     */
     async handle(request) {
         if (!this.next) {
             throw new Error('No next handler set in retry handler.');
@@ -28,6 +41,13 @@ class RetryHandler {
         }
         throw new Error('Error retrying request.');
     }
+    /**
+     * Handles a streaming HTTP request with retry logic.
+     * @template T - The expected response data type for each chunk
+     * @param request - The HTTP request to process
+     * @returns An async generator that yields HTTP responses
+     * @throws Error if no next handler is set, or if all retry attempts fail
+     */
     async *stream(request) {
         if (!this.next) {
             throw new Error('No next handler set in retry handler.');
@@ -46,10 +66,21 @@ class RetryHandler {
         }
         throw new Error('Error retrying request.');
     }
+    /**
+     * Determines if an error should trigger a retry.
+     * Retries server errors (5xx), request timeouts (408), and rate limits (429).
+     * @param error - The error to check
+     * @returns True if the request should be retried, false otherwise
+     */
     shouldRetry(error) {
         return (error instanceof error_js_1.HttpError &&
             (error.metadata.status >= 500 || error.metadata.status === 408 || error.metadata.status === 429));
     }
+    /**
+     * Delays execution for a specified duration before retrying.
+     * @param delayMs - The delay in milliseconds (optional)
+     * @returns A promise that resolves after the delay
+     */
     delay(delayMs) {
         if (!delayMs) {
             return Promise.resolve();

package/dist/commonjs/project-client/http/handlers/retry-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry-handler.js","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/retry-handler.ts"],"names":[],"mappings":";;;AAAA,0CAAwC;AAIxC,MAAa,YAAY;IAAzB;QACE;;;;;WAAsB;IAyDxB,CAAC;IAvDC,KAAK,CAAC,MAAM,CAAI,OAAgB;QAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;YACnE,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAI,OAAO,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnE,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAI,OAAgB;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;YACnE,IAAI,CAAC;gBACH,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAI,OAAO,CAAC,CAAC;gBACpC,OAAO;YACT,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnE,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAEO,WAAW,CAAC,KAAY;QAC9B,OAAO,CACL,KAAK,YAAY,oBAAS;YAC1B,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CACjG,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,OAA2B;QACvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA1DD,oCA0DC"}
+{"version":3,"file":"retry-handler.js","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/retry-handler.ts"],"names":[],"mappings":";;;AAAA,0CAAwC;AAIxC;;;GAGG;AACH,MAAa,YAAY;IAAzB;QACE,gCAAgC;QAChC;;;;;WAAsB;IAmFxB,CAAC;IAjFC;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAI,OAAgB;QAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;YACnE,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAI,OAAO,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnE,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,MAAM,CAAI,OAAgB;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;YACnE,IAAI,CAAC;gBACH,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAI,OAAO,CAAC,CAAC;gBACpC,OAAO;YACT,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnE,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACK,WAAW,CAAC,KAAY;QAC9B,OAAO,CACL,KAAK,YAAY,oBAAS;YAC1B,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CACjG,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,OAA2B;QACvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AArFD,oCAqFC"}

package/dist/commonjs/project-client/http/handlers/terminating-handler.d.ts

@@ -1,7 +1,23 @@
 import { Request } from '../transport/request.js';
 import { HttpResponse, RequestHandler } from '../types.js';
+/**
+ * Final handler in the request chain that executes the actual HTTP request.
+ * Uses the configured HTTP client adapter (Fetch or Axios) to send the request.
+ */
 export declare class TerminatingHandler implements RequestHandler {
+    /**
+     * Executes the actual HTTP request using the configured client adapter.
+     * @template T - The expected response data type
+     * @param request - The HTTP request to execute
+     * @returns A promise that resolves to the HTTP response
+     */
     handle<T>(request: Request): Promise<HttpResponse<T>>;
+    /**
+     * Executes a streaming HTTP request using the configured client adapter.
+     * @template T - The expected response data type for each chunk
+     * @param request - The HTTP request to execute
+     * @returns An async generator that yields HTTP responses
+     */
     stream<T>(request: Request): AsyncGenerator<HttpResponse<T>>;
 }
 //# sourceMappingURL=terminating-handler.d.ts.map

package/dist/commonjs/project-client/http/handlers/terminating-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminating-handler.d.ts","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/terminating-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,qBAAa,kBAAmB,YAAW,cAAc;IACjD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAIpD,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAGpE"}
+{"version":3,"file":"terminating-handler.d.ts","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/terminating-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD;;;;;OAKG;IACG,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAI3D;;;;;OAKG;IACI,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAGpE"}

package/dist/commonjs/project-client/http/handlers/terminating-handler.js

@@ -2,10 +2,26 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TerminatingHandler = void 0;
 const request_fetch_adapter_js_1 = require("../transport/request-fetch-adapter.js");
+/**
+ * Final handler in the request chain that executes the actual HTTP request.
+ * Uses the configured HTTP client adapter (Fetch or Axios) to send the request.
+ */
 class TerminatingHandler {
+    /**
+     * Executes the actual HTTP request using the configured client adapter.
+     * @template T - The expected response data type
+     * @param request - The HTTP request to execute
+     * @returns A promise that resolves to the HTTP response
+     */
     async handle(request) {
         return new request_fetch_adapter_js_1.RequestFetchAdapter(request).send();
     }
+    /**
+     * Executes a streaming HTTP request using the configured client adapter.
+     * @template T - The expected response data type for each chunk
+     * @param request - The HTTP request to execute
+     * @returns An async generator that yields HTTP responses
+     */
     async *stream(request) {
         yield* new request_fetch_adapter_js_1.RequestFetchAdapter(request).stream();
     }

package/dist/commonjs/project-client/http/handlers/terminating-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminating-handler.js","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/terminating-handler.ts"],"names":[],"mappings":";;;AAEA,oFAA4E;AAG5E,MAAa,kBAAkB;IAC7B,KAAK,CAAC,MAAM,CAAI,OAAgB;QAC9B,OAAO,IAAI,8CAAmB,CAAI,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAI,OAAgB;QAC/B,KAAK,CAAC,CAAC,IAAI,8CAAmB,CAAI,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;IACtD,CAAC;CACF;AARD,gDAQC"}
+{"version":3,"file":"terminating-handler.js","sourceRoot":"","sources":["../../../../../src/project-client/http/handlers/terminating-handler.ts"],"names":[],"mappings":";;;AAEA,oFAA4E;AAG5E;;;GAGG;AACH,MAAa,kBAAkB;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAI,OAAgB;QAC9B,OAAO,IAAI,8CAAmB,CAAI,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,CAAC,MAAM,CAAI,OAAgB;QAC/B,KAAK,CAAC,CAAC,IAAI,8CAAmB,CAAI,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;IACtD,CAAC;CACF;AApBD,gDAoBC"}