@use-voltra/android 1.3.1 → 1.4.0-rc.0

package/build/esm/events.js

@@ -1,29 +0,0 @@
-import { Platform } from 'react-native';
-import VoltraModule from './VoltraModule.js';
-const noopSubscription = {
-    remove: () => { },
-};
-/**
- * Add a listener for Voltra events.
- *
- * Supported events:
- * - `interaction`: User interactions with widgets (buttons, switches, checkboxes) (iOS only)
- * - `stateChange`: Live Activity state changes (iOS only)
- * - `activityTokenReceived`: Push token for Live Activity (iOS only)
- * - `activityPushToStartTokenReceived`: Push-to-start token (iOS only)
- *
- * Note: On Android, interactions open the app directly (optionally via deep links)
- * instead of emitting background events.
- *
- * @param event The event type to listen for
- * @param listener Callback function to handle the event
- * @returns EventSubscription with a remove() method to unsubscribe
- */
-export function addVoltraListener(event, listener) {
-    if (Platform.OS !== 'ios') {
-        console.warn(`[Voltra] Event '${event}' is only supported on iOS. Returning no-op subscription.`);
-        return noopSubscription;
-    }
-    return VoltraModule.addListener(event, listener);
-}
-//# sourceMappingURL=events.js.map

package/build/esm/events.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAGvC,OAAO,YAAY,MAAM,mBAAmB,CAAA;AA6B5C,MAAM,gBAAgB,GAAsB;IAC1C,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;CACjB,CAAA;AASD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAQ,EACR,QAA4C;IAE5C,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,mBAAmB,KAAK,2DAA2D,CAAC,CAAA;QACjG,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,OAAO,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AAClD,CAAC"}

package/build/esm/live-update/api.js

