@cyphlens/2fa-sse-sdk 1.0.1

package/README.md

@@ -0,0 +1,142 @@
+# Cyphlens SSE Client SDK 🚀  
+A lightweight JavaScript library designed to simplify 2FA authentication with Cyphlens' Server-Sent Events (SSE) integration.
+
+This SDK is bundled using **Rollup** and supports **ES Modules (ESM)**, **CommonJS (CJS)**, and **UMD (Universal Module Definition)** formats for maximum compatibility across environments.
+
+---
+
+## Features ✨  
+- Easy integration with Cyphlens 2FA authentication  
+- Real-time event listening via Server-Sent Events (SSE)  
+- Lightweight and dependency-free  
+- Cross-environment support (Node.js, browsers, and modern frameworks)  
+
+---
+
+## Installation 📦  
+
+### Using NPM  
+Install the SDK via npm:  
+```sh
+npm install @cyphlens/2fa-sse-sdk
+```
+
+### Using Yarn  
+Install the SDK via Yarn:  
+```sh 
+yarn add @cyphlens/2fa-sse-sdk
+```
+
+### Using CDN (Browser)  
+Include the SDK directly in your HTML:  
+```html
+<script src="https://cdn.jsdelivr.net/npm/@cyphlens/2fa-sse-sdk/dist/bundle.umd.min.js"/>
+```
+
+---
+
+## Usage 🔧  
+
+### Importing the SDK  
+
+#### 1. ES Modules (ESM) - Modern JavaScript  
+```javascript
+import Cyphlens from "@cyphlens/2fa-sse-sdk";
+```
+
+#### 2. CommonJS (CJS) - Node.js  
+```javascript
+const Cyphlens = require("@cyphlens/2fa-sse-sdk");
+```
+
+#### 3. Browser (UMD)  
+After including the CDN script, the SDK is available as a global `Cyphlens` object:  
+```javascript
+const cyphlensClient = new Cyphlens("https://your-api-base-url/b2b/v1");
+```
+
+---
+
+### Example: Listening to 2FA Events  
+
+#### 1. Initialize the Client  
+```javascript
+    const baseUrl = "https://your-api-base-url"; // Replace with your API base URL
+    const sessionId = "your-session-id"; // Replace with your session ID
+    // Initialize the Cyphlens client
+    const cyphlensClient = new Cyphlens(`${baseUrl}/b2b/v1`);
+```
+
+#### 2. Listen for Events  
+```javascript
+    // Define the callback for handling events```  
+    const onData = (eventType, data) => {
+      if (eventType === "MFASwipe") {
+        const twoFactorEvent = data;
+        console.log("2FA Status:", twoFactorEvent.status);
+        // Handle status change (e.g., update UI or trigger logic)
+      }
+    };
+    const onError = (error) => {
+        console.error("SSE Error:", error);
+        // Handle the error (e.g., retry connection, notify user)
+    };
+    // Start listening to events
+    cyphlensClient.listen(sessionId, onData, onError);
+```
+
+#### 3. Stop Listening  
+```javascript
+    // Stop the event listener when no longer needed```  
+    cyphlensClient.stop();
+```
+
+---
+
+## API Reference 📚  
+
+### ```new Cyphlens(baseUrl)```  
+- **baseUrl**: `string` - The base URL of your Cyphlens API (e.g., `"https://api.cyphlens.com/b2b/v1"`)  
+Creates a new instance of the Cyphlens client.
+
+### ```listen(sessionId, callback, errorCallback)```  
+- **sessionId**: `string` - The session ID to listen for events  
+- **callback**: `(eventType: string, data: any) => void` - Callback function to handle incoming events  
+- **errorCallback**: `(error: Event) => void` - Callback function to handle errors (optional)  
+Starts listening for Server-Sent Events tied to the specified session.
+
+### ```stop()```  
+Stops the event listener and closes the connection.
+
+---
+
+## Event Types  
+- **`MFASwipe`**: Triggered when a 2FA swipe event occurs.  
+  - **data**: `{ status: string, ... }` - Contains the event details, including the 2FA status.
+
+---
+
+## Types  
+- `CyphlensErrorCallback`: `(error: Event) => void` - Type definition for the error callback function.
+
+## Requirements ⚙️  
+- **Node.js**: v14.x or higher (for CommonJS/ESM usage)  
+- **Browsers**: Modern browsers with support for Server-Sent Events (SSE)  
+
+---
+
+## Contributing 🤝  
+We welcome contributions! Please follow these steps:  
+1. Fork the repository  
+2. Create a feature branch (```git checkout -b feature/YourFeature```)  
+3. Commit your changes (```git commit -m "Add your feature"```)  
+4. Push to the branch (```git push origin feature/YourFeature```)  
+5. Open a Pull Request  
+
+---
+
+## License 📄  
+This project is licensed under the Cyphlens License. See the [LICENSE](https://cyphlens.com/legal/terms-and-conditions.html) file for details.
+
+
+

package/dist/index.esm.js

@@ -0,0 +1,115 @@
+var EventType;
+(function (EventType) {
+    EventType["MFASwipe"] = "MFA.SWIPE";
+    EventType["Disconnect"] = "DISCONNECT";
+})(EventType || (EventType = {}));
+var StatusType;
+(function (StatusType) {
+    StatusType["Pending"] = "PENDING";
+    StatusType["Success"] = "SUCCESS";
+    StatusType["Expired"] = "EXPIRED";
+})(StatusType || (StatusType = {}));
+
+class Cyphlens {
+    /**
+     * Initializes the Cyphlens service with a base URL.
+     * @param baseUrl The base API URL for connecting to the Cyphlens service.
+     */
+    constructor(baseUrl = "https://api.cyphme.com/b2c/v1") {
+        this.eventSource = null;
+        this.timeoutId = null;
+        /**
+         * Handles browser visibility changes to restart the SSE connection when the page becomes visible.
+         * This is primarily to prevent connection loss in Safari when the tab goes to the background.
+         */
+        this.onVisibilityChange = () => {
+            if (document.visibilityState === "visible" && this.sessionID) {
+                this.start();
+            }
+        };
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Updates the base API URL.
+     * @param baseUrl The new base URL.
+     */
+    setBaseUrl(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Starts the Server-Sent Events (SSE) connection to listen for authentication events.
+     * @returns The EventSource instance if successful, otherwise null.
+     */
+    start() {
+        if (!this.sessionID)
+            return null;
+        this.stop(); // Ensure any existing connections are closed before starting a new one.
+        this.eventSource = new EventSource(`${this.baseUrl}/cyphlens/status-events?sid=${this.sessionID}`);
+        // Listen for MFA swipe events
+        this.eventSource.addEventListener(EventType.MFASwipe, (event) => {
+            var _a, _b;
+            try {
+                const data = JSON.parse(event.data);
+                this.setupTimeout(data.expiresAt);
+                (_a = this.onSuccess) === null || _a === void 0 ? void 0 : _a.call(this, EventType.MFASwipe, data);
+            }
+            catch (error) {
+                console.error("Error parsing event data:", error);
+                const errorEvent = new Event('Something went wrong');
+                (_b = this.onError) === null || _b === void 0 ? void 0 : _b.call(this, errorEvent);
+            }
+        });
+        // Handle SSE errors
+        this.eventSource.addEventListener("error", (event) => {
+            var _a;
+            (_a = this.onError) === null || _a === void 0 ? void 0 : _a.call(this, event);
+            this.stop();
+        });
+        return this.eventSource;
+    }
+    /**
+     * Sets up a timeout to automatically stop the SSE connection when the event expires.
+     * @param expiresAt The expiration timestamp (milliseconds).
+     */
+    setupTimeout(expiresAt) {
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+        }
+        // Calculate timeout duration and add a buffer (5000ms) before stopping the connection.
+        const timeoutDuration = expiresAt - Date.now() + 5000;
+        this.timeoutId = setTimeout(() => this.stop(), timeoutDuration);
+    }
+    /**
+     * Starts listening for authentication events.
+     * @param sessionId The session ID used for authentication.
+     * @param onData Callback function for handling successful authentication events.
+     * @param onError Callback function for handling errors.
+     * @returns The EventSource instance if successfully started, otherwise null.
+     */
+    listen(sessionId, onData, onError) {
+        this.sessionID = sessionId;
+        this.onSuccess = onData;
+        this.onError = onError;
+        // Attach visibility change listener to handle browser background issues (especially for iOS Safari).
+        if (typeof document !== "undefined") {
+            document.addEventListener("visibilitychange", this.onVisibilityChange);
+        }
+        return this.start();
+    }
+    /**
+     * Stops the SSE connection and clears any active timeouts.
+     */
+    stop() {
+        if (this.eventSource) {
+            this.eventSource.close();
+            this.eventSource = null;
+        }
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = null;
+        }
+    }
+}
+
+export { Cyphlens, EventType, StatusType, Cyphlens as default };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/types.ts","../src/index.ts"],"sourcesContent":["export enum EventType {\n  MFASwipe = \"MFA.SWIPE\",\n  Disconnect = \"DISCONNECT\",\n}\n\nexport enum StatusType {\n  Pending = \"PENDING\",\n  Success = \"SUCCESS\",\n  Expired = \"EXPIRED\",\n}\n\nexport interface CyphlensEvent {}\n\nexport interface TwoFactorEvent extends CyphlensEvent  {  \n  sessionId: string;\n  status: StatusType;\n  timestamp: number;\n  expiresAt: number;\n}\n\nexport interface DisconnectEvent extends CyphlensEvent {\n  message: string;\n}\n\nexport type EventCallback = (eventType: EventType, data: CyphlensEvent) => void;\nexport type CyphlensErrorCallback = (error: Event) => void;\n","import { EventCallback, TwoFactorEvent, EventType, CyphlensErrorCallback, StatusType, DisconnectEvent, CyphlensEvent } from './types';\nexport { EventCallback, TwoFactorEvent, EventType, CyphlensErrorCallback, StatusType, DisconnectEvent, CyphlensEvent }\nexport class Cyphlens {\n  private baseUrl: string;\n  private eventSource: EventSource | null = null;\n  private sessionID?: string;\n  private onSuccess?: EventCallback;\n  private onError?: CyphlensErrorCallback;\n  private timeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  /**\n   * Initializes the Cyphlens service with a base URL.\n   * @param baseUrl The base API URL for connecting to the Cyphlens service.\n   */\n  constructor(baseUrl: string = \"https://api.cyphme.com/b2c/v1\") {\n    this.baseUrl = baseUrl;\n  }\n\n  /**\n   * Updates the base API URL.\n   * @param baseUrl The new base URL.\n   */\n  setBaseUrl(baseUrl: string): void {\n    this.baseUrl = baseUrl;\n  }\n\n  /**\n   * Starts the Server-Sent Events (SSE) connection to listen for authentication events.\n   * @returns The EventSource instance if successful, otherwise null.\n   */\n  private start(): EventSource | null {\n    if (!this.sessionID) return null;\n\n    this.stop(); // Ensure any existing connections are closed before starting a new one.\n\n    this.eventSource = new EventSource(`${this.baseUrl}/cyphlens/status-events?sid=${this.sessionID}`);\n\n    // Listen for MFA swipe events\n    this.eventSource.addEventListener(EventType.MFASwipe, (event: MessageEvent) => {\n      try {\n        const data: TwoFactorEvent = JSON.parse(event.data);\n        this.setupTimeout(data.expiresAt);\n        this.onSuccess?.(EventType.MFASwipe, data);\n      } catch (error) {\n        console.error(\"Error parsing event data:\", error);\n        const errorEvent = new Event('Something went wrong');\n        this.onError?.(errorEvent);\n      }\n    });\n\n    // Handle SSE errors\n    this.eventSource.addEventListener(\"error\", (event: Event) => {\n      this.onError?.(event);\n      this.stop();\n    });\n\n    return this.eventSource;\n  }\n\n  /**\n   * Sets up a timeout to automatically stop the SSE connection when the event expires.\n   * @param expiresAt The expiration timestamp (milliseconds).\n   */\n  private setupTimeout(expiresAt: number): void {\n    if (this.timeoutId) {\n      clearTimeout(this.timeoutId);\n    }\n\n    // Calculate timeout duration and add a buffer (5000ms) before stopping the connection.\n    const timeoutDuration = expiresAt - Date.now() + 5000;\n    this.timeoutId = setTimeout(() => this.stop(), timeoutDuration);\n  }\n\n  /**\n   * Starts listening for authentication events.\n   * @param sessionId The session ID used for authentication.\n   * @param onData Callback function for handling successful authentication events.\n   * @param onError Callback function for handling errors.\n   * @returns The EventSource instance if successfully started, otherwise null.\n   */\n  listen(sessionId: string, onData?: EventCallback, onError?: CyphlensErrorCallback): EventSource | null {\n    this.sessionID = sessionId;\n    this.onSuccess = onData;\n    this.onError = onError;\n\n    // Attach visibility change listener to handle browser background issues (especially for iOS Safari).\n    if (typeof document !== \"undefined\") {\n      document.addEventListener(\"visibilitychange\", this.onVisibilityChange);\n    }\n\n    return this.start();\n  }\n\n  /**\n   * Stops the SSE connection and clears any active timeouts.\n   */\n  stop(): void {\n    if (this.eventSource) {\n      this.eventSource.close();\n      this.eventSource = null;\n    }\n    if (this.timeoutId) {\n      clearTimeout(this.timeoutId);\n      this.timeoutId = null;\n    }\n  }\n\n  /**\n   * Handles browser visibility changes to restart the SSE connection when the page becomes visible.\n   * This is primarily to prevent connection loss in Safari when the tab goes to the background.\n   */\n  private readonly onVisibilityChange = (): void => {\n    if (document.visibilityState === \"visible\" && this.sessionID) {\n      this.start();\n    }\n  };\n}\n\nexport type CyphlensExports = {\n  Cyphlens: typeof Cyphlens;\n  EventType: typeof EventType;\n  StatusType: typeof StatusType;\n  TwoFactorEvent: TwoFactorEvent;\n  CyphlensEvent: CyphlensEvent;\n  DisconnectEvent: DisconnectEvent;\n  EventCallback: EventCallback;\n  CyphlensErrorCallback: CyphlensErrorCallback;\n};\n\nexport default Cyphlens;\n"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,120 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+exports.EventType = void 0;
+(function (EventType) {
+    EventType["MFASwipe"] = "MFA.SWIPE";
+    EventType["Disconnect"] = "DISCONNECT";
+})(exports.EventType || (exports.EventType = {}));
+exports.StatusType = void 0;
+(function (StatusType) {
+    StatusType["Pending"] = "PENDING";
+    StatusType["Success"] = "SUCCESS";
+    StatusType["Expired"] = "EXPIRED";
+})(exports.StatusType || (exports.StatusType = {}));
+
+class Cyphlens {
+    /**
+     * Initializes the Cyphlens service with a base URL.
+     * @param baseUrl The base API URL for connecting to the Cyphlens service.
+     */
+    constructor(baseUrl = "https://api.cyphme.com/b2c/v1") {
+        this.eventSource = null;
+        this.timeoutId = null;
+        /**
+         * Handles browser visibility changes to restart the SSE connection when the page becomes visible.
+         * This is primarily to prevent connection loss in Safari when the tab goes to the background.
+         */
+        this.onVisibilityChange = () => {
+            if (document.visibilityState === "visible" && this.sessionID) {
+                this.start();
+            }
+        };
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Updates the base API URL.
+     * @param baseUrl The new base URL.
+     */
+    setBaseUrl(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Starts the Server-Sent Events (SSE) connection to listen for authentication events.
+     * @returns The EventSource instance if successful, otherwise null.
+     */
+    start() {
+        if (!this.sessionID)
+            return null;
+        this.stop(); // Ensure any existing connections are closed before starting a new one.
+        this.eventSource = new EventSource(`${this.baseUrl}/cyphlens/status-events?sid=${this.sessionID}`);
+        // Listen for MFA swipe events
+        this.eventSource.addEventListener(exports.EventType.MFASwipe, (event) => {
+            var _a, _b;
+            try {
+                const data = JSON.parse(event.data);
+                this.setupTimeout(data.expiresAt);
+                (_a = this.onSuccess) === null || _a === void 0 ? void 0 : _a.call(this, exports.EventType.MFASwipe, data);
+            }
+            catch (error) {
+                console.error("Error parsing event data:", error);
+                const errorEvent = new Event('Something went wrong');
+                (_b = this.onError) === null || _b === void 0 ? void 0 : _b.call(this, errorEvent);
+            }
+        });
+        // Handle SSE errors
+        this.eventSource.addEventListener("error", (event) => {
+            var _a;
+            (_a = this.onError) === null || _a === void 0 ? void 0 : _a.call(this, event);
+            this.stop();
+        });
+        return this.eventSource;
+    }
+    /**
+     * Sets up a timeout to automatically stop the SSE connection when the event expires.
+     * @param expiresAt The expiration timestamp (milliseconds).
+     */
+    setupTimeout(expiresAt) {
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+        }
+        // Calculate timeout duration and add a buffer (5000ms) before stopping the connection.
+        const timeoutDuration = expiresAt - Date.now() + 5000;
+        this.timeoutId = setTimeout(() => this.stop(), timeoutDuration);
+    }
+    /**
+     * Starts listening for authentication events.
+     * @param sessionId The session ID used for authentication.
+     * @param onData Callback function for handling successful authentication events.
+     * @param onError Callback function for handling errors.
+     * @returns The EventSource instance if successfully started, otherwise null.
+     */
+    listen(sessionId, onData, onError) {
+        this.sessionID = sessionId;
+        this.onSuccess = onData;
+        this.onError = onError;
+        // Attach visibility change listener to handle browser background issues (especially for iOS Safari).
+        if (typeof document !== "undefined") {
+            document.addEventListener("visibilitychange", this.onVisibilityChange);
+        }
+        return this.start();
+    }
+    /**
+     * Stops the SSE connection and clears any active timeouts.
+     */
+    stop() {
+        if (this.eventSource) {
+            this.eventSource.close();
+            this.eventSource = null;
+        }
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = null;
+        }
+    }
+}
+
+exports.Cyphlens = Cyphlens;
+exports.default = Cyphlens;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/types.ts","../src/index.ts"],"sourcesContent":["export enum EventType {\n  MFASwipe = \"MFA.SWIPE\",\n  Disconnect = \"DISCONNECT\",\n}\n\nexport enum StatusType {\n  Pending = \"PENDING\",\n  Success = \"SUCCESS\",\n  Expired = \"EXPIRED\",\n}\n\nexport interface CyphlensEvent {}\n\nexport interface TwoFactorEvent extends CyphlensEvent  {  \n  sessionId: string;\n  status: StatusType;\n  timestamp: number;\n  expiresAt: number;\n}\n\nexport interface DisconnectEvent extends CyphlensEvent {\n  message: string;\n}\n\nexport type EventCallback = (eventType: EventType, data: CyphlensEvent) => void;\nexport type CyphlensErrorCallback = (error: Event) => void;\n","import { EventCallback, TwoFactorEvent, EventType, CyphlensErrorCallback, StatusType, DisconnectEvent, CyphlensEvent } from './types';\nexport { EventCallback, TwoFactorEvent, EventType, CyphlensErrorCallback, StatusType, DisconnectEvent, CyphlensEvent }\nexport class Cyphlens {\n  private baseUrl: string;\n  private eventSource: EventSource | null = null;\n  private sessionID?: string;\n  private onSuccess?: EventCallback;\n  private onError?: CyphlensErrorCallback;\n  private timeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  /**\n   * Initializes the Cyphlens service with a base URL.\n   * @param baseUrl The base API URL for connecting to the Cyphlens service.\n   */\n  constructor(baseUrl: string = \"https://api.cyphme.com/b2c/v1\") {\n    this.baseUrl = baseUrl;\n  }\n\n  /**\n   * Updates the base API URL.\n   * @param baseUrl The new base URL.\n   */\n  setBaseUrl(baseUrl: string): void {\n    this.baseUrl = baseUrl;\n  }\n\n  /**\n   * Starts the Server-Sent Events (SSE) connection to listen for authentication events.\n   * @returns The EventSource instance if successful, otherwise null.\n   */\n  private start(): EventSource | null {\n    if (!this.sessionID) return null;\n\n    this.stop(); // Ensure any existing connections are closed before starting a new one.\n\n    this.eventSource = new EventSource(`${this.baseUrl}/cyphlens/status-events?sid=${this.sessionID}`);\n\n    // Listen for MFA swipe events\n    this.eventSource.addEventListener(EventType.MFASwipe, (event: MessageEvent) => {\n      try {\n        const data: TwoFactorEvent = JSON.parse(event.data);\n        this.setupTimeout(data.expiresAt);\n        this.onSuccess?.(EventType.MFASwipe, data);\n      } catch (error) {\n        console.error(\"Error parsing event data:\", error);\n        const errorEvent = new Event('Something went wrong');\n        this.onError?.(errorEvent);\n      }\n    });\n\n    // Handle SSE errors\n    this.eventSource.addEventListener(\"error\", (event: Event) => {\n      this.onError?.(event);\n      this.stop();\n    });\n\n    return this.eventSource;\n  }\n\n  /**\n   * Sets up a timeout to automatically stop the SSE connection when the event expires.\n   * @param expiresAt The expiration timestamp (milliseconds).\n   */\n  private setupTimeout(expiresAt: number): void {\n    if (this.timeoutId) {\n      clearTimeout(this.timeoutId);\n    }\n\n    // Calculate timeout duration and add a buffer (5000ms) before stopping the connection.\n    const timeoutDuration = expiresAt - Date.now() + 5000;\n    this.timeoutId = setTimeout(() => this.stop(), timeoutDuration);\n  }\n\n  /**\n   * Starts listening for authentication events.\n   * @param sessionId The session ID used for authentication.\n   * @param onData Callback function for handling successful authentication events.\n   * @param onError Callback function for handling errors.\n   * @returns The EventSource instance if successfully started, otherwise null.\n   */\n  listen(sessionId: string, onData?: EventCallback, onError?: CyphlensErrorCallback): EventSource | null {\n    this.sessionID = sessionId;\n    this.onSuccess = onData;\n    this.onError = onError;\n\n    // Attach visibility change listener to handle browser background issues (especially for iOS Safari).\n    if (typeof document !== \"undefined\") {\n      document.addEventListener(\"visibilitychange\", this.onVisibilityChange);\n    }\n\n    return this.start();\n  }\n\n  /**\n   * Stops the SSE connection and clears any active timeouts.\n   */\n  stop(): void {\n    if (this.eventSource) {\n      this.eventSource.close();\n      this.eventSource = null;\n    }\n    if (this.timeoutId) {\n      clearTimeout(this.timeoutId);\n      this.timeoutId = null;\n    }\n  }\n\n  /**\n   * Handles browser visibility changes to restart the SSE connection when the page becomes visible.\n   * This is primarily to prevent connection loss in Safari when the tab goes to the background.\n   */\n  private readonly onVisibilityChange = (): void => {\n    if (document.visibilityState === \"visible\" && this.sessionID) {\n      this.start();\n    }\n  };\n}\n\nexport type CyphlensExports = {\n  Cyphlens: typeof Cyphlens;\n  EventType: typeof EventType;\n  StatusType: typeof StatusType;\n  TwoFactorEvent: TwoFactorEvent;\n  CyphlensEvent: CyphlensEvent;\n  DisconnectEvent: DisconnectEvent;\n  EventCallback: EventCallback;\n  CyphlensErrorCallback: CyphlensErrorCallback;\n};\n\nexport default Cyphlens;\n"],"names":["EventType","StatusType"],"mappings":"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"}

package/dist/index.umd.js

@@ -0,0 +1,126 @@
+(function (global, factory) {
+  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+  typeof define === 'function' && define.amd ? define(['exports'], factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.CyphlensSSE = {}));
+})(this, (function (exports) { 'use strict';
+
+  exports.EventType = void 0;
+  (function (EventType) {
+      EventType["MFASwipe"] = "MFA.SWIPE";
+      EventType["Disconnect"] = "DISCONNECT";
+  })(exports.EventType || (exports.EventType = {}));
+  exports.StatusType = void 0;
+  (function (StatusType) {
+      StatusType["Pending"] = "PENDING";
+      StatusType["Success"] = "SUCCESS";
+      StatusType["Expired"] = "EXPIRED";
+  })(exports.StatusType || (exports.StatusType = {}));
+
+  class Cyphlens {
+      /**
+       * Initializes the Cyphlens service with a base URL.
+       * @param baseUrl The base API URL for connecting to the Cyphlens service.
+       */
+      constructor(baseUrl = "https://api.cyphme.com/b2c/v1") {
+          this.eventSource = null;
+          this.timeoutId = null;
+          /**
+           * Handles browser visibility changes to restart the SSE connection when the page becomes visible.
+           * This is primarily to prevent connection loss in Safari when the tab goes to the background.
+           */
+          this.onVisibilityChange = () => {
+              if (document.visibilityState === "visible" && this.sessionID) {
+                  this.start();
+              }
+          };
+          this.baseUrl = baseUrl;
+      }
+      /**
+       * Updates the base API URL.
+       * @param baseUrl The new base URL.
+       */
+      setBaseUrl(baseUrl) {
+          this.baseUrl = baseUrl;
+      }
+      /**
+       * Starts the Server-Sent Events (SSE) connection to listen for authentication events.
+       * @returns The EventSource instance if successful, otherwise null.
+       */
+      start() {
+          if (!this.sessionID)
+              return null;
+          this.stop(); // Ensure any existing connections are closed before starting a new one.
+          this.eventSource = new EventSource(`${this.baseUrl}/cyphlens/status-events?sid=${this.sessionID}`);
+          // Listen for MFA swipe events
+          this.eventSource.addEventListener(exports.EventType.MFASwipe, (event) => {
+              var _a, _b;
+              try {
+                  const data = JSON.parse(event.data);
+                  this.setupTimeout(data.expiresAt);
+                  (_a = this.onSuccess) === null || _a === void 0 ? void 0 : _a.call(this, exports.EventType.MFASwipe, data);
+              }
+              catch (error) {
+                  console.error("Error parsing event data:", error);
+                  const errorEvent = new Event('Something went wrong');
+                  (_b = this.onError) === null || _b === void 0 ? void 0 : _b.call(this, errorEvent);
+              }
+          });
+          // Handle SSE errors
+          this.eventSource.addEventListener("error", (event) => {
+              var _a;
+              (_a = this.onError) === null || _a === void 0 ? void 0 : _a.call(this, event);
+              this.stop();
+          });
+          return this.eventSource;
+      }
+      /**
+       * Sets up a timeout to automatically stop the SSE connection when the event expires.
+       * @param expiresAt The expiration timestamp (milliseconds).
+       */
+      setupTimeout(expiresAt) {
+          if (this.timeoutId) {
+              clearTimeout(this.timeoutId);
+          }
+          // Calculate timeout duration and add a buffer (5000ms) before stopping the connection.
+          const timeoutDuration = expiresAt - Date.now() + 5000;
+          this.timeoutId = setTimeout(() => this.stop(), timeoutDuration);
+      }
+      /**
+       * Starts listening for authentication events.
+       * @param sessionId The session ID used for authentication.
+       * @param onData Callback function for handling successful authentication events.
+       * @param onError Callback function for handling errors.
+       * @returns The EventSource instance if successfully started, otherwise null.
+       */
+      listen(sessionId, onData, onError) {
+          this.sessionID = sessionId;
+          this.onSuccess = onData;
+          this.onError = onError;
+          // Attach visibility change listener to handle browser background issues (especially for iOS Safari).
+          if (typeof document !== "undefined") {
+              document.addEventListener("visibilitychange", this.onVisibilityChange);
+          }
+          return this.start();
+      }
+      /**
+       * Stops the SSE connection and clears any active timeouts.
+       */
+      stop() {
+          if (this.eventSource) {
+              this.eventSource.close();
+              this.eventSource = null;
+          }
+          if (this.timeoutId) {
+              clearTimeout(this.timeoutId);
+              this.timeoutId = null;
+          }
+      }
+  }
+
+  exports.Cyphlens = Cyphlens;
+  exports.default = Cyphlens;
+
+  Object.defineProperty(exports, '__esModule', { value: true });
+
+}));
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../src/types.ts","../src/index.ts"],"sourcesContent":["export enum EventType {\n  MFASwipe = \"MFA.SWIPE\",\n  Disconnect = \"DISCONNECT\",\n}\n\nexport enum StatusType {\n  Pending = \"PENDING\",\n  Success = \"SUCCESS\",\n  Expired = \"EXPIRED\",\n}\n\nexport interface CyphlensEvent {}\n\nexport interface TwoFactorEvent extends CyphlensEvent  {  \n  sessionId: string;\n  status: StatusType;\n  timestamp: number;\n  expiresAt: number;\n}\n\nexport interface DisconnectEvent extends CyphlensEvent {\n  message: string;\n}\n\nexport type EventCallback = (eventType: EventType, data: CyphlensEvent) => void;\nexport type CyphlensErrorCallback = (error: Event) => void;\n","import { EventCallback, TwoFactorEvent, EventType, CyphlensErrorCallback, StatusType, DisconnectEvent, CyphlensEvent } from './types';\nexport { EventCallback, TwoFactorEvent, EventType, CyphlensErrorCallback, StatusType, DisconnectEvent, CyphlensEvent }\nexport class Cyphlens {\n  private baseUrl: string;\n  private eventSource: EventSource | null = null;\n  private sessionID?: string;\n  private onSuccess?: EventCallback;\n  private onError?: CyphlensErrorCallback;\n  private timeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  /**\n   * Initializes the Cyphlens service with a base URL.\n   * @param baseUrl The base API URL for connecting to the Cyphlens service.\n   */\n  constructor(baseUrl: string = \"https://api.cyphme.com/b2c/v1\") {\n    this.baseUrl = baseUrl;\n  }\n\n  /**\n   * Updates the base API URL.\n   * @param baseUrl The new base URL.\n   */\n  setBaseUrl(baseUrl: string): void {\n    this.baseUrl = baseUrl;\n  }\n\n  /**\n   * Starts the Server-Sent Events (SSE) connection to listen for authentication events.\n   * @returns The EventSource instance if successful, otherwise null.\n   */\n  private start(): EventSource | null {\n    if (!this.sessionID) return null;\n\n    this.stop(); // Ensure any existing connections are closed before starting a new one.\n\n    this.eventSource = new EventSource(`${this.baseUrl}/cyphlens/status-events?sid=${this.sessionID}`);\n\n    // Listen for MFA swipe events\n    this.eventSource.addEventListener(EventType.MFASwipe, (event: MessageEvent) => {\n      try {\n        const data: TwoFactorEvent = JSON.parse(event.data);\n        this.setupTimeout(data.expiresAt);\n        this.onSuccess?.(EventType.MFASwipe, data);\n      } catch (error) {\n        console.error(\"Error parsing event data:\", error);\n        const errorEvent = new Event('Something went wrong');\n        this.onError?.(errorEvent);\n      }\n    });\n\n    // Handle SSE errors\n    this.eventSource.addEventListener(\"error\", (event: Event) => {\n      this.onError?.(event);\n      this.stop();\n    });\n\n    return this.eventSource;\n  }\n\n  /**\n   * Sets up a timeout to automatically stop the SSE connection when the event expires.\n   * @param expiresAt The expiration timestamp (milliseconds).\n   */\n  private setupTimeout(expiresAt: number): void {\n    if (this.timeoutId) {\n      clearTimeout(this.timeoutId);\n    }\n\n    // Calculate timeout duration and add a buffer (5000ms) before stopping the connection.\n    const timeoutDuration = expiresAt - Date.now() + 5000;\n    this.timeoutId = setTimeout(() => this.stop(), timeoutDuration);\n  }\n\n  /**\n   * Starts listening for authentication events.\n   * @param sessionId The session ID used for authentication.\n   * @param onData Callback function for handling successful authentication events.\n   * @param onError Callback function for handling errors.\n   * @returns The EventSource instance if successfully started, otherwise null.\n   */\n  listen(sessionId: string, onData?: EventCallback, onError?: CyphlensErrorCallback): EventSource | null {\n    this.sessionID = sessionId;\n    this.onSuccess = onData;\n    this.onError = onError;\n\n    // Attach visibility change listener to handle browser background issues (especially for iOS Safari).\n    if (typeof document !== \"undefined\") {\n      document.addEventListener(\"visibilitychange\", this.onVisibilityChange);\n    }\n\n    return this.start();\n  }\n\n  /**\n   * Stops the SSE connection and clears any active timeouts.\n   */\n  stop(): void {\n    if (this.eventSource) {\n      this.eventSource.close();\n      this.eventSource = null;\n    }\n    if (this.timeoutId) {\n      clearTimeout(this.timeoutId);\n      this.timeoutId = null;\n    }\n  }\n\n  /**\n   * Handles browser visibility changes to restart the SSE connection when the page becomes visible.\n   * This is primarily to prevent connection loss in Safari when the tab goes to the background.\n   */\n  private readonly onVisibilityChange = (): void => {\n    if (document.visibilityState === \"visible\" && this.sessionID) {\n      this.start();\n    }\n  };\n}\n\nexport type CyphlensExports = {\n  Cyphlens: typeof Cyphlens;\n  EventType: typeof EventType;\n  StatusType: typeof StatusType;\n  TwoFactorEvent: TwoFactorEvent;\n  CyphlensEvent: CyphlensEvent;\n  DisconnectEvent: DisconnectEvent;\n  EventCallback: EventCallback;\n  CyphlensErrorCallback: CyphlensErrorCallback;\n};\n\nexport default Cyphlens;\n"],"names":["EventType","StatusType"],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,59 @@
+import { EventCallback, TwoFactorEvent, EventType, CyphlensErrorCallback, StatusType, DisconnectEvent, CyphlensEvent } from './types';
+export { EventCallback, TwoFactorEvent, EventType, CyphlensErrorCallback, StatusType, DisconnectEvent, CyphlensEvent };
+export declare class Cyphlens {
+    private baseUrl;
+    private eventSource;
+    private sessionID?;
+    private onSuccess?;
+    private onError?;
+    private timeoutId;
+    /**
+     * Initializes the Cyphlens service with a base URL.
+     * @param baseUrl The base API URL for connecting to the Cyphlens service.
+     */
+    constructor(baseUrl?: string);
+    /**
+     * Updates the base API URL.
+     * @param baseUrl The new base URL.
+     */
+    setBaseUrl(baseUrl: string): void;
+    /**
+     * Starts the Server-Sent Events (SSE) connection to listen for authentication events.
+     * @returns The EventSource instance if successful, otherwise null.
+     */
+    private start;
+    /**
+     * Sets up a timeout to automatically stop the SSE connection when the event expires.
+     * @param expiresAt The expiration timestamp (milliseconds).
+     */
+    private setupTimeout;
+    /**
+     * Starts listening for authentication events.
+     * @param sessionId The session ID used for authentication.
+     * @param onData Callback function for handling successful authentication events.
+     * @param onError Callback function for handling errors.
+     * @returns The EventSource instance if successfully started, otherwise null.
+     */
+    listen(sessionId: string, onData?: EventCallback, onError?: CyphlensErrorCallback): EventSource | null;
+    /**
+     * Stops the SSE connection and clears any active timeouts.
+     */
+    stop(): void;
+    /**
+     * Handles browser visibility changes to restart the SSE connection when the page becomes visible.
+     * This is primarily to prevent connection loss in Safari when the tab goes to the background.
+     */
+    private readonly onVisibilityChange;
+}
+export type CyphlensExports = {
+    Cyphlens: typeof Cyphlens;
+    EventType: typeof EventType;
+    StatusType: typeof StatusType;
+    TwoFactorEvent: TwoFactorEvent;
+    CyphlensEvent: CyphlensEvent;
+    DisconnectEvent: DisconnectEvent;
+    EventCallback: EventCallback;
+    CyphlensErrorCallback: CyphlensErrorCallback;
+};
+export default Cyphlens;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,qBAAqB,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtI,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,qBAAqB,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,CAAA;AACtH,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAgB;IAClC,OAAO,CAAC,OAAO,CAAC,CAAwB;IACxC,OAAO,CAAC,SAAS,CAA8C;IAE/D;;;OAGG;gBACS,OAAO,GAAE,MAAwC;IAI7D;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;;OAGG;IACH,OAAO,CAAC,KAAK;IA6Bb;;;OAGG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,WAAW,GAAG,IAAI;IAatG;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAIjC;CACH;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,qBAAqB,EAAE,qBAAqB,CAAC;CAC9C,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/types/types.d.ts

@@ -0,0 +1,23 @@
+export declare enum EventType {
+    MFASwipe = "MFA.SWIPE",
+    Disconnect = "DISCONNECT"
+}
+export declare enum StatusType {
+    Pending = "PENDING",
+    Success = "SUCCESS",
+    Expired = "EXPIRED"
+}
+export interface CyphlensEvent {
+}
+export interface TwoFactorEvent extends CyphlensEvent {
+    sessionId: string;
+    status: StatusType;
+    timestamp: number;
+    expiresAt: number;
+}
+export interface DisconnectEvent extends CyphlensEvent {
+    message: string;
+}
+export type EventCallback = (eventType: EventType, data: CyphlensEvent) => void;
+export type CyphlensErrorCallback = (error: Event) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IACnB,QAAQ,cAAc;IACtB,UAAU,eAAe;CAC1B;AAED,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,aAAa;CAAG;AAEjC,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;AAChF,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@cyphlens/2fa-sse-sdk",
+  "version": "1.0.1",
+  "private": false,
+  "description": "Cyphlens SDK for 2FA SSE",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "browser":  "dist/index.umd.js",
+  "types": "dist/types/index.d.ts",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "test": "jest --coverage"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.3",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@types/jest": "^29.5.14",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "jsdom": "^25.0.1",
+    "rollup": "^4.24.0",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "ts-jest": "^29.2.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3"
+  },
+  "keywords": [
+    "2fa",
+    "sse",
+    "cyphlens",
+    "sdk"
+  ],
+  "author": "Cyphlens",
+  "license": "ISC",
+  "dependencies": {
+    "eventsource": "^2.0.2"
+  }
+}