@use-voltra/ios 1.3.0

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

@@ -0,0 +1,277 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLiveActivityActive = exports.stopLiveActivity = exports.updateLiveActivity = exports.startLiveActivity = exports.useLiveActivity = void 0;
+exports.endAllLiveActivities = endAllLiveActivities;
+const react_1 = require("react");
+const events_js_1 = require("../events.js");
+const logger_js_1 = require("../logger.js");
+const index_js_1 = require("../utils/index.js");
+const VoltraModule_js_1 = __importDefault(require("../VoltraModule.js"));
+const renderer_js_1 = require("./renderer.js");
+const normalizeSharedLiveActivityOptions = (options) => {
+    if (!options)
+        return undefined;
+    const normalizedOptions = {};
+    if (options.staleDate !== undefined) {
+        if (options.staleDate < Date.now()) {
+            logger_js_1.logger.warn('Ignoring staleDate because it is in the past, the Live Activity would be dismissed immediately.');
+        }
+        else {
+            normalizedOptions.staleDate = options.staleDate;
+        }
+    }
+    // Always include relevanceScore, defaulting to 0.0 if not provided
+    const relevanceScore = options.relevanceScore ?? 0.0;
+    if (relevanceScore < 0 || relevanceScore > 1) {
+        logger_js_1.logger.warn('Ignoring relevanceScore because it is out of range [0.0, 1.0], using default 0.0');
+        normalizedOptions.relevanceScore = 0.0;
+    }
+    else {
+        normalizedOptions.relevanceScore = relevanceScore;
+    }
+    return Object.keys(normalizedOptions).length > 0 ? normalizedOptions : undefined;
+};
+const normalizeEndLiveActivityOptions = (options) => {
+    if (!options?.dismissalPolicy)
+        return undefined;
+    if (typeof options.dismissalPolicy === 'string') {
+        if (options.dismissalPolicy === 'immediate') {
+            return { dismissalPolicy: { type: 'immediate' } };
+        }
+    }
+    else if (typeof options.dismissalPolicy === 'object' && 'after' in options.dismissalPolicy) {
+        return { dismissalPolicy: { type: 'after', date: options.dismissalPolicy.after } };
+    }
+    // Default to immediate if unrecognized
+    return { dismissalPolicy: { type: 'immediate' } };
+};
+/**
+ * React hook for managing Live Activities with automatic lifecycle handling.
+ *
+ * @param variants - The Live Activity content variants to display
+ * @param options - Configuration options for the hook
+ * @returns Object with start, update, end methods and isActive state
+ *
+ * @example
+ * ```tsx
+ * import { useLiveActivity, Voltra } from 'voltra'
+ *
+ * const MyLiveActivity = () => {
+ *   const { start, update, end, isActive } = useLiveActivity({
+ *     minimal: <Voltra.Text>Live Activity</Voltra.Text>,
+ *     compact: <Voltra.HStack>...</Voltra.HStack>,
+ *     expanded: <Voltra.VStack>...</Voltra.VStack>
+ *   }, {
+ *     activityName: 'my-activity',
+ *     autoStart: true,
+ *     autoUpdate: true
+ *   })
+ *
+ *   return (
+ *     <View>
+ *       <Button title={isActive ? "Stop" : "Start"} onPress={isActive ? end : start} />
+ *     </View>
+ *   )
+ * }
+ * ```
+ */
+const useLiveActivity = (variants, options) => {
+    const [targetId, setTargetId] = (0, react_1.useState)(() => {
+        if (options?.activityName) {
+            return (0, exports.isLiveActivityActive)(options.activityName) ? options.activityName : 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.startLiveActivity)(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.updateLiveActivity)(targetId, variantsRef.current, updateOptions);
+    }, [targetId]);
+    const end = (0, react_1.useCallback)(async (options) => {
+        if (!targetId) {
+            return;
+        }
+        await (0, exports.stopLiveActivity)(targetId, options);
+        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]);
+    (0, react_1.useEffect)(() => {
+        if (!targetId)
+            return;
+        const subscription = (0, events_js_1.addVoltraListener)('stateChange', (event) => {
+            if (event.activityName !== targetId)
+                return;
+            if (event.activityState === 'dismissed' || event.activityState === 'ended') {
+                // Live Activity is no longer active.
+                setTargetId(null);
+            }
+        });
+        return () => subscription.remove();
+    }, [targetId]);
+    return {
+        start,
+        update,
+        end,
+        isActive,
+    };
+};
+exports.useLiveActivity = useLiveActivity;
+/**
+ * Start a new Live Activity with the provided content variants.
+ *
+ * @param variants - The Live Activity content variants to display
+ * @param options - Configuration options for the Live Activity
+ * @returns Promise resolving to the activity ID
+ *
+ * @example
+ * ```tsx
+ * import { startLiveActivity, Voltra } from 'voltra'
+ *
+ * const activityId = await startLiveActivity({
+ *   minimal: <Voltra.Text>Live Activity</Voltra.Text>,
+ *   compact: <Voltra.HStack>...</Voltra.HStack>,
+ *   expanded: <Voltra.VStack>...</Voltra.VStack>
+ * }, {
+ *   activityName: 'my-activity',
+ *   deepLinkUrl: '/details',
+ *   relevanceScore: 0.8
+ * })
+ * ```
+ */
+const startLiveActivity = async (variants, options) => {
+    if (!(0, index_js_1.assertRunningOnApple)())
+        return Promise.resolve('');
+    const payload = (0, renderer_js_1.renderLiveActivityToString)(variants);
+    const normalizedSharedOptions = normalizeSharedLiveActivityOptions(options);
+    const targetId = await VoltraModule_js_1.default.startLiveActivity(payload, {
+        target: 'liveActivity',
+        deepLinkUrl: options?.deepLinkUrl,
+        activityId: options?.activityName,
+        channelId: options?.channelId,
+        ...normalizedSharedOptions,
+    });
+    return targetId;
+};
+exports.startLiveActivity = startLiveActivity;
+/**
+ * Update an existing Live Activity with new content.
+ *
+ * @param targetId - The ID of the Live Activity to update
+ * @param variants - The new Live Activity content variants
+ * @param options - Update options like relevance score
+ *
+ * @example
+ * ```tsx
+ * import { updateLiveActivity, Voltra } from 'voltra'
+ *
+ * await updateLiveActivity('activity-123', {
+ *   minimal: <Voltra.Text>Updated: Live Activity</Voltra.Text>,
+ *   compact: <Voltra.HStack>...</Voltra.HStack>,
+ *   expanded: <Voltra.VStack>...</Voltra.VStack>
+ * }, {
+ *   relevanceScore: 0.9
+ * })
+ * ```
+ */
+const updateLiveActivity = async (targetId, variants, options) => {
+    if (!(0, index_js_1.assertRunningOnApple)())
+        return Promise.resolve();
+    const payload = (0, renderer_js_1.renderLiveActivityToString)(variants);
+    const normalizedSharedOptions = normalizeSharedLiveActivityOptions(options);
+    return VoltraModule_js_1.default.updateLiveActivity(targetId, payload, normalizedSharedOptions);
+};
+exports.updateLiveActivity = updateLiveActivity;
+/**
+ * Stop a Live Activity.
+ *
+ * @param targetId - The ID of the Live Activity to stop
+ * @param options - Options for how to end the activity
+ *
+ * @example
+ * ```tsx
+ * import { stopLiveActivity } from 'voltra'
+ *
+ * await stopLiveActivity('activity-123', { dismissalPolicy: 'immediate' })
+ * ```
+ */
+const stopLiveActivity = async (targetId, options) => {
+    if (!(0, index_js_1.assertRunningOnApple)())
+        return Promise.resolve();
+    const normalizedOptions = normalizeEndLiveActivityOptions(options);
+    return VoltraModule_js_1.default.endLiveActivity(targetId, normalizedOptions);
+};
+exports.stopLiveActivity = stopLiveActivity;
+/**
+ * Check if a Live Activity with the given name is currently active.
+ *
+ * @param activityName - The name of the Live Activity to check
+ * @returns true if the activity is active, false otherwise
+ *
+ * @example
+ * ```tsx
+ * import { isLiveActivityActive } from 'voltra'
+ *
+ * if (isLiveActivityActive('my-activity')) {
+ *   console.log('Activity is running')
+ * }
+ * ```
+ */
+const isLiveActivityActive = (activityName) => {
+    if (!(0, index_js_1.assertRunningOnApple)())
+        return false;
+    return VoltraModule_js_1.default.isLiveActivityActive(activityName);
+};
+exports.isLiveActivityActive = isLiveActivityActive;
+/**
+ * End all active Live Activities.
+ *
+ * This function stops and dismisses all currently running Live Activities in the app.
+ * It's useful for cleanup operations, such as when the app is being closed or
+ * when you want to reset all Live Activity states.
+ *
+ * @example
+ * ```typescript
+ * import { endAllLiveActivities } from 'voltra'
+ *
+ * // End all active Live Activities
+ * await endAllLiveActivities()
+ * ```
+ */
+async function endAllLiveActivities() {
+    if (!(0, index_js_1.assertRunningOnApple)())
+        return Promise.resolve();
+    return VoltraModule_js_1.default.endAllLiveActivities();
+}
+//# sourceMappingURL=api.js.map

