miragedev-sdk 0.1.0

package/dist/mobile/index.cjs

@@ -0,0 +1,101 @@
+'use strict';
+
+require('../chunk-75ZPJI57.cjs');
+var react = require('react');
+
+function useNetworkStatus() {
+  const [isOnline, setIsOnline] = react.useState(
+    typeof window !== "undefined" ? window.navigator.onLine : true
+  );
+  react.useEffect(() => {
+    const handleOnline = () => setIsOnline(true);
+    const handleOffline = () => setIsOnline(false);
+    window.addEventListener("online", handleOnline);
+    window.addEventListener("offline", handleOffline);
+    return () => {
+      window.removeEventListener("online", handleOnline);
+      window.removeEventListener("offline", handleOffline);
+    };
+  }, []);
+  return isOnline;
+}
+function useInstallPrompt() {
+  const [installPrompt, setInstallPrompt] = react.useState(null);
+  const [canInstall, setCanInstall] = react.useState(false);
+  react.useEffect(() => {
+    const handleBeforeInstallPrompt = (e) => {
+      e.preventDefault();
+      setInstallPrompt(e);
+      setCanInstall(true);
+    };
+    window.addEventListener("beforeinstallprompt", handleBeforeInstallPrompt);
+    return () => {
+      window.removeEventListener("beforeinstallprompt", handleBeforeInstallPrompt);
+    };
+  }, []);
+  const promptInstall = react.useCallback(async () => {
+    if (!installPrompt) return;
+    installPrompt.prompt();
+    const result = await installPrompt.userChoice;
+    if (result.outcome === "accepted") {
+      setCanInstall(false);
+      setInstallPrompt(null);
+    }
+  }, [installPrompt]);
+  return { canInstall, promptInstall };
+}
+function useNotifications() {
+  const [permission, setPermission] = react.useState(
+    typeof window !== "undefined" && "Notification" in window ? Notification.permission : "default"
+  );
+  const requestPermission = react.useCallback(async () => {
+    if (!("Notification" in window)) {
+      console.warn("Notifications not supported");
+      return;
+    }
+    const result = await Notification.requestPermission();
+    setPermission(result);
+  }, []);
+  const sendNotification = react.useCallback((title, options) => {
+    if (permission === "granted") {
+      new Notification(title, options);
+    }
+  }, [permission]);
+  return { permission, requestPermission, sendNotification };
+}
+function usePullToRefresh(onRefresh) {
+  const [isRefreshing, setIsRefreshing] = react.useState(false);
+  react.useEffect(() => {
+    let touchStartY = 0;
+    const handleTouchStart = (e) => {
+      touchStartY = e.touches[0].clientY;
+    };
+    const handleTouchMove = (e) => {
+      const touchY = e.touches[0].clientY;
+      const scrollTop = document.documentElement.scrollTop || document.body.scrollTop;
+      if (scrollTop === 0 && touchY > touchStartY + 50 && !isRefreshing) {
+        handleRefresh();
+      }
+    };
+    const handleRefresh = async () => {
+      setIsRefreshing(true);
+      try {
+        await onRefresh();
+      } finally {
+        setIsRefreshing(false);
+      }
+    };
+    window.addEventListener("touchstart", handleTouchStart, { passive: true });
+    window.addEventListener("touchmove", handleTouchMove, { passive: true });
+    return () => {
+      window.removeEventListener("touchstart", handleTouchStart);
+      window.removeEventListener("touchmove", handleTouchMove);
+    };
+  }, [onRefresh, isRefreshing]);
+  return { isRefreshing };
+}
+
+exports.useInstallPrompt = useInstallPrompt;
+exports.useNetworkStatus = useNetworkStatus;
+exports.useNotifications = useNotifications;
+exports.usePullToRefresh = usePullToRefresh;

package/dist/mobile/index.d.cts

@@ -0,0 +1,15 @@
+declare function useNetworkStatus(): boolean;
+declare function useInstallPrompt(): {
+    canInstall: boolean;
+    promptInstall: () => Promise<void>;
+};
+declare function useNotifications(): {
+    permission: NotificationPermission;
+    requestPermission: () => Promise<void>;
+    sendNotification: (title: string, options?: NotificationOptions) => void;
+};
+declare function usePullToRefresh(onRefresh: () => Promise<void>): {
+    isRefreshing: boolean;
+};
+
+export { useInstallPrompt, useNetworkStatus, useNotifications, usePullToRefresh };

package/dist/mobile/index.d.ts

