@metamask-previews/kyc-controller 0.0.0-preview-e12b5ece6 → 0.0.0-preview-e0510042f

package/dist/KycService.mjs

@@ -24,12 +24,11 @@ export const serviceName = 'KycService';
 // === MESSENGER ===
 const MESSENGER_EXPOSED_METHODS = [
     'getGeoCountry',
-    'fetchVendorDisclaimers',
+    'fetchDisclaimers',
     'createSession',
     'checkKycRequired',
     'createVendorCustomer',
     'submitVendorDisclaimers',
-    'fetchDisclaimersCatalog',
     'fetchSessionDisclaimers',
     'submitSessionDisclaimers',
     'fetchKycStatus',
@@ -119,27 +118,13 @@ const KycUserStatusResponseStruct = type({
     sumsubSessionId: optional(string()),
     errorCode: optional(string()),
 });
-const CatalogDocumentFields = {
+const ConsentDocumentStruct = type({
     key: string(),
     version: string(),
     title: string(),
     url: string(),
-};
-const CatalogDocumentStruct = type(CatalogDocumentFields);
-// Session documents also report whether that version was already consented to.
-const ConsentDocumentStruct = type({
-    ...CatalogDocumentFields,
     consented: boolean(),
 });
-/**
- * Global catalog from `GET /disclaimers` (no per-document `consented` flag and
- * no credential-reuse flag).
- */
-const GlobalDisclaimersResponseStruct = type({
-    idOS: array(CatalogDocumentStruct),
-    kycProvider: array(CatalogDocumentStruct),
-});
-/** Session catalog from `GET`/`POST /sessions/{id}/disclaimers`. */
 const SessionDisclaimersResponseStruct = type({
     idOS: array(ConsentDocumentStruct),
     kycProvider: array(ConsentDocumentStruct),
@@ -153,21 +138,13 @@ const SessionDisclaimersResponseStruct = type({
  * `fetch` when provided), and the auth bearer token and geolocation come from
  * other controllers via the messenger.
  *
- * It extends {@link BaseDataService}, so read-only endpoints are routed through
- * `fetchQuery`: they are wrapped in the shared service policy (retries, circuit
- * breaker) and their results are exposed via the service's `QueryClient`.
- * `fetchDisclaimers` and `fetchJwks` are cached with a `staleTime`;
- * session-scoped disclaimer and status-polling reads opt out of caching
+ * It extends {@link BaseDataService}, so every request is routed through
+ * `fetchQuery`: it is wrapped in the shared service policy (retries, circuit
+ * breaker) and its result is exposed via the service's `QueryClient`. Read-only
+ * endpoints (`fetchDisclaimers`, `fetchIdosEnclaveJwks`, `fetchIdosRelayJwks`) are cached
+ * with a `staleTime`; vendor-disclaimer, session-scoped disclaimer,
+ * session-creating, and status-polling endpoints opt out of caching
  * (`staleTime`/`gcTime` of `0`) so they never serve a stale result.
- *
- * Write endpoints (every `POST`) deliberately bypass `fetchQuery`. The query
- * cache is built for idempotent reads: it deduplicates concurrent requests
- * sharing a `queryKey`, retains responses for replay, and publishes them on the
- * messenger via `cacheUpdated`. None of that is safe for calls that create
- * sessions, customers, or consents — two overlapping `createVendorCustomer`
- * calls would collapse into a single `POST`, and session tokens would be
- * broadcast as cache payloads. Writes therefore call `#requestJson` directly,
- * which also means they are not retried by the service policy.
  */
 export class KycService extends BaseDataService {
     /**
@@ -232,7 +209,7 @@ export class KycService extends BaseDataService {
         // Guard nullish/empty geolocation with the documented domain error rather
         // than letting `assert(location, string())` surface a superstruct
         // assertion error (which would change how the failure reads in
-        // `vendorError`).
+        // `disclaimersError`).
         const alpha2 = typeof location === 'string' ? location.split('-')[0].toUpperCase() : '';
         if (!alpha2 || alpha2 === 'UNKNOWN') {
             throw new Error(`Unable to determine country from geolocation (got "${String(location)}").`);
@@ -252,11 +229,11 @@ export class KycService extends BaseDataService {
      * @param params.country - ISO 3166-1 alpha-3 country code.
      * @returns The disclaimers.
      */
-    async fetchVendorDisclaimers({ vendor = 'moonpay', country, }) {
+    async fetchDisclaimers({ vendor = 'moonpay', country, }) {
         const url = new URL(`/vendors/${vendor}/disclaimers`, __classPrivateFieldGet(this, _KycService_baseUrl, "f"));
         url.searchParams.set('country', country);
         const data = await this.fetchQuery({
-            queryKey: [`${this.name}:fetchVendorDisclaimers`, vendor, country],
+            queryKey: [`${this.name}:fetchDisclaimers`, vendor, country],
             queryFn: async () => __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, { method: 'GET' }),
             staleTime: inMilliseconds(5, Duration.Minute),
         });
@@ -270,9 +247,20 @@ export class KycService extends BaseDataService {
      */
     async createSession(params) {
         const url = new URL('/vendors/moonpay/sessions', __classPrivateFieldGet(this, _KycService_baseUrl, "f"));
-        const data = await __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
-            method: 'POST',
-            body: JSON.stringify(params),
+        const data = await this.fetchQuery({
+            queryKey: [
+                `${this.name}:createSession`,
+                params.email,
+                params.termsAcceptedAt,
+                params.disclaimerIds,
+            ],
+            queryFn: async () => __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
+                method: 'POST',
+                body: JSON.stringify(params),
+            }),
+            // A session-creating mutation must never serve a stale/cached result.
+            staleTime: 0,
+            gcTime: 0,
         });
         return __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_validateResponse).call(this, data, CreateSessionResponseStruct, 'sessions');
     }
@@ -303,9 +291,21 @@ export class KycService extends BaseDataService {
                 throw new Error('checkKycRequired: country is required for vendor "moonpay".');
             }
         }
-        const data = await __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
-            method: 'POST',
-            body: JSON.stringify(body),
+        const data = await this.fetchQuery({
+            queryKey: [
+                `${this.name}:checkKycRequired`,
+                vendor,
+                params.accessToken ?? null,
+                params.country ?? null,
+                capabilities,
+            ],
+            queryFn: async () => __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
+                method: 'POST',
+                body: JSON.stringify(body),
+            }),
+            // The requirement can change server-side, so always re-check.
+            staleTime: 0,
+            gcTime: 0,
         });
         const { required } = __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_validateResponse).call(this, data, KycRequiredResponseStruct, 'kyc-required');
         return { kycRequired: required };
@@ -323,9 +323,19 @@ export class KycService extends BaseDataService {
      */
     async createVendorCustomer(params) {
         const url = new URL(`/vendors/${params.vendor}/customers`, __classPrivateFieldGet(this, _KycService_baseUrl, "f"));
-        const data = await __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
-            method: 'POST',
-            body: JSON.stringify({ email: params.email }),
+        const data = await this.fetchQuery({
+            queryKey: [
+                `${this.name}:createVendorCustomer`,
+                params.vendor,
+                params.email,
+            ],
+            queryFn: async () => __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
+                method: 'POST',
+                body: JSON.stringify({ email: params.email }),
+            }),
+            // Customer creation/resume must never serve a stale/cached result.
+            staleTime: 0,
+            gcTime: 0,
         });
         return __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_validateResponse).call(this, data, VendorCustomerResponseStruct, 'vendor customers');
     }
@@ -343,52 +353,34 @@ export class KycService extends BaseDataService {
      */
     async submitVendorDisclaimers(params) {
         const url = new URL(`/vendors/${encodeURIComponent(params.vendor)}/disclaimers`, __classPrivateFieldGet(this, _KycService_baseUrl, "f"));
-        const data = await __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
-            method: 'POST',
-            body: JSON.stringify({ disclaimerIds: params.disclaimerIds }),
-        });
-        return __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_validateResponse).call(this, data, VendorSigningsResponseStruct, 'vendor disclaimers');
-    }
-    /**
-     * Fetches the global idOS + KYC-provider disclaimer catalog
-     * (`GET /disclaimers?country=`). Carries no consent state — per-document
-     * `consented` flags and `credentialReusabilityConsentGiven` are
-     * session-scoped via {@link fetchSessionDisclaimers}. Vendor T&Cs continue to
-     * come from {@link fetchVendorDisclaimers}.
-     *
-     * @param params - The parameters.
-     * @param params.country - ISO 3166-1 alpha-3 country code.
-     * @returns The catalog documents.
-     */
-    async fetchDisclaimersCatalog({ country, }) {
-        if (country.length !== 3) {
-            throw new Error(`KycService.fetchDisclaimersCatalog: country must be an ISO 3166-1 alpha-3 code (received "${country}").`);
-        }
-        const url = new URL('/disclaimers', __classPrivateFieldGet(this, _KycService_baseUrl, "f"));
-        url.searchParams.set('country', country);
         const data = await this.fetchQuery({
-            queryKey: [`${this.name}:fetchDisclaimersCatalog`, country],
-            queryFn: async () => __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, { method: 'GET' }),
+            queryKey: [
+                `${this.name}:submitVendorDisclaimers`,
+                params.vendor,
+                params.disclaimerIds,
+            ],
+            queryFn: async () => __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
+                method: 'POST',
+                body: JSON.stringify({ disclaimerIds: params.disclaimerIds }),
+            }),
             staleTime: 0,
             gcTime: 0,
         });
-        return __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_validateResponse).call(this, data, GlobalDisclaimersResponseStruct, 'disclaimers');
+        return __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_validateResponse).call(this, data, VendorSigningsResponseStruct, 'vendor disclaimers');
     }
     /**
      * Fetches the session-scoped idOS + KYC-provider disclaimer catalog
-     * (`GET /sessions/{sessionId}/disclaimers`), including per-session
-     * `consented` flags and `credentialReusabilityConsentGiven`. For the
-     * pre-session global catalog use {@link fetchDisclaimersCatalog}. Vendor
-     * T&Cs continue to come from {@link fetchVendorDisclaimers}.
+     * (`GET /sessions/{sessionId}/disclaimers`). Requires an existing UKYC
+     * session; vendor T&Cs continue to come from {@link fetchDisclaimers}.
      *
      * @param params - The parameters.
      * @param params.sessionId - The UKYC session id.
      * @returns The catalog, including which documents are already consented.
      */