package/build/cjs/live-activity/api.js.map

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

package/build/cjs/live-activity/renderer.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderLiveActivityToString = exports.renderLiveActivityToJson = void 0;
+const index_js_1 = require("../renderer/index.js");
+/**
+ * Renders Live Activity variants to JSON.
+ * Handles non-JSX properties like keylineTint and activityBackgroundTint separately.
+ */
+const renderLiveActivityToJson = (variants) => {
+    const renderer = (0, index_js_1.createVoltraRenderer)();
+    // Add lock screen variant
+    if (variants.lockScreen) {
+        const lockScreenVariant = variants.lockScreen;
+        if (typeof lockScreenVariant === 'object' && lockScreenVariant !== null && 'content' in lockScreenVariant) {
+            if (lockScreenVariant.content) {
+                renderer.addRootNode('ls', lockScreenVariant.content);
+            }
+        }
+        else {
+            renderer.addRootNode('ls', lockScreenVariant);
+        }
+    }
+    // Add island variants
+    if (variants.island) {
+        if (variants.island.expanded) {
+            if (variants.island.expanded.center) {
+                renderer.addRootNode('isl_exp_c', variants.island.expanded.center);
+            }
+            if (variants.island.expanded.leading) {
+                renderer.addRootNode('isl_exp_l', variants.island.expanded.leading);
+            }
+            if (variants.island.expanded.trailing) {
+                renderer.addRootNode('isl_exp_t', variants.island.expanded.trailing);
+            }
+            if (variants.island.expanded.bottom) {
+                renderer.addRootNode('isl_exp_b', variants.island.expanded.bottom);
+            }
+        }
+        if (variants.island.compact) {
+            if (variants.island.compact.leading) {
+                renderer.addRootNode('isl_cmp_l', variants.island.compact.leading);
+            }
+            if (variants.island.compact.trailing) {
+                renderer.addRootNode('isl_cmp_t', variants.island.compact.trailing);
+            }
+        }
+        if (variants.island.minimal) {
+            renderer.addRootNode('isl_min', variants.island.minimal);
+        }
+    }
+    // Add supplemental activity family variants (iOS 18+)
+    if (variants.supplementalActivityFamilies?.small) {
+        renderer.addRootNode('saf_sm', variants.supplementalActivityFamilies.small);
+    }
+    // Render all variants
+    const result = renderer.render();
+    // Add non-JSX properties after rendering
+    if (variants.lockScreen &&
+        typeof variants.lockScreen === 'object' &&
+        'activityBackgroundTint' in variants.lockScreen) {
+        if (variants.lockScreen.activityBackgroundTint) {
+            result.ls_background_tint = variants.lockScreen.activityBackgroundTint;
+        }
+    }
+    if (variants.island?.keylineTint) {
+        result.isl_keyline_tint = variants.island.keylineTint;
+    }
+    return result;
+};
+exports.renderLiveActivityToJson = renderLiveActivityToJson;
+/**
+ * Renders Live Activity variants to a JSON string.
+ */
+const renderLiveActivityToString = (variants) => {
+    return JSON.stringify((0, exports.renderLiveActivityToJson)(variants));
+};
+exports.renderLiveActivityToString = renderLiveActivityToString;
+//# sourceMappingURL=renderer.js.map

