@develemit/web-hooks 0.2.0 → 0.3.0

package/dist/push.cjs

@@ -0,0 +1,201 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/push/index.ts
+var push_exports = {};
+__export(push_exports, {
+  getPushSupport: () => getPushSupport,
+  shouldResubscribe: () => shouldResubscribe,
+  urlBase64ToUint8Array: () => urlBase64ToUint8Array,
+  usePushSubscription: () => usePushSubscription
+});
+module.exports = __toCommonJS(push_exports);
+
+// src/push/use-push-subscription.ts
+var import_react = require("react");
+
+// src/pwa/detect.ts
+var IOS_UA = /iPhone|iPad|iPod/;
+var IOS_OTHER_BROWSER = /CriOS|FxiOS|EdgiOS|OPiOS/;
+var IN_APP_WEBVIEW = /FBAN|FBAV|Instagram/;
+var STANDALONE_QUERY = "(display-mode: standalone)";
+function detectPlatform(env) {
+  const isIos2 = IOS_UA.test(env.userAgent) || env.platform === "MacIntel" && env.maxTouchPoints > 1;
+  const isIosSafari = isIos2 && !IOS_OTHER_BROWSER.test(env.userAgent) && !IN_APP_WEBVIEW.test(env.userAgent);
+  return { isIos: isIos2, isIosSafari, isStandalone: env.standaloneMedia || env.navigatorStandalone };
+}
+function readStandaloneMedia() {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") return false;
+  return window.matchMedia(STANDALONE_QUERY).matches;
+}
+function readNavigatorStandalone() {
+  if (typeof navigator === "undefined") return false;
+  return navigator.standalone === true;
+}
+function readPlatform() {
+  if (typeof navigator === "undefined") return { isIos: false, isIosSafari: false, isStandalone: false };
+  return detectPlatform({
+    userAgent: navigator.userAgent ?? "",
+    platform: navigator.platform ?? "",
+    maxTouchPoints: navigator.maxTouchPoints ?? 0,
+    standaloneMedia: readStandaloneMedia(),
+    navigatorStandalone: readNavigatorStandalone()
+  });
+}
+var isStandalone = () => readPlatform().isStandalone;
+var isIos = () => readPlatform().isIos;
+
+// src/push/support.ts
+function getPushSupport(env = readPushEnv()) {
+  if (env.isIos && !env.isStandalone) return "ios-needs-install";
+  if (!env.hasPushManager || !env.hasServiceWorker || !env.hasNotification) return "unsupported";
+  return "supported";
+}
+function readPushEnv() {
+  const browser = typeof window !== "undefined" && typeof navigator !== "undefined";
+  return {
+    hasPushManager: browser && "PushManager" in window,
+    hasServiceWorker: browser && "serviceWorker" in navigator,
+    hasNotification: browser && "Notification" in window,
+    isIos: browser && isIos(),
+    isStandalone: browser && isStandalone()
+  };
+}
+function readPermission() {
+  if (typeof window === "undefined" || !("Notification" in window)) return "unsupported";
+  return Notification.permission;
+}
+function shouldResubscribe({ permission, hasSubscription, resubscribeOnLoad }) {
+  return resubscribeOnLoad && permission === "granted" && !hasSubscription;
+}
+function isGone(error) {
+  return typeof error === "object" && error !== null && error.status === 410;
+}
+
+// src/push/vapid.ts
+function urlBase64ToUint8Array(key) {
+  const padding = "=".repeat((4 - key.length % 4) % 4);
+  const base64 = (key + padding).replace(/-/g, "+").replace(/_/g, "/");
+  const raw = atob(base64);
+  const out = new Uint8Array(raw.length);
+  for (let i = 0; i < raw.length; i++) out[i] = raw.charCodeAt(i);
+  return out;
+}
+
+// src/push/register.ts
+function subscribeFresh(reg, vapidPublicKey) {
+  return reg.pushManager.subscribe({
+    userVisibleOnly: true,
+    // lib.dom wants ArrayBufferView<ArrayBuffer>; a Uint8Array satisfies the runtime contract.
+    applicationServerKey: urlBase64ToUint8Array(vapidPublicKey)
+  });
+}
+async function ensureSubscribed(reg, { vapidPublicKey, onSubscribe }, existing) {
+  let sub = existing ?? await reg.pushManager.getSubscription() ?? await subscribeFresh(reg, vapidPublicKey);
+  try {
+    await onSubscribe(sub.toJSON());
+  } catch (error) {
+    if (!isGone(error)) throw error;
+    await sub.unsubscribe();
+    sub = await subscribeFresh(reg, vapidPublicKey);
+    await onSubscribe(sub.toJSON());
+  }
+  return sub;
+}
+
+// src/push/use-push-subscription.ts
+var messageOf = (error, fallback) => error instanceof Error ? error.message : fallback;
+function usePushSubscription(options) {
+  const { resubscribeOnLoad = true } = options;
+  const [support, setSupport] = (0, import_react.useState)("unsupported");
+  const [permission, setPermission] = (0, import_react.useState)("unsupported");
+  const [subscribed, setSubscribed] = (0, import_react.useState)(false);
+  const [busy, setBusy] = (0, import_react.useState)(false);
+  const [error, setError] = (0, import_react.useState)(null);
+  const latest = (0, import_react.useRef)(options);
+  latest.current = options;
+  (0, import_react.useEffect)(() => {
+    const current = getPushSupport();
+    setSupport(current);
+    setPermission(readPermission());
+    if (current !== "supported") return;
+    let cancelled = false;
+    (async () => {
+      try {
+        const reg = await navigator.serviceWorker.ready;
+        const existing = await reg.pushManager.getSubscription();
+        if (cancelled) return;
+        const permissionNow = readPermission();
+        setPermission(permissionNow);
+        if (existing) return setSubscribed(true);
+        if (!shouldResubscribe({ permission: permissionNow, hasSubscription: false, resubscribeOnLoad })) return;
+        await ensureSubscribed(reg, latest.current);
+        if (!cancelled) setSubscribed(true);
+      } catch {
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [resubscribeOnLoad]);
+  const subscribe = (0, import_react.useCallback)(async () => {
+    if (getPushSupport() !== "supported") return;
+    setError(null);
+    setBusy(true);
+    try {
+      const result = await Notification.requestPermission();
+      setPermission(result);
+      if (result !== "granted") return;
+      const reg = await navigator.serviceWorker.ready;
+      await ensureSubscribed(reg, latest.current);
+      setSubscribed(true);
+    } catch (e) {
+      setError(messageOf(e, "subscribe failed"));
+    } finally {
+      setBusy(false);
+    }
+  }, []);
+  const unsubscribe = (0, import_react.useCallback)(async () => {
+    if (getPushSupport() !== "supported") return;
+    setError(null);
+    setBusy(true);
+    try {
+      const reg = await navigator.serviceWorker.ready;
+      const sub = await reg.pushManager.getSubscription();
+      if (sub) {
+        await latest.current.onUnsubscribe(sub.endpoint);
+        await sub.unsubscribe();
+      }
+      setSubscribed(false);
+    } catch (e) {
+      setError(messageOf(e, "unsubscribe failed"));
+    } finally {
+      setBusy(false);
+    }
+  }, []);
+  return { support, permission, subscribed, busy, error, subscribe, unsubscribe };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getPushSupport,
+  shouldResubscribe,
+  urlBase64ToUint8Array,
+  usePushSubscription
+});

package/dist/push.d.cts

@@ -0,0 +1,37 @@
+type PushSupport = 'supported' | 'unsupported' | 'ios-needs-install';
+type PushPermission = NotificationPermission | 'unsupported';
+interface PushEnv {
+    hasPushManager: boolean;
+    hasServiceWorker: boolean;
+    hasNotification: boolean;
+    isIos: boolean;
+    isStandalone: boolean;
+}
+declare function getPushSupport(env?: PushEnv): PushSupport;
+interface ResubscribeInput {
+    permission: PushPermission;
+    hasSubscription: boolean;
+    resubscribeOnLoad: boolean;
+}
+declare function shouldResubscribe({ permission, hasSubscription, resubscribeOnLoad }: ResubscribeInput): boolean;
+
+interface UsePushSubscriptionOptions {
+    vapidPublicKey: string;
+    onSubscribe: (subscription: PushSubscriptionJSON) => Promise<unknown> | unknown;
+    onUnsubscribe: (endpoint: string) => Promise<unknown> | unknown;
+    resubscribeOnLoad?: boolean;
+}
+interface PushSubscriptionState {
+    support: PushSupport;
+    permission: PushPermission;
+    subscribed: boolean;
+    busy: boolean;
+    error: string | null;
+    subscribe: () => Promise<void>;
+    unsubscribe: () => Promise<void>;
+}
+declare function usePushSubscription(options: UsePushSubscriptionOptions): PushSubscriptionState;
+
+declare function urlBase64ToUint8Array(key: string): Uint8Array;
+
+export { type PushEnv, type PushPermission, type PushSubscriptionState, type PushSupport, type ResubscribeInput, type UsePushSubscriptionOptions, getPushSupport, shouldResubscribe, urlBase64ToUint8Array, usePushSubscription };

package/dist/push.d.ts

@@ -0,0 +1,37 @@
+type PushSupport = 'supported' | 'unsupported' | 'ios-needs-install';
+type PushPermission = NotificationPermission | 'unsupported';
+interface PushEnv {
+    hasPushManager: boolean;
+    hasServiceWorker: boolean;
+    hasNotification: boolean;
+    isIos: boolean;
+    isStandalone: boolean;
+}
+declare function getPushSupport(env?: PushEnv): PushSupport;
+interface ResubscribeInput {
+    permission: PushPermission;
+    hasSubscription: boolean;
+    resubscribeOnLoad: boolean;
+}
+declare function shouldResubscribe({ permission, hasSubscription, resubscribeOnLoad }: ResubscribeInput): boolean;
+
+interface UsePushSubscriptionOptions {
+    vapidPublicKey: string;
+    onSubscribe: (subscription: PushSubscriptionJSON) => Promise<unknown> | unknown;
+    onUnsubscribe: (endpoint: string) => Promise<unknown> | unknown;
+    resubscribeOnLoad?: boolean;
+}
+interface PushSubscriptionState {
+    support: PushSupport;
+    permission: PushPermission;
+    subscribed: boolean;
+    busy: boolean;
+    error: string | null;
+    subscribe: () => Promise<void>;
+    unsubscribe: () => Promise<void>;
+}
+declare function usePushSubscription(options: UsePushSubscriptionOptions): PushSubscriptionState;
+
+declare function urlBase64ToUint8Array(key: string): Uint8Array;
+
+export { type PushEnv, type PushPermission, type PushSubscriptionState, type PushSupport, type ResubscribeInput, type UsePushSubscriptionOptions, getPushSupport, shouldResubscribe, urlBase64ToUint8Array, usePushSubscription };

package/dist/push.js

@@ -0,0 +1,14 @@
+"use client";
+import {
+  getPushSupport,
+  shouldResubscribe,
+  urlBase64ToUint8Array,
+  usePushSubscription
+} from "./chunk-UJ366T3Y.js";
+import "./chunk-YFMMSLMB.js";
+export {
+  getPushSupport,
+  shouldResubscribe,
+  urlBase64ToUint8Array,
+  usePushSubscription
+};

package/dist/pwa.cjs

@@ -0,0 +1,198 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/pwa/index.ts
+var pwa_exports = {};
+__export(pwa_exports, {
+  detectPlatform: () => detectPlatform,
+  isIos: () => isIos,
+  isIosSafari: () => isIosSafari,
+  isStandalone: () => isStandalone,
+  startInstallPromptCapture: () => startInstallPromptCapture,
+  useInstallPrompt: () => useInstallPrompt,
+  useIsStandalone: () => useIsStandalone
+});
+module.exports = __toCommonJS(pwa_exports);
+
+// src/pwa/use-is-standalone.ts
+var import_react = require("react");
+
+// src/media-query/media-query.ts
+var lists = /* @__PURE__ */ new WeakMap();
+function getList(query) {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") return null;
+  const owner = window.matchMedia;
+  let byQuery = lists.get(owner);
+  if (!byQuery) {
+    byQuery = /* @__PURE__ */ new Map();
+    lists.set(owner, byQuery);
+  }
+  let list = byQuery.get(query);
+  if (!list) {
+    list = owner.call(window, query);
+    byQuery.set(query, list);
+  }
+  return list;
+}
+function subscribe(query, onChange) {
+  const list = getList(query);
+  if (!list) return () => {
+  };
+  if (typeof list.addEventListener === "function") {
+    list.addEventListener("change", onChange);
+    return () => list.removeEventListener("change", onChange);
+  }
+  list.addListener(onChange);
+  return () => list.removeListener(onChange);
+}
+
+// src/pwa/detect.ts
+var IOS_UA = /iPhone|iPad|iPod/;
+var IOS_OTHER_BROWSER = /CriOS|FxiOS|EdgiOS|OPiOS/;
+var IN_APP_WEBVIEW = /FBAN|FBAV|Instagram/;
+var STANDALONE_QUERY = "(display-mode: standalone)";
+function detectPlatform(env) {
+  const isIos2 = IOS_UA.test(env.userAgent) || env.platform === "MacIntel" && env.maxTouchPoints > 1;
+  const isIosSafari2 = isIos2 && !IOS_OTHER_BROWSER.test(env.userAgent) && !IN_APP_WEBVIEW.test(env.userAgent);
+  return { isIos: isIos2, isIosSafari: isIosSafari2, isStandalone: env.standaloneMedia || env.navigatorStandalone };
+}
+function readStandaloneMedia() {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") return false;
+  return window.matchMedia(STANDALONE_QUERY).matches;
+}
+function readNavigatorStandalone() {
+  if (typeof navigator === "undefined") return false;
+  return navigator.standalone === true;
+}
+function readPlatform() {
+  if (typeof navigator === "undefined") return { isIos: false, isIosSafari: false, isStandalone: false };
+  return detectPlatform({
+    userAgent: navigator.userAgent ?? "",
+    platform: navigator.platform ?? "",
+    maxTouchPoints: navigator.maxTouchPoints ?? 0,
+    standaloneMedia: readStandaloneMedia(),
+    navigatorStandalone: readNavigatorStandalone()
+  });
+}
+var isStandalone = () => readPlatform().isStandalone;
+var isIos = () => readPlatform().isIos;
+var isIosSafari = () => readPlatform().isIosSafari;
+
+// src/pwa/use-is-standalone.ts
+function useIsStandalone() {
+  const subscribeToMode = (0, import_react.useCallback)((onChange) => subscribe(STANDALONE_QUERY, onChange), []);
+  return (0, import_react.useSyncExternalStore)(subscribeToMode, isStandalone, () => false);
+}
+
+// src/pwa/use-install-prompt.ts
+var import_react2 = require("react");
+
+// src/pwa/install-store.ts
+var state = { event: null, installed: false };
+var subscribers = /* @__PURE__ */ new Set();
+var permanent = false;
+var holders = 0;
+var attached = false;
+function set(next) {
+  state = next;
+  subscribers.forEach((fn) => fn());
+}
+function onBeforeInstallPrompt(e) {
+  e.preventDefault();
+  set({ ...state, event: e });
+}
+function onAppInstalled() {
+  set({ event: null, installed: true });
+}
+function sync() {
+  const wanted = permanent || holders > 0;
+  if (wanted === attached || typeof window === "undefined") return;
+  attached = wanted;
+  const toggle = wanted ? window.addEventListener : window.removeEventListener;
+  toggle.call(window, "beforeinstallprompt", onBeforeInstallPrompt);
+  toggle.call(window, "appinstalled", onAppInstalled);
+}
+function startInstallPromptCapture() {
+  permanent = true;
+  sync();
+}
+function acquireCapture() {
+  holders += 1;
+  sync();
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    holders -= 1;
+    sync();
+  };
+}
+function getInstallState() {
+  return state;
+}
+function subscribeInstallState(onChange) {
+  subscribers.add(onChange);
+  return () => {
+    subscribers.delete(onChange);
+  };
+}
+async function promptInstall() {
+  const event = state.event;
+  if (!event) return "unavailable";
+  set({ ...state, event: null });
+  try {
+    await event.prompt();
+    const { outcome } = await event.userChoice;
+    return outcome;
+  } catch {
+    return "dismissed";
+  }
+}
+
+// src/pwa/use-install-prompt.ts
+var serverState = { event: null, installed: false };
+function useInstallPrompt() {
+  const state2 = (0, import_react2.useSyncExternalStore)(subscribeInstallState, getInstallState, () => serverState);
+  const standalone = useIsStandalone();
+  const iosSafari = (0, import_react2.useSyncExternalStore)(
+    () => () => {
+    },
+    isIosSafari,
+    () => false
+  );
+  (0, import_react2.useEffect)(() => acquireCapture(), []);
+  const installed = state2.installed || standalone;
+  return {
+    canPrompt: state2.event !== null && !installed,
+    prompt: promptInstall,
+    installed,
+    needsIosInstructions: iosSafari && !installed
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  detectPlatform,
+  isIos,
+  isIosSafari,
+  isStandalone,
+  startInstallPromptCapture,
+  useInstallPrompt,
+  useIsStandalone
+});

package/dist/pwa.d.cts

@@ -0,0 +1,35 @@
+declare function useIsStandalone(): boolean;
+
+/** Listens for the install events for the life of the page. Safe to call more than once. */
+declare function startInstallPromptCapture(): void;
+type PromptOutcome = 'accepted' | 'dismissed' | 'unavailable';
+
+interface InstallPrompt {
+    /** A captured `beforeinstallprompt` is waiting, so `prompt()` can show the browser dialog. */
+    canPrompt: boolean;
+    prompt: () => Promise<PromptOutcome>;
+    /** Running as an installed app, or `appinstalled` fired. */
+    installed: boolean;
+    /** iOS Safari has no install event: show "Share, then Add to Home Screen". */
+    needsIosInstructions: boolean;
+}
+declare function useInstallPrompt(): InstallPrompt;
+
+interface PlatformEnv {
+    userAgent: string;
+    platform: string;
+    maxTouchPoints: number;
+    standaloneMedia: boolean;
+    navigatorStandalone: boolean;
+}
+interface Platform {
+    isIos: boolean;
+    isIosSafari: boolean;
+    isStandalone: boolean;
+}
+declare function detectPlatform(env: PlatformEnv): Platform;
+declare const isStandalone: () => boolean;
+declare const isIos: () => boolean;
+declare const isIosSafari: () => boolean;
+
+export { type InstallPrompt, type Platform, type PlatformEnv, type PromptOutcome, detectPlatform, isIos, isIosSafari, isStandalone, startInstallPromptCapture, useInstallPrompt, useIsStandalone };

package/dist/pwa.d.ts

@@ -0,0 +1,35 @@
+declare function useIsStandalone(): boolean;
+
+/** Listens for the install events for the life of the page. Safe to call more than once. */
+declare function startInstallPromptCapture(): void;
+type PromptOutcome = 'accepted' | 'dismissed' | 'unavailable';
+
+interface InstallPrompt {
+    /** A captured `beforeinstallprompt` is waiting, so `prompt()` can show the browser dialog. */
+    canPrompt: boolean;
+    prompt: () => Promise<PromptOutcome>;
+    /** Running as an installed app, or `appinstalled` fired. */
+    installed: boolean;
+    /** iOS Safari has no install event: show "Share, then Add to Home Screen". */
+    needsIosInstructions: boolean;
+}
+declare function useInstallPrompt(): InstallPrompt;
+
+interface PlatformEnv {
+    userAgent: string;
+    platform: string;
+    maxTouchPoints: number;
+    standaloneMedia: boolean;
+    navigatorStandalone: boolean;
+}
+interface Platform {
+    isIos: boolean;
+    isIosSafari: boolean;
+    isStandalone: boolean;
+}
+declare function detectPlatform(env: PlatformEnv): Platform;
+declare const isStandalone: () => boolean;
+declare const isIos: () => boolean;
+declare const isIosSafari: () => boolean;
+
+export { type InstallPrompt, type Platform, type PlatformEnv, type PromptOutcome, detectPlatform, isIos, isIosSafari, isStandalone, startInstallPromptCapture, useInstallPrompt, useIsStandalone };

package/dist/pwa.js

@@ -0,0 +1,22 @@
+"use client";
+import {
+  startInstallPromptCapture,
+  useInstallPrompt,
+  useIsStandalone
+} from "./chunk-Z3X27PCA.js";
+import {
+  detectPlatform,
+  isIos,
+  isIosSafari,
+  isStandalone
+} from "./chunk-YFMMSLMB.js";
+import "./chunk-WVM2LTWQ.js";
+export {
+  detectPlatform,
+  isIos,
+  isIosSafari,
+  isStandalone,
+  startInstallPromptCapture,
+  useInstallPrompt,
+  useIsStandalone
+};