@dugjason/front-node 0.1.0-beta.2 → 0.2.0

package/package.json

@@ -1,49 +1,78 @@
 {
   "name": "@dugjason/front-node",
-  "version": "0.1.0-beta.2",
-  "description": "Modern TypeScript SDK for the Front.com API",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
+  "version": "0.2.0",
+  "description": "Modern Typescript SDK for the Front.com API",
   "keywords": [
-    "front",
     "api",
-    "sdk",
-    "typescript",
-    "nodejs"
+    "customer-support",
+    "front",
+    "frontapp",
+    "sdk"
   ],
-  "author": "",
-  "license": "ISC",
-  "devDependencies": {
-    "@biomejs/biome": "2.2.2",
-    "@faker-js/faker": "10.0.0",
-    "@hey-api/openapi-ts": "0.82.3",
-    "@types/node": "^20.19.1",
-    "msw": "^2.11.1",
-    "msw-auto-mock": "0.31.0",
-    "typescript": "^5.9.2",
-    "vitest": "3.2.4"
+  "homepage": "https://github.com/dugjason/front-node#readme",
+  "bugs": {
+    "url": "https://github.com/dugjason/front-node/issues"
   },
-  "engines": {
-    "node": ">=18.0.0"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dugjason/front-node.git"
   },
   "files": [
     "dist"
   ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "lint": "biome check .",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "generate:types": "openapi-ts"
-  }
-}
+    "test": "bun test",
+    "build": "tsdown",
+    "check": "bun x ultracite check . && bun x tsc --noEmit",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "bun run build && changeset publish",
+    "prepack": "bun run build",
+    "generate": "bun ./scripts/build.ts && bun run build",
+    "lint": "bun x oxlint -c oxlint.config.ts .",
+    "fmt": "bun x oxfmt -c oxfmt.config.ts .",
+    "fmt:check": "bun x oxfmt --check -c oxfmt.config.ts .",
+    "fix": "bun x ultracite fix .",
+    "ultracite": "bun x ultracite check ."
+  },
+  "devDependencies": {
+    "@arethetypeswrong/core": "0.18.5",
+    "@changesets/cli": "3.0.1",
+    "@types/bun": "1.4.0",
+    "@types/node": "26.4.1",
+    "lint-staged": "17.4.1",
+    "openapi-typescript": "7.13.0",
+    "oxfmt": "0.66.0",
+    "oxlint": "1.81.0",
+    "tsdown": "0.22.14",
+    "typescript": "7.0.2",
+    "ultracite": "7.10.7",
+    "unrun": "0.3.1"
+  },
+  "lint-staged": {
+    "*.{js,ts,json,jsonc,md,mdx}": [
+      "ultracite fix"
+    ]
+  },
+  "packageManager": "bun@1.3.14"
+}

package/dist/client.d.ts

@@ -1,53 +0,0 @@
-import { OAuthTokenManager } from "./oauth";
-import type { FrontConfig } from "./types";
-export declare class FrontClient {
-    private apiKey?;
-    private oauthManager?;
-    constructor(config: FrontConfig);
-    private setApiKey;
-    request<T>(options: {
-        method: string;
-        path: string;
-        body?: unknown;
-        params?: Record<string, unknown>;
-    }): Promise<T>;
-    private requestWithRetry;
-    /**
-     * Calculate retry delay based on retry-after header and exponential backoff
-     */
-    private getRetryDelay;
-    /**
-     * Calculate exponential backoff delay with jitter
-     */
-    private calculateExponentialBackoff;
-    /**
-     * Sleep for the specified number of milliseconds
-     */
-    private sleep;
-    /**
-     * Get the appropriate auth token (OAuth access token or API key)
-     */
-    private getAuthToken;
-    /**
-     * Handle the response from the API
-     */
-    private handleResponse;
-    get<T>(path: string, params?: Record<string, unknown>): Promise<T>;
-    post<T>(path: string, body?: unknown): Promise<T>;
-    put<T>(path: string, body?: unknown): Promise<T>;
-    patch<T>(path: string, body?: unknown): Promise<T>;
-    delete<T>(path: string, body?: unknown): Promise<T>;
-    /**
-     * Get the OAuth token manager (if using OAuth)
-     */
-    getOAuthManager(): OAuthTokenManager | undefined;
-    /**
-     * Check if the client is using OAuth authentication
-     */
-    isUsingOAuth(): boolean;
-    /**
-     * Update OAuth configuration (useful for updating tokens)
-     */
-    updateOAuthConfig(updates: Partial<import("./types").OAuthConfig>): void;
-}
-//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,SAAS,CAAA;AAUtD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAC,CAAmB;gBAE5B,MAAM,EAAE,WAAW;IAkB/B,OAAO,CAAC,SAAS;IASX,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE;QACxB,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACjC,GAAG,OAAO,CAAC,CAAC,CAAC;YAIA,gBAAgB;IAgG9B;;OAEG;IACH,OAAO,CAAC,aAAa;IAyBrB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgBnC;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;YACW,cAAc;IAyBtB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,iBAAiB,GAAG,SAAS;IAIhD;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,SAAS,EAAE,WAAW,CAAC,GAAG,IAAI;CAMzE"}

