@scalemule/nextjs 0.0.29 → 0.0.31

package/dist/index.d.mts

@@ -319,6 +319,30 @@ interface UsePushNotificationsReturn {
 }
 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
  *
@@ -477,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 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 };
+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

@@ -319,6 +319,30 @@ interface UsePushNotificationsReturn {
 }
 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
  *
@@ -477,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 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 };
+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

@@ -3138,9 +3138,18 @@ function usePushNotifications(options = {}) {
     setIsSupported(supported);
     setPermission(manager.getPermissionState());
     if (supported) {
+      const storedTokenId = manager.getTokenId();
       manager.isSubscribed().then((sub) => {
-        setIsSubscribed(sub);
-        setTokenId(manager.getTokenId());
+        if (!sub && storedTokenId) {
+          manager.unsubscribe().catch(() => {
+          });
+          setIsSubscribed(false);
+          setTokenId(null);
+          setPermission(manager.getPermissionState());
+        } else {
+          setIsSubscribed(sub);
+          setTokenId(manager.getTokenId());
+        }
       });
     }
   }, [manager]);
@@ -3150,10 +3159,19 @@ function usePushNotifications(options = {}) {
       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;
@@ -3222,6 +3240,79 @@ function usePushNotifications(options = {}) {
     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 = [
@@ -3532,6 +3623,7 @@ exports.usePushNotifications = usePushNotifications;
 exports.useRealtime = useRealtime;
 exports.useScaleMule = useScaleMule;
 exports.useScaleMuleClient = useScaleMuleClient;
+exports.useShare = useShare;
 exports.useUser = useUser;
 exports.validateForm = validateForm;
 exports.validators = validators;

package/dist/index.mjs

@@ -3136,9 +3136,18 @@ function usePushNotifications(options = {}) {
     setIsSupported(supported);
     setPermission(manager.getPermissionState());
     if (supported) {
+      const storedTokenId = manager.getTokenId();
       manager.isSubscribed().then((sub) => {
-        setIsSubscribed(sub);
-        setTokenId(manager.getTokenId());
+        if (!sub && storedTokenId) {
+          manager.unsubscribe().catch(() => {
+          });
+          setIsSubscribed(false);
+          setTokenId(null);
+          setPermission(manager.getPermissionState());
+        } else {
+          setIsSubscribed(sub);
+          setTokenId(manager.getTokenId());
+        }
       });
     }
   }, [manager]);
@@ -3148,10 +3157,19 @@ function usePushNotifications(options = {}) {
       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]);
   useEffect(() => {
     if (!manager) return;
     const currentUserId = user?.id || null;
@@ -3220,6 +3238,79 @@ function usePushNotifications(options = {}) {
     tokenId
   };
 }
+function useShare(options) {
+  const { client, user } = useScaleMule();
+  const [referralCode, setReferralCode] = useState(
+    options?.referralCode ?? null
+  );
+  const [loading, setLoading] = useState(false);
+  const [copied, setCopied] = useState(false);
+  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 = 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 = 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 = [
@@ -3512,4 +3603,4 @@ function createSafeLogger(prefix) {
   };
 }
 
-export { ScaleMuleApiError, ScaleMuleClient, ScaleMuleProvider, composePhone, createClient, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, usePushNotifications, 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, useShare, useUser, validateForm, validators };

package/dist/server/index.js

@@ -1836,8 +1836,12 @@ function apiHandler(handler, options) {
           const custom = options.onError(error);
           if (custom) return custom;
         }
+        const safeMessage = error.status >= 500 ? "An unexpected error occurred" : error.message;
+        if (error.status >= 500) {
+          console.error("Internal API error:", error.message);
+        }
         return Response.json(
-          { success: false, error: { code: error.code, message: error.message } },
+          { success: false, error: { code: error.code, message: safeMessage } },
           { status: error.status }
         );
       }

package/dist/server/index.mjs

@@ -1834,8 +1834,12 @@ function apiHandler(handler, options) {
           const custom = options.onError(error);
           if (custom) return custom;
         }
+        const safeMessage = error.status >= 500 ? "An unexpected error occurred" : error.message;
+        if (error.status >= 500) {
+          console.error("Internal API error:", error.message);
+        }
         return Response.json(
-          { success: false, error: { code: error.code, message: error.message } },
+          { success: false, error: { code: error.code, message: safeMessage } },
           { status: error.status }
         );
       }

package/package.json

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