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

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,82 @@
-# 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 KYC SDK for React Native / Expo. Mirrors the KwikId web SDK flow
+(document capture → selfie → upload → submit) natively, using
+[`react-native-vision-camera`](https://react-native-vision-camera.com/).
+
+> **Alpha status.** 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.
+
+> **Requires Expo SDK 53 and a custom dev build / EAS build.** This SDK uses
+> native vision-camera modules and **will not run in Expo Go.** Run `expo prebuild` and build a
+> development client (or use `eas build`). `KwikIdRNSDK.initialize()` throws an
+> actionable error if it detects Expo Go at runtime.
+
+## Install
+
+```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
+```
+
+`react-native-reanimated`, `react-native-worklets-core` and
+`react-native-vision-camera-face-detector` are optional peers for now; they will be
+required once on-device liveness ships.
+
+### 1. Add the config plugins (`app.json`)
+
+```jsonc
+{
+    "expo": {
+        "plugins": [
+            "react-native-vision-camera",
+            ["@kwik-id/sdk-react-native", { "cameraPermissionText": "We verify your identity" }],
+        ],
+    },
+}
+```
+
+### 2. Prebuild + run a dev build
+
+```sh
+npx expo prebuild
+npx expo run:ios   # or run:android, or `eas build --profile development`
+```
+
+## Usage
+
+Your backend creates a session (`POST /api/v1/sessions` with your API key) and
+returns its `token`. Pass that token to the SDK as `clientSecret`:
+
+```tsx
+import { useKwikVerification } from "@kwik-id/sdk-react-native";
+
+function VerifyButton({ clientSecret }: { clientSecret: string }) {
+    const kyc = useKwikVerification({ clientSecret });
+    return (
+        <>
+            <Button
+                title="Verify identity"
+                onPress={async () => {
+                    const outcome = await kyc.start();
+                    if (outcome.status === "submitted") {
+                        // result is delivered to your backend via webhook
+                    }
+                }}
+            />
+            <kyc.Modal />
+        </>
+    );
+}
+```
+
+## Architecture
+
+This package is **standalone**: it reuses the KwikId backend protocol and type
+vocabulary but ships its own RN-native API client, session manager, crypto, camera,
+and UI. It has **no runtime dependency** on the other `@kwik-id/*` libraries.
+
+Built with [`react-native-builder-bob`](https://github.com/callstack/react-native-builder-bob).
+See the repo plan for the phased rollout (capture → passive liveness → active challenges → handoff).

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

package/lib/commonjs/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_apiClient","require","_apiError","_upload"],"sourceRoot":"../../../src","sources":["api/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,UAAA,GAAAC,OAAA;AASA,IAAAC,SAAA,GAAAD,OAAA;AACA,IAAAE,OAAA,GAAAF,OAAA","ignoreList":[]}

package/lib/commonjs/api/upload.js

@@ -0,0 +1,74 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.uploadMultipart = void 0;
+var _expoFileSystem = require("expo-file-system");
+var _apiError = require("./api-error.js");
+/**
+ * Multipart upload for RN via expo-file-system (gives real upload progress, which
+ * RN's fetch/FormData path cannot). The gateway's multer expects the field `file`.
+ */
+
+function parseBody(body) {
+  try {
+    return JSON.parse(body);
+  } catch {
+    return {};
+  }
+}
+
+/** Default uploader — used on device. */
+const uploadMultipart = async ({
+  url,
+  asset,
+  headers,
+  onProgress,
+  timeoutMs
+}) => {
+  let timer;
+  let rejectTimeout = () => undefined;
+  const timedOut = new Promise((_, reject) => {
+    rejectTimeout = reject;
+  });
+  // Reset on every progress event so a slow-but-moving upload isn't killed.
+  const armTimeout = () => {
+    if (!timeoutMs) return;
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(() => {
+      task.cancelAsync().catch(() => undefined);
+      rejectTimeout(new _apiError.ApiError("Upload timeout", 0, "UPLOAD_TIMEOUT"));
+    }, timeoutMs);
+  };
+  const task = (0, _expoFileSystem.createUploadTask)(url, asset.uri, {
+    httpMethod: "POST",
+    uploadType: _expoFileSystem.FileSystemUploadType.MULTIPART,
+    fieldName: "file",
+    mimeType: asset.type,
+    headers
+  }, p => {
+    armTimeout();
+    if (p.totalBytesExpectedToSend > 0) {
+      onProgress?.(p.totalBytesSent / p.totalBytesExpectedToSend * 100);
+    }
+  });
+  armTimeout();
+  let res;
+  try {
+    res = await Promise.race([task.uploadAsync(), timedOut]);
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+  if (!res || res.status < 200 || res.status >= 300) {
+    const parsed = res ? parseBody(res.body) : {};
+    throw new _apiError.ApiError(parsed.message || `Upload failed with status ${res?.status ?? 0}`, res?.status ?? 0);
+  }
+  const parsed = parseBody(res.body);
+  return {
+    uploadId: parsed.uploadId || "",
+    status: parsed.status || "uploaded"
+  };
+};
+exports.uploadMultipart = uploadMultipart;
+//# sourceMappingURL=upload.js.map

package/lib/commonjs/api/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_expoFileSystem","require","_apiError","parseBody","body","JSON","parse","uploadMultipart","url","asset","headers","onProgress","timeoutMs","timer","rejectTimeout","undefined","timedOut","Promise","_","reject","armTimeout","clearTimeout","setTimeout","task","cancelAsync","catch","ApiError","createUploadTask","uri","httpMethod","uploadType","FileSystemUploadType","MULTIPART","fieldName","mimeType","type","p","totalBytesExpectedToSend","totalBytesSent","res","race","uploadAsync","status","parsed","message","uploadId","exports"],"sourceRoot":"../../../src","sources":["api/upload.ts"],"mappings":";;;;;;AAIA,IAAAA,eAAA,GAAAC,OAAA;AAGA,IAAAC,SAAA,GAAAD,OAAA;AAPA;AACA;AACA;AACA;;AAuBA,SAASE,SAASA,CAACC,IAAY,EAA4D;EACvF,IAAI;IACA,OAAOC,IAAI,CAACC,KAAK,CAACF,IAAI,CAAC;EAC3B,CAAC,CAAC,MAAM;IACJ,OAAO,CAAC,CAAC;EACb;AACJ;;AAEA;AACO,MAAMG,eAAyB,GAAG,MAAAA,CAAO;EAAEC,GAAG;EAAEC,KAAK;EAAEC,OAAO;EAAEC,UAAU;EAAEC;AAAU,CAAC,KAAK;EAC/F,IAAIC,KAAgD;EACpD,IAAIC,aAAqC,GAAGA,CAAA,KAAMC,SAAS;EAC3D,MAAMC,QAAQ,GAAG,IAAIC,OAAO,CAAQ,CAACC,CAAC,EAAEC,MAAM,KAAK;IAC/CL,aAAa,GAAGK,MAAM;EAC1B,CAAC,CAAC;EACF;EACA,MAAMC,UAAU,GAAGA,CAAA,KAAM;IACrB,IAAI,CAACR,SAAS,EAAE;IAChB,IAAIC,KAAK,EAAEQ,YAAY,CAACR,KAAK,CAAC;IAC9BA,KAAK,GAAGS,UAAU,CAAC,MAAM;MACrBC,IAAI,CAACC,WAAW,CAAC,CAAC,CAACC,KAAK,CAAC,MAAMV,SAAS,CAAC;MACzCD,aAAa,CAAC,IAAIY,kBAAQ,CAAC,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACtE,CAAC,EAAEd,SAAS,CAAC;EACjB,CAAC;EAED,MAAMW,IAAI,GAAG,IAAAI,gCAAgB,EACzBnB,GAAG,EACHC,KAAK,CAACmB,GAAG,EACT;IACIC,UAAU,EAAE,MAAM;IAClBC,UAAU,EAAEC,oCAAoB,CAACC,SAAS;IAC1CC,SAAS,EAAE,MAAM;IACjBC,QAAQ,EAAEzB,KAAK,CAAC0B,IAAI;IACpBzB;EACJ,CAAC,EACA0B,CAAC,IAAK;IACHhB,UAAU,CAAC,CAAC;IACZ,IAAIgB,CAAC,CAACC,wBAAwB,GAAG,CAAC,EAAE;MAChC1B,UAAU,GAAIyB,CAAC,CAACE,cAAc,GAAGF,CAAC,CAACC,wBAAwB,GAAI,GAAG,CAAC;IACvE;EACJ,CACJ,CAAC;EAEDjB,UAAU,CAAC,CAAC;EACZ,IAAImB,GAAiD;EACrD,IAAI;IACAA,GAAG,GAAG,MAAMtB,OAAO,CAACuB,IAAI,CAAC,CAACjB,IAAI,CAACkB,WAAW,CAAC,CAAC,EAAEzB,QAAQ,CAAC,CAAC;EAC5D,CAAC,SAAS;IACN,IAAIH,KAAK,EAAEQ,YAAY,CAACR,KAAK,CAAC;EAClC;EACA,IAAI,CAAC0B,GAAG,IAAIA,GAAG,CAACG,MAAM,GAAG,GAAG,IAAIH,GAAG,CAACG,MAAM,IAAI,GAAG,EAAE;IAC/C,MAAMC,MAAM,GAAGJ,GAAG,GAAGpC,SAAS,CAACoC,GAAG,CAACnC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,IAAIsB,kBAAQ,CACdiB,MAAM,CAACC,OAAO,IAAI,6BAA6BL,GAAG,EAAEG,MAAM,IAAI,CAAC,EAAE,EACjEH,GAAG,EAAEG,MAAM,IAAI,CACnB,CAAC;EACL;EAEA,MAAMC,MAAM,GAAGxC,SAAS,CAACoC,GAAG,CAACnC,IAAI,CAAC;EAClC,OAAO;IAAEyC,QAAQ,EAAEF,MAAM,CAACE,QAAQ,IAAI,EAAE;IAAEH,MAAM,EAAEC,MAAM,CAACD,MAAM,IAAI;EAAW,CAAC;AACnF,CAAC;AAACI,OAAA,CAAAvC,eAAA,GAAAA,eAAA","ignoreList":[]}