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

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

@@ -1,215 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isAndroidLiveUpdateActive = exports.stopAndroidLiveUpdate = exports.updateAndroidLiveUpdate = exports.startAndroidLiveUpdate = exports.useAndroidLiveUpdate = void 0;
-exports.endAllAndroidLiveUpdates = endAllAndroidLiveUpdates;
-const react_1 = require("react");
-const index_js_1 = require("../utils/index.js");
-const VoltraModule_js_1 = __importDefault(require("../VoltraModule.js"));
-const renderer_js_1 = require("./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>
- *   )
- * }
- * ```
- */
-const useAndroidLiveUpdate = (variants, options) => {
-    const [targetId, setTargetId] = (0, react_1.useState)(() => {
-        if (options?.updateName) {
-            return (0, exports.isAndroidLiveUpdateActive)(options.updateName) ? options.updateName : null;
-        }
-        return null;
-    });
-    const isActive = targetId !== null;
-    const optionsRef = (0, react_1.useRef)(options);
-    const variantsRef = (0, react_1.useRef)(variants);
-    const lastUpdateOptionsRef = (0, react_1.useRef)(undefined);
-    // Update refs when values change
-    (0, react_1.useEffect)(() => {
-        optionsRef.current = options;
-    }, [options]);
-    (0, react_1.useEffect)(() => {
-        variantsRef.current = variants;
-    }, [variants]);
-    (0, index_js_1.useUpdateOnHMR)();
-    const start = (0, react_1.useCallback)(async (options) => {
-        const id = await (0, exports.startAndroidLiveUpdate)(variantsRef.current, {
-            ...optionsRef.current,
-            ...options,
-        });
-        setTargetId(id);
-    }, []);
-    const update = (0, react_1.useCallback)(async (options) => {
-        if (!targetId) {
-            return;
-        }
-        const updateOptions = { ...optionsRef.current, ...options };
-        lastUpdateOptionsRef.current = updateOptions;
-        await (0, exports.updateAndroidLiveUpdate)(targetId, variantsRef.current, updateOptions);
-    }, [targetId]);
-    const end = (0, react_1.useCallback)(async () => {
-        if (!targetId) {
-            return;
-        }
-        await (0, exports.stopAndroidLiveUpdate)(targetId);
-        setTargetId(null);
-    }, [targetId]);
-    (0, react_1.useEffect)(() => {
-        if (!options?.autoStart) {
-            return;
-        }
-        start();
-    }, [options?.autoStart, start]);
-    (0, react_1.useEffect)(() => {
-        if (!options?.autoUpdate)
-            return;
-        update(lastUpdateOptionsRef.current);
-    }, [options?.autoUpdate, update, variants]);
-    return {
-        start,
-        update,
-        end,
-        isActive,
-    };
-};
-exports.useAndroidLiveUpdate = useAndroidLiveUpdate;
-/**
- * @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',
- * })
- * ```
- */
-const startAndroidLiveUpdate = async (variants, options) => {
-    const payload = (0, renderer_js_1.renderAndroidLiveUpdateToString)(variants);
-    const notificationId = await VoltraModule_js_1.default.startAndroidLiveUpdate(payload, {
-        updateName: options?.updateName,
-        channelId: options?.channelId || variants.channelId || 'voltra_live_updates',
-    });
-    return notificationId;
-};
-exports.startAndroidLiveUpdate = startAndroidLiveUpdate;
-/**
- * @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>,
- * })
- * ```
- */
-const updateAndroidLiveUpdate = async (notificationId, variants, options) => {
-    const payload = (0, renderer_js_1.renderAndroidLiveUpdateToString)(variants);
-    return VoltraModule_js_1.default.updateAndroidLiveUpdate(notificationId, payload);
-};
-exports.updateAndroidLiveUpdate = updateAndroidLiveUpdate;
-/**
- * @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')
- * ```
- */
-const stopAndroidLiveUpdate = async (notificationId) => {
-    return VoltraModule_js_1.default.stopAndroidLiveUpdate(notificationId);
-};
-exports.stopAndroidLiveUpdate = stopAndroidLiveUpdate;
-/**
- * @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')
- * }
- * ```
- */
-const isAndroidLiveUpdateActive = (updateName) => {
-    return VoltraModule_js_1.default.isAndroidLiveUpdateActive(updateName);
-};
-exports.isAndroidLiveUpdateActive = isAndroidLiveUpdateActive;
-/**
- * @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()
- * ```
- */
-async function endAllAndroidLiveUpdates() {
-    return VoltraModule_js_1.default.endAllAndroidLiveUpdates();
-}
-//# sourceMappingURL=api.js.map

package/build/cjs/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/cjs/preload.js