package/dist/client.js

@@ -1,230 +0,0 @@
-import { client } from "./generated/client.gen";
-import { OAuthTokenManager } from "./oauth";
-// Rate limiting configuration
-const RATE_LIMIT_CONFIG = {
-    maxRetries: 3,
-    baseDelay: 1_000, // 1 second
-    maxDelay: 30_000, // 30 seconds
-    jitterFactor: 0.2, // 20% jitter to avoid thundering herd problem
-};
-export class FrontClient {
-    apiKey;
-    oauthManager;
-    constructor(config) {
-        client.setConfig({
-            baseUrl: config.baseUrl || "https://api2.frontapp.com",
-        });
-        if (config.apiKey) {
-            this.setApiKey(config.apiKey);
-        }
-        if (config.oauth) {
-            // OAuth configuration provided
-            this.oauthManager = new OAuthTokenManager(config.oauth);
-        }
-        // Maybe exit here if no auth method is provided
-        if (!this.apiKey && !this.oauthManager) {
-            throw new Error("API key or OAuth configuration is required");
-        }
-    }
-    setApiKey(apiKey) {
-        this.apiKey = apiKey;
-        client.setConfig({
-            headers: {
-                Authorization: `Bearer ${apiKey}`,
-            },
-        });
-    }
-    async request(options) {
-        return this.requestWithRetry(options, 0);
-    }
-    async requestWithRetry(options, retryCount) {
-        const { method, path, body, params } = options;
-        // Build URL with query parameters
-        const baseUrl = client.getConfig().baseUrl ??
-            "https://api2.frontapp.com";
-        const url = new URL(path, baseUrl);
-        if (params) {
-            Object.entries(params).forEach(([key, value]) => {
-                if (value !== undefined && value !== null) {
-                    url.searchParams.append(key, String(value));
-                }
-            });
-        }
-        // Get the authorization token (OAuth or API key)
-        const authToken = this.getAuthToken();
-        // Prepare headers
-        const headers = {
-            Authorization: `Bearer ${authToken}`,
-            Accept: "application/json",
-        };
-        // Add content-type for requests with body
-        if (body) {
-            headers["Content-Type"] = "application/json";
-        }
-        // Prepare fetch options
-        const fetchOptions = {
-            method,
-            headers,
-        };
-        // Add body for non-GET requests
-        if (body) {
-            fetchOptions.body = JSON.stringify(body);
-        }
-        try {
-            const response = await fetch(url, fetchOptions);
-            // Handle token expiration for OAuth
-            if (response.status === 401 && this.oauthManager) {
-                // Token might be expired, try to refresh and retry once
-                const refreshedToken = await this.oauthManager.refreshToken();
-                // Token was refreshed, retry the request
-                headers.Authorization = `Bearer ${refreshedToken}`;
-                const retryResponse = await fetch(url.toString(), {
-                    ...fetchOptions,
-                    headers,
-                });
-                return this.handleResponse(retryResponse);
-            }
-            // Handle rate limiting (429 status)
-            if (response.status === 429) {
-                if (retryCount < RATE_LIMIT_CONFIG.maxRetries) {
-                    const retryAfterMs = this.getRetryDelay(response, retryCount);
-                    await this.sleep(retryAfterMs);
-                    return this.requestWithRetry(options, retryCount + 1);
-                }
-                // Max retries exceeded, handle as normal error response
-            }
-            return this.handleResponse(response);
-        }
-        catch (error) {
-            if (error instanceof Error && "status" in error) {
-                // Re-throw Front API errors
-                throw error;
-            }
-            // Handle network or other errors - retry if we haven't exceeded max retries
-            if (retryCount < RATE_LIMIT_CONFIG.maxRetries) {
-                const retryAfterMs = this.calculateExponentialBackoff(retryCount);
-                await this.sleep(retryAfterMs);
-                return this.requestWithRetry(options, retryCount + 1);
-            }
-            // Max retries exceeded for network errors
-            throw new Error(`Request failed after ${RATE_LIMIT_CONFIG.maxRetries} retries: ${error instanceof Error ? error.message : "Unknown error"}`);
-        }
-    }
-    /**
-     * Calculate retry delay based on retry-after header and exponential backoff
-     */
-    getRetryDelay(response, retryCount) {
-        const retryAfterHeader = response.headers.get("retry-after");
-        let retryAfterMs = 0;
-        if (retryAfterHeader) {
-            // retry-after can be in seconds (integer) or HTTP date
-            const retryAfterSeconds = Number.parseInt(retryAfterHeader, 10);
-            if (!Number.isNaN(retryAfterSeconds)) {
-                retryAfterMs = retryAfterSeconds * 1000;
-            }
-            else {
-                // Try parsing as HTTP date
-                const retryAfterDate = new Date(retryAfterHeader);
-                if (!Number.isNaN(retryAfterDate.getTime())) {
-                    retryAfterMs = Math.max(0, retryAfterDate.getTime() - Date.now());
-                }
-            }
-        }
-        // Calculate exponential backoff delay
-        const exponentialBackoffMs = this.calculateExponentialBackoff(retryCount);
-        // Use the maximum of retry-after and exponential backoff to ensure we wait AT LEAST retry-after time
-        return Math.max(retryAfterMs, exponentialBackoffMs);
-    }
-    /**
-     * Calculate exponential backoff delay with jitter
-     */
-    calculateExponentialBackoff(retryCount) {
-        const { baseDelay, maxDelay, jitterFactor } = RATE_LIMIT_CONFIG;
-        // Calculate exponential delay: baseDelay * (2 ^ retryCount)
-        const exponentialDelay = baseDelay * 2 ** retryCount;
-        // Apply maximum delay cap
-        const cappedDelay = Math.min(exponentialDelay, maxDelay);
-        // Add jitter to avoid thundering herd problem
-        // Jitter is a random value between +-jitterFactor of the delay
-        const jitter = cappedDelay * jitterFactor * (Math.random() * 2 - 1);
-        return Math.max(0, cappedDelay + jitter);
-    }
-    /**
-     * Sleep for the specified number of milliseconds
-     */
-    sleep(ms) {
-        return new Promise((resolve) => setTimeout(resolve, ms));
-    }
-    /**
-     * Get the appropriate auth token (OAuth access token or API key)
-     */
-    getAuthToken() {
-        if (this.oauthManager) {
-            return this.oauthManager.getAccessToken();
-        }
-        if (!this.apiKey) {
-            throw new Error("No authentication method available. This should not happen with proper configuration.");
-        }
-        return this.apiKey;
-    }
-    /**
-     * Handle the response from the API
-     */
-    async handleResponse(response) {
-        // Handle non-JSON responses (like 204 No Content)
-        if (response.status === 204) {
-            return {};
-        }
-        const responseData = await response.json();
-        if (!response.ok) {
-            // Type guard for error response structure
-            const errorData = responseData;
-            const error = {
-                message: (typeof errorData.message === "string"
-                    ? errorData.message
-                    : undefined) || `HTTP ${response.status}: ${response.statusText}`,
-                status: response.status,
-                code: typeof errorData.code === "string" ? errorData.code : undefined,
-            };
-            throw error;
-        }
-        return responseData;
-    }
-    async get(path, params) {
-        return this.request({ method: "GET", path, params });
-    }
-    async post(path, body) {
-        return this.request({ method: "POST", path, body });
-    }
-    async put(path, body) {
-        return this.request({ method: "PUT", path, body });
-    }
-    async patch(path, body) {
-        return this.request({ method: "PATCH", path, body });
-    }
-    async delete(path, body) {
-        return this.request({ method: "DELETE", path, body });
-    }
-    /**
-     * Get the OAuth token manager (if using OAuth)
-     */
-    getOAuthManager() {
-        return this.oauthManager;
-    }
-    /**
-     * Check if the client is using OAuth authentication
-     */
-    isUsingOAuth() {
-        return !!this.oauthManager;
-    }
-    /**
-     * Update OAuth configuration (useful for updating tokens)
-     */
-    updateOAuthConfig(updates) {
-        if (!this.oauthManager) {
-            throw new Error("OAuth is not configured for this client");
-        }
-        this.oauthManager.updateConfig(updates);
-    }
-}
-//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/core/client.d.ts

