@kyciris/core 0.1.0

package/README.md

@@ -0,0 +1,224 @@
+# @kyciris/core
+
+Core SDK package with UI-agnostic KYC (Know Your Customer) functions. Use this package if you want to build your own UI while leveraging Paytesy's verification services.
+
+## Installation
+
+```bash
+pnpm add @kyciris/core
+```
+
+## Usage
+
+### Initialization
+
+```typescript
+import { createKYCClient } from '@kyciris/core';
+
+const kyc = createKYCClient({
+  apiKey: 'your-api-key',
+  baseUrl: 'http://localhost:3000', // Your KYC API base URL
+});
+```
+
+### Creating a Verification Token
+
+Before starting verification, create a token for secure API access:
+
+```typescript
+const { token, expiresIn } = await kyc.createVerificationToken(
+  'user-123', // externalId
+  '3' // expiry in hours (optional, default: 3)
+);
+```
+
+### Starting a Verification
+
+```typescript
+const session = await kyc.startVerification({
+  documentType: 'IDENTITY_CARD', // or 'DRIVING_LICENSE'
+  country: 'MZ', // Country code: MZ, AO, PT, etc.
+  identityId: 'optional-existing-identity-id', // optional
+  externalId: 'optional-external-ref', // optional
+});
+
+console.log(session.verificationId);
+console.log(session.status); // 'PENDING'
+```
+
+### Uploading Documents
+
+After starting verification, upload front and back of the document:
+
+```typescript
+// Upload front of document
+const frontResult = await kyc.uploadDocument({
+  verificationId: session.verificationId,
+  type: 'front',
+  imageData: 'base64-encoded-image-data',
+});
+
+// Upload back of document
+const backResult = await kyc.uploadDocument({
+  verificationId: session.verificationId,
+  type: 'back',
+  imageData: 'base64-encoded-image-data',
+});
+```
+
+### Uploading Selfie
+
+```typescript
+const selfieResult = await kyc.uploadSelfie({
+  verificationId: session.verificationId,
+  imageData: 'base64-encoded-selfie-image',
+});
+```
+
+### Checking Status
+
+```typescript
+// Get current status
+const status = await kyc.getStatus(session.verificationId);
+console.log(status.status); // 'PENDING' | 'PROCESSING' | 'APPROVED' | 'REJECTED'
+console.log(status.ocrData); // Extracted document data
+console.log(status.faceMatchScore); // Face match similarity (0-1)
+
+// Poll until completion
+const finalStatus = await kyc.pollStatus(
+  session.verificationId,
+  3000, // poll interval in ms (optional, default: 3000)
+  120000 // timeout in ms (optional, default: 120000)
+);
+```
+
+### Listening to Events
+
+```typescript
+// Subscribe to status changes
+const unsubscribe = kyc.onEvent((event) => {
+  if (event.type === 'statusChanged') {
+    console.log('Status changed to:', event.status);
+  } else if (event.type === 'error') {
+    console.log('Error:', event.error);
+  }
+});
+
+// Unsubscribe when done
+unsubscribe();
+```
+
+## API Reference
+
+### Interfaces
+
+#### KYCCredentials
+
+```typescript
+{
+  apiKey: string; // Your API key for authentication
+  baseUrl: string; // Base URL of your KYC API
+}
+```
+
+#### StartVerificationParams
+
+```typescript
+{
+  documentType: 'IDENTITY_CARD' | 'DRIVING_LICENSE';
+  country: string;      // Country code (e.g., 'MZ', 'AO', 'PT')
+  identityId?: string;  // Optional existing identity ID
+  externalId?: string;  // Optional external reference
+}
+```
+
+#### VerificationStatus
+
+```typescript
+{
+  verificationId: string;
+  status: 'PENDING' | 'PROCESSING' | 'APPROVED' | 'REJECTED';
+  faceMatchScore?: number;  // Similarity score 0-1
+  ocrData?: {
+    fullName?: string;
+    idNumber?: string;
+    birthDate?: string;
+    expiryDate?: string;
+    // ... additional country-specific fields
+  };
+  createdAt: string;
+  updatedAt: string;
+}
+```
+
+## Supported Countries
+
+- **MZ** (Mozambique)
+- **AO** (Angola)
+- **PT** (Portugal)
+
+## Error Handling
+
+All methods throw `KYCSdkError` with the following properties:
+
+```typescript
+try {
+  await kyc.startVerification({ ... });
+} catch (error) {
+  if (error instanceof KYCSdkError) {
+    console.log(error.code);      // Error code
+    console.log(error.statusCode); // HTTP status code
+    console.log(error.message);   // Human-readable message
+  }
+}
+```
+
+## Example
+
+```typescript
+import { createKYCClient } from '@kyciris/core';
+
+async function runKYC() {
+  const kyc = createKYCClient({
+    apiKey: process.env.KYC_API_KEY,
+    baseUrl: 'http://localhost:3000',
+  });
+
+  // Start verification
+  const session = await kyc.startVerification({
+    documentType: 'IDENTITY_CARD',
+    country: 'MZ',
+    externalId: 'user-12345',
+  });
+
+  // Listen for events
+  kyc.onEvent((event) => {
+    console.log('KYC Event:', event);
+  });
+
+  // Upload documents (you would get imageData from your UI)
+  await kyc.uploadDocument({
+    verificationId: session.verificationId,
+    type: 'front',
+    imageData: 'base64-encoded-image...',
+  });
+
+  await kyc.uploadDocument({
+    verificationId: session.verificationId,
+    type: 'back',
+    imageData: 'base64-encoded-image...',
+  });
+
+  // Upload selfie
+  await kyc.uploadSelfie({
+    verificationId: session.verificationId,
+    imageData: 'base64-encoded-selfie...',
+  });
+
+  // Wait for completion
+  const result = await kyc.pollStatus(session.verificationId);
+  console.log('Verification result:', result.status);
+}
+
+runKYC();
+```

package/dist/index.d.mts

