@scalemule/nextjs 0.0.28 → 0.0.30

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,60 @@ 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;
+
+interface UseShareOptions {
+    /** The canonical URL to share. Defaults to current page URL.
+     *  IMPORTANT: Pass the content's canonical URL, not window.location.href,
+     *  to avoid re-sharing someone else's referral code. */
+    url?: string;
+    /** Manual referral code override (skips fetch) */
+    referralCode?: string;
+    /** Auto-fetch referral code from /v1/referrals/me when authenticated */
+    autoFetchReferral?: boolean;
+}
+interface UseShareReturn {
+    /** Share URL — absolute, with ?rc= appended if referral code available */
+    shareUrl: string;
+    /** User's referral code, or null if unauthenticated/not fetched */
+    referralCode: string | null;
+    /** Copy shareUrl to clipboard. Returns true on success. */
+    copyLink: () => Promise<boolean>;
+    /** Whether link was recently copied (auto-resets after 2s) */
+    copied: boolean;
+    /** Loading state for referral code fetch */
+    loading: boolean;
+}
+declare function useShare(options?: UseShareOptions): UseShareReturn;
+
 /**
  * Client-side validation helpers
  *
@@ -447,4 +501,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, type UseShareOptions, type UseShareReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, usePushNotifications, useRealtime, useScaleMule, useScaleMuleClient, useShare, 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,60 @@ 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;
+
+interface UseShareOptions {
+    /** The canonical URL to share. Defaults to current page URL.
+     *  IMPORTANT: Pass the content's canonical URL, not window.location.href,
+     *  to avoid re-sharing someone else's referral code. */
+    url?: string;
+    /** Manual referral code override (skips fetch) */
+    referralCode?: string;
+    /** Auto-fetch referral code from /v1/referrals/me when authenticated */
+    autoFetchReferral?: boolean;
+}
+interface UseShareReturn {
+    /** Share URL — absolute, with ?rc= appended if referral code available */
+    shareUrl: string;
+    /** User's referral code, or null if unauthenticated/not fetched */
+    referralCode: string | null;
+    /** Copy shareUrl to clipboard. Returns true on success. */
+    copyLink: () => Promise<boolean>;
+    /** Whether link was recently copied (auto-resets after 2s) */
+    copied: boolean;
+    /** Loading state for referral code fetch */
+    loading: boolean;
+}
+declare function useShare(options?: UseShareOptions): UseShareReturn;
+
 /**
  * Client-side validation helpers
  *
@@ -447,4 +501,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, type UseShareOptions, type UseShareReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, usePushNotifications, useRealtime, useScaleMule, useScaleMuleClient, useShare, 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,265 @@ 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) {
+      const storedTokenId = manager.getTokenId();
+      manager.isSubscribed().then((sub) => {
+        if (!sub && storedTokenId) {
+          manager.unsubscribe().catch(() => {
+          });
+          setIsSubscribed(false);
+          setTokenId(null);
+          setPermission(manager.getPermissionState());
+        } else {
+          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);
+      }
+      if (event.data?.type === "push-subscription-expired") {
+        if (manager) {
+          manager.unsubscribe().catch(() => {
+          });
+        }
+        setIsSubscribed(false);
+        setTokenId(null);
+        setPermission(typeof Notification !== "undefined" ? Notification.permission : "unsupported");
+      }
+    }
+    navigator.serviceWorker.addEventListener("message", handleMessage);
+    return () => navigator.serviceWorker.removeEventListener("message", handleMessage);
+  }, [manager]);
+  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
+  };
+}
+function useShare(options) {
+  const { client, user } = useScaleMule();
+  const [referralCode, setReferralCode] = react.useState(
+    options?.referralCode ?? null
+  );
+  const [loading, setLoading] = react.useState(false);
+  const [copied, setCopied] = react.useState(false);
+  react.useEffect(() => {
+    if (!user) {
+      setReferralCode(options?.referralCode ?? null);
+      setLoading(false);
+      return;
+    }
+    if (!options?.autoFetchReferral) {
+      setLoading(false);
+      return;
+    }
+    if (options?.referralCode) {
+      setReferralCode(options.referralCode);
+      setLoading(false);
+      return;
+    }
+    setReferralCode(null);
+    let cancelled = false;
+    setLoading(true);
+    client.get("/v1/referrals/me").then((data) => {
+      if (!cancelled) setReferralCode(data.referral_code);
+    }).catch(() => {
+      if (!cancelled) setReferralCode(null);
+    }).finally(() => {
+      if (!cancelled) setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [user?.id, options?.url, options?.referralCode, options?.autoFetchReferral, client]);
+  const shareUrl = react.useMemo(() => {
+    const raw = options?.url || (typeof window !== "undefined" ? window.location.href : "");
+    if (!raw) return raw;
+    try {
+      const base = typeof window !== "undefined" ? window.location.origin : void 0;
+      const u = new URL(raw, base);
+      if (referralCode) {
+        u.searchParams.set("rc", referralCode);
+      }
+      return u.toString();
+    } catch {
+      return raw;
+    }
+  }, [options?.url, referralCode]);
+  const copyLink = react.useCallback(async () => {
+    try {
+      await navigator.clipboard.writeText(shareUrl);
+    } catch {
+      try {
+        const textarea = document.createElement("textarea");
+        textarea.value = shareUrl;
+        textarea.style.position = "fixed";
+        textarea.style.opacity = "0";
+        document.body.appendChild(textarea);
+        textarea.select();
+        document.execCommand("copy");
+        document.body.removeChild(textarea);
+      } catch {
+        return false;
+      }
+    }
+    setCopied(true);
+    setTimeout(() => setCopied(false), 2e3);
+    return true;
+  }, [shareUrl]);
+  return { shareUrl, referralCode, copyLink, copied, loading };
+}
 
 // src/validation.ts
 var phoneCountries = [
@@ -3359,9 +3619,11 @@ exports.useAuth = useAuth;
 exports.useBilling = useBilling;
 exports.useContent = useContent;
 exports.useFeatureFlags = useFeatureFlags;
+exports.usePushNotifications = usePushNotifications;
 exports.useRealtime = useRealtime;
 exports.useScaleMule = useScaleMule;
 exports.useScaleMuleClient = useScaleMuleClient;
+exports.useShare = useShare;
 exports.useUser = useUser;
 exports.validateForm = validateForm;
 exports.validators = validators;