@@ -1,36 +0,0 @@
-import type { Client as GeneratedClient } from "../generated/client/types.gen";
-import type { FrontConfig } from "../types";
-/**
- * Core HTTP client used by the SDK's handwritten resources.
- *
- * Responsibilities:
- * - Configure and expose the generated HTTP client
- * - Inject authentication (API key or OAuth) into every request
- * - Refresh OAuth tokens on 401 responses and retry once
- * - Normalize thrown errors into `FrontError` subclasses
- */
-export declare class APIClient {
-    private readonly gen;
-    private apiKey?;
-    private oauthManager?;
-    private readonly maxRetries;
-    /**
-     * Create a new API client.
-     *
-     * @param config - Front configuration including API key or OAuth settings and optional overrides
-     */
-    constructor(config?: FrontConfig & {
-        maxRetries?: number;
-    });
-    /**
-     * Access the configured generated client for low-level operations.
-     */
-    getGenClient(): GeneratedClient;
-    /**
-     * Resolve the current auth token used for requests.
-     *
-     * @throws FrontError when credentials are missing
-     */
-    private getAuthToken;
-}
-//# sourceMappingURL=client.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAG9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAK3C;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAEnC;;;;OAIG;gBACS,MAAM,CAAC,EAAE,WAAW,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAoD1D;;OAEG;IACH,YAAY,IAAI,eAAe;IAI/B;;;;OAIG;YACW,YAAY;CAK3B"}