@@ -0,0 +1,197 @@
+/**
+ * Credentials required to initialize the KYC SDK
+ */
+interface KYCCredentials {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL of the KYC API */
+    baseUrl: string;
+}
+/**
+ * Parameters required to start a verification session
+ */
+interface StartVerificationParams {
+    /** Type of document to verify (e.g., IDENTITY_CARD, DRIVING_LICENSE) */
+    documentType: 'IDENTITY_CARD' | 'DRIVING_LICENSE';
+    /** Country code (e.g., MZ, AO, PT) */
+    country: string;
+    /** Optional existing identity ID to link verification to */
+    identityId?: string;
+    /** Optional external reference ID */
+    externalId?: string;
+}
+/**
+ * Response from starting a verification session
+ */
+interface VerificationSession {
+    /** Unique verification ID */
+    verificationId: string;
+    /** Linked identity ID (if exists) */
+    identityId?: string;
+    /** Current verification status */
+    status: string;
+}
+/**
+ * Parameters for uploading a selfie image
+ */
+interface UploadSelfieParams {
+    /** Verification ID to attach the selfie to */
+    verificationId: string;
+    /** Base64 encoded image data, data URI, or file:// URI (React Native) */
+    imageData: string;
+    /** MIME type of the image (default: image/jpeg) */
+    mimeType?: string;
+}
+/**
+ * Parameters for uploading a document image
+ */
+interface UploadDocumentParams {
+    /** Verification ID to attach the document to */
+    verificationId: string;
+    /** Type of document (front or back) */
+    type: 'front' | 'back';
+    /** Base64 encoded image data, data URI, or file:// URI (React Native) */
+    imageData: string;
+    /** MIME type of the image (default: image/jpeg) */
+    mimeType?: string;
+}
+/** Result of an upload operation */
+interface UploadResult {
+    /** Response message */
+    message: string;
+    /** Current status after upload */
+    status: string;
+}
+/** Current status of a verification session */
+interface VerificationStatus {
+    /** Verification ID */
+    verificationId: string;
+    /** Current status: PENDING, PROCESSING, APPROVED, or REJECTED */
+    status: 'PENDING' | 'PROCESSING' | 'APPROVED' | 'REJECTED';
+    /** Face match similarity score (0-1) */
+    faceMatchScore?: number;
+    /** OCR extracted data from document */
+    ocrData?: {
+        /** Full name extracted from document */
+        fullName?: string;
+        /** ID number extracted from document */
+        idNumber?: string;
+        /** Birth date extracted from document */
+        birthDate?: string;
+        /** Expiry date extracted from document */
+        expiryDate?: string;
+        /** Additional extracted fields */
+        [key: string]: any;
+    };
+    /** When the verification was created */
+    createdAt: string;
+    /** When the verification was last updated */
+    updatedAt: string;
+}
+/** Event emitted when KYC status changes */
+interface KYCStatusEvent {
+    /** Type of event: statusChanged or error */
+    type: 'statusChanged' | 'error';
+    /** New status (for statusChanged events) */
+    status?: string;
+    /** Error message (for error events) */
+    error?: string;
+}
+/** Callback function for handling KYC status events */
+type KYCEventCallback = (event: KYCStatusEvent) => void;
+/**
+ * Custom error class for KYC SDK errors
+ */
+declare class KYCSdkError extends Error {
+    /** Error code for programmatic error handling */
+    code: string;
+    /** HTTP status code if available */
+    statusCode?: number;
+    /**
+     * Creates a new KYC SDK error
+     * @param message Human-readable error message
+     * @param code Error code for handling
+     * @param statusCode Optional HTTP status code
+     */
+    constructor(message: string, code: string, statusCode?: number);
+}
+/**
+ * Core KYC SDK client for interacting with the verification API
+ */
+declare class KYCCore {
+    private client;
+    private credentials;
+    private eventCallbacks;
+    /**
+     * Creates a new KYC Core instance
+     * @param credentials API credentials (apiKey and baseUrl)
+     */
+    constructor(credentials: KYCCredentials);
+    /**
+     * Registers a callback for KYC status events
+     * @param callback Function to call when status changes
+     * @returns Unsubscribe function to remove the callback
+     */
+    onEvent(callback: KYCEventCallback): () => void;
+    /**
+     * Emits a status event to all registered callbacks
+     * @param event The event to emit
+     */
+    private emitEvent;
+    /**
+     * Creates a verification token for secure API access
+     * @param externalId External reference ID
+     * @param expiry Token expiry in hours (default: 3)
+     * @returns Object containing the token and its expiration time
+     */
+    createVerificationToken(externalId: string, expiry?: string): Promise<{
+        token: string;
+        expiresIn: string;
+    }>;
+    /**
+     * Starts a new verification session
+     * @param params Parameters including documentType, country, identityId, and externalId
+     * @returns Verification session with verificationId and status
+     */
+    startVerification(params: StartVerificationParams): Promise<VerificationSession>;
+    /**
+     * Uploads a selfie image for face verification
+     * @param params Parameters including verificationId, imageData, and optional mimeType
+     * @returns Upload result with status
+     */
+    uploadSelfie(params: UploadSelfieParams): Promise<UploadResult>;
+    /**
+     * Uploads a document image (front or back)
+     * @param params Parameters including verificationId, type, imageData, and optional mimeType
+     * @returns Upload result with status
+     */
+    uploadDocument(params: UploadDocumentParams): Promise<UploadResult>;
+    /**
+     * Gets the current status of a verification session
+     * @param verificationId The verification ID to check
+     * @returns Current verification status including OCR data and face match score
+     */
+    getStatus(verificationId: string): Promise<VerificationStatus>;
+    /**
+     * Polls for verification status until completion or timeout
+     * @param verificationId The verification ID to check
+     * @param interval Polling interval in milliseconds (default: 3000)
+     * @param timeout Maximum time to wait in milliseconds (default: 120000)
+     * @returns Final verification status when approved or rejected
+     */
+    pollStatus(verificationId: string, interval?: number, timeout?: number): Promise<VerificationStatus>;
+    /**
+     * Static factory method to create a KYC client instance
+     * @param credentials API credentials (apiKey and baseUrl)
+     * @returns Configured KYCCore instance
+     */
+    static createClient(credentials: KYCCredentials): KYCCore;
+}
+/**
+ * Factory function to create a KYC client instance
+ * @param credentials API credentials (apiKey and baseUrl)
+ * @returns Configured KYCCore instance
+ */
+declare function createKYCClient(credentials: KYCCredentials): KYCCore;
+
+export { KYCCore, type KYCCredentials, type KYCEventCallback, KYCSdkError, type KYCStatusEvent, type StartVerificationParams, type UploadDocumentParams, type UploadResult, type UploadSelfieParams, type VerificationSession, type VerificationStatus, createKYCClient };

