@pocketping/sdk-node 1.8.0 → 1.9.0

package/dist/index.cjs

@@ -1897,6 +1897,12 @@ var PocketPing = class {
           case "delete":
             result = await this.handleDeleteMessage(body);
             break;
+          case "disconnect":
+            result = await this.handleDisconnect(body);
+            break;
+          case "visibility":
+            result = await this.handleVisibility(body);
+            break;
           default:
             if (next) {
               next();
@@ -2217,6 +2223,58 @@ var PocketPing = class {
     this.forwardIdentityToWebhook(session);
     return { ok: true };
   }
+  /**
+   * Handle visitor disconnect (page unload or inactivity)
+   * Notifies bridges and triggers callback
+   */
+  async handleDisconnect(request) {
+    const session = await this.storage.getSession(request.sessionId);
+    if (!session) {
+      throw new Error("Session not found");
+    }
+    const formatDuration = (seconds) => {
+      if (seconds < 60) return `${seconds}s`;
+      if (seconds < 3600) return `${Math.floor(seconds / 60)} min`;
+      const hours = Math.floor(seconds / 3600);
+      const mins = Math.floor(seconds % 3600 / 60);
+      return mins > 0 ? `${hours}h ${mins}min` : `${hours}h`;
+    };
+    const visitorName = session.identity?.name || session.identity?.email?.split("@")[0] || "Visitor";
+    const durationText = formatDuration(request.duration);
+    const message = `\u{1F44B} ${visitorName} left (was here for ${durationText})`;
+    await this.notifyBridgesDisconnect(session, message);
+    await this.config.onVisitorDisconnect?.(session, request.duration);
+    return { ok: true };
+  }
+  /**
+   * Handle visibility change (tab focus/blur)
+   * Used for inactivity tracking
+   */
+  async handleVisibility(request) {
+    const session = await this.storage.getSession(request.sessionId);
+    if (!session) {
+      throw new Error("Session not found");
+    }
+    if (request.state === "visible") {
+      session.lastActivity = /* @__PURE__ */ new Date();
+      await this.storage.updateSession(session);
+    }
+    return { ok: true };
+  }
+  /**
+   * Notify all bridges when visitor disconnects
+   */
+  async notifyBridgesDisconnect(session, message) {
+    for (const bridge of this.bridges) {
+      try {
+        if ("notifyDisconnect" in bridge && typeof bridge.notifyDisconnect === "function") {
+          await bridge.notifyDisconnect(session, message);
+        }
+      } catch (error) {
+        console.error(`[PocketPing] Bridge disconnect notification failed:`, error);
+      }
+    }
+  }
   /**
    * Get a session by ID
    */

package/dist/index.d.cts

@@ -63,6 +63,20 @@ declare class PocketPing {
      * Called when visitor calls PocketPing.identify()
      */
     handleIdentify(request: IdentifyRequest): Promise<IdentifyResponse>;
+    /**
+     * Handle visitor disconnect (page unload or inactivity)
+     * Notifies bridges and triggers callback
+     */
+    handleDisconnect(request: DisconnectRequest): Promise<DisconnectResponse>;
+    /**
+     * Handle visibility change (tab focus/blur)
+     * Used for inactivity tracking
+     */
+    handleVisibility(request: VisibilityRequest): Promise<VisibilityResponse>;
+    /**
+     * Notify all bridges when visitor disconnects
+     */
+    private notifyBridgesDisconnect;
     /**
      * Get a session by ID
      */
@@ -384,6 +398,8 @@ interface PocketPingConfig {
     welcomeMessage?: string;
     /** Seconds of inactivity before AI takes over (default: 300) */
     aiTakeoverDelay?: number;
+    /** Seconds of visitor inactivity before notifying bridges (0 = disabled) */
+    visitorInactivityTimeout?: number;
     /** Callback when a new session is created */
     onNewSession?: (session: Session) => void | Promise<void>;
     /** Callback when a message is received */
@@ -392,6 +408,8 @@ interface PocketPingConfig {
     onEvent?: (event: CustomEvent, session: Session) => void | Promise<void>;
     /** Callback when a user identifies themselves */
     onIdentify?: (session: Session) => void | Promise<void>;
+    /** Callback when a visitor disconnects (leaves the page or goes inactive) */
+    onVisitorDisconnect?: (session: Session, duration: number) => void | Promise<void>;
     /** Webhook URL to forward custom events (Zapier, Make, n8n, etc.) */
     webhookUrl?: string;
     /** Secret key for HMAC-SHA256 signature (X-PocketPing-Signature header) */
@@ -602,6 +620,22 @@ interface IdentifyRequest {
 interface IdentifyResponse {
     ok: boolean;
 }
+interface DisconnectRequest {
+    sessionId: string;
+    duration: number;
+    reason: 'page_unload' | 'inactivity' | 'manual';
+}
+interface DisconnectResponse {
+    ok: boolean;
+}
+interface VisibilityRequest {
+    sessionId: string;
+    state: 'hidden' | 'visible';
+    timestamp: number;
+}
+interface VisibilityResponse {
+    ok: boolean;
+}
 interface PresenceResponse {
     online: boolean;
     operators?: Array<{
@@ -1065,4 +1099,4 @@ declare class WebhookHandler {
     private getSlackUserName;
 }
 
-export { type AIProvider, type Bridge, type BridgeMessageIds, type BridgeMessageResult, type ConnectRequest, type ConnectResponse, type CustomEvent, type CustomEventHandler, DEFAULT_BOT_PATTERNS, type DeleteMessageRequest, type DeleteMessageResponse, type DiscordBotOptions, DiscordBridge, type DiscordWebhookOptions, type EditMessageRequest, type EditMessageResponse, type IpFilterConfig, type IpFilterLogEvent, type IpFilterMode, MemoryStorage, type Message, type OperatorAttachment, type OperatorMessageCallback, type OperatorMessageDeleteCallback, type OperatorMessageEditCallback, PocketPing, type PocketPingConfig, type PresenceResponse, type SendMessageRequest, type SendMessageResponse, type Session, type SlackBotOptions, SlackBridge, type SlackWebhookOptions, type Storage, TelegramBridge, type TelegramBridgeOptions, type TrackedElement, type TriggerOptions, type UaFilterConfig, type UaFilterLogEvent, type UaFilterMode, type UaFilterReason, type UaFilterResult, type WebhookConfig, WebhookHandler, type WebhookPayload, checkIpFilter, checkUaFilter, ipMatchesAny, ipMatchesCidr, isBot, matchesAnyPattern };
+export { type AIProvider, type Bridge, type BridgeMessageIds, type BridgeMessageResult, type ConnectRequest, type ConnectResponse, type CustomEvent, type CustomEventHandler, DEFAULT_BOT_PATTERNS, type DeleteMessageRequest, type DeleteMessageResponse, type DisconnectRequest, type DisconnectResponse, type DiscordBotOptions, DiscordBridge, type DiscordWebhookOptions, type EditMessageRequest, type EditMessageResponse, type IpFilterConfig, type IpFilterLogEvent, type IpFilterMode, MemoryStorage, type Message, type OperatorAttachment, type OperatorMessageCallback, type OperatorMessageDeleteCallback, type OperatorMessageEditCallback, PocketPing, type PocketPingConfig, type PresenceResponse, type SendMessageRequest, type SendMessageResponse, type Session, type SlackBotOptions, SlackBridge, type SlackWebhookOptions, type Storage, TelegramBridge, type TelegramBridgeOptions, type TrackedElement, type TriggerOptions, type UaFilterConfig, type UaFilterLogEvent, type UaFilterMode, type UaFilterReason, type UaFilterResult, type VisibilityRequest, type VisibilityResponse, type WebhookConfig, WebhookHandler, type WebhookPayload, checkIpFilter, checkUaFilter, ipMatchesAny, ipMatchesCidr, isBot, matchesAnyPattern };

package/dist/index.d.ts

@@ -63,6 +63,20 @@ declare class PocketPing {
      * Called when visitor calls PocketPing.identify()
      */
     handleIdentify(request: IdentifyRequest): Promise<IdentifyResponse>;
+    /**
+     * Handle visitor disconnect (page unload or inactivity)
+     * Notifies bridges and triggers callback
+     */
+    handleDisconnect(request: DisconnectRequest): Promise<DisconnectResponse>;
+    /**
+     * Handle visibility change (tab focus/blur)
+     * Used for inactivity tracking
+     */
+    handleVisibility(request: VisibilityRequest): Promise<VisibilityResponse>;
+    /**
+     * Notify all bridges when visitor disconnects
+     */
+    private notifyBridgesDisconnect;
     /**
      * Get a session by ID
      */
@@ -384,6 +398,8 @@ interface PocketPingConfig {
     welcomeMessage?: string;
     /** Seconds of inactivity before AI takes over (default: 300) */
     aiTakeoverDelay?: number;
+    /** Seconds of visitor inactivity before notifying bridges (0 = disabled) */
+    visitorInactivityTimeout?: number;
     /** Callback when a new session is created */
     onNewSession?: (session: Session) => void | Promise<void>;
     /** Callback when a message is received */
@@ -392,6 +408,8 @@ interface PocketPingConfig {
     onEvent?: (event: CustomEvent, session: Session) => void | Promise<void>;
     /** Callback when a user identifies themselves */
     onIdentify?: (session: Session) => void | Promise<void>;
+    /** Callback when a visitor disconnects (leaves the page or goes inactive) */
+    onVisitorDisconnect?: (session: Session, duration: number) => void | Promise<void>;
     /** Webhook URL to forward custom events (Zapier, Make, n8n, etc.) */
     webhookUrl?: string;
     /** Secret key for HMAC-SHA256 signature (X-PocketPing-Signature header) */
@@ -602,6 +620,22 @@ interface IdentifyRequest {
 interface IdentifyResponse {
     ok: boolean;
 }
+interface DisconnectRequest {
+    sessionId: string;
+    duration: number;
+    reason: 'page_unload' | 'inactivity' | 'manual';
+}
+interface DisconnectResponse {
+    ok: boolean;
+}
+interface VisibilityRequest {
+    sessionId: string;
+    state: 'hidden' | 'visible';
+    timestamp: number;
+}
+interface VisibilityResponse {
+    ok: boolean;
+}
 interface PresenceResponse {
     online: boolean;
     operators?: Array<{
@@ -1065,4 +1099,4 @@ declare class WebhookHandler {
     private getSlackUserName;
 }
 
-export { type AIProvider, type Bridge, type BridgeMessageIds, type BridgeMessageResult, type ConnectRequest, type ConnectResponse, type CustomEvent, type CustomEventHandler, DEFAULT_BOT_PATTERNS, type DeleteMessageRequest, type DeleteMessageResponse, type DiscordBotOptions, DiscordBridge, type DiscordWebhookOptions, type EditMessageRequest, type EditMessageResponse, type IpFilterConfig, type IpFilterLogEvent, type IpFilterMode, MemoryStorage, type Message, type OperatorAttachment, type OperatorMessageCallback, type OperatorMessageDeleteCallback, type OperatorMessageEditCallback, PocketPing, type PocketPingConfig, type PresenceResponse, type SendMessageRequest, type SendMessageResponse, type Session, type SlackBotOptions, SlackBridge, type SlackWebhookOptions, type Storage, TelegramBridge, type TelegramBridgeOptions, type TrackedElement, type TriggerOptions, type UaFilterConfig, type UaFilterLogEvent, type UaFilterMode, type UaFilterReason, type UaFilterResult, type WebhookConfig, WebhookHandler, type WebhookPayload, checkIpFilter, checkUaFilter, ipMatchesAny, ipMatchesCidr, isBot, matchesAnyPattern };
+export { type AIProvider, type Bridge, type BridgeMessageIds, type BridgeMessageResult, type ConnectRequest, type ConnectResponse, type CustomEvent, type CustomEventHandler, DEFAULT_BOT_PATTERNS, type DeleteMessageRequest, type DeleteMessageResponse, type DisconnectRequest, type DisconnectResponse, type DiscordBotOptions, DiscordBridge, type DiscordWebhookOptions, type EditMessageRequest, type EditMessageResponse, type IpFilterConfig, type IpFilterLogEvent, type IpFilterMode, MemoryStorage, type Message, type OperatorAttachment, type OperatorMessageCallback, type OperatorMessageDeleteCallback, type OperatorMessageEditCallback, PocketPing, type PocketPingConfig, type PresenceResponse, type SendMessageRequest, type SendMessageResponse, type Session, type SlackBotOptions, SlackBridge, type SlackWebhookOptions, type Storage, TelegramBridge, type TelegramBridgeOptions, type TrackedElement, type TriggerOptions, type UaFilterConfig, type UaFilterLogEvent, type UaFilterMode, type UaFilterReason, type UaFilterResult, type VisibilityRequest, type VisibilityResponse, type WebhookConfig, WebhookHandler, type WebhookPayload, checkIpFilter, checkUaFilter, ipMatchesAny, ipMatchesCidr, isBot, matchesAnyPattern };

package/dist/index.js

@@ -1859,6 +1859,12 @@ var PocketPing = class {
           case "delete":
             result = await this.handleDeleteMessage(body);
             break;
+          case "disconnect":
+            result = await this.handleDisconnect(body);
+            break;
+          case "visibility":
+            result = await this.handleVisibility(body);
+            break;
           default:
             if (next) {
               next();
@@ -2179,6 +2185,58 @@ var PocketPing = class {
     this.forwardIdentityToWebhook(session);
     return { ok: true };
   }
+  /**
+   * Handle visitor disconnect (page unload or inactivity)
+   * Notifies bridges and triggers callback
+   */
+  async handleDisconnect(request) {
+    const session = await this.storage.getSession(request.sessionId);
+    if (!session) {
+      throw new Error("Session not found");
+    }
+    const formatDuration = (seconds) => {
+      if (seconds < 60) return `${seconds}s`;
+      if (seconds < 3600) return `${Math.floor(seconds / 60)} min`;
+      const hours = Math.floor(seconds / 3600);
+      const mins = Math.floor(seconds % 3600 / 60);
+      return mins > 0 ? `${hours}h ${mins}min` : `${hours}h`;
+    };
+    const visitorName = session.identity?.name || session.identity?.email?.split("@")[0] || "Visitor";
+    const durationText = formatDuration(request.duration);
+    const message = `\u{1F44B} ${visitorName} left (was here for ${durationText})`;
+    await this.notifyBridgesDisconnect(session, message);
+    await this.config.onVisitorDisconnect?.(session, request.duration);
+    return { ok: true };
+  }
+  /**
+   * Handle visibility change (tab focus/blur)
+   * Used for inactivity tracking
+   */
+  async handleVisibility(request) {
+    const session = await this.storage.getSession(request.sessionId);
+    if (!session) {
+      throw new Error("Session not found");
+    }
+    if (request.state === "visible") {
+      session.lastActivity = /* @__PURE__ */ new Date();
+      await this.storage.updateSession(session);
+    }
+    return { ok: true };
+  }
+  /**
+   * Notify all bridges when visitor disconnects
+   */
+  async notifyBridgesDisconnect(session, message) {
+    for (const bridge of this.bridges) {
+      try {
+        if ("notifyDisconnect" in bridge && typeof bridge.notifyDisconnect === "function") {
+          await bridge.notifyDisconnect(session, message);
+        }
+      } catch (error) {
+        console.error(`[PocketPing] Bridge disconnect notification failed:`, error);
+      }
+    }
+  }
   /**
    * Get a session by ID
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pocketping/sdk-node",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "type": "module",
   "description": "Node.js SDK for implementing PocketPing protocol",
   "main": "dist/index.cjs",