@@ -1,203 +0,0 @@
-import { useCallback, useEffect, useRef, useState } from 'react';
-import { useUpdateOnHMR } from '../utils/index.js';
-import VoltraModule from '../VoltraModule.js';
-import { renderAndroidLiveUpdateToString } from './renderer.js';
-/**
- * @unstable This API is experimental and may change in future versions.
- *
- * React hook for managing Android Live Updates with automatic lifecycle handling.
- *
- * @param variants - The Android Live Update content variants to display
- * @param options - Configuration options for the hook
- * @returns Object with start, update, end methods and isActive state
- *
- * @example
- * ```tsx
- * import { VoltraAndroid, useAndroidLiveUpdate } from 'voltra'
- *
- * const MyLiveUpdate = () => {
- *   const { start, update, end, isActive } = useAndroidLiveUpdate({
- *     collapsed: <VoltraAndroid.Text>Delivery arriving</VoltraAndroid.Text>,
- *     expanded: <VoltraAndroid.Column>...</VoltraAndroid.Column>,
- *     channelId: 'delivery_updates',
- *   }, {
- *     updateName: 'my-live-update',
- *     autoStart: true,
- *     autoUpdate: true
- *   })
- *
- *   return (
- *     <View>
- *       <Button title={isActive ? "Stop" : "Start"} onPress={isActive ? end : start} />
- *     </View>
- *   )
- * }
- * ```
- */
-export const useAndroidLiveUpdate = (variants, options) => {
-    const [targetId, setTargetId] = useState(() => {
-        if (options?.updateName) {
-            return isAndroidLiveUpdateActive(options.updateName) ? options.updateName : null;
-        }
-        return null;
-    });
-    const isActive = targetId !== null;
-    const optionsRef = useRef(options);
-    const variantsRef = useRef(variants);
-    const lastUpdateOptionsRef = useRef(undefined);
-    // Update refs when values change
-    useEffect(() => {
-        optionsRef.current = options;
-    }, [options]);
-    useEffect(() => {
-        variantsRef.current = variants;
-    }, [variants]);
-    useUpdateOnHMR();
-    const start = useCallback(async (options) => {
-        const id = await startAndroidLiveUpdate(variantsRef.current, {
-            ...optionsRef.current,
-            ...options,
-        });
-        setTargetId(id);
-    }, []);
-    const update = useCallback(async (options) => {
-        if (!targetId) {
-            return;
-        }
-        const updateOptions = { ...optionsRef.current, ...options };
-        lastUpdateOptionsRef.current = updateOptions;
-        await updateAndroidLiveUpdate(targetId, variantsRef.current, updateOptions);
-    }, [targetId]);
-    const end = useCallback(async () => {
-        if (!targetId) {
-            return;
-        }
-        await stopAndroidLiveUpdate(targetId);
-        setTargetId(null);
-    }, [targetId]);
-    useEffect(() => {
-        if (!options?.autoStart) {
-            return;
-        }
-        start();
-    }, [options?.autoStart, start]);
-    useEffect(() => {
-        if (!options?.autoUpdate)
-            return;
-        update(lastUpdateOptionsRef.current);
-    }, [options?.autoUpdate, update, variants]);
-    return {
-        start,
-        update,
-        end,
-        isActive,
-    };
-};
-/**
- * @unstable This API is experimental and may change in future versions.
- *
- * Start a new Android Live Update with the provided content variants.
- *
- * @param variants - The Android Live Update content variants to display
- * @param options - Configuration options for the Live Update
- * @returns Promise resolving to the notification ID
- *
- * @example
- * ```tsx
- * import { VoltraAndroid, startAndroidLiveUpdate } from 'voltra'
- *
- * const notificationId = await startAndroidLiveUpdate({
- *   collapsed: <VoltraAndroid.Text>Delivery arriving</VoltraAndroid.Text>,
- *   expanded: <VoltraAndroid.Column>...</VoltraAndroid.Column>,
- *   channelId: 'delivery_updates',
- * }, {
- *   updateName: 'my-live-update',
- * })
- * ```
- */
-export const startAndroidLiveUpdate = async (variants, options) => {
-    const payload = renderAndroidLiveUpdateToString(variants);
-    const notificationId = await VoltraModule.startAndroidLiveUpdate(payload, {
-        updateName: options?.updateName,
-        channelId: options?.channelId || variants.channelId || 'voltra_live_updates',
-    });
-    return notificationId;
-};
-/**
- * @unstable This API is experimental and may change in future versions.
- *
- * Update an existing Android Live Update with new content.
- *
- * @param notificationId - The ID of the notification to update
- * @param variants - The new Android Live Update content variants
- * @param options - Update options
- *
- * @example
- * ```tsx
- * import { VoltraAndroid, updateAndroidLiveUpdate } from 'voltra'
- *
- * await updateAndroidLiveUpdate('notification-123', {
- *   collapsed: <VoltraAndroid.Text>Updated: Delivery arriving</VoltraAndroid.Text>,
- *   expanded: <VoltraAndroid.Column>...</VoltraAndroid.Column>,
- * })
- * ```
- */
-export const updateAndroidLiveUpdate = async (notificationId, variants, options) => {
-    const payload = renderAndroidLiveUpdateToString(variants);
-    return VoltraModule.updateAndroidLiveUpdate(notificationId, payload);
-};
-/**
- * @unstable This API is experimental and may change in future versions.
- *
- * Stop an Android Live Update and dismiss the notification.
- *
- * @param notificationId - The ID of the notification to stop
- *
- * @example
- * ```tsx
- * import { stopAndroidLiveUpdate } from 'voltra'
- *
- * await stopAndroidLiveUpdate('notification-123')
- * ```
- */
-export const stopAndroidLiveUpdate = async (notificationId) => {
-    return VoltraModule.stopAndroidLiveUpdate(notificationId);
-};
-/**
- * @unstable This API is experimental and may change in future versions.
- *
- * Check if an Android Live Update with the given name is currently active.
- *
- * @param updateName - The name of the Live Update to check
- * @returns true if the update is active, false otherwise
- *
- * @example
- * ```tsx
- * import { isAndroidLiveUpdateActive } from 'voltra'
- *
- * if (isAndroidLiveUpdateActive('my-live-update')) {
- *   console.log('Update is running')
- * }
- * ```
- */
-export const isAndroidLiveUpdateActive = (updateName) => {
-    return VoltraModule.isAndroidLiveUpdateActive(updateName);
-};
-/**
- * @unstable This API is experimental and may change in future versions.
- *
- * End all active Android Live Updates.
- *
- * This function stops and dismisses all currently running Live Updates in the app.
- *
- * @example
- * ```tsx
- * import { endAllAndroidLiveUpdates } from 'voltra'
- *
- * await endAllAndroidLiveUpdates()
- * ```
- */
-export async function endAllAndroidLiveUpdates() {
-    return VoltraModule.endAllAndroidLiveUpdates();
-}
-//# sourceMappingURL=api.js.map