package/dist/index.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Credentials required to initialize the KYC SDK
+ */
+interface KYCCredentials {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL of the KYC API */
+    baseUrl: string;
+}
+/**
+ * Parameters required to start a verification session
+ */
+interface StartVerificationParams {
+    /** Type of document to verify (e.g., IDENTITY_CARD, DRIVING_LICENSE) */
+    documentType: 'IDENTITY_CARD' | 'DRIVING_LICENSE';
+    /** Country code (e.g., MZ, AO, PT) */
+    country: string;
+    /** Optional existing identity ID to link verification to */
+    identityId?: string;
+    /** Optional external reference ID */
+    externalId?: string;
+}
+/**
+ * Response from starting a verification session
+ */
+interface VerificationSession {
+    /** Unique verification ID */
+    verificationId: string;
+    /** Linked identity ID (if exists) */
+    identityId?: string;
+    /** Current verification status */
+    status: string;
+}
+/**
+ * Parameters for uploading a selfie image
+ */
+interface UploadSelfieParams {
+    /** Verification ID to attach the selfie to */
+    verificationId: string;
+    /** Base64 encoded image data, data URI, or file:// URI (React Native) */
+    imageData: string;
+    /** MIME type of the image (default: image/jpeg) */
+    mimeType?: string;
+}
+/**
+ * Parameters for uploading a document image
+ */
+interface UploadDocumentParams {
+    /** Verification ID to attach the document to */
+    verificationId: string;
+    /** Type of document (front or back) */
+    type: 'front' | 'back';
+    /** Base64 encoded image data, data URI, or file:// URI (React Native) */
+    imageData: string;
+    /** MIME type of the image (default: image/jpeg) */
+    mimeType?: string;
+}
+/** Result of an upload operation */
+interface UploadResult {
+    /** Response message */
+    message: string;
+    /** Current status after upload */
+    status: string;
+}
+/** Current status of a verification session */
+interface VerificationStatus {
+    /** Verification ID */
+    verificationId: string;
+    /** Current status: PENDING, PROCESSING, APPROVED, or REJECTED */
+    status: 'PENDING' | 'PROCESSING' | 'APPROVED' | 'REJECTED';
+    /** Face match similarity score (0-1) */
+    faceMatchScore?: number;
+    /** OCR extracted data from document */
+    ocrData?: {
+        /** Full name extracted from document */
+        fullName?: string;
+        /** ID number extracted from document */
+        idNumber?: string;
+        /** Birth date extracted from document */
+        birthDate?: string;
+        /** Expiry date extracted from document */
+        expiryDate?: string;
+        /** Additional extracted fields */
+        [key: string]: any;
+    };
+    /** When the verification was created */
+    createdAt: string;
+    /** When the verification was last updated */
+    updatedAt: string;
+}
+/** Event emitted when KYC status changes */
+interface KYCStatusEvent {
+    /** Type of event: statusChanged or error */
+    type: 'statusChanged' | 'error';
+    /** New status (for statusChanged events) */
+    status?: string;
+    /** Error message (for error events) */
+    error?: string;
+}
+/** Callback function for handling KYC status events */
+type KYCEventCallback = (event: KYCStatusEvent) => void;
+/**
+ * Custom error class for KYC SDK errors
+ */
+declare class KYCSdkError extends Error {
+    /** Error code for programmatic error handling */
+    code: string;
+    /** HTTP status code if available */
+    statusCode?: number;
+    /**
+     * Creates a new KYC SDK error
+     * @param message Human-readable error message
+     * @param code Error code for handling
+     * @param statusCode Optional HTTP status code
+     */
+    constructor(message: string, code: string, statusCode?: number);
+}
+/**
+ * Core KYC SDK client for interacting with the verification API
+ */
+declare class KYCCore {
+    private client;
+    private credentials;
+    private eventCallbacks;
+    /**
+     * Creates a new KYC Core instance
+     * @param credentials API credentials (apiKey and baseUrl)
+     */
+    constructor(credentials: KYCCredentials);
+    /**
+     * Registers a callback for KYC status events
+     * @param callback Function to call when status changes
+     * @returns Unsubscribe function to remove the callback
+     */
+    onEvent(callback: KYCEventCallback): () => void;
+    /**
+     * Emits a status event to all registered callbacks
+     * @param event The event to emit
+     */
+    private emitEvent;
+    /**
+     * Creates a verification token for secure API access
+     * @param externalId External reference ID
+     * @param expiry Token expiry in hours (default: 3)
+     * @returns Object containing the token and its expiration time
+     */
+    createVerificationToken(externalId: string, expiry?: string): Promise<{
+        token: string;
+        expiresIn: string;
+    }>;
+    /**
+     * Starts a new verification session
+     * @param params Parameters including documentType, country, identityId, and externalId
+     * @returns Verification session with verificationId and status
+     */
+    startVerification(params: StartVerificationParams): Promise<VerificationSession>;
+    /**
+     * Uploads a selfie image for face verification
+     * @param params Parameters including verificationId, imageData, and optional mimeType
+     * @returns Upload result with status
+     */
+    uploadSelfie(params: UploadSelfieParams): Promise<UploadResult>;
+    /**
+     * Uploads a document image (front or back)
+     * @param params Parameters including verificationId, type, imageData, and optional mimeType
+     * @returns Upload result with status
+     */
+    uploadDocument(params: UploadDocumentParams): Promise<UploadResult>;
+    /**
+     * Gets the current status of a verification session
+     * @param verificationId The verification ID to check
+     * @returns Current verification status including OCR data and face match score
+     */
+    getStatus(verificationId: string): Promise<VerificationStatus>;
+    /**
+     * Polls for verification status until completion or timeout
+     * @param verificationId The verification ID to check
+     * @param interval Polling interval in milliseconds (default: 3000)
+     * @param timeout Maximum time to wait in milliseconds (default: 120000)
+     * @returns Final verification status when approved or rejected
+     */
+    pollStatus(verificationId: string, interval?: number, timeout?: number): Promise<VerificationStatus>;
+    /**
+     * Static factory method to create a KYC client instance
+     * @param credentials API credentials (apiKey and baseUrl)
+     * @returns Configured KYCCore instance
+     */
+    static createClient(credentials: KYCCredentials): KYCCore;
+}
+/**
+ * Factory function to create a KYC client instance
+ * @param credentials API credentials (apiKey and baseUrl)
+ * @returns Configured KYCCore instance
+ */
+declare function createKYCClient(credentials: KYCCredentials): KYCCore;
+
+export { KYCCore, type KYCCredentials, type KYCEventCallback, KYCSdkError, type KYCStatusEvent, type StartVerificationParams, type UploadDocumentParams, type UploadResult, type UploadSelfieParams, type VerificationSession, type VerificationStatus, createKYCClient };

package/dist/index.js

