@scalemule/nextjs 0.0.31 → 0.0.33

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
+import { RealtimeService } from '@scalemule/sdk';
 import { ScaleMuleClient } from './client.mjs';
 export { ClientConfig, RequestOptions, createClient } from './client.mjs';
 import { S as ScaleMuleConfig, U as User, L as LoginResponse, A as ApiError, a as UseAuthReturn, b as UseBillingReturn, c as ListFilesParams, d as UseContentReturn, e as UseUserReturn, f as UseAnalyticsOptions, g as UseAnalyticsReturn } from './index-BoENfro3.mjs';
@@ -8,6 +9,8 @@ export { h as AccountBalance, i as AnalyticsEvent, j as ApiResponse, B as BatchT
 interface ScaleMuleContextValue {
     /** The API client instance */
     client: ScaleMuleClient;
+    /** Base SDK realtime service — shared singleton for WebSocket connections */
+    realtime: RealtimeService;
     /** Current authenticated user */
     user: User | null;
     /** Set the current user */
@@ -154,58 +157,45 @@ interface RealtimeMessage<T = unknown> {
 }
 type RealtimeStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
 interface UseRealtimeOptions {
-    /** Auto-connect on mount (default: true) */
+    /** Channels to subscribe to */
+    channels?: string[];
+    /** Called when a message arrives on any subscribed channel */
+    onMessage?: (channel: string, data: unknown) => void;
+    /** Auto-connect on mount (default: true) — subscribing auto-connects */
     autoConnect?: boolean;
-    /** Events to subscribe to (default: all) */
-    events?: RealtimeEvent[];
-    /** Reconnect on disconnect (default: true) */
-    autoReconnect?: boolean;
-    /** Max reconnect attempts (default: 5) */
-    maxReconnectAttempts?: number;
-    /** Reconnect delay in ms (default: 1000, doubles each attempt) */
-    reconnectDelay?: number;
 }
 interface UseRealtimeReturn {
     /** Current connection status */
     status: RealtimeStatus;
-    /** Last error */
-    error: ApiError | null;
-    /** Connect to realtime */
-    connect: () => void;
-    /** Disconnect from realtime */
-    disconnect: () => void;
-    /** Subscribe to an event */
-    subscribe: <T>(event: RealtimeEvent, callback: (data: T) => void) => () => void;
-    /** Send a message (if supported) */
-    send: (event: string, data: unknown) => void;
     /** Last received message */
-    lastMessage: RealtimeMessage | null;
+    lastMessage: {
+        channel: string;
+        data: unknown;
+    } | null;
+    /** Manually disconnect */
+    disconnect: () => void;
+    /** Subscribe to an additional channel (auto-connects) */
+    subscribe: (channel: string, callback?: (data: unknown) => void) => () => void;
+    /** Publish data to a channel */
+    publish: (channel: string, data: unknown) => void;
 }
 /**
- * Real-time updates hook via WebSocket
+ * Real-time updates hook via WebSocket.
  *
- * Provides live updates for user state, files, and notifications.
+ * Uses the base SDK's RealtimeService (shared singleton created in the provider)
+ * to ensure correct protocol handling and single WebSocket connection per page.
  *
  * @example
  * ```tsx
- * function Dashboard() {
- *   const { status, subscribe } = useRealtime()
- *
- *   useEffect(() => {
- *     // Subscribe to file uploads
- *     const unsubscribe = subscribe('file.uploaded', (data) => {
- *       console.log('New file uploaded:', data)
- *       refreshFiles()
- *     })
- *
- *     return () => unsubscribe()
- *   }, [subscribe])
+ * function ChatNotifications() {
+ *   const { status, lastMessage } = useRealtime({
+ *     channels: ['chat:room-1', 'notifications'],
+ *     onMessage: (channel, data) => {
+ *       console.log(`${channel}:`, data)
+ *     },
+ *   })
  *
- *   return (
- *     <div>
- *       <span>Status: {status}</span>
- *     </div>
- *   )
+ *   return <div>Status: {status}</div>
  * }
  * ```
  */
@@ -294,6 +284,8 @@ interface UsePushNotificationsOptions {
     serviceWorkerUrl?: string;
     /** Push proxy URL (default: '/api/push') */
     pushProxyUrl?: string;
+    /** Where the user subscribed (e.g., 'landing_prompt', 'post_signup', 'settings') */
+    registrationSource?: string;
     /** Called when a push notification is received while app is in foreground */
     onNotification?: (data: unknown) => void;
 }

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
+import { RealtimeService } from '@scalemule/sdk';
 import { ScaleMuleClient } from './client.js';
 export { ClientConfig, RequestOptions, createClient } from './client.js';
 import { S as ScaleMuleConfig, U as User, L as LoginResponse, A as ApiError, a as UseAuthReturn, b as UseBillingReturn, c as ListFilesParams, d as UseContentReturn, e as UseUserReturn, f as UseAnalyticsOptions, g as UseAnalyticsReturn } from './index-BoENfro3.js';
@@ -8,6 +9,8 @@ export { h as AccountBalance, i as AnalyticsEvent, j as ApiResponse, B as BatchT
 interface ScaleMuleContextValue {
     /** The API client instance */
     client: ScaleMuleClient;
+    /** Base SDK realtime service — shared singleton for WebSocket connections */
+    realtime: RealtimeService;
     /** Current authenticated user */
     user: User | null;
     /** Set the current user */
@@ -154,58 +157,45 @@ interface RealtimeMessage<T = unknown> {
 }
 type RealtimeStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
 interface UseRealtimeOptions {
-    /** Auto-connect on mount (default: true) */
+    /** Channels to subscribe to */
+    channels?: string[];
+    /** Called when a message arrives on any subscribed channel */
+    onMessage?: (channel: string, data: unknown) => void;
+    /** Auto-connect on mount (default: true) — subscribing auto-connects */
     autoConnect?: boolean;
-    /** Events to subscribe to (default: all) */
-    events?: RealtimeEvent[];
-    /** Reconnect on disconnect (default: true) */
-    autoReconnect?: boolean;
-    /** Max reconnect attempts (default: 5) */
-    maxReconnectAttempts?: number;
-    /** Reconnect delay in ms (default: 1000, doubles each attempt) */
-    reconnectDelay?: number;
 }
 interface UseRealtimeReturn {
     /** Current connection status */
     status: RealtimeStatus;
-    /** Last error */
-    error: ApiError | null;
-    /** Connect to realtime */
-    connect: () => void;
-    /** Disconnect from realtime */
-    disconnect: () => void;
-    /** Subscribe to an event */
-    subscribe: <T>(event: RealtimeEvent, callback: (data: T) => void) => () => void;
-    /** Send a message (if supported) */
-    send: (event: string, data: unknown) => void;
     /** Last received message */
-    lastMessage: RealtimeMessage | null;
+    lastMessage: {
+        channel: string;
+        data: unknown;
+    } | null;
+    /** Manually disconnect */
+    disconnect: () => void;
+    /** Subscribe to an additional channel (auto-connects) */
+    subscribe: (channel: string, callback?: (data: unknown) => void) => () => void;
+    /** Publish data to a channel */
+    publish: (channel: string, data: unknown) => void;
 }
 /**
- * Real-time updates hook via WebSocket
+ * Real-time updates hook via WebSocket.
  *
- * Provides live updates for user state, files, and notifications.
+ * Uses the base SDK's RealtimeService (shared singleton created in the provider)
+ * to ensure correct protocol handling and single WebSocket connection per page.
  *
  * @example
  * ```tsx
- * function Dashboard() {
- *   const { status, subscribe } = useRealtime()
- *
- *   useEffect(() => {
- *     // Subscribe to file uploads
- *     const unsubscribe = subscribe('file.uploaded', (data) => {
- *       console.log('New file uploaded:', data)
- *       refreshFiles()
- *     })
- *
- *     return () => unsubscribe()
- *   }, [subscribe])
+ * function ChatNotifications() {
+ *   const { status, lastMessage } = useRealtime({
+ *     channels: ['chat:room-1', 'notifications'],
+ *     onMessage: (channel, data) => {
+ *       console.log(`${channel}:`, data)
+ *     },
+ *   })
  *
- *   return (
- *     <div>
- *       <span>Status: {status}</span>
- *     </div>
- *   )
+ *   return <div>Status: {status}</div>
  * }
  * ```
  */
@@ -294,6 +284,8 @@ interface UsePushNotificationsOptions {
     serviceWorkerUrl?: string;
     /** Push proxy URL (default: '/api/push') */
     pushProxyUrl?: string;
+    /** Where the user subscribed (e.g., 'landing_prompt', 'post_signup', 'settings') */
+    registrationSource?: string;
     /** Called when a push notification is received while app is in foreground */
     onNotification?: (data: unknown) => void;
 }

package/dist/index.js

@@ -1,8 +1,8 @@
 'use strict';
 
 var react = require('react');
-var jsxRuntime = require('react/jsx-runtime');
 var sdk = require('@scalemule/sdk');
+var jsxRuntime = require('react/jsx-runtime');
 
 // src/provider.tsx
 
@@ -836,6 +836,24 @@ function ScaleMuleProvider({
     }),
     [apiKey, applicationId, environment, gatewayUrl, debug, storage, authProxyUrl]
   );
+  const baseClient = react.useMemo(() => {
+    const resolvedGatewayUrl = gatewayUrl || (environment === "dev" ? "https://api-dev.scalemule.com" : "https://api.scalemule.com");
+    return new sdk.ScaleMule({
+      apiKey,
+      applicationId,
+      baseUrl: resolvedGatewayUrl,
+      environment,
+      debug
+    });
+  }, [apiKey, applicationId, environment, gatewayUrl, debug]);
+  react.useEffect(() => {
+    const token = client.getSessionToken();
+    if (token) {
+      baseClient.setAccessToken(token);
+    } else {
+      baseClient.clearAccessToken();
+    }
+  }, [client, baseClient, user]);
   react.useEffect(() => {
     let mounted = true;
     async function initialize() {
@@ -923,6 +941,7 @@ function ScaleMuleProvider({
   const value = react.useMemo(
     () => ({
       client,
+      realtime: baseClient.realtime,
       user,
       setUser: handleSetUser,
       initializing,
@@ -935,7 +954,7 @@ function ScaleMuleProvider({
       environment: environment || void 0,
       bootstrapFlags
     }),
-    [client, user, handleSetUser, initializing, error, analyticsProxyUrl, authProxyUrl, publishableKey, gatewayUrl, environment, bootstrapFlags]
+    [client, baseClient, user, handleSetUser, initializing, error, analyticsProxyUrl, authProxyUrl, publishableKey, gatewayUrl, environment, bootstrapFlags]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(ScaleMuleContext.Provider, { value, children });
 }
@@ -2231,187 +2250,79 @@ function useUser() {
     [user, loading, localError, update, changePassword, changeEmail, deleteAccount, exportData]
   );
 }
-function useRealtime(options = {}) {
-  const {
-    autoConnect = true,
-    events,
-    autoReconnect = true,
-    maxReconnectAttempts = 5,
-    reconnectDelay = 1e3
-  } = options;
-  const { client, user, setUser } = useScaleMule();
+function useRealtime(options) {
+  const { realtime } = useScaleMule();
   const [status, setStatus] = react.useState("disconnected");
-  const [error, setError] = react.useState(null);
   const [lastMessage, setLastMessage] = react.useState(null);
-  const wsRef = react.useRef(null);
-  const reconnectAttempts = react.useRef(0);
-  const reconnectTimeout = react.useRef(null);
-  const subscribersRef = react.useRef(/* @__PURE__ */ new Map());
-  const getWebSocketUrl = react.useCallback(() => {
-    const gatewayUrl = client.getGatewayUrl();
-    const wsUrl = gatewayUrl.replace(/^https?:\/\//, "wss://").replace(/^http:\/\//, "ws://");
-    return `${wsUrl}/v1/realtime`;
-  }, [client]);
-  const handleMessage = react.useCallback(
-    (event) => {
-      try {
-        const message = JSON.parse(event.data);
-        setLastMessage(message);
-        switch (message.event) {
-          case "user.updated":
-            if (user && message.data.id === user.id) {
-              setUser(message.data);
-            }
-            break;
-          case "session.expired":
-            client.clearSession();
-            setUser(null);
-            break;
-        }
-        const subscribers = subscribersRef.current.get(message.event);
-        if (subscribers) {
-          subscribers.forEach((callback) => callback(message.data));
-        }
-        const wildcardSubscribers = subscribersRef.current.get("*");
-        if (wildcardSubscribers) {
-          wildcardSubscribers.forEach((callback) => callback(message));
-        }
-      } catch (err) {
-        console.error("[ScaleMule Realtime] Failed to parse message:", err);
-      }
-    },
-    [client, user, setUser]
-  );
-  const connect = react.useCallback(() => {
-    if (wsRef.current?.readyState === WebSocket.OPEN) {
-      return;
-    }
-    if (!user) {
-      setError({ code: "NOT_AUTHENTICATED", message: "Must be logged in to connect" });
-      return;
-    }
-    const applicationId = client.getApplicationId();
-    if (!applicationId) {
-      setError({ code: "MISSING_APP_ID", message: "applicationId is required for realtime features. Add it to your ScaleMuleProvider config." });
-      return;
-    }
-    setStatus("connecting");
-    setError(null);
-    const url = getWebSocketUrl();
-    try {
-      const ws = new WebSocket(url);
-      ws.onopen = () => {
-        const sessionToken = client.getSessionToken();
-        ws.send(JSON.stringify({
-          type: "auth",
-          token: sessionToken,
-          app_id: applicationId
-        }));
-      };
-      ws.onmessage = (event) => {
-        try {
-          const message = JSON.parse(event.data);
-          if (message.type === "auth_success") {
-            setStatus("connected");
-            reconnectAttempts.current = 0;
-            if (events && events.length > 0) {
-              ws.send(JSON.stringify({ type: "subscribe", events }));
-            }
-            return;
-          }
-          if (message.type === "error") {
-            setError({ code: "AUTH_ERROR", message: message.message || "Authentication failed" });
-            setStatus("disconnected");
-            ws.close(1e3);
-            return;
-          }
-          handleMessage(event);
-        } catch (err) {
-          console.error("[ScaleMule Realtime] Failed to parse message:", err);
-        }
-      };
-      ws.onerror = () => {
-        setError({ code: "WEBSOCKET_ERROR", message: "Connection error" });
-      };
-      ws.onclose = (event) => {
-        setStatus("disconnected");
-        wsRef.current = null;
-        if (autoReconnect && event.code !== 1e3 && reconnectAttempts.current < maxReconnectAttempts) {
-          setStatus("reconnecting");
-          const delay = reconnectDelay * Math.pow(2, reconnectAttempts.current);
-          reconnectAttempts.current++;
-          reconnectTimeout.current = setTimeout(() => {
-            connect();
-          }, delay);
-        }
-      };
-      wsRef.current = ws;
-    } catch (err) {
-      setError({
-        code: "WEBSOCKET_CONNECT_FAILED",
-        message: err instanceof Error ? err.message : "Failed to connect"
-      });
-      setStatus("disconnected");
-    }
-  }, [user, client, getWebSocketUrl, events, handleMessage, autoReconnect, maxReconnectAttempts, reconnectDelay]);
+  const manualUnsubscribesRef = react.useRef([]);
+  const autoUnsubscribesRef = react.useRef([]);
+  const onMessageRef = react.useRef(void 0);
+  const channelSignature = (options?.channels ?? []).join("");
+  react.useEffect(() => {
+    onMessageRef.current = options?.onMessage;
+  }, [options?.onMessage]);
   const disconnect = react.useCallback(() => {
-    if (reconnectTimeout.current) {
-      clearTimeout(reconnectTimeout.current);
-      reconnectTimeout.current = null;
-    }
-    if (wsRef.current) {
-      wsRef.current.close(1e3, "Client disconnect");
-      wsRef.current = null;
-    }
-    setStatus("disconnected");
-    reconnectAttempts.current = 0;
-  }, []);
+    realtime.disconnect();
+  }, [realtime]);
   const subscribe = react.useCallback(
-    (event, callback) => {
-      if (!subscribersRef.current.has(event)) {
-        subscribersRef.current.set(event, /* @__PURE__ */ new Set());
-      }
-      const typedCallback = callback;
-      subscribersRef.current.get(event).add(typedCallback);
+    (channel, callback) => {
+      const unsub = realtime.subscribe(channel, (data) => {
+        setLastMessage({ channel, data });
+        callback?.(data);
+        onMessageRef.current?.(channel, data);
+      });
+      manualUnsubscribesRef.current.push(unsub);
       return () => {
-        const subscribers = subscribersRef.current.get(event);
-        if (subscribers) {
-          subscribers.delete(typedCallback);
-          if (subscribers.size === 0) {
-            subscribersRef.current.delete(event);
-          }
-        }
+        manualUnsubscribesRef.current = manualUnsubscribesRef.current.filter((fn) => fn !== unsub);
+        unsub();
       };
     },
-    []
+    [realtime]
   );
-  const send = react.useCallback((event, data) => {
-    if (wsRef.current?.readyState === WebSocket.OPEN) {
-      wsRef.current.send(JSON.stringify({ event, data }));
-    } else {
-      console.warn("[ScaleMule Realtime] Cannot send - not connected");
-    }
-  }, []);
+  const publish = react.useCallback(
+    (channel, data) => {
+      realtime.publish(channel, data);
+    },
+    [realtime]
+  );
+  react.useEffect(() => {
+    const unsub = realtime.onStatusChange((newStatus) => {
+      setStatus(newStatus);
+    });
+    return unsub;
+  }, [realtime]);
   react.useEffect(() => {
-    if (autoConnect && user) {
-      connect();
+    for (const unsub of autoUnsubscribesRef.current) {
+      unsub();
+    }
+    autoUnsubscribesRef.current = [];
+    for (const channel of options?.channels ?? []) {
+      const unsub = realtime.subscribe(channel, (data) => {
+        setLastMessage({ channel, data });
+        onMessageRef.current?.(channel, data);
+      });
+      autoUnsubscribesRef.current.push(unsub);
     }
     return () => {
-      disconnect();
+      for (const unsub of autoUnsubscribesRef.current) {
+        unsub();
+      }
+      autoUnsubscribesRef.current = [];
     };
-  }, [autoConnect, user, connect, disconnect]);
-  return react.useMemo(
-    () => ({
-      status,
-      error,
-      connect,
-      disconnect,
-      subscribe,
-      send,
-      lastMessage
-    }),
-    [status, error, connect, disconnect, subscribe, send, lastMessage]
-  );
+  }, [realtime, channelSignature]);
+  react.useEffect(() => {
+    return () => {
+      for (const unsub of manualUnsubscribesRef.current) {
+        unsub();
+      }
+      manualUnsubscribesRef.current = [];
+      for (const unsub of autoUnsubscribesRef.current) {
+        unsub();
+      }
+      autoUnsubscribesRef.current = [];
+    };
+  }, []);
+  return { status, lastMessage, disconnect, subscribe, publish };
 }
 
 // src/hooks/event-dedup.ts
@@ -3060,7 +2971,7 @@ function getCsrfToken() {
   return match ? decodeURIComponent(match[1]) : "";
 }
 function usePushNotifications(options = {}) {
-  const { serviceWorkerUrl = "/sw.js", pushProxyUrl = "/api/push", onNotification } = options;
+  const { serviceWorkerUrl = "/sw.js", pushProxyUrl = "/api/push", registrationSource, onNotification } = options;
   const { user } = useScaleMule();
   const [isSupported, setIsSupported] = react.useState(false);
   const [permission, setPermission] = react.useState("unsupported");
@@ -3127,7 +3038,7 @@ function usePushNotifications(options = {}) {
   const manager = react.useMemo(() => {
     if (typeof window === "undefined") return null;
     try {
-      return new sdk.WebPushManager({ fetcher, serviceWorkerUrl });
+      return new sdk.WebPushManager({ fetcher, serviceWorkerUrl, registrationSource });
     } catch {
       return null;
     }

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { createContext, useState, useMemo, useEffect, useCallback, useContext, useRef } from 'react';
+import { ScaleMule, WebPushManager } from '@scalemule/sdk';
 import { jsx } from 'react/jsx-runtime';
-import { WebPushManager } from '@scalemule/sdk';
 
 // src/provider.tsx
 
@@ -834,6 +834,24 @@ function ScaleMuleProvider({
     }),
     [apiKey, applicationId, environment, gatewayUrl, debug, storage, authProxyUrl]
   );
+  const baseClient = useMemo(() => {
+    const resolvedGatewayUrl = gatewayUrl || (environment === "dev" ? "https://api-dev.scalemule.com" : "https://api.scalemule.com");
+    return new ScaleMule({
+      apiKey,
+      applicationId,
+      baseUrl: resolvedGatewayUrl,
+      environment,
+      debug
+    });
+  }, [apiKey, applicationId, environment, gatewayUrl, debug]);
+  useEffect(() => {
+    const token = client.getSessionToken();
+    if (token) {
+      baseClient.setAccessToken(token);
+    } else {
+      baseClient.clearAccessToken();
+    }
+  }, [client, baseClient, user]);
   useEffect(() => {
     let mounted = true;
     async function initialize() {
@@ -921,6 +939,7 @@ function ScaleMuleProvider({
   const value = useMemo(
     () => ({
       client,
+      realtime: baseClient.realtime,
       user,
       setUser: handleSetUser,
       initializing,
@@ -933,7 +952,7 @@ function ScaleMuleProvider({
       environment: environment || void 0,
       bootstrapFlags
     }),
-    [client, user, handleSetUser, initializing, error, analyticsProxyUrl, authProxyUrl, publishableKey, gatewayUrl, environment, bootstrapFlags]
+    [client, baseClient, user, handleSetUser, initializing, error, analyticsProxyUrl, authProxyUrl, publishableKey, gatewayUrl, environment, bootstrapFlags]
   );
   return /* @__PURE__ */ jsx(ScaleMuleContext.Provider, { value, children });
 }
@@ -2229,187 +2248,79 @@ function useUser() {
     [user, loading, localError, update, changePassword, changeEmail, deleteAccount, exportData]
   );
 }
-function useRealtime(options = {}) {
-  const {
-    autoConnect = true,
-    events,
-    autoReconnect = true,
-    maxReconnectAttempts = 5,
-    reconnectDelay = 1e3
-  } = options;
-  const { client, user, setUser } = useScaleMule();
+function useRealtime(options) {
+  const { realtime } = useScaleMule();
   const [status, setStatus] = useState("disconnected");
-  const [error, setError] = useState(null);
   const [lastMessage, setLastMessage] = useState(null);
-  const wsRef = useRef(null);
-  const reconnectAttempts = useRef(0);
-  const reconnectTimeout = useRef(null);
-  const subscribersRef = useRef(/* @__PURE__ */ new Map());
-  const getWebSocketUrl = useCallback(() => {
-    const gatewayUrl = client.getGatewayUrl();
-    const wsUrl = gatewayUrl.replace(/^https?:\/\//, "wss://").replace(/^http:\/\//, "ws://");
-    return `${wsUrl}/v1/realtime`;
-  }, [client]);
-  const handleMessage = useCallback(
-    (event) => {
-      try {
-        const message = JSON.parse(event.data);
-        setLastMessage(message);
-        switch (message.event) {
-          case "user.updated":
-            if (user && message.data.id === user.id) {
-              setUser(message.data);
-            }
-            break;
-          case "session.expired":
-            client.clearSession();
-            setUser(null);
-            break;
-        }
-        const subscribers = subscribersRef.current.get(message.event);
-        if (subscribers) {
-          subscribers.forEach((callback) => callback(message.data));
-        }
-        const wildcardSubscribers = subscribersRef.current.get("*");
-        if (wildcardSubscribers) {
-          wildcardSubscribers.forEach((callback) => callback(message));
-        }
-      } catch (err) {
-        console.error("[ScaleMule Realtime] Failed to parse message:", err);
-      }
-    },
-    [client, user, setUser]
-  );
-  const connect = useCallback(() => {
-    if (wsRef.current?.readyState === WebSocket.OPEN) {
-      return;
-    }
-    if (!user) {
-      setError({ code: "NOT_AUTHENTICATED", message: "Must be logged in to connect" });
-      return;
-    }
-    const applicationId = client.getApplicationId();
-    if (!applicationId) {
-      setError({ code: "MISSING_APP_ID", message: "applicationId is required for realtime features. Add it to your ScaleMuleProvider config." });
-      return;
-    }
-    setStatus("connecting");
-    setError(null);
-    const url = getWebSocketUrl();
-    try {
-      const ws = new WebSocket(url);
-      ws.onopen = () => {
-        const sessionToken = client.getSessionToken();
-        ws.send(JSON.stringify({
-          type: "auth",
-          token: sessionToken,
-          app_id: applicationId
-        }));
-      };
-      ws.onmessage = (event) => {
-        try {
-          const message = JSON.parse(event.data);
-          if (message.type === "auth_success") {
-            setStatus("connected");
-            reconnectAttempts.current = 0;
-            if (events && events.length > 0) {
-              ws.send(JSON.stringify({ type: "subscribe", events }));
-            }
-            return;
-          }
-          if (message.type === "error") {
-            setError({ code: "AUTH_ERROR", message: message.message || "Authentication failed" });
-            setStatus("disconnected");
-            ws.close(1e3);
-            return;
-          }
-          handleMessage(event);
-        } catch (err) {
-          console.error("[ScaleMule Realtime] Failed to parse message:", err);
-        }
-      };
-      ws.onerror = () => {
-        setError({ code: "WEBSOCKET_ERROR", message: "Connection error" });
-      };
-      ws.onclose = (event) => {
-        setStatus("disconnected");
-        wsRef.current = null;
-        if (autoReconnect && event.code !== 1e3 && reconnectAttempts.current < maxReconnectAttempts) {
-          setStatus("reconnecting");
-          const delay = reconnectDelay * Math.pow(2, reconnectAttempts.current);
-          reconnectAttempts.current++;
-          reconnectTimeout.current = setTimeout(() => {
-            connect();
-          }, delay);
-        }
-      };
-      wsRef.current = ws;
-    } catch (err) {
-      setError({
-        code: "WEBSOCKET_CONNECT_FAILED",
-        message: err instanceof Error ? err.message : "Failed to connect"
-      });
-      setStatus("disconnected");
-    }
-  }, [user, client, getWebSocketUrl, events, handleMessage, autoReconnect, maxReconnectAttempts, reconnectDelay]);
+  const manualUnsubscribesRef = useRef([]);
+  const autoUnsubscribesRef = useRef([]);
+  const onMessageRef = useRef(void 0);
+  const channelSignature = (options?.channels ?? []).join("");
+  useEffect(() => {
+    onMessageRef.current = options?.onMessage;
+  }, [options?.onMessage]);
   const disconnect = useCallback(() => {
-    if (reconnectTimeout.current) {
-      clearTimeout(reconnectTimeout.current);
-      reconnectTimeout.current = null;
-    }
-    if (wsRef.current) {
-      wsRef.current.close(1e3, "Client disconnect");
-      wsRef.current = null;
-    }
-    setStatus("disconnected");
-    reconnectAttempts.current = 0;
-  }, []);
+    realtime.disconnect();
+  }, [realtime]);
   const subscribe = useCallback(
-    (event, callback) => {
-      if (!subscribersRef.current.has(event)) {
-        subscribersRef.current.set(event, /* @__PURE__ */ new Set());
-      }
-      const typedCallback = callback;
-      subscribersRef.current.get(event).add(typedCallback);
+    (channel, callback) => {
+      const unsub = realtime.subscribe(channel, (data) => {
+        setLastMessage({ channel, data });
+        callback?.(data);
+        onMessageRef.current?.(channel, data);
+      });
+      manualUnsubscribesRef.current.push(unsub);
       return () => {
-        const subscribers = subscribersRef.current.get(event);
-        if (subscribers) {
-          subscribers.delete(typedCallback);
-          if (subscribers.size === 0) {
-            subscribersRef.current.delete(event);
-          }
-        }
+        manualUnsubscribesRef.current = manualUnsubscribesRef.current.filter((fn) => fn !== unsub);
+        unsub();
       };
     },
-    []
+    [realtime]
   );
-  const send = useCallback((event, data) => {
-    if (wsRef.current?.readyState === WebSocket.OPEN) {
-      wsRef.current.send(JSON.stringify({ event, data }));
-    } else {
-      console.warn("[ScaleMule Realtime] Cannot send - not connected");
-    }
-  }, []);
+  const publish = useCallback(
+    (channel, data) => {
+      realtime.publish(channel, data);
+    },
+    [realtime]
+  );
+  useEffect(() => {
+    const unsub = realtime.onStatusChange((newStatus) => {
+      setStatus(newStatus);
+    });
+    return unsub;
+  }, [realtime]);
   useEffect(() => {
-    if (autoConnect && user) {
-      connect();
+    for (const unsub of autoUnsubscribesRef.current) {
+      unsub();
+    }
+    autoUnsubscribesRef.current = [];
+    for (const channel of options?.channels ?? []) {
+      const unsub = realtime.subscribe(channel, (data) => {
+        setLastMessage({ channel, data });
+        onMessageRef.current?.(channel, data);
+      });
+      autoUnsubscribesRef.current.push(unsub);
     }
     return () => {
-      disconnect();
+      for (const unsub of autoUnsubscribesRef.current) {
+        unsub();
+      }
+      autoUnsubscribesRef.current = [];
     };
-  }, [autoConnect, user, connect, disconnect]);
-  return useMemo(
-    () => ({
-      status,
-      error,
-      connect,
-      disconnect,
-      subscribe,
-      send,
-      lastMessage
-    }),
-    [status, error, connect, disconnect, subscribe, send, lastMessage]
-  );
+  }, [realtime, channelSignature]);
+  useEffect(() => {
+    return () => {
+      for (const unsub of manualUnsubscribesRef.current) {
+        unsub();
+      }
+      manualUnsubscribesRef.current = [];
+      for (const unsub of autoUnsubscribesRef.current) {
+        unsub();
+      }
+      autoUnsubscribesRef.current = [];
+    };
+  }, []);
+  return { status, lastMessage, disconnect, subscribe, publish };
 }
 
 // src/hooks/event-dedup.ts
@@ -3058,7 +2969,7 @@ function getCsrfToken() {
   return match ? decodeURIComponent(match[1]) : "";
 }
 function usePushNotifications(options = {}) {
-  const { serviceWorkerUrl = "/sw.js", pushProxyUrl = "/api/push", onNotification } = options;
+  const { serviceWorkerUrl = "/sw.js", pushProxyUrl = "/api/push", registrationSource, onNotification } = options;
   const { user } = useScaleMule();
   const [isSupported, setIsSupported] = useState(false);
   const [permission, setPermission] = useState("unsupported");
@@ -3125,7 +3036,7 @@ function usePushNotifications(options = {}) {
   const manager = useMemo(() => {
     if (typeof window === "undefined") return null;
     try {
-      return new WebPushManager({ fetcher, serviceWorkerUrl });
+      return new WebPushManager({ fetcher, serviceWorkerUrl, registrationSource });
     } catch {
       return null;
     }

package/dist/server/index.d.mts

@@ -231,7 +231,7 @@ interface AuthRoutesConfig {
         email: string;
     }) => void | Promise<void>;
 }
-type RouteHandler$1 = (request: Request, context: {
+type RouteHandler$2 = (request: Request, context: {
     params: Promise<{
         scalemule?: string[];
     }>;
@@ -264,10 +264,10 @@ type RouteHandler$1 = (request: Request, context: {
  * - POST /api/auth/verify-email - Verify email
  */
 declare function createAuthRoutes(config?: AuthRoutesConfig): {
-    GET: RouteHandler$1;
-    POST: RouteHandler$1;
-    DELETE: RouteHandler$1;
-    PATCH: RouteHandler$1;
+    GET: RouteHandler$2;
+    POST: RouteHandler$2;
+    DELETE: RouteHandler$2;
+    PATCH: RouteHandler$2;
 };
 interface AnalyticsTrackingGateConfig {
     /** Feature flag key used to decide whether to forward analytics */
@@ -346,7 +346,7 @@ interface AnalyticsRoutesConfig {
  * ```
  */
 declare function createAnalyticsRoutes(config?: AnalyticsRoutesConfig): {
-    POST: RouteHandler$1;
+    POST: RouteHandler$2;
 };
 
 /**
@@ -374,15 +374,49 @@ interface PushRoutesConfig {
     /** Enable CSRF validation on POST/PUT/DELETE (default: true) */
     csrf?: boolean;
 }
-type RouteHandler = (request: Request, context: {
+type RouteHandler$1 = (request: Request, context: {
     params: Promise<{
         action?: string[];
     }>;
 }) => Promise<Response>;
 declare function createPushRoutes(config: PushRoutesConfig): {
+    GET: RouteHandler$1;
+    POST: RouteHandler$1;
+    PUT: RouteHandler$1;
+    DELETE: RouteHandler$1;
+};
+
+/**
+ * Notification Proxy Routes
+ *
+ * Drop-in route handlers for Next.js App Router that proxy notification
+ * requests to the ScaleMule gateway. Follows the same pattern as createPushRoutes().
+ *
+ * @example
+ * ```ts
+ * // app/api/notifications/[...action]/route.ts
+ * import { createNotificationRoutes } from '@scalemule/nextjs/server'
+ *
+ * export const { GET, PATCH, DELETE } = createNotificationRoutes({
+ *   apiKey: process.env.SCALEMULE_API_KEY!,
+ *   gatewayUrl: process.env.SCALEMULE_API_URL!,
+ * })
+ * ```
+ */
+interface NotificationRoutesConfig {
+    /** Server-side secret API key */
+    apiKey: string;
+    /** Gateway URL (e.g., https://api.scalemule.com) */
+    gatewayUrl: string;
+}
+type RouteHandler = (request: Request, context: {
+    params: Promise<{
+        action?: string[];
+    }>;
+}) => Promise<Response>;
+declare function createNotificationRoutes(config: NotificationRoutesConfig): {
     GET: RouteHandler;
-    POST: RouteHandler;
-    PUT: RouteHandler;
+    PATCH: RouteHandler;
     DELETE: RouteHandler;
 };
 
@@ -977,4 +1011,4 @@ declare function invalidateBundleCache(key?: string): void;
  */
 declare function prefetchBundles(keys: string[]): Promise<void>;
 
-export { type AnalyticsRoutesConfig, type AnalyticsTrackingGateConfig, type AuthMiddlewareConfig, type AuthRoutesConfig, CSRF_COOKIE_NAME, CSRF_HEADER_NAME, type HandlerContext, type HandlerOptions, type MySqlBundle, OAUTH_STATE_COOKIE_NAME, type OAuthBundle, type PostgresBundle, type PushRoutesConfig, type RedisBundle, type S3Bundle, SESSION_COOKIE_NAME, ScaleMuleError, ServerConfig, type SessionCookieOptions, type SessionData, type SmtpBundle, USER_ID_COOKIE_NAME, apiHandler, buildClientContextHeaders, buildFlagContext, clearOAuthState, clearSession, configureBundles, configureSecrets, createAnalyticsRoutes, createAuthMiddleware, createAuthRoutes, createPushRoutes, errorCodeToStatus, extractClientContext, extractClientContextFromReq, generateCSRFToken, getAppSecret, getAppSecretOrDefault, getBootstrapFlags, getBundle, getCSRFToken, getMySqlBundle, getOAuthBundle, getPostgresBundle, getRedisBundle, getS3Bundle, getSession, getSessionFromRequest, getSmtpBundle, invalidateBundleCache, invalidateSecretCache, prefetchBundles, prefetchSecrets, requireAppSecret, requireBundle, requireSession, setOAuthState, unwrap, validateCSRFToken, validateCSRFTokenAsync, validateOAuthState, validateOAuthStateAsync, withAuth, withCSRFProtection, withCSRFToken, withSession };
+export { type AnalyticsRoutesConfig, type AnalyticsTrackingGateConfig, type AuthMiddlewareConfig, type AuthRoutesConfig, CSRF_COOKIE_NAME, CSRF_HEADER_NAME, type HandlerContext, type HandlerOptions, type MySqlBundle, type NotificationRoutesConfig, OAUTH_STATE_COOKIE_NAME, type OAuthBundle, type PostgresBundle, type PushRoutesConfig, type RedisBundle, type S3Bundle, SESSION_COOKIE_NAME, ScaleMuleError, ServerConfig, type SessionCookieOptions, type SessionData, type SmtpBundle, USER_ID_COOKIE_NAME, apiHandler, buildClientContextHeaders, buildFlagContext, clearOAuthState, clearSession, configureBundles, configureSecrets, createAnalyticsRoutes, createAuthMiddleware, createAuthRoutes, createNotificationRoutes, createPushRoutes, errorCodeToStatus, extractClientContext, extractClientContextFromReq, generateCSRFToken, getAppSecret, getAppSecretOrDefault, getBootstrapFlags, getBundle, getCSRFToken, getMySqlBundle, getOAuthBundle, getPostgresBundle, getRedisBundle, getS3Bundle, getSession, getSessionFromRequest, getSmtpBundle, invalidateBundleCache, invalidateSecretCache, prefetchBundles, prefetchSecrets, requireAppSecret, requireBundle, requireSession, setOAuthState, unwrap, validateCSRFToken, validateCSRFTokenAsync, validateOAuthState, validateOAuthStateAsync, withAuth, withCSRFProtection, withCSRFToken, withSession };

package/dist/server/index.d.ts

@@ -231,7 +231,7 @@ interface AuthRoutesConfig {
         email: string;
     }) => void | Promise<void>;
 }
-type RouteHandler$1 = (request: Request, context: {
+type RouteHandler$2 = (request: Request, context: {
     params: Promise<{
         scalemule?: string[];
     }>;
@@ -264,10 +264,10 @@ type RouteHandler$1 = (request: Request, context: {
  * - POST /api/auth/verify-email - Verify email
  */
 declare function createAuthRoutes(config?: AuthRoutesConfig): {
-    GET: RouteHandler$1;
-    POST: RouteHandler$1;
-    DELETE: RouteHandler$1;
-    PATCH: RouteHandler$1;
+    GET: RouteHandler$2;
+    POST: RouteHandler$2;
+    DELETE: RouteHandler$2;
+    PATCH: RouteHandler$2;
 };
 interface AnalyticsTrackingGateConfig {
     /** Feature flag key used to decide whether to forward analytics */
@@ -346,7 +346,7 @@ interface AnalyticsRoutesConfig {
  * ```
  */
 declare function createAnalyticsRoutes(config?: AnalyticsRoutesConfig): {
-    POST: RouteHandler$1;
+    POST: RouteHandler$2;
 };
 
 /**
@@ -374,15 +374,49 @@ interface PushRoutesConfig {
     /** Enable CSRF validation on POST/PUT/DELETE (default: true) */
     csrf?: boolean;
 }
-type RouteHandler = (request: Request, context: {
+type RouteHandler$1 = (request: Request, context: {
     params: Promise<{
         action?: string[];
     }>;
 }) => Promise<Response>;
 declare function createPushRoutes(config: PushRoutesConfig): {
+    GET: RouteHandler$1;
+    POST: RouteHandler$1;
+    PUT: RouteHandler$1;
+    DELETE: RouteHandler$1;
+};
+
+/**
+ * Notification Proxy Routes
+ *
+ * Drop-in route handlers for Next.js App Router that proxy notification
+ * requests to the ScaleMule gateway. Follows the same pattern as createPushRoutes().
+ *
+ * @example
+ * ```ts
+ * // app/api/notifications/[...action]/route.ts
+ * import { createNotificationRoutes } from '@scalemule/nextjs/server'
+ *
+ * export const { GET, PATCH, DELETE } = createNotificationRoutes({
+ *   apiKey: process.env.SCALEMULE_API_KEY!,
+ *   gatewayUrl: process.env.SCALEMULE_API_URL!,
+ * })
+ * ```
+ */
+interface NotificationRoutesConfig {
+    /** Server-side secret API key */
+    apiKey: string;
+    /** Gateway URL (e.g., https://api.scalemule.com) */
+    gatewayUrl: string;
+}
+type RouteHandler = (request: Request, context: {
+    params: Promise<{
+        action?: string[];
+    }>;
+}) => Promise<Response>;
+declare function createNotificationRoutes(config: NotificationRoutesConfig): {
     GET: RouteHandler;
-    POST: RouteHandler;
-    PUT: RouteHandler;
+    PATCH: RouteHandler;
     DELETE: RouteHandler;
 };
 
@@ -977,4 +1011,4 @@ declare function invalidateBundleCache(key?: string): void;
  */
 declare function prefetchBundles(keys: string[]): Promise<void>;
 
-export { type AnalyticsRoutesConfig, type AnalyticsTrackingGateConfig, type AuthMiddlewareConfig, type AuthRoutesConfig, CSRF_COOKIE_NAME, CSRF_HEADER_NAME, type HandlerContext, type HandlerOptions, type MySqlBundle, OAUTH_STATE_COOKIE_NAME, type OAuthBundle, type PostgresBundle, type PushRoutesConfig, type RedisBundle, type S3Bundle, SESSION_COOKIE_NAME, ScaleMuleError, ServerConfig, type SessionCookieOptions, type SessionData, type SmtpBundle, USER_ID_COOKIE_NAME, apiHandler, buildClientContextHeaders, buildFlagContext, clearOAuthState, clearSession, configureBundles, configureSecrets, createAnalyticsRoutes, createAuthMiddleware, createAuthRoutes, createPushRoutes, errorCodeToStatus, extractClientContext, extractClientContextFromReq, generateCSRFToken, getAppSecret, getAppSecretOrDefault, getBootstrapFlags, getBundle, getCSRFToken, getMySqlBundle, getOAuthBundle, getPostgresBundle, getRedisBundle, getS3Bundle, getSession, getSessionFromRequest, getSmtpBundle, invalidateBundleCache, invalidateSecretCache, prefetchBundles, prefetchSecrets, requireAppSecret, requireBundle, requireSession, setOAuthState, unwrap, validateCSRFToken, validateCSRFTokenAsync, validateOAuthState, validateOAuthStateAsync, withAuth, withCSRFProtection, withCSRFToken, withSession };
+export { type AnalyticsRoutesConfig, type AnalyticsTrackingGateConfig, type AuthMiddlewareConfig, type AuthRoutesConfig, CSRF_COOKIE_NAME, CSRF_HEADER_NAME, type HandlerContext, type HandlerOptions, type MySqlBundle, type NotificationRoutesConfig, OAUTH_STATE_COOKIE_NAME, type OAuthBundle, type PostgresBundle, type PushRoutesConfig, type RedisBundle, type S3Bundle, SESSION_COOKIE_NAME, ScaleMuleError, ServerConfig, type SessionCookieOptions, type SessionData, type SmtpBundle, USER_ID_COOKIE_NAME, apiHandler, buildClientContextHeaders, buildFlagContext, clearOAuthState, clearSession, configureBundles, configureSecrets, createAnalyticsRoutes, createAuthMiddleware, createAuthRoutes, createNotificationRoutes, createPushRoutes, errorCodeToStatus, extractClientContext, extractClientContextFromReq, generateCSRFToken, getAppSecret, getAppSecretOrDefault, getBootstrapFlags, getBundle, getCSRFToken, getMySqlBundle, getOAuthBundle, getPostgresBundle, getRedisBundle, getS3Bundle, getSession, getSessionFromRequest, getSmtpBundle, invalidateBundleCache, invalidateSecretCache, prefetchBundles, prefetchSecrets, requireAppSecret, requireBundle, requireSession, setOAuthState, unwrap, validateCSRFToken, validateCSRFTokenAsync, validateOAuthState, validateOAuthStateAsync, withAuth, withCSRFProtection, withCSRFToken, withSession };

package/dist/server/index.js

@@ -1732,6 +1732,73 @@ function createPushRoutes(config) {
   return { GET, POST, PUT, DELETE };
 }
 
+// src/server/notifications.ts
+function createNotificationRoutes(config) {
+  const { apiKey, gatewayUrl } = config;
+  async function proxyToGateway(request, method, subPath) {
+    const targetUrl = `${gatewayUrl}/v1/notifications/${subPath}`;
+    const headers2 = {
+      "x-api-key": apiKey,
+      "Content-Type": "application/json"
+    };
+    const session = getSessionFromRequest(request);
+    if (session?.sessionToken) {
+      headers2["Authorization"] = `Bearer ${session.sessionToken}`;
+    }
+    const clientContext = extractClientContext(
+      request
+    );
+    const contextHeaders = buildClientContextHeaders(clientContext);
+    Object.assign(headers2, contextHeaders);
+    const workspaceId = request.headers.get("x-sm-workspace-id");
+    if (workspaceId) {
+      headers2["x-sm-workspace-id"] = workspaceId;
+    }
+    const fetchOptions = {
+      method,
+      headers: headers2
+    };
+    if (method === "PATCH") {
+      try {
+        const body = await request.text();
+        if (body) {
+          fetchOptions.body = body;
+        }
+      } catch {
+      }
+    }
+    let targetUrlWithQuery = targetUrl;
+    if (method === "GET") {
+      const url = new URL(request.url);
+      if (url.search) {
+        targetUrlWithQuery = `${targetUrl}${url.search}`;
+      }
+    }
+    const response = await fetch(targetUrlWithQuery, fetchOptions);
+    const responseBody = await response.text();
+    return new Response(responseBody, {
+      status: response.status,
+      headers: { "Content-Type": "application/json" }
+    });
+  }
+  const GET = async (request, context) => {
+    const params = await context.params;
+    const subPath = params.action?.join("/") || "";
+    return proxyToGateway(request, "GET", subPath);
+  };
+  const PATCH = async (request, context) => {
+    const params = await context.params;
+    const subPath = params.action?.join("/") || "";
+    return proxyToGateway(request, "PATCH", subPath);
+  };
+  const DELETE = async (request, context) => {
+    const params = await context.params;
+    const subPath = params.action?.join("/") || "";
+    return proxyToGateway(request, "DELETE", subPath);
+  };
+  return { GET, PATCH, DELETE };
+}
+
 // src/server/errors.ts
 var ScaleMuleError = class extends Error {
   constructor(code, message, status = 400, details) {
@@ -2355,6 +2422,7 @@ exports.configureSecrets = configureSecrets;
 exports.createAnalyticsRoutes = createAnalyticsRoutes;
 exports.createAuthMiddleware = createAuthMiddleware;
 exports.createAuthRoutes = createAuthRoutes;
+exports.createNotificationRoutes = createNotificationRoutes;
 exports.createPushRoutes = createPushRoutes;
 exports.createServerClient = createServerClient;
 exports.createWebhookHandler = createWebhookHandler;

package/dist/server/index.mjs

@@ -1730,6 +1730,73 @@ function createPushRoutes(config) {
   return { GET, POST, PUT, DELETE };
 }
 
+// src/server/notifications.ts
+function createNotificationRoutes(config) {
+  const { apiKey, gatewayUrl } = config;
+  async function proxyToGateway(request, method, subPath) {
+    const targetUrl = `${gatewayUrl}/v1/notifications/${subPath}`;
+    const headers2 = {
+      "x-api-key": apiKey,
+      "Content-Type": "application/json"
+    };
+    const session = getSessionFromRequest(request);
+    if (session?.sessionToken) {
+      headers2["Authorization"] = `Bearer ${session.sessionToken}`;
+    }
+    const clientContext = extractClientContext(
+      request
+    );
+    const contextHeaders = buildClientContextHeaders(clientContext);
+    Object.assign(headers2, contextHeaders);
+    const workspaceId = request.headers.get("x-sm-workspace-id");
+    if (workspaceId) {
+      headers2["x-sm-workspace-id"] = workspaceId;
+    }
+    const fetchOptions = {
+      method,
+      headers: headers2
+    };
+    if (method === "PATCH") {
+      try {
+        const body = await request.text();
+        if (body) {
+          fetchOptions.body = body;
+        }
+      } catch {
+      }
+    }
+    let targetUrlWithQuery = targetUrl;
+    if (method === "GET") {
+      const url = new URL(request.url);
+      if (url.search) {
+        targetUrlWithQuery = `${targetUrl}${url.search}`;
+      }
+    }
+    const response = await fetch(targetUrlWithQuery, fetchOptions);
+    const responseBody = await response.text();
+    return new Response(responseBody, {
+      status: response.status,
+      headers: { "Content-Type": "application/json" }
+    });
+  }
+  const GET = async (request, context) => {
+    const params = await context.params;
+    const subPath = params.action?.join("/") || "";
+    return proxyToGateway(request, "GET", subPath);
+  };
+  const PATCH = async (request, context) => {
+    const params = await context.params;
+    const subPath = params.action?.join("/") || "";
+    return proxyToGateway(request, "PATCH", subPath);
+  };
+  const DELETE = async (request, context) => {
+    const params = await context.params;
+    const subPath = params.action?.join("/") || "";
+    return proxyToGateway(request, "DELETE", subPath);
+  };
+  return { GET, PATCH, DELETE };
+}
+
 // src/server/errors.ts
 var ScaleMuleError = class extends Error {
   constructor(code, message, status = 400, details) {
@@ -2336,4 +2403,4 @@ async function prefetchBundles(keys) {
   await Promise.all(keys.map((key) => getBundle(key)));
 }
 
-export { CSRF_COOKIE_NAME, CSRF_HEADER_NAME, OAUTH_STATE_COOKIE_NAME, SESSION_COOKIE_NAME, ScaleMuleError, ScaleMuleServer, USER_ID_COOKIE_NAME, apiHandler, buildClientContextHeaders, buildFlagContext, clearOAuthState, clearSession, configureBundles, configureSecrets, createAnalyticsRoutes, createAuthMiddleware, createAuthRoutes, createPushRoutes, createServerClient, createWebhookHandler, createWebhookRoutes, errorCodeToStatus, extractClientContext, extractClientContextFromReq, generateCSRFToken, getAppSecret, getAppSecretOrDefault, getBootstrapFlags, getBundle, getCSRFToken, getMySqlBundle, getOAuthBundle, getPostgresBundle, getRedisBundle, getS3Bundle, getSession, getSessionFromRequest, getSmtpBundle, invalidateBundleCache, invalidateSecretCache, parseWebhookEvent, prefetchBundles, prefetchSecrets, registerVideoWebhook, requireAppSecret, requireBundle, requireSession, resolveGatewayUrl, setOAuthState, unwrap, validateCSRFToken, validateCSRFTokenAsync, validateOAuthState, validateOAuthStateAsync, verifyWebhookSignature, withAuth, withCSRFProtection, withCSRFToken, withSession };
+export { CSRF_COOKIE_NAME, CSRF_HEADER_NAME, OAUTH_STATE_COOKIE_NAME, SESSION_COOKIE_NAME, ScaleMuleError, ScaleMuleServer, USER_ID_COOKIE_NAME, apiHandler, buildClientContextHeaders, buildFlagContext, clearOAuthState, clearSession, configureBundles, configureSecrets, createAnalyticsRoutes, createAuthMiddleware, createAuthRoutes, createNotificationRoutes, createPushRoutes, createServerClient, createWebhookHandler, createWebhookRoutes, errorCodeToStatus, extractClientContext, extractClientContextFromReq, generateCSRFToken, getAppSecret, getAppSecretOrDefault, getBootstrapFlags, getBundle, getCSRFToken, getMySqlBundle, getOAuthBundle, getPostgresBundle, getRedisBundle, getS3Bundle, getSession, getSessionFromRequest, getSmtpBundle, invalidateBundleCache, invalidateSecretCache, parseWebhookEvent, prefetchBundles, prefetchSecrets, registerVideoWebhook, requireAppSecret, requireBundle, requireSession, resolveGatewayUrl, setOAuthState, unwrap, validateCSRFToken, validateCSRFTokenAsync, validateOAuthState, validateOAuthStateAsync, verifyWebhookSignature, withAuth, withCSRFProtection, withCSRFToken, withSession };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/nextjs",
-  "version": "0.0.31",
+  "version": "0.0.33",
   "description": "ScaleMule SDK for Next.js applications - authentication, storage, and user management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -52,7 +52,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@scalemule/sdk": ">=0.0.23"
+    "@scalemule/sdk": "file:../sdk"
   },
   "peerDependencies": {
     "next": ">=14.0.0",