package/build/esm/live-update/api.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/live-update/api.ts"],"names":[],"mappings":"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"}

package/build/esm/preload.js

@@ -1,72 +0,0 @@
-import VoltraModule from './VoltraModule.js';
-/**
- * Preload images to Android cache for use in Widgets.
- *
- * Downloaded images are stored in the app's cache directory and exposed via FileProvider.
- * Images can then be referenced using the `assetName` property in the Image component.
- *
- * @param images - Array of images to preload
- * @returns Result indicating which images succeeded or failed
- *
- * @example
- * ```typescript
- * const result = await preloadImages([
- *   {
- *     url: 'https://example.com/album-art.jpg',
- *     key: 'current-album',
- *     headers: { 'Authorization': 'Bearer token' }
- *   }
- * ])
- *
- * // Use in Android Widget
- * <VoltraAndroid.Image source={{ assetName: 'current-album' }} />
- * ```
- */
-export async function preloadImages(images) {
-    try {
-        return await VoltraModule.preloadImages(images);
-    }
-    catch (error) {
-        return {
-            succeeded: [],
-            failed: images.map((img) => ({
-                key: img.key,
-                error: error instanceof Error ? error.message : 'Unknown error',
-            })),
-        };
-    }
-}
-/**
- * Clear preloaded images from Android cache.
- *
- * @param keys - Optional array of image keys to clear. If omitted, clears all preloaded images.
- *
- * @example
- * ```typescript
- * // Clear specific images
- * await clearPreloadedImages(['album-art', 'profile-pic'])
- *
- * // Clear all preloaded images
- * await clearPreloadedImages()
- * ```
- */
-export async function clearPreloadedImages(keys) {
-    try {
-        await VoltraModule.clearPreloadedImages(keys ?? null);
-    }
-    catch (error) {
-        console.error('Failed to clear preloaded images:', error);
-    }
-}
-/**
- * Reload Android Widgets. (Alias for reloadAndroidWidgets)
- */
-export async function reloadWidgets(widgetIds) {
-    try {
-        await VoltraModule.reloadAndroidWidgets(widgetIds ?? null);
-    }
-    catch (error) {
-        console.error('Failed to reload Android widgets:', error);
-    }
-}
-//# sourceMappingURL=preload.js.map

package/build/esm/preload.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"preload.js","sourceRoot":"","sources":["../../src/preload.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,mBAAmB,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAA6B;IAC/D,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC3B,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,CAAC,CAAC;SACJ,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAe;IACxD,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,oBAAoB,CAAC,IAAI,IAAI,IAAI,CAAC,CAAA;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAoB;IACtD,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,oBAAoB,CAAC,SAAS,IAAI,IAAI,CAAC,CAAA;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC"}

package/build/esm/utils/useUpdateOnHMR.js

@@ -1,23 +0,0 @@
-import { useEffect, useState } from 'react';
-/**
- * Taps into the HMR accept function to forcefully re-render the component when any module is updated.
- * Is only available in development mode.
- */
-export const useUpdateOnHMR = () => {
-    const [, forceUpdate] = useState(0);
-    useEffect(() => {
-        if (!__DEV__) {
-            return;
-        }
-        // Override the accept function to forcefully re-render when any module is updated
-        const oldAccept = global['__accept'];
-        global['__accept'] = (...args) => {
-            forceUpdate((prev) => prev + 1);
-            oldAccept?.(...args);
-        };
-        return () => {
-            global['__accept'] = oldAccept;
-        };
-    }, []);
-};
-//# sourceMappingURL=useUpdateOnHMR.js.map

