@koraidv/core 1.7.1 → 1.7.3

package/dist/index.d.mts

@@ -532,7 +532,22 @@ declare class ApiClient {
     private readonly baseDelay;
     constructor(configuration: Configuration);
     /**
-     * Get supported countries and their document types
+     * Get supported countries and their document types.
+     *
+     * Backend has no dedicated /supported-countries endpoint — the
+     * countries catalog is bundled into the /document-types response
+     * alongside the per-type metadata. We fetch that bundled payload,
+     * then project it onto the SDK's `SupportedCountry` shape:
+     *   - `id` ← `code` (ISO-3166 alpha-2)
+     *   - `flagEmoji` derived from the ISO code
+     *   - `documentTypes` filtered from the bundled types list by country
+     *
+     * Mirrors the iOS / Android pattern (SessionManager.fetchSupported-
+     * Countries on iOS, ApiService.getDocumentTypes on Android). The
+     * previous standalone /supported-countries call had been silently
+     * 404-ing since the Web SDK shipped — surfaced 2026-05-29 by
+     * Luckycat's integration, hot on the heels of the v1.7.1
+     * wire-format pass.
      */
     getSupportedCountries(): Promise<SupportedCountry[]>;
     /**
@@ -590,6 +605,22 @@ declare class ApiClient {
     submitLivenessChallenge(verificationId: string, challenge: LivenessChallenge, imageData: Blob): Promise<LivenessChallengeResponse>;
     /**
      * Check document quality before uploading.
+     *
+     * Outlier endpoint: backend's `CheckDocumentQualityRequest` is the
+     * one struct in identity-service still using snake_case JSON tags
+     * (`document_front_base64`, `document_type`). Every other request
+     * body on this client is camelCase. The v1.7.1 wire-format pass
+     * blanket-converted this one too and broke it with a 400 from
+     * gin's `binding:"required"` validator — fixed in v1.7.3 by
+     * sending snake_case for just this one endpoint. The response
+     * decoder still goes through transformResponse() which converts
+     * snake_case → camelCase, so DocumentQualityResponse on the SDK
+     * surface is unchanged.
+     *
+     * If the backend is ever unified onto camelCase, this can revert
+     * to the standard camelCase body — but Android currently sends
+     * snake_case via @SerializedName, so any backend change there
+     * needs an Android coordination first.
      */
     checkDocumentQuality(imageData: Blob, documentType: string): Promise<DocumentQualityResponse>;
     /**

package/dist/index.d.ts

@@ -532,7 +532,22 @@ declare class ApiClient {
     private readonly baseDelay;
     constructor(configuration: Configuration);
     /**
-     * Get supported countries and their document types
+     * Get supported countries and their document types.
+     *
+     * Backend has no dedicated /supported-countries endpoint — the
+     * countries catalog is bundled into the /document-types response
+     * alongside the per-type metadata. We fetch that bundled payload,
+     * then project it onto the SDK's `SupportedCountry` shape:
+     *   - `id` ← `code` (ISO-3166 alpha-2)
+     *   - `flagEmoji` derived from the ISO code
+     *   - `documentTypes` filtered from the bundled types list by country
+     *
+     * Mirrors the iOS / Android pattern (SessionManager.fetchSupported-
+     * Countries on iOS, ApiService.getDocumentTypes on Android). The
+     * previous standalone /supported-countries call had been silently
+     * 404-ing since the Web SDK shipped — surfaced 2026-05-29 by
+     * Luckycat's integration, hot on the heels of the v1.7.1
+     * wire-format pass.
      */
     getSupportedCountries(): Promise<SupportedCountry[]>;
     /**
@@ -590,6 +605,22 @@ declare class ApiClient {
     submitLivenessChallenge(verificationId: string, challenge: LivenessChallenge, imageData: Blob): Promise<LivenessChallengeResponse>;
     /**
      * Check document quality before uploading.
+     *
+     * Outlier endpoint: backend's `CheckDocumentQualityRequest` is the
+     * one struct in identity-service still using snake_case JSON tags
+     * (`document_front_base64`, `document_type`). Every other request
+     * body on this client is camelCase. The v1.7.1 wire-format pass
+     * blanket-converted this one too and broke it with a 400 from
+     * gin's `binding:"required"` validator — fixed in v1.7.3 by
+     * sending snake_case for just this one endpoint. The response
+     * decoder still goes through transformResponse() which converts
+     * snake_case → camelCase, so DocumentQualityResponse on the SDK
+     * surface is unchanged.
+     *
+     * If the backend is ever unified onto camelCase, this can revert
+     * to the standard camelCase body — but Android currently sends
+     * snake_case via @SerializedName, so any backend change there
+     * needs an Android coordination first.
      */
     checkDocumentQuality(imageData: Blob, documentType: string): Promise<DocumentQualityResponse>;
     /**

package/dist/index.js

@@ -538,10 +538,31 @@ var ApiClient = class {
     this.baseUrl = environmentUrls[configuration.environment];
   }
   /**
-   * Get supported countries and their document types
+   * Get supported countries and their document types.
+   *
+   * Backend has no dedicated /supported-countries endpoint — the
+   * countries catalog is bundled into the /document-types response
+   * alongside the per-type metadata. We fetch that bundled payload,
+   * then project it onto the SDK's `SupportedCountry` shape:
+   *   - `id` ← `code` (ISO-3166 alpha-2)
+   *   - `flagEmoji` derived from the ISO code
+   *   - `documentTypes` filtered from the bundled types list by country
+   *
+   * Mirrors the iOS / Android pattern (SessionManager.fetchSupported-
+   * Countries on iOS, ApiService.getDocumentTypes on Android). The
+   * previous standalone /supported-countries call had been silently
+   * 404-ing since the Web SDK shipped — surfaced 2026-05-29 by
+   * Luckycat's integration, hot on the heels of the v1.7.1
+   * wire-format pass.
    */
   async getSupportedCountries() {
-    return this.request("/supported-countries");
+    const response = await this.request("/document-types");
+    return response.countries.map((c) => ({
+      id: c.code,
+      name: c.name,
+      flagEmoji: countryCodeToFlagEmoji(c.code),
+      documentTypes: response.documentTypes.filter((dt) => dt.country === c.code).map((dt) => dt.type)
+    })).filter((country) => country.documentTypes.length > 0);
   }
   /**
    * Create a new verification
@@ -671,14 +692,30 @@ var ApiClient = class {
   }
   /**
    * Check document quality before uploading.
+   *
+   * Outlier endpoint: backend's `CheckDocumentQualityRequest` is the
+   * one struct in identity-service still using snake_case JSON tags
+   * (`document_front_base64`, `document_type`). Every other request
+   * body on this client is camelCase. The v1.7.1 wire-format pass
+   * blanket-converted this one too and broke it with a 400 from
+   * gin's `binding:"required"` validator — fixed in v1.7.3 by
+   * sending snake_case for just this one endpoint. The response
+   * decoder still goes through transformResponse() which converts
+   * snake_case → camelCase, so DocumentQualityResponse on the SDK
+   * surface is unchanged.
+   *
+   * If the backend is ever unified onto camelCase, this can revert
+   * to the standard camelCase body — but Android currently sends
+   * snake_case via @SerializedName, so any backend change there
+   * needs an Android coordination first.
    */
   async checkDocumentQuality(imageData, documentType) {
     const documentFrontBase64 = await blobToBase64(imageData);
     return this.request("/kyc/document-quality", {
       method: "POST",
       body: JSON.stringify({
-        documentFrontBase64,
-        documentType
+        document_front_base64: documentFrontBase64,
+        document_type: documentType
       })
     });
   }
@@ -839,6 +876,15 @@ function instructionForChallengeType(type) {
       return "Follow the on-screen prompt";
   }
 }