@@ -1,80 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.preloadImages = preloadImages;
-exports.clearPreloadedImages = clearPreloadedImages;
-exports.reloadWidgets = reloadWidgets;
-const VoltraModule_js_1 = __importDefault(require("./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' }} />
- * ```
- */
-async function preloadImages(images) {
-    try {
-        return await VoltraModule_js_1.default.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()
- * ```
- */
-async function clearPreloadedImages(keys) {
-    try {
-        await VoltraModule_js_1.default.clearPreloadedImages(keys ?? null);
-    }
-    catch (error) {
-        console.error('Failed to clear preloaded images:', error);
-    }
-}
-/**
- * Reload Android Widgets. (Alias for reloadAndroidWidgets)
- */
-async function reloadWidgets(widgetIds) {
-    try {
-        await VoltraModule_js_1.default.reloadAndroidWidgets(widgetIds ?? null);
-    }
-    catch (error) {
-        console.error('Failed to reload Android widgets:', error);
-    }
-}
-//# sourceMappingURL=preload.js.map

package/build/cjs/preload.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"preload.js","sourceRoot":"","sources":["../../src/preload.ts"],"names":[],"mappings":";;;;;AA0BA,sCAYC;AAgBD,oDAMC;AAKD,sCAMC;AAtED,wEAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,KAAK,UAAU,aAAa,CAAC,MAA6B;IAC/D,IAAI,CAAC;QACH,OAAO,MAAM,yBAAY,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;AACI,KAAK,UAAU,oBAAoB,CAAC,IAAe;IACxD,IAAI,CAAC;QACH,MAAM,yBAAY,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;AACI,KAAK,UAAU,aAAa,CAAC,SAAoB;IACtD,IAAI,CAAC;QACH,MAAM,yBAAY,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/cjs/utils/useUpdateOnHMR.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useUpdateOnHMR = void 0;
-const react_1 = require("react");
-/**
- * Taps into the HMR accept function to forcefully re-render the component when any module is updated.
- * Is only available in development mode.
- */
-const useUpdateOnHMR = () => {
-    const [, forceUpdate] = (0, react_1.useState)(0);
-    (0, react_1.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;
-        };
-    }, []);
-};
-exports.useUpdateOnHMR = useUpdateOnHMR;
-//# sourceMappingURL=useUpdateOnHMR.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useUpdateOnHMR.js","sourceRoot":"","sources":["../../../src/utils/useUpdateOnHMR.ts"],"names":[],"mappings":";;;AAAA,iCAA2C;AAO3C;;;GAGG;AACI,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC,GAAG,IAAA,gBAAQ,EAAC,CAAC,CAAC,CAAA;IAEnC,IAAA,iBAAS,EAAC,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;AAnBY,QAAA,cAAc,kBAmB1B"}

package/build/cjs/widgets/api.js

@@ -1,155 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getActiveWidgets = exports.requestPinAndroidWidget = exports.clearAllAndroidWidgets = exports.clearAndroidWidget = exports.reloadAndroidWidgets = exports.updateAndroidWidget = void 0;
-const VoltraModule_js_1 = __importDefault(require("../VoltraModule.js"));
-const renderer_js_1 = require("./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' })
- * ```
- */
-const updateAndroidWidget = async (widgetId, variants, options) => {
-    const payload = (0, renderer_js_1.renderAndroidWidgetToString)(variants);
-    return VoltraModule_js_1.default.updateAndroidWidget(widgetId, payload, {
-        deepLinkUrl: options?.deepLinkUrl,
-    });
-};
-exports.updateAndroidWidget = updateAndroidWidget;
-/**
- * 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()
- * ```
- */
-const reloadAndroidWidgets = async (widgetIds) => {
-    return VoltraModule_js_1.default.reloadAndroidWidgets(widgetIds ?? null);
-};
-exports.reloadAndroidWidgets = reloadAndroidWidgets;
-/**
- * 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')
- * ```
- */
-const clearAndroidWidget = async (widgetId) => {
-    return VoltraModule_js_1.default.clearAndroidWidget(widgetId);
-};
-exports.clearAndroidWidget = clearAndroidWidget;
-/**
- * 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()
- * ```
- */
-const clearAllAndroidWidgets = async () => {
-    return VoltraModule_js_1.default.clearAllAndroidWidgets();
-};
-exports.clearAllAndroidWidgets = 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
- * })
- * ```
- */
-const requestPinAndroidWidget = async (widgetId, options) => {
-    return VoltraModule_js_1.default.requestPinGlanceAppWidget(widgetId, options);
-};
-exports.requestPinAndroidWidget = requestPinAndroidWidget;
-/**
- * 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)
- * ```
- */
-const getActiveWidgets = async () => {
-    return VoltraModule_js_1.default.getActiveWidgets();
-};
-exports.getActiveWidgets = getActiveWidgets;
-//# sourceMappingURL=api.js.map

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

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