package/build/esm/utils/useUpdateOnHMR.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useUpdateOnHMR.js","sourceRoot":"","sources":["../../../src/utils/useUpdateOnHMR.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAO3C;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IAEnC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAM;QACR,CAAC;QAED,kFAAkF;QAClF,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;QACpC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE;YAC/B,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;YAC/B,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QACtB,CAAC,CAAA;QAED,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,UAAU,CAAC,GAAG,SAAS,CAAA;QAChC,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;AACR,CAAC,CAAA"}

package/build/esm/widgets/api.js

@@ -1,143 +0,0 @@
-import VoltraModule from '../VoltraModule.js';
-import { renderAndroidWidgetToString } from './renderer.js';
-/**
- * Update an Android home screen widget with new content.
- *
- * The content will be stored in SharedPreferences and the widget
- * will be updated to display the new content.
- *
- * @param widgetId - The widget identifier
- * @param variants - An array of size variants with their breakpoints and content.
- *   Android will automatically select the best matching variant based on the
- *   actual widget dimensions.
- * @param options - Optional settings like deep link URL
- *
- * @example Different content per size
- * ```tsx
- * import { VoltraAndroid, updateAndroidWidget } from 'voltra'
- *
- * await updateAndroidWidget('weather', [
- *   {
- *     size: { width: 150, height: 100 },
- *     content: <VoltraAndroid.Text fontSize={32}>72°F</VoltraAndroid.Text>
- *   },
- *   {
- *     size: { width: 250, height: 150 },
- *     content: (
- *       <VoltraAndroid.Row>
- *         <VoltraAndroid.Text fontSize={32}>72°F</VoltraAndroid.Text>
- *         <VoltraAndroid.Column>
- *           <VoltraAndroid.Text>Sunny</VoltraAndroid.Text>
- *           <VoltraAndroid.Text>High: 78° Low: 65°</VoltraAndroid.Text>
- *         </VoltraAndroid.Column>
- *       </VoltraAndroid.Row>
- *     )
- *   }
- * ], { deepLinkUrl: '/weather' })
- * ```
- */
-export const updateAndroidWidget = async (widgetId, variants, options) => {
-    const payload = renderAndroidWidgetToString(variants);
-    return VoltraModule.updateAndroidWidget(widgetId, payload, {
-        deepLinkUrl: options?.deepLinkUrl,
-    });
-};
-/**
- * Reload widget timelines to refresh their content.
- *
- * Use this after updating data that widgets depend on (e.g., after preloading
- * new images) to force them to re-render.
- *
- * @param widgetIds - Optional array of widget IDs to reload. If omitted, reloads all widgets.
- *
- * @example
- * ```typescript
- * // Reload specific widgets
- * await reloadAndroidWidgets(['weather', 'calendar'])
- *
- * // Reload all widgets
- * await reloadAndroidWidgets()
- * ```
- */
-export const reloadAndroidWidgets = async (widgetIds) => {
-    return VoltraModule.reloadAndroidWidgets(widgetIds ?? null);
-};
-/**
- * Clear a widget's stored data.
- *
- * This removes the JSON content and deep link URL for the specified widget,
- * causing it to show its placeholder state.
- *
- * @param widgetId - The widget identifier to clear
- *
- * @example
- * ```typescript
- * await clearAndroidWidget('weather')
- * ```
- */
-export const clearAndroidWidget = async (widgetId) => {
-    return VoltraModule.clearAndroidWidget(widgetId);
-};
-/**
- * Clear all widgets' stored data.
- *
- * This removes the JSON content and deep link URLs for all configured widgets,
- * causing them to show their placeholder states.
- *
- * @example
- * ```typescript
- * await clearAllAndroidWidgets()
- * ```
- */
-export const clearAllAndroidWidgets = async () => {
-    return VoltraModule.clearAllAndroidWidgets();
-};
-/**
- * Request to pin a widget to the home screen.
- *
- * This will show the Android system pin widget dialog, allowing the user
- * to add the widget to their home screen. Optionally, you can provide
- * preview dimensions to show a preview of the widget in the pin dialog.
- *
- * See: https://developer.android.com/develop/ui/compose/glance/pin-in-app
- *
- * @param widgetId - The widget identifier to pin
- * @param options - Optional settings for the pin request
- * @param options.previewWidth - Optional preview width in dp (default: 245)
- * @param options.previewHeight - Optional preview height in dp (default: 115)
- * @returns Promise that resolves to true if the pin request was successful
- *
- * @example Basic usage
- * ```typescript
- * const success = await requestPinAndroidWidget('weather')
- * if (success) {
- *   console.log('Widget pin request sent')
- * }
- * ```
- *
- * @example With preview dimensions
- * ```typescript
- * const success = await requestPinAndroidWidget('weather', {
- *   previewWidth: 245,
- *   previewHeight: 115
- * })
- * ```
- */
-export const requestPinAndroidWidget = async (widgetId, options) => {
-    return VoltraModule.requestPinGlanceAppWidget(widgetId, options);
-};
-/**
- * Fetches all active widget instances for the containing app on Android.
- *
- * @returns A promise that resolves to an array of active widget instances.
- *
- * @example
- * ```typescript
- * const widgets = await getActiveWidgets()
- * console.log('Active widgets:', widgets)
- * ```
- */
-export const getActiveWidgets = async () => {
-    return VoltraModule.getActiveWidgets();
-};
-//# sourceMappingURL=api.js.map