package/build/cjs/live-activity/renderer.js.map

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

package/build/cjs/live-activity/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/cjs/live-activity/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/live-activity/types.ts"],"names":[],"mappings":""}

package/build/cjs/logger.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+let currentLevel = __DEV__ ? 'debug' : 'info';
+exports.logger = {
+    debug: (message) => {
+        if (LEVELS.debug >= LEVELS[currentLevel]) {
+            console.log(`[Voltra] ${message}`);
+        }
+    },
+    info: (message) => {
+        if (LEVELS.info >= LEVELS[currentLevel]) {
+            console.info(`[Voltra] ${message}`);
+        }
+    },
+    warn: (message) => {
+        if (LEVELS.warn >= LEVELS[currentLevel]) {
+            console.warn(`[Voltra] ${message}`);
+        }
+    },
+    error: (message) => {
+        if (LEVELS.error >= LEVELS[currentLevel]) {
+            console.error(`[Voltra] ${message}`);
+        }
+    },
+    setLevel: (level) => {
+        currentLevel = level;
+    },
+};
+//# sourceMappingURL=logger.js.map

package/build/cjs/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":";;;AAAA,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACA,CAAA;AAGV,IAAI,YAAY,GAAmB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAA;AAEhD,QAAA,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE;QACzB,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,EAAE,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IACD,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE;QACxB,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;IACD,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE;QACxB,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE;QACzB,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IACD,QAAQ,EAAE,CAAC,KAAqB,EAAE,EAAE;QAClC,YAAY,GAAG,KAAK,CAAA;IACtB,CAAC;CACF,CAAA"}