-    async fetchSessionDisclaimers({ sessionId, }) {
-        const url = new URL(`/sessions/${encodeURIComponent(sessionId)}/disclaimers`, __classPrivateFieldGet(this, _KycService_baseUrl, "f"));
+    async fetchSessionDisclaimers(params) {
+        const url = new URL(`/sessions/${encodeURIComponent(params.sessionId)}/disclaimers`, __classPrivateFieldGet(this, _KycService_baseUrl, "f"));
         const data = await this.fetchQuery({
-            queryKey: [`${this.name}:fetchSessionDisclaimers`, sessionId],
+            queryKey: [`${this.name}:fetchSessionDisclaimers`, params.sessionId],
             queryFn: async () => __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, { method: 'GET' }),
             // Consent state can change after a POST, so always re-fetch.
             staleTime: 0,
@@ -407,13 +399,24 @@ export class KycService extends BaseDataService {
      */
     async submitSessionDisclaimers(params) {
         const url = new URL(`/sessions/${encodeURIComponent(params.sessionId)}/disclaimers`, __classPrivateFieldGet(this, _KycService_baseUrl, "f"));
-        const data = await __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
-            method: 'POST',
-            body: JSON.stringify({
-                idOS: params.idOS,
-                kycProvider: params.kycProvider,
-                credentialReusabilityConsentGiven: params.credentialReusabilityConsentGiven,
+        const data = await this.fetchQuery({
+            queryKey: [
+                `${this.name}:submitSessionDisclaimers`,
+                params.sessionId,
+                params.idOS,
+                params.kycProvider,
+                params.credentialReusabilityConsentGiven,
+            ],
+            queryFn: async () => __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
+                method: 'POST',
+                body: JSON.stringify({
+                    idOS: params.idOS,
+                    kycProvider: params.kycProvider,
+                    credentialReusabilityConsentGiven: params.credentialReusabilityConsentGiven,
+                }),
             }),
+            staleTime: 0,
+            gcTime: 0,
         });
         return __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_validateResponse).call(this, data, SessionDisclaimersResponseStruct, 'session disclaimers');
     }
@@ -475,16 +478,22 @@ export class KycService extends BaseDataService {
      */
     async createUkycSession(params) {
         const url = new URL('/sessions', __classPrivateFieldGet(this, _KycService_baseUrl, "f"));
-        const data = await __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
-            method: 'POST',
-            body: JSON.stringify({
-                vendorId: params.vendor ?? 'moonpay',
-                vendorUserId: 'mockedId',
-                jwtToken: params.jwtToken,
-                sessionClientPublicKey: params.sessionClientPublicKey,
-                residenceCountry: params.residenceCountry,
-                vendorMetadata: params.vendorMetadata ?? {},
+        const data = await this.fetchQuery({
+            queryKey: [`${this.name}:createUkycSession`, params.jwtToken],
+            queryFn: async () => __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
+                method: 'POST',
+                body: JSON.stringify({
+                    vendorId: params.vendor ?? 'moonpay',
+                    vendorUserId: 'mockedId',
+                    jwtToken: params.jwtToken,
+                    sessionClientPublicKey: params.sessionClientPublicKey,
+                    residenceCountry: params.residenceCountry,
+                    vendorMetadata: params.vendorMetadata ?? {},
+                }),
             }),
+            // A session-creating mutation must never serve a stale/cached result.
+            staleTime: 0,
+            gcTime: 0,
         });
         return __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_validateResponse).call(this, data, UkycSessionResponseStruct, 'UKYC sessions');
     }
@@ -499,12 +508,17 @@ export class KycService extends BaseDataService {
      */
     async setAuthorizations(params) {
         const url = new URL(`/sessions/${encodeURIComponent(params.sessionId)}/authorizations`, __classPrivateFieldGet(this, _KycService_baseUrl, "f"));
-        const data = await __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
-            method: 'POST',
-            body: JSON.stringify({
-                wrappedEncryptionDataKey: params.wrappedEncryptionDataKey,
-                wrappedUkycCapabilityToken: params.wrappedUkycCapabilityToken,
+        const data = await this.fetchQuery({
+            queryKey: [`${this.name}:setAuthorizations`, params.sessionId],
+            queryFn: async () => __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, {
+                method: 'POST',
+                body: JSON.stringify({
+                    wrappedEncryptionDataKey: params.wrappedEncryptionDataKey,
+                    wrappedUkycCapabilityToken: params.wrappedUkycCapabilityToken,
+                }),
             }),
+            staleTime: 0,
+            gcTime: 0,
         });
         return __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_validateResponse).call(this, data, SessionStatusResponseStruct, 'authorizations');
     }
@@ -517,7 +531,13 @@ export class KycService extends BaseDataService {
      */
     async createJourney(sessionId) {
         const url = new URL(`/sessions/${encodeURIComponent(sessionId)}/journey`, __classPrivateFieldGet(this, _KycService_baseUrl, "f"));
-        const data = await __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, { method: 'POST' });
+        const data = await this.fetchQuery({
+            queryKey: [`${this.name}:createJourney`, sessionId],
+            queryFn: async () => __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_requestJson).call(this, url, { method: 'POST' }),
+            // Journeys are (re)created on demand; do not reuse a cached token.
+            staleTime: 0,
+            gcTime: 0,
+        });
         return __classPrivateFieldGet(this, _KycService_instances, "m", _KycService_validateResponse).call(this, data, ApplicantAccessTokenResponseStruct, 'journey');
     }
     /**
@@ -579,9 +599,8 @@ async function _KycService_fetchWellKnownJwks(baseUrl, queryName, responseLabel,
 /**
  * Performs a single JSON request.
  *
- * Read endpoints pass this as the `queryFn` to {@link fetchQuery}, which
- * wraps it in the shared service policy (retries, circuit breaker). Write
- * endpoints call it directly, so they are executed exactly once. Requests
+ * This is meant to be used as the `queryFn` for {@link fetchQuery}, which
+ * wraps it in the shared service policy (retries, circuit breaker). Requests
  * are authenticated with the wallet bearer token by default; pass
  * `{ authenticated: false }` for calls to services that do not expect it
  * (e.g. the idOS enclave or idOS relay JWKS endpoints).

package/dist/KycService.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"KycService.mjs","sourceRoot":"","sources":["../src/KycService.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseDataService } from '@metamask/base-data-service';\nimport type {\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  DataServiceInvalidateQueriesAction,\n} from '@metamask/base-data-service';\nimport type { CreateServicePolicyOptions } from '@metamask/controller-utils';\nimport { HttpError } from '@metamask/controller-utils';\nimport type { GeolocationControllerGetGeolocationAction } from '@metamask/geolocation-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type { AuthenticationControllerGetBearerTokenAction } from '@metamask/profile-sync-controller/auth';\nimport type { Infer, Struct } from '@metamask/superstruct';\nimport {\n  array,\n  assert,\n  boolean,\n  enums,\n  optional,\n  string,\n  StructError,\n  type,\n} from '@metamask/superstruct';\nimport type { Json } from '@metamask/utils';\nimport { Duration, inMilliseconds } from '@metamask/utils';\nimport type { QueryClientConfig } from '@tanstack/query-core';\n\nimport { alpha2ToAlpha3 } from './countryCodes.js';\nimport type { KycServiceMethodActions } from './KycService-method-action-types.js';\nimport type {\n  KycConsentRecord,\n  KycDisclaimer,\n  KycDisclaimersCatalog,\n  KycSessionDisclaimers,\n  KycSessionStatus,\n  KycUserStatusResponse,\n  KycVendor,\n  KycVendorSigning,\n} from './types.js';\nimport { UKYC_JWKS_PATH } from './ukyc/constants.js';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link KycService}, used to namespace the service's actions.\n */\nexport const serviceName = 'KycService';\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'getGeoCountry',\n  'fetchVendorDisclaimers',\n  'createSession',\n  'checkKycRequired',\n  'createVendorCustomer',\n  'submitVendorDisclaimers',\n  'fetchDisclaimersCatalog',\n  'fetchSessionDisclaimers',\n  'submitSessionDisclaimers',\n  'fetchKycStatus',\n  'fetchIdosEnclaveJwks',\n  'fetchIdosRelayJwks',\n  'createUkycSession',\n  'setAuthorizations',\n  'createJourney',\n  'getSessionStatus',\n] as const;\n\n/**\n * Invalidates cached queries serviced by {@link KycService}.\n */\nexport type KycServiceInvalidateQueriesAction =\n  DataServiceInvalidateQueriesAction<typeof serviceName>;\n\n/**\n * Actions that {@link KycService} exposes to other consumers.\n */\nexport type KycServiceActions =\n  | KycServiceMethodActions\n  | KycServiceInvalidateQueriesAction;\n\n/**\n * Actions from other messengers that {@link KycService} calls.\n */\ntype AllowedActions =\n  | AuthenticationControllerGetBearerTokenAction\n  | GeolocationControllerGetGeolocationAction;\n\n/**\n * Published when {@link KycService}'s cache is updated.\n */\nexport type KycServiceCacheUpdatedEvent = DataServiceCacheUpdatedEvent<\n  typeof serviceName\n>;\n\n/**\n * Published when a single key within {@link KycService}'s cache is updated.\n */\nexport type KycServiceGranularCacheUpdatedEvent =\n  DataServiceGranularCacheUpdatedEvent<typeof serviceName>;\n\n/**\n * Events that {@link KycService} exposes to other consumers.\n */\nexport type KycServiceEvents =\n  | KycServiceCacheUpdatedEvent\n  | KycServiceGranularCacheUpdatedEvent;\n\n/**\n * Events from other messengers that {@link KycService} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link KycService}.\n */\nexport type KycServiceMessenger = Messenger<\n  typeof serviceName,\n  KycServiceActions | AllowedActions,\n  KycServiceEvents | AllowedEvents\n>;\n\n/**\n * Options for constructing a {@link KycService}.\n */\nexport type KycServiceOptions = {\n  messenger: KycServiceMessenger;\n  /**\n   * A function used to make HTTP requests. Defaults to the runtime's native\n   * `fetch`, so consumers do not need to inject one on platforms where `fetch`\n   * is available globally (browser, React Native, Node 18+).\n   */\n  fetch?: typeof fetch;\n  /**\n   * Mandatory value that sets the base url to KYC api\n   */\n  baseUrl: string;\n  /**\n   * Base URL of the idOS enclave, from which the JWKS used to\n   * verify the `encryptionDataKey` schema's `jwtChain` is fetched.\n   */\n  idosEnclaveBaseUrl?: string;\n  /**\n   * Base URL of the idOS relay, from which the JWKS used to verify the\n   * `ukycCapabilityToken` schema's `jwtChain` is fetched.\n   */\n  idosRelayBaseUrl?: string;\n  /**\n   * Shared configuration applied to all queries exposed by the service (e.g. a\n   * default `staleTime`/`gcTime`). Each data service gets its own\n   * `QueryClient`.\n   */\n  queryClientConfig?: QueryClientConfig;\n  policyOptions?: CreateServicePolicyOptions;\n};\n\n// === API RESPONSE SCHEMAS ===\n\nconst DisclaimerStruct = type({\n  id: string(),\n  display_name: string(),\n  url: string(),\n});\nconst DisclaimersResponseStruct = array(DisclaimerStruct);\n\nconst VendorSigningStruct = type({\n  id: string(),\n  customer_id: string(),\n  content_id: optional(string()),\n});\nconst VendorSigningsResponseStruct = array(VendorSigningStruct);\n\nconst CreateSessionResponseStruct = type({ sessionToken: string() });\n\n// The live KYC API returns the flag under `required`; the service normalizes\n// this to `kycRequired` for consumers (see `checkKycRequired`).\nconst KycRequiredResponseStruct = type({ required: boolean() });\n\n// The session server's public key, in JWK-like form, returned inside an\n// encryption schema from `POST /sessions`. `x` is the base64url public key\n// used to wrap a secret for that schema.\nconst ServerPublicKeyStruct = type({\n  kty: string(),\n  crv: string(),\n  x: string(),\n  kid: optional(string()),\n  alg: optional(string()),\n  use: optional(string()),\n});\n\nconst EncryptionSchemaStruct = type({\n  serverPublicKey: ServerPublicKeyStruct,\n  jwtChain: string(),\n});\nexport type EncryptionSchema = Infer<typeof EncryptionSchemaStruct>;\n\n// A single Ed25519 (OKP) JWK. `type` (not `object`) keeps optional/extra JWK\n// fields (`use`, `alg`) from failing validation.\nconst JwkStruct = type({\n  kty: string(),\n  crv: string(),\n  x: string(),\n  kid: string(),\n});\nconst JwksResponseStruct = type({ keys: array(JwkStruct) });\nexport type JwksResponse = Infer<typeof JwksResponseStruct>;\n\nconst UkycSessionResponseStruct = type({\n  sessionId: string(),\n  // Per-secret wrapping material so the client can seal the\n  // `data_encryption_key` and the `ukyc_capability_token` independently.\n  encryptionDataKey: EncryptionSchemaStruct,\n  ukycCapabilityToken: EncryptionSchemaStruct,\n});\nexport type UkycSessionResponse = Infer<typeof UkycSessionResponseStruct>;\n\nconst ApplicantAccessTokenResponseStruct = type({\n  status: string(),\n  applicantAccessToken: string(),\n});\nexport type ApplicantAccessTokenResponse = Infer<\n  typeof ApplicantAccessTokenResponseStruct\n>;\n\nconst SessionStatusResponseStruct = type({\n  finalStatus: string(),\n  statusMessage: optional(string()),\n  externalUserId: string(),\n  kycStatus: string(),\n  vendor: string(),\n  vendorStatus: string(),\n});\n\n// Vendor customer subset — `type` (not `object`) keeps extra vendor fields from\n// failing validation while still requiring the fields the controller needs.\nconst VendorCustomerResponseStruct = type({\n  id: string(),\n  email: string(),\n  status: string(),\n});\nexport type VendorCustomerResponse = Infer<typeof VendorCustomerResponseStruct>;\n\nconst KYC_USER_STATUSES = [\n  'not-started',\n  'pending',\n  'need-more-information',\n  'terminal-failure',\n  'completed',\n] as const;\n\nconst KycUserStatusResponseStruct = type({\n  status: enums([...KYC_USER_STATUSES]),\n  sumsubSessionId: optional(string()),\n  errorCode: optional(string()),\n});\n\nconst CatalogDocumentFields = {\n  key: string(),\n  version: string(),\n  title: string(),\n  url: string(),\n} as const;\n\nconst CatalogDocumentStruct = type(CatalogDocumentFields);\n\n// Session documents also report whether that version was already consented to.\nconst ConsentDocumentStruct = type({\n  ...CatalogDocumentFields,\n  consented: boolean(),\n});\n\n/**\n * Global catalog from `GET /disclaimers` (no per-document `consented` flag and\n * no credential-reuse flag).\n */\nconst GlobalDisclaimersResponseStruct = type({\n  idOS: array(CatalogDocumentStruct),\n  kycProvider: array(CatalogDocumentStruct),\n});\n\n/** Session catalog from `GET`/`POST /sessions/{id}/disclaimers`. */\nconst SessionDisclaimersResponseStruct = type({\n  idOS: array(ConsentDocumentStruct),\n  kycProvider: array(ConsentDocumentStruct),\n  credentialReusabilityConsentGiven: boolean(),\n});\n\n// === PARAM TYPES ===\n\nexport type CreateSessionParams = {\n  email: string;\n  termsAcceptedAt: string;\n  disclaimerIds: string[];\n};\n\nexport type CheckKycRequiredParams = {\n  /**\n   * Identity vendor to check. Defaults to `moonpay` for the existing\n   * Check/Auth path.\n   */\n  vendor?: KycVendor;\n  /**\n   * MoonPay access token. Required when `vendor` is `moonpay` (or omitted).\n   */\n  accessToken?: string;\n  /**\n   * ISO 3166-1 alpha-3 country code. Required when `vendor` is `moonpay`.\n   */\n  country?: string;\n  capabilities?: { product: string }[];\n};\n\nexport type CreateVendorCustomerParams = {\n  vendor: KycVendor;\n  email: string;\n};\n\nexport type SubmitVendorDisclaimersParams = {\n  /** Identity vendor whose T&Cs were accepted (currently `iron`). */\n  vendor: KycVendor;\n  /** Disclaimer ids from {@link KycService.fetchVendorDisclaimers}. */\n  disclaimerIds: string[];\n};\n\nexport type FetchDisclaimersCatalogParams = {\n  /** ISO 3166-1 alpha-3 country code for `GET /disclaimers?country=`. */\n  country: string;\n};\n\nexport type FetchSessionDisclaimersParams = {\n  /** UKYC session id from {@link KycService.createUkycSession}. */\n  sessionId: string;\n};\n\nexport type SubmitSessionDisclaimersParams = {\n  /** UKYC session id from {@link KycService.createUkycSession}. */\n  sessionId: string;\n  /** Consents to the idOS legal documents (`key`/`version` from the catalog). */\n  idOS: KycConsentRecord[];\n  /**\n   * Consents to the KYC provider (SumSub) legal documents (`key`/`version`\n   * from the catalog).\n   */\n  kycProvider: KycConsentRecord[];\n  /** Consent to reuse the user's existing idOS credentials. */\n  credentialReusabilityConsentGiven: boolean;\n};\n\nexport type CreateUkycSessionParams = {\n  jwtToken: string;\n  /**\n   * The client's per-session X25519 public key (unpadded base64url). Generated\n   * with the matching private key used later to wrap authorizations, so the\n   * session server can open those boxes.\n   */\n  sessionClientPublicKey: string;\n  /**\n   * Country of residence in ISO 3166-1 alpha-3 format (e.g. `USA`, `GBR`).\n   */\n  residenceCountry: string;\n  /**\n   * Identity vendor for the UKYC session. Defaults to `moonpay` for the\n   * existing Check/Auth flow. Pass a non-MoonPay vendor (e.g. `iron`) for\n   * the consents path (no MoonPay metadata required).\n   */\n  vendor?: KycVendor;\n  /**\n   * Vendor-specific metadata. Required for MoonPay (`moonPayAccessToken` /\n   * `moonPayUserId`); optional / omitted for other vendors.\n   */\n  vendorMetadata?: Record<string, unknown>;\n};\n\n/**\n * Encrypted capability authorization payload (base64url nonce + ciphertext)\n * accepted by `POST /sessions/:sessionId/authorizations`. Produced by\n * `wrapEncryptionKey` for both the `data_encryption_key` and the\n * `ukyc_capability_token`.\n */\nexport type CapabilityAuthorization = {\n  nonce: string;\n  data: string;\n};\n\nexport type SetAuthorizationsParams = {\n  sessionId: string;\n  wrappedEncryptionDataKey: CapabilityAuthorization;\n  wrappedUkycCapabilityToken: CapabilityAuthorization;\n};\n\nexport type GetSessionStatusParams = {\n  sessionId: string;\n};\n\n// === SERVICE DEFINITION ===\n\n/**\n * `KycService` communicates with the Universal KYC (UKYC) backend to drive the\n * identity + document-verification flow. It is stateless and platform-agnostic:\n * HTTP is performed through the runtime's native `fetch` (or an injected\n * `fetch` when provided), and the auth bearer token and geolocation come from\n * other controllers via the messenger.\n *\n * It extends {@link BaseDataService}, so read-only endpoints are routed through\n * `fetchQuery`: they are wrapped in the shared service policy (retries, circuit\n * breaker) and their results are exposed via the service's `QueryClient`.\n * `fetchDisclaimers` and `fetchJwks` are cached with a `staleTime`;\n * session-scoped disclaimer and status-polling reads opt out of caching\n * (`staleTime`/`gcTime` of `0`) so they never serve a stale result.\n *\n * Write endpoints (every `POST`) deliberately bypass `fetchQuery`. The query\n * cache is built for idempotent reads: it deduplicates concurrent requests\n * sharing a `queryKey`, retains responses for replay, and publishes them on the\n * messenger via `cacheUpdated`. None of that is safe for calls that create\n * sessions, customers, or consents — two overlapping `createVendorCustomer`\n * calls would collapse into a single `POST`, and session tokens would be\n * broadcast as cache payloads. Writes therefore call `#requestJson` directly,\n * which also means they are not retried by the service policy.\n */\nexport class KycService extends BaseDataService<\n  typeof serviceName,\n  KycServiceMessenger\n> {\n  readonly #fetch: typeof fetch;\n\n  readonly #baseUrl: string;\n\n  readonly #idosEnclaveBaseUrl: string;\n\n  readonly #idosRelayBaseUrl: string;\n\n  /**\n   * Constructs a new KycService.\n   *\n   * @param options - The constructor options.\n   * @param options.messenger - The messenger suited for this service.\n   * @param options.fetch - A function used to make HTTP requests. Defaults to\n   * the runtime's native `fetch`.\n   * @param options.baseUrl - Base URL of the KYC API\n   * @param options.idosEnclaveBaseUrl - Base URL of the idOS enclave, from\n   * which the JWKS used to verify the `encryptionDataKey` schema's `jwtChain`\n   * is fetched.\n   * @param options.idosRelayBaseUrl - Base URL of the idOS relay, from which\n   * the JWKS used to verify the `ukycCapabilityToken` schema's `jwtChain` is\n   * fetched.\n   * @param options.queryClientConfig - Shared configuration for all queries\n   * exposed by the service.\n   * @param options.policyOptions - Options for the request service policy.\n   */\n  constructor({\n    messenger,\n    fetch: fetchFunction,\n    baseUrl,\n    idosEnclaveBaseUrl,\n    idosRelayBaseUrl,\n    queryClientConfig = {},\n    policyOptions = {},\n  }: KycServiceOptions) {\n    super({\n      name: serviceName,\n      messenger,\n      queryClientConfig,\n      policyOptions,\n    });\n    // Fall back to the runtime's native `fetch`, bound to `globalThis` so it\n    // can be invoked as a method of this instance without an illegal-invocation\n    // error on platforms that check the receiver.\n    if (fetchFunction) {\n      this.#fetch = fetchFunction;\n    } else if (typeof globalThis.fetch === 'function') {\n      this.#fetch = globalThis.fetch.bind(globalThis);\n    } else {\n      throw new Error(\n        'KycService: fetch is not available globally and was not provided in options. Please inject a fetch implementation.',\n      );\n    }\n    if (!baseUrl) {\n      throw new Error('KycService: baseUrl is required');\n    }\n    this.#baseUrl = baseUrl;\n    this.#idosEnclaveBaseUrl = idosEnclaveBaseUrl ?? '';\n    this.#idosRelayBaseUrl = idosRelayBaseUrl ?? '';\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Resolves the customer's country from the geolocation source and converts it\n   * to an ISO 3166-1 alpha-3 code.\n   *\n   * @returns The alpha-3 country code.\n   * @throws If the country cannot be determined or mapped.\n   */\n  async getGeoCountry(): Promise<string> {\n    const location = await this.messenger.call(\n      'GeolocationController:getGeolocation',\n    );\n    // Guard nullish/empty geolocation with the documented domain error rather\n    // than letting `assert(location, string())` surface a superstruct\n    // assertion error (which would change how the failure reads in\n    // `vendorError`).\n    const alpha2 =\n      typeof location === 'string' ? location.split('-')[0].toUpperCase() : '';\n    if (!alpha2 || alpha2 === 'UNKNOWN') {\n      throw new Error(\n        `Unable to determine country from geolocation (got \"${String(\n          location,\n        )}\").`,\n      );\n    }\n    const alpha3 = alpha2ToAlpha3(alpha2);\n    if (!alpha3) {\n      throw new Error(\n        `Unable to map country code \"${alpha2}\" to an ISO 3166-1 alpha-3 code.`,\n      );\n    }\n    return alpha3;\n  }\n\n  /**\n   * Fetches the disclaimers the customer must accept before a session is\n   * created.\n   *\n   * @param params - The parameters.\n   * @param params.vendor - Identity vendor. Defaults to `moonpay`.\n   * @param params.country - ISO 3166-1 alpha-3 country code.\n   * @returns The disclaimers.\n   */\n  async fetchVendorDisclaimers({\n    vendor = 'moonpay',\n    country,\n  }: {\n    vendor?: KycVendor;\n    country: string;\n  }): Promise<KycDisclaimer[]> {\n    const url = new URL(`/vendors/${vendor}/disclaimers`, this.#baseUrl);\n    url.searchParams.set('country', country);\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:fetchVendorDisclaimers`, vendor, country],\n      queryFn: async () => this.#requestJson(url, { method: 'GET' }),\n      staleTime: inMilliseconds(5, Duration.Minute),\n    });\n    return this.#validateResponse(\n      data,\n      DisclaimersResponseStruct,\n      'disclaimers',\n    ) as KycDisclaimer[];\n  }\n\n  /**\n   * Creates a vendor session via the UKYC backend.\n   *\n   * @param params - The session parameters.\n   * @returns The created session token.\n   */\n  async createSession(\n    params: CreateSessionParams,\n  ): Promise<Infer<typeof CreateSessionResponseStruct>> {\n    const url = new URL('/vendors/moonpay/sessions', this.#baseUrl);\n    const data = await this.#requestJson(url, {\n      method: 'POST',\n      body: JSON.stringify(params),\n    });\n    return this.#validateResponse(\n      data,\n      CreateSessionResponseStruct,\n      'sessions',\n    );\n  }\n\n  /**\n   * Checks whether KYC is required for the given vendor, country, and\n   * capabilities.\n   *\n   * @param params - The check parameters.\n   * @returns Whether KYC is required.\n   */\n  async checkKycRequired(\n    params: CheckKycRequiredParams,\n  ): Promise<{ kycRequired: boolean }> {\n    const vendor = params.vendor ?? 'moonpay';\n    const url = new URL(`/vendors/${vendor}/kyc-required`, this.#baseUrl);\n    const capabilities = params.capabilities ?? [{ product: 'ramps' }];\n    const body =\n      vendor === 'moonpay'\n        ? {\n            accessToken: params.accessToken,\n            country: params.country,\n            capabilities,\n          }\n        : {};\n\n    // MoonPay requires accessToken and country; validate before making the request.\n    if (vendor === 'moonpay') {\n      if (!params.accessToken) {\n        throw new Error(\n          'checkKycRequired: accessToken is required for vendor \"moonpay\".',\n        );\n      }\n      if (!params.country) {\n        throw new Error(\n          'checkKycRequired: country is required for vendor \"moonpay\".',\n        );\n      }\n    }\n\n    const data = await this.#requestJson(url, {\n      method: 'POST',\n      body: JSON.stringify(body),\n    });\n    const { required } = this.#validateResponse(\n      data,\n      KycRequiredResponseStruct,\n      'kyc-required',\n    );\n    return { kycRequired: required };\n  }\n\n  /**\n   * Creates (or resumes) an empty-shell customer for the authenticated\n   * canonical user on the given identity vendor. Must run before showing\n   * vendor T&C so the customer exists and resume logic can key off vendor\n   * status.\n   *\n   * @param params - The parameters.\n   * @param params.vendor - Identity vendor (e.g. `iron` for Money/VBA).\n   * @param params.email - Email associated with the customer.\n   * @returns The vendor customer record (subset validated for controller use).\n   */\n  async createVendorCustomer(\n    params: CreateVendorCustomerParams,\n  ): Promise<VendorCustomerResponse> {\n    const url = new URL(`/vendors/${params.vendor}/customers`, this.#baseUrl);\n    const data = await this.#requestJson(url, {\n      method: 'POST',\n      body: JSON.stringify({ email: params.email }),\n    });\n    return this.#validateResponse(\n      data,\n      VendorCustomerResponseStruct,\n      'vendor customers',\n    );\n  }\n\n  /**\n   * Records vendor T&C acceptance (`POST /vendors/{vendor}/disclaimers`).\n   * For Iron this creates content signings from the disclaimer ids the\n   * customer accepted. Session-scoped idOS / KYC-provider consents are\n   * recorded separately via {@link submitSessionDisclaimers}. Retries re-POST\n   * the same ids, matching the legacy `POST /consents` signing step.\n   *\n   * @param params - The parameters.\n   * @param params.vendor - Identity vendor (e.g. `iron`).\n   * @param params.disclaimerIds - Accepted vendor T&C ids.\n   * @returns The vendor signing records.\n   */\n  async submitVendorDisclaimers(\n    params: SubmitVendorDisclaimersParams,\n  ): Promise<KycVendorSigning[]> {\n    const url = new URL(\n      `/vendors/${encodeURIComponent(params.vendor)}/disclaimers`,\n      this.#baseUrl,\n    );\n    const data = await this.#requestJson(url, {\n      method: 'POST',\n      body: JSON.stringify({ disclaimerIds: params.disclaimerIds }),\n    });\n    return this.#validateResponse(\n      data,\n      VendorSigningsResponseStruct,\n      'vendor disclaimers',\n    );\n  }\n\n  /**\n   * Fetches the global idOS + KYC-provider disclaimer catalog\n   * (`GET /disclaimers?country=`). Carries no consent state — per-document\n   * `consented` flags and `credentialReusabilityConsentGiven` are\n   * session-scoped via {@link fetchSessionDisclaimers}. Vendor T&Cs continue to\n   * come from {@link fetchVendorDisclaimers}.\n   *\n   * @param params - The parameters.\n   * @param params.country - ISO 3166-1 alpha-3 country code.\n   * @returns The catalog documents.\n   */\n  async fetchDisclaimersCatalog({\n    country,\n  }: FetchDisclaimersCatalogParams): Promise<KycDisclaimersCatalog> {\n    if (country.length !== 3) {\n      throw new Error(\n        `KycService.fetchDisclaimersCatalog: country must be an ISO 3166-1 alpha-3 code (received \"${country}\").`,\n      );\n    }\n\n    const url = new URL('/disclaimers', this.#baseUrl);\n    url.searchParams.set('country', country);\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:fetchDisclaimersCatalog`, country],\n      queryFn: async () => this.#requestJson(url, { method: 'GET' }),\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      GlobalDisclaimersResponseStruct,\n      'disclaimers',\n    );\n  }\n\n  /**\n   * Fetches the session-scoped idOS + KYC-provider disclaimer catalog\n   * (`GET /sessions/{sessionId}/disclaimers`), including per-session\n   * `consented` flags and `credentialReusabilityConsentGiven`. For the\n   * pre-session global catalog use {@link fetchDisclaimersCatalog}. Vendor\n   * T&Cs continue to come from {@link fetchVendorDisclaimers}.\n   *\n   * @param params - The parameters.\n   * @param params.sessionId - The UKYC session id.\n   * @returns The catalog, including which documents are already consented.\n   */\n  async fetchSessionDisclaimers({\n    sessionId,\n  }: FetchSessionDisclaimersParams): Promise<KycSessionDisclaimers> {\n    const url = new URL(\n      `/sessions/${encodeURIComponent(sessionId)}/disclaimers`,\n      this.#baseUrl,\n    );\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:fetchSessionDisclaimers`, sessionId],\n      queryFn: async () => this.#requestJson(url, { method: 'GET' }),\n      // Consent state can change after a POST, so always re-fetch.\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      SessionDisclaimersResponseStruct,\n      'session disclaimers',\n    );\n  }\n\n  /**\n   * Records idOS + KYC-provider consents for a UKYC session\n   * (`POST /sessions/{sessionId}/disclaimers`). `key`/`version` pairs must\n   * match the current catalog from {@link fetchSessionDisclaimers}. A 409\n   * means those document versions were already recorded for the session.\n   *\n   * @param params - The consent parameters.\n   * @returns The updated catalog after recording.\n   */\n  async submitSessionDisclaimers(\n    params: SubmitSessionDisclaimersParams,\n  ): Promise<KycSessionDisclaimers> {\n    const url = new URL(\n      `/sessions/${encodeURIComponent(params.sessionId)}/disclaimers`,\n      this.#baseUrl,\n    );\n    const data = await this.#requestJson(url, {\n      method: 'POST',\n      body: JSON.stringify({\n        idOS: params.idOS,\n        kycProvider: params.kycProvider,\n        credentialReusabilityConsentGiven:\n          params.credentialReusabilityConsentGiven,\n      }),\n    });\n    return this.#validateResponse(\n      data,\n      SessionDisclaimersResponseStruct,\n      'session disclaimers',\n    );\n  }\n\n  /**\n   * Fetches the user-keyed simplified KYC status used by Money toast / banner\n   * surfaces (`GET /kyc/status`).\n   *\n   * @returns The simplified status payload.\n   */\n  async fetchKycStatus(): Promise<KycUserStatusResponse> {\n    const url = new URL('/kyc/status', this.#baseUrl);\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:fetchKycStatus`],\n      queryFn: async () => this.#requestJson(url, { method: 'GET' }),\n      // Status is polled for toast flips, so it must always be fresh.\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      KycUserStatusResponseStruct,\n      'kyc status',\n    );\n  }\n\n  /**\n   * Fetches a well-known JWKS from `baseUrl`, caching the result for an hour.\n   *\n   * @param baseUrl - Host base URL that serves `/.well-known/jwks.json`.\n   * @param queryName - Cache query-key segment.\n   * @param responseLabel - Label used in malformed-response errors.\n   * @param missingConfigMessage - Error thrown when `baseUrl` is empty.\n   * @returns The JWKS keys.\n   */\n  async #fetchWellKnownJwks(\n    baseUrl: string,\n    queryName: string,\n    responseLabel: string,\n    missingConfigMessage: string,\n  ): Promise<JwksResponse> {\n    if (!baseUrl) {\n      throw new Error(missingConfigMessage);\n    }\n    const url = new URL(UKYC_JWKS_PATH, baseUrl);\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:${queryName}`, baseUrl],\n      queryFn: async () =>\n        this.#requestJson(url, { method: 'GET' }, { authenticated: false }),\n      staleTime: inMilliseconds(1, Duration.Hour),\n    });\n    return this.#validateResponse(data, JwksResponseStruct, responseLabel);\n  }\n\n  /**\n   * Fetches the idOS enclave JWKS used to verify the\n   * `encryptionDataKey` schema's `jwtChain` from\n   * {@link KycService.createUkycSession}.\n   *\n   * This is an unauthenticated request to a well-known path on the idOS enclave\n   * host, distinct from the UKYC base URL.\n   *\n   * @returns The JWKS keys.\n   */\n  async fetchIdosEnclaveJwks(): Promise<JwksResponse> {\n    return this.#fetchWellKnownJwks(\n      this.#idosEnclaveBaseUrl,\n      'fetchIdosEnclaveJwks',\n      'idOS enclave JWKS',\n      'KycService: idosEnclaveBaseUrl is not configured; cannot fetch JWKS to verify the encryptionDataKey schema.',\n    );\n  }\n\n  /**\n   * Fetches the idOS relay JWKS used to verify the `ukycCapabilityToken`\n   * schema's `jwtChain` from {@link KycService.createUkycSession}.\n   *\n   * This is an unauthenticated request to a well-known path on the idOS relay\n   * host, distinct from both the UKYC base URL and the idOS enclave.\n   *\n   * @returns The JWKS keys.\n   */\n  async fetchIdosRelayJwks(): Promise<JwksResponse> {\n    return this.#fetchWellKnownJwks(\n      this.#idosRelayBaseUrl,\n      'fetchIdosRelayJwks',\n      'idOS relay JWKS',\n      'KycService: idosRelayBaseUrl is not configured; cannot fetch JWKS to verify the ukycCapabilityToken schema.',\n    );\n  }\n\n  /**\n   * Creates a UKYC session for the SumSub document-verification sub-flow.\n   *\n   * The client registers its per-session X25519 public key so the server can\n   * later open boxes sealed with the matching private key, and supplies the\n   * customer's ISO 3166-1 alpha-3 country of residence. The response\n   * carries per-secret encryption schemas (`encryptionDataKey` and\n   * `ukycCapabilityToken`) so the client can wrap the `data_encryption_key` and\n   * the read-only `ukyc_capability_token` and submit them via\n   * {@link KycService.setAuthorizations}.\n   *\n   * @param params - The session parameters.\n   * @returns The UKYC session id and encryption schemas.\n   */\n  async createUkycSession(\n    params: CreateUkycSessionParams,\n  ): Promise<UkycSessionResponse> {\n    const url = new URL('/sessions', this.#baseUrl);\n    const data = await this.#requestJson(url, {\n      method: 'POST',\n      body: JSON.stringify({\n        vendorId: params.vendor ?? 'moonpay',\n        vendorUserId: 'mockedId',\n        jwtToken: params.jwtToken,\n        sessionClientPublicKey: params.sessionClientPublicKey,\n        residenceCountry: params.residenceCountry,\n        vendorMetadata: params.vendorMetadata ?? {},\n      }),\n    });\n    return this.#validateResponse(\n      data,\n      UkycSessionResponseStruct,\n      'UKYC sessions',\n    );\n  }\n\n  /**\n   * Submits the wrapped `data_encryption_key` and wrapped\n   * `ukyc_capability_token` for a UKYC session. Both secrets are sealed with\n   * `wrapEncryptionKey` against the encryption schemas returned by\n   * {@link KycService.createUkycSession}.\n   *\n   * @param params - The wrapped authorizations.\n   * @returns The session status after the authorizations are applied.\n   */\n  async setAuthorizations(\n    params: SetAuthorizationsParams,\n  ): Promise<KycSessionStatus> {\n    const url = new URL(\n      `/sessions/${encodeURIComponent(params.sessionId)}/authorizations`,\n      this.#baseUrl,\n    );\n    const data = await this.#requestJson(url, {\n      method: 'POST',\n      body: JSON.stringify({\n        wrappedEncryptionDataKey: params.wrappedEncryptionDataKey,\n        wrappedUkycCapabilityToken: params.wrappedUkycCapabilityToken,\n      }),\n    });\n    return this.#validateResponse(\n      data,\n      SessionStatusResponseStruct,\n      'authorizations',\n    );\n  }\n\n  /**\n   * Creates (or refreshes) the SumSub verification journey for a UKYC session,\n   * returning the applicant access token used to launch the SDK.\n   *\n   * @param sessionId - The UKYC session id from `createUkycSession`.\n   * @returns The applicant access token and status.\n   */\n  async createJourney(\n    sessionId: string,\n  ): Promise<ApplicantAccessTokenResponse> {\n    const url = new URL(\n      `/sessions/${encodeURIComponent(sessionId)}/journey`,\n      this.#baseUrl,\n    );\n    const data = await this.#requestJson(url, { method: 'POST' });\n    return this.#validateResponse(\n      data,\n      ApplicantAccessTokenResponseStruct,\n      'journey',\n    );\n  }\n\n  /**\n   * Fetches the current status of a UKYC session. Polled after the SumSub SDK\n   * completes to determine the final verification decision.\n   *\n   * @param params - The parameters.\n   * @param params.sessionId - The UKYC session id.\n   * @returns The session status.\n   */\n  async getSessionStatus(\n    params: GetSessionStatusParams,\n  ): Promise<KycSessionStatus> {\n    const url = new URL(\n      `/sessions/${encodeURIComponent(params.sessionId)}/status`,\n      this.#baseUrl,\n    );\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:getSessionStatus`, params.sessionId],\n      queryFn: async () => this.#requestJson(url, { method: 'GET' }),\n      // Status is polled for a terminal decision, so it must always be fresh.\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      SessionStatusResponseStruct,\n      'session status',\n    );\n  }\n\n  /**\n   * Validates a parsed API response against a superstruct schema, throwing a\n   * descriptive error when the response does not match.\n   *\n   * Unlike a bare `Struct.is` check, this surfaces exactly which field was\n   * missing or had the wrong type, which is essential for diagnosing shape\n   * mismatches between the client and the live API.\n   *\n   * @param data - The parsed response body.\n   * @param struct - The superstruct schema the body is expected to satisfy.\n   * @param apiName - A human-readable name of the API, used in the error message.\n   * @returns The validated, typed response.\n   * @throws If `data` does not match `struct`.\n   */\n  #validateResponse<Type, Schema>(\n    data: unknown,\n    struct: Struct<Type, Schema>,\n    apiName: string,\n  ): Type {\n    try {\n      assert(data, struct);\n      return data;\n    } catch (error) {\n      const detail =\n        error instanceof StructError\n          ? `${error.message} (received: ${JSON.stringify(data)})`\n          : // `assert` only ever throws `StructError` for the plain structs used\n            // here, so this is a defensive fallback that is not exercised.\n            /* istanbul ignore next */\n            String(error);\n      throw new Error(\n        `Malformed response received from ${apiName} API: ${detail}`,\n      );\n    }\n  }\n\n  /**\n   * Performs a single JSON request.\n   *\n   * Read endpoints pass this as the `queryFn` to {@link fetchQuery}, which\n   * wraps it in the shared service policy (retries, circuit breaker). Write\n   * endpoints call it directly, so they are executed exactly once. Requests\n   * are authenticated with the wallet bearer token by default; pass\n   * `{ authenticated: false }` for calls to services that do not expect it\n   * (e.g. the idOS enclave or idOS relay JWKS endpoints).\n   *\n   * @param url - The request URL.\n   * @param init - The request init (method, body).\n   * @param options - Request options.\n   * @param options.authenticated - Whether to attach the bearer token. Defaults\n   * to `true`.\n   * @returns The parsed JSON response.\n   */\n  async #requestJson(\n    url: URL,\n    init: RequestInit,\n    options: { authenticated?: boolean } = {},\n  ): Promise<Json> {\n    const { authenticated = true } = options;\n\n    const headers: Record<string, string> = {};\n\n    // Only advertise a JSON body when one is actually sent; bodyless requests\n    // (e.g. `createJourney`) must not carry a `Content-Type`.\n    if (init.body !== undefined && init.body !== null) {\n      headers['Content-Type'] = 'application/json';\n    }\n\n    if (authenticated) {\n      const bearerToken = await this.messenger.call(\n        'AuthenticationController:getBearerToken',\n      );\n      if (!bearerToken) {\n        throw new Error(\n          'Unable to obtain an authentication bearer token — is the wallet signed in?',\n        );\n      }\n      assert(bearerToken, string());\n      headers.Authorization = `Bearer ${bearerToken}`;\n    }\n\n    const response = await this.#fetch(url.toString(), {\n      ...init,\n      headers,\n    });\n    if (!response.ok) {\n      let detail = '';\n      try {\n        const errorBody: unknown = await response.json();\n        if (errorBody && typeof errorBody === 'object') {\n          const record = errorBody as Record<string, unknown>;\n          if (typeof record.message === 'string') {\n            detail = record.message;\n          } else if (typeof record.error === 'string') {\n            detail = record.error;\n          }\n        }\n      } catch {\n        // Ignore body parse failures; status alone is still useful.\n      }\n      throw new HttpError(\n        response.status,\n        `Fetching '${url.toString()}' failed with status '${response.status}'${\n          detail ? `: ${detail}` : ''\n        }`,\n      );\n    }\n\n    // DELETE (and similar) endpoints return 204 No Content.\n    if (response.status === 204) {\n      return null;\n    }\n\n    return (await response.json()) as Json;\n  }\n}\n"]}
+{"version":3,"file":"KycService.mjs","sourceRoot":"","sources":["../src/KycService.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseDataService } from '@metamask/base-data-service';\nimport type {\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  DataServiceInvalidateQueriesAction,\n} from '@metamask/base-data-service';\nimport type { CreateServicePolicyOptions } from '@metamask/controller-utils';\nimport { HttpError } from '@metamask/controller-utils';\nimport type { GeolocationControllerGetGeolocationAction } from '@metamask/geolocation-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type { AuthenticationControllerGetBearerTokenAction } from '@metamask/profile-sync-controller/auth';\nimport type { Infer, Struct } from '@metamask/superstruct';\nimport {\n  array,\n  assert,\n  boolean,\n  enums,\n  optional,\n  string,\n  StructError,\n  type,\n} from '@metamask/superstruct';\nimport type { Json } from '@metamask/utils';\nimport { Duration, inMilliseconds } from '@metamask/utils';\nimport type { QueryClientConfig } from '@tanstack/query-core';\n\nimport { alpha2ToAlpha3 } from './countryCodes.js';\nimport type { KycServiceMethodActions } from './KycService-method-action-types.js';\nimport type {\n  KycConsentRecord,\n  KycDisclaimer,\n  KycSessionDisclaimers,\n  KycSessionStatus,\n  KycUserStatusResponse,\n  KycVendor,\n  KycVendorSigning,\n} from './types.js';\nimport { UKYC_JWKS_PATH } from './ukyc/constants.js';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link KycService}, used to namespace the service's actions.\n */\nexport const serviceName = 'KycService';\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'getGeoCountry',\n  'fetchDisclaimers',\n  'createSession',\n  'checkKycRequired',\n  'createVendorCustomer',\n  'submitVendorDisclaimers',\n  'fetchSessionDisclaimers',\n  'submitSessionDisclaimers',\n  'fetchKycStatus',\n  'fetchIdosEnclaveJwks',\n  'fetchIdosRelayJwks',\n  'createUkycSession',\n  'setAuthorizations',\n  'createJourney',\n  'getSessionStatus',\n] as const;\n\n/**\n * Invalidates cached queries serviced by {@link KycService}.\n */\nexport type KycServiceInvalidateQueriesAction =\n  DataServiceInvalidateQueriesAction<typeof serviceName>;\n\n/**\n * Actions that {@link KycService} exposes to other consumers.\n */\nexport type KycServiceActions =\n  | KycServiceMethodActions\n  | KycServiceInvalidateQueriesAction;\n\n/**\n * Actions from other messengers that {@link KycService} calls.\n */\ntype AllowedActions =\n  | AuthenticationControllerGetBearerTokenAction\n  | GeolocationControllerGetGeolocationAction;\n\n/**\n * Published when {@link KycService}'s cache is updated.\n */\nexport type KycServiceCacheUpdatedEvent = DataServiceCacheUpdatedEvent<\n  typeof serviceName\n>;\n\n/**\n * Published when a single key within {@link KycService}'s cache is updated.\n */\nexport type KycServiceGranularCacheUpdatedEvent =\n  DataServiceGranularCacheUpdatedEvent<typeof serviceName>;\n\n/**\n * Events that {@link KycService} exposes to other consumers.\n */\nexport type KycServiceEvents =\n  | KycServiceCacheUpdatedEvent\n  | KycServiceGranularCacheUpdatedEvent;\n\n/**\n * Events from other messengers that {@link KycService} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link KycService}.\n */\nexport type KycServiceMessenger = Messenger<\n  typeof serviceName,\n  KycServiceActions | AllowedActions,\n  KycServiceEvents | AllowedEvents\n>;\n\n/**\n * Options for constructing a {@link KycService}.\n */\nexport type KycServiceOptions = {\n  messenger: KycServiceMessenger;\n  /**\n   * A function used to make HTTP requests. Defaults to the runtime's native\n   * `fetch`, so consumers do not need to inject one on platforms where `fetch`\n   * is available globally (browser, React Native, Node 18+).\n   */\n  fetch?: typeof fetch;\n  /**\n   * Mandatory value that sets the base url to KYC api\n   */\n  baseUrl: string;\n  /**\n   * Base URL of the idOS enclave, from which the JWKS used to\n   * verify the `encryptionDataKey` schema's `jwtChain` is fetched.\n   */\n  idosEnclaveBaseUrl?: string;\n  /**\n   * Base URL of the idOS relay, from which the JWKS used to verify the\n   * `ukycCapabilityToken` schema's `jwtChain` is fetched.\n   */\n  idosRelayBaseUrl?: string;\n  /**\n   * Shared configuration applied to all queries exposed by the service (e.g. a\n   * default `staleTime`/`gcTime`). Each data service gets its own\n   * `QueryClient`.\n   */\n  queryClientConfig?: QueryClientConfig;\n  policyOptions?: CreateServicePolicyOptions;\n};\n\n// === API RESPONSE SCHEMAS ===\n\nconst DisclaimerStruct = type({\n  id: string(),\n  display_name: string(),\n  url: string(),\n});\nconst DisclaimersResponseStruct = array(DisclaimerStruct);\n\nconst VendorSigningStruct = type({\n  id: string(),\n  customer_id: string(),\n  content_id: optional(string()),\n});\nconst VendorSigningsResponseStruct = array(VendorSigningStruct);\n\nconst CreateSessionResponseStruct = type({ sessionToken: string() });\n\n// The live KYC API returns the flag under `required`; the service normalizes\n// this to `kycRequired` for consumers (see `checkKycRequired`).\nconst KycRequiredResponseStruct = type({ required: boolean() });\n\n// The session server's public key, in JWK-like form, returned inside an\n// encryption schema from `POST /sessions`. `x` is the base64url public key\n// used to wrap a secret for that schema.\nconst ServerPublicKeyStruct = type({\n  kty: string(),\n  crv: string(),\n  x: string(),\n  kid: optional(string()),\n  alg: optional(string()),\n  use: optional(string()),\n});\n\nconst EncryptionSchemaStruct = type({\n  serverPublicKey: ServerPublicKeyStruct,\n  jwtChain: string(),\n});\nexport type EncryptionSchema = Infer<typeof EncryptionSchemaStruct>;\n\n// A single Ed25519 (OKP) JWK. `type` (not `object`) keeps optional/extra JWK\n// fields (`use`, `alg`) from failing validation.\nconst JwkStruct = type({\n  kty: string(),\n  crv: string(),\n  x: string(),\n  kid: string(),\n});\nconst JwksResponseStruct = type({ keys: array(JwkStruct) });\nexport type JwksResponse = Infer<typeof JwksResponseStruct>;\n\nconst UkycSessionResponseStruct = type({\n  sessionId: string(),\n  // Per-secret wrapping material so the client can seal the\n  // `data_encryption_key` and the `ukyc_capability_token` independently.\n  encryptionDataKey: EncryptionSchemaStruct,\n  ukycCapabilityToken: EncryptionSchemaStruct,\n});\nexport type UkycSessionResponse = Infer<typeof UkycSessionResponseStruct>;\n\nconst ApplicantAccessTokenResponseStruct = type({\n  status: string(),\n  applicantAccessToken: string(),\n});\nexport type ApplicantAccessTokenResponse = Infer<\n  typeof ApplicantAccessTokenResponseStruct\n>;\n\nconst SessionStatusResponseStruct = type({\n  finalStatus: string(),\n  statusMessage: optional(string()),\n  externalUserId: string(),\n  kycStatus: string(),\n  vendor: string(),\n  vendorStatus: string(),\n});\n\n// Vendor customer subset — `type` (not `object`) keeps extra vendor fields from\n// failing validation while still requiring the fields the controller needs.\nconst VendorCustomerResponseStruct = type({\n  id: string(),\n  email: string(),\n  status: string(),\n});\nexport type VendorCustomerResponse = Infer<typeof VendorCustomerResponseStruct>;\n\nconst KYC_USER_STATUSES = [\n  'not-started',\n  'pending',\n  'need-more-information',\n  'terminal-failure',\n  'completed',\n] as const;\n\nconst KycUserStatusResponseStruct = type({\n  status: enums([...KYC_USER_STATUSES]),\n  sumsubSessionId: optional(string()),\n  errorCode: optional(string()),\n});\n\nconst ConsentDocumentStruct = type({\n  key: string(),\n  version: string(),\n  title: string(),\n  url: string(),\n  consented: boolean(),\n});\n\nconst SessionDisclaimersResponseStruct = type({\n  idOS: array(ConsentDocumentStruct),\n  kycProvider: array(ConsentDocumentStruct),\n  credentialReusabilityConsentGiven: boolean(),\n});\n\n// === PARAM TYPES ===\n\nexport type CreateSessionParams = {\n  email: string;\n  termsAcceptedAt: string;\n  disclaimerIds: string[];\n};\n\nexport type CheckKycRequiredParams = {\n  /**\n   * Identity vendor to check. Defaults to `moonpay` for the existing\n   * Check/Auth path.\n   */\n  vendor?: KycVendor;\n  /**\n   * MoonPay access token. Required when `vendor` is `moonpay` (or omitted).\n   */\n  accessToken?: string;\n  /**\n   * ISO 3166-1 alpha-3 country code. Required when `vendor` is `moonpay`.\n   */\n  country?: string;\n  capabilities?: { product: string }[];\n};\n\nexport type CreateVendorCustomerParams = {\n  vendor: KycVendor;\n  email: string;\n};\n\nexport type SubmitVendorDisclaimersParams = {\n  /** Identity vendor whose T&Cs were accepted (currently `iron`). */\n  vendor: KycVendor;\n  /** Disclaimer ids from {@link KycService.fetchDisclaimers}. */\n  disclaimerIds: string[];\n};\n\nexport type FetchSessionDisclaimersParams = {\n  /** UKYC session id from {@link KycService.createUkycSession}. */\n  sessionId: string;\n};\n\nexport type SubmitSessionDisclaimersParams = {\n  /** UKYC session id from {@link KycService.createUkycSession}. */\n  sessionId: string;\n  /** Consents to the idOS legal documents (`key`/`version` from the catalog). */\n  idOS: KycConsentRecord[];\n  /**\n   * Consents to the KYC provider (SumSub) legal documents (`key`/`version`\n   * from the catalog).\n   */\n  kycProvider: KycConsentRecord[];\n  /** Consent to reuse the user's existing idOS credentials. */\n  credentialReusabilityConsentGiven: boolean;\n};\n\nexport type CreateUkycSessionParams = {\n  jwtToken: string;\n  /**\n   * The client's per-session X25519 public key (unpadded base64url). Generated\n   * with the matching private key used later to wrap authorizations, so the\n   * session server can open those boxes.\n   */\n  sessionClientPublicKey: string;\n  /**\n   * Country of residence in ISO 3166-1 alpha-3 format (e.g. `USA`, `GBR`).\n   */\n  residenceCountry: string;\n  /**\n   * Identity vendor for the UKYC session. Defaults to `moonpay` for the\n   * existing Check/Auth flow. Pass a non-MoonPay vendor (e.g. `iron`) for\n   * the consents path (no MoonPay metadata required).\n   */\n  vendor?: KycVendor;\n  /**\n   * Vendor-specific metadata. Required for MoonPay (`moonPayAccessToken` /\n   * `moonPayUserId`); optional / omitted for other vendors.\n   */\n  vendorMetadata?: Record<string, unknown>;\n};\n\n/**\n * Encrypted capability authorization payload (base64url nonce + ciphertext)\n * accepted by `POST /sessions/:sessionId/authorizations`. Produced by\n * `wrapEncryptionKey` for both the `data_encryption_key` and the\n * `ukyc_capability_token`.\n */\nexport type CapabilityAuthorization = {\n  nonce: string;\n  data: string;\n};\n\nexport type SetAuthorizationsParams = {\n  sessionId: string;\n  wrappedEncryptionDataKey: CapabilityAuthorization;\n  wrappedUkycCapabilityToken: CapabilityAuthorization;\n};\n\nexport type GetSessionStatusParams = {\n  sessionId: string;\n};\n\n// === SERVICE DEFINITION ===\n\n/**\n * `KycService` communicates with the Universal KYC (UKYC) backend to drive the\n * identity + document-verification flow. It is stateless and platform-agnostic:\n * HTTP is performed through the runtime's native `fetch` (or an injected\n * `fetch` when provided), and the auth bearer token and geolocation come from\n * other controllers via the messenger.\n *\n * It extends {@link BaseDataService}, so every request is routed through\n * `fetchQuery`: it is wrapped in the shared service policy (retries, circuit\n * breaker) and its result is exposed via the service's `QueryClient`. Read-only\n * endpoints (`fetchDisclaimers`, `fetchIdosEnclaveJwks`, `fetchIdosRelayJwks`) are cached\n * with a `staleTime`; vendor-disclaimer, session-scoped disclaimer,\n * session-creating, and status-polling endpoints opt out of caching\n * (`staleTime`/`gcTime` of `0`) so they never serve a stale result.\n */\nexport class KycService extends BaseDataService<\n  typeof serviceName,\n  KycServiceMessenger\n> {\n  readonly #fetch: typeof fetch;\n\n  readonly #baseUrl: string;\n\n  readonly #idosEnclaveBaseUrl: string;\n\n  readonly #idosRelayBaseUrl: string;\n\n  /**\n   * Constructs a new KycService.\n   *\n   * @param options - The constructor options.\n   * @param options.messenger - The messenger suited for this service.\n   * @param options.fetch - A function used to make HTTP requests. Defaults to\n   * the runtime's native `fetch`.\n   * @param options.baseUrl - Base URL of the KYC API\n   * @param options.idosEnclaveBaseUrl - Base URL of the idOS enclave, from\n   * which the JWKS used to verify the `encryptionDataKey` schema's `jwtChain`\n   * is fetched.\n   * @param options.idosRelayBaseUrl - Base URL of the idOS relay, from which\n   * the JWKS used to verify the `ukycCapabilityToken` schema's `jwtChain` is\n   * fetched.\n   * @param options.queryClientConfig - Shared configuration for all queries\n   * exposed by the service.\n   * @param options.policyOptions - Options for the request service policy.\n   */\n  constructor({\n    messenger,\n    fetch: fetchFunction,\n    baseUrl,\n    idosEnclaveBaseUrl,\n    idosRelayBaseUrl,\n    queryClientConfig = {},\n    policyOptions = {},\n  }: KycServiceOptions) {\n    super({\n      name: serviceName,\n      messenger,\n      queryClientConfig,\n      policyOptions,\n    });\n    // Fall back to the runtime's native `fetch`, bound to `globalThis` so it\n    // can be invoked as a method of this instance without an illegal-invocation\n    // error on platforms that check the receiver.\n    if (fetchFunction) {\n      this.#fetch = fetchFunction;\n    } else if (typeof globalThis.fetch === 'function') {\n      this.#fetch = globalThis.fetch.bind(globalThis);\n    } else {\n      throw new Error(\n        'KycService: fetch is not available globally and was not provided in options. Please inject a fetch implementation.',\n      );\n    }\n    if (!baseUrl) {\n      throw new Error('KycService: baseUrl is required');\n    }\n    this.#baseUrl = baseUrl;\n    this.#idosEnclaveBaseUrl = idosEnclaveBaseUrl ?? '';\n    this.#idosRelayBaseUrl = idosRelayBaseUrl ?? '';\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Resolves the customer's country from the geolocation source and converts it\n   * to an ISO 3166-1 alpha-3 code.\n   *\n   * @returns The alpha-3 country code.\n   * @throws If the country cannot be determined or mapped.\n   */\n  async getGeoCountry(): Promise<string> {\n    const location = await this.messenger.call(\n      'GeolocationController:getGeolocation',\n    );\n    // Guard nullish/empty geolocation with the documented domain error rather\n    // than letting `assert(location, string())` surface a superstruct\n    // assertion error (which would change how the failure reads in\n    // `disclaimersError`).\n    const alpha2 =\n      typeof location === 'string' ? location.split('-')[0].toUpperCase() : '';\n    if (!alpha2 || alpha2 === 'UNKNOWN') {\n      throw new Error(\n        `Unable to determine country from geolocation (got \"${String(\n          location,\n        )}\").`,\n      );\n    }\n    const alpha3 = alpha2ToAlpha3(alpha2);\n    if (!alpha3) {\n      throw new Error(\n        `Unable to map country code \"${alpha2}\" to an ISO 3166-1 alpha-3 code.`,\n      );\n    }\n    return alpha3;\n  }\n\n  /**\n   * Fetches the disclaimers the customer must accept before a session is\n   * created.\n   *\n   * @param params - The parameters.\n   * @param params.vendor - Identity vendor. Defaults to `moonpay`.\n   * @param params.country - ISO 3166-1 alpha-3 country code.\n   * @returns The disclaimers.\n   */\n  async fetchDisclaimers({\n    vendor = 'moonpay',\n    country,\n  }: {\n    vendor?: KycVendor;\n    country: string;\n  }): Promise<KycDisclaimer[]> {\n    const url = new URL(`/vendors/${vendor}/disclaimers`, this.#baseUrl);\n    url.searchParams.set('country', country);\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:fetchDisclaimers`, vendor, country],\n      queryFn: async () => this.#requestJson(url, { method: 'GET' }),\n      staleTime: inMilliseconds(5, Duration.Minute),\n    });\n    return this.#validateResponse(\n      data,\n      DisclaimersResponseStruct,\n      'disclaimers',\n    ) as KycDisclaimer[];\n  }\n\n  /**\n   * Creates a vendor session via the UKYC backend.\n   *\n   * @param params - The session parameters.\n   * @returns The created session token.\n   */\n  async createSession(\n    params: CreateSessionParams,\n  ): Promise<Infer<typeof CreateSessionResponseStruct>> {\n    const url = new URL('/vendors/moonpay/sessions', this.#baseUrl);\n    const data = await this.fetchQuery({\n      queryKey: [\n        `${this.name}:createSession`,\n        params.email,\n        params.termsAcceptedAt,\n        params.disclaimerIds,\n      ],\n      queryFn: async () =>\n        this.#requestJson(url, {\n          method: 'POST',\n          body: JSON.stringify(params),\n        }),\n      // A session-creating mutation must never serve a stale/cached result.\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      CreateSessionResponseStruct,\n      'sessions',\n    );\n  }\n\n  /**\n   * Checks whether KYC is required for the given vendor, country, and\n   * capabilities.\n   *\n   * @param params - The check parameters.\n   * @returns Whether KYC is required.\n   */\n  async checkKycRequired(\n    params: CheckKycRequiredParams,\n  ): Promise<{ kycRequired: boolean }> {\n    const vendor = params.vendor ?? 'moonpay';\n    const url = new URL(`/vendors/${vendor}/kyc-required`, this.#baseUrl);\n    const capabilities = params.capabilities ?? [{ product: 'ramps' }];\n    const body =\n      vendor === 'moonpay'\n        ? {\n            accessToken: params.accessToken,\n            country: params.country,\n            capabilities,\n          }\n        : {};\n\n    // MoonPay requires accessToken and country; validate before making the request.\n    if (vendor === 'moonpay') {\n      if (!params.accessToken) {\n        throw new Error(\n          'checkKycRequired: accessToken is required for vendor \"moonpay\".',\n        );\n      }\n      if (!params.country) {\n        throw new Error(\n          'checkKycRequired: country is required for vendor \"moonpay\".',\n        );\n      }\n    }\n\n    const data = await this.fetchQuery({\n      queryKey: [\n        `${this.name}:checkKycRequired`,\n        vendor,\n        params.accessToken ?? null,\n        params.country ?? null,\n        capabilities,\n      ],\n      queryFn: async () =>\n        this.#requestJson(url, {\n          method: 'POST',\n          body: JSON.stringify(body),\n        }),\n      // The requirement can change server-side, so always re-check.\n      staleTime: 0,\n      gcTime: 0,\n    });\n    const { required } = this.#validateResponse(\n      data,\n      KycRequiredResponseStruct,\n      'kyc-required',\n    );\n    return { kycRequired: required };\n  }\n\n  /**\n   * Creates (or resumes) an empty-shell customer for the authenticated\n   * canonical user on the given identity vendor. Must run before showing\n   * vendor T&C so the customer exists and resume logic can key off vendor\n   * status.\n   *\n   * @param params - The parameters.\n   * @param params.vendor - Identity vendor (e.g. `iron` for Money/VBA).\n   * @param params.email - Email associated with the customer.\n   * @returns The vendor customer record (subset validated for controller use).\n   */\n  async createVendorCustomer(\n    params: CreateVendorCustomerParams,\n  ): Promise<VendorCustomerResponse> {\n    const url = new URL(`/vendors/${params.vendor}/customers`, this.#baseUrl);\n    const data = await this.fetchQuery({\n      queryKey: [\n        `${this.name}:createVendorCustomer`,\n        params.vendor,\n        params.email,\n      ],\n      queryFn: async () =>\n        this.#requestJson(url, {\n          method: 'POST',\n          body: JSON.stringify({ email: params.email }),\n        }),\n      // Customer creation/resume must never serve a stale/cached result.\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      VendorCustomerResponseStruct,\n      'vendor customers',\n    );\n  }\n\n  /**\n   * Records vendor T&C acceptance (`POST /vendors/{vendor}/disclaimers`).\n   * For Iron this creates content signings from the disclaimer ids the\n   * customer accepted. Session-scoped idOS / KYC-provider consents are\n   * recorded separately via {@link submitSessionDisclaimers}. Retries re-POST\n   * the same ids, matching the legacy `POST /consents` signing step.\n   *\n   * @param params - The parameters.\n   * @param params.vendor - Identity vendor (e.g. `iron`).\n   * @param params.disclaimerIds - Accepted vendor T&C ids.\n   * @returns The vendor signing records.\n   */\n  async submitVendorDisclaimers(\n    params: SubmitVendorDisclaimersParams,\n  ): Promise<KycVendorSigning[]> {\n    const url = new URL(\n      `/vendors/${encodeURIComponent(params.vendor)}/disclaimers`,\n      this.#baseUrl,\n    );\n    const data = await this.fetchQuery({\n      queryKey: [\n        `${this.name}:submitVendorDisclaimers`,\n        params.vendor,\n        params.disclaimerIds,\n      ],\n      queryFn: async () =>\n        this.#requestJson(url, {\n          method: 'POST',\n          body: JSON.stringify({ disclaimerIds: params.disclaimerIds }),\n        }),\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      VendorSigningsResponseStruct,\n      'vendor disclaimers',\n    );\n  }\n\n  /**\n   * Fetches the session-scoped idOS + KYC-provider disclaimer catalog\n   * (`GET /sessions/{sessionId}/disclaimers`). Requires an existing UKYC\n   * session; vendor T&Cs continue to come from {@link fetchDisclaimers}.\n   *\n   * @param params - The parameters.\n   * @param params.sessionId - The UKYC session id.\n   * @returns The catalog, including which documents are already consented.\n   */\n  async fetchSessionDisclaimers(\n    params: FetchSessionDisclaimersParams,\n  ): Promise<KycSessionDisclaimers> {\n    const url = new URL(\n      `/sessions/${encodeURIComponent(params.sessionId)}/disclaimers`,\n      this.#baseUrl,\n    );\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:fetchSessionDisclaimers`, params.sessionId],\n      queryFn: async () => this.#requestJson(url, { method: 'GET' }),\n      // Consent state can change after a POST, so always re-fetch.\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      SessionDisclaimersResponseStruct,\n      'session disclaimers',\n    );\n  }\n\n  /**\n   * Records idOS + KYC-provider consents for a UKYC session\n   * (`POST /sessions/{sessionId}/disclaimers`). `key`/`version` pairs must\n   * match the current catalog from {@link fetchSessionDisclaimers}. A 409\n   * means those document versions were already recorded for the session.\n   *\n   * @param params - The consent parameters.\n   * @returns The updated catalog after recording.\n   */\n  async submitSessionDisclaimers(\n    params: SubmitSessionDisclaimersParams,\n  ): Promise<KycSessionDisclaimers> {\n    const url = new URL(\n      `/sessions/${encodeURIComponent(params.sessionId)}/disclaimers`,\n      this.#baseUrl,\n    );\n    const data = await this.fetchQuery({\n      queryKey: [\n        `${this.name}:submitSessionDisclaimers`,\n        params.sessionId,\n        params.idOS,\n        params.kycProvider,\n        params.credentialReusabilityConsentGiven,\n      ],\n      queryFn: async () =>\n        this.#requestJson(url, {\n          method: 'POST',\n          body: JSON.stringify({\n            idOS: params.idOS,\n            kycProvider: params.kycProvider,\n            credentialReusabilityConsentGiven:\n              params.credentialReusabilityConsentGiven,\n          }),\n        }),\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      SessionDisclaimersResponseStruct,\n      'session disclaimers',\n    );\n  }\n\n  /**\n   * Fetches the user-keyed simplified KYC status used by Money toast / banner\n   * surfaces (`GET /kyc/status`).\n   *\n   * @returns The simplified status payload.\n   */\n  async fetchKycStatus(): Promise<KycUserStatusResponse> {\n    const url = new URL('/kyc/status', this.#baseUrl);\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:fetchKycStatus`],\n      queryFn: async () => this.#requestJson(url, { method: 'GET' }),\n      // Status is polled for toast flips, so it must always be fresh.\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      KycUserStatusResponseStruct,\n      'kyc status',\n    );\n  }\n\n  /**\n   * Fetches a well-known JWKS from `baseUrl`, caching the result for an hour.\n   *\n   * @param baseUrl - Host base URL that serves `/.well-known/jwks.json`.\n   * @param queryName - Cache query-key segment.\n   * @param responseLabel - Label used in malformed-response errors.\n   * @param missingConfigMessage - Error thrown when `baseUrl` is empty.\n   * @returns The JWKS keys.\n   */\n  async #fetchWellKnownJwks(\n    baseUrl: string,\n    queryName: string,\n    responseLabel: string,\n    missingConfigMessage: string,\n  ): Promise<JwksResponse> {\n    if (!baseUrl) {\n      throw new Error(missingConfigMessage);\n    }\n    const url = new URL(UKYC_JWKS_PATH, baseUrl);\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:${queryName}`, baseUrl],\n      queryFn: async () =>\n        this.#requestJson(url, { method: 'GET' }, { authenticated: false }),\n      staleTime: inMilliseconds(1, Duration.Hour),\n    });\n    return this.#validateResponse(data, JwksResponseStruct, responseLabel);\n  }\n\n  /**\n   * Fetches the idOS enclave JWKS used to verify the\n   * `encryptionDataKey` schema's `jwtChain` from\n   * {@link KycService.createUkycSession}.\n   *\n   * This is an unauthenticated request to a well-known path on the idOS enclave\n   * host, distinct from the UKYC base URL.\n   *\n   * @returns The JWKS keys.\n   */\n  async fetchIdosEnclaveJwks(): Promise<JwksResponse> {\n    return this.#fetchWellKnownJwks(\n      this.#idosEnclaveBaseUrl,\n      'fetchIdosEnclaveJwks',\n      'idOS enclave JWKS',\n      'KycService: idosEnclaveBaseUrl is not configured; cannot fetch JWKS to verify the encryptionDataKey schema.',\n    );\n  }\n\n  /**\n   * Fetches the idOS relay JWKS used to verify the `ukycCapabilityToken`\n   * schema's `jwtChain` from {@link KycService.createUkycSession}.\n   *\n   * This is an unauthenticated request to a well-known path on the idOS relay\n   * host, distinct from both the UKYC base URL and the idOS enclave.\n   *\n   * @returns The JWKS keys.\n   */\n  async fetchIdosRelayJwks(): Promise<JwksResponse> {\n    return this.#fetchWellKnownJwks(\n      this.#idosRelayBaseUrl,\n      'fetchIdosRelayJwks',\n      'idOS relay JWKS',\n      'KycService: idosRelayBaseUrl is not configured; cannot fetch JWKS to verify the ukycCapabilityToken schema.',\n    );\n  }\n\n  /**\n   * Creates a UKYC session for the SumSub document-verification sub-flow.\n   *\n   * The client registers its per-session X25519 public key so the server can\n   * later open boxes sealed with the matching private key, and supplies the\n   * customer's ISO 3166-1 alpha-3 country of residence. The response\n   * carries per-secret encryption schemas (`encryptionDataKey` and\n   * `ukycCapabilityToken`) so the client can wrap the `data_encryption_key` and\n   * the read-only `ukyc_capability_token` and submit them via\n   * {@link KycService.setAuthorizations}.\n   *\n   * @param params - The session parameters.\n   * @returns The UKYC session id and encryption schemas.\n   */\n  async createUkycSession(\n    params: CreateUkycSessionParams,\n  ): Promise<UkycSessionResponse> {\n    const url = new URL('/sessions', this.#baseUrl);\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:createUkycSession`, params.jwtToken],\n      queryFn: async () =>\n        this.#requestJson(url, {\n          method: 'POST',\n          body: JSON.stringify({\n            vendorId: params.vendor ?? 'moonpay',\n            vendorUserId: 'mockedId',\n            jwtToken: params.jwtToken,\n            sessionClientPublicKey: params.sessionClientPublicKey,\n            residenceCountry: params.residenceCountry,\n            vendorMetadata: params.vendorMetadata ?? {},\n          }),\n        }),\n      // A session-creating mutation must never serve a stale/cached result.\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      UkycSessionResponseStruct,\n      'UKYC sessions',\n    );\n  }\n\n  /**\n   * Submits the wrapped `data_encryption_key` and wrapped\n   * `ukyc_capability_token` for a UKYC session. Both secrets are sealed with\n   * `wrapEncryptionKey` against the encryption schemas returned by\n   * {@link KycService.createUkycSession}.\n   *\n   * @param params - The wrapped authorizations.\n   * @returns The session status after the authorizations are applied.\n   */\n  async setAuthorizations(\n    params: SetAuthorizationsParams,\n  ): Promise<KycSessionStatus> {\n    const url = new URL(\n      `/sessions/${encodeURIComponent(params.sessionId)}/authorizations`,\n      this.#baseUrl,\n    );\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:setAuthorizations`, params.sessionId],\n      queryFn: async () =>\n        this.#requestJson(url, {\n          method: 'POST',\n          body: JSON.stringify({\n            wrappedEncryptionDataKey: params.wrappedEncryptionDataKey,\n            wrappedUkycCapabilityToken: params.wrappedUkycCapabilityToken,\n          }),\n        }),\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      SessionStatusResponseStruct,\n      'authorizations',\n    );\n  }\n\n  /**\n   * Creates (or refreshes) the SumSub verification journey for a UKYC session,\n   * returning the applicant access token used to launch the SDK.\n   *\n   * @param sessionId - The UKYC session id from `createUkycSession`.\n   * @returns The applicant access token and status.\n   */\n  async createJourney(\n    sessionId: string,\n  ): Promise<ApplicantAccessTokenResponse> {\n    const url = new URL(\n      `/sessions/${encodeURIComponent(sessionId)}/journey`,\n      this.#baseUrl,\n    );\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:createJourney`, sessionId],\n      queryFn: async () => this.#requestJson(url, { method: 'POST' }),\n      // Journeys are (re)created on demand; do not reuse a cached token.\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      ApplicantAccessTokenResponseStruct,\n      'journey',\n    );\n  }\n\n  /**\n   * Fetches the current status of a UKYC session. Polled after the SumSub SDK\n   * completes to determine the final verification decision.\n   *\n   * @param params - The parameters.\n   * @param params.sessionId - The UKYC session id.\n   * @returns The session status.\n   */\n  async getSessionStatus(\n    params: GetSessionStatusParams,\n  ): Promise<KycSessionStatus> {\n    const url = new URL(\n      `/sessions/${encodeURIComponent(params.sessionId)}/status`,\n      this.#baseUrl,\n    );\n    const data = await this.fetchQuery({\n      queryKey: [`${this.name}:getSessionStatus`, params.sessionId],\n      queryFn: async () => this.#requestJson(url, { method: 'GET' }),\n      // Status is polled for a terminal decision, so it must always be fresh.\n      staleTime: 0,\n      gcTime: 0,\n    });\n    return this.#validateResponse(\n      data,\n      SessionStatusResponseStruct,\n      'session status',\n    );\n  }\n\n  /**\n   * Validates a parsed API response against a superstruct schema, throwing a\n   * descriptive error when the response does not match.\n   *\n   * Unlike a bare `Struct.is` check, this surfaces exactly which field was\n   * missing or had the wrong type, which is essential for diagnosing shape\n   * mismatches between the client and the live API.\n   *\n   * @param data - The parsed response body.\n   * @param struct - The superstruct schema the body is expected to satisfy.\n   * @param apiName - A human-readable name of the API, used in the error message.\n   * @returns The validated, typed response.\n   * @throws If `data` does not match `struct`.\n   */\n  #validateResponse<Type, Schema>(\n    data: unknown,\n    struct: Struct<Type, Schema>,\n    apiName: string,\n  ): Type {\n    try {\n      assert(data, struct);\n      return data;\n    } catch (error) {\n      const detail =\n        error instanceof StructError\n          ? `${error.message} (received: ${JSON.stringify(data)})`\n          : // `assert` only ever throws `StructError` for the plain structs used\n            // here, so this is a defensive fallback that is not exercised.\n            /* istanbul ignore next */\n            String(error);\n      throw new Error(\n        `Malformed response received from ${apiName} API: ${detail}`,\n      );\n    }\n  }\n\n  /**\n   * Performs a single JSON request.\n   *\n   * This is meant to be used as the `queryFn` for {@link fetchQuery}, which\n   * wraps it in the shared service policy (retries, circuit breaker). Requests\n   * are authenticated with the wallet bearer token by default; pass\n   * `{ authenticated: false }` for calls to services that do not expect it\n   * (e.g. the idOS enclave or idOS relay JWKS endpoints).\n   *\n   * @param url - The request URL.\n   * @param init - The request init (method, body).\n   * @param options - Request options.\n   * @param options.authenticated - Whether to attach the bearer token. Defaults\n   * to `true`.\n   * @returns The parsed JSON response.\n   */\n  async #requestJson(\n    url: URL,\n    init: RequestInit,\n    options: { authenticated?: boolean } = {},\n  ): Promise<Json> {\n    const { authenticated = true } = options;\n\n    const headers: Record<string, string> = {};\n\n    // Only advertise a JSON body when one is actually sent; bodyless requests\n    // (e.g. `createJourney`) must not carry a `Content-Type`.\n    if (init.body !== undefined && init.body !== null) {\n      headers['Content-Type'] = 'application/json';\n    }\n\n    if (authenticated) {\n      const bearerToken = await this.messenger.call(\n        'AuthenticationController:getBearerToken',\n      );\n      if (!bearerToken) {\n        throw new Error(\n          'Unable to obtain an authentication bearer token — is the wallet signed in?',\n        );\n      }\n      assert(bearerToken, string());\n      headers.Authorization = `Bearer ${bearerToken}`;\n    }\n\n    const response = await this.#fetch(url.toString(), {\n      ...init,\n      headers,\n    });\n    if (!response.ok) {\n      let detail = '';\n      try {\n        const errorBody: unknown = await response.json();\n        if (errorBody && typeof errorBody === 'object') {\n          const record = errorBody as Record<string, unknown>;\n          if (typeof record.message === 'string') {\n            detail = record.message;\n          } else if (typeof record.error === 'string') {\n            detail = record.error;\n          }\n        }\n      } catch {\n        // Ignore body parse failures; status alone is still useful.\n      }\n      throw new HttpError(\n        response.status,\n        `Fetching '${url.toString()}' failed with status '${response.status}'${\n          detail ? `: ${detail}` : ''\n        }`,\n      );\n    }\n\n    // DELETE (and similar) endpoints return 204 No Content.\n    if (response.status === 204) {\n      return null;\n    }\n\n    return (await response.json()) as Json;\n  }\n}\n"]}

package/dist/index.cjs

@@ -1,11 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mintUkycTestToken = exports.signStorageAccessToken = exports.encodeStorageAccessTokenForHeader = exports.encodeClientMaterial = exports.deriveClientMaterial = exports.UKYC_STORAGE_ACCESS_TOKEN_VERSION = exports.UKYC_STORAGE_ACCESS_TOKEN_AUDIENCES = exports.UKYC_STORAGE_ACCESS_TOKEN_AUDIENCE = exports.UKYC_KWIL_AUDIENCE = exports.UKYC_CAPABILITY_AUTH_SCHEME = exports.generateKeyPair = exports.decryptCredentials = exports.ALPHA2_TO_ALPHA3 = exports.alpha2ToAlpha3 = exports.selectKycSumSub = exports.selectKycPhase = exports.selectIsKycRequiredForProduct = exports.serviceName = exports.KycService = exports.controllerName = exports.getDefaultKycVendorDisclaimersAccepted = exports.getDefaultKycProviderDisclaimersAccepted = exports.getDefaultKycControllerState = exports.KycController = void 0;
+exports.mintUkycTestToken = exports.signStorageAccessToken = exports.encodeStorageAccessTokenForHeader = exports.encodeClientMaterial = exports.deriveClientMaterial = exports.UKYC_STORAGE_ACCESS_TOKEN_VERSION = exports.UKYC_STORAGE_ACCESS_TOKEN_AUDIENCES = exports.UKYC_STORAGE_ACCESS_TOKEN_AUDIENCE = exports.UKYC_KWIL_AUDIENCE = exports.UKYC_CAPABILITY_AUTH_SCHEME = exports.generateKeyPair = exports.decryptCredentials = exports.ALPHA2_TO_ALPHA3 = exports.alpha2ToAlpha3 = exports.selectKycSumSub = exports.selectKycPhase = exports.selectIsKycRequiredForProduct = exports.serviceName = exports.KycService = exports.controllerName = exports.getDefaultKycControllerState = exports.KycController = void 0;
 var KycController_js_1 = require("./KycController.cjs");
 Object.defineProperty(exports, "KycController", { enumerable: true, get: function () { return KycController_js_1.KycController; } });
 Object.defineProperty(exports, "getDefaultKycControllerState", { enumerable: true, get: function () { return KycController_js_1.getDefaultKycControllerState; } });
-Object.defineProperty(exports, "getDefaultKycProviderDisclaimersAccepted", { enumerable: true, get: function () { return KycController_js_1.getDefaultKycProviderDisclaimersAccepted; } });
-Object.defineProperty(exports, "getDefaultKycVendorDisclaimersAccepted", { enumerable: true, get: function () { return KycController_js_1.getDefaultKycVendorDisclaimersAccepted; } });
 Object.defineProperty(exports, "controllerName", { enumerable: true, get: function () { return KycController_js_1.controllerName; } });
 var KycService_js_1 = require("./KycService.cjs");
 Object.defineProperty(exports, "KycService", { enumerable: true, get: function () { return KycService_js_1.KycService; } });