@kwik-id/sdk-react-native 0.0.0-stage → 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2026 Kwik Nkap Technologies. All rights reserved.
+
+This software and its source code (the "Software") are the proprietary and
+confidential property of Kwik Nkap Technologies.
+
+Kwik Nkap Technologies grants you a limited, non-exclusive, non-transferable,
+revocable license to install and use the Software solely to integrate KwikID
+identity verification into your applications, in accordance with your agreement
+with Kwik Nkap Technologies.
+
+You may not, except as expressly permitted in writing by Kwik Nkap Technologies:
+copy, modify, or create derivative works of the Software; distribute, sublicense,
+sell, or otherwise make the Software available to third parties other than as
+part of your application; or reverse engineer the Software or use it to build a
+competing product or service.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL KWIK NKAP
+TECHNOLOGIES BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
+THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,313 @@
-# Temporary Holding Version
+# @kwik-id/sdk-react-native
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+On-device identity verification (KYC) for React Native / Expo apps, by
+[KwikID](https://identity.kwiknkap.com). The SDK runs the same flow as the KwikID web
+SDK, natively: pick a document → photograph the front (and back) → take a selfie →
+upload → submit. Camera capture uses
+[`react-native-vision-camera`](https://react-native-vision-camera.com/).
+
+> **Alpha.** This release captures documents and a selfie and submits them for
+> verification. It does **not** yet run on-device liveness (passive or active
+> challenges), image-quality checks, or the desktop→mobile handoff UI. Those land in
+> later alphas. No client-side liveness result is sent with the submission. Expect
+> breaking changes between alpha versions.
+
+## Requirements
+
+- **Expo SDK 53** (React Native 0.79, React 19).
+- **A custom dev build or EAS build.** The SDK uses native camera modules and
+  **does not run in Expo Go**. In Expo Go, `KwikIdRNSDK.initialize()` throws an
+  error that explains how to switch to a dev build, and the verification modal shows
+  that message.
+- A physical device for capture testing. Simulators/emulators have no real camera.
+- A KwikID account and API key from the [KwikID dashboard](https://identity.kwiknkap.com).
+
+## Installation
+
+```sh
+npx expo install @kwik-id/sdk-react-native react-native-vision-camera \
+  expo-image-manipulator expo-file-system expo-device expo-localization expo-constants
+```
+
+Use `npx expo install` (not plain `npm install`) so the Expo modules resolve to the
+versions that match your Expo SDK.
+
+`react-native-reanimated`, `react-native-worklets-core` and
+`react-native-vision-camera-face-detector` are optional peers for now. You don't need
+them in this alpha; they become required once on-device liveness ships.
+
+### 1. Add the config plugins (`app.json` / `app.config.js`)
+
+```jsonc
+{
+    "expo": {
+        "plugins": [
+            "react-native-vision-camera",
+            [
+                "@kwik-id/sdk-react-native",
+                { "cameraPermissionText": "We use the camera to verify your identity" },
+            ],
+        ],
+    },
+}
+```
+
+The KwikID plugin adds the camera permission on both platforms
+(`NSCameraUsageDescription` on iOS, `android.permission.CAMERA` on Android).
+`cameraPermissionText` is optional; it is the text iOS shows in the permission prompt.
+
+### 2. Prebuild and run a dev build
+
+```sh
+npx expo prebuild
+npx expo run:ios      # or: npx expo run:android
+# or build in the cloud: eas build --profile development
+```
+
+Re-run `expo prebuild` whenever you add or change config plugins.
+
+## How it works
+
+1. **Your backend** creates a verification session with your secret API key and gets
+   back a short-lived session `token`. Never put your API key in the app.
+2. **Your app** passes that token to the SDK as `clientSecret` and opens the flow.
+3. The SDK guides the user through capture, uploads the images and submits the
+   verification. `start()` resolves with `status: "submitted"` and a `jobId`.
+4. **KwikID** processes the verification asynchronously and sends the result to your
+   backend by **webhook**. The app does not receive the final verified/rejected
+   decision.
+
+### Create a session on your backend
+
+With [`@kwik-id/sdk-node`](https://www.npmjs.com/package/@kwik-id/sdk-node):
+
+```ts
+import { KwikIDNode } from "@kwik-id/sdk-node";
+
+const kwikId = new KwikIDNode({ apiKey: process.env.KWIKID_API_KEY! });
+
+// e.g. in your POST /kyc/session route
+const session = await kwikId.createSession({
+    referenceId: user.id, // your own user/order ID; echoed back in webhooks
+    userName: user.name,
+    userEmail: user.email,
+});
+
+return { clientSecret: session.token, jobId: session.jobId };
+```
+
+Or call the REST API directly: `POST /api/v1/sessions` with an `X-API-Key` header.
+The response's `token` is the `clientSecret`.
+
+Session tokens expire. Create a new session for each verification attempt, just
+before you open the flow.
+
+## Usage
+
+### Quick start: `useKwikVerification`
+
+The hook gives you a `start()` function that opens the full-screen verification flow
+and resolves when the user finishes or closes it. Render `<kyc.Modal />` once,
+anywhere in the component.
+
+```tsx
+import { useKwikVerification } from "@kwik-id/sdk-react-native";
+import { Alert, Button } from "react-native";
+
+export function VerifyIdentityButton({ clientSecret }: { clientSecret: string }) {
+    const kyc = useKwikVerification({
+        clientSecret,
+        appName: "Acme Bank", // optional: header title (defaults to your org name)
+    });
+
+    const verify = async () => {
+        const outcome = await kyc.start();
+
+        switch (outcome.status) {
+            case "submitted":
+                // Documents are in. The final decision arrives at your backend by webhook.
+                Alert.alert("Thanks!", "Your documents were submitted for review.");
+                break;
+            case "cancelled":
+                // The user closed the flow.
+                break;
+            case "error":
+                // The flow ended on an error screen (expired session, network, etc.).
+                console.warn("KYC failed:", outcome.error?.message);
+                break;
+        }
+    };
+
+    return (
+        <>
+            <Button title="Verify identity" onPress={verify} />
+            <kyc.Modal />
+        </>
+    );
+}
+```
+
+Fetching the session token right before opening the flow:
+
+```tsx
+const [clientSecret, setClientSecret] = useState("");
+const kyc = useKwikVerification({ clientSecret });
+
+const verify = async () => {
+    const res = await fetch("https://your-backend.example.com/kyc/session", { method: "POST" });
+    setClientSecret((await res.json()).clientSecret);
+};
+
+// Open once the token is in state, so the modal receives it.
+useEffect(() => {
+    if (clientSecret) kyc.start().then(handleOutcome);
+}, [clientSecret]);
+```
+
+#### Options
+
+| Option          | Type                                | Default                             | Description                                                                                            |
+| --------------- | ----------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `clientSecret`  | `string`                            | **required**                        | Session token from your backend.                                                                       |
+| `appName`       | `string`                            | org name from the session           | Title shown in the flow's header.                                                                      |
+| `locale`        | `"en" \| "fr"`                      | device language                     | UI language. If omitted, the SDK uses French when the device language is French and English otherwise. |
+| `theme`         | `KwikIdTheme`                       | KwikID blue on white                | Colors; see [Theming](#theming).                                                                       |
+| `documentTypes` | `DocumentType[]`                    | all types enabled for your org      | Restrict which documents the user can pick. Intersected with your session's configuration.             |
+| `onSubmitted`   | `({ jobId }) => void`               | none                                | Called as soon as the submission succeeds, before the user taps Done.                                  |
+| `baseUrl`       | `string`                            | `https://api.identity.kwiknkap.com` | API base URL. Override only to target a non-production environment.                                    |
+| `livenessMode`  | `"passive" \| "active" \| "hybrid"` | none                                | **Not yet supported.** Accepted but ignored until on-device liveness ships.                            |
+
+#### Return value
+
+| Field    | Type                                 | Description                                                                 |
+| -------- | ------------------------------------ | --------------------------------------------------------------------------- |
+| `start`  | `() => Promise<VerificationOutcome>` | Opens the flow. Resolves when the user finishes or closes it.               |
+| `cancel` | `() => void`                         | Closes the flow programmatically; a pending `start()` resolves `cancelled`. |
+| `isOpen` | `boolean`                            | Whether the flow is currently open.                                         |
+| `Modal`  | `React.FC`                           | Render once; the verification UI mounts here.                               |
+
+#### `VerificationOutcome`
+
+```ts
+interface VerificationOutcome {
+    status: "submitted" | "cancelled" | "error";
+    jobId?: string; // set when status is "submitted"
+    error?: Error; // set when status is "error"
+}
+```
+
+`"submitted"` means the documents were received, **not** that the user is verified.
+Use the webhook (or `getVerificationResult(jobId)` in `@kwik-id/sdk-node`) to read the
+decision.
+
+### Declarative: `<KwikIDVerificationModal />`
+
+If you prefer to control visibility yourself:
+
+```tsx
+import { KwikIDVerificationModal } from "@kwik-id/sdk-react-native";
+
+<KwikIDVerificationModal
+    visible={open}
+    clientSecret={clientSecret}
+    locale="fr"
+    onSubmitted={({ jobId }) => saveJobId(jobId)}
+    onComplete={(outcome) => {
+        setOpen(false);
+        handleOutcome(outcome);
+    }}
+/>;
+```
+
+It takes the same options as the hook, plus `visible`, `onComplete(outcome)` (always
+called when the flow ends, including on cancel) and `onClose()` (called only when the
+user dismisses the flow).
+
+### Theming
+
+```ts
+useKwikVerification({
+    clientSecret,
+    theme: {
+        primary: "#0F766E", // buttons, progress bar, accents (default #1E3A8A)
+        background: "#FFFFFF", // screen background
+        foreground: "#111111", // text
+    },
+});
+```
+
+The built-in flow currently uses `primary`, `background` and `foreground`. `accent`,
+`error` and `success` are reserved for upcoming screens.
+
+### Localization
+
+The flow ships with **English** and **French**. Without a `locale` option it follows
+the device language. Pass `locale` to force a language, e.g. to match an in-app
+language setting. Other device languages fall back to English.
+
+### Document types
+
+`passport`, `id_card`, `drivers_license`, `voters_card` and `residence_permit`.
+National ID cards, driver's licenses and voter's cards ask for front and back;
+passports and residence permits need only the front. If your
+session configuration doesn't list any document types, the user can choose from
+passport, national ID card and driver's license.
+
+## Error handling and timeouts
+
+When something goes wrong, the flow shows an error screen and `start()` resolves with
+`status: "error"` after the user taps Done. Common causes:
+
+- **Expired session:** the user sees "Your verification session has expired." Create
+  a new session and start again.
+- **Network problems:** each API request and each upload times out after **30
+  seconds**. For uploads the timer restarts whenever upload progress is reported, so a
+  slow upload that's still moving is not cut off; only a stalled one is cancelled.
+- **Camera permission denied:** the flow shows a screen with an **Open Settings**
+  button. The user can grant access there and come back to continue.
+- **Expo Go:** see [Requirements](#requirements).
+
+## Advanced: headless SDK
+
+`KwikIdRNSDK` is the engine behind the built-in UI. Use it if you build your own
+capture screens. You are then responsible for capture, compression (`compressCapture`)
+and calling the API in the right order.
+
+```ts
+import { KwikIdRNSDK } from "@kwik-id/sdk-react-native";
+
+const sdk = new KwikIdRNSDK({ clientSecret, timeout: 30_000, debug: __DEV__ });
+
+const session = await sdk.initialize(); // validates the token; throws in Expo Go
+sdk.on("upload:progress", ({ type, progress }) => console.log(type, progress));
+
+await sdk.uploadCapture("document_front", frontAsset);
+await sdk.uploadCapture("document_back", backAsset); // not for passports
+await sdk.uploadCapture("selfie", selfieAsset);
+const { jobId } = await sdk.submit("id_card");
+
+sdk.destroy();
+```
+
+Events emitted today: `ready`, `error`, `session:created`, `upload:starting`,
+`upload:progress`, `upload:complete`, `upload:failed`, `verification:submitting`,
+`verification:submitted`, `verification:failed`. The other event names in
+`KwikIdEvents` are reserved for liveness and handoff and are not emitted yet.
+
+`CameraView` (the capture component used by the built-in flow) is also exported for
+custom screens.
+
+## Troubleshooting
+
+| Symptom                                             | Fix                                                                                                         |
+| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| "This SDK requires a custom dev build or EAS build" | You're in Expo Go. Run `npx expo prebuild` and `npx expo run:ios` / `run:android`, or use an EAS dev build. |
+| Camera preview is black / no camera found           | Use a physical device, and check that the vision-camera and KwikID plugins are in `app.json`, then rebuild. |
+| iOS crashes when the camera opens                   | `NSCameraUsageDescription` is missing: add the KwikID config plugin and re-run `expo prebuild`.             |
+| "Your verification session has expired"             | Session tokens are short-lived. Create a new session right before calling `start()`.                        |
+
+## License
+
+Proprietary. Copyright © 2026 Kwik Nkap Technologies. All rights reserved. Use is
+subject to the terms in the [LICENSE](./LICENSE) file and your agreement with Kwik Nkap
+Technologies.

package/app.plugin.js

@@ -0,0 +1,40 @@
+/**
+ * Expo config plugin for @kwik-id/sdk-react-native.
+ *
+ * Adds the native camera permissions required by react-native-vision-camera.
+ * Babel-level requirements (react-native-worklets-core/plugin and
+ * react-native-reanimated/plugin) live in the consumer's babel.config.js — see README.
+ *
+ * Usage (app.json):
+ *   "plugins": [
+ *     "react-native-vision-camera",
+ *     ["@kwik-id/sdk-react-native", { "cameraPermissionText": "..." }]
+ *   ]
+ *
+ * NOTE: requires `expo prebuild` + a custom dev build / EAS build. Will NOT run in Expo Go.
+ */
+const { withInfoPlist, withAndroidManifest, AndroidConfig } = require("expo/config-plugins");
+
+const DEFAULT_CAMERA_TEXT = "We need camera access to verify your identity";
+
+/** @param {import('expo/config-plugins').ExpoConfig} config */
+const withKwikId = (config, props = {}) => {
+    const cameraPermissionText = props.cameraPermissionText || DEFAULT_CAMERA_TEXT;
+
+    // iOS — NSCameraUsageDescription
+    config = withInfoPlist(config, (cfg) => {
+        cfg.modResults.NSCameraUsageDescription =
+            cfg.modResults.NSCameraUsageDescription || cameraPermissionText;
+        return cfg;
+    });
+
+    // Android — CAMERA permission
+    config = withAndroidManifest(config, (cfg) => {
+        AndroidConfig.Permissions.ensurePermissions(cfg.modResults, ["android.permission.CAMERA"]);
+        return cfg;
+    });
+
+    return config;
+};
+
+module.exports = withKwikId;

package/lib/commonjs/api/api-client.js

@@ -0,0 +1,213 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_BASE_URL = exports.ApiClient = void 0;
+var _apiError = require("./api-error.js");
+var _upload = require("./upload.js");
+/**
+ * RN API client for the KwikId SDK gateway (`/sdk/v1/*`).
+ *
+ * Ported from @kwik-id/sdk-core: the JSON `request()` (fetch + AbortController) is
+ * unchanged; the XMLHttpRequest upload is replaced with an injectable multipart
+ * uploader (expo-file-system by default). `liveness_frame` has no server endpoint
+ * and is rejected.
+ */
+
+const DEFAULT_BASE_URL = exports.DEFAULT_BASE_URL = "https://api.identity.kwiknkap.com";
+const CAPTURE_PATH = {
+  document_front: "front",
+  document_back: "back",
+  selfie: "selfie",
+  liveness_frame: null // no server endpoint — liveness evidence rides in /submit
+};
+class ApiClient {
+  constructor(sessionManager, config) {
+    this.config = {
+      baseUrl: DEFAULT_BASE_URL,
+      timeout: 30000,
+      debug: false,
+      ...config
+    };
+    this.sessionManager = sessionManager;
+    this.uploader = config?.uploader ?? _upload.uploadMultipart;
+  }
+  async validateSession(clientSecret) {
+    await this.sessionManager.initializeFromClientSecret(clientSecret);
+    const response = await this.request("GET", "/sdk/v1/session");
+    this.sessionManager.updateSession({
+      expiresAt: new Date(response.expiresAt)
+    });
+    return response;
+  }
+  async uploadCapture(type, asset, onProgress) {
+    const path = CAPTURE_PATH[type];
+    if (!path) {
+      throw new Error(`Unsupported capture type for upload: ${type}`);
+    }
+    const url = `${this.config.baseUrl}/sdk/v1/upload/${path}`;
+    const headers = this.sessionManager.getRequestHeaders();
+    return this.uploader({
+      url,
+      asset,
+      headers,
+      onProgress,
+      timeoutMs: this.config.timeout
+    });
+  }
+  async submitVerification(documentType, clientAnalysis) {
+    const payload = await this.sessionManager.createSecurePayload({
+      documentType,
+      clientAnalysis,
+      submittedAt: Date.now()
+    });
+    return this.request("POST", "/sdk/v1/submit", payload);
+  }
+  async getStatus() {
+    return this.request("GET", "/sdk/v1/status");
+  }
+  async getResult() {
+    return this.request("GET", "/sdk/v1/result");
+  }
+  async pollForResult(options = {}) {
+    const {
+      maxAttempts = 60,
+      intervalMs = 2000,
+      onProgress
+    } = options;
+    let attempts = 0;
+    while (attempts < maxAttempts) {
+      const status = await this.getStatus();
+      onProgress?.(status);
+      if (status.status === "verified") {
+        return this.getResult();
+      }
+      if (status.status === "rejected") {
+        const result = await this.getResult();
+        const contextualError = status.errorDetails ? `${status.errorDetails.document === "front" ? "Front" : "Back"} document: ${status.errorDetails.errorMessage}` : undefined;
+        return {
+          ...result,
+          status: "rejected",
+          errorDetails: status.errorDetails,
+          rejectionReasons: [contextualError || status.errorMessage || "Verification rejected"]
+        };
+      }
+      if (status.status === "failed") {
+        // A failed job may have no result record, so fall back to a minimal one.
+        const result = await this.getResult().catch(() => ({
+          jobId: status.jobId,
+          status: "rejected",
+          overallScore: 0,
+          scores: {
+            documentQuality: 0,
+            documentAuthenticity: 0,
+            faceMatch: 0,
+            liveness: 0
+          },
+          timestamps: {
+            submitted: ""
+          },
+          referenceId: ""
+        }));
+        return {
+          ...result,
+          // VerificationResult has no "failed" status (it mirrors sdk-core).
+          status: "rejected",
+          errorDetails: status.errorDetails,
+          rejectionReasons: [status.errorDetails?.errorMessage || status.errorMessage || "Verification failed"]
+        };
+      }
+      attempts++;
+      await this.delay(intervalMs);
+    }
+    throw new Error("Verification timeout");
+  }
+
+  // ---- Handoff (mobile redeemer) ----
+
+  async validateHandoff(code) {
+    const url = `${this.config.baseUrl}/sdk/v1/handoff/${encodeURIComponent(code)}`;
+    const fetchFn = this.config.fetch || fetch;
+    const response = await fetchFn(url);
+    if (!response.ok) {
+      return {
+        valid: false,
+        error: `Validation failed: ${response.status}`
+      };
+    }
+    return await response.json();
+  }
+  async redeemHandoff(code) {
+    const url = `${this.config.baseUrl}/sdk/v1/handoff/${encodeURIComponent(code)}/redeem`;
+    const fetchFn = this.config.fetch || fetch;
+    const response = await fetchFn(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new _apiError.ApiError(error.message || `Redeem failed: ${response.status}`, response.status);
+    }
+    return await response.json();
+  }
+  async reportHandoffStatus(code, status) {
+    await this.request("POST", `/sdk/v1/handoff/${encodeURIComponent(code)}/status`, {
+      status
+    });
+  }
+  getBaseUrl() {
+    return this.config.baseUrl;
+  }
+  async request(method, path, body) {
+    const url = `${this.config.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const headers = {
+        "Content-Type": "application/json",
+        ...this.sessionManager.getRequestHeaders()
+      };
+      const fetchFn = this.config.fetch || fetch;
+      const response = await fetchFn(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        throw await this.parseErrorResponse(response);
+      }
+      const data = await response.json();
+      if (this.config.debug) {
+        console.log(`[KwikID API] ${method} ${path}`, {
+          body,
+          response: data
+        });
+      }
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new Error("Request timeout");
+      }
+      throw error;
+    }
+  }
+  async parseErrorResponse(response) {
+    try {
+      const data = await response.json();
+      return new _apiError.ApiError(data.message || `API error: ${response.status}`, response.status, data.code, data.details);
+    } catch {
+      return new _apiError.ApiError(`API error: ${response.status}`, response.status);
+    }
+  }
+  delay(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+  }
+}
+exports.ApiClient = ApiClient;
+//# sourceMappingURL=api-client.js.map

package/lib/commonjs/api/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_apiError","require","_upload","DEFAULT_BASE_URL","exports","CAPTURE_PATH","document_front","document_back","selfie","liveness_frame","ApiClient","constructor","sessionManager","config","baseUrl","timeout","debug","uploader","uploadMultipart","validateSession","clientSecret","initializeFromClientSecret","response","request","updateSession","expiresAt","Date","uploadCapture","type","asset","onProgress","path","Error","url","headers","getRequestHeaders","timeoutMs","submitVerification","documentType","clientAnalysis","payload","createSecurePayload","submittedAt","now","getStatus","getResult","pollForResult","options","maxAttempts","intervalMs","attempts","status","result","contextualError","errorDetails","document","errorMessage","undefined","rejectionReasons","catch","jobId","overallScore","scores","documentQuality","documentAuthenticity","faceMatch","liveness","timestamps","submitted","referenceId","delay","validateHandoff","code","encodeURIComponent","fetchFn","fetch","ok","valid","error","json","redeemHandoff","method","ApiError","message","reportHandoffStatus","getBaseUrl","body","controller","AbortController","timeoutId","setTimeout","abort","JSON","stringify","signal","clearTimeout","parseErrorResponse","data","console","log","name","details","ms","Promise","resolve"],"sourceRoot":"../../../src","sources":["api/api-client.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/api/api-error.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ApiError = void 0;
+/**
+ * API error (ported verbatim from @kwik-id/sdk-core).
+ */
+class ApiError extends Error {
+  constructor(message, statusCode, code, details) {
+    super(message);
+    this.name = "ApiError";
+    this.statusCode = statusCode;
+    this.code = code;
+    this.details = details;
+  }
+  isRetryable() {
+    return this.statusCode >= 500 || this.statusCode === 429;
+  }
+  isAuthError() {
+    return this.statusCode === 401 || this.statusCode === 403;
+  }
+  isValidationError() {
+    return this.statusCode === 400 || this.statusCode === 422;
+  }
+}
+exports.ApiError = ApiError;
+//# sourceMappingURL=api-error.js.map

package/lib/commonjs/api/api-error.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ApiError","Error","constructor","message","statusCode","code","details","name","isRetryable","isAuthError","isValidationError","exports"],"sourceRoot":"../../../src","sources":["api/api-error.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACO,MAAMA,QAAQ,SAASC,KAAK,CAAC;EAKhCC,WAAWA,CAACC,OAAe,EAAEC,UAAkB,EAAEC,IAAa,EAAEC,OAAiB,EAAE;IAC/E,KAAK,CAACH,OAAO,CAAC;IACd,IAAI,CAACI,IAAI,GAAG,UAAU;IACtB,IAAI,CAACH,UAAU,GAAGA,UAAU;IAC5B,IAAI,CAACC,IAAI,GAAGA,IAAI;IAChB,IAAI,CAACC,OAAO,GAAGA,OAAO;EAC1B;EAEAE,WAAWA,CAAA,EAAY;IACnB,OAAO,IAAI,CAACJ,UAAU,IAAI,GAAG,IAAI,IAAI,CAACA,UAAU,KAAK,GAAG;EAC5D;EAEAK,WAAWA,CAAA,EAAY;IACnB,OAAO,IAAI,CAACL,UAAU,KAAK,GAAG,IAAI,IAAI,CAACA,UAAU,KAAK,GAAG;EAC7D;EAEAM,iBAAiBA,CAAA,EAAY;IACzB,OAAO,IAAI,CAACN,UAAU,KAAK,GAAG,IAAI,IAAI,CAACA,UAAU,KAAK,GAAG;EAC7D;AACJ;AAACO,OAAA,CAAAX,QAAA,GAAAA,QAAA","ignoreList":[]}

package/lib/commonjs/api/index.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "ApiClient", {
+  enumerable: true,
+  get: function () {
+    return _apiClient.ApiClient;
+  }
+});
+Object.defineProperty(exports, "ApiError", {
+  enumerable: true,
+  get: function () {
+    return _apiError.ApiError;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_BASE_URL", {
+  enumerable: true,
+  get: function () {
+    return _apiClient.DEFAULT_BASE_URL;
+  }
+});
+Object.defineProperty(exports, "uploadMultipart", {
+  enumerable: true,
+  get: function () {
+    return _upload.uploadMultipart;
+  }
+});
+var _apiClient = require("./api-client.js");
+var _apiError = require("./api-error.js");
+var _upload = require("./upload.js");
+//# sourceMappingURL=index.js.map