package/build/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/build/cjs/payload/component-ids.js

@@ -0,0 +1,86 @@
+"use strict";
+// 🤖 AUTO-GENERATED from data/components.json
+// DO NOT EDIT MANUALLY - Changes will be overwritten
+// Schema version: 1.0.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPONENT_ID_TO_NAME = exports.COMPONENT_NAME_TO_ID = void 0;
+exports.getComponentId = getComponentId;
+exports.getComponentName = getComponentName;
+/**
+ * Mapping from component name to numeric ID
+ * Component IDs are assigned sequentially based on order in components.json (0-indexed)
+ */
+exports.COMPONENT_NAME_TO_ID = {
+    Text: 0,
+    Button: 1,
+    Label: 2,
+    Image: 3,
+    Symbol: 4,
+    Toggle: 5,
+    LinearProgressView: 6,
+    CircularProgressView: 7,
+    Gauge: 8,
+    Timer: 9,
+    LinearGradient: 10,
+    VStack: 11,
+    HStack: 12,
+    ZStack: 13,
+    GroupBox: 14,
+    GlassContainer: 15,
+    Spacer: 16,
+    Divider: 17,
+    Mask: 18,
+    Link: 19,
+    View: 20,
+    Chart: 21,
+};
+/**
+ * Mapping from numeric ID to component name
+ */
+exports.COMPONENT_ID_TO_NAME = {
+    0: 'Text',
+    1: 'Button',
+    2: 'Label',
+    3: 'Image',
+    4: 'Symbol',
+    5: 'Toggle',
+    6: 'LinearProgressView',
+    7: 'CircularProgressView',
+    8: 'Gauge',
+    9: 'Timer',
+    10: 'LinearGradient',
+    11: 'VStack',
+    12: 'HStack',
+    13: 'ZStack',
+    14: 'GroupBox',
+    15: 'GlassContainer',
+    16: 'Spacer',
+    17: 'Divider',
+    18: 'Mask',
+    19: 'Link',
+    20: 'View',
+    21: 'Chart',
+};
+/**
+ * Get component ID from name
+ * @throws Error if component name is not found
+ */
+function getComponentId(name) {
+    const id = exports.COMPONENT_NAME_TO_ID[name];
+    if (id === undefined) {
+        throw new Error(`Unknown component name: "${name}". Available components: ${Object.keys(exports.COMPONENT_NAME_TO_ID).join(', ')}`);
+    }
+    return id;
+}
+/**
+ * Get component name from ID
+ * @throws Error if component ID is not found
+ */
+function getComponentName(id) {
+    const name = exports.COMPONENT_ID_TO_NAME[id];
+    if (name === undefined) {
+        throw new Error(`Unknown component ID: ${id}. Valid IDs: 0-${Object.keys(exports.COMPONENT_ID_TO_NAME).length - 1}`);
+    }
+    return name;
+}
+//# sourceMappingURL=component-ids.js.map

