@flightdev/mobile 0.2.0

package/dist/platform-Cq72g4Qx.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Platform detection utilities.
+ * Works without Capacitor installed - gracefully degrades.
+ */
+type Platform = 'web' | 'ios' | 'android';
+interface PlatformInfo {
+    /** Current platform: 'web', 'ios', or 'android' */
+    platform: Platform;
+    /** True if running as a native app (iOS or Android) */
+    isNative: boolean;
+    /** True if running on iOS */
+    isIOS: boolean;
+    /** True if running on Android */
+    isAndroid: boolean;
+    /** True if running as a web app */
+    isWeb: boolean;
+    /** True if Capacitor is available */
+    hasCapacitor: boolean;
+}
+/**
+ * Detect the current platform.
+ *
+ * @returns Platform information object
+ *
+ * @example
+ * ```typescript
+ * const { isNative, isIOS, platform } = getPlatform();
+ *
+ * if (isNative) {
+ *     // Use native features
+ * }
+ *
+ * if (isIOS) {
+ *     // iOS-specific code
+ * }
+ * ```
+ */
+declare function getPlatform(): PlatformInfo;
+/**
+ * Check if a Capacitor plugin is available.
+ *
+ * @param pluginName - Name of the plugin to check
+ * @returns True if the plugin is registered
+ *
+ * @example
+ * ```typescript
+ * if (isPluginAvailable('Camera')) {
+ *     // Camera plugin is installed
+ * }
+ * ```
+ */
+declare function isPluginAvailable(pluginName: string): boolean;
+/**
+ * Get safe area insets for notched devices.
+ * Returns zeros on web or when not available.
+ */
+declare function getSafeAreaInsets(): {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
+/**
+ * Check if running in a PWA installed context.
+ */
+declare function isPWA(): boolean;
+
+export { type Platform as P, type PlatformInfo as a, getSafeAreaInsets as b, isPWA as c, getPlatform as g, isPluginAvailable as i };

package/dist/plugins/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Plugin utilities for @flightdev/mobile
+ *
+ * Helpers for working with Capacitor plugins.
+ */
+/**
+ * Check if required plugins are installed.
+ * Useful for showing warnings or fallback UI.
+ *
+ * @example
+ * ```typescript
+ * const missing = checkPlugins(['Camera', 'Geolocation']);
+ * if (missing.length > 0) {
+ *     console.warn('Missing plugins:', missing);
+ * }
+ * ```
+ */
+declare function checkPlugins(pluginNames: string[]): string[];
+/**
+ * Ensure all required plugins are available.
+ * Throws error if any are missing.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *     requirePlugins(['Camera', 'Geolocation']);
+ * } catch (error) {
+ *     console.error('Please install required plugins');
+ * }
+ * ```
+ */
+declare function requirePlugins(pluginNames: string[]): void;
+interface PluginInfo {
+    name: string;
+    package: string;
+    available: boolean;
+    description: string;
+}
+/**
+ * List of supported plugins with their status.
+ */
+declare function getPluginInfo(): PluginInfo[];
+/**
+ * Get installed plugins.
+ */
+declare function getInstalledPlugins(): string[];
+/**
+ * Get missing plugins from a required list.
+ */
+declare function getMissingPlugins(required: string[]): PluginInfo[];
+
+export { checkPlugins, getInstalledPlugins, getMissingPlugins, getPluginInfo, requirePlugins };

package/dist/plugins/index.js

@@ -0,0 +1,104 @@
+// src/platform.ts
+function getCapacitor() {
+  try {
+    const Capacitor = globalThis.Capacitor;
+    return Capacitor || null;
+  } catch {
+    return null;
+  }
+}
+function isPluginAvailable(pluginName) {
+  const Capacitor = getCapacitor();
+  if (!Capacitor || !Capacitor.isPluginAvailable) {
+    return false;
+  }
+  return Capacitor.isPluginAvailable(pluginName);
+}
+
+// src/plugins/index.ts
+function checkPlugins(pluginNames) {
+  return pluginNames.filter((name) => !isPluginAvailable(name));
+}
+function requirePlugins(pluginNames) {
+  const missing = checkPlugins(pluginNames);
+  if (missing.length > 0) {
+    throw new Error(
+      `Missing Capacitor plugins: ${missing.join(", ")}. Install with: npm install ${missing.map((p) => `@capacitor/${p.toLowerCase()}`).join(" ")}`
+    );
+  }
+}
+function getPluginInfo() {
+  return [
+    {
+      name: "Camera",
+      package: "@capacitor/camera",
+      available: isPluginAvailable("Camera"),
+      description: "Take photos and pick images"
+    },
+    {
+      name: "Geolocation",
+      package: "@capacitor/geolocation",
+      available: isPluginAvailable("Geolocation"),
+      description: "Get device location"
+    },
+    {
+      name: "PushNotifications",
+      package: "@capacitor/push-notifications",
+      available: isPluginAvailable("PushNotifications"),
+      description: "Receive push notifications"
+    },
+    {
+      name: "Haptics",
+      package: "@capacitor/haptics",
+      available: isPluginAvailable("Haptics"),
+      description: "Haptic feedback"
+    },
+    {
+      name: "Preferences",
+      package: "@capacitor/preferences",
+      available: isPluginAvailable("Preferences"),
+      description: "Key-value storage"
+    },
+    {
+      name: "App",
+      package: "@capacitor/app",
+      available: isPluginAvailable("App"),
+      description: "App lifecycle and info"
+    },
+    {
+      name: "StatusBar",
+      package: "@capacitor/status-bar",
+      available: isPluginAvailable("StatusBar"),
+      description: "Control status bar"
+    },
+    {
+      name: "Keyboard",
+      package: "@capacitor/keyboard",
+      available: isPluginAvailable("Keyboard"),
+      description: "Control keyboard"
+    },
+    {
+      name: "Share",
+      package: "@capacitor/share",
+      available: isPluginAvailable("Share"),
+      description: "Share content"
+    },
+    {
+      name: "Clipboard",
+      package: "@capacitor/clipboard",
+      available: isPluginAvailable("Clipboard"),
+      description: "Copy and paste"
+    }
+  ];
+}
+function getInstalledPlugins() {
+  return getPluginInfo().filter((p) => p.available).map((p) => p.name);
+}
+function getMissingPlugins(required) {
+  const info = getPluginInfo();
+  return required.map((name) => info.find((p) => p.name === name)).filter((p) => p !== void 0 && !p.available);
+}
+
+export { checkPlugins, getInstalledPlugins, getMissingPlugins, getPluginInfo, requirePlugins };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/platform.ts","../../src/plugins/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Platform detection utilities.\r\n * Works without Capacitor installed - gracefully degrades.\r\n */\r\n\r\n// =============================================================================\r\n// Types\r\n// =============================================================================\r\n\r\nexport type Platform = 'web' | 'ios' | 'android';\r\n\r\nexport interface PlatformInfo {\r\n    /** Current platform: 'web', 'ios', or 'android' */\r\n    platform: Platform;\r\n    /** True if running as a native app (iOS or Android) */\r\n    isNative: boolean;\r\n    /** True if running on iOS */\r\n    isIOS: boolean;\r\n    /** True if running on Android */\r\n    isAndroid: boolean;\r\n    /** True if running as a web app */\r\n    isWeb: boolean;\r\n    /** True if Capacitor is available */\r\n    hasCapacitor: boolean;\r\n}\r\n\r\n// =============================================================================\r\n// Detection\r\n// =============================================================================\r\n\r\n/**\r\n * Get Capacitor instance if available.\r\n * Returns null if Capacitor is not installed.\r\n */\r\nfunction getCapacitor(): any {\r\n    try {\r\n        // Dynamic import to avoid errors when Capacitor is not installed\r\n        const Capacitor = (globalThis as any).Capacitor;\r\n        return Capacitor || null;\r\n    } catch {\r\n        return null;\r\n    }\r\n}\r\n\r\n/**\r\n * Detect the current platform.\r\n * \r\n * @returns Platform information object\r\n * \r\n * @example\r\n * ```typescript\r\n * const { isNative, isIOS, platform } = getPlatform();\r\n * \r\n * if (isNative) {\r\n *     // Use native features\r\n * }\r\n * \r\n * if (isIOS) {\r\n *     // iOS-specific code\r\n * }\r\n * ```\r\n */\r\nexport function getPlatform(): PlatformInfo {\r\n    const Capacitor = getCapacitor();\r\n\r\n    if (!Capacitor) {\r\n        return {\r\n            platform: 'web',\r\n            isNative: false,\r\n            isIOS: false,\r\n            isAndroid: false,\r\n            isWeb: true,\r\n            hasCapacitor: false,\r\n        };\r\n    }\r\n\r\n    const platform = Capacitor.getPlatform() as Platform;\r\n    const isNative = Capacitor.isNativePlatform();\r\n\r\n    return {\r\n        platform,\r\n        isNative,\r\n        isIOS: platform === 'ios',\r\n        isAndroid: platform === 'android',\r\n        isWeb: platform === 'web',\r\n        hasCapacitor: true,\r\n    };\r\n}\r\n\r\n/**\r\n * Check if a Capacitor plugin is available.\r\n * \r\n * @param pluginName - Name of the plugin to check\r\n * @returns True if the plugin is registered\r\n * \r\n * @example\r\n * ```typescript\r\n * if (isPluginAvailable('Camera')) {\r\n *     // Camera plugin is installed\r\n * }\r\n * ```\r\n */\r\nexport function isPluginAvailable(pluginName: string): boolean {\r\n    const Capacitor = getCapacitor();\r\n\r\n    if (!Capacitor || !Capacitor.isPluginAvailable) {\r\n        return false;\r\n    }\r\n\r\n    return Capacitor.isPluginAvailable(pluginName);\r\n}\r\n\r\n/**\r\n * Get safe area insets for notched devices.\r\n * Returns zeros on web or when not available.\r\n */\r\nexport function getSafeAreaInsets(): {\r\n    top: number;\r\n    bottom: number;\r\n    left: number;\r\n    right: number;\r\n} {\r\n    // Try to get from CSS env variables\r\n    if (typeof window !== 'undefined' && typeof window.getComputedStyle === 'function') {\r\n        const style = getComputedStyle(document.documentElement);\r\n        return {\r\n            top: parseInt(style.getPropertyValue('--sat') || '0', 10),\r\n            bottom: parseInt(style.getPropertyValue('--sab') || '0', 10),\r\n            left: parseInt(style.getPropertyValue('--sal') || '0', 10),\r\n            right: parseInt(style.getPropertyValue('--sar') || '0', 10),\r\n        };\r\n    }\r\n\r\n    return { top: 0, bottom: 0, left: 0, right: 0 };\r\n}\r\n\r\n/**\r\n * Check if running in a PWA installed context.\r\n */\r\nexport function isPWA(): boolean {\r\n    if (typeof window === 'undefined') return false;\r\n\r\n    return window.matchMedia('(display-mode: standalone)').matches ||\r\n        (window.navigator as any).standalone === true;\r\n}\r\n","/**\r\n * Plugin utilities for @flightdev/mobile\r\n * \r\n * Helpers for working with Capacitor plugins.\r\n */\r\n\r\nimport { isPluginAvailable } from '../platform';\r\n\r\n// =============================================================================\r\n// Plugin Check\r\n// =============================================================================\r\n\r\n/**\r\n * Check if required plugins are installed.\r\n * Useful for showing warnings or fallback UI.\r\n * \r\n * @example\r\n * ```typescript\r\n * const missing = checkPlugins(['Camera', 'Geolocation']);\r\n * if (missing.length > 0) {\r\n *     console.warn('Missing plugins:', missing);\r\n * }\r\n * ```\r\n */\r\nexport function checkPlugins(pluginNames: string[]): string[] {\r\n    return pluginNames.filter(name => !isPluginAvailable(name));\r\n}\r\n\r\n/**\r\n * Ensure all required plugins are available.\r\n * Throws error if any are missing.\r\n * \r\n * @example\r\n * ```typescript\r\n * try {\r\n *     requirePlugins(['Camera', 'Geolocation']);\r\n * } catch (error) {\r\n *     console.error('Please install required plugins');\r\n * }\r\n * ```\r\n */\r\nexport function requirePlugins(pluginNames: string[]): void {\r\n    const missing = checkPlugins(pluginNames);\r\n\r\n    if (missing.length > 0) {\r\n        throw new Error(\r\n            `Missing Capacitor plugins: ${missing.join(', ')}. ` +\r\n            `Install with: npm install ${missing.map(p => `@capacitor/${p.toLowerCase()}`).join(' ')}`\r\n        );\r\n    }\r\n}\r\n\r\n// =============================================================================\r\n// Plugin Info\r\n// =============================================================================\r\n\r\ninterface PluginInfo {\r\n    name: string;\r\n    package: string;\r\n    available: boolean;\r\n    description: string;\r\n}\r\n\r\n/**\r\n * List of supported plugins with their status.\r\n */\r\nexport function getPluginInfo(): PluginInfo[] {\r\n    return [\r\n        {\r\n            name: 'Camera',\r\n            package: '@capacitor/camera',\r\n            available: isPluginAvailable('Camera'),\r\n            description: 'Take photos and pick images',\r\n        },\r\n        {\r\n            name: 'Geolocation',\r\n            package: '@capacitor/geolocation',\r\n            available: isPluginAvailable('Geolocation'),\r\n            description: 'Get device location',\r\n        },\r\n        {\r\n            name: 'PushNotifications',\r\n            package: '@capacitor/push-notifications',\r\n            available: isPluginAvailable('PushNotifications'),\r\n            description: 'Receive push notifications',\r\n        },\r\n        {\r\n            name: 'Haptics',\r\n            package: '@capacitor/haptics',\r\n            available: isPluginAvailable('Haptics'),\r\n            description: 'Haptic feedback',\r\n        },\r\n        {\r\n            name: 'Preferences',\r\n            package: '@capacitor/preferences',\r\n            available: isPluginAvailable('Preferences'),\r\n            description: 'Key-value storage',\r\n        },\r\n        {\r\n            name: 'App',\r\n            package: '@capacitor/app',\r\n            available: isPluginAvailable('App'),\r\n            description: 'App lifecycle and info',\r\n        },\r\n        {\r\n            name: 'StatusBar',\r\n            package: '@capacitor/status-bar',\r\n            available: isPluginAvailable('StatusBar'),\r\n            description: 'Control status bar',\r\n        },\r\n        {\r\n            name: 'Keyboard',\r\n            package: '@capacitor/keyboard',\r\n            available: isPluginAvailable('Keyboard'),\r\n            description: 'Control keyboard',\r\n        },\r\n        {\r\n            name: 'Share',\r\n            package: '@capacitor/share',\r\n            available: isPluginAvailable('Share'),\r\n            description: 'Share content',\r\n        },\r\n        {\r\n            name: 'Clipboard',\r\n            package: '@capacitor/clipboard',\r\n            available: isPluginAvailable('Clipboard'),\r\n            description: 'Copy and paste',\r\n        },\r\n    ];\r\n}\r\n\r\n/**\r\n * Get installed plugins.\r\n */\r\nexport function getInstalledPlugins(): string[] {\r\n    return getPluginInfo()\r\n        .filter(p => p.available)\r\n        .map(p => p.name);\r\n}\r\n\r\n/**\r\n * Get missing plugins from a required list.\r\n */\r\nexport function getMissingPlugins(required: string[]): PluginInfo[] {\r\n    const info = getPluginInfo();\r\n\r\n    return required\r\n        .map(name => info.find(p => p.name === name))\r\n        .filter((p): p is PluginInfo => p !== undefined && !p.available);\r\n}\r\n"]}

package/dist/react/index.d.ts

@@ -0,0 +1,259 @@
+import { a as PlatformInfo } from '../platform-Cq72g4Qx.js';
+
+/**
+ * React hooks for @flightdev/mobile
+ *
+ * Provides React-friendly wrappers around Capacitor plugins.
+ * All hooks gracefully degrade on web - no errors if plugin not installed.
+ *
+ * Philosophy: Flight doesn't impose - use only the hooks you need.
+ * Each Capacitor plugin is an optional peer dependency.
+ *
+ * @example
+ * ```typescript
+ * import { usePlatform, useCamera, useGeolocation } from '@flightdev/mobile/react';
+ *
+ * function App() {
+ *     const { isNative, isIOS } = usePlatform();
+ *     const { takePhoto } = useCamera();
+ *     const { position, getCurrentPosition } = useGeolocation();
+ *
+ *     // ...
+ * }
+ * ```
+ */
+
+/**
+ * Get current platform information.
+ *
+ * @example
+ * ```typescript
+ * function App() {
+ *     const { isNative, isIOS, isAndroid, isWeb } = usePlatform();
+ *
+ *     if (isNative) {
+ *         return <NativeApp />;
+ *     }
+ *
+ *     return <WebApp />;
+ * }
+ * ```
+ */
+declare function usePlatform(): PlatformInfo;
+interface CameraResult {
+    /** Path to the image that can be used as src */
+    webPath?: string;
+    /** Base64 encoded image data */
+    base64String?: string;
+    /** Platform-specific path */
+    path?: string;
+    /** Image format (jpeg, png, etc.) */
+    format?: string;
+    /** Whether the image was saved to gallery */
+    saved?: boolean;
+}
+interface UseCameraOptions {
+    /** Image quality (0-100) */
+    quality?: number;
+    /** Allow editing before returning */
+    allowEditing?: boolean;
+    /** Save to photo gallery */
+    saveToGallery?: boolean;
+    /** Width constraint */
+    width?: number;
+    /** Height constraint */
+    height?: number;
+}
+interface UseCameraReturn {
+    /** Take a photo with the camera */
+    takePhoto: (options?: UseCameraOptions) => Promise<CameraResult | null>;
+    /** Pick an image from gallery */
+    pickImage: (options?: UseCameraOptions) => Promise<CameraResult | null>;
+    /** Camera is available */
+    available: boolean;
+}
+/**
+ * Camera hook for taking photos and picking images.
+ * Requires @capacitor/camera to be installed.
+ *
+ * @example
+ * ```typescript
+ * function PhotoCapture() {
+ *     const { takePhoto, pickImage, available } = useCamera();
+ *
+ *     const handleCapture = async () => {
+ *         const photo = await takePhoto({ quality: 90 });
+ *         if (photo?.webPath) {
+ *             setImage(photo.webPath);
+ *         }
+ *     };
+ *
+ *     if (!available) return <p>Camera not available</p>;
+ *
+ *     return <button onClick={handleCapture}>Take Photo</button>;
+ * }
+ * ```
+ */
+declare function useCamera(): UseCameraReturn;
+interface GeolocationPosition {
+    coords: {
+        latitude: number;
+        longitude: number;
+        accuracy: number;
+        altitude: number | null;
+        altitudeAccuracy: number | null;
+        heading: number | null;
+        speed: number | null;
+    };
+    timestamp: number;
+}
+interface UseGeolocationReturn {
+    /** Current position (null until fetched) */
+    position: GeolocationPosition | null;
+    /** Fetch error if any */
+    error: Error | null;
+    /** Loading state */
+    loading: boolean;
+    /** Get current position */
+    getCurrentPosition: () => Promise<GeolocationPosition | null>;
+    /** Start watching position changes */
+    watchPosition: (callback: (pos: GeolocationPosition) => void) => Promise<string | null>;
+    /** Stop watching position */
+    clearWatch: (watchId: string) => Promise<void>;
+    /** Geolocation is available */
+    available: boolean;
+}
+/**
+ * Geolocation hook for getting device position.
+ * Requires @capacitor/geolocation to be installed.
+ *
+ * @example
+ * ```typescript
+ * function LocationTracker() {
+ *     const { position, error, loading, getCurrentPosition, available } = useGeolocation();
+ *
+ *     if (!available) return <p>Geolocation not available</p>;
+ *     if (loading) return <p>Getting location...</p>;
+ *     if (error) return <p>Error: {error.message}</p>;
+ *
+ *     return (
+ *         <div>
+ *             <p>Lat: {position?.coords.latitude}</p>
+ *             <p>Lng: {position?.coords.longitude}</p>
+ *             <button onClick={getCurrentPosition}>Refresh</button>
+ *         </div>
+ *     );
+ * }
+ * ```
+ */
+declare function useGeolocation(): UseGeolocationReturn;
+interface UsePushNotificationsReturn {
+    /** FCM/APNs token for the device */
+    token: string | null;
+    /** Request permission and register for notifications */
+    requestPermission: () => Promise<boolean>;
+    /** Add listener for notification received */
+    onNotificationReceived: (callback: (notification: any) => void) => Promise<() => void>;
+    /** Add listener for notification action */
+    onNotificationAction: (callback: (notification: any) => void) => Promise<() => void>;
+    /** Push notifications available */
+    available: boolean;
+}
+/**
+ * Push notifications hook.
+ * Requires @capacitor/push-notifications to be installed.
+ *
+ * @example
+ * ```typescript
+ * function NotificationSetup() {
+ *     const { token, requestPermission, onNotificationReceived, available } = usePushNotifications();
+ *
+ *     useEffect(() => {
+ *         if (!available) return;
+ *
+ *         requestPermission();
+ *
+ *         const cleanup = onNotificationReceived((notification) => {
+ *             console.log('Received:', notification);
+ *         });
+ *
+ *         return () => { cleanup.then(fn => fn?.()); };
+ *     }, []);
+ *
+ *     return <p>Token: {token}</p>;
+ * }
+ * ```
+ */
+declare function usePushNotifications(): UsePushNotificationsReturn;
+interface UseHapticsReturn {
+    /** Light impact feedback */
+    impact: (style?: 'light' | 'medium' | 'heavy') => Promise<void>;
+    /** Notification feedback */
+    notification: (type?: 'success' | 'warning' | 'error') => Promise<void>;
+    /** Selection feedback */
+    selection: () => Promise<void>;
+    /** Vibrate for duration */
+    vibrate: (duration?: number) => Promise<void>;
+    /** Haptics available */
+    available: boolean;
+}
+/**
+ * Haptic feedback hook.
+ * Requires @capacitor/haptics to be installed.
+ *
+ * @example
+ * ```typescript
+ * function HapticButton() {
+ *     const { impact, notification, available } = useHaptics();
+ *
+ *     const handlePress = async () => {
+ *         await impact('medium');
+ *         // Do action
+ *     };
+ *
+ *     const handleSuccess = async () => {
+ *         await notification('success');
+ *     };
+ *
+ *     return <button onClick={handlePress}>Press me</button>;
+ * }
+ * ```
+ */
+declare function useHaptics(): UseHapticsReturn;
+interface UseStorageReturn {
+    /** Get a value from storage */
+    get: (key: string) => Promise<string | null>;
+    /** Set a value in storage */
+    set: (key: string, value: string) => Promise<void>;
+    /** Remove a value from storage */
+    remove: (key: string) => Promise<void>;
+    /** Get all keys */
+    keys: () => Promise<string[]>;
+    /** Clear all storage */
+    clear: () => Promise<void>;
+    /** Storage available */
+    available: boolean;
+}
+/**
+ * Secure storage hook using Capacitor Preferences.
+ * Falls back to localStorage on web.
+ * Requires @capacitor/preferences to be installed for native.
+ *
+ * @example
+ * ```typescript
+ * function UserSettings() {
+ *     const { get, set, remove } = useStorage();
+ *
+ *     const saveTheme = async (theme: string) => {
+ *         await set('theme', theme);
+ *     };
+ *
+ *     const loadTheme = async () => {
+ *         return await get('theme') ?? 'light';
+ *     };
+ * }
+ * ```
+ */
+declare function useStorage(): UseStorageReturn;
+
+export { useCamera, useGeolocation, useHaptics, usePlatform, usePushNotifications, useStorage };