@sudobility/svgr_client 1.0.11 → 1.0.13

package/dist/hooks/query-keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-keys.d.ts","sourceRoot":"","sources":["../../src/hooks/query-keys.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ;;;CAGpB,CAAC"}
+{"version":3,"file":"query-keys.d.ts","sourceRoot":"","sources":["../../src/hooks/query-keys.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,QAAQ;;;CAKpB,CAAC"}

package/dist/hooks/query-keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-keys.js","sourceRoot":"","sources":["../../src/hooks/query-keys.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,EAAE,CAAC,MAAM,CAAU;IACtB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAU;CACrD,CAAC","sourcesContent":["export const svgrKeys = {\n  all: [\"svgr\"] as const,\n  convert: () => [...svgrKeys.all, \"convert\"] as const,\n};\n"]}
+{"version":3,"file":"query-keys.js","sourceRoot":"","sources":["../../src/hooks/query-keys.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,QAAQ,GAAG;IAEtB,GAAG,EAAE,CAAC,MAAM,CAAU;IAEtB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAU;CACrD,CAAC","sourcesContent":["/**\n * Query key factory for SVGR-related TanStack Query cache keys.\n *\n * Provides a hierarchical key structure for consistent cache invalidation.\n * All keys are `as const` tuples for type-safe query key matching.\n *\n * @example\n * ```typescript\n * import { svgrKeys } from '@sudobility/svgr_client';\n * import { useQueryClient } from '@tanstack/react-query';\n *\n * const queryClient = useQueryClient();\n *\n * // Invalidate all SVGR-related queries\n * queryClient.invalidateQueries({ queryKey: svgrKeys.all });\n *\n * // Invalidate only convert-related queries\n * queryClient.invalidateQueries({ queryKey: svgrKeys.convert() });\n * ```\n */\nexport const svgrKeys = {\n  /** Base key for all SVGR queries: `[\"svgr\"]` */\n  all: [\"svgr\"] as const,\n  /** Key for conversion queries: `[\"svgr\", \"convert\"]` */\n  convert: () => [...svgrKeys.all, \"convert\"] as const,\n};\n"]}

package/dist/hooks/useConvert.d.ts

@@ -1,8 +1,9 @@
 import type { SvgrClient } from "../network/SvgrClient";
-export declare function useConvert(client: SvgrClient): import("@tanstack/react-query").UseMutationResult<import("@sudobility/types").BaseResponse<import("@sudobility/svgr_types").ConvertResult>, Error, {
+export interface ConvertMutationParams {
     original: string;
     filename?: string;
     quality?: number;
     transparentBg?: boolean;
-}, unknown>;
+}
+export declare function useConvert(client: SvgrClient): import("@tanstack/react-query").UseMutationResult<import("@sudobility/types").BaseResponse<import("@sudobility/svgr_types").ConvertResult>, Error, ConvertMutationParams, unknown>;
 //# sourceMappingURL=useConvert.d.ts.map

package/dist/hooks/useConvert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useConvert.d.ts","sourceRoot":"","sources":["../../src/hooks/useConvert.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU;cAQ7B,MAAM;eACL,MAAM;cACP,MAAM;oBACA,OAAO;YAG5B"}
+{"version":3,"file":"useConvert.d.ts","sourceRoot":"","sources":["../../src/hooks/useConvert.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAWxD,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAkDD,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,sLAU5C"}

package/dist/hooks/useConvert.js.map

@@ -1 +1 @@
-{"version":3,"file":"useConvert.js","sourceRoot":"","sources":["../../src/hooks/useConvert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,OAAO,WAAW,CAAC;QACjB,UAAU,EAAE,CAAC,EACX,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,aAAa,GAMd,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC;KACjE,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { useMutation } from \"@tanstack/react-query\";\nimport type { SvgrClient } from \"../network/SvgrClient\";\n\nexport function useConvert(client: SvgrClient) {\n  return useMutation({\n    mutationFn: ({\n      original,\n      filename,\n      quality,\n      transparentBg,\n    }: {\n      original: string;\n      filename?: string;\n      quality?: number;\n      transparentBg?: boolean;\n    }) => client.convert(original, filename, quality, transparentBg),\n  });\n}\n"]}
+{"version":3,"file":"useConvert.js","sourceRoot":"","sources":["../../src/hooks/useConvert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAuEpD,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,OAAO,WAAW,CAAC;QACjB,UAAU,EAAE,CAAC,EACX,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,aAAa,GACS,EAAE,EAAE,CAC1B,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC;KAC7D,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { useMutation } from \"@tanstack/react-query\";\nimport type { SvgrClient } from \"../network/SvgrClient\";\n\n/**\n * Parameters for the {@link useConvert} mutation hook.\n *\n * @interface ConvertMutationParams\n * @property {string} original - Base64-encoded raster image data (PNG, JPG, WEBP, BMP, or GIF)\n * @property {string} [filename] - Optional filename for metadata or audit purposes\n * @property {number} [quality] - Conversion quality level from 1 to 10. Default: 5\n * @property {boolean} [transparentBg] - If true, removes the background from the SVG. Default: false\n */\nexport interface ConvertMutationParams {\n  /** Base64-encoded raster image data (PNG, JPG, WEBP, BMP, or GIF) */\n  original: string;\n  /** Optional filename for metadata or audit purposes */\n  filename?: string;\n  /** Conversion quality level from 1 to 10 (1 = smallest, 10 = highest fidelity). Default: 5 */\n  quality?: number;\n  /** If true, removes the background from the SVG. Default: false */\n  transparentBg?: boolean;\n}\n\n/**\n * TanStack Query mutation hook for converting raster images to SVG.\n *\n * Wraps {@link SvgrClient.convert} in a `useMutation` hook, providing\n * loading state, error handling, and cache integration via TanStack Query.\n *\n * @param client - An initialized {@link SvgrClient} instance\n * @returns A TanStack Query mutation result object with `mutate`, `mutateAsync`,\n *   `isPending`, `isError`, `data`, `error`, and other standard mutation properties\n *\n * @example\n * ```tsx\n * import { useConvert } from '@sudobility/svgr_client';\n *\n * function ConvertButton({ client }: { client: SvgrClient }) {\n *   const convert = useConvert(client);\n *\n *   const handleConvert = () => {\n *     convert.mutate({\n *       original: base64ImageData,\n *       filename: 'logo.png',\n *       quality: 7,\n *       transparentBg: true,\n *     });\n *   };\n *\n *   if (convert.isPending) return <p>Converting...</p>;\n *   if (convert.isError) return <p>Error: {convert.error.message}</p>;\n *   if (convert.data?.data) return <div>{convert.data.data.svg}</div>;\n *\n *   return <button onClick={handleConvert}>Convert</button>;\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Using mutateAsync for async/await flow\n * const convert = useConvert(client);\n * try {\n *   const result = await convert.mutateAsync({ original: imageData });\n *   console.log(result.data?.svg);\n * } catch (error) {\n *   if (error instanceof SvgrApiError) {\n *     console.error(`HTTP ${error.status}: ${error.message}`);\n *   }\n * }\n * ```\n */\nexport function useConvert(client: SvgrClient) {\n  return useMutation({\n    mutationFn: ({\n      original,\n      filename,\n      quality,\n      transparentBg,\n    }: ConvertMutationParams) =>\n      client.convert(original, filename, quality, transparentBg),\n  });\n}\n"]}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { SvgrClient, SvgrApiError, type SvgrClientConfig, } from "./network/SvgrClient";
+export { SvgrClient, SvgrApiError, type SvgrClientConfig, type RetryConfig, } from "./network/SvgrClient";
 export { useConvert, svgrKeys } from "./hooks";
+export type { ConvertMutationParams } from "./hooks/useConvert";
 export type { ConvertRequest, ConvertResult, ConvertResponse, BaseResponse, } from "@sudobility/svgr_types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG/C,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,wBAAwB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,YAAY,GAEb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC","sourcesContent":["// Network\nexport {\n  SvgrClient,\n  SvgrApiError,\n  type SvgrClientConfig,\n} from \"./network/SvgrClient\";\n\n// Hooks\nexport { useConvert, svgrKeys } from \"./hooks\";\n\n// Re-export types for convenience\nexport type {\n  ConvertRequest,\n  ConvertResult,\n  ConvertResponse,\n  BaseResponse,\n} from \"@sudobility/svgr_types\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,UAAU,EACV,YAAY,GAGb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC","sourcesContent":["/**\n * @module @sudobility/svgr_client\n *\n * API client SDK for SVGR with React Query hooks.\n *\n * Provides a typed HTTP client ({@link SvgrClient}) for calling the SVGR\n * image-to-SVG conversion API, along with TanStack Query hooks ({@link useConvert})\n * for seamless React integration.\n *\n * @example\n * ```typescript\n * import { SvgrClient, useConvert, svgrKeys } from '@sudobility/svgr_client';\n * ```\n */\n\n// Network\nexport {\n  SvgrClient,\n  SvgrApiError,\n  type SvgrClientConfig,\n  type RetryConfig,\n} from \"./network/SvgrClient\";\n\n// Hooks\nexport { useConvert, svgrKeys } from \"./hooks\";\nexport type { ConvertMutationParams } from \"./hooks/useConvert\";\n\n// Re-export types for convenience\nexport type {\n  ConvertRequest,\n  ConvertResult,\n  ConvertResponse,\n  BaseResponse,\n} from \"@sudobility/svgr_types\";\n"]}

package/dist/network/SvgrClient.d.ts

@@ -3,6 +3,12 @@ import type { BaseResponse, ConvertResult } from "@sudobility/svgr_types";
 export interface SvgrClientConfig {
     baseUrl: string;
     networkClient: NetworkClient;
+    retry?: RetryConfig;
+}
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+    retryableStatuses?: number[];
 }
 export declare class SvgrApiError extends Error {
     status: number;
@@ -11,7 +17,9 @@ export declare class SvgrApiError extends Error {
 export declare class SvgrClient {
     private readonly baseUrl;
     private readonly networkClient;
+    private readonly retryConfig;
     constructor(config: SvgrClientConfig);
     convert(original: string, filename?: string, quality?: number, transparentBg?: boolean): Promise<BaseResponse<ConvertResult>>;
+    private withRetry;
 }
 //# sourceMappingURL=SvgrClient.d.ts.map

package/dist/network/SvgrClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SvgrClient.d.ts","sourceRoot":"","sources":["../../src/network/SvgrClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,qBAAa,YAAa,SAAQ,KAAK;IAE5B,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAElC,MAAM,EAAE,gBAAgB;IAK9B,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;CAqBxC"}
+{"version":3,"file":"SvgrClient.d.ts","sourceRoot":"","sources":["../../src/network/SvgrClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAmB1E,MAAM,WAAW,gBAAgB;IAE/B,OAAO,EAAE,MAAM,CAAC;IAEhB,aAAa,EAAE,aAAa,CAAC;IAM7B,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAqBD,MAAM,WAAW,WAAW;IAE1B,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IAEpB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AA8BD,qBAAa,YAAa,SAAQ,KAAK;IAG5B,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAgCD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;gBAE1C,MAAM,EAAE,gBAAgB;IAmC9B,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;YAmCzB,SAAS;CAsBxB"}

package/dist/network/SvgrClient.js

@@ -1,3 +1,4 @@
+const DEFAULT_RETRYABLE_STATUSES = [408, 429, 500, 502, 503, 504];
 export class SvgrApiError extends Error {
     constructor(status, message) {
         super(message);
@@ -9,19 +10,36 @@ export class SvgrClient {
     constructor(config) {
         this.baseUrl = config.baseUrl;
         this.networkClient = config.networkClient;
+        this.retryConfig = config.retry;
     }
     async convert(original, filename, quality, transparentBg) {
-        const response = await this.networkClient.post(`${this.baseUrl}/api/v1/convert`, {
+        const makeRequest = () => this.networkClient.post(`${this.baseUrl}/api/v1/convert`, {
             original,
             filename,
             quality,
             transparentBg,
         });
+        const response = this.retryConfig
+            ? await this.withRetry(makeRequest, this.retryConfig)
+            : await makeRequest();
         if (!response.ok || !response.data) {
             const errorData = response.data;
             throw new SvgrApiError(response.status, errorData?.error || "Conversion failed");
         }
         return response.data;
     }
+    async withRetry(fn, config) {
+        const retryableStatuses = config.retryableStatuses ?? DEFAULT_RETRYABLE_STATUSES;
+        let response = await fn();
+        for (let attempt = 0; attempt < config.maxRetries; attempt++) {
+            if (response.ok || !retryableStatuses.includes(response.status)) {
+                return response;
+            }
+            const delay = config.baseDelayMs * Math.pow(2, attempt);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            response = await fn();
+        }
+        return response;
+    }
 }
 //# sourceMappingURL=SvgrClient.js.map

package/dist/network/SvgrClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"SvgrClient.js","sourceRoot":"","sources":["../../src/network/SvgrClient.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YACS,MAAc,EACrB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,WAAM,GAAN,MAAM,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,UAAU;IAIrB,YAAY,MAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAO,CACX,QAAgB,EAChB,QAAiB,EACjB,OAAgB,EAChB,aAAuB;QAEvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAC5C,GAAG,IAAI,CAAC,OAAO,iBAAiB,EAChC;YACE,QAAQ;YACR,QAAQ;YACR,OAAO;YACP,aAAa;SACd,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,IAA6C,CAAC;YACzE,MAAM,IAAI,YAAY,CACpB,QAAQ,CAAC,MAAM,EACf,SAAS,EAAE,KAAK,IAAI,mBAAmB,CACxC,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF","sourcesContent":["import type { NetworkClient } from \"@sudobility/types\";\nimport type { BaseResponse, ConvertResult } from \"@sudobility/svgr_types\";\n\nexport interface SvgrClientConfig {\n  baseUrl: string;\n  networkClient: NetworkClient;\n}\n\nexport class SvgrApiError extends Error {\n  constructor(\n    public status: number,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"SvgrApiError\";\n  }\n}\n\nexport class SvgrClient {\n  private readonly baseUrl: string;\n  private readonly networkClient: NetworkClient;\n\n  constructor(config: SvgrClientConfig) {\n    this.baseUrl = config.baseUrl;\n    this.networkClient = config.networkClient;\n  }\n\n  async convert(\n    original: string,\n    filename?: string,\n    quality?: number,\n    transparentBg?: boolean,\n  ): Promise<BaseResponse<ConvertResult>> {\n    const response = await this.networkClient.post<BaseResponse<ConvertResult>>(\n      `${this.baseUrl}/api/v1/convert`,\n      {\n        original,\n        filename,\n        quality,\n        transparentBg,\n      },\n    );\n\n    if (!response.ok || !response.data) {\n      const errorData = response.data as { error?: string } | null | undefined;\n      throw new SvgrApiError(\n        response.status,\n        errorData?.error || \"Conversion failed\",\n      );\n    }\n\n    return response.data;\n  }\n}\n"]}
+{"version":3,"file":"SvgrClient.js","sourceRoot":"","sources":["../../src/network/SvgrClient.ts"],"names":[],"mappings":"AA8DA,MAAM,0BAA0B,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AA2BlE,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAES,MAAc,EACrB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,WAAM,GAAN,MAAM,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAgCD,MAAM,OAAO,UAAU;IAKrB,YAAY,MAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;IAClC,CAAC;IA+BD,KAAK,CAAC,OAAO,CACX,QAAgB,EAChB,QAAiB,EACjB,OAAgB,EAChB,aAAuB;QAEvB,MAAM,WAAW,GAAG,GAAG,EAAE,CACvB,IAAI,CAAC,aAAa,CAAC,IAAI,CACrB,GAAG,IAAI,CAAC,OAAO,iBAAiB,EAChC;YACE,QAAQ;YACR,QAAQ;YACR,OAAO;YACP,aAAa;SACd,CACF,CAAC;QAEJ,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW;YAC/B,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC;YACrD,CAAC,CAAC,MAAM,WAAW,EAAE,CAAC;QAExB,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,IAA6C,CAAC;YACzE,MAAM,IAAI,YAAY,CACpB,QAAQ,CAAC,MAAM,EACf,SAAS,EAAE,KAAK,IAAI,mBAAmB,CACxC,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAUO,KAAK,CAAC,SAAS,CACrB,EAAsD,EACtD,MAAmB;QAEnB,MAAM,iBAAiB,GACrB,MAAM,CAAC,iBAAiB,IAAI,0BAA0B,CAAC;QAEzD,IAAI,QAAQ,GAAG,MAAM,EAAE,EAAE,CAAC;QAE1B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YAC7D,IAAI,QAAQ,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChE,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACxD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAE3D,QAAQ,GAAG,MAAM,EAAE,EAAE,CAAC;QACxB,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF","sourcesContent":["import type { NetworkClient } from \"@sudobility/types\";\nimport type { BaseResponse, ConvertResult } from \"@sudobility/svgr_types\";\n\n/**\n * Configuration for creating an {@link SvgrClient} instance.\n *\n * @interface SvgrClientConfig\n * @property {string} baseUrl - The base URL of the SVGR API server (e.g., `https://api.svgr.app`)\n * @property {NetworkClient} networkClient - A platform-agnostic HTTP client from `@sudobility/types`\n *   that handles authentication headers and request serialization\n *\n * @example\n * ```typescript\n * const config: SvgrClientConfig = {\n *   baseUrl: 'https://api.svgr.app',\n *   networkClient: myNetworkClient,\n * };\n * const client = new SvgrClient(config);\n * ```\n */\nexport interface SvgrClientConfig {\n  /** The base URL of the SVGR API server (e.g., `https://api.svgr.app`) */\n  baseUrl: string;\n  /** Platform-agnostic HTTP client that handles auth and serialization */\n  networkClient: NetworkClient;\n  /**\n   * Optional retry configuration for failed requests.\n   * When provided, the client will retry failed network requests\n   * using exponential backoff.\n   */\n  retry?: RetryConfig;\n}\n\n/**\n * Configuration for automatic retry of failed network requests.\n *\n * @interface RetryConfig\n * @property {number} maxRetries - Maximum number of retry attempts (default: 3)\n * @property {number} baseDelayMs - Base delay in milliseconds before first retry (default: 1000).\n *   Subsequent retries use exponential backoff: `baseDelayMs * 2^attempt`.\n * @property {number[]} [retryableStatuses] - HTTP status codes that should trigger a retry.\n *   Defaults to [408, 429, 500, 502, 503, 504].\n *\n * @example\n * ```typescript\n * const retryConfig: RetryConfig = {\n *   maxRetries: 3,\n *   baseDelayMs: 1000,\n *   retryableStatuses: [429, 500, 502, 503, 504],\n * };\n * ```\n */\nexport interface RetryConfig {\n  /** Maximum number of retry attempts (default: 3) */\n  maxRetries: number;\n  /** Base delay in milliseconds before first retry (default: 1000) */\n  baseDelayMs: number;\n  /** HTTP status codes that should trigger a retry. Defaults to [408, 429, 500, 502, 503, 504] */\n  retryableStatuses?: number[];\n}\n\n/** Default HTTP status codes considered retryable */\nconst DEFAULT_RETRYABLE_STATUSES = [408, 429, 500, 502, 503, 504];\n\n/**\n * Error thrown when the SVGR API returns a non-successful HTTP response.\n *\n * Extends the built-in `Error` class with an HTTP `status` code property,\n * allowing consumers to differentiate between different error types.\n *\n * @extends Error\n * @property {number} status - The HTTP status code from the API response\n * @property {string} message - Human-readable error description\n * @property {string} name - Always `\"SvgrApiError\"` for type identification\n *\n * @example\n * ```typescript\n * try {\n *   await client.convert(imageData);\n * } catch (error) {\n *   if (error instanceof SvgrApiError) {\n *     console.error(`API error ${error.status}: ${error.message}`);\n *     if (error.status === 429) {\n *       // Handle rate limiting\n *     }\n *   }\n * }\n * ```\n */\nexport class SvgrApiError extends Error {\n  constructor(\n    /** The HTTP status code from the API response */\n    public status: number,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"SvgrApiError\";\n  }\n}\n\n/**\n * HTTP client for the SVGR image-to-SVG conversion API.\n *\n * Provides a typed interface for calling the SVGR conversion endpoint.\n * Uses a platform-agnostic `NetworkClient` for HTTP communication,\n * making it usable in both web and React Native environments.\n *\n * @example\n * ```typescript\n * import { SvgrClient } from '@sudobility/svgr_client';\n *\n * const client = new SvgrClient({\n *   baseUrl: 'https://api.svgr.app',\n *   networkClient: myNetworkClient,\n * });\n *\n * const response = await client.convert(base64Image, 'logo.png', 7, true);\n * console.log(response.data?.svg);\n * ```\n *\n * @example\n * ```typescript\n * // With retry configuration\n * const client = new SvgrClient({\n *   baseUrl: 'https://api.svgr.app',\n *   networkClient: myNetworkClient,\n *   retry: { maxRetries: 3, baseDelayMs: 1000 },\n * });\n * ```\n */\nexport class SvgrClient {\n  private readonly baseUrl: string;\n  private readonly networkClient: NetworkClient;\n  private readonly retryConfig: RetryConfig | undefined;\n\n  constructor(config: SvgrClientConfig) {\n    this.baseUrl = config.baseUrl;\n    this.networkClient = config.networkClient;\n    this.retryConfig = config.retry;\n  }\n\n  /**\n   * Convert a raster image to SVG format.\n   *\n   * Sends a POST request to `/api/v1/convert` with the image data and\n   * optional conversion parameters. Returns a `BaseResponse<ConvertResult>`\n   * containing the SVG string and original image dimensions on success.\n   *\n   * @param original - Base64-encoded raster image data (PNG, JPG, WEBP, BMP, or GIF)\n   * @param filename - Optional filename for metadata or audit purposes\n   * @param quality - Conversion quality level from 1 to 10 (1 = smallest, 10 = highest fidelity). Default: 5\n   * @param transparentBg - If true, removes the background from the SVG. Default: false\n   * @returns A promise resolving to a `BaseResponse<ConvertResult>` with the SVG output\n   * @throws {SvgrApiError} When the API returns a non-successful response (includes HTTP status code)\n   *\n   * @example\n   * ```typescript\n   * const response = await client.convert(\n   *   'data:image/png;base64,...',\n   *   'logo.png',\n   *   7,\n   *   true,\n   * );\n   * if (response.success && response.data) {\n   *   console.log(response.data.svg);    // SVG string\n   *   console.log(response.data.width);  // Original width in px\n   *   console.log(response.data.height); // Original height in px\n   * }\n   * ```\n   */\n  async convert(\n    original: string,\n    filename?: string,\n    quality?: number,\n    transparentBg?: boolean,\n  ): Promise<BaseResponse<ConvertResult>> {\n    const makeRequest = () =>\n      this.networkClient.post<BaseResponse<ConvertResult>>(\n        `${this.baseUrl}/api/v1/convert`,\n        {\n          original,\n          filename,\n          quality,\n          transparentBg,\n        },\n      );\n\n    const response = this.retryConfig\n      ? await this.withRetry(makeRequest, this.retryConfig)\n      : await makeRequest();\n\n    if (!response.ok || !response.data) {\n      const errorData = response.data as { error?: string } | null | undefined;\n      throw new SvgrApiError(\n        response.status,\n        errorData?.error || \"Conversion failed\",\n      );\n    }\n\n    return response.data;\n  }\n\n  /**\n   * Execute a request function with exponential backoff retry.\n   *\n   * @param fn - The async function to retry\n   * @param config - Retry configuration\n   * @returns The result of the successful request\n   * @throws The last error encountered after all retries are exhausted\n   */\n  private async withRetry<T>(\n    fn: () => Promise<{ ok: boolean; status: number } & T>,\n    config: RetryConfig,\n  ): Promise<{ ok: boolean; status: number } & T> {\n    const retryableStatuses =\n      config.retryableStatuses ?? DEFAULT_RETRYABLE_STATUSES;\n\n    let response = await fn();\n\n    for (let attempt = 0; attempt < config.maxRetries; attempt++) {\n      if (response.ok || !retryableStatuses.includes(response.status)) {\n        return response;\n      }\n\n      const delay = config.baseDelayMs * Math.pow(2, attempt);\n      await new Promise((resolve) => setTimeout(resolve, delay));\n\n      response = await fn();\n    }\n\n    return response;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/svgr_client",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -29,16 +29,16 @@
     "verify": "bun run typecheck && bun run lint && bun run test && bun run build"
   },
   "dependencies": {
-    "@sudobility/svgr_types": "^1.0.6"
+    "@sudobility/svgr_types": "^1.0.7"
   },
   "peerDependencies": {
-    "@sudobility/types": "^1.9.53",
+    "@sudobility/types": "^1.9.54",
     "react": "^18.0.0 || ^19.0.0",
     "@tanstack/react-query": "^5.0.0"
   },
   "devDependencies": {
-    "@sudobility/di": "^1.5.38",
-    "@sudobility/types": "^1.9.53",
+    "@sudobility/di": "^1.5.40",
+    "@sudobility/types": "^1.9.54",
     "@eslint/js": "^9.38.0",
     "@tanstack/react-query": "^5.0.0",
     "@types/react": "^19.0.0",