package/build/cjs/payload/component-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-ids.js","sourceRoot":"","sources":["../../../src/payload/component-ids.ts"],"names":[],"mappings":";AAAA,8CAA8C;AAC9C,qDAAqD;AACrD,wBAAwB;;;AA+DxB,wCAQC;AAMD,4CAMC;AAjFD;;;GAGG;AACU,QAAA,oBAAoB,GAA2B;IAC1D,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,kBAAkB,EAAE,CAAC;IACrB,oBAAoB,EAAE,CAAC;IACvB,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,cAAc,EAAE,EAAE;IAClB,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,QAAQ,EAAE,EAAE;IACZ,cAAc,EAAE,EAAE;IAClB,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAA;AAED;;GAEG;AACU,QAAA,oBAAoB,GAA2B;IAC1D,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,oBAAoB;IACvB,CAAC,EAAE,sBAAsB;IACzB,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,OAAO;IACV,EAAE,EAAE,gBAAgB;IACpB,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,UAAU;IACd,EAAE,EAAE,gBAAgB;IACpB,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,OAAO;CACZ,CAAA;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,MAAM,EAAE,GAAG,4BAAoB,CAAC,IAAI,CAAC,CAAA;IACrC,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,4BAA4B,IAAI,4BAA4B,MAAM,CAAC,IAAI,CAAC,4BAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3G,CAAA;IACH,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,EAAU;IACzC,MAAM,IAAI,GAAG,4BAAoB,CAAC,EAAE,CAAC,CAAA;IACrC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,kBAAkB,MAAM,CAAC,IAAI,CAAC,4BAAoB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAA;IAC9G,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/build/cjs/payload/short-names.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shorten = exports.SHORT_TO_NAME = exports.NAME_TO_SHORT = exports.expand = void 0;
+var core_1 = require("@use-voltra/core");
+Object.defineProperty(exports, "expand", { enumerable: true, get: function () { return core_1.expand; } });
+Object.defineProperty(exports, "NAME_TO_SHORT", { enumerable: true, get: function () { return core_1.NAME_TO_SHORT; } });
+Object.defineProperty(exports, "SHORT_TO_NAME", { enumerable: true, get: function () { return core_1.SHORT_TO_NAME; } });
+Object.defineProperty(exports, "shorten", { enumerable: true, get: function () { return core_1.shorten; } });
+//# sourceMappingURL=short-names.js.map

package/build/cjs/payload/short-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"short-names.js","sourceRoot":"","sources":["../../../src/payload/short-names.ts"],"names":[],"mappings":";;;AAAA,yCAAgF;AAAvE,8FAAA,MAAM,OAAA;AAAE,qGAAA,aAAa,OAAA;AAAE,qGAAA,aAAa,OAAA;AAAE,+FAAA,OAAO,OAAA"}

package/build/cjs/payload.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensurePayloadWithinBudget = void 0;
+var core_1 = require("@use-voltra/core");
+Object.defineProperty(exports, "ensurePayloadWithinBudget", { enumerable: true, get: function () { return core_1.ensurePayloadWithinBudget; } });
+//# sourceMappingURL=payload.js.map

