@scalemule/nextjs 0.0.28 → 0.0.29

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { j as StorageAdapter } from './index-DewTyMF2.mjs';
+import { a7 as StorageAdapter } from './index-BoENfro3.mjs';
 
 /**
  * ScaleMule API Client

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { j as StorageAdapter } from './index-DewTyMF2.js';
+import { a7 as StorageAdapter } from './index-BoENfro3.js';
 
 /**
  * ScaleMule API Client

package/dist/{index-DewTyMF2.d.mts → index-BoENfro3.d.mts}

@@ -842,4 +842,4 @@ interface UseBillingReturn {
     }) => Promise<string | null>;
 }
 
-export { type ClientContext as $, type ApiError as A, type MFASMSSetupResponse as B, type ChangePasswordRequest as C, type DeviceFingerprint as D, type MFAVerifyRequest as E, type ForgotPasswordRequest as F, type MFAChallengeResponse as G, type MFAStatus as H, type PhoneSendCodeRequest as I, type PhoneVerifyRequest as J, type PhoneLoginRequest as K, type LoginResponse as L, type MFAMethod as M, type StorageFile as N, type OAuthProvider as O, type Profile as P, type UploadOptions as Q, type RegisterRequest as R, type ScaleMuleConfig as S, type ListFilesResponse as T, type User as U, type VerifyEmailRequest as V, type UploadResponse as W, type SignedUploadUrl as X, type SignedUploadRequest as Y, type SignedUploadResponse as Z, type SignedUploadCompleteRequest as _, type UseAuthReturn as a, type UpdateProfileRequest as a0, type ConnectedAccount as a1, type AccountBalance as a2, type BillingPayment as a3, type BillingRefund as a4, type BillingPayout as a5, type PayoutSchedule as a6, type BillingTransaction as a7, type TransactionSummary as a8, type AnalyticsEvent as a9, type PageViewData as aa, type UTMParams as ab, type DeviceInfo as ac, type EnhancedAnalyticsEvent as ad, type TrackEventResponse as ae, type BatchTrackRequest as af, type UseBillingReturn as b, type ListFilesParams as c, type UseContentReturn as d, type UseUserReturn as e, type UseAnalyticsOptions as f, type UseAnalyticsReturn as g, ScaleMuleApiError as h, type ScaleMuleEnvironment as i, type StorageAdapter as j, type ApiResponse as k, type LoginRequest as l, type LoginResponseWithMFA as m, type LoginDeviceInfo as n, type LoginRiskInfo as o, type RefreshResponse as p, type ResetPasswordRequest as q, type ChangeEmailRequest as r, type Session as s, type OAuthConfig as t, type OAuthStartResponse as u, type OAuthCallbackRequest as v, type OAuthCallbackResponse as w, type LinkedAccount as x, type MFASetupRequest as y, type MFATOTPSetupResponse as z };
+export { type ResetPasswordRequest as $, type ApiError as A, type BatchTrackRequest as B, type ChangeEmailRequest as C, type DeviceFingerprint as D, type EnhancedAnalyticsEvent as E, type ForgotPasswordRequest as F, type MFASetupRequest as G, type MFAStatus as H, type MFATOTPSetupResponse as I, type MFAVerifyRequest as J, type OAuthCallbackResponse as K, type LoginResponse as L, type MFAChallengeResponse as M, type OAuthConfig as N, type OAuthCallbackRequest as O, type OAuthProvider as P, type OAuthStartResponse as Q, type PageViewData as R, type ScaleMuleConfig as S, type PayoutSchedule as T, type User as U, type PhoneLoginRequest as V, type PhoneSendCodeRequest as W, type PhoneVerifyRequest as X, type Profile as Y, type RefreshResponse as Z, type RegisterRequest as _, type UseAuthReturn as a, ScaleMuleApiError as a0, type ScaleMuleEnvironment as a1, type Session as a2, type SignedUploadCompleteRequest as a3, type SignedUploadRequest as a4, type SignedUploadResponse as a5, type SignedUploadUrl as a6, type StorageAdapter as a7, type StorageFile as a8, type TrackEventResponse as a9, type TransactionSummary as aa, type UTMParams as ab, type UpdateProfileRequest as ac, type UploadOptions as ad, type UploadResponse as ae, type VerifyEmailRequest as af, type UseBillingReturn as b, type ListFilesParams as c, type UseContentReturn as d, type UseUserReturn as e, type UseAnalyticsOptions as f, type UseAnalyticsReturn as g, type AccountBalance as h, type AnalyticsEvent as i, type ApiResponse as j, type BillingPayment as k, type BillingPayout as l, type BillingRefund as m, type BillingTransaction as n, type ChangePasswordRequest as o, type ClientContext as p, type ConnectedAccount as q, type DeviceInfo as r, type LinkedAccount as s, type ListFilesResponse as t, type LoginDeviceInfo as u, type LoginRequest as v, type LoginResponseWithMFA as w, type LoginRiskInfo as x, type MFAMethod as y, type MFASMSSetupResponse as z };

package/dist/{index-DewTyMF2.d.ts → index-BoENfro3.d.ts}

@@ -842,4 +842,4 @@ interface UseBillingReturn {
     }) => Promise<string | null>;
 }
 
-export { type ClientContext as $, type ApiError as A, type MFASMSSetupResponse as B, type ChangePasswordRequest as C, type DeviceFingerprint as D, type MFAVerifyRequest as E, type ForgotPasswordRequest as F, type MFAChallengeResponse as G, type MFAStatus as H, type PhoneSendCodeRequest as I, type PhoneVerifyRequest as J, type PhoneLoginRequest as K, type LoginResponse as L, type MFAMethod as M, type StorageFile as N, type OAuthProvider as O, type Profile as P, type UploadOptions as Q, type RegisterRequest as R, type ScaleMuleConfig as S, type ListFilesResponse as T, type User as U, type VerifyEmailRequest as V, type UploadResponse as W, type SignedUploadUrl as X, type SignedUploadRequest as Y, type SignedUploadResponse as Z, type SignedUploadCompleteRequest as _, type UseAuthReturn as a, type UpdateProfileRequest as a0, type ConnectedAccount as a1, type AccountBalance as a2, type BillingPayment as a3, type BillingRefund as a4, type BillingPayout as a5, type PayoutSchedule as a6, type BillingTransaction as a7, type TransactionSummary as a8, type AnalyticsEvent as a9, type PageViewData as aa, type UTMParams as ab, type DeviceInfo as ac, type EnhancedAnalyticsEvent as ad, type TrackEventResponse as ae, type BatchTrackRequest as af, type UseBillingReturn as b, type ListFilesParams as c, type UseContentReturn as d, type UseUserReturn as e, type UseAnalyticsOptions as f, type UseAnalyticsReturn as g, ScaleMuleApiError as h, type ScaleMuleEnvironment as i, type StorageAdapter as j, type ApiResponse as k, type LoginRequest as l, type LoginResponseWithMFA as m, type LoginDeviceInfo as n, type LoginRiskInfo as o, type RefreshResponse as p, type ResetPasswordRequest as q, type ChangeEmailRequest as r, type Session as s, type OAuthConfig as t, type OAuthStartResponse as u, type OAuthCallbackRequest as v, type OAuthCallbackResponse as w, type LinkedAccount as x, type MFASetupRequest as y, type MFATOTPSetupResponse as z };
+export { type ResetPasswordRequest as $, type ApiError as A, type BatchTrackRequest as B, type ChangeEmailRequest as C, type DeviceFingerprint as D, type EnhancedAnalyticsEvent as E, type ForgotPasswordRequest as F, type MFASetupRequest as G, type MFAStatus as H, type MFATOTPSetupResponse as I, type MFAVerifyRequest as J, type OAuthCallbackResponse as K, type LoginResponse as L, type MFAChallengeResponse as M, type OAuthConfig as N, type OAuthCallbackRequest as O, type OAuthProvider as P, type OAuthStartResponse as Q, type PageViewData as R, type ScaleMuleConfig as S, type PayoutSchedule as T, type User as U, type PhoneLoginRequest as V, type PhoneSendCodeRequest as W, type PhoneVerifyRequest as X, type Profile as Y, type RefreshResponse as Z, type RegisterRequest as _, type UseAuthReturn as a, ScaleMuleApiError as a0, type ScaleMuleEnvironment as a1, type Session as a2, type SignedUploadCompleteRequest as a3, type SignedUploadRequest as a4, type SignedUploadResponse as a5, type SignedUploadUrl as a6, type StorageAdapter as a7, type StorageFile as a8, type TrackEventResponse as a9, type TransactionSummary as aa, type UTMParams as ab, type UpdateProfileRequest as ac, type UploadOptions as ad, type UploadResponse as ae, type VerifyEmailRequest as af, type UseBillingReturn as b, type ListFilesParams as c, type UseContentReturn as d, type UseUserReturn as e, type UseAnalyticsOptions as f, type UseAnalyticsReturn as g, type AccountBalance as h, type AnalyticsEvent as i, type ApiResponse as j, type BillingPayment as k, type BillingPayout as l, type BillingRefund as m, type BillingTransaction as n, type ChangePasswordRequest as o, type ClientContext as p, type ConnectedAccount as q, type DeviceInfo as r, type LinkedAccount as s, type ListFilesResponse as t, type LoginDeviceInfo as u, type LoginRequest as v, type LoginResponseWithMFA as w, type LoginRiskInfo as x, type MFAMethod as y, type MFASMSSetupResponse as z };

package/dist/index.d.mts

@@ -2,8 +2,8 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 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-DewTyMF2.mjs';
-export { a2 as AccountBalance, a9 as AnalyticsEvent, k as ApiResponse, af as BatchTrackRequest, a3 as BillingPayment, a5 as BillingPayout, a4 as BillingRefund, a7 as BillingTransaction, r as ChangeEmailRequest, C as ChangePasswordRequest, $ as ClientContext, a1 as ConnectedAccount, D as DeviceFingerprint, ac as DeviceInfo, ad as EnhancedAnalyticsEvent, F as ForgotPasswordRequest, x as LinkedAccount, T as ListFilesResponse, n as LoginDeviceInfo, l as LoginRequest, m as LoginResponseWithMFA, o as LoginRiskInfo, G as MFAChallengeResponse, M as MFAMethod, B as MFASMSSetupResponse, y as MFASetupRequest, H as MFAStatus, z as MFATOTPSetupResponse, E as MFAVerifyRequest, v as OAuthCallbackRequest, w as OAuthCallbackResponse, t as OAuthConfig, O as OAuthProvider, u as OAuthStartResponse, aa as PageViewData, a6 as PayoutSchedule, K as PhoneLoginRequest, I as PhoneSendCodeRequest, J as PhoneVerifyRequest, P as Profile, p as RefreshResponse, R as RegisterRequest, q as ResetPasswordRequest, h as ScaleMuleApiError, i as ScaleMuleEnvironment, s as Session, _ as SignedUploadCompleteRequest, Y as SignedUploadRequest, Z as SignedUploadResponse, X as SignedUploadUrl, j as StorageAdapter, N as StorageFile, ae as TrackEventResponse, a8 as TransactionSummary, ab as UTMParams, a0 as UpdateProfileRequest, Q as UploadOptions, W as UploadResponse, V as VerifyEmailRequest } from './index-DewTyMF2.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';
+export { h as AccountBalance, i as AnalyticsEvent, j as ApiResponse, B as BatchTrackRequest, k as BillingPayment, l as BillingPayout, m as BillingRefund, n as BillingTransaction, C as ChangeEmailRequest, o as ChangePasswordRequest, p as ClientContext, q as ConnectedAccount, D as DeviceFingerprint, r as DeviceInfo, E as EnhancedAnalyticsEvent, F as ForgotPasswordRequest, s as LinkedAccount, t as ListFilesResponse, u as LoginDeviceInfo, v as LoginRequest, w as LoginResponseWithMFA, x as LoginRiskInfo, M as MFAChallengeResponse, y as MFAMethod, z as MFASMSSetupResponse, G as MFASetupRequest, H as MFAStatus, I as MFATOTPSetupResponse, J as MFAVerifyRequest, O as OAuthCallbackRequest, K as OAuthCallbackResponse, N as OAuthConfig, P as OAuthProvider, Q as OAuthStartResponse, R as PageViewData, T as PayoutSchedule, V as PhoneLoginRequest, W as PhoneSendCodeRequest, X as PhoneVerifyRequest, Y as Profile, Z as RefreshResponse, _ as RegisterRequest, $ as ResetPasswordRequest, a0 as ScaleMuleApiError, a1 as ScaleMuleEnvironment, a2 as Session, a3 as SignedUploadCompleteRequest, a4 as SignedUploadRequest, a5 as SignedUploadResponse, a6 as SignedUploadUrl, a7 as StorageAdapter, a8 as StorageFile, a9 as TrackEventResponse, aa as TransactionSummary, ab as UTMParams, ac as UpdateProfileRequest, ad as UploadOptions, ae as UploadResponse, af as VerifyEmailRequest } from './index-BoENfro3.mjs';
 
 interface ScaleMuleContextValue {
     /** The API client instance */