@@ -0,0 +1,251 @@
+'use strict';
+
+var axios = require('axios');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var axios__default = /*#__PURE__*/_interopDefault(axios);
+
+// src/index.ts
+var KYCSdkError = class extends Error {
+  /**
+   * Creates a new KYC SDK error
+   * @param message Human-readable error message
+   * @param code Error code for handling
+   * @param statusCode Optional HTTP status code
+   */
+  constructor(message, code, statusCode) {
+    super(message);
+    this.name = "KYCSdkError";
+    this.code = code;
+    this.statusCode = statusCode;
+  }
+};
+var KYCCore = class _KYCCore {
+  /**
+   * Creates a new KYC Core instance
+   * @param credentials API credentials (apiKey and baseUrl)
+   */
+  constructor(credentials) {
+    this.eventCallbacks = [];
+    this.credentials = credentials;
+    this.client = axios__default.default.create({
+      baseURL: credentials.baseUrl,
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json"
+      }
+    });
+    this.client.interceptors.request.use((config) => {
+      config.headers["x-api-key"] = this.credentials.apiKey;
+      return config;
+    });
+  }
+  /**
+   * Registers a callback for KYC status events
+   * @param callback Function to call when status changes
+   * @returns Unsubscribe function to remove the callback
+   */
+  onEvent(callback) {
+    this.eventCallbacks.push(callback);
+    return () => {
+      this.eventCallbacks = this.eventCallbacks.filter((cb) => cb !== callback);
+    };
+  }
+  /**
+   * Emits a status event to all registered callbacks
+   * @param event The event to emit
+   */
+  emitEvent(event) {
+    this.eventCallbacks.forEach((callback) => callback(event));
+  }
+  /**
+   * Creates a verification token for secure API access
+   * @param externalId External reference ID
+   * @param expiry Token expiry in hours (default: 3)
+   * @returns Object containing the token and its expiration time
+   */
+  async createVerificationToken(externalId, expiry = "3") {
+    try {
+      const response = await this.client.post("/verification/token", {
+        externalId,
+        expiry
+      });
+      return response.data;
+    } catch (error) {
+      const message = error.response?.data?.message || error.message || "Failed to create verification token";
+      throw new KYCSdkError(message, "TOKEN_CREATE_FAILED", error.response?.status);
+    }
+  }
+  /**
+   * Starts a new verification session
+   * @param params Parameters including documentType, country, identityId, and externalId
+   * @returns Verification session with verificationId and status
+   */
+  async startVerification(params) {
+    try {
+      const response = await this.client.post("/verification/start", params);
+      this.emitEvent({
+        type: "statusChanged",
+        status: "PENDING"
+      });
+      return response.data;
+    } catch (error) {
+      const message = error.response?.data?.message || error.message || "Failed to start verification";
+      throw new KYCSdkError(message, "VERIFICATION_START_FAILED", error.response?.status);
+    }
+  }
+  /**
+   * Uploads a selfie image for face verification
+   * @param params Parameters including verificationId, imageData, and optional mimeType
+   * @returns Upload result with status
+   */
+  async uploadSelfie(params) {
+    try {
+      const formData = new FormData();
+      formData.append("verificationId", params.verificationId);
+      const mimeType = params.mimeType || "image/jpeg";
+      const imageData = params.imageData;
+      if (imageData.startsWith("file://")) {
+        formData.append("file", {
+          uri: imageData,
+          type: mimeType,
+          name: "selfie.jpg"
+        });
+      } else if (imageData.startsWith("data:")) {
+        formData.append("file", {
+          uri: imageData,
+          type: mimeType,
+          name: "selfie.jpg"
+        });
+      } else {
+        formData.append("file", {
+          uri: `data:${mimeType};base64,${imageData}`,
+          type: mimeType,
+          name: "selfie.jpg"
+        });
+      }
+      const response = await this.client.post("/verification/upload/selfie", formData, {
+        headers: { "Content-Type": "multipart/form-data" }
+      });
+      this.emitEvent({
+        type: "statusChanged",
+        status: "PROCESSING"
+      });
+      return response.data;
+    } catch (error) {
+      console.log("Upload selfie error:", error.response?.data || error.message);
+      const message = error.response?.data?.message || error.message || "Failed to upload selfie";
+      throw new KYCSdkError(message, "SELFIE_UPLOAD_FAILED", error.response?.status);
+    }
+  }
+  /**
+   * Uploads a document image (front or back)
+   * @param params Parameters including verificationId, type, imageData, and optional mimeType
+   * @returns Upload result with status
+   */
+  async uploadDocument(params) {
+    try {
+      const formData = new FormData();
+      formData.append("verificationId", params.verificationId);
+      formData.append("type", params.type);
+      const mimeType = params.mimeType || "image/jpeg";
+      const imageData = params.imageData;
+      if (imageData.startsWith("file://")) {
+        formData.append("file", {
+          uri: imageData,
+          type: mimeType,
+          name: `${params.type}.jpg`
+        });
+      } else if (imageData.startsWith("data:")) {
+        formData.append("file", {
+          uri: imageData,
+          type: mimeType,
+          name: `${params.type}.jpg`
+        });
+      } else {
+        formData.append("file", {
+          uri: `data:${mimeType};base64,${imageData}`,
+          type: mimeType,
+          name: `${params.type}.jpg`
+        });
+      }
+      const response = await this.client.post("/verification/upload/document", formData, {
+        headers: { "Content-Type": "multipart/form-data" }
+      });
+      this.emitEvent({
+        type: "statusChanged",
+        status: "PROCESSING"
+      });
+      return response.data;
+    } catch (error) {
+      console.log("Upload document error:", error.response?.data || error.message);
+      const message = error.response?.data?.message || error.message || "Failed to upload document";
+      throw new KYCSdkError(message, "DOCUMENT_UPLOAD_FAILED", error.response?.status);
+    }
+  }
+  /**
+   * Gets the current status of a verification session
+   * @param verificationId The verification ID to check
+   * @returns Current verification status including OCR data and face match score
+   */
+  async getStatus(verificationId) {
+    try {
+      const response = await this.client.get(`/verification/status/${verificationId}`);
+      this.emitEvent({
+        type: "statusChanged",
+        status: response.data.status
+      });
+      return response.data;
+    } catch (error) {
+      const message = error.response?.data?.message || error.message || "Failed to get verification status";
+      throw new KYCSdkError(message, "STATUS_CHECK_FAILED", error.response?.status);
+    }
+  }
+  /**
+   * Polls for verification status until completion or timeout
+   * @param verificationId The verification ID to check
+   * @param interval Polling interval in milliseconds (default: 3000)
+   * @param timeout Maximum time to wait in milliseconds (default: 120000)
+   * @returns Final verification status when approved or rejected
+   */
+  async pollStatus(verificationId, interval = 3e3, timeout = 12e4) {
+    const startTime = Date.now();
+    return new Promise((resolve, reject) => {
+      const poll = async () => {
+        try {
+          const status = await this.getStatus(verificationId);
+          if (status.status === "APPROVED" || status.status === "REJECTED") {
+            resolve(status);
+            return;
+          }
+          if (Date.now() - startTime > timeout) {
+            reject(new KYCSdkError("Polling timeout", "POLLING_TIMEOUT"));
+            return;
+          }
+          setTimeout(poll, interval);
+        } catch (error) {
+          reject(error);
+        }
+      };
+      poll();
+    });
+  }
+  /**
+   * Static factory method to create a KYC client instance
+   * @param credentials API credentials (apiKey and baseUrl)
+   * @returns Configured KYCCore instance
+   */
+  static createClient(credentials) {
+    return new _KYCCore(credentials);
+  }
+};
+function createKYCClient(credentials) {
+  return KYCCore.createClient(credentials);
+}
+
+exports.KYCCore = KYCCore;
+exports.KYCSdkError = KYCSdkError;
+exports.createKYCClient = createKYCClient;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["axios"],"mappings":"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","file":"index.js","sourcesContent":["import axios, { AxiosInstance } from 'axios';\n\n/**\n * Credentials required to initialize the KYC SDK\n */\nexport interface KYCCredentials {\n  /** API key for authentication */\n  apiKey: string;\n  /** Base URL of the KYC API */\n  baseUrl: string;\n}\n\n/**\n * Parameters required to start a verification session\n */\nexport interface StartVerificationParams {\n  /** Type of document to verify (e.g., IDENTITY_CARD, DRIVING_LICENSE) */\n  documentType: 'IDENTITY_CARD' | 'DRIVING_LICENSE';\n  /** Country code (e.g., MZ, AO, PT) */\n  country: string;\n  /** Optional existing identity ID to link verification to */\n  identityId?: string;\n  /** Optional external reference ID */\n  externalId?: string;\n}\n\n/**\n * Response from starting a verification session\n */\nexport interface VerificationSession {\n  /** Unique verification ID */\n  verificationId: string;\n  /** Linked identity ID (if exists) */\n  identityId?: string;\n  /** Current verification status */\n  status: string;\n}\n\n/**\n * Parameters for uploading a selfie image\n */\nexport interface UploadSelfieParams {\n  /** Verification ID to attach the selfie to */\n  verificationId: string;\n  /** Base64 encoded image data, data URI, or file:// URI (React Native) */\n  imageData: string;\n  /** MIME type of the image (default: image/jpeg) */\n  mimeType?: string;\n}\n\n/**\n * Parameters for uploading a document image\n */\nexport interface UploadDocumentParams {\n  /** Verification ID to attach the document to */\n  verificationId: string;\n  /** Type of document (front or back) */\n  type: 'front' | 'back';\n  /** Base64 encoded image data, data URI, or file:// URI (React Native) */\n  imageData: string;\n  /** MIME type of the image (default: image/jpeg) */\n  mimeType?: string;\n}\n\n/** Result of an upload operation */\nexport interface UploadResult {\n  /** Response message */\n  message: string;\n  /** Current status after upload */\n  status: string;\n}\n\n/** Current status of a verification session */\nexport interface VerificationStatus {\n  /** Verification ID */\n  verificationId: string;\n  /** Current status: PENDING, PROCESSING, APPROVED, or REJECTED */\n  status: 'PENDING' | 'PROCESSING' | 'APPROVED' | 'REJECTED';\n  /** Face match similarity score (0-1) */\n  faceMatchScore?: number;\n  /** OCR extracted data from document */\n  ocrData?: {\n    /** Full name extracted from document */\n    fullName?: string;\n    /** ID number extracted from document */\n    idNumber?: string;\n    /** Birth date extracted from document */\n    birthDate?: string;\n    /** Expiry date extracted from document */\n    expiryDate?: string;\n    /** Additional extracted fields */\n    [key: string]: any;\n  };\n  /** When the verification was created */\n  createdAt: string;\n  /** When the verification was last updated */\n  updatedAt: string;\n}\n\n/** Event emitted when KYC status changes */\nexport interface KYCStatusEvent {\n  /** Type of event: statusChanged or error */\n  type: 'statusChanged' | 'error';\n  /** New status (for statusChanged events) */\n  status?: string;\n  /** Error message (for error events) */\n  error?: string;\n}\n\n/** Callback function for handling KYC status events */\nexport type KYCEventCallback = (event: KYCStatusEvent) => void;\n\n/**\n * Custom error class for KYC SDK errors\n */\nexport class KYCSdkError extends Error {\n  /** Error code for programmatic error handling */\n  code: string;\n  /** HTTP status code if available */\n  statusCode?: number;\n\n  /**\n   * Creates a new KYC SDK error\n   * @param message Human-readable error message\n   * @param code Error code for handling\n   * @param statusCode Optional HTTP status code\n   */\n  constructor(message: string, code: string, statusCode?: number) {\n    super(message);\n    this.name = 'KYCSdkError';\n    this.code = code;\n    this.statusCode = statusCode;\n  }\n}\n\n/**\n * Core KYC SDK client for interacting with the verification API\n */\nexport class KYCCore {\n  private client: AxiosInstance;\n  private credentials: KYCCredentials;\n  private eventCallbacks: KYCEventCallback[] = [];\n\n  /**\n   * Creates a new KYC Core instance\n   * @param credentials API credentials (apiKey and baseUrl)\n   */\n  constructor(credentials: KYCCredentials) {\n    this.credentials = credentials;\n    this.client = axios.create({\n      baseURL: credentials.baseUrl,\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'application/json',\n      },\n    });\n\n    this.client.interceptors.request.use((config) => {\n      config.headers['x-api-key'] = this.credentials.apiKey;\n      return config;\n    });\n  }\n\n  /**\n   * Registers a callback for KYC status events\n   * @param callback Function to call when status changes\n   * @returns Unsubscribe function to remove the callback\n   */\n  onEvent(callback: KYCEventCallback): () => void {\n    this.eventCallbacks.push(callback);\n    return () => {\n      this.eventCallbacks = this.eventCallbacks.filter((cb) => cb !== callback);\n    };\n  }\n\n  /**\n   * Emits a status event to all registered callbacks\n   * @param event The event to emit\n   */\n  private emitEvent(event: KYCStatusEvent): void {\n    this.eventCallbacks.forEach((callback) => callback(event));\n  }\n\n  /**\n   * Creates a verification token for secure API access\n   * @param externalId External reference ID\n   * @param expiry Token expiry in hours (default: 3)\n   * @returns Object containing the token and its expiration time\n   */\n  async createVerificationToken(\n    externalId: string,\n    expiry: string = '3'\n  ): Promise<{ token: string; expiresIn: string }> {\n    try {\n      const response = await this.client.post('/verification/token', {\n        externalId,\n        expiry,\n      });\n\n      return response.data;\n    } catch (error: any) {\n      const message =\n        error.response?.data?.message || error.message || 'Failed to create verification token';\n      throw new KYCSdkError(message, 'TOKEN_CREATE_FAILED', error.response?.status);\n    }\n  }\n\n  /**\n   * Starts a new verification session\n   * @param params Parameters including documentType, country, identityId, and externalId\n   * @returns Verification session with verificationId and status\n   */\n  async startVerification(params: StartVerificationParams): Promise<VerificationSession> {\n    try {\n      const response = await this.client.post('/verification/start', params);\n\n      this.emitEvent({\n        type: 'statusChanged',\n        status: 'PENDING',\n      });\n\n      return response.data;\n    } catch (error: any) {\n      const message =\n        error.response?.data?.message || error.message || 'Failed to start verification';\n      throw new KYCSdkError(message, 'VERIFICATION_START_FAILED', error.response?.status);\n    }\n  }\n\n  /**\n   * Uploads a selfie image for face verification\n   * @param params Parameters including verificationId, imageData, and optional mimeType\n   * @returns Upload result with status\n   */\n  async uploadSelfie(params: UploadSelfieParams): Promise<UploadResult> {\n    try {\n      const formData = new FormData();\n      formData.append('verificationId', params.verificationId);\n\n      const mimeType = params.mimeType || 'image/jpeg';\n      const imageData = params.imageData;\n\n      if (imageData.startsWith('file://')) {\n        formData.append('file', {\n          uri: imageData,\n          type: mimeType,\n          name: 'selfie.jpg',\n        } as any);\n      } else if (imageData.startsWith('data:')) {\n        formData.append('file', {\n          uri: imageData,\n          type: mimeType,\n          name: 'selfie.jpg',\n        } as any);\n      } else {\n        formData.append('file', {\n          uri: `data:${mimeType};base64,${imageData}`,\n          type: mimeType,\n          name: 'selfie.jpg',\n        } as any);\n      }\n\n      const response = await this.client.post('/verification/upload/selfie', formData, {\n        headers: { 'Content-Type': 'multipart/form-data' },\n      });\n\n      this.emitEvent({\n        type: 'statusChanged',\n        status: 'PROCESSING',\n      });\n\n      return response.data;\n    } catch (error: any) {\n      console.log('Upload selfie error:', error.response?.data || error.message);\n      const message = error.response?.data?.message || error.message || 'Failed to upload selfie';\n      throw new KYCSdkError(message, 'SELFIE_UPLOAD_FAILED', error.response?.status);\n    }\n  }\n\n  /**\n   * Uploads a document image (front or back)\n   * @param params Parameters including verificationId, type, imageData, and optional mimeType\n   * @returns Upload result with status\n   */\n  async uploadDocument(params: UploadDocumentParams): Promise<UploadResult> {\n    try {\n      const formData = new FormData();\n      formData.append('verificationId', params.verificationId);\n      formData.append('type', params.type);\n\n      const mimeType = params.mimeType || 'image/jpeg';\n      const imageData = params.imageData;\n\n      if (imageData.startsWith('file://')) {\n        formData.append('file', {\n          uri: imageData,\n          type: mimeType,\n          name: `${params.type}.jpg`,\n        } as any);\n      } else if (imageData.startsWith('data:')) {\n        formData.append('file', {\n          uri: imageData,\n          type: mimeType,\n          name: `${params.type}.jpg`,\n        } as any);\n      } else {\n        formData.append('file', {\n          uri: `data:${mimeType};base64,${imageData}`,\n          type: mimeType,\n          name: `${params.type}.jpg`,\n        } as any);\n      }\n\n      const response = await this.client.post('/verification/upload/document', formData, {\n        headers: { 'Content-Type': 'multipart/form-data' },\n      });\n\n      this.emitEvent({\n        type: 'statusChanged',\n        status: 'PROCESSING',\n      });\n\n      return response.data;\n    } catch (error: any) {\n      console.log('Upload document error:', error.response?.data || error.message);\n      const message = error.response?.data?.message || error.message || 'Failed to upload document';\n      throw new KYCSdkError(message, 'DOCUMENT_UPLOAD_FAILED', error.response?.status);\n    }\n  }\n\n  /**\n   * Gets the current status of a verification session\n   * @param verificationId The verification ID to check\n   * @returns Current verification status including OCR data and face match score\n   */\n  async getStatus(verificationId: string): Promise<VerificationStatus> {\n    try {\n      const response = await this.client.get(`/verification/status/${verificationId}`);\n\n      this.emitEvent({\n        type: 'statusChanged',\n        status: response.data.status,\n      });\n\n      return response.data;\n    } catch (error: any) {\n      const message =\n        error.response?.data?.message || error.message || 'Failed to get verification status';\n      throw new KYCSdkError(message, 'STATUS_CHECK_FAILED', error.response?.status);\n    }\n  }\n\n  /**\n   * Polls for verification status until completion or timeout\n   * @param verificationId The verification ID to check\n   * @param interval Polling interval in milliseconds (default: 3000)\n   * @param timeout Maximum time to wait in milliseconds (default: 120000)\n   * @returns Final verification status when approved or rejected\n   */\n  async pollStatus(\n    verificationId: string,\n    interval: number = 3000,\n    timeout: number = 120000\n  ): Promise<VerificationStatus> {\n    const startTime = Date.now();\n\n    return new Promise((resolve, reject) => {\n      const poll = async () => {\n        try {\n          const status = await this.getStatus(verificationId);\n\n          if (status.status === 'APPROVED' || status.status === 'REJECTED') {\n            resolve(status);\n            return;\n          }\n\n          if (Date.now() - startTime > timeout) {\n            reject(new KYCSdkError('Polling timeout', 'POLLING_TIMEOUT'));\n            return;\n          }\n\n          setTimeout(poll, interval);\n        } catch (error) {\n          reject(error);\n        }\n      };\n\n      poll();\n    });\n  }\n\n  /**\n   * Static factory method to create a KYC client instance\n   * @param credentials API credentials (apiKey and baseUrl)\n   * @returns Configured KYCCore instance\n   */\n  static createClient(credentials: KYCCredentials): KYCCore {\n    return new KYCCore(credentials);\n  }\n}\n\n/**\n * Factory function to create a KYC client instance\n * @param credentials API credentials (apiKey and baseUrl)\n * @returns Configured KYCCore instance\n */\nexport function createKYCClient(credentials: KYCCredentials): KYCCore {\n  return KYCCore.createClient(credentials);\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,243 @@
+import axios from 'axios';
+
+// src/index.ts
+var KYCSdkError = class extends Error {
+  /**
+   * Creates a new KYC SDK error
+   * @param message Human-readable error message
+   * @param code Error code for handling
+   * @param statusCode Optional HTTP status code
+   */
+  constructor(message, code, statusCode) {
+    super(message);
+    this.name = "KYCSdkError";
+    this.code = code;
+    this.statusCode = statusCode;
+  }
+};
+var KYCCore = class _KYCCore {
+  /**
+   * Creates a new KYC Core instance
+   * @param credentials API credentials (apiKey and baseUrl)
+   */
+  constructor(credentials) {
+    this.eventCallbacks = [];
+    this.credentials = credentials;
+    this.client = axios.create({
+      baseURL: credentials.baseUrl,
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json"
+      }
+    });
+    this.client.interceptors.request.use((config) => {
+      config.headers["x-api-key"] = this.credentials.apiKey;
+      return config;
+    });
+  }
+  /**
+   * Registers a callback for KYC status events
+   * @param callback Function to call when status changes
+   * @returns Unsubscribe function to remove the callback
+   */
+  onEvent(callback) {
+    this.eventCallbacks.push(callback);
+    return () => {
+      this.eventCallbacks = this.eventCallbacks.filter((cb) => cb !== callback);
+    };
+  }
+  /**
+   * Emits a status event to all registered callbacks
+   * @param event The event to emit
+   */
+  emitEvent(event) {
+    this.eventCallbacks.forEach((callback) => callback(event));
+  }
+  /**
+   * Creates a verification token for secure API access
+   * @param externalId External reference ID
+   * @param expiry Token expiry in hours (default: 3)
+   * @returns Object containing the token and its expiration time
+   */
+  async createVerificationToken(externalId, expiry = "3") {
+    try {
+      const response = await this.client.post("/verification/token", {
+        externalId,
+        expiry
+      });
+      return response.data;
+    } catch (error) {
+      const message = error.response?.data?.message || error.message || "Failed to create verification token";
+      throw new KYCSdkError(message, "TOKEN_CREATE_FAILED", error.response?.status);
+    }
+  }
+  /**
+   * Starts a new verification session
+   * @param params Parameters including documentType, country, identityId, and externalId
+   * @returns Verification session with verificationId and status
+   */
+  async startVerification(params) {
+    try {
+      const response = await this.client.post("/verification/start", params);
+      this.emitEvent({
+        type: "statusChanged",
+        status: "PENDING"
+      });
+      return response.data;
+    } catch (error) {
+      const message = error.response?.data?.message || error.message || "Failed to start verification";
+      throw new KYCSdkError(message, "VERIFICATION_START_FAILED", error.response?.status);
+    }
+  }
+  /**
+   * Uploads a selfie image for face verification
+   * @param params Parameters including verificationId, imageData, and optional mimeType
+   * @returns Upload result with status
+   */
+  async uploadSelfie(params) {
+    try {
+      const formData = new FormData();
+      formData.append("verificationId", params.verificationId);
+      const mimeType = params.mimeType || "image/jpeg";
+      const imageData = params.imageData;
+      if (imageData.startsWith("file://")) {
+        formData.append("file", {
+          uri: imageData,
+          type: mimeType,
+          name: "selfie.jpg"
+        });
+      } else if (imageData.startsWith("data:")) {
+        formData.append("file", {
+          uri: imageData,
+          type: mimeType,
+          name: "selfie.jpg"
+        });
+      } else {
+        formData.append("file", {
+          uri: `data:${mimeType};base64,${imageData}`,
+          type: mimeType,
+          name: "selfie.jpg"
+        });
+      }
+      const response = await this.client.post("/verification/upload/selfie", formData, {
+        headers: { "Content-Type": "multipart/form-data" }
+      });
+      this.emitEvent({
+        type: "statusChanged",
+        status: "PROCESSING"
+      });
+      return response.data;
+    } catch (error) {
+      console.log("Upload selfie error:", error.response?.data || error.message);
+      const message = error.response?.data?.message || error.message || "Failed to upload selfie";
+      throw new KYCSdkError(message, "SELFIE_UPLOAD_FAILED", error.response?.status);
+    }
+  }
+  /**
+   * Uploads a document image (front or back)
+   * @param params Parameters including verificationId, type, imageData, and optional mimeType
+   * @returns Upload result with status
+   */
+  async uploadDocument(params) {
+    try {
+      const formData = new FormData();
+      formData.append("verificationId", params.verificationId);
+      formData.append("type", params.type);
+      const mimeType = params.mimeType || "image/jpeg";
+      const imageData = params.imageData;
+      if (imageData.startsWith("file://")) {
+        formData.append("file", {
+          uri: imageData,
+          type: mimeType,
+          name: `${params.type}.jpg`
+        });
+      } else if (imageData.startsWith("data:")) {
+        formData.append("file", {
+          uri: imageData,
+          type: mimeType,
+          name: `${params.type}.jpg`
+        });
+      } else {
+        formData.append("file", {
+          uri: `data:${mimeType};base64,${imageData}`,
+          type: mimeType,
+          name: `${params.type}.jpg`
+        });
+      }
+      const response = await this.client.post("/verification/upload/document", formData, {
+        headers: { "Content-Type": "multipart/form-data" }
+      });
+      this.emitEvent({
+        type: "statusChanged",
+        status: "PROCESSING"
+      });
+      return response.data;
+    } catch (error) {
+      console.log("Upload document error:", error.response?.data || error.message);
+      const message = error.response?.data?.message || error.message || "Failed to upload document";
+      throw new KYCSdkError(message, "DOCUMENT_UPLOAD_FAILED", error.response?.status);
+    }
+  }
+  /**
+   * Gets the current status of a verification session
+   * @param verificationId The verification ID to check
+   * @returns Current verification status including OCR data and face match score
+   */
+  async getStatus(verificationId) {
+    try {
+      const response = await this.client.get(`/verification/status/${verificationId}`);
+      this.emitEvent({
+        type: "statusChanged",
+        status: response.data.status
+      });
+      return response.data;
+    } catch (error) {
+      const message = error.response?.data?.message || error.message || "Failed to get verification status";
+      throw new KYCSdkError(message, "STATUS_CHECK_FAILED", error.response?.status);
+    }
+  }
+  /**
+   * Polls for verification status until completion or timeout
+   * @param verificationId The verification ID to check
+   * @param interval Polling interval in milliseconds (default: 3000)
+   * @param timeout Maximum time to wait in milliseconds (default: 120000)
+   * @returns Final verification status when approved or rejected
+   */
+  async pollStatus(verificationId, interval = 3e3, timeout = 12e4) {
+    const startTime = Date.now();
+    return new Promise((resolve, reject) => {
+      const poll = async () => {
+        try {
+          const status = await this.getStatus(verificationId);
+          if (status.status === "APPROVED" || status.status === "REJECTED") {
+            resolve(status);
+            return;
+          }
+          if (Date.now() - startTime > timeout) {
+            reject(new KYCSdkError("Polling timeout", "POLLING_TIMEOUT"));
+            return;
+          }
+          setTimeout(poll, interval);
+        } catch (error) {
+          reject(error);
+        }
+      };
+      poll();
+    });
+  }
+  /**
+   * Static factory method to create a KYC client instance
+   * @param credentials API credentials (apiKey and baseUrl)
+   * @returns Configured KYCCore instance
+   */
+  static createClient(credentials) {
+    return new _KYCCore(credentials);
+  }
+};
+function createKYCClient(credentials) {
+  return KYCCore.createClient(credentials);
+}
+
+export { KYCCore, KYCSdkError, createKYCClient };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import axios, { AxiosInstance } from 'axios';\n\n/**\n * Credentials required to initialize the KYC SDK\n */\nexport interface KYCCredentials {\n  /** API key for authentication */\n  apiKey: string;\n  /** Base URL of the KYC API */\n  baseUrl: string;\n}\n\n/**\n * Parameters required to start a verification session\n */\nexport interface StartVerificationParams {\n  /** Type of document to verify (e.g., IDENTITY_CARD, DRIVING_LICENSE) */\n  documentType: 'IDENTITY_CARD' | 'DRIVING_LICENSE';\n  /** Country code (e.g., MZ, AO, PT) */\n  country: string;\n  /** Optional existing identity ID to link verification to */\n  identityId?: string;\n  /** Optional external reference ID */\n  externalId?: string;\n}\n\n/**\n * Response from starting a verification session\n */\nexport interface VerificationSession {\n  /** Unique verification ID */\n  verificationId: string;\n  /** Linked identity ID (if exists) */\n  identityId?: string;\n  /** Current verification status */\n  status: string;\n}\n\n/**\n * Parameters for uploading a selfie image\n */\nexport interface UploadSelfieParams {\n  /** Verification ID to attach the selfie to */\n  verificationId: string;\n  /** Base64 encoded image data, data URI, or file:// URI (React Native) */\n  imageData: string;\n  /** MIME type of the image (default: image/jpeg) */\n  mimeType?: string;\n}\n\n/**\n * Parameters for uploading a document image\n */\nexport interface UploadDocumentParams {\n  /** Verification ID to attach the document to */\n  verificationId: string;\n  /** Type of document (front or back) */\n  type: 'front' | 'back';\n  /** Base64 encoded image data, data URI, or file:// URI (React Native) */\n  imageData: string;\n  /** MIME type of the image (default: image/jpeg) */\n  mimeType?: string;\n}\n\n/** Result of an upload operation */\nexport interface UploadResult {\n  /** Response message */\n  message: string;\n  /** Current status after upload */\n  status: string;\n}\n\n/** Current status of a verification session */\nexport interface VerificationStatus {\n  /** Verification ID */\n  verificationId: string;\n  /** Current status: PENDING, PROCESSING, APPROVED, or REJECTED */\n  status: 'PENDING' | 'PROCESSING' | 'APPROVED' | 'REJECTED';\n  /** Face match similarity score (0-1) */\n  faceMatchScore?: number;\n  /** OCR extracted data from document */\n  ocrData?: {\n    /** Full name extracted from document */\n    fullName?: string;\n    /** ID number extracted from document */\n    idNumber?: string;\n    /** Birth date extracted from document */\n    birthDate?: string;\n    /** Expiry date extracted from document */\n    expiryDate?: string;\n    /** Additional extracted fields */\n    [key: string]: any;\n  };\n  /** When the verification was created */\n  createdAt: string;\n  /** When the verification was last updated */\n  updatedAt: string;\n}\n\n/** Event emitted when KYC status changes */\nexport interface KYCStatusEvent {\n  /** Type of event: statusChanged or error */\n  type: 'statusChanged' | 'error';\n  /** New status (for statusChanged events) */\n  status?: string;\n  /** Error message (for error events) */\n  error?: string;\n}\n\n/** Callback function for handling KYC status events */\nexport type KYCEventCallback = (event: KYCStatusEvent) => void;\n\n/**\n * Custom error class for KYC SDK errors\n */\nexport class KYCSdkError extends Error {\n  /** Error code for programmatic error handling */\n  code: string;\n  /** HTTP status code if available */\n  statusCode?: number;\n\n  /**\n   * Creates a new KYC SDK error\n   * @param message Human-readable error message\n   * @param code Error code for handling\n   * @param statusCode Optional HTTP status code\n   */\n  constructor(message: string, code: string, statusCode?: number) {\n    super(message);\n    this.name = 'KYCSdkError';\n    this.code = code;\n    this.statusCode = statusCode;\n  }\n}\n\n/**\n * Core KYC SDK client for interacting with the verification API\n */\nexport class KYCCore {\n  private client: AxiosInstance;\n  private credentials: KYCCredentials;\n  private eventCallbacks: KYCEventCallback[] = [];\n\n  /**\n   * Creates a new KYC Core instance\n   * @param credentials API credentials (apiKey and baseUrl)\n   */\n  constructor(credentials: KYCCredentials) {\n    this.credentials = credentials;\n    this.client = axios.create({\n      baseURL: credentials.baseUrl,\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'application/json',\n      },\n    });\n\n    this.client.interceptors.request.use((config) => {\n      config.headers['x-api-key'] = this.credentials.apiKey;\n      return config;\n    });\n  }\n\n  /**\n   * Registers a callback for KYC status events\n   * @param callback Function to call when status changes\n   * @returns Unsubscribe function to remove the callback\n   */\n  onEvent(callback: KYCEventCallback): () => void {\n    this.eventCallbacks.push(callback);\n    return () => {\n      this.eventCallbacks = this.eventCallbacks.filter((cb) => cb !== callback);\n    };\n  }\n\n  /**\n   * Emits a status event to all registered callbacks\n   * @param event The event to emit\n   */\n  private emitEvent(event: KYCStatusEvent): void {\n    this.eventCallbacks.forEach((callback) => callback(event));\n  }\n\n  /**\n   * Creates a verification token for secure API access\n   * @param externalId External reference ID\n   * @param expiry Token expiry in hours (default: 3)\n   * @returns Object containing the token and its expiration time\n   */\n  async createVerificationToken(\n    externalId: string,\n    expiry: string = '3'\n  ): Promise<{ token: string; expiresIn: string }> {\n    try {\n      const response = await this.client.post('/verification/token', {\n        externalId,\n        expiry,\n      });\n\n      return response.data;\n    } catch (error: any) {\n      const message =\n        error.response?.data?.message || error.message || 'Failed to create verification token';\n      throw new KYCSdkError(message, 'TOKEN_CREATE_FAILED', error.response?.status);\n    }\n  }\n\n  /**\n   * Starts a new verification session\n   * @param params Parameters including documentType, country, identityId, and externalId\n   * @returns Verification session with verificationId and status\n   */\n  async startVerification(params: StartVerificationParams): Promise<VerificationSession> {\n    try {\n      const response = await this.client.post('/verification/start', params);\n\n      this.emitEvent({\n        type: 'statusChanged',\n        status: 'PENDING',\n      });\n\n      return response.data;\n    } catch (error: any) {\n      const message =\n        error.response?.data?.message || error.message || 'Failed to start verification';\n      throw new KYCSdkError(message, 'VERIFICATION_START_FAILED', error.response?.status);\n    }\n  }\n\n  /**\n   * Uploads a selfie image for face verification\n   * @param params Parameters including verificationId, imageData, and optional mimeType\n   * @returns Upload result with status\n   */\n  async uploadSelfie(params: UploadSelfieParams): Promise<UploadResult> {\n    try {\n      const formData = new FormData();\n      formData.append('verificationId', params.verificationId);\n\n      const mimeType = params.mimeType || 'image/jpeg';\n      const imageData = params.imageData;\n\n      if (imageData.startsWith('file://')) {\n        formData.append('file', {\n          uri: imageData,\n          type: mimeType,\n          name: 'selfie.jpg',\n        } as any);\n      } else if (imageData.startsWith('data:')) {\n        formData.append('file', {\n          uri: imageData,\n          type: mimeType,\n          name: 'selfie.jpg',\n        } as any);\n      } else {\n        formData.append('file', {\n          uri: `data:${mimeType};base64,${imageData}`,\n          type: mimeType,\n          name: 'selfie.jpg',\n        } as any);\n      }\n\n      const response = await this.client.post('/verification/upload/selfie', formData, {\n        headers: { 'Content-Type': 'multipart/form-data' },\n      });\n\n      this.emitEvent({\n        type: 'statusChanged',\n        status: 'PROCESSING',\n      });\n\n      return response.data;\n    } catch (error: any) {\n      console.log('Upload selfie error:', error.response?.data || error.message);\n      const message = error.response?.data?.message || error.message || 'Failed to upload selfie';\n      throw new KYCSdkError(message, 'SELFIE_UPLOAD_FAILED', error.response?.status);\n    }\n  }\n\n  /**\n   * Uploads a document image (front or back)\n   * @param params Parameters including verificationId, type, imageData, and optional mimeType\n   * @returns Upload result with status\n   */\n  async uploadDocument(params: UploadDocumentParams): Promise<UploadResult> {\n    try {\n      const formData = new FormData();\n      formData.append('verificationId', params.verificationId);\n      formData.append('type', params.type);\n\n      const mimeType = params.mimeType || 'image/jpeg';\n      const imageData = params.imageData;\n\n      if (imageData.startsWith('file://')) {\n        formData.append('file', {\n          uri: imageData,\n          type: mimeType,\n          name: `${params.type}.jpg`,\n        } as any);\n      } else if (imageData.startsWith('data:')) {\n        formData.append('file', {\n          uri: imageData,\n          type: mimeType,\n          name: `${params.type}.jpg`,\n        } as any);\n      } else {\n        formData.append('file', {\n          uri: `data:${mimeType};base64,${imageData}`,\n          type: mimeType,\n          name: `${params.type}.jpg`,\n        } as any);\n      }\n\n      const response = await this.client.post('/verification/upload/document', formData, {\n        headers: { 'Content-Type': 'multipart/form-data' },\n      });\n\n      this.emitEvent({\n        type: 'statusChanged',\n        status: 'PROCESSING',\n      });\n\n      return response.data;\n    } catch (error: any) {\n      console.log('Upload document error:', error.response?.data || error.message);\n      const message = error.response?.data?.message || error.message || 'Failed to upload document';\n      throw new KYCSdkError(message, 'DOCUMENT_UPLOAD_FAILED', error.response?.status);\n    }\n  }\n\n  /**\n   * Gets the current status of a verification session\n   * @param verificationId The verification ID to check\n   * @returns Current verification status including OCR data and face match score\n   */\n  async getStatus(verificationId: string): Promise<VerificationStatus> {\n    try {\n      const response = await this.client.get(`/verification/status/${verificationId}`);\n\n      this.emitEvent({\n        type: 'statusChanged',\n        status: response.data.status,\n      });\n\n      return response.data;\n    } catch (error: any) {\n      const message =\n        error.response?.data?.message || error.message || 'Failed to get verification status';\n      throw new KYCSdkError(message, 'STATUS_CHECK_FAILED', error.response?.status);\n    }\n  }\n\n  /**\n   * Polls for verification status until completion or timeout\n   * @param verificationId The verification ID to check\n   * @param interval Polling interval in milliseconds (default: 3000)\n   * @param timeout Maximum time to wait in milliseconds (default: 120000)\n   * @returns Final verification status when approved or rejected\n   */\n  async pollStatus(\n    verificationId: string,\n    interval: number = 3000,\n    timeout: number = 120000\n  ): Promise<VerificationStatus> {\n    const startTime = Date.now();\n\n    return new Promise((resolve, reject) => {\n      const poll = async () => {\n        try {\n          const status = await this.getStatus(verificationId);\n\n          if (status.status === 'APPROVED' || status.status === 'REJECTED') {\n            resolve(status);\n            return;\n          }\n\n          if (Date.now() - startTime > timeout) {\n            reject(new KYCSdkError('Polling timeout', 'POLLING_TIMEOUT'));\n            return;\n          }\n\n          setTimeout(poll, interval);\n        } catch (error) {\n          reject(error);\n        }\n      };\n\n      poll();\n    });\n  }\n\n  /**\n   * Static factory method to create a KYC client instance\n   * @param credentials API credentials (apiKey and baseUrl)\n   * @returns Configured KYCCore instance\n   */\n  static createClient(credentials: KYCCredentials): KYCCore {\n    return new KYCCore(credentials);\n  }\n}\n\n/**\n * Factory function to create a KYC client instance\n * @param credentials API credentials (apiKey and baseUrl)\n * @returns Configured KYCCore instance\n */\nexport function createKYCClient(credentials: KYCCredentials): KYCCore {\n  return KYCCore.createClient(credentials);\n}\n"]}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@kyciris/core",
+  "version": "0.1.0",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "import": "./dist/index.mjs",
+    "require": "./dist/index.js"
+  },
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "eslint": "^9.25.0",
+    "tsup": "^8.0.0",
+    "typescript": "~5.9.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/"
+  }
+}