package/build/esm/widgets/api.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/widgets/api.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAY3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,QAAgB,EAChB,QAA+B,EAC/B,OAAoC,EACrB,EAAE;IACjB,MAAM,OAAO,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAA;IAErD,OAAO,YAAY,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE;QACzD,WAAW,EAAE,OAAO,EAAE,WAAW;KAClC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,SAAoB,EAAiB,EAAE;IAChF,OAAO,YAAY,CAAC,oBAAoB,CAAC,SAAS,IAAI,IAAI,CAAC,CAAA;AAC7D,CAAC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,QAAgB,EAAiB,EAAE;IAC1E,OAAO,YAAY,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAA;AAClD,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,IAAmB,EAAE;IAC9D,OAAO,YAAY,CAAC,sBAAsB,EAAE,CAAA;AAC9C,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC1C,QAAgB,EAChB,OAA2D,EACzC,EAAE;IACpB,OAAO,YAAY,CAAC,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AAClE,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,IAA2B,EAAE;IAChE,OAAO,YAAY,CAAC,gBAAgB,EAAE,CAAA;AACxC,CAAC,CAAA"}

package/build/esm/widgets/index.js

@@ -1,3 +0,0 @@
-// Android Widget API
-export { clearAllAndroidWidgets, clearAndroidWidget, getActiveWidgets, reloadAndroidWidgets, requestPinAndroidWidget, updateAndroidWidget, } from './api.js';
-//# sourceMappingURL=index.js.map

package/build/esm/widgets/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/widgets/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,UAAU,CAAA"}

package/build/esm/widgets/server-credentials.js

@@ -1,24 +0,0 @@
-import VoltraModule from '../VoltraModule.js';
-/**
- * Store server credentials for Android widget server-driven updates.
- *
- * Credentials are stored in DataStore, which is
- * automatically accessible by the widget's WorkManager background worker.
- *
- * @param credentials - The server credentials to store
- */
-export async function setWidgetServerCredentials(credentials) {
-    if (!credentials.token) {
-        throw new Error('[Voltra] [Android] setWidgetServerCredentials: token is required');
-    }
-    return VoltraModule.setWidgetServerCredentials(credentials);
-}
-/**
- * Clear stored server credentials for Android widget updates.
- * All widgets are automatically reloaded after clearing credentials so they
- * revert to their default/unauthenticated state.
- */
-export async function clearWidgetServerCredentials() {
-    return VoltraModule.clearWidgetServerCredentials();
-}
-//# sourceMappingURL=server-credentials.js.map