@@ -0,0 +1,15 @@
+declare function useNetworkStatus(): boolean;
+declare function useInstallPrompt(): {
+    canInstall: boolean;
+    promptInstall: () => Promise<void>;
+};
+declare function useNotifications(): {
+    permission: NotificationPermission;
+    requestPermission: () => Promise<void>;
+    sendNotification: (title: string, options?: NotificationOptions) => void;
+};
+declare function usePullToRefresh(onRefresh: () => Promise<void>): {
+    isRefreshing: boolean;
+};
+
+export { useInstallPrompt, useNetworkStatus, useNotifications, usePullToRefresh };

package/dist/mobile/index.js

@@ -0,0 +1,96 @@
+import '../chunk-MLKGABMK.js';
+import { useState, useEffect, useCallback } from 'react';
+
+function useNetworkStatus() {
+  const [isOnline, setIsOnline] = useState(
+    typeof window !== "undefined" ? window.navigator.onLine : true
+  );
+  useEffect(() => {
+    const handleOnline = () => setIsOnline(true);
+    const handleOffline = () => setIsOnline(false);
+    window.addEventListener("online", handleOnline);
+    window.addEventListener("offline", handleOffline);
+    return () => {
+      window.removeEventListener("online", handleOnline);
+      window.removeEventListener("offline", handleOffline);
+    };
+  }, []);
+  return isOnline;
+}
+function useInstallPrompt() {
+  const [installPrompt, setInstallPrompt] = useState(null);
+  const [canInstall, setCanInstall] = useState(false);
+  useEffect(() => {
+    const handleBeforeInstallPrompt = (e) => {
+      e.preventDefault();
+      setInstallPrompt(e);
+      setCanInstall(true);
+    };
+    window.addEventListener("beforeinstallprompt", handleBeforeInstallPrompt);
+    return () => {
+      window.removeEventListener("beforeinstallprompt", handleBeforeInstallPrompt);
+    };
+  }, []);
+  const promptInstall = useCallback(async () => {
+    if (!installPrompt) return;
+    installPrompt.prompt();
+    const result = await installPrompt.userChoice;
+    if (result.outcome === "accepted") {
+      setCanInstall(false);
+      setInstallPrompt(null);
+    }
+  }, [installPrompt]);
+  return { canInstall, promptInstall };
+}
+function useNotifications() {
+  const [permission, setPermission] = useState(
+    typeof window !== "undefined" && "Notification" in window ? Notification.permission : "default"
+  );
+  const requestPermission = useCallback(async () => {
+    if (!("Notification" in window)) {
+      console.warn("Notifications not supported");
+      return;
+    }
+    const result = await Notification.requestPermission();
+    setPermission(result);
+  }, []);
+  const sendNotification = useCallback((title, options) => {
+    if (permission === "granted") {
+      new Notification(title, options);
+    }
+  }, [permission]);
+  return { permission, requestPermission, sendNotification };
+}
+function usePullToRefresh(onRefresh) {
+  const [isRefreshing, setIsRefreshing] = useState(false);
+  useEffect(() => {
+    let touchStartY = 0;
+    const handleTouchStart = (e) => {
+      touchStartY = e.touches[0].clientY;
+    };
+    const handleTouchMove = (e) => {
+      const touchY = e.touches[0].clientY;
+      const scrollTop = document.documentElement.scrollTop || document.body.scrollTop;
+      if (scrollTop === 0 && touchY > touchStartY + 50 && !isRefreshing) {
+        handleRefresh();
+      }
+    };
+    const handleRefresh = async () => {
+      setIsRefreshing(true);
+      try {
+        await onRefresh();
+      } finally {
+        setIsRefreshing(false);
+      }
+    };
+    window.addEventListener("touchstart", handleTouchStart, { passive: true });
+    window.addEventListener("touchmove", handleTouchMove, { passive: true });
+    return () => {
+      window.removeEventListener("touchstart", handleTouchStart);
+      window.removeEventListener("touchmove", handleTouchMove);
+    };
+  }, [onRefresh, isRefreshing]);
+  return { isRefreshing };
+}
+
+export { useInstallPrompt, useNetworkStatus, useNotifications, usePullToRefresh };

package/dist/pwa/index.cjs