package/build/cjs/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/payload.ts"],"names":[],"mappings":";;;AAAA,yCAA4D;AAAnD,iHAAA,yBAAyB,OAAA"}

package/build/cjs/preload.js

@@ -0,0 +1,115 @@
+"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.reloadLiveActivities = reloadLiveActivities;
+exports.clearPreloadedImages = clearPreloadedImages;
+const react_native_1 = require("react-native");
+const VoltraModule_js_1 = __importDefault(require("./VoltraModule.js"));
+function assertIOS(name) {
+    const isIOS = react_native_1.Platform.OS === 'ios';
+    if (!isIOS)
+        console.error(`${name} is only available on iOS`);
+    return isIOS;
+}
+/**
+ * Preload images to App Group storage for use in Live Activities.
+ *
+ * Downloaded images are stored in shared storage accessible by both the app
+ * and the Live Activity widget extension. Images can then be referenced using
+ * the `assetName` property in the Image component.
+ *
+ * Images must be less than 4KB to comply with ActivityKit limits.
+ *
+ * @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 Live Activity
+ * <Voltra.Image source={{ assetName: 'current-album' }} />
+ * ```
+ */
+async function preloadImages(images) {
+    if (!assertIOS('preloadImages')) {
+        return { succeeded: [], failed: images.map((img) => ({ key: img.key, error: 'Not available on this platform' })) };
+    }
+    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',
+            })),
+        };
+    }
+}
+/**
+ * Reload Live Activities to pick up newly preloaded images.
+ *
+ * This triggers an update on the specified Live Activities (or all if none specified)
+ * with their current content state, forcing SwiftUI to re-render and load the
+ * newly preloaded images from App Group storage.
+ *
+ * @param activityNames - Optional array of activity names to reload. If omitted, reloads all.
+ *
+ * @example
+ * ```typescript
+ * // Preload new image
+ * await preloadImages([{ url: 'https://example.com/new-art.jpg', key: 'album-art' }])
+ *
+ * // Reload specific activity to pick up the new image
+ * await reloadLiveActivities(['music-player'])
+ *
+ * // Or reload all activities
+ * await reloadLiveActivities()
+ * ```
+ */
+async function reloadLiveActivities(activityNames) {
+    if (!assertIOS('reloadLiveActivities'))
+        return;
+    try {
+        await VoltraModule_js_1.default.reloadLiveActivities(activityNames ?? null);
+    }
+    catch (error) {
+        console.error('Failed to reload Live Activities:', error);
+    }
+}
+/**
+ * Clear preloaded images from App Group storage.
+ *
+ * @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) {
+    if (!assertIOS('clearPreloadedImages'))
+        return;
+    try {
+        await VoltraModule_js_1.default.clearPreloadedImages(keys ?? null);
+    }
+    catch (error) {
+        console.error('Failed to clear preloaded images:', error);
+    }
+}
+//# sourceMappingURL=preload.js.map

package/build/cjs/preload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preload.js","sourceRoot":"","sources":["../../src/preload.ts"],"names":[],"mappings":";;;;;AAwCA,sCAgBC;AAuBD,oDAQC;AAgBD,oDAQC;AA/GD,+CAAuC;AAGvC,wEAA4C;AAK5C,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,uBAAQ,CAAC,EAAE,KAAK,KAAK,CAAA;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,2BAA2B,CAAC,CAAA;IAC7D,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,KAAK,UAAU,aAAa,CAAC,MAA6B;IAC/D,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC,CAAC,EAAE,CAAA;IACpH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAO,yBAAoB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAC1D,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;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,KAAK,UAAU,oBAAoB,CAAC,aAAwB;IACjE,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC;QAAE,OAAM;IAE9C,IAAI,CAAC;QACH,MAAO,yBAAoB,CAAC,oBAAoB,CAAC,aAAa,IAAI,IAAI,CAAC,CAAA;IACzE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,oBAAoB,CAAC,IAAe;IACxD,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC;QAAE,OAAM;IAE9C,IAAI,CAAC;QACH,MAAO,yBAAoB,CAAC,oBAAoB,CAAC,IAAI,IAAI,IAAI,CAAC,CAAA;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC"}