package/build/esm/widgets/server-credentials.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server-credentials.js","sourceRoot":"","sources":["../../../src/widgets/server-credentials.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAK7C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,WAAoC;IACnF,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;IACrF,CAAC;IACD,OAAO,YAAY,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAA;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAChD,OAAO,YAAY,CAAC,4BAA4B,EAAE,CAAA;AACpD,CAAC"}

package/build/types/VoltraModule.d.ts

@@ -1,30 +0,0 @@
-import type { EventSubscription, PreloadImageOptions, PreloadImagesResult, WidgetServerCredentials } from './types.js';
-export interface VoltraAndroidModuleSpec {
-    startAndroidLiveUpdate(payload: string, options: {
-        updateName?: string;
-        channelId?: string;
-    }): Promise<string>;
-    updateAndroidLiveUpdate(notificationId: string, payload: string): Promise<void>;
-    stopAndroidLiveUpdate(notificationId: string): Promise<void>;
-    isAndroidLiveUpdateActive(updateName: string): boolean;
-    endAllAndroidLiveUpdates(): Promise<void>;
-    updateAndroidWidget(widgetId: string, jsonString: string, options?: {
-        deepLinkUrl?: string;
-    }): Promise<void>;
-    reloadAndroidWidgets(widgetIds?: string[] | null): Promise<void>;
-    clearAndroidWidget(widgetId: string): Promise<void>;
-    clearAllAndroidWidgets(): Promise<void>;
-    requestPinGlanceAppWidget(widgetId: string, options?: {
-        previewWidth?: number;
-        previewHeight?: number;
-    }): Promise<boolean>;
-    preloadImages(images: PreloadImageOptions[]): Promise<PreloadImagesResult>;
-    clearPreloadedImages(keys?: string[] | null): Promise<void>;
-    setWidgetServerCredentials(credentials: WidgetServerCredentials): Promise<void>;
-    clearWidgetServerCredentials(): Promise<void>;
-    getActiveWidgets<T = any>(): Promise<T[]>;
-    addListener(event: string, listener: (event: any) => void): EventSubscription;
-}
-declare const VoltraModule: VoltraAndroidModuleSpec;
-export default VoltraModule;
-//# sourceMappingURL=VoltraModule.d.ts.map

package/build/types/VoltraModule.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VoltraModule.d.ts","sourceRoot":"","sources":["../../src/VoltraModule.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAEtH,MAAM,WAAW,uBAAuB;IACtC,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9G,uBAAuB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/E,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAA;IACtD,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5G,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,yBAAyB,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1D,OAAO,CAAC,OAAO,CAAC,CAAA;IACnB,aAAa,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC1E,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,0BAA0B,CAAC,WAAW,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/E,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,gBAAgB,CAAC,CAAC,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;IACzC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,iBAAiB,CAAA;CAC9E;AAED,QAAA,MAAM,YAAY,yBAA+D,CAAA;AAEjF,eAAe,YAAY,CAAA"}

package/build/types/client.d.ts

@@ -1,9 +0,0 @@
-export { endAllAndroidLiveUpdates, isAndroidLiveUpdateActive, startAndroidLiveUpdate, stopAndroidLiveUpdate, updateAndroidLiveUpdate, useAndroidLiveUpdate, } from './live-update/api.js';
-export type { AndroidLiveUpdateJson, AndroidLiveUpdateVariants, AndroidLiveUpdateVariantsJson, StartAndroidLiveUpdateOptions, UpdateAndroidLiveUpdateOptions, UseAndroidLiveUpdateOptions, UseAndroidLiveUpdateResult, } from './live-update/types.js';
-export { clearAllAndroidWidgets, clearAndroidWidget, getActiveWidgets, reloadAndroidWidgets, requestPinAndroidWidget, updateAndroidWidget, } from './widgets/api.js';
-export type { AndroidWidgetSize, AndroidWidgetSizeVariant, AndroidWidgetVariants, UpdateAndroidWidgetOptions, WidgetInfo, } from './widgets/types.js';
-export { clearWidgetServerCredentials, setWidgetServerCredentials, type WidgetServerCredentials, } from './widgets/server-credentials.js';
-export { clearPreloadedImages, preloadImages, reloadWidgets } from './preload.js';
-export { VoltraView, type VoltraViewProps } from './components/VoltraView.js';
-export { type AndroidWidgetFamily, VoltraWidgetPreview, type VoltraWidgetPreviewProps, } from './components/VoltraWidgetPreview.js';
-//# sourceMappingURL=client.d.ts.map