package/build/cjs/widgets/index.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateAndroidWidget = exports.requestPinAndroidWidget = exports.reloadAndroidWidgets = exports.getActiveWidgets = exports.clearAndroidWidget = exports.clearAllAndroidWidgets = void 0;
-// Android Widget API
-var api_js_1 = require("./api.js");
-Object.defineProperty(exports, "clearAllAndroidWidgets", { enumerable: true, get: function () { return api_js_1.clearAllAndroidWidgets; } });
-Object.defineProperty(exports, "clearAndroidWidget", { enumerable: true, get: function () { return api_js_1.clearAndroidWidget; } });
-Object.defineProperty(exports, "getActiveWidgets", { enumerable: true, get: function () { return api_js_1.getActiveWidgets; } });
-Object.defineProperty(exports, "reloadAndroidWidgets", { enumerable: true, get: function () { return api_js_1.reloadAndroidWidgets; } });
-Object.defineProperty(exports, "requestPinAndroidWidget", { enumerable: true, get: function () { return api_js_1.requestPinAndroidWidget; } });
-Object.defineProperty(exports, "updateAndroidWidget", { enumerable: true, get: function () { return api_js_1.updateAndroidWidget; } });
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/widgets/index.ts"],"names":[],"mappings":";;;AAAA,qBAAqB;AACrB,mCAOiB;AANf,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAChB,8GAAA,oBAAoB,OAAA;AACpB,iHAAA,uBAAuB,OAAA;AACvB,6GAAA,mBAAmB,OAAA"}

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