@@ -289,6 +289,36 @@ interface UseFeatureFlagsReturn {
 }
 declare function useFeatureFlags(options?: UseFeatureFlagsOptions): UseFeatureFlagsReturn;
 
+interface UsePushNotificationsOptions {
+    /** Service worker URL (default: '/sw.js') */
+    serviceWorkerUrl?: string;
+    /** Push proxy URL (default: '/api/push') */
+    pushProxyUrl?: string;
+    /** Called when a push notification is received while app is in foreground */
+    onNotification?: (data: unknown) => void;
+}
+interface UsePushNotificationsReturn {
+    /** Whether the browser supports Web Push */
+    isSupported: boolean;
+    /** Current notification permission state */
+    permission: NotificationPermission | 'unsupported';
+    /** Whether push is currently subscribed */
+    isSubscribed: boolean;
+    /** Whether an operation is in progress */
+    isLoading: boolean;
+    /** Last error */
+    error: ApiError | null;
+    /** Request permission and subscribe to push notifications */
+    subscribe: () => Promise<void>;
+    /** Unsubscribe from push notifications */
+    unsubscribe: () => Promise<void>;
+    /** Clear user association (call before logout) */
+    disassociateUser: () => Promise<void>;
+    /** The push token ID from backend registration */
+    tokenId: string | null;
+}
+declare function usePushNotifications(options?: UsePushNotificationsOptions): UsePushNotificationsReturn;
+
 /**
  * Client-side validation helpers
  *
@@ -447,4 +477,4 @@ declare function createSafeLogger(prefix: string): {
     error: (message: string, data?: unknown) => void;
 };
 
-export { ApiError, type FeatureFlagEvaluation, type FeatureFlagEvaluation as FeatureFlagResult, ListFilesParams, LoginResponse, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseFeatureFlagsOptions, type UseFeatureFlagsReturn, type UseFeatureFlagsOptions as UseFlagsOptions, type UseFeatureFlagsReturn as UseFlagsReturn, type UseRealtimeOptions, type UseRealtimeReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };
+export { ApiError, type FeatureFlagEvaluation, type FeatureFlagEvaluation as FeatureFlagResult, ListFilesParams, LoginResponse, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseFeatureFlagsOptions, type UseFeatureFlagsReturn, type UseFeatureFlagsOptions as UseFlagsOptions, type UseFeatureFlagsReturn as UseFlagsReturn, type UsePushNotificationsOptions, type UsePushNotificationsReturn, type UseRealtimeOptions, type UseRealtimeReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, usePushNotifications, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 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-DewTyMF2.js';
-export { a2 as AccountBalance, a9 as AnalyticsEvent, k as ApiResponse, af as BatchTrackRequest, a3 as BillingPayment, a5 as BillingPayout, a4 as BillingRefund, a7 as BillingTransaction, r as ChangeEmailRequest, C as ChangePasswordRequest, $ as ClientContext, a1 as ConnectedAccount, D as DeviceFingerprint, ac as DeviceInfo, ad as EnhancedAnalyticsEvent, F as ForgotPasswordRequest, x as LinkedAccount, T as ListFilesResponse, n as LoginDeviceInfo, l as LoginRequest, m as LoginResponseWithMFA, o as LoginRiskInfo, G as MFAChallengeResponse, M as MFAMethod, B as MFASMSSetupResponse, y as MFASetupRequest, H as MFAStatus, z as MFATOTPSetupResponse, E as MFAVerifyRequest, v as OAuthCallbackRequest, w as OAuthCallbackResponse, t as OAuthConfig, O as OAuthProvider, u as OAuthStartResponse, aa as PageViewData, a6 as PayoutSchedule, K as PhoneLoginRequest, I as PhoneSendCodeRequest, J as PhoneVerifyRequest, P as Profile, p as RefreshResponse, R as RegisterRequest, q as ResetPasswordRequest, h as ScaleMuleApiError, i as ScaleMuleEnvironment, s as Session, _ as SignedUploadCompleteRequest, Y as SignedUploadRequest, Z as SignedUploadResponse, X as SignedUploadUrl, j as StorageAdapter, N as StorageFile, ae as TrackEventResponse, a8 as TransactionSummary, ab as UTMParams, a0 as UpdateProfileRequest, Q as UploadOptions, W as UploadResponse, V as VerifyEmailRequest } from './index-DewTyMF2.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';
+export { h as AccountBalance, i as AnalyticsEvent, j as ApiResponse, B as BatchTrackRequest, k as BillingPayment, l as BillingPayout, m as BillingRefund, n as BillingTransaction, C as ChangeEmailRequest, o as ChangePasswordRequest, p as ClientContext, q as ConnectedAccount, D as DeviceFingerprint, r as DeviceInfo, E as EnhancedAnalyticsEvent, F as ForgotPasswordRequest, s as LinkedAccount, t as ListFilesResponse, u as LoginDeviceInfo, v as LoginRequest, w as LoginResponseWithMFA, x as LoginRiskInfo, M as MFAChallengeResponse, y as MFAMethod, z as MFASMSSetupResponse, G as MFASetupRequest, H as MFAStatus, I as MFATOTPSetupResponse, J as MFAVerifyRequest, O as OAuthCallbackRequest, K as OAuthCallbackResponse, N as OAuthConfig, P as OAuthProvider, Q as OAuthStartResponse, R as PageViewData, T as PayoutSchedule, V as PhoneLoginRequest, W as PhoneSendCodeRequest, X as PhoneVerifyRequest, Y as Profile, Z as RefreshResponse, _ as RegisterRequest, $ as ResetPasswordRequest, a0 as ScaleMuleApiError, a1 as ScaleMuleEnvironment, a2 as Session, a3 as SignedUploadCompleteRequest, a4 as SignedUploadRequest, a5 as SignedUploadResponse, a6 as SignedUploadUrl, a7 as StorageAdapter, a8 as StorageFile, a9 as TrackEventResponse, aa as TransactionSummary, ab as UTMParams, ac as UpdateProfileRequest, ad as UploadOptions, ae as UploadResponse, af as VerifyEmailRequest } from './index-BoENfro3.js';
 
 interface ScaleMuleContextValue {
     /** The API client instance */