package/dist/core/client.js

@@ -1,89 +0,0 @@
-import { client as generatedClient } from "../generated/client.gen";
-import { OAuthTokenManager } from "../oauth";
-import { FrontError, mapToFrontError } from "./errors";
-const DEFAULT_MAX_RETRIES = 3;
-/**
- * Core HTTP client used by the SDK's handwritten resources.
- *
- * Responsibilities:
- * - Configure and expose the generated HTTP client
- * - Inject authentication (API key or OAuth) into every request
- * - Refresh OAuth tokens on 401 responses and retry once
- * - Normalize thrown errors into `FrontError` subclasses
- */
-export class APIClient {
-    gen;
-    apiKey;
-    oauthManager;
-    maxRetries;
-    /**
-     * Create a new API client.
-     *
-     * @param config - Front configuration including API key or OAuth settings and optional overrides
-     */
-    constructor(config) {
-        this.gen = generatedClient;
-        this.maxRetries = config?.maxRetries ?? DEFAULT_MAX_RETRIES;
-        // Set Auth credentials
-        if (config?.oauth) {
-            this.oauthManager = new OAuthTokenManager(config.oauth);
-        }
-        if (config?.apiKey || process.env.FRONT_API_KEY) {
-            this.apiKey = config?.apiKey ?? process.env.FRONT_API_KEY;
-        }
-        if (!this.apiKey && !this.oauthManager) {
-            throw new Error("API key or OAuth configuration is required");
-        }
-        this.gen.setConfig({
-            baseUrl: config?.baseUrl ?? "https://api2.frontapp.com",
-            throwOnError: true,
-            responseStyle: "fields",
-            // Use the generated client's `auth` hook to inject the token per request
-            auth: async (auth) => {
-                const token = await this.getAuthToken();
-                if (!token)
-                    return undefined;
-                if (auth.scheme === "bearer")
-                    return token;
-                return token;
-            },
-        });
-        // Install a response interceptor to handle 401 with OAuth and retry logic
-        this.gen.interceptors.response.use(async (response, request) => {
-            if (response.status !== 401 || !this.oauthManager)
-                return response;
-            // Attempt only a single refresh + retry to avoid loops
-            const refreshed = await this.oauthManager.refreshToken();
-            // Clone request with new Authorization token
-            const headers = new Headers(request.headers);
-            headers.set("Authorization", `Bearer ${refreshed}`);
-            const retryReq = new Request(request, { headers });
-            const cfg = this.gen.getConfig();
-            const fetchImpl = cfg.fetch ?? globalThis.fetch;
-            return fetchImpl(retryReq);
-        });
-        // Normalize thrown errors
-        this.gen.interceptors.error.use(async (err, response) => {
-            throw mapToFrontError(err, response);
-        });
-    }
-    /**
-     * Access the configured generated client for low-level operations.
-     */
-    getGenClient() {
-        return this.gen;
-    }
-    /**
-     * Resolve the current auth token used for requests.
-     *
-     * @throws FrontError when credentials are missing
-     */
-    async getAuthToken() {
-        if (this.apiKey)
-            return this.apiKey;
-        if (this.oauthManager)
-            return this.oauthManager.getAccessToken();
-        throw new FrontError("Missing credentials", 401, "auth_error");
-    }
-}
-//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

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