@@ -0,0 +1,80 @@
+'use strict';
+
+require('../chunk-75ZPJI57.cjs');
+
+// src/pwa/index.ts
+function generateManifest(options) {
+  return {
+    name: options.name,
+    short_name: options.shortName || options.name,
+    description: options.description || "",
+    start_url: options.startUrl || "/",
+    display: "standalone",
+    background_color: options.backgroundColor || "#ffffff",
+    theme_color: options.theme || "#000000",
+    icons: options.icons || [
+      {
+        src: "/icon-192.png",
+        sizes: "192x192",
+        type: "image/png"
+      },
+      {
+        src: "/icon-512.png",
+        sizes: "512x512",
+        type: "image/png"
+      }
+    ]
+  };
+}
+function generateServiceWorker(options) {
+  const cacheName = `${options.name.toLowerCase().replace(/\s+/g, "-")}-v1`;
+  const offlinePages = options.offline?.pages || ["/"];
+  return `
+const CACHE_NAME = '${cacheName}';
+const OFFLINE_PAGES = ${JSON.stringify(offlinePages)};
+
+self.addEventListener('install', (event) => {
+  event.waitUntil(
+    caches.open(CACHE_NAME).then((cache) => {
+      return cache.addAll(OFFLINE_PAGES);
+    })
+  );
+  self.skipWaiting();
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    caches.keys().then((cacheNames) => {
+      return Promise.all(
+        cacheNames.map((cacheName) => {
+          if (cacheName !== CACHE_NAME) {
+            return caches.delete(cacheName);
+          }
+        })
+      );
+    })
+  );
+  self.clients.claim();
+});
+
+self.addEventListener('fetch', (event) => {
+  event.respondWith(
+    caches.match(event.request).then((response) => {
+      return response || fetch(event.request).catch(() => {
+        return caches.match('/');
+      });
+    })
+  );
+});
+`.trim();
+}
+function configurePWA(options) {
+  return {
+    manifest: generateManifest(options),
+    serviceWorker: options.offline?.enabled ? generateServiceWorker(options) : null
+  };
+}
+
+exports.configurePWA = configurePWA;
+exports.generateManifest = generateManifest;
+exports.generateServiceWorker = generateServiceWorker;

package/dist/pwa/index.d.cts

@@ -0,0 +1,51 @@
+interface PWAOptions {
+    name: string;
+    shortName?: string;
+    theme?: string;
+    backgroundColor?: string;
+    description?: string;
+    startUrl?: string;
+    icons?: {
+        src: string;
+        sizes: string;
+        type?: string;
+    }[];
+    offline?: {
+        enabled: boolean;
+        pages?: string[];
+    };
+}
+declare function generateManifest(options: PWAOptions): {
+    name: string;
+    short_name: string;
+    description: string;
+    start_url: string;
+    display: string;
+    background_color: string;
+    theme_color: string;
+    icons: {
+        src: string;
+        sizes: string;
+        type?: string;
+    }[];
+};
+declare function generateServiceWorker(options: PWAOptions): string;
+declare function configurePWA(options: PWAOptions): {
+    manifest: {
+        name: string;
+        short_name: string;
+        description: string;
+        start_url: string;
+        display: string;
+        background_color: string;
+        theme_color: string;
+        icons: {
+            src: string;
+            sizes: string;
+            type?: string;
+        }[];
+    };
+    serviceWorker: string | null;
+};
+
+export { type PWAOptions, configurePWA, generateManifest, generateServiceWorker };

package/dist/pwa/index.d.ts

@@ -0,0 +1,51 @@
+interface PWAOptions {
+    name: string;
+    shortName?: string;
+    theme?: string;
+    backgroundColor?: string;
+    description?: string;
+    startUrl?: string;
+    icons?: {
+        src: string;
+        sizes: string;
+        type?: string;
+    }[];
+    offline?: {
+        enabled: boolean;
+        pages?: string[];
+    };
+}
+declare function generateManifest(options: PWAOptions): {
+    name: string;
+    short_name: string;
+    description: string;
+    start_url: string;
+    display: string;
+    background_color: string;
+    theme_color: string;
+    icons: {
+        src: string;
+        sizes: string;
+        type?: string;
+    }[];
+};
+declare function generateServiceWorker(options: PWAOptions): string;
+declare function configurePWA(options: PWAOptions): {
+    manifest: {
+        name: string;
+        short_name: string;
+        description: string;
+        start_url: string;
+        display: string;
+        background_color: string;
+        theme_color: string;
+        icons: {
+            src: string;
+            sizes: string;
+            type?: string;
+        }[];
+    };
+    serviceWorker: string | null;
+};
+
+export { type PWAOptions, configurePWA, generateManifest, generateServiceWorker };

package/dist/pwa/index.js

