@cshah18/sdk 3.0.4 → 3.0.5

package/dist/types/core/socket-client.d.ts

@@ -0,0 +1,126 @@
+import { InternalConfig } from "./types";
+export interface GroupPayload {
+    id: string;
+    group_name: string;
+    participants_count: number;
+    max_participants: number;
+    status: string;
+    expiry_at: Date | string;
+    timeLeftSeconds: number;
+}
+export interface MembershipPayload {
+    id: string;
+    session_id: string;
+    created_at: Date | string;
+}
+export interface GroupMemberJoinedPayload {
+    group: GroupPayload;
+    membership: MembershipPayload;
+    product_id?: string;
+    isPrimary?: boolean;
+}
+export interface GroupCreatedPayload {
+    group: GroupPayload;
+    membership: MembershipPayload;
+    product_id?: string;
+}
+export interface GroupFulfilledPayload {
+    group: GroupPayload;
+    frozen_reward: unknown;
+    product_id?: string | null;
+}
+export interface SocketClientConfig {
+    serverUrl: string;
+    merchantKey?: string;
+    sdkVersion?: string;
+    sessionId?: string;
+    debug?: boolean;
+}
+export interface SocketEventHandlers {
+    onGroupMemberJoined?: (payload: GroupMemberJoinedPayload) => void;
+    onGroupCreated?: (payload: GroupCreatedPayload) => void;
+    onGroupFulfilled?: (payload: GroupFulfilledPayload) => void;
+    onConnect?: () => void;
+    onDisconnect?: (reason: string) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Frontend Socket.IO client for real-time group updates
+ * Manages connection to the backend /sdk namespace and handles group subscriptions
+ */
+export declare class SocketClient {
+    private socket;
+    private logger;
+    private config;
+    private handlers;
+    private currentGroupId;
+    private currentProductId;
+    private maxReconnectAttempts;
+    constructor(config: SocketClientConfig);
+    /**
+     * Connect to the Socket.IO server
+     * @param handlers - Event handlers for socket events
+     */
+    connect(handlers: SocketEventHandlers): Promise<void>;
+    /**
+     * Register event listeners for group updates
+     */
+    private registerEventListeners;
+    /**
+     * Subscribe to a specific group's updates
+     * @param groupId - The group ID to subscribe to
+     */
+    subscribeToGroup(groupId: string): void;
+    /**
+     * Unsubscribe from a specific group's updates
+     * @param groupId - The group ID to unsubscribe from
+     */
+    unsubscribeFromGroup(groupId: string): void;
+    /**
+     * Subscribe to product availability updates (groups being created for the product)
+     * @param productId - The product ID to watch for
+     */
+    subscribeToProductAvailable(productId: string): void;
+    /**
+     * Unsubscribe from product availability updates
+     * @param productId - The product ID to stop watching
+     */
+    unsubscribeFromProductAvailable(productId: string): void;
+    /**
+     * Check if socket is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get current socket ID
+     */
+    getSocketId(): string | null;
+    /**
+     * Get currently subscribed group ID
+     */
+    getCurrentGroupId(): string | null;
+    /**
+     * Get currently subscribed product ID
+     */
+    getCurrentProductId(): string | null;
+    /**
+     * Disconnect from the server
+     */
+    disconnect(): void;
+    /**
+     * Force reconnection to the server
+     */
+    reconnect(): void;
+    /**
+     * Update authentication credentials
+     * @param merchantKey - New merchant key
+     */
+    updateAuth(merchantKey: string): void;
+}
+/**
+ * Create a socket client from SDK config
+ * @param config - Internal SDK configuration
+ * @param sdkVersion - SDK version
+ * @param sessionId - Session ID from CoBuy instance
+ * @returns Configured SocketClient instance
+ */
+export declare function createSocketClient(config: InternalConfig, sdkVersion: string, sessionId: string): SocketClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cshah18/sdk",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "description": "CoBuy Embedded SDK for browser JavaScript integration",
   "type": "module",
   "main": "dist/cobuy-sdk.umd.js",

package/dist/types/core/group-channel-manager.d.ts

@@ -1,74 +0,0 @@
-import { InternalConfig, GroupFulfilledEvent, Reward } from "./types";
-export interface GroupRealtimeSnapshot {
-    groupId: string;
-    productId: string;
-    participants: number;
-    maxParticipants?: number;
-    progressPercent?: number;
-    expiresAt?: string;
-    reward?: Reward | null;
-    status?: string;
-    timeLeftSeconds?: number;
-}
-export type GroupChannelEvent = {
-    type: "update";
-    snapshot: GroupRealtimeSnapshot;
-} | {
-    type: "fulfilled";
-    snapshot: GroupRealtimeSnapshot;
-};
-export type GroupChannelListener = (event: GroupChannelEvent) => void;
-/**
- * Centralized real-time channel manager for all group-aware UI surfaces.
- * Ensures a single socket connection, one room subscription per group, and
- * shared event dispatch to interested listeners.
- */
-export declare class GroupChannelManager {
-    private readonly config;
-    private readonly sdkVersion;
-    private readonly onFulfilledCallback?;
-    private socket;
-    private readonly logger;
-    private readonly listeners;
-    private readonly groupRefCount;
-    private readonly groupToProduct;
-    private readonly latestByGroup;
-    private readonly latestByProduct;
-    private isConnecting;
-    constructor(config: InternalConfig, sdkVersion: string, onFulfilledCallback?: ((event: GroupFulfilledEvent) => void) | undefined);
-    /**
-     * Start socket connection if not already connected.
-     */
-    connect(): void;
-    /**
-     * Subscribe to realtime updates for a group. Multiple callers are reference-counted.
-     */
-    subscribeToGroup(groupId: string, productId: string): void;
-    /**
-     * Unsubscribe from a group when no listeners remain.
-     */
-    unsubscribeFromGroup(groupId: string): void;
-    /**
-     * Switch from one group room to another, ensuring only one active subscription.
-     */
-    switchGroup(oldGroupId: string | null, newGroupId: string, productId: string): void;
-    /**
-     * Register for realtime events. Returns an unsubscribe function.
-     */
-    addListener(listener: GroupChannelListener): () => void;
-    /**
-     * Retrieve the latest snapshot for a product if one exists.
-     */
-    getLatestSnapshotForProduct(productId: string): GroupRealtimeSnapshot | null;
-    /**
-     * Disconnect and clear state.
-     */
-    disconnect(): void;
-    private handleGroupUpdate;
-    private handleGroupFulfilled;
-    private cacheSnapshot;
-    private broadcast;
-    private normalizeSnapshot;
-    private pickString;
-    private pickNumber;
-}