@transmitsecurity/platform-web-sdk 1.16.1 → 1.17.0

package/CHANGELOG.md

@@ -1,4 +1,14 @@
 # Changelog
+## 1.16.4 -  Aug. 3, 2025
+* fix: Crypto binding - resolved initialization issue in Safari
+* feat: Improved error handling - provide detailed reasons when the RiskID-SDK is disabled.
+
+## 1.16.3 -  Jul. 13, 2025
+* feat: Deploy a fix for Orchestration (ido) sdk
+
+## 1.16.2 -  Jul. 13, 2025
+* feat: Add NPM support for Platform SDK
+
 ## 1.15.0 -  Jun. 29, 2025
 **Fraud Prevention**
 * feat: Add support for rotating crypto-binding keys
@@ -11,11 +21,9 @@
 **Fraud Prevention**
 * feat: Add support for passing custom attributes to the `triggerActionEvent`
 
-
 ## 1.13.7 -  Jun. 8, 2025
 **Identity Verification**
 * Correct and update UI texts
-* 
 
 ## 1.13.6 -  May 25, 2025
 * fix: prevent race condition during crypto binding keys generation

package/README.md

@@ -1,72 +1,100 @@
 # Transmit Security Platform Web SDK
 
-A comprehensive browser-based identity and security solution for integrating with Mosaic's Fraud Prevention, WebAuthn authentication, Identity Verification, and Orchestration capabilities.
+A comprehensive browser-based identity and security solution with fraud prevention, WebAuthn authentication, identity verification, and orchestration capabilities.
 
 ## Installation
 
+### NPM Package (Recommended)
 ```bash
-npm install @transmitsecurity/platform-web-sdk@^1
+npm install @transmitsecurity/platform-web-sdk
 ```
+## Usage Patterns
 
-## Quick Start
+#### Individual Module Imports (Recommended)
+For optimal bundle sizes and performance, import only the modules you need:
 
-### Individual Module Imports (Recommended)
+```javascript
+// Option 1: Individual function imports (best for tree-shaking)
+import { triggerActionEvent, setUser, clearUser, initialize } from '@transmitsecurity/platform-web-sdk/drs';
+import { isPlatformAuthenticatorSupported, register } from '@transmitsecurity/platform-web-sdk/webauthn';
+import { start } from '@transmitsecurity/platform-web-sdk/idv';
 
-✅ **Recommended**: Import only the modules you need for optimal bundle size and faster loading.
+// Use modules (syntax depends on import method)
+// Option 1: Direct function calls
+await triggerActionEvent('login', { correlationId: 'example' });
+await setUser({ userId: 'user123' });
+const isSupported = await isPlatformAuthenticatorSupported();
+
+// Option 2: Namespace calls
+await drs.triggerActionEvent('login', { correlationId: 'example' });
+await drs.setUser({ userId: 'user123' });
+const isSupported = await webauthn.isPlatformAuthenticatorSupported();
+```
 
-```js
-import { drs, initialize } from '@transmitsecurity/platform-web-sdk/drs';
-import { webauthn } from '@transmitsecurity/platform-web-sdk/webauthn';
 
+```javascript
+import { ido, ClientResponseOptionType } from '@transmitsecurity/platform-web-sdk/ido';
+import { initialize } from '@transmitsecurity/platform-web-sdk';
+
+// Initialize
 await initialize({
-  clientId: 'your-client-id',
-  drs: { serverPath: 'https://api.transmitsecurity.io/risk-collect/' },
-  webauthn: { serverPath: 'https://api.transmitsecurity.io' }
+    clientId: 'your-client-id',
+    ido: { serverPath: 'https://api.transmitsecurity.io' }
 });
 
-// Use the modules
-await drs.triggerActionEvent('login', { correlationId: 'example' });
-const isSupported = await webauthn.isPlatformAuthenticatorSupported();
+// IDO usage
+await ido.startJourney('journey-id');
+await ido.submitClientResponse(
+    ClientResponseOptionType.ClientInput,
+    { userEmail: 'user@example.com' }
+);
 ```
 
-**Available individual imports**:
-```js
-// Fraud Prevention (DRS)
-import { drs, initialize } from '@transmitsecurity/platform-web-sdk/drs';
+#### TypeScript Support
+Full TypeScript support with individual module imports:
 
-// WebAuthn Authentication
-import { webauthn, initialize } from '@transmitsecurity/platform-web-sdk/webauthn';
+```typescript
+import { triggerActionEvent, setUser } from '@transmitsecurity/platform-web-sdk/drs';
+import { isPlatformAuthenticatorSupported } from '@transmitsecurity/platform-web-sdk/webauthn';
+import { start } from '@transmitsecurity/platform-web-sdk/idv';
+import { ido } from '@transmitsecurity/platform-web-sdk/ido';
+import { initialize } from '@transmitsecurity/platform-web-sdk';
 
-// Identity Verification (IDV)
-import { idv, initialize } from '@transmitsecurity/platform-web-sdk/idv';
+// Initialize with TypeScript types
+await initialize({
+    clientId: 'your-client-id',
+    drs: { serverPath: 'https://api.transmitsecurity.io/risk-collect/' },
+    webauthn: { serverPath: 'https://api.transmitsecurity.io' },
+    idv: { serverPath: 'https://api.transmitsecurity.io' },
+    ido: { 
+        serverPath: 'https://api.transmitsecurity.io',
+    }
+});
 
-// Identity Orchestration (IDO)
-import { ido, initialize } from '@transmitsecurity/platform-web-sdk/ido';
+// Use with proper TypeScript types
+await triggerActionEvent('login', { correlationId: 'example' });
+const isSupported: boolean = await isPlatformAuthenticatorSupported();
+await ido.default.submitClientResponse(
+    ClientResponseOptionType.ClientInput,
+    { userEmail: 'user@example.com' }
+);
 ```
 
-### Full SDK Import
-
-Import the entire SDK if you need multiple modules or prefer a single import.
+#### Full SDK Import (Alternative)
+If you need multiple modules, you can also import the full SDK:
 
-```js
+```javascript
 import { drs, webauthn, idv, ido, initialize } from '@transmitsecurity/platform-web-sdk';
 
 // Single initialize call for all modules
 await initialize({
-  clientId: 'your-client-id',
-  drs: { serverPath: 'https://api.transmitsecurity.io/risk-collect/' },
-  webauthn: { serverPath: 'https://api.transmitsecurity.io' }
+    clientId: 'your-client-id',
+    drs: { serverPath: 'https://api.transmitsecurity.io/risk-collect/' },
+    webauthn: { serverPath: 'https://api.transmitsecurity.io' },
+    idv: { serverPath: 'https://api.transmitsecurity.io' },
+    ido: { serverPath: 'https://api.transmitsecurity.io' }
 });
 
-// Use the modules
+// Use modules through the main object
 await drs.triggerActionEvent('login', { correlationId: 'example' });
-const isSupported = await webauthn.isPlatformAuthenticatorSupported();
 ```
-
-## Documentation
-
-For complete documentation, visit: https://developer.transmitsecurity.com/sdk-ref/sdk_ref_intro/
-
-## License
-
-SEE LICENSE IN LICENSE