+function countryCodeToFlagEmoji(code) {
+  if (!code || code.length !== 2) return "";
+  const upper = code.toUpperCase();
+  const a = upper.charCodeAt(0);
+  const b = upper.charCodeAt(1);
+  if (a < 65 || a > 90 || b < 65 || b > 90) return "";
+  const offset = 127462 - 65;
+  return String.fromCodePoint(a + offset, b + offset);
+}
 
 // src/KoraIDV.ts
 var KoraIDV = class {

package/dist/index.mjs

@@ -494,10 +494,31 @@ var ApiClient = class {
     this.baseUrl = environmentUrls[configuration.environment];
   }
   /**
-   * Get supported countries and their document types
+   * Get supported countries and their document types.
+   *
+   * Backend has no dedicated /supported-countries endpoint — the
+   * countries catalog is bundled into the /document-types response
+   * alongside the per-type metadata. We fetch that bundled payload,
+   * then project it onto the SDK's `SupportedCountry` shape:
+   *   - `id` ← `code` (ISO-3166 alpha-2)
+   *   - `flagEmoji` derived from the ISO code
+   *   - `documentTypes` filtered from the bundled types list by country
+   *
+   * Mirrors the iOS / Android pattern (SessionManager.fetchSupported-
+   * Countries on iOS, ApiService.getDocumentTypes on Android). The
+   * previous standalone /supported-countries call had been silently
+   * 404-ing since the Web SDK shipped — surfaced 2026-05-29 by
+   * Luckycat's integration, hot on the heels of the v1.7.1
+   * wire-format pass.
    */
   async getSupportedCountries() {
-    return this.request("/supported-countries");
+    const response = await this.request("/document-types");
+    return response.countries.map((c) => ({
+      id: c.code,
+      name: c.name,
+      flagEmoji: countryCodeToFlagEmoji(c.code),
+      documentTypes: response.documentTypes.filter((dt) => dt.country === c.code).map((dt) => dt.type)
+    })).filter((country) => country.documentTypes.length > 0);
   }
   /**
    * Create a new verification
@@ -627,14 +648,30 @@ var ApiClient = class {
   }
   /**
    * Check document quality before uploading.
+   *
+   * Outlier endpoint: backend's `CheckDocumentQualityRequest` is the
+   * one struct in identity-service still using snake_case JSON tags
+   * (`document_front_base64`, `document_type`). Every other request
+   * body on this client is camelCase. The v1.7.1 wire-format pass
+   * blanket-converted this one too and broke it with a 400 from
+   * gin's `binding:"required"` validator — fixed in v1.7.3 by
+   * sending snake_case for just this one endpoint. The response
+   * decoder still goes through transformResponse() which converts
+   * snake_case → camelCase, so DocumentQualityResponse on the SDK
+   * surface is unchanged.
+   *
+   * If the backend is ever unified onto camelCase, this can revert
+   * to the standard camelCase body — but Android currently sends
+   * snake_case via @SerializedName, so any backend change there
+   * needs an Android coordination first.
    */
   async checkDocumentQuality(imageData, documentType) {
     const documentFrontBase64 = await blobToBase64(imageData);
     return this.request("/kyc/document-quality", {
       method: "POST",
       body: JSON.stringify({
-        documentFrontBase64,
-        documentType
+        document_front_base64: documentFrontBase64,
+        document_type: documentType
       })
     });
   }
@@ -795,6 +832,15 @@ function instructionForChallengeType(type) {
       return "Follow the on-screen prompt";
   }
 }
+function countryCodeToFlagEmoji(code) {
+  if (!code || code.length !== 2) return "";
+  const upper = code.toUpperCase();
+  const a = upper.charCodeAt(0);
+  const b = upper.charCodeAt(1);
+  if (a < 65 || a > 90 || b < 65 || b > 90) return "";
+  const offset = 127462 - 65;
+  return String.fromCodePoint(a + offset, b + offset);
+}
 
 // src/KoraIDV.ts
 var KoraIDV = class {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koraidv/core",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "description": "Kora IDV Core SDK - API Client and Utilities",
   "main": "dist/index.js",
   "module": "dist/index.mjs",