@@ -289,6 +289,36 @@ interface UseFeatureFlagsReturn {
 }
 declare function useFeatureFlags(options?: UseFeatureFlagsOptions): UseFeatureFlagsReturn;
 
+interface UsePushNotificationsOptions {
+    /** Service worker URL (default: '/sw.js') */
+    serviceWorkerUrl?: string;
+    /** Push proxy URL (default: '/api/push') */
+    pushProxyUrl?: string;
+    /** Called when a push notification is received while app is in foreground */
+    onNotification?: (data: unknown) => void;
+}
+interface UsePushNotificationsReturn {
+    /** Whether the browser supports Web Push */
+    isSupported: boolean;
+    /** Current notification permission state */
+    permission: NotificationPermission | 'unsupported';
+    /** Whether push is currently subscribed */
+    isSubscribed: boolean;
+    /** Whether an operation is in progress */
+    isLoading: boolean;
+    /** Last error */
+    error: ApiError | null;
+    /** Request permission and subscribe to push notifications */
+    subscribe: () => Promise<void>;
+    /** Unsubscribe from push notifications */
+    unsubscribe: () => Promise<void>;
+    /** Clear user association (call before logout) */
+    disassociateUser: () => Promise<void>;
+    /** The push token ID from backend registration */
+    tokenId: string | null;
+}
+declare function usePushNotifications(options?: UsePushNotificationsOptions): UsePushNotificationsReturn;
+
 /**
  * Client-side validation helpers
  *
@@ -447,4 +477,4 @@ declare function createSafeLogger(prefix: string): {
     error: (message: string, data?: unknown) => void;
 };
 
-export { ApiError, type FeatureFlagEvaluation, type FeatureFlagEvaluation as FeatureFlagResult, ListFilesParams, LoginResponse, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseFeatureFlagsOptions, type UseFeatureFlagsReturn, type UseFeatureFlagsOptions as UseFlagsOptions, type UseFeatureFlagsReturn as UseFlagsReturn, type UseRealtimeOptions, type UseRealtimeReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };
+export { ApiError, type FeatureFlagEvaluation, type FeatureFlagEvaluation as FeatureFlagResult, ListFilesParams, LoginResponse, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseFeatureFlagsOptions, type UseFeatureFlagsReturn, type UseFeatureFlagsOptions as UseFlagsOptions, type UseFeatureFlagsReturn as UseFlagsReturn, type UsePushNotificationsOptions, type UsePushNotificationsReturn, type UseRealtimeOptions, type UseRealtimeReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, usePushNotifications, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };

package/dist/index.js

@@ -2,6 +2,7 @@
 
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
+var sdk = require('@scalemule/sdk');
 
 // src/provider.tsx
 
@@ -3053,6 +3054,174 @@ function useFeatureFlags(options = {}) {
     getFlag
   };
 }
+function getCsrfToken() {
+  if (typeof document === "undefined") return "";
+  const match = document.cookie.match(/(?:^|;\s*)sm_csrf=([^;]*)/);
+  return match ? decodeURIComponent(match[1]) : "";
+}
+function usePushNotifications(options = {}) {
+  const { serviceWorkerUrl = "/sw.js", pushProxyUrl = "/api/push", onNotification } = options;
+  const { user } = useScaleMule();
+  const [isSupported, setIsSupported] = react.useState(false);
+  const [permission, setPermission] = react.useState("unsupported");
+  const [isSubscribed, setIsSubscribed] = react.useState(false);
+  const [isLoading, setIsLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const [tokenId, setTokenId] = react.useState(null);
+  const onNotificationRef = react.useRef(onNotification);
+  react.useEffect(() => {
+    onNotificationRef.current = onNotification;
+  }, [onNotification]);
+  const prevUserRef = react.useRef(null);
+  const fetcher = react.useMemo(() => {
+    async function proxyGet(path) {
+      const res = await fetch(`${pushProxyUrl}/${path}`);
+      const json = await res.json();
+      if (!json.success) throw new Error(json.error?.message || "Request failed");
+      return json.data;
+    }
+    async function proxyPost(path, body) {
+      const res = await fetch(`${pushProxyUrl}/${path}`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-csrf-token": getCsrfToken()
+        },
+        body: body ? JSON.stringify(body) : void 0
+      });
+      const json = await res.json();
+      if (!json.success) throw new Error(json.error?.message || "Request failed");
+      return json.data;
+    }
+    async function proxyPut(path, body) {
+      const res = await fetch(`${pushProxyUrl}/${path}`, {
+        method: "PUT",
+        headers: {
+          "Content-Type": "application/json",
+          "x-csrf-token": getCsrfToken()
+        },
+        body: body ? JSON.stringify(body) : void 0
+      });
+      const json = await res.json();
+      if (!json.success) throw new Error(json.error?.message || "Request failed");
+      return json.data;
+    }
+    async function proxyDelete(path) {
+      const res = await fetch(`${pushProxyUrl}/${path}`, {
+        method: "DELETE",
+        headers: {
+          "x-csrf-token": getCsrfToken()
+        }
+      });
+      const json = await res.json();
+      if (!json.success) throw new Error(json.error?.message || "Request failed");
+    }
+    return {
+      getSettings: () => proxyGet("settings/me"),
+      registerToken: (data) => proxyPost("register", data),
+      unregisterToken: (id) => proxyDelete(`tokens/by-id/${id}`),
+      associateUser: (id) => proxyPut(`tokens/by-id/${id}/user`, {}),
+      disassociateUser: (id) => proxyDelete(`tokens/by-id/${id}/user`)
+    };
+  }, [pushProxyUrl]);
+  const manager = react.useMemo(() => {
+    if (typeof window === "undefined") return null;
+    try {
+      return new sdk.WebPushManager({ fetcher, serviceWorkerUrl });
+    } catch {
+      return null;
+    }
+  }, [fetcher, serviceWorkerUrl]);
+  react.useEffect(() => {
+    if (!manager) return;
+    const supported = manager.isSupported();
+    setIsSupported(supported);
+    setPermission(manager.getPermissionState());
+    if (supported) {
+      manager.isSubscribed().then((sub) => {
+        setIsSubscribed(sub);
+        setTokenId(manager.getTokenId());
+      });
+    }
+  }, [manager]);
+  react.useEffect(() => {
+    if (typeof navigator === "undefined" || !("serviceWorker" in navigator)) return;
+    function handleMessage(event) {
+      if (event.data?.type === "push-received") {
+        onNotificationRef.current?.(event.data.payload);
+      }
+    }
+    navigator.serviceWorker.addEventListener("message", handleMessage);
+    return () => navigator.serviceWorker.removeEventListener("message", handleMessage);
+  }, []);
+  react.useEffect(() => {
+    if (!manager) return;
+    const currentUserId = user?.id || null;
+    const prevUserId = prevUserRef.current;
+    if (currentUserId && !prevUserId && isSubscribed) {
+      manager.associateUser().catch(() => {
+      });
+    }
+    prevUserRef.current = currentUserId;
+  }, [user?.id, manager, isSubscribed]);
+  const subscribe = react.useCallback(async () => {
+    if (!manager) return;
+    setIsLoading(true);
+    setError(null);
+    try {
+      const result = await manager.subscribe();
+      if (result) {
+        setIsSubscribed(true);
+        setTokenId(result.tokenId);
+        setPermission("granted");
+      } else {
+        setPermission(manager.getPermissionState());
+      }
+    } catch (e) {
+      setError({
+        code: "PUSH_SUBSCRIBE_ERROR",
+        message: e instanceof Error ? e.message : "Failed to subscribe"
+      });
+    } finally {
+      setIsLoading(false);
+    }
+  }, [manager]);
+  const unsubscribe = react.useCallback(async () => {
+    if (!manager) return;
+    setIsLoading(true);
+    setError(null);
+    try {
+      await manager.unsubscribe();
+      setIsSubscribed(false);
+      setTokenId(null);
+    } catch (e) {
+      setError({
+        code: "PUSH_UNSUBSCRIBE_ERROR",
+        message: e instanceof Error ? e.message : "Failed to unsubscribe"
+      });
+    } finally {
+      setIsLoading(false);
+    }
+  }, [manager]);
+  const disassociateUser = react.useCallback(async () => {
+    if (!manager) return;
+    try {
+      await manager.disassociateUser();
+    } catch {
+    }
+  }, [manager]);
+  return {
+    isSupported,
+    permission,
+    isSubscribed,
+    isLoading,
+    error,
+    subscribe,
+    unsubscribe,
+    disassociateUser,
+    tokenId
+  };
+}
 
 // src/validation.ts
 var phoneCountries = [
@@ -3359,6 +3528,7 @@ exports.useAuth = useAuth;
 exports.useBilling = useBilling;
 exports.useContent = useContent;
 exports.useFeatureFlags = useFeatureFlags;
+exports.usePushNotifications = usePushNotifications;
 exports.useRealtime = useRealtime;
 exports.useScaleMule = useScaleMule;
 exports.useScaleMuleClient = useScaleMuleClient;

package/dist/index.mjs

@@ -1,5 +1,6 @@
 import { createContext, useState, useMemo, useEffect, useCallback, useContext, useRef } from 'react';
 import { jsx } from 'react/jsx-runtime';
+import { WebPushManager } from '@scalemule/sdk';
 
 // src/provider.tsx
 
@@ -3051,6 +3052,174 @@ function useFeatureFlags(options = {}) {
     getFlag
   };
 }
+function getCsrfToken() {
+  if (typeof document === "undefined") return "";
+  const match = document.cookie.match(/(?:^|;\s*)sm_csrf=([^;]*)/);
+  return match ? decodeURIComponent(match[1]) : "";
+}
+function usePushNotifications(options = {}) {
+  const { serviceWorkerUrl = "/sw.js", pushProxyUrl = "/api/push", onNotification } = options;
+  const { user } = useScaleMule();
+  const [isSupported, setIsSupported] = useState(false);
+  const [permission, setPermission] = useState("unsupported");
+  const [isSubscribed, setIsSubscribed] = useState(false);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [tokenId, setTokenId] = useState(null);
+  const onNotificationRef = useRef(onNotification);
+  useEffect(() => {
+    onNotificationRef.current = onNotification;
+  }, [onNotification]);
+  const prevUserRef = useRef(null);
+  const fetcher = useMemo(() => {
+    async function proxyGet(path) {
+      const res = await fetch(`${pushProxyUrl}/${path}`);
+      const json = await res.json();
+      if (!json.success) throw new Error(json.error?.message || "Request failed");
+      return json.data;
+    }
+    async function proxyPost(path, body) {
+      const res = await fetch(`${pushProxyUrl}/${path}`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-csrf-token": getCsrfToken()
+        },
+        body: body ? JSON.stringify(body) : void 0
+      });
+      const json = await res.json();
+      if (!json.success) throw new Error(json.error?.message || "Request failed");
+      return json.data;
+    }
+    async function proxyPut(path, body) {
+      const res = await fetch(`${pushProxyUrl}/${path}`, {
+        method: "PUT",
+        headers: {
+          "Content-Type": "application/json",
+          "x-csrf-token": getCsrfToken()
+        },
+        body: body ? JSON.stringify(body) : void 0
+      });
+      const json = await res.json();
+      if (!json.success) throw new Error(json.error?.message || "Request failed");
+      return json.data;
+    }
+    async function proxyDelete(path) {
+      const res = await fetch(`${pushProxyUrl}/${path}`, {
+        method: "DELETE",
+        headers: {
+          "x-csrf-token": getCsrfToken()
+        }
+      });
+      const json = await res.json();
+      if (!json.success) throw new Error(json.error?.message || "Request failed");
+    }
+    return {
+      getSettings: () => proxyGet("settings/me"),
+      registerToken: (data) => proxyPost("register", data),
+      unregisterToken: (id) => proxyDelete(`tokens/by-id/${id}`),
+      associateUser: (id) => proxyPut(`tokens/by-id/${id}/user`, {}),
+      disassociateUser: (id) => proxyDelete(`tokens/by-id/${id}/user`)
+    };
+  }, [pushProxyUrl]);
+  const manager = useMemo(() => {
+    if (typeof window === "undefined") return null;
+    try {
+      return new WebPushManager({ fetcher, serviceWorkerUrl });
+    } catch {
+      return null;
+    }
+  }, [fetcher, serviceWorkerUrl]);
+  useEffect(() => {
+    if (!manager) return;
+    const supported = manager.isSupported();
+    setIsSupported(supported);
+    setPermission(manager.getPermissionState());
+    if (supported) {
+      manager.isSubscribed().then((sub) => {
+        setIsSubscribed(sub);
+        setTokenId(manager.getTokenId());
+      });
+    }
+  }, [manager]);
+  useEffect(() => {
+    if (typeof navigator === "undefined" || !("serviceWorker" in navigator)) return;
+    function handleMessage(event) {
+      if (event.data?.type === "push-received") {
+        onNotificationRef.current?.(event.data.payload);
+      }
+    }
+    navigator.serviceWorker.addEventListener("message", handleMessage);
+    return () => navigator.serviceWorker.removeEventListener("message", handleMessage);
+  }, []);
+  useEffect(() => {
+    if (!manager) return;
+    const currentUserId = user?.id || null;
+    const prevUserId = prevUserRef.current;
+    if (currentUserId && !prevUserId && isSubscribed) {
+      manager.associateUser().catch(() => {
+      });
+    }
+    prevUserRef.current = currentUserId;
+  }, [user?.id, manager, isSubscribed]);
+  const subscribe = useCallback(async () => {
+    if (!manager) return;
+    setIsLoading(true);
+    setError(null);
+    try {
+      const result = await manager.subscribe();
+      if (result) {
+        setIsSubscribed(true);
+        setTokenId(result.tokenId);
+        setPermission("granted");
+      } else {
+        setPermission(manager.getPermissionState());
+      }
+    } catch (e) {
+      setError({
+        code: "PUSH_SUBSCRIBE_ERROR",
+        message: e instanceof Error ? e.message : "Failed to subscribe"
+      });
+    } finally {
+      setIsLoading(false);
+    }
+  }, [manager]);
+  const unsubscribe = useCallback(async () => {
+    if (!manager) return;
+    setIsLoading(true);
+    setError(null);
+    try {
+      await manager.unsubscribe();
+      setIsSubscribed(false);
+      setTokenId(null);
+    } catch (e) {
+      setError({
+        code: "PUSH_UNSUBSCRIBE_ERROR",
+        message: e instanceof Error ? e.message : "Failed to unsubscribe"
+      });
+    } finally {
+      setIsLoading(false);
+    }
+  }, [manager]);
+  const disassociateUser = useCallback(async () => {
+    if (!manager) return;
+    try {
+      await manager.disassociateUser();
+    } catch {
+    }
+  }, [manager]);
+  return {
+    isSupported,
+    permission,
+    isSubscribed,
+    isLoading,
+    error,
+    subscribe,
+    unsubscribe,
+    disassociateUser,
+    tokenId
+  };
+}
 
 // src/validation.ts
 var phoneCountries = [
@@ -3343,4 +3512,4 @@ function createSafeLogger(prefix) {
   };
 }
 
-export { ScaleMuleApiError, ScaleMuleClient, ScaleMuleProvider, composePhone, createClient, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };
+export { ScaleMuleApiError, ScaleMuleClient, ScaleMuleProvider, composePhone, createClient, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, usePushNotifications, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };

package/dist/server/index.d.mts

@@ -1,6 +1,6 @@
-import { S as ServerConfig } from '../webhook-handler-DS0r_w4M.mjs';
-export { a as ScaleMuleServer, e as VideoFailedEvent, V as VideoReadyEvent, g as VideoTranscodedEvent, f as VideoUploadedEvent, W as WebhookEvent, h as WebhookRoutesConfig, c as createServerClient, i as createWebhookHandler, d as createWebhookRoutes, p as parseWebhookEvent, b as registerVideoWebhook, r as resolveGatewayUrl, v as verifyWebhookSignature } from '../webhook-handler-DS0r_w4M.mjs';
-import { $ as ClientContext, A as ApiError } from '../index-DewTyMF2.mjs';
+import { S as ServerConfig } from '../webhook-handler-Cz9jtet2.mjs';
+export { a as ScaleMuleServer, V as VideoFailedEvent, b as VideoReadyEvent, c as VideoTranscodedEvent, d as VideoUploadedEvent, W as WebhookEvent, e as WebhookRoutesConfig, f as createServerClient, g as createWebhookHandler, h as createWebhookRoutes, p as parseWebhookEvent, r as registerVideoWebhook, i as resolveGatewayUrl, v as verifyWebhookSignature } from '../webhook-handler-Cz9jtet2.mjs';
+import { p as ClientContext, A as ApiError } from '../index-BoENfro3.mjs';
 import { NextRequest, NextResponse } from 'next/server';
 
 /**
@@ -231,7 +231,7 @@ interface AuthRoutesConfig {
         email: string;
     }) => void | Promise<void>;
 }
-type RouteHandler = (request: Request, context: {
+type RouteHandler$1 = (request: Request, context: {
     params: Promise<{
         scalemule?: string[];
     }>;
@@ -264,10 +264,10 @@ type RouteHandler = (request: Request, context: {
  * - POST /api/auth/verify-email - Verify email
  */
 declare function createAuthRoutes(config?: AuthRoutesConfig): {
-    GET: RouteHandler;
-    POST: RouteHandler;
-    DELETE: RouteHandler;
-    PATCH: RouteHandler;
+    GET: RouteHandler$1;
+    POST: RouteHandler$1;
+    DELETE: RouteHandler$1;
+    PATCH: RouteHandler$1;
 };
 interface AnalyticsTrackingGateConfig {
     /** Feature flag key used to decide whether to forward analytics */
@@ -346,7 +346,44 @@ interface AnalyticsRoutesConfig {
  * ```
  */
 declare function createAnalyticsRoutes(config?: AnalyticsRoutesConfig): {
+    POST: RouteHandler$1;
+};
+
+/**
+ * Push Notification Proxy Routes
+ *
+ * Drop-in route handlers for Next.js App Router that proxy push notification
+ * requests to the ScaleMule gateway. Follows the same pattern as createAuthRoutes().
+ *
+ * @example
+ * ```ts
+ * // app/api/push/[...action]/route.ts
+ * import { createPushRoutes } from '@scalemule/nextjs/server'
+ *
+ * export const { GET, POST, PUT, DELETE } = createPushRoutes({
+ *   apiKey: process.env.SCALEMULE_API_KEY!,
+ *   gatewayUrl: process.env.SCALEMULE_API_URL!,
+ * })
+ * ```
+ */
+interface PushRoutesConfig {
+    /** Server-side secret API key */
+    apiKey: string;
+    /** Gateway URL (e.g., https://api.scalemule.com) */
+    gatewayUrl: string;
+    /** Enable CSRF validation on POST/PUT/DELETE (default: true) */
+    csrf?: boolean;
+}
+type RouteHandler = (request: Request, context: {
+    params: Promise<{
+        action?: string[];
+    }>;
+}) => Promise<Response>;
+declare function createPushRoutes(config: PushRoutesConfig): {
+    GET: RouteHandler;
     POST: RouteHandler;
+    PUT: RouteHandler;
+    DELETE: RouteHandler;
 };
 
 /**
@@ -940,4 +977,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 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, 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, 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 };

package/dist/server/index.d.ts

@@ -1,6 +1,6 @@
-import { S as ServerConfig } from '../webhook-handler-CQ2lZgy0.js';
-export { a as ScaleMuleServer, e as VideoFailedEvent, V as VideoReadyEvent, g as VideoTranscodedEvent, f as VideoUploadedEvent, W as WebhookEvent, h as WebhookRoutesConfig, c as createServerClient, i as createWebhookHandler, d as createWebhookRoutes, p as parseWebhookEvent, b as registerVideoWebhook, r as resolveGatewayUrl, v as verifyWebhookSignature } from '../webhook-handler-CQ2lZgy0.js';
-import { $ as ClientContext, A as ApiError } from '../index-DewTyMF2.js';
+import { S as ServerConfig } from '../webhook-handler-CjSSCdvI.js';
+export { a as ScaleMuleServer, V as VideoFailedEvent, b as VideoReadyEvent, c as VideoTranscodedEvent, d as VideoUploadedEvent, W as WebhookEvent, e as WebhookRoutesConfig, f as createServerClient, g as createWebhookHandler, h as createWebhookRoutes, p as parseWebhookEvent, r as registerVideoWebhook, i as resolveGatewayUrl, v as verifyWebhookSignature } from '../webhook-handler-CjSSCdvI.js';
+import { p as ClientContext, A as ApiError } from '../index-BoENfro3.js';
 import { NextRequest, NextResponse } from 'next/server';
 
 /**
@@ -231,7 +231,7 @@ interface AuthRoutesConfig {
         email: string;
     }) => void | Promise<void>;
 }
-type RouteHandler = (request: Request, context: {
+type RouteHandler$1 = (request: Request, context: {
     params: Promise<{
         scalemule?: string[];
     }>;
@@ -264,10 +264,10 @@ type RouteHandler = (request: Request, context: {
  * - POST /api/auth/verify-email - Verify email
  */
 declare function createAuthRoutes(config?: AuthRoutesConfig): {
-    GET: RouteHandler;
-    POST: RouteHandler;
-    DELETE: RouteHandler;
-    PATCH: RouteHandler;
+    GET: RouteHandler$1;
+    POST: RouteHandler$1;
+    DELETE: RouteHandler$1;
+    PATCH: RouteHandler$1;
 };
 interface AnalyticsTrackingGateConfig {
     /** Feature flag key used to decide whether to forward analytics */
@@ -346,7 +346,44 @@ interface AnalyticsRoutesConfig {
  * ```
  */
 declare function createAnalyticsRoutes(config?: AnalyticsRoutesConfig): {
+    POST: RouteHandler$1;
+};
+
+/**
+ * Push Notification Proxy Routes
+ *
+ * Drop-in route handlers for Next.js App Router that proxy push notification
+ * requests to the ScaleMule gateway. Follows the same pattern as createAuthRoutes().
+ *
+ * @example
+ * ```ts
+ * // app/api/push/[...action]/route.ts
+ * import { createPushRoutes } from '@scalemule/nextjs/server'
+ *
+ * export const { GET, POST, PUT, DELETE } = createPushRoutes({
+ *   apiKey: process.env.SCALEMULE_API_KEY!,
+ *   gatewayUrl: process.env.SCALEMULE_API_URL!,
+ * })
+ * ```
+ */
+interface PushRoutesConfig {
+    /** Server-side secret API key */
+    apiKey: string;
+    /** Gateway URL (e.g., https://api.scalemule.com) */
+    gatewayUrl: string;
+    /** Enable CSRF validation on POST/PUT/DELETE (default: true) */
+    csrf?: boolean;
+}
+type RouteHandler = (request: Request, context: {
+    params: Promise<{
+        action?: string[];
+    }>;
+}) => Promise<Response>;
+declare function createPushRoutes(config: PushRoutesConfig): {
+    GET: RouteHandler;
     POST: RouteHandler;
+    PUT: RouteHandler;
+    DELETE: RouteHandler;
 };
 
 /**
@@ -940,4 +977,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 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, 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, 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 };

package/dist/server/index.js

@@ -1601,6 +1601,137 @@ function createAnalyticsRoutes(config = {}) {
   return { POST };
 }
 
+// src/server/push.ts
+function errorResponse2(code, message, status) {
+  return new Response(
+    JSON.stringify({ success: false, error: { code, message } }),
+    { status, headers: { "Content-Type": "application/json" } }
+  );
+}
+function successResponse2(data, status = 200) {
+  return new Response(
+    JSON.stringify({ success: true, data }),
+    { status, headers: { "Content-Type": "application/json" } }
+  );
+}
+function createPushRoutes(config) {
+  const { apiKey, gatewayUrl, csrf = true } = config;
+  async function proxyToGateway(request, method, subPath) {
+    const targetUrl = `${gatewayUrl}/v1/communication/push/${subPath}`;
+    const headers2 = {
+      "x-api-key": apiKey
+    };
+    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 !== "GET" && method !== "DELETE") {
+      try {
+        const body = await request.text();
+        if (body) {
+          headers2["Content-Type"] = "application/json";
+          fetchOptions.body = body;
+        }
+      } catch {
+      }
+    }
+    const response = await fetch(targetUrl, fetchOptions);
+    if (response.status === 204) {
+      return successResponse2(null);
+    }
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("application/json")) {
+      const json = await response.json();
+      if (response.ok) {
+        return new Response(JSON.stringify(json), {
+          status: response.status,
+          headers: { "Content-Type": "application/json" }
+        });
+      } else {
+        const errMsg = json?.error?.message || json?.message || "Request failed";
+        const errCode = json?.error?.code || json?.code || "PUSH_ERROR";
+        return errorResponse2(errCode, errMsg, response.status);
+      }
+    }
+    const text = await response.text();
+    if (response.ok) {
+      return successResponse2(text);
+    }
+    return errorResponse2("PUSH_ERROR", text || "Request failed", response.status);
+  }
+  function extractSubPath(params) {
+    return (params.action || []).join("/");
+  }
+  const GET = async (request, context) => {
+    try {
+      const params = await context?.params;
+      const subPath = extractSubPath(params || {});
+      return proxyToGateway(request, "GET", subPath);
+    } catch (e) {
+      return errorResponse2("INTERNAL_ERROR", String(e), 500);
+    }
+  };
+  const POST = async (request, context) => {
+    if (csrf) {
+      const csrfError = validateCSRFToken(request);
+      if (csrfError) {
+        return errorResponse2("CSRF_ERROR", "CSRF validation failed", 403);
+      }
+    }
+    try {
+      const params = await context?.params;
+      const subPath = extractSubPath(params || {});
+      return proxyToGateway(request, "POST", subPath);
+    } catch (e) {
+      return errorResponse2("INTERNAL_ERROR", String(e), 500);
+    }
+  };
+  const PUT = async (request, context) => {
+    if (csrf) {
+      const csrfError = validateCSRFToken(request);
+      if (csrfError) {
+        return errorResponse2("CSRF_ERROR", "CSRF validation failed", 403);
+      }
+    }
+    try {
+      const params = await context?.params;
+      const subPath = extractSubPath(params || {});
+      return proxyToGateway(request, "PUT", subPath);
+    } catch (e) {
+      return errorResponse2("INTERNAL_ERROR", String(e), 500);
+    }
+  };
+  const DELETE = async (request, context) => {
+    if (csrf) {
+      const csrfError = validateCSRFToken(request);
+      if (csrfError) {
+        return errorResponse2("CSRF_ERROR", "CSRF validation failed", 403);
+      }
+    }
+    try {
+      const params = await context?.params;
+      const subPath = extractSubPath(params || {});
+      return proxyToGateway(request, "DELETE", subPath);
+    } catch (e) {
+      return errorResponse2("INTERNAL_ERROR", String(e), 500);
+    }
+  };
+  return { GET, POST, PUT, DELETE };
+}
+
 // src/server/errors.ts
 var ScaleMuleError = class extends Error {
   constructor(code, message, status = 400, details) {
@@ -2220,6 +2351,7 @@ exports.configureSecrets = configureSecrets;
 exports.createAnalyticsRoutes = createAnalyticsRoutes;
 exports.createAuthMiddleware = createAuthMiddleware;
 exports.createAuthRoutes = createAuthRoutes;
+exports.createPushRoutes = createPushRoutes;
 exports.createServerClient = createServerClient;
 exports.createWebhookHandler = createWebhookHandler;
 exports.createWebhookRoutes = createWebhookRoutes;

package/dist/server/index.mjs

@@ -1599,6 +1599,137 @@ function createAnalyticsRoutes(config = {}) {
   return { POST };
 }
 
+// src/server/push.ts
+function errorResponse2(code, message, status) {
+  return new Response(
+    JSON.stringify({ success: false, error: { code, message } }),
+    { status, headers: { "Content-Type": "application/json" } }
+  );
+}
+function successResponse2(data, status = 200) {
+  return new Response(
+    JSON.stringify({ success: true, data }),
+    { status, headers: { "Content-Type": "application/json" } }
+  );
+}
+function createPushRoutes(config) {
+  const { apiKey, gatewayUrl, csrf = true } = config;
+  async function proxyToGateway(request, method, subPath) {
+    const targetUrl = `${gatewayUrl}/v1/communication/push/${subPath}`;
+    const headers2 = {
+      "x-api-key": apiKey
+    };
+    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 !== "GET" && method !== "DELETE") {
+      try {
+        const body = await request.text();
+        if (body) {
+          headers2["Content-Type"] = "application/json";
+          fetchOptions.body = body;
+        }
+      } catch {
+      }
+    }
+    const response = await fetch(targetUrl, fetchOptions);
+    if (response.status === 204) {
+      return successResponse2(null);
+    }
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("application/json")) {
+      const json = await response.json();
+      if (response.ok) {
+        return new Response(JSON.stringify(json), {
+          status: response.status,
+          headers: { "Content-Type": "application/json" }
+        });
+      } else {
+        const errMsg = json?.error?.message || json?.message || "Request failed";
+        const errCode = json?.error?.code || json?.code || "PUSH_ERROR";
+        return errorResponse2(errCode, errMsg, response.status);
+      }
+    }
+    const text = await response.text();
+    if (response.ok) {
+      return successResponse2(text);
+    }
+    return errorResponse2("PUSH_ERROR", text || "Request failed", response.status);
+  }
+  function extractSubPath(params) {
+    return (params.action || []).join("/");
+  }
+  const GET = async (request, context) => {
+    try {
+      const params = await context?.params;
+      const subPath = extractSubPath(params || {});
+      return proxyToGateway(request, "GET", subPath);
+    } catch (e) {
+      return errorResponse2("INTERNAL_ERROR", String(e), 500);
+    }
+  };
+  const POST = async (request, context) => {
+    if (csrf) {
+      const csrfError = validateCSRFToken(request);
+      if (csrfError) {
+        return errorResponse2("CSRF_ERROR", "CSRF validation failed", 403);
+      }
+    }
+    try {
+      const params = await context?.params;
+      const subPath = extractSubPath(params || {});
+      return proxyToGateway(request, "POST", subPath);
+    } catch (e) {
+      return errorResponse2("INTERNAL_ERROR", String(e), 500);
+    }
+  };
+  const PUT = async (request, context) => {
+    if (csrf) {
+      const csrfError = validateCSRFToken(request);
+      if (csrfError) {
+        return errorResponse2("CSRF_ERROR", "CSRF validation failed", 403);
+      }
+    }
+    try {
+      const params = await context?.params;
+      const subPath = extractSubPath(params || {});
+      return proxyToGateway(request, "PUT", subPath);
+    } catch (e) {
+      return errorResponse2("INTERNAL_ERROR", String(e), 500);
+    }
+  };
+  const DELETE = async (request, context) => {
+    if (csrf) {
+      const csrfError = validateCSRFToken(request);
+      if (csrfError) {
+        return errorResponse2("CSRF_ERROR", "CSRF validation failed", 403);
+      }
+    }
+    try {
+      const params = await context?.params;
+      const subPath = extractSubPath(params || {});
+      return proxyToGateway(request, "DELETE", subPath);
+    } catch (e) {
+      return errorResponse2("INTERNAL_ERROR", String(e), 500);
+    }
+  };
+  return { GET, POST, PUT, DELETE };
+}
+
 // src/server/errors.ts
 var ScaleMuleError = class extends Error {
   constructor(code, message, status = 400, details) {
@@ -2201,4 +2332,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, 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, 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/dist/server/webhook-handler.d.mts

@@ -1,2 +1,2 @@
-export { i as createWebhookHandler } from '../webhook-handler-DS0r_w4M.mjs';
-import '../index-DewTyMF2.mjs';
+export { g as createWebhookHandler } from '../webhook-handler-Cz9jtet2.mjs';
+import '../index-BoENfro3.mjs';

package/dist/server/webhook-handler.d.ts

@@ -1,2 +1,2 @@
-export { i as createWebhookHandler } from '../webhook-handler-CQ2lZgy0.js';
-import '../index-DewTyMF2.js';
+export { g as createWebhookHandler } from '../webhook-handler-CjSSCdvI.js';
+import '../index-BoENfro3.js';

package/dist/testing.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { U as User, N as StorageFile, A as ApiError } from './index-DewTyMF2.mjs';
+import { U as User, A as ApiError, a8 as StorageFile } from './index-BoENfro3.mjs';
 
 interface MockUserOptions {
     id?: string;

package/dist/testing.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { U as User, N as StorageFile, A as ApiError } from './index-DewTyMF2.js';
+import { U as User, A as ApiError, a8 as StorageFile } from './index-BoENfro3.js';
 
 interface MockUserOptions {
     id?: string;

package/dist/{webhook-handler-CQ2lZgy0.d.ts → webhook-handler-CjSSCdvI.d.ts}

@@ -1,4 +1,4 @@
-import { R as RegisterRequest, $ as ClientContext, U as User, l as LoginRequest, L as LoginResponse, c as ListFilesParams, T as ListFilesResponse, N as StorageFile, W as UploadResponse } from './index-DewTyMF2.js';
+import { _ as RegisterRequest, p as ClientContext, U as User, v as LoginRequest, L as LoginResponse, c as ListFilesParams, t as ListFilesResponse, a8 as StorageFile, ae as UploadResponse } from './index-BoENfro3.js';
 
 /**
  * Server-Side ScaleMule Client
@@ -776,4 +776,4 @@ type RouteHandler = (request: Request) => Promise<Response>;
  */
 declare function createWebhookHandler(config?: WebhookHandlerConfig): RouteHandler;
 
-export { type ServerConfig as S, type VideoReadyEvent as V, type WebhookEvent as W, ScaleMuleServer as a, registerVideoWebhook as b, createServerClient as c, createWebhookRoutes as d, type VideoFailedEvent as e, type VideoUploadedEvent as f, type VideoTranscodedEvent as g, type WebhookRoutesConfig as h, createWebhookHandler as i, parseWebhookEvent as p, resolveGatewayUrl as r, verifyWebhookSignature as v };
+export { type ServerConfig as S, type VideoFailedEvent as V, type WebhookEvent as W, ScaleMuleServer as a, type VideoReadyEvent as b, type VideoTranscodedEvent as c, type VideoUploadedEvent as d, type WebhookRoutesConfig as e, createServerClient as f, createWebhookHandler as g, createWebhookRoutes as h, resolveGatewayUrl as i, parseWebhookEvent as p, registerVideoWebhook as r, verifyWebhookSignature as v };

package/dist/{webhook-handler-DS0r_w4M.d.mts → webhook-handler-Cz9jtet2.d.mts}

@@ -1,4 +1,4 @@
-import { R as RegisterRequest, $ as ClientContext, U as User, l as LoginRequest, L as LoginResponse, c as ListFilesParams, T as ListFilesResponse, N as StorageFile, W as UploadResponse } from './index-DewTyMF2.mjs';
+import { _ as RegisterRequest, p as ClientContext, U as User, v as LoginRequest, L as LoginResponse, c as ListFilesParams, t as ListFilesResponse, a8 as StorageFile, ae as UploadResponse } from './index-BoENfro3.mjs';
 
 /**
  * Server-Side ScaleMule Client
@@ -776,4 +776,4 @@ type RouteHandler = (request: Request) => Promise<Response>;
  */
 declare function createWebhookHandler(config?: WebhookHandlerConfig): RouteHandler;
 
-export { type ServerConfig as S, type VideoReadyEvent as V, type WebhookEvent as W, ScaleMuleServer as a, registerVideoWebhook as b, createServerClient as c, createWebhookRoutes as d, type VideoFailedEvent as e, type VideoUploadedEvent as f, type VideoTranscodedEvent as g, type WebhookRoutesConfig as h, createWebhookHandler as i, parseWebhookEvent as p, resolveGatewayUrl as r, verifyWebhookSignature as v };
+export { type ServerConfig as S, type VideoFailedEvent as V, type WebhookEvent as W, ScaleMuleServer as a, type VideoReadyEvent as b, type VideoTranscodedEvent as c, type VideoUploadedEvent as d, type WebhookRoutesConfig as e, createServerClient as f, createWebhookHandler as g, createWebhookRoutes as h, resolveGatewayUrl as i, parseWebhookEvent as p, registerVideoWebhook as r, verifyWebhookSignature as v };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/nextjs",
-  "version": "0.0.28",
+  "version": "0.0.29",
   "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.18"
+    "@scalemule/sdk": "^0.0.23"
   },
   "peerDependencies": {
     "next": ">=14.0.0",