package/dist/core/errors.d.ts

@@ -1,55 +0,0 @@
-/**
- * Base Front SDK error. All SDK errors extend this class.
- */
-export declare class FrontError extends Error {
-    readonly status?: number | undefined;
-    readonly code?: string | undefined;
-    readonly details?: unknown | undefined;
-    readonly headers?: Headers | undefined;
-    constructor(message: string, status?: number | undefined, code?: string | undefined, details?: unknown | undefined, headers?: Headers | undefined);
-}
-/** 400 Bad Request */
-export declare class FrontBadRequestError extends FrontError {
-    constructor(...args: ConstructorParameters<typeof FrontError>);
-}
-/** 401 Unauthorized */
-export declare class FrontUnauthorizedError extends FrontError {
-    constructor(...args: ConstructorParameters<typeof FrontError>);
-}
-/** 403 Forbidden */
-export declare class FrontForbiddenError extends FrontError {
-    constructor(...args: ConstructorParameters<typeof FrontError>);
-}
-/** 404 Not Found */
-export declare class FrontNotFoundError extends FrontError {
-    constructor(...args: ConstructorParameters<typeof FrontError>);
-}
-/** 409 Conflict */
-export declare class FrontConflictError extends FrontError {
-    constructor(...args: ConstructorParameters<typeof FrontError>);
-}
-/** 422 Unprocessable Entity */
-export declare class FrontUnprocessableEntityError extends FrontError {
-    constructor(...args: ConstructorParameters<typeof FrontError>);
-}
-/** 429 Too Many Requests */
-export declare class FrontRateLimitError extends FrontError {
-    constructor(...args: ConstructorParameters<typeof FrontError>);
-}
-/** 5xx Server Error */
-export declare class FrontServerError extends FrontError {
-    constructor(...args: ConstructorParameters<typeof FrontError>);
-}
-/**
- * Normalize unknown errors (thrown by fetch/generated client) into FrontError subclasses.
- *
- * - Preserves HTTP status and headers when available
- * - Attempts to read `message` and `code` from the thrown payload
- * - Maps common HTTP status codes to specific subclasses for easier matching
- *
- * @param error - The unknown error payload (string/object/Error)
- * @param response - The corresponding `Response`, if available
- * @returns A typed `FrontError` subclass
- */
-export declare function mapToFrontError(error: unknown, response?: Response): FrontError;
-//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;aAGjB,MAAM,CAAC,EAAE,MAAM;aACf,IAAI,CAAC,EAAE,MAAM;aACb,OAAO,CAAC,EAAE,OAAO;aACjB,OAAO,CAAC,EAAE,OAAO;gBAJjC,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,OAAO,CAAC,EAAE,OAAO,YAAA,EACjB,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,sBAAsB;AACtB,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,UAAU,CAAC;CAI9D;AACD,uBAAuB;AACvB,qBAAa,sBAAuB,SAAQ,UAAU;gBACxC,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,UAAU,CAAC;CAI9D;AACD,oBAAoB;AACpB,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,UAAU,CAAC;CAI9D;AACD,oBAAoB;AACpB,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,UAAU,CAAC;CAI9D;AACD,mBAAmB;AACnB,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,UAAU,CAAC;CAI9D;AACD,+BAA+B;AAC/B,qBAAa,6BAA8B,SAAQ,UAAU;gBAC/C,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,UAAU,CAAC;CAI9D;AACD,4BAA4B;AAC5B,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,UAAU,CAAC;CAI9D;AACD,uBAAuB;AACvB,qBAAa,gBAAiB,SAAQ,UAAU;gBAClC,GAAG,IAAI,EAAE,qBAAqB,CAAC,OAAO,UAAU,CAAC;CAI9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,QAAQ,GAClB,UAAU,CA6CZ"}