package/build/types/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,6BAA6B,EAC7B,8BAA8B,EAC9B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,UAAU,GACX,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,uBAAuB,GAC7B,MAAM,iCAAiC,CAAA;AAGxC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjF,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC7E,OAAO,EACL,KAAK,mBAAmB,EACxB,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,qCAAqC,CAAA"}

package/build/types/components/VoltraView.d.ts

@@ -1,29 +0,0 @@
-import { ReactNode } from 'react';
-import { StyleProp, ViewStyle } from 'react-native';
-import { VoltraInteractionEvent } from '../events.js';
-export type VoltraViewProps = {
-    /**
-     * Unique identifier for this view instance.
-     * Used as 'source' in interaction events to identify which view triggered the event.
-     * If not provided, a unique ID will be generated automatically.
-     */
-    id?: string;
-    /**
-     * Voltra JSX components to render
-     */
-    children: ReactNode;
-    /**
-     * Style for the view container
-     */
-    style?: StyleProp<ViewStyle>;
-    /**
-     * Callback when user interacts with components in the view.
-     * Events are filtered by this view's id (source).
-     */
-    onInteraction?: (event: VoltraInteractionEvent) => void;
-};
-/**
- * A React Native component that renders Voltra UI for Android using Jetpack Compose.
- */
-export declare function VoltraView({ id, children, style, onInteraction }: VoltraViewProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=VoltraView.d.ts.map

package/build/types/components/VoltraView.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VoltraView.d.ts","sourceRoot":"","sources":["../../../src/components/VoltraView.tsx"],"names":[],"mappings":"AACA,OAAc,EAAE,SAAS,EAAsB,MAAM,OAAO,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAEnD,OAAO,EAAqB,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAQxE,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAA;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAA;CACxD,CAAA;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,eAAe,2CAsCjF"}

package/build/types/components/VoltraWidgetPreview.d.ts

@@ -1,21 +0,0 @@
-import { StyleProp, ViewStyle } from 'react-native';
-import { VoltraViewProps } from './VoltraView.js';
-/**
- * Android-specific widget sizes in dp.
- */
-export type AndroidWidgetFamily = 'small' | 'mediumSquare' | 'mediumWide' | 'mediumTall' | 'large' | 'extraLarge';
-export type VoltraWidgetPreviewProps = Omit<VoltraViewProps, 'style'> & {
-    /**
-     * Android widget size to preview
-     */
-    family: AndroidWidgetFamily;
-    /**
-     * Additional styles to apply on top of the widget dimensions
-     */
-    style?: StyleProp<ViewStyle>;
-};
-/**
- * A preview component that renders Voltra Android JSX content at specific dimensions.
- */
-export declare function VoltraWidgetPreview({ family, style, children, ...voltraViewProps }: VoltraWidgetPreviewProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=VoltraWidgetPreview.d.ts.map

package/build/types/components/VoltraWidgetPreview.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VoltraWidgetPreview.d.ts","sourceRoot":"","sources":["../../../src/components/VoltraWidgetPreview.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAEnD,OAAO,EAAc,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAE7D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,cAAc,GAAG,YAAY,GAAG,YAAY,GAAG,OAAO,GAAG,YAAY,CAAA;AAWjH,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,GAAG;IACtE;;OAEG;IACH,MAAM,EAAE,mBAAmB,CAAA;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAC7B,CAAA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,eAAe,EAAE,EAAE,wBAAwB,2CAe5G"}