@codedartdev/coinsentry-sdk 0.1.0

package/dist/kyc/config.js

@@ -0,0 +1,224 @@
+export function normalizeStringList(value) {
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => normalizeStringList(item));
+    }
+    if (typeof value === 'string') {
+        return value
+            .split(',')
+            .map((item) => item.trim())
+            .filter(Boolean);
+    }
+    return [];
+}
+export function normalizeClientFlowStep(step) {
+    return {
+        ...step,
+        required_fields: normalizeStringList(step.required_fields),
+        required_documents: normalizeStringList(step.required_documents),
+        entity_types: normalizeStringList(step.entity_types),
+        document_type_options: normalizeStringList(step.document_type_options),
+    };
+}
+export function normalizeClientFlow(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .filter((step) => Boolean(step && typeof step === 'object'))
+        .map(normalizeClientFlowStep);
+}
+export function normalizeDocumentTypeChoices(value) {
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => {
+            if (item && typeof item === 'object') {
+                const record = item;
+                const optionValue = String(record.value ?? '').trim();
+                if (!optionValue)
+                    return [];
+                return [{
+                        value: optionValue,
+                        label: String(record.label ?? optionValue).trim() || optionValue,
+                    }];
+            }
+            if (typeof item === 'string') {
+                const optionValue = item.trim();
+                return optionValue ? [{ value: optionValue, label: optionValue }] : [];
+            }
+            return [];
+        });
+    }
+    return normalizeStringList(value).map((optionValue) => ({
+        value: optionValue,
+        label: optionValue,
+    }));
+}
+export function uniqueDocumentChoices(choices) {
+    const seen = new Set();
+    return choices.filter((choice) => {
+        const value = choice.value.trim();
+        if (!value || seen.has(value))
+            return false;
+        seen.add(value);
+        return true;
+    });
+}
+export function getKycPrefill(requirements) {
+    if (!requirements)
+        return {};
+    const kycForm = requirements.kyc_form;
+    if (kycForm?.prefill && typeof kycForm.prefill === 'object')
+        return kycForm.prefill;
+    if (requirements.form_prefill && typeof requirements.form_prefill === 'object')
+        return requirements.form_prefill;
+    return {};
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));
+}
+function normalizeFieldName(value) {
+    return value.trim().toLowerCase();
+}
+function recordValue(value) {
+    return value && typeof value === 'object' ? value : {};
+}
+const PREFILL_FIELD_ALIASES = {
+    birth_date: ['birth_date', 'date_of_birth'],
+    date_of_birth: ['date_of_birth', 'birth_date'],
+    document_number: ['document_number', 'tax_id'],
+    tax_id: ['tax_id', 'document_number'],
+};
+const STRONG_READ_ONLY_LIST_KEYS = [
+    'locked_fields',
+    'strong_read_only_fields',
+    'force_read_only_fields',
+    'forced_read_only_fields',
+    'hard_read_only_fields',
+];
+const STRONG_READ_ONLY_MAP_KEYS = [
+    'field_locks',
+    'read_only_locks',
+];
+function prefillAliasesForField(field) {
+    const normalized = normalizeFieldName(field);
+    return PREFILL_FIELD_ALIASES[normalized] ?? [normalized];
+}
+export function hasRealKycPrefillValue(value) {
+    if (value === null || value === undefined)
+        return false;
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!trimmed || trimmed.includes('*'))
+            return false;
+        return /[A-Za-z0-9]/.test(trimmed);
+    }
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if (typeof value === 'boolean')
+        return true;
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (typeof value === 'object')
+        return Object.keys(value).length > 0;
+    return false;
+}
+function hasRealKycPrefillForField(requirements, field) {
+    const prefill = getKycPrefill(requirements);
+    return prefillAliasesForField(field).some((alias) => hasRealKycPrefillValue(prefill[alias]));
+}
+export function getKycReadOnlyFields(requirements) {
+    if (!requirements)
+        return [];
+    const kycFormFields = normalizeStringList(requirements.kyc_form?.read_only_fields);
+    return uniqueStrings([
+        ...kycFormFields,
+        ...normalizeStringList(requirements.read_only_fields),
+    ]);
+}
+function getKycStrongReadOnlyFields(requirements) {
+    if (!requirements)
+        return [];
+    const kycForm = recordValue(requirements.kyc_form);
+    const topLevel = recordValue(requirements);
+    const listFields = STRONG_READ_ONLY_LIST_KEYS.flatMap((key) => [
+        ...normalizeStringList(kycForm[key]),
+        ...normalizeStringList(topLevel[key]),
+    ]);
+    const mapFields = STRONG_READ_ONLY_MAP_KEYS.flatMap((key) => [
+        ...strongReadOnlyFieldsFromMap(kycForm[key]),
+        ...strongReadOnlyFieldsFromMap(topLevel[key]),
+    ]);
+    return uniqueStrings([...listFields, ...mapFields]);
+}
+function strongReadOnlyFieldsFromMap(value) {
+    const locks = recordValue(value);
+    return Object.entries(locks).flatMap(([field, lock]) => {
+        if (lock === true)
+            return [field];
+        if (typeof lock !== 'string')
+            return [];
+        const normalized = lock.trim().toLowerCase();
+        return ['strong', 'hard', 'locked', 'force', 'forced', 'read_only'].includes(normalized)
+            ? [field]
+            : [];
+    });
+}
+export function isKycFieldReadOnly(requirements, field) {
+    const normalizedField = normalizeFieldName(field);
+    const strongReadOnlyFields = getKycStrongReadOnlyFields(requirements).map(normalizeFieldName);
+    if (strongReadOnlyFields.includes(normalizedField))
+        return true;
+    const readOnlyFields = getKycReadOnlyFields(requirements).map(normalizeFieldName);
+    return readOnlyFields.includes(normalizedField)
+        && hasRealKycPrefillForField(requirements, normalizedField);
+}
+export function shouldLockKycFiscalDocumentField(options) {
+    return options.configuredReadOnly
+        && options.normalized.length > 0
+        && options.isValid;
+}
+function getConfigClientFlow(config) {
+    const record = config && typeof config === 'object' ? config : {};
+    return [
+        ...normalizeClientFlow(record.client_flow),
+        ...normalizeClientFlow(record.compliance_config?.client_flow),
+        ...normalizeClientFlow(record.flow_config?.compliance_config?.client_flow),
+    ];
+}
+export function getRegistrationDocumentConfig(config) {
+    const record = config && typeof config === 'object' ? config : {};
+    const direct = record.registration_document;
+    if (direct && typeof direct === 'object') {
+        return direct;
+    }
+    const flowConfig = record.flow_config && typeof record.flow_config === 'object'
+        ? record.flow_config
+        : {};
+    const nested = flowConfig.registration_document;
+    if (nested && typeof nested === 'object') {
+        return nested;
+    }
+    return null;
+}
+export function getRegistrationTaxIdField(config) {
+    const field = String(getRegistrationDocumentConfig(config)?.field ?? 'tax_id').trim();
+    return field || 'tax_id';
+}
+export function shouldCollectRegistrationTaxId(config) {
+    const registrationDocument = getRegistrationDocumentConfig(config);
+    if (registrationDocument?.collect_tax_id === true)
+        return true;
+    return getConfigClientFlow(config).some((step) => step.screen === 'account' && step.collect_tax_id === true);
+}
+export function isRegistrationTaxIdRequired(config) {
+    const registrationDocument = getRegistrationDocumentConfig(config);
+    const taxIdField = getRegistrationTaxIdField(config);
+    if (registrationDocument?.collect_tax_id === true && registrationDocument.required === true) {
+        return true;
+    }
+    return getConfigClientFlow(config).some((step) => {
+        if (step.screen !== 'account')
+            return false;
+        const requiredFields = normalizeStringList(step.required_fields);
+        return requiredFields.includes(taxIdField) || requiredFields.includes('tax_id');
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/kyc/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/kyc/config.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ClientFlowStep,\n  DocumentTypeChoice,\n  KycRequirements,\n  KycFormPrefill,\n  RegistrationDocumentConfig,\n} from './types.js';\n\nexport function normalizeStringList(value: unknown): string[] {\n  if (Array.isArray(value)) {\n    return value.flatMap((item) => normalizeStringList(item));\n  }\n\n  if (typeof value === 'string') {\n    return value\n      .split(',')\n      .map((item) => item.trim())\n      .filter(Boolean);\n  }\n\n  return [];\n}\n\nexport function normalizeClientFlowStep(step: ClientFlowStep): ClientFlowStep {\n  return {\n    ...step,\n    required_fields: normalizeStringList(step.required_fields),\n    required_documents: normalizeStringList(step.required_documents),\n    entity_types: normalizeStringList(step.entity_types) as ClientFlowStep['entity_types'],\n    document_type_options: normalizeStringList(step.document_type_options),\n  };\n}\n\nexport function normalizeClientFlow(value: unknown): ClientFlowStep[] {\n  if (!Array.isArray(value)) return [];\n  return value\n    .filter((step): step is ClientFlowStep => Boolean(step && typeof step === 'object'))\n    .map(normalizeClientFlowStep);\n}\n\nexport function normalizeDocumentTypeChoices(value: unknown): DocumentTypeChoice[] {\n  if (Array.isArray(value)) {\n    return value.flatMap((item) => {\n      if (item && typeof item === 'object') {\n        const record = item as Record<string, unknown>;\n        const optionValue = String(record.value ?? '').trim();\n        if (!optionValue) return [];\n        return [{\n          value: optionValue,\n          label: String(record.label ?? optionValue).trim() || optionValue,\n        }];\n      }\n\n      if (typeof item === 'string') {\n        const optionValue = item.trim();\n        return optionValue ? [{ value: optionValue, label: optionValue }] : [];\n      }\n\n      return [];\n    });\n  }\n\n  return normalizeStringList(value).map((optionValue) => ({\n    value: optionValue,\n    label: optionValue,\n  }));\n}\n\nexport function uniqueDocumentChoices(choices: DocumentTypeChoice[]): DocumentTypeChoice[] {\n  const seen = new Set<string>();\n  return choices.filter((choice) => {\n    const value = choice.value.trim();\n    if (!value || seen.has(value)) return false;\n    seen.add(value);\n    return true;\n  });\n}\n\nexport function getKycPrefill(requirements: KycRequirements | null): KycFormPrefill {\n  if (!requirements) return {};\n  const kycForm = requirements.kyc_form;\n  if (kycForm?.prefill && typeof kycForm.prefill === 'object') return kycForm.prefill;\n  if (requirements.form_prefill && typeof requirements.form_prefill === 'object') return requirements.form_prefill;\n  return {};\n}\n\nfunction uniqueStrings(values: string[]): string[] {\n  return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));\n}\n\nfunction normalizeFieldName(value: string): string {\n  return value.trim().toLowerCase();\n}\n\nfunction recordValue(value: unknown): Record<string, unknown> {\n  return value && typeof value === 'object' ? value as Record<string, unknown> : {};\n}\n\nconst PREFILL_FIELD_ALIASES: Record<string, string[]> = {\n  birth_date: ['birth_date', 'date_of_birth'],\n  date_of_birth: ['date_of_birth', 'birth_date'],\n  document_number: ['document_number', 'tax_id'],\n  tax_id: ['tax_id', 'document_number'],\n};\n\nconst STRONG_READ_ONLY_LIST_KEYS = [\n  'locked_fields',\n  'strong_read_only_fields',\n  'force_read_only_fields',\n  'forced_read_only_fields',\n  'hard_read_only_fields',\n];\n\nconst STRONG_READ_ONLY_MAP_KEYS = [\n  'field_locks',\n  'read_only_locks',\n];\n\nfunction prefillAliasesForField(field: string): string[] {\n  const normalized = normalizeFieldName(field);\n  return PREFILL_FIELD_ALIASES[normalized] ?? [normalized];\n}\n\nexport function hasRealKycPrefillValue(value: unknown): boolean {\n  if (value === null || value === undefined) return false;\n\n  if (typeof value === 'string') {\n    const trimmed = value.trim();\n    if (!trimmed || trimmed.includes('*')) return false;\n    return /[A-Za-z0-9]/.test(trimmed);\n  }\n\n  if (typeof value === 'number') return Number.isFinite(value);\n  if (typeof value === 'boolean') return true;\n  if (Array.isArray(value)) return value.length > 0;\n  if (typeof value === 'object') return Object.keys(value).length > 0;\n\n  return false;\n}\n\nfunction hasRealKycPrefillForField(requirements: KycRequirements | null, field: string): boolean {\n  const prefill = getKycPrefill(requirements);\n  return prefillAliasesForField(field).some((alias) => hasRealKycPrefillValue(prefill[alias]));\n}\n\nexport function getKycReadOnlyFields(requirements: KycRequirements | null): string[] {\n  if (!requirements) return [];\n  const kycFormFields = normalizeStringList(requirements.kyc_form?.read_only_fields);\n  return uniqueStrings([\n    ...kycFormFields,\n    ...normalizeStringList(requirements.read_only_fields),\n  ]);\n}\n\nfunction getKycStrongReadOnlyFields(requirements: KycRequirements | null): string[] {\n  if (!requirements) return [];\n\n  const kycForm = recordValue(requirements.kyc_form);\n  const topLevel = recordValue(requirements);\n  const listFields = STRONG_READ_ONLY_LIST_KEYS.flatMap((key) => [\n    ...normalizeStringList(kycForm[key]),\n    ...normalizeStringList(topLevel[key]),\n  ]);\n  const mapFields = STRONG_READ_ONLY_MAP_KEYS.flatMap((key) => [\n    ...strongReadOnlyFieldsFromMap(kycForm[key]),\n    ...strongReadOnlyFieldsFromMap(topLevel[key]),\n  ]);\n\n  return uniqueStrings([...listFields, ...mapFields]);\n}\n\nfunction strongReadOnlyFieldsFromMap(value: unknown): string[] {\n  const locks = recordValue(value);\n\n  return Object.entries(locks).flatMap(([field, lock]) => {\n    if (lock === true) return [field];\n    if (typeof lock !== 'string') return [];\n\n    const normalized = lock.trim().toLowerCase();\n    return ['strong', 'hard', 'locked', 'force', 'forced', 'read_only'].includes(normalized)\n      ? [field]\n      : [];\n  });\n}\n\nexport function isKycFieldReadOnly(requirements: KycRequirements | null, field: string): boolean {\n  const normalizedField = normalizeFieldName(field);\n  const strongReadOnlyFields = getKycStrongReadOnlyFields(requirements).map(normalizeFieldName);\n  if (strongReadOnlyFields.includes(normalizedField)) return true;\n\n  const readOnlyFields = getKycReadOnlyFields(requirements).map(normalizeFieldName);\n  return readOnlyFields.includes(normalizedField)\n    && hasRealKycPrefillForField(requirements, normalizedField);\n}\n\nexport function shouldLockKycFiscalDocumentField(options: {\n  configuredReadOnly: boolean;\n  normalized: string;\n  isValid: boolean;\n}): boolean {\n  return options.configuredReadOnly\n    && options.normalized.length > 0\n    && options.isValid;\n}\n\nfunction getConfigClientFlow(config: unknown): ClientFlowStep[] {\n  const record = config && typeof config === 'object' ? config as Record<string, unknown> : {};\n  return [\n    ...normalizeClientFlow(record.client_flow),\n    ...normalizeClientFlow((record.compliance_config as Record<string, unknown> | undefined)?.client_flow),\n    ...normalizeClientFlow(\n      ((record.flow_config as Record<string, unknown> | undefined)?.compliance_config as Record<string, unknown> | undefined)?.client_flow\n    ),\n  ];\n}\n\nexport function getRegistrationDocumentConfig(config: unknown): RegistrationDocumentConfig | null {\n  const record = config && typeof config === 'object' ? config as Record<string, unknown> : {};\n  const direct = record.registration_document;\n  if (direct && typeof direct === 'object') {\n    return direct as RegistrationDocumentConfig;\n  }\n\n  const flowConfig = record.flow_config && typeof record.flow_config === 'object'\n    ? record.flow_config as Record<string, unknown>\n    : {};\n  const nested = flowConfig.registration_document;\n  if (nested && typeof nested === 'object') {\n    return nested as RegistrationDocumentConfig;\n  }\n\n  return null;\n}\n\nexport function getRegistrationTaxIdField(config: unknown): string {\n  const field = String(getRegistrationDocumentConfig(config)?.field ?? 'tax_id').trim();\n  return field || 'tax_id';\n}\n\nexport function shouldCollectRegistrationTaxId(config: unknown): boolean {\n  const registrationDocument = getRegistrationDocumentConfig(config);\n  if (registrationDocument?.collect_tax_id === true) return true;\n\n  return getConfigClientFlow(config).some((step) =>\n    step.screen === 'account' && step.collect_tax_id === true\n  );\n}\n\nexport function isRegistrationTaxIdRequired(config: unknown): boolean {\n  const registrationDocument = getRegistrationDocumentConfig(config);\n  const taxIdField = getRegistrationTaxIdField(config);\n\n  if (registrationDocument?.collect_tax_id === true && registrationDocument.required === true) {\n    return true;\n  }\n\n  return getConfigClientFlow(config).some((step) => {\n    if (step.screen !== 'account') return false;\n    const requiredFields = normalizeStringList(step.required_fields);\n    return requiredFields.includes(taxIdField) || requiredFields.includes('tax_id');\n  });\n}\n"]}

package/dist/kyc/flow.d.ts

@@ -0,0 +1,37 @@
+import type { ClientFlowStep, KycCustomerType, KycFlowEntityType, KycFlowSnapshot, KycOverviewData, KycRequirements, KycVerificationData } from './types.js';
+export declare const VIRTUAL_REVIEW_STEP: ClientFlowStep;
+export declare function normalizeCustomerType(value: unknown): KycCustomerType;
+export declare function flowEntityTypeForCustomerType(customerType: KycCustomerType): KycFlowEntityType;
+export declare function getRequirementsClientFlow(requirements: KycRequirements | null | undefined): ClientFlowStep[];
+export declare function hasKycClientFlow(requirements: KycRequirements | null | undefined): boolean;
+export declare function hasResolvedKycRequirements(requirements: KycRequirements | null | undefined): requirements is KycRequirements;
+export declare function getComplianceSteps(requirements: KycRequirements | null | undefined, customerType: KycCustomerType): ClientFlowStep[];
+export declare function ensureReviewStep(steps: ClientFlowStep[], customerType: KycCustomerType): ClientFlowStep[];
+export declare function isUniversalStepCompleted(step: ClientFlowStep, status: KycVerificationData | null | undefined): boolean;
+export declare function resolveActiveKycStep(params: {
+    requirements: KycRequirements | null | undefined;
+    status: KycVerificationData | null | undefined;
+    customerType: KycCustomerType;
+}): ClientFlowStep | null;
+export declare function canOpenUniversalStep(params: {
+    step: ClientFlowStep;
+    steps: ClientFlowStep[];
+    activeStep: ClientFlowStep | null;
+    status: KycVerificationData | null | undefined;
+}): boolean;
+export declare function findStepByMissing(steps: ClientFlowStep[], missingStep?: string, missingScreen?: string): ClientFlowStep | null;
+export declare function getKycProgress(params: {
+    steps: ClientFlowStep[];
+    status: KycVerificationData | null | undefined;
+}): number;
+export declare function requirementsFromOverview(overview: KycOverviewData | null | undefined): KycRequirements | null;
+export declare function preserveSsrKycRequirementsAnchor(anchor: KycRequirements, overviewRequirements: KycRequirements | null): KycRequirements;
+export declare function mergeKycRequirementsWithAnchor(nextRequirements: KycRequirements, anchor: KycRequirements | null): KycRequirements;
+export declare function statusFromOverview(overview: KycOverviewData | null | undefined): KycVerificationData | null;
+export declare function resolveKycFlowSnapshot(input: {
+    overview?: KycOverviewData | null;
+    anchorRequirements?: KycRequirements | null;
+}): KycFlowSnapshot;
+export declare function isKycFlowSnapshotConfigured(snapshot: KycFlowSnapshot | null | undefined): boolean;
+export declare function isKycOverviewFlowConfigured(overview: KycOverviewData | null | undefined): boolean;
+//# sourceMappingURL=flow.d.ts.map

package/dist/kyc/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/kyc/flow.ts"],"names":[],"mappings":"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"}

package/dist/kyc/flow.js

@@ -0,0 +1,329 @@
+export const VIRTUAL_REVIEW_STEP = {
+    key: 'review',
+    title: 'Review',
+    phase: 'compliance',
+    screen: 'review',
+    description: 'Review and submit verification.',
+    endpoint: '/api/v1/kyc/submit',
+    required_fields: [],
+    required_documents: [],
+    entity_types: ['PF', 'PJ'],
+    blocking: true,
+};
+function asRecord(value) {
+    return value && typeof value === 'object' ? value : {};
+}
+function normalizeClientFlow(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .filter((step) => Boolean(step && typeof step === 'object'))
+        .flatMap((step) => {
+        const key = typeof step.key === 'string' ? step.key.trim() : '';
+        const screen = typeof step.screen === 'string' ? step.screen.trim() : '';
+        const phase = step.phase === 'registration' || step.phase === 'compliance'
+            ? step.phase
+            : 'compliance';
+        if (!key || !screen)
+            return [];
+        return [{
+                ...step,
+                key,
+                title: typeof step.title === 'string' && step.title.trim() ? step.title : key,
+                phase,
+                screen: screen,
+                endpoint: typeof step.endpoint === 'string' ? step.endpoint : undefined,
+                required_fields: Array.isArray(step.required_fields) ? step.required_fields.map(String) : [],
+                required_documents: Array.isArray(step.required_documents) ? step.required_documents.map(String) : [],
+                entity_types: normalizeEntityTypes(step.entity_types),
+                blocking: step.blocking !== false,
+            }];
+    });
+}
+function normalizeEntityTypes(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        return ['PF', 'PJ'];
+    const entityTypes = value
+        .map((item) => String(item).trim().toUpperCase())
+        .filter((item) => item === 'PF' || item === 'PJ');
+    return entityTypes.length > 0 ? entityTypes : ['PF', 'PJ'];
+}
+function normalizeJurisdictionCode(value) {
+    const normalized = String(value ?? '').trim().toUpperCase();
+    return /^[A-Z]{2}$/.test(normalized) ? normalized : undefined;
+}
+function normalizeDocumentTypes(requirements) {
+    const value = requirements?.document_types;
+    const list = Array.isArray(value)
+        ? value
+        : typeof value === 'string'
+            ? value.split(',')
+            : [];
+    return Array.from(new Set(list
+        .map((type) => String(type).trim().toLowerCase())
+        .filter(Boolean))).sort();
+}
+function sameDocumentTypes(nextRequirements, anchor) {
+    const nextTypes = normalizeDocumentTypes(nextRequirements);
+    const anchorTypes = normalizeDocumentTypes(anchor);
+    if (nextTypes.length === 0 || anchorTypes.length === 0)
+        return true;
+    if (nextTypes.length !== anchorTypes.length)
+        return false;
+    return nextTypes.every((type, index) => type === anchorTypes[index]);
+}
+function anchorMatchesRequirements(nextRequirements, anchor) {
+    const nextJurisdiction = normalizeJurisdictionCode(nextRequirements.jurisdiction_code ?? nextRequirements.code);
+    const anchorJurisdiction = normalizeJurisdictionCode(anchor.jurisdiction_code ?? anchor.code);
+    if (nextJurisdiction && anchorJurisdiction && nextJurisdiction !== anchorJurisdiction)
+        return false;
+    if (nextRequirements.customer_type
+        && anchor.customer_type
+        && nextRequirements.customer_type !== anchor.customer_type) {
+        return false;
+    }
+    return sameDocumentTypes(nextRequirements, anchor);
+}
+export function normalizeCustomerType(value) {
+    const normalized = String(value ?? '').trim().toLowerCase();
+    return ['company', 'pj', 'business', 'legal_entity'].includes(normalized)
+        ? 'company'
+        : 'individual';
+}
+export function flowEntityTypeForCustomerType(customerType) {
+    return customerType === 'company' ? 'PJ' : 'PF';
+}
+export function getRequirementsClientFlow(requirements) {
+    if (!requirements)
+        return [];
+    const direct = normalizeClientFlow(requirements.client_flow);
+    if (direct.length > 0)
+        return direct;
+    const nested = normalizeClientFlow(requirements.compliance_config?.client_flow);
+    if (nested.length > 0)
+        return nested;
+    return normalizeClientFlow(requirements.flow_config?.compliance_config?.client_flow);
+}
+export function hasKycClientFlow(requirements) {
+    return getRequirementsClientFlow(requirements).length > 0;
+}
+export function hasResolvedKycRequirements(requirements) {
+    return Boolean(requirements && hasKycClientFlow(requirements));
+}
+export function getComplianceSteps(requirements, customerType) {
+    const entityType = flowEntityTypeForCustomerType(customerType);
+    return getRequirementsClientFlow(requirements)
+        .filter((step) => step.phase === 'compliance')
+        .filter((step) => (step.entity_types?.length ? step.entity_types : ['PF', 'PJ']).includes(entityType));
+}
+export function ensureReviewStep(steps, customerType) {
+    if (steps.length === 0 || steps.some((step) => step.screen === 'review'))
+        return steps;
+    return [
+        ...steps,
+        {
+            ...VIRTUAL_REVIEW_STEP,
+            entity_types: [flowEntityTypeForCustomerType(customerType)],
+        },
+    ];
+}
+export function isUniversalStepCompleted(step, status) {
+    if (!status)
+        return false;
+    return status.completed_flow_steps?.includes(step.key) ?? false;
+}
+function flowStateStepKey(status) {
+    return status?.flow_state?.required_action?.step_key
+        ?? status?.flow_state?.target_flow_step
+        ?? status?.flow_state?.current_step?.key
+        ?? status?.flow_state?.target_step
+        ?? null;
+}
+export function resolveActiveKycStep(params) {
+    if (getRequirementsClientFlow(params.requirements).length === 0)
+        return null;
+    const steps = ensureReviewStep(getComplianceSteps(params.requirements, params.customerType), params.customerType);
+    if (steps.length === 0)
+        return null;
+    if (params.status?.status === 'pending_review' || params.status?.status === 'under_review')
+        return null;
+    if (params.status?.status === 'approved')
+        return null;
+    const flowStateKey = flowStateStepKey(params.status);
+    if (flowStateKey) {
+        const configuredStep = steps.find((step) => step.key === flowStateKey);
+        if (configuredStep)
+            return configuredStep;
+    }
+    if (params.status?.status === 'rejected' || params.status?.status === 'requires_resubmission') {
+        return steps.find((step) => step.screen !== 'review' && !isUniversalStepCompleted(step, params.status))
+            ?? steps.find((step) => step.screen === 'review')
+            ?? steps[0];
+    }
+    for (const step of steps) {
+        if (step.screen === 'review')
+            continue;
+        if (isUniversalStepCompleted(step, params.status))
+            continue;
+        if (step.blocking !== false)
+            return step;
+    }
+    return steps.find((step) => step.screen === 'review') ?? steps[steps.length - 1];
+}
+export function canOpenUniversalStep(params) {
+    const index = params.steps.findIndex((step) => step.key === params.step.key);
+    if (index < 0)
+        return false;
+    if (params.activeStep?.key === params.step.key)
+        return true;
+    if (isUniversalStepCompleted(params.step, params.status))
+        return true;
+    const firstIncompleteIndex = params.steps.findIndex((step) => step.screen !== 'review' && !isUniversalStepCompleted(step, params.status));
+    if (params.step.screen === 'review')
+        return firstIncompleteIndex === -1;
+    if (firstIncompleteIndex === -1)
+        return true;
+    return index <= firstIncompleteIndex;
+}
+export function findStepByMissing(steps, missingStep, missingScreen) {
+    if (!missingStep && !missingScreen)
+        return null;
+    return steps.find((step) => (missingStep && step.key === missingStep)
+        || (missingScreen && step.screen === missingScreen)) ?? null;
+}
+export function getKycProgress(params) {
+    if (params.steps.length === 0)
+        return 0;
+    const completed = params.steps.filter((step) => step.screen === 'review'
+        ? params.status?.status === 'pending_review'
+            || params.status?.status === 'under_review'
+            || params.status?.status === 'approved'
+        : isUniversalStepCompleted(step, params.status)).length;
+    return Math.min(100, Math.round((completed / params.steps.length) * 100));
+}
+export function requirementsFromOverview(overview) {
+    if (!overview)
+        return null;
+    const overviewRequirements = asRecord(overview.requirements);
+    const overviewFlowConfig = asRecord(overview.flow_config);
+    const requirementFlowConfig = asRecord(overviewRequirements.flow_config);
+    const flowConfig = {
+        ...overviewFlowConfig,
+        ...requirementFlowConfig,
+    };
+    const requirementsSource = Object.keys(overviewRequirements).length > 0
+        ? overviewRequirements
+        : flowConfig;
+    if (Object.keys(requirementsSource).length === 0)
+        return null;
+    const flowComplianceConfig = asRecord(asRecord(flowConfig).compliance_config);
+    const requirementsComplianceConfig = asRecord(requirementsSource.compliance_config);
+    const directClientFlow = normalizeClientFlow(overview.client_flow);
+    const clientFlow = directClientFlow.length > 0
+        ? directClientFlow
+        : [
+            ...normalizeClientFlow(requirementsSource.client_flow),
+            ...normalizeClientFlow(requirementsComplianceConfig.client_flow),
+            ...normalizeClientFlow(flowComplianceConfig.client_flow),
+        ];
+    const flowState = overview.flow_state ?? overview.status?.flow_state ?? null;
+    const jurisdiction = asRecord(requirementsSource.jurisdiction ?? flowConfig.jurisdiction);
+    const resolvedLocale = String(requirementsSource.locale
+        ?? asRecord(overview).locale
+        ?? flowConfig.locale
+        ?? jurisdiction.locale
+        ?? '').trim() || undefined;
+    return {
+        ...flowConfig,
+        ...requirementsSource,
+        jurisdiction_code: normalizeJurisdictionCode(requirementsSource.jurisdiction_code
+            ?? requirementsSource.code
+            ?? flowState?.jurisdiction_code),
+        customer_type: requirementsSource.customer_type
+            ?? normalizeCustomerType(flowState?.entity_type),
+        locale: resolvedLocale,
+        flow_config: {
+            ...flowConfig,
+            compliance_config: {
+                ...flowComplianceConfig,
+                client_flow: clientFlow,
+            },
+        },
+        compliance_config: {
+            ...flowComplianceConfig,
+            ...requirementsComplianceConfig,
+            client_flow: clientFlow,
+        },
+        client_flow: clientFlow,
+    };
+}
+export function preserveSsrKycRequirementsAnchor(anchor, overviewRequirements) {
+    const anchorClientFlow = getRequirementsClientFlow(anchor);
+    return {
+        ...anchor,
+        kyc_form: overviewRequirements?.kyc_form ?? anchor.kyc_form,
+        form_prefill: overviewRequirements?.form_prefill ?? anchor.form_prefill,
+        read_only_fields: overviewRequirements?.read_only_fields ?? anchor.read_only_fields,
+        client_flow: anchorClientFlow,
+        flow_config: {
+            ...(anchor.flow_config ?? {}),
+            compliance_config: {
+                ...(anchor.flow_config?.compliance_config ?? {}),
+                client_flow: anchorClientFlow,
+            },
+        },
+        compliance_config: {
+            ...(anchor.compliance_config ?? {}),
+            client_flow: anchorClientFlow,
+        },
+    };
+}
+export function mergeKycRequirementsWithAnchor(nextRequirements, anchor) {
+    if (!anchor)
+        return nextRequirements;
+    const anchorClientFlow = getRequirementsClientFlow(anchor);
+    const nextClientFlow = getRequirementsClientFlow(nextRequirements);
+    const canUseAnchor = anchorClientFlow.length > 0
+        && nextClientFlow.length === 0
+        && anchorMatchesRequirements(nextRequirements, anchor);
+    if (!canUseAnchor)
+        return nextRequirements;
+    return preserveSsrKycRequirementsAnchor(anchor, nextRequirements);
+}
+export function statusFromOverview(overview) {
+    return overview?.status ?? null;
+}
+export function resolveKycFlowSnapshot(input) {
+    const overviewRequirements = requirementsFromOverview(input.overview);
+    const requirements = overviewRequirements
+        ? mergeKycRequirementsWithAnchor(overviewRequirements, input.anchorRequirements ?? null)
+        : input.anchorRequirements ?? null;
+    const status = statusFromOverview(input.overview);
+    const customerType = normalizeCustomerType(requirements?.customer_type
+        ?? status?.flow_state?.entity_type);
+    const jurisdictionCode = normalizeJurisdictionCode(requirements?.jurisdiction_code
+        ?? requirements?.code
+        ?? status?.flow_state?.jurisdiction_code);
+    const hasConfiguredClientFlow = getRequirementsClientFlow(requirements).length > 0;
+    const steps = hasConfiguredClientFlow
+        ? ensureReviewStep(getComplianceSteps(requirements, customerType), customerType)
+        : [];
+    const activeStep = resolveActiveKycStep({ requirements, status, customerType });
+    return {
+        activeStep,
+        steps,
+        requirements,
+        status,
+        customerType,
+        jurisdictionCode,
+        progress: getKycProgress({ steps, status }),
+        configMissing: Boolean(requirements && !hasConfiguredClientFlow),
+    };
+}
+export function isKycFlowSnapshotConfigured(snapshot) {
+    return Boolean(snapshot && !snapshot.configMissing && snapshot.steps.length > 0);
+}
+export function isKycOverviewFlowConfigured(overview) {
+    return isKycFlowSnapshotConfigured(resolveKycFlowSnapshot({ overview }));
+}
+//# sourceMappingURL=flow.js.map