@transmitsecurity/platform-web-sdk 2.4.1 → 2.5.0

package/dist/drs.d.ts

@@ -21,6 +21,38 @@ type LightweightPayload = {
     events: Array<Record<string, unknown>>;
 };
 
+type CryptoBindingOptions = {
+    /** Set to true if you want to scope your crypto-binding keys with your product only (default is false, to use global-platofrm scope) */
+    productScope?: boolean;
+    /** Custom database name, will be affected only if set `productScope` to true */
+    indexedDBName?: string;
+    /** Custom db-versioning, will be be affected only if set `productScope` to true */
+    dbVersion?: number;
+    /** Custom keys-store (table) name, will be affected only if set `productScope` to true */
+    keysStoreName?: string;
+    /** Set to true if product supports key rotation */
+    /** Expiry days - number of days after which the key will expire */
+    /** Started at - timestamp of the day when the rotation was enabled for the product */
+    keyRotation?: {
+        isEnabled: boolean;
+        expiryDays: number;
+        startedAt: number;
+        tenantId: string;
+    };
+    /** Timeout in milliseconds for IDB write transactions. If not set, no timeout is applied.
+     *  Use to guard against browsers that silently freeze IDB (e.g. iOS 18.7 WKWebView ephemeral sessions). */
+    idbWriteTimeoutMs?: number;
+    /** @internal
+     *  Warning! This flag shouldn't be used, it was added temporarily for multi-tenant support.
+     *
+     *  Internal flag used when the Product SDK instance has its own client ID separate from the Platform SDK root-level client ID */
+    fallbackClientId?: string;
+    /** Optional string to scope crypto-binding keys to a separate object store.
+     *  When set, keys are stored in `identifiers_store:<keyScope>` instead of the default `identifiers_store`.
+     *  Use only when instructed by Transmit Security to isolate key storage between browser contexts (e.g. webview vs Safari). */
+    keyScope?: string;
+};
+
 type TransactionType = 'purchase' | 'bill_payment' | 'mobile_recharge' | 'money_transfer' | 'credit_transfer' | 'credit_redemption' | 'top_up' | 'withdrawal' | 'investment' | 'loan' | 'refund' | 'other';
 type TransactionMethod = 'bank_account' | 'wire' | 'card' | 'p2p' | 'wallet';
 type AvsMatchLevel = 'none' | 'postal' | 'street' | 'full' | 'unknown';
@@ -66,6 +98,10 @@ interface ConstructorOptions {
     hasOwnClientId?: boolean;
     /** Tier mode for the SDK: 'standard' (default) or 'lightweight' (server-to-server) */
     tier?: 'standard' | 'lightweight';
+    /** @internal
+     * Optional configuration for crypto-binding key scoping.
+     * Use only when instructed by Transmit Security. */
+    cryptoBindingConfig?: Pick<CryptoBindingOptions, 'keyScope'>;
 }
 interface TransactionData {
     amount: number;