@@ -1,31 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setWidgetServerCredentials = setWidgetServerCredentials;
-exports.clearWidgetServerCredentials = clearWidgetServerCredentials;
-const VoltraModule_js_1 = __importDefault(require("../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
- */
-async function setWidgetServerCredentials(credentials) {
-    if (!credentials.token) {
-        throw new Error('[Voltra] [Android] setWidgetServerCredentials: token is required');
-    }
-    return VoltraModule_js_1.default.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.
- */
-async function clearWidgetServerCredentials() {
-    return VoltraModule_js_1.default.clearWidgetServerCredentials();
-}
-//# sourceMappingURL=server-credentials.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"server-credentials.js","sourceRoot":"","sources":["../../../src/widgets/server-credentials.ts"],"names":[],"mappings":";;;;;AAcA,gEAKC;AAOD,oEAEC;AA3BD,yEAA6C;AAK7C;;;;;;;GAOG;AACI,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,yBAAY,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAA;AAC7D,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,4BAA4B;IAChD,OAAO,yBAAY,CAAC,4BAA4B,EAAE,CAAA;AACpD,CAAC"}

package/build/esm/VoltraModule.js

@@ -1,4 +0,0 @@
-import { requireNativeModule } from 'expo';
-const VoltraModule = requireNativeModule('VoltraModule');
-export default VoltraModule;
-//# sourceMappingURL=VoltraModule.js.map

package/build/esm/VoltraModule.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"VoltraModule.js","sourceRoot":"","sources":["../../src/VoltraModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAA;AA0B1C,MAAM,YAAY,GAAG,mBAAmB,CAA0B,cAAc,CAAC,CAAA;AAEjF,eAAe,YAAY,CAAA"}

package/build/esm/client.js

@@ -1,12 +0,0 @@
-// Android Live Update API and types
-export { endAllAndroidLiveUpdates, isAndroidLiveUpdateActive, startAndroidLiveUpdate, stopAndroidLiveUpdate, updateAndroidLiveUpdate, useAndroidLiveUpdate, } from './live-update/api.js';
-// Android Widget API and types
-export { clearAllAndroidWidgets, clearAndroidWidget, getActiveWidgets, reloadAndroidWidgets, requestPinAndroidWidget, updateAndroidWidget, } from './widgets/api.js';
-// Android Widget Server Credentials API
-export { clearWidgetServerCredentials, setWidgetServerCredentials, } from './widgets/server-credentials.js';
-// Preload API
-export { clearPreloadedImages, preloadImages, reloadWidgets } from './preload.js';
-// Android Preview Components
-export { VoltraView } from './components/VoltraView.js';
-export { VoltraWidgetPreview, } from './components/VoltraWidgetPreview.js';
-//# sourceMappingURL=client.js.map

package/build/esm/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA;AAW7B,+BAA+B;AAC/B,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AASzB,wCAAwC;AACxC,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAE3B,MAAM,iCAAiC,CAAA;AAExC,cAAc;AACd,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjF,6BAA6B;AAC7B,OAAO,EAAE,UAAU,EAAwB,MAAM,4BAA4B,CAAA;AAC7E,OAAO,EAEL,mBAAmB,GAEpB,MAAM,qCAAqC,CAAA"}

package/build/esm/components/VoltraView.js

@@ -1,45 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { requireNativeView } from 'expo';
-import { useEffect, useMemo } from 'react';
-import { addVoltraListener } from '../events.js';
-import { androidComponentRegistry, createVoltraRenderer } from '../renderer/renderer.js';
-const NativeVoltraView = requireNativeView('VoltraModule');
-// Generate a unique ID for views that don't have one
-const generateViewId = () => `voltra-view-android-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-/**
- * A React Native component that renders Voltra UI for Android using Jetpack Compose.
- */
-export function VoltraView({ id, children, style, onInteraction }) {
-    // Generate a stable ID if not provided
-    const viewId = useMemo(() => id || generateViewId(), [id]);
-    const payload = useMemo(() => {
-        const renderer = createVoltraRenderer(androidComponentRegistry);
-        renderer.addRootNode('content', children);
-        const rendered = renderer.render();
-        // Move 'content' into 'variants' to match VoltraPayload structure
-        const node = rendered.content;
-        delete rendered.content;
-        rendered.variants = { content: node };
-        return JSON.stringify(rendered);
-    }, [children]);
-    // Subscribe to interaction events and filter by this view's ID
-    useEffect(() => {
-        if (!onInteraction)
-            return;
-        const subscription = addVoltraListener('interaction', (event) => {
-            // Only forward events from this view
-            if (event.source === viewId) {
-                onInteraction({
-                    type: 'interaction',
-                    source: event.source,
-                    timestamp: event.timestamp,
-                    identifier: event.identifier,
-                    payload: event.payload,
-                });
-            }
-        });
-        return () => subscription.remove();
-    }, [viewId, onInteraction]);
-    return _jsx(NativeVoltraView, { payload: payload, viewId: viewId, style: style });
-}
-//# sourceMappingURL=VoltraView.js.map

package/build/esm/components/VoltraView.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"VoltraView.js","sourceRoot":"","sources":["../../../src/components/VoltraView.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AACxC,OAAc,EAAa,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAG5D,OAAO,EAAE,iBAAiB,EAA0B,MAAM,cAAc,CAAA;AACxE,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAExF,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAA;AAE1D,qDAAqD;AACrD,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,uBAAuB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;AAwB9G;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAmB;IAChF,uCAAuC;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,cAAc,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAE1D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,wBAAwB,CAAC,CAAA;QAC/D,QAAQ,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAA;QAElC,kEAAkE;QAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAA;QAC7B,OAAO,QAAQ,CAAC,OAAO,CAAA;QACvB,QAAQ,CAAC,QAAQ,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAErC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;IACjC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEd,+DAA+D;IAC/D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,aAAa;YAAE,OAAM;QAE1B,MAAM,YAAY,GAAG,iBAAiB,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE;YAC9D,qCAAqC;YACrC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC5B,aAAa,CAAC;oBACZ,IAAI,EAAE,aAAa;oBACnB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;iBACvB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAA;IACpC,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;IAE3B,OAAO,KAAC,gBAAgB,IAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAI,CAAA;AAC7E,CAAC"}

package/build/esm/components/VoltraWidgetPreview.js

@@ -1,25 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { VoltraView } from './VoltraView.js';
-const WIDGET_DIMENSIONS = {
-    small: { width: 150, height: 100 },
-    mediumSquare: { width: 200, height: 200 },
-    mediumWide: { width: 250, height: 150 },
-    mediumTall: { width: 150, height: 250 },
-    large: { width: 300, height: 200 },
-    extraLarge: { width: 350, height: 300 },
-};
-/**
- * A preview component that renders Voltra Android JSX content at specific dimensions.
- */
-export function VoltraWidgetPreview({ family, style, children, ...voltraViewProps }) {
-    const dimensions = WIDGET_DIMENSIONS[family];
-    const previewStyle = [
-        {
-            width: dimensions.width,
-            height: dimensions.height,
-        },
-        style,
-    ];
-    return (_jsx(VoltraView, { ...voltraViewProps, style: previewStyle, children: children }));
-}
-//# sourceMappingURL=VoltraWidgetPreview.js.map

package/build/esm/components/VoltraWidgetPreview.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"VoltraWidgetPreview.js","sourceRoot":"","sources":["../../../src/components/VoltraWidgetPreview.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,UAAU,EAAmB,MAAM,iBAAiB,CAAA;AAO7D,MAAM,iBAAiB,GAAmE;IACxF,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IAClC,YAAY,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IACzC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IACvC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IACvC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IAClC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;CACxC,CAAA;AAaD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,eAAe,EAA4B;IAC3G,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC5C,MAAM,YAAY,GAAyB;QACzC;YACE,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B;QACD,KAAK;KACN,CAAA;IAED,OAAO,CACL,KAAC,UAAU,OAAK,eAAe,EAAE,KAAK,EAAE,YAAY,YACjD,QAAQ,GACE,CACd,CAAA;AACH,CAAC"}