@@ -0,0 +1,76 @@
+import '../chunk-MLKGABMK.js';
+
+// src/pwa/index.ts
+function generateManifest(options) {
+  return {
+    name: options.name,
+    short_name: options.shortName || options.name,
+    description: options.description || "",
+    start_url: options.startUrl || "/",
+    display: "standalone",
+    background_color: options.backgroundColor || "#ffffff",
+    theme_color: options.theme || "#000000",
+    icons: options.icons || [
+      {
+        src: "/icon-192.png",
+        sizes: "192x192",
+        type: "image/png"
+      },
+      {
+        src: "/icon-512.png",
+        sizes: "512x512",
+        type: "image/png"
+      }
+    ]
+  };
+}
+function generateServiceWorker(options) {
+  const cacheName = `${options.name.toLowerCase().replace(/\s+/g, "-")}-v1`;
+  const offlinePages = options.offline?.pages || ["/"];
+  return `
+const CACHE_NAME = '${cacheName}';
+const OFFLINE_PAGES = ${JSON.stringify(offlinePages)};
+
+self.addEventListener('install', (event) => {
+  event.waitUntil(
+    caches.open(CACHE_NAME).then((cache) => {
+      return cache.addAll(OFFLINE_PAGES);
+    })
+  );
+  self.skipWaiting();
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    caches.keys().then((cacheNames) => {
+      return Promise.all(
+        cacheNames.map((cacheName) => {
+          if (cacheName !== CACHE_NAME) {
+            return caches.delete(cacheName);
+          }
+        })
+      );
+    })
+  );
+  self.clients.claim();
+});
+
+self.addEventListener('fetch', (event) => {
+  event.respondWith(
+    caches.match(event.request).then((response) => {
+      return response || fetch(event.request).catch(() => {
+        return caches.match('/');
+      });
+    })
+  );
+});
+`.trim();
+}
+function configurePWA(options) {
+  return {
+    manifest: generateManifest(options),
+    serviceWorker: options.offline?.enabled ? generateServiceWorker(options) : null
+  };
+}
+
+export { configurePWA, generateManifest, generateServiceWorker };

package/package.json

@@ -0,0 +1,140 @@
+{
+  "name": "miragedev-sdk",
+  "version": "0.1.0",
+  "description": "AI-first SDK for building SAAS applications with Next.js",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "miragedev": "./dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js",
+      "require": "./dist/auth/index.cjs"
+    },
+    "./auth/client": {
+      "types": "./dist/auth/client.d.ts",
+      "import": "./dist/auth/client.js",
+      "require": "./dist/auth/client.cjs"
+    },
+    "./auth/biometric": {
+      "types": "./dist/auth/biometric.d.ts",
+      "import": "./dist/auth/biometric.js",
+      "require": "./dist/auth/biometric.cjs"
+    },
+    "./auth/middleware": {
+      "types": "./dist/auth/middleware.d.ts",
+      "import": "./dist/auth/middleware.js",
+      "require": "./dist/auth/middleware.cjs"
+    },
+    "./billing": {
+      "types": "./dist/billing/index.d.ts",
+      "import": "./dist/billing/index.js",
+      "require": "./dist/billing/index.cjs"
+    },
+    "./billing/client": {
+      "types": "./dist/billing/client.d.ts",
+      "import": "./dist/billing/client.js",
+      "require": "./dist/billing/client.cjs"
+    },
+    "./billing/mobile": {
+      "types": "./dist/billing/mobile.d.ts",
+      "import": "./dist/billing/mobile.js",
+      "require": "./dist/billing/mobile.cjs"
+    },
+    "./billing/webhook": {
+      "types": "./dist/billing/webhook.d.ts",
+      "import": "./dist/billing/webhook.js",
+      "require": "./dist/billing/webhook.cjs"
+    },
+    "./email": {
+      "types": "./dist/email/index.d.ts",
+      "import": "./dist/email/index.js",
+      "require": "./dist/email/index.cjs"
+    },
+    "./pwa": {
+      "types": "./dist/pwa/index.d.ts",
+      "import": "./dist/pwa/index.js",
+      "require": "./dist/pwa/index.cjs"
+    },
+    "./mobile": {
+      "types": "./dist/mobile/index.d.ts",
+      "import": "./dist/mobile/index.js",
+      "require": "./dist/mobile/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "npm run type-check && npm run test -- --run && npm run build"
+  },
+  "keywords": [
+    "saas",
+    "nextjs",
+    "next",
+    "auth",
+    "authentication",
+    "billing",
+    "stripe",
+    "subscriptions",
+    "email",
+    "resend",
+    "pwa",
+    "mobile",
+    "react",
+    "typescript",
+    "sdk",
+    "ai-friendly",
+    "jsdoc"
+  ],
+  "author": "MirageDev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/miragedev/miragedev-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/miragedev/miragedev-sdk/issues"
+  },
+  "homepage": "https://github.com/miragedev/miragedev-sdk#readme",
+  "peerDependencies": {
+    "next": ">=14.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.1",
+    "@types/node": "^25.0.3",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@vitest/coverage-v8": "^4.0.16",
+    "happy-dom": "^20.1.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16",
+    "zod": "^4.3.5"
+  },
+  "dependencies": {
+    "@react-email/components": "^1.0.4",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "inquirer": "^13.1.0",
+    "ora": "^9.0.0",
+    "resend": "^6.7.0",
+    "stripe": "^20.1.2"
+  }
+}