@use-voltra/ios-client 2.2.0 → 2.3.0

package/build/commonjs/widgets/server-update.js

@@ -0,0 +1,78 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clearWidgetServerUpdate = clearWidgetServerUpdate;
+exports.getWidgetServerUpdate = getWidgetServerUpdate;
+exports.setWidgetServerUpdate = setWidgetServerUpdate;
+var _VoltraModule = require("../VoltraModule.js");
+/**
+ * Overrides a server-driven widget's `serverUpdate` settings at runtime.
+ *
+ * The `serverUpdate` entry in app.json supplies the defaults; this replaces any of them for one
+ * widget, or for every server-driven widget when no `widgetId` is given. A widget-scoped call wins
+ * over a global one, and `headers` and `query` merge per key across the two.
+ *
+ * Each call replaces the whole layer it writes, so pass every field you want to keep. Setting
+ * anything reschedules the widgets it affects and fetches once immediately.
+ *
+ * @example Point a widget at the tenant's own backend once the user has logged in.
+ * ```ts
+ * await setWidgetServerUpdate(
+ *   { url: `https://${tenant}.example.com/widgets/portfolio`, headers: { Authorization: `Bearer ${token}` } },
+ *   { widgetId: 'portfolio' }
+ * )
+ * ```
+ *
+ * @example Take a widget over and drive it from the app until you hand it back.
+ * ```ts
+ * await setWidgetServerUpdate({ enabled: false }, { widgetId: 'portfolio' })
+ * await updateDynamicWidget('portfolio', localProps)
+ * ```
+ *
+ * @throws if the widget has no `serverUpdate` in app.json, if the URL is not https (plain http is
+ *   allowed only in a debug build, and only for a local dev host), or if `query` names one of the
+ *   parameters Voltra already sends.
+ */
+async function setWidgetServerUpdate(settings, options) {
+  return (0, _VoltraModule.getNativeVoltra)().setWidgetServerUpdate(JSON.stringify(settings ?? {}), options?.widgetId ?? null);
+}
+
+/**
+ * Drops the runtime settings for one widget, or the global ones when no `widgetId` is given, so
+ * the widget falls back to what app.json configured.
+ *
+ * Clearing the global settings is the logout gesture: along with the settings it drops what the
+ * server last sent for every server-driven widget, so a Dynamic Widget goes back to `{}` with
+ * `env.serverUpdate.status` of `never` rather than showing the previous account's data. Credentials
+ * set with the deprecated `setWidgetServerCredentials` are stored separately — clear those with
+ * `clearWidgetServerCredentials`.
+ */
+async function clearWidgetServerUpdate(options) {
+  return (0, _VoltraModule.getNativeVoltra)().clearWidgetServerUpdate(options?.widgetId ?? null);
+}
+
+/**
+ * Reads a widget's `serverUpdate` settings back, without reasoning about what was set where.
+ *
+ * With a `widgetId`, this is the fully resolved settings that widget would fetch with right now:
+ * every layer flattened and app.json's defaults applied — `null` if the widget is not
+ * server-driven. Without one, this is the raw contents of the global layer only — what the last
+ * `setWidgetServerUpdate(settings)` call (with no `widgetId`) wrote, with no defaults applied and
+ * every field optional — `null` if nothing has been set globally.
+ *
+ * @example Check what a widget is about to fetch from.
+ * ```ts
+ * const snapshot = await getWidgetServerUpdate({ widgetId: 'portfolio' })
+ * if (snapshot?.enabled) {
+ *   console.log(`portfolio fetches ${snapshot.url} every ${snapshot.intervalMinutes}m`)
+ * }
+ * ```
+ */
+
+async function getWidgetServerUpdate(options) {
+  const json = await (0, _VoltraModule.getNativeVoltra)().getWidgetServerUpdate(options?.widgetId ?? null);
+  return json == null ? null : JSON.parse(json);
+}
+//# sourceMappingURL=server-update.js.map

package/build/commonjs/widgets/server-update.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_VoltraModule","require","setWidgetServerUpdate","settings","options","getNativeVoltra","JSON","stringify","widgetId","clearWidgetServerUpdate","getWidgetServerUpdate","json","parse"],"sourceRoot":"../../../src","sources":["widgets/server-update.ts"],"mappings":";;;;;;;;AACA,IAAAA,aAAA,GAAAC,OAAA;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeC,qBAAqBA,CACzCC,QAAoC,EACpCC,OAAmC,EACpB;EACf,OAAO,IAAAC,6BAAe,EAAC,CAAC,CAACH,qBAAqB,CAACI,IAAI,CAACC,SAAS,CAACJ,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAEC,OAAO,EAAEI,QAAQ,IAAI,IAAI,CAAC;AAC3G;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeC,uBAAuBA,CAACL,OAAmC,EAAiB;EAChG,OAAO,IAAAC,6BAAe,EAAC,CAAC,CAACI,uBAAuB,CAACL,OAAO,EAAEI,QAAQ,IAAI,IAAI,CAAC;AAC7E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGO,eAAeE,qBAAqBA,CACzCN,OAAmC,EACsC;EACzE,MAAMO,IAAI,GAAG,MAAM,IAAAN,6BAAe,EAAC,CAAC,CAACK,qBAAqB,CAACN,OAAO,EAAEI,QAAQ,IAAI,IAAI,CAAC;EACrF,OAAOG,IAAI,IAAI,IAAI,GAAG,IAAI,GAAGL,IAAI,CAACM,KAAK,CAACD,IAAI,CAAC;AAC/C","ignoreList":[]}

package/build/module/events.js

@@ -5,6 +5,11 @@ import { getNativeVoltra } from './VoltraModule.js';
 const noopSubscription = {
   remove: () => {}
 };
+
+// Codegen EventEmitter subscriptions do not tell native code when their last
+// JavaScript listener goes away. Keep this count at the public API boundary so
+// the App Group queue is drained only while it can actually be delivered.
+let dynamicRenderFailureListenerCount = 0;
 export function addVoltraListener(event, listener) {
   if (Platform.OS !== 'ios') {
     console.warn(`[Voltra] Event '${event}' is only supported on iOS. Returning no-op subscription.`);
@@ -20,6 +25,24 @@ export function addVoltraListener(event, listener) {
       return voltraModule.onStateChanged(listener);
     case 'interaction':
       return voltraModule.onInteraction(listener);
+    case 'dynamicLiveActivityRenderFailed':
+      const subscription = voltraModule.onDynamicLiveActivityRenderFailed(listener);
+      dynamicRenderFailureListenerCount += 1;
+      if (dynamicRenderFailureListenerCount === 1) {
+        voltraModule.setDynamicLiveActivityRenderFailureListenerActive(true);
+      }
+      let removed = false;
+      return {
+        remove: () => {
+          if (removed) return;
+          removed = true;
+          subscription.remove();
+          dynamicRenderFailureListenerCount -= 1;
+          if (dynamicRenderFailureListenerCount === 0) {
+            voltraModule.setDynamicLiveActivityRenderFailureListenerActive(false);
+          }
+        }
+      };
     default:
       console.warn(`[Voltra] Event '${event}' is not supported. Returning no-op subscription.`);
       return noopSubscription;

package/build/module/events.js.map

@@ -1 +1 @@
-{"version":3,"names":["Platform","getNativeVoltra","noopSubscription","remove","addVoltraListener","event","listener","OS","console","warn","voltraModule","onActivityTokenReceived","onActivityPushToStartTokenReceived","onStateChanged","onInteraction"],"sourceRoot":"../../src","sources":["events.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AAGvC,SAASC,eAAe,QAAQ,mBAAmB;AA6BnD,MAAMC,gBAAmC,GAAG;EAC1CC,MAAM,EAAEA,CAAA,KAAM,CAAC;AACjB,CAAC;AASD,OAAO,SAASC,iBAAiBA,CAC/BC,KAAQ,EACRC,QAA4C,EACzB;EACnB,IAAIN,QAAQ,CAACO,EAAE,KAAK,KAAK,EAAE;IACzBC,OAAO,CAACC,IAAI,CAAC,mBAAmBJ,KAAK,2DAA2D,CAAC;IACjG,OAAOH,gBAAgB;EACzB;EAEA,MAAMQ,YAAY,GAAGT,eAAe,CAAC,CAAC;EAEtC,QAAQI,KAAK;IACX,KAAK,uBAAuB;MAC1B,OAAOK,YAAY,CAACC,uBAAuB,CAACL,QAA2D,CAAC;IAC1G,KAAK,kCAAkC;MACrC,OAAOI,YAAY,CAACE,kCAAkC,CACpDN,QACF,CAAC;IACH,KAAK,aAAa;MAChB,OAAOI,YAAY,CAACG,cAAc,CAACP,QAAoD,CAAC;IAC1F,KAAK,aAAa;MAChB,OAAOI,YAAY,CAACI,aAAa,CAACR,QAAiD,CAAC;IACtF;MACEE,OAAO,CAACC,IAAI,CAAC,mBAAmBJ,KAAK,mDAAmD,CAAC;MACzF,OAAOH,gBAAgB;EAC3B;AACF","ignoreList":[]}
+{"version":3,"names":["Platform","getNativeVoltra","noopSubscription","remove","dynamicRenderFailureListenerCount","addVoltraListener","event","listener","OS","console","warn","voltraModule","onActivityTokenReceived","onActivityPushToStartTokenReceived","onStateChanged","onInteraction","subscription","onDynamicLiveActivityRenderFailed","setDynamicLiveActivityRenderFailureListenerActive","removed"],"sourceRoot":"../../src","sources":["events.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AAGvC,SAASC,eAAe,QAAQ,mBAAmB;AAoCnD,MAAMC,gBAAmC,GAAG;EAC1CC,MAAM,EAAEA,CAAA,KAAM,CAAC;AACjB,CAAC;;AAED;AACA;AACA;AACA,IAAIC,iCAAiC,GAAG,CAAC;AAUzC,OAAO,SAASC,iBAAiBA,CAC/BC,KAAQ,EACRC,QAA4C,EACzB;EACnB,IAAIP,QAAQ,CAACQ,EAAE,KAAK,KAAK,EAAE;IACzBC,OAAO,CAACC,IAAI,CAAC,mBAAmBJ,KAAK,2DAA2D,CAAC;IACjG,OAAOJ,gBAAgB;EACzB;EAEA,MAAMS,YAAY,GAAGV,eAAe,CAAC,CAAC;EAEtC,QAAQK,KAAK;IACX,KAAK,uBAAuB;MAC1B,OAAOK,YAAY,CAACC,uBAAuB,CAACL,QAA2D,CAAC;IAC1G,KAAK,kCAAkC;MACrC,OAAOI,YAAY,CAACE,kCAAkC,CACpDN,QACF,CAAC;IACH,KAAK,aAAa;MAChB,OAAOI,YAAY,CAACG,cAAc,CAACP,QAAoD,CAAC;IAC1F,KAAK,aAAa;MAChB,OAAOI,YAAY,CAACI,aAAa,CAACR,QAAiD,CAAC;IACtF,KAAK,iCAAiC;MACpC,MAAMS,YAAY,GAAGL,YAAY,CAACM,iCAAiC,CACjEV,QACF,CAAC;MACDH,iCAAiC,IAAI,CAAC;MACtC,IAAIA,iCAAiC,KAAK,CAAC,EAAE;QAC3CO,YAAY,CAACO,iDAAiD,CAAC,IAAI,CAAC;MACtE;MAEA,IAAIC,OAAO,GAAG,KAAK;MACnB,OAAO;QACLhB,MAAM,EAAEA,CAAA,KAAM;UACZ,IAAIgB,OAAO,EAAE;UACbA,OAAO,GAAG,IAAI;UACdH,YAAY,CAACb,MAAM,CAAC,CAAC;UACrBC,iCAAiC,IAAI,CAAC;UACtC,IAAIA,iCAAiC,KAAK,CAAC,EAAE;YAC3CO,YAAY,CAACO,iDAAiD,CAAC,KAAK,CAAC;UACvE;QACF;MACF,CAAC;IACH;MACET,OAAO,CAACC,IAAI,CAAC,mBAAmBJ,KAAK,mDAAmD,CAAC;MACzF,OAAOJ,gBAAgB;EAC3B;AACF","ignoreList":[]}

package/build/module/index.js

@@ -9,11 +9,14 @@ export * from './events.js';
 export { isGlassSupported, isHeadless, useIsHeadless } from './helpers.js';
 export { logger } from './logger.js';
 export { endAllLiveActivities, isLiveActivityActive, startLiveActivity, stopLiveActivity, updateLiveActivity, useLiveActivity } from './live-activity/api.js';
+export { getDynamicLiveActivityDefinitionIds, startDynamicLiveActivity, updateDynamicLiveActivity, useDynamicLiveActivity } from './live-activity/dynamic-api.js';
 export { clearPreloadedImages, preloadImages, reloadLiveActivities } from './preload.js';
 export { assertRunningOnApple } from './utils/assertRunningOnApple.js';
 export { enableWidgetHotReload } from './utils/enableWidgetHotReload.js';
+export { enableDynamicLiveActivityHotReload } from './utils/enableDynamicLiveActivityHotReload.js';
 export { useUpdateOnHMR } from './utils/useUpdateOnHMR.js';
 export * from './utils/helpers.js';
+export { clearWidgetServerUpdate, getWidgetServerUpdate, setWidgetServerUpdate } from './widgets/server-update.js';
 export { clearWidgetServerCredentials, setWidgetServerCredentials } from './widgets/server-credentials.js';
 export { clearAllWidgets, clearWidget, getActiveWidgets, reloadWidgets, scheduleWidget, updateWidget } from './widgets/widget-api.js';
 //# sourceMappingURL=index.js.map

package/build/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Voltra","VoltraLiveActivityPreview","VoltraView","VoltraWidgetPreview","updateDynamicWidget","isGlassSupported","isHeadless","useIsHeadless","logger","endAllLiveActivities","isLiveActivityActive","startLiveActivity","stopLiveActivity","updateLiveActivity","useLiveActivity","clearPreloadedImages","preloadImages","reloadLiveActivities","assertRunningOnApple","enableWidgetHotReload","useUpdateOnHMR","clearWidgetServerCredentials","setWidgetServerCredentials","clearAllWidgets","clearWidget","getActiveWidgets","reloadWidgets","scheduleWidget","updateWidget"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,iBAAiB;AACxC,SACEC,yBAAyB,QAEpB,2CAA2C;AAClD,SAASC,UAAU,QAA8B,4BAA4B;AAC7E,SAASC,mBAAmB,QAAuC,qCAAqC;AACxG,SAAgEC,mBAAmB,QAAQ,yBAAyB;AACpH,cAAc,aAAa;AAC3B,SAASC,gBAAgB,EAAEC,UAAU,EAAEC,aAAa,QAAQ,cAAc;AAC1E,SAASC,MAAM,QAA6B,aAAa;AACzD,SACEC,oBAAoB,EAEpBC,oBAAoB,EAEpBC,iBAAiB,EAEjBC,gBAAgB,EAChBC,kBAAkB,EAElBC,eAAe,QAGV,wBAAwB;AAE/B,SACEC,oBAAoB,EAEpBC,aAAa,EAEbC,oBAAoB,QACf,cAAc;AACrB,SAASC,oBAAoB,QAAQ,iCAAiC;AACtE,SAASC,qBAAqB,QAAQ,kCAAkC;AACxE,SAASC,cAAc,QAAQ,2BAA2B;AAC1D,cAAc,oBAAoB;AAElC,SACEC,4BAA4B,EAC5BC,0BAA0B,QAErB,iCAAiC;AAExC,SACEC,eAAe,EACfC,WAAW,EACXC,gBAAgB,EAChBC,aAAa,EAEbC,cAAc,EACdC,YAAY,QAEP,yBAAyB","ignoreList":[]}
+{"version":3,"names":["Voltra","VoltraLiveActivityPreview","VoltraView","VoltraWidgetPreview","updateDynamicWidget","isGlassSupported","isHeadless","useIsHeadless","logger","endAllLiveActivities","isLiveActivityActive","startLiveActivity","stopLiveActivity","updateLiveActivity","useLiveActivity","getDynamicLiveActivityDefinitionIds","startDynamicLiveActivity","updateDynamicLiveActivity","useDynamicLiveActivity","clearPreloadedImages","preloadImages","reloadLiveActivities","assertRunningOnApple","enableWidgetHotReload","enableDynamicLiveActivityHotReload","useUpdateOnHMR","clearWidgetServerUpdate","getWidgetServerUpdate","setWidgetServerUpdate","clearWidgetServerCredentials","setWidgetServerCredentials","clearAllWidgets","clearWidget","getActiveWidgets","reloadWidgets","scheduleWidget","updateWidget"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,iBAAiB;AACxC,SACEC,yBAAyB,QAEpB,2CAA2C;AAClD,SAASC,UAAU,QAA8B,4BAA4B;AAC7E,SAASC,mBAAmB,QAAuC,qCAAqC;AACxG,SAAgEC,mBAAmB,QAAQ,yBAAyB;AACpH,cAAc,aAAa;AAC3B,SAASC,gBAAgB,EAAEC,UAAU,EAAEC,aAAa,QAAQ,cAAc;AAC1E,SAASC,MAAM,QAA6B,aAAa;AACzD,SACEC,oBAAoB,EAEpBC,oBAAoB,EAEpBC,iBAAiB,EAEjBC,gBAAgB,EAChBC,kBAAkB,EAElBC,eAAe,QAGV,wBAAwB;AAC/B,SACEC,mCAAmC,EACnCC,wBAAwB,EAExBC,yBAAyB,EAEzBC,sBAAsB,QAKjB,gCAAgC;AAEvC,SACEC,oBAAoB,EAEpBC,aAAa,EAEbC,oBAAoB,QACf,cAAc;AACrB,SAASC,oBAAoB,QAAQ,iCAAiC;AACtE,SAASC,qBAAqB,QAAQ,kCAAkC;AACxE,SAASC,kCAAkC,QAAQ,+CAA+C;AAClG,SAASC,cAAc,QAAQ,2BAA2B;AAC1D,cAAc,oBAAoB;AAElC,SACEC,uBAAuB,EACvBC,qBAAqB,EACrBC,qBAAqB,QAKhB,4BAA4B;AACnC,SACEC,4BAA4B,EAC5BC,0BAA0B,QAErB,iCAAiC;AAExC,SACEC,eAAe,EACfC,WAAW,EACXC,gBAAgB,EAChBC,aAAa,EAEbC,cAAc,EACdC,YAAY,QAEP,yBAAyB","ignoreList":[]}

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

@@ -6,7 +6,7 @@ import { addVoltraListener } from '../events.js';
 import { logger } from '../logger.js';
 import { assertRunningOnApple, useUpdateOnHMR } from '../utils/index.js';
 import { getNativeVoltra } from '../VoltraModule.js';
-const normalizeSharedLiveActivityOptions = options => {
+export const normalizeSharedLiveActivityOptions = options => {
   if (!options) return undefined;
   const normalizedOptions = {};
   if (options.staleDate !== undefined) {
@@ -25,7 +25,7 @@ const normalizeSharedLiveActivityOptions = options => {
   }
   return Object.keys(normalizedOptions).length > 0 ? normalizedOptions : undefined;
 };
-const normalizeEndLiveActivityOptions = options => {
+export const normalizeEndLiveActivityOptions = options => {
   if (!options?.dismissalPolicy) return undefined;
   if (typeof options.dismissalPolicy === 'string') {
     if (options.dismissalPolicy === 'immediate') {

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

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useEffect","useRef","useState","renderLiveActivityToString","addVoltraListener","logger","assertRunningOnApple","useUpdateOnHMR","getNativeVoltra","normalizeSharedLiveActivityOptions","options","undefined","normalizedOptions","staleDate","Date","now","warn","relevanceScore","Object","keys","length","normalizeEndLiveActivityOptions","dismissalPolicy","type","date","after","useLiveActivity","variants","targetId","setTargetId","activityName","isLiveActivityActive","isActive","optionsRef","variantsRef","lastUpdateOptionsRef","current","start","id","startLiveActivity","update","updateOptions","updateLiveActivity","end","stopLiveActivity","autoStart","autoUpdate","subscription","event","activityState","remove","Promise","resolve","payload","normalizedSharedOptions","target","deepLinkUrl","channelId","endLiveActivity","endAllLiveActivities"],"sourceRoot":"../../../src","sources":["live-activity/api.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useCallback","useEffect","useRef","useState","renderLiveActivityToString","addVoltraListener","logger","assertRunningOnApple","useUpdateOnHMR","getNativeVoltra","normalizeSharedLiveActivityOptions","options","undefined","normalizedOptions","staleDate","Date","now","warn","relevanceScore","Object","keys","length","normalizeEndLiveActivityOptions","dismissalPolicy","type","date","after","useLiveActivity","variants","targetId","setTargetId","activityName","isLiveActivityActive","isActive","optionsRef","variantsRef","lastUpdateOptionsRef","current","start","id","startLiveActivity","update","updateOptions","updateLiveActivity","end","stopLiveActivity","autoStart","autoUpdate","subscription","event","activityState","remove","Promise","resolve","payload","normalizedSharedOptions","target","deepLinkUrl","channelId","endLiveActivity","endAllLiveActivities"],"sourceRoot":"../../../src","sources":["live-activity/api.ts"],"mappings":"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","ignoreList":[]}

package/build/module/live-activity/dynamic-api.js

@@ -0,0 +1,167 @@
+"use strict";
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { addVoltraListener } from '../events.js';
+import { assertRunningOnApple, useUpdateOnHMR } from '../utils/index.js';
+import { getNativeVoltra } from '../VoltraModule.js';
+import { isLiveActivityActive, normalizeSharedLiveActivityOptions, stopLiveActivity } from './api.js';
+
+/** @experimental A JSON-compatible value accepted as Dynamic Live Activity props. */
+
+/** @experimental A complete JSON-compatible props record for a Dynamic Live Activity update. */
+
+/** @experimental Options used to start a Dynamic Live Activity. */
+
+/** @experimental Options used to update a Dynamic Live Activity. */
+
+/** @experimental Options for `useDynamicLiveActivity`. */
+
+/** @experimental Lifecycle controls returned by `useDynamicLiveActivity`. */
+
+function serializeDynamicLiveActivityProps(props) {
+  const ancestors = new Set();
+  const validate = (value, path) => {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean') return;
+    if (typeof value === 'number') {
+      if (!Number.isFinite(value)) {
+        throw new TypeError(`Dynamic Live Activity props must be JSON-compatible; ${path} is not a finite number.`);
+      }
+      return;
+    }
+    if (Array.isArray(value)) {
+      if (ancestors.has(value)) {
+        throw new TypeError(`Dynamic Live Activity props must be JSON-compatible; ${path} contains a circular reference.`);
+      }
+      ancestors.add(value);
+      value.forEach((item, index) => validate(item, `${path}[${index}]`));
+      ancestors.delete(value);
+      return;
+    }
+    if (typeof value === 'object') {
+      const prototype = Object.getPrototypeOf(value);
+      if (prototype !== Object.prototype && prototype !== null) {
+        throw new TypeError(`Dynamic Live Activity props must be JSON-compatible; ${path} must be a plain object.`);
+      }
+      if (ancestors.has(value)) {
+        throw new TypeError(`Dynamic Live Activity props must be JSON-compatible; ${path} contains a circular reference.`);
+      }
+      ancestors.add(value);
+      for (const [key, item] of Object.entries(value)) {
+        validate(item, `${path}.${key}`);
+      }
+      ancestors.delete(value);
+      return;
+    }
+    throw new TypeError(`Dynamic Live Activity props must be JSON-compatible; ${path} has unsupported type ${typeof value}.`);
+  };
+  if (props === null || Array.isArray(props) || typeof props !== 'object') {
+    throw new TypeError('Dynamic Live Activity props must be a JSON-compatible record.');
+  }
+  validate(props, 'props');
+  return JSON.stringify(props);
+}
+
+/**
+ * Starts a bundled Dynamic Live Activity with a complete opaque props record.
+ * @experimental
+ */
+export async function startDynamicLiveActivity(definitionId, props, options) {
+  if (!assertRunningOnApple()) return '';
+  const propsJson = serializeDynamicLiveActivityProps(props);
+  const normalizedSharedOptions = normalizeSharedLiveActivityOptions(options);
+  return getNativeVoltra().startDynamicLiveActivity(definitionId, propsJson, {
+    target: 'liveActivity',
+    deepLinkUrl: options?.deepLinkUrl,
+    activityName: options?.activityName,
+    channelId: options?.channelId,
+    ...normalizedSharedOptions
+  });
+}
+
+/**
+ * Replaces a Dynamic Live Activity's complete opaque props record.
+ * @experimental
+ */
+export async function updateDynamicLiveActivity(activityName, props, options) {
+  if (!assertRunningOnApple()) return;
+  const propsJson = serializeDynamicLiveActivityProps(props);
+  return getNativeVoltra().updateDynamicLiveActivity(activityName, propsJson, normalizeSharedLiveActivityOptions(options) ?? {});
+}
+
+/**
+ * Returns the Dynamic Live Activity definition IDs bundled in the installed app.
+ * @experimental
+ */
+export async function getDynamicLiveActivityDefinitionIds() {
+  if (!assertRunningOnApple()) return [];
+  return getNativeVoltra().getDynamicLiveActivityDefinitionIds();
+}
+
+/**
+ * Manages the lifecycle of one Dynamic Live Activity definition.
+ *
+ * Complete props are sent on every update. In development, call
+ * `enableDynamicLiveActivityHotReload()` once in the app host to reload only
+ * the definition changed by Fast Refresh.
+ * @experimental
+ */
+export function useDynamicLiveActivity(definitionId, props, options) {
+  const [activityName, setActivityName] = useState(() => {
+    if (options?.activityName) {
+      return isLiveActivityActive(options.activityName) ? options.activityName : null;
+    }
+    return null;
+  });
+  const propsRef = useRef(props);
+  const optionsRef = useRef(options);
+  const lastUpdateOptionsRef = useRef(undefined);
+  useEffect(() => {
+    propsRef.current = props;
+  }, [props]);
+  useEffect(() => {
+    optionsRef.current = options;
+  }, [options]);
+  useUpdateOnHMR();
+  const start = useCallback(async startOptions => {
+    const id = await startDynamicLiveActivity(definitionId, propsRef.current, {
+      ...optionsRef.current,
+      ...startOptions
+    });
+    setActivityName(id);
+  }, [definitionId]);
+  const update = useCallback(async updateOptions => {
+    if (!activityName) return;
+    const mergedOptions = {
+      ...optionsRef.current,
+      ...updateOptions
+    };
+    lastUpdateOptionsRef.current = mergedOptions;
+    await updateDynamicLiveActivity(activityName, propsRef.current, mergedOptions);
+  }, [activityName]);
+  const end = useCallback(async endOptions => {
+    if (!activityName) return;
+    await stopLiveActivity(activityName, endOptions);
+    setActivityName(null);
+  }, [activityName]);
+  useEffect(() => {
+    if (options?.autoStart) void start();
+  }, [options?.autoStart, start]);
+  useEffect(() => {
+    if (options?.autoUpdate) void update(lastUpdateOptionsRef.current);
+  }, [options?.autoUpdate, props, update]);
+  useEffect(() => {
+    if (!activityName) return;
+    const subscription = addVoltraListener('stateChange', event => {
+      if (event.activityName !== activityName) return;
+      if (event.activityState === 'dismissed' || event.activityState === 'ended') setActivityName(null);
+    });
+    return () => subscription.remove();
+  }, [activityName]);
+  return {
+    start,
+    update,
+    end,
+    isActive: activityName !== null
+  };
+}
+//# sourceMappingURL=dynamic-api.js.map

package/build/module/live-activity/dynamic-api.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useRef","useState","addVoltraListener","assertRunningOnApple","useUpdateOnHMR","getNativeVoltra","isLiveActivityActive","normalizeSharedLiveActivityOptions","stopLiveActivity","serializeDynamicLiveActivityProps","props","ancestors","Set","validate","value","path","Number","isFinite","TypeError","Array","isArray","has","add","forEach","item","index","delete","prototype","Object","getPrototypeOf","key","entries","JSON","stringify","startDynamicLiveActivity","definitionId","options","propsJson","normalizedSharedOptions","target","deepLinkUrl","activityName","channelId","updateDynamicLiveActivity","getDynamicLiveActivityDefinitionIds","useDynamicLiveActivity","setActivityName","propsRef","optionsRef","lastUpdateOptionsRef","undefined","current","start","startOptions","id","update","updateOptions","mergedOptions","end","endOptions","autoStart","autoUpdate","subscription","event","activityState","remove","isActive"],"sourceRoot":"../../../src","sources":["live-activity/dynamic-api.ts"],"mappings":"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","ignoreList":[]}

package/build/module/native/NativeVoltra.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getNativeVoltra","voltraModule","get","Error"],"sourceRoot":"../../../src","sources":["native/NativeVoltra.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AAgHlD,OAAO,SAASC,eAAeA,CAAA,EAAS;EACtC,MAAMC,YAAY,GAAGF,mBAAmB,CAACG,GAAG,CAAO,cAAc,CAAC;EAElE,IAAID,YAAY,IAAI,IAAI,EAAE;IACxB,MAAM,IAAIE,KAAK,CAAC,+BAA+B,CAAC;EAClD;EAEA,OAAOF,YAAY;AACrB","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getNativeVoltra","voltraModule","get","Error"],"sourceRoot":"../../../src","sources":["native/NativeVoltra.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AAqIlD,OAAO,SAASC,eAAeA,CAAA,EAAS;EACtC,MAAMC,YAAY,GAAGF,mBAAmB,CAACG,GAAG,CAAO,cAAc,CAAC;EAElE,IAAID,YAAY,IAAI,IAAI,EAAE;IACxB,MAAM,IAAIE,KAAK,CAAC,+BAA+B,CAAC;EAClD;EAEA,OAAOF,YAAY;AACrB","ignoreList":[]}

package/build/module/utils/enableDynamicLiveActivityHotReload.js

@@ -0,0 +1,43 @@
+"use strict";
+
+import { getFastRefreshHub } from '@use-voltra/ios';
+import { getNativeVoltra } from '../VoltraModule.js';
+/**
+ * Reload Dynamic Live Activities after a Metro Fast Refresh patch. When Metro
+ * re-evaluates a generated definition entry, only that definition is reloaded.
+ * Component-only refresh boundaries do not re-evaluate their importer, so those
+ * patches fall back to reloading every Dynamic Live Activity definition.
+ * Legacy activities and Dynamic Widgets are unaffected.
+ *
+ * Subscribes to the shared {@link getFastRefreshHub} so multiple `__accept`
+ * calls from one save collapse into a single native reload.
+ */
+export function enableDynamicLiveActivityHotReload() {
+  if (!__DEV__) return () => {};
+  const hub = getFastRefreshHub();
+  const previousDefinitionUpdated = global.__voltraDynamicLiveActivityDefinitionUpdated;
+  const updatedDefinitionIds = new Set();
+  global.__voltraDynamicLiveActivityDefinitionUpdated = definitionId => {
+    // A generated entry re-evaluated inside a patch: batch it so the debounced
+    // flush reloads each changed definition exactly once. A signal that arrives
+    // outside a patch (the first require of a definition) has no flush coming,
+    // so reload it immediately.
+    if (hub.isAccepting) {
+      updatedDefinitionIds.add(definitionId);
+      return;
+    }
+    void getNativeVoltra().reloadDynamicLiveActivities([definitionId]);
+  };
+  const unsubscribe = hub.onPatch(() => {
+    const definitionIds = Array.from(updatedDefinitionIds);
+    updatedDefinitionIds.clear();
+    // No definition re-evaluated during this patch: a component-only boundary
+    // changed, so fall back to reloading every definition (null).
+    void getNativeVoltra().reloadDynamicLiveActivities(definitionIds.length > 0 ? definitionIds : null);
+  });
+  return () => {
+    unsubscribe();
+    global.__voltraDynamicLiveActivityDefinitionUpdated = previousDefinitionUpdated;
+  };
+}
+//# sourceMappingURL=enableDynamicLiveActivityHotReload.js.map

package/build/module/utils/enableDynamicLiveActivityHotReload.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getFastRefreshHub","getNativeVoltra","enableDynamicLiveActivityHotReload","__DEV__","hub","previousDefinitionUpdated","global","__voltraDynamicLiveActivityDefinitionUpdated","updatedDefinitionIds","Set","definitionId","isAccepting","add","reloadDynamicLiveActivities","unsubscribe","onPatch","definitionIds","Array","from","clear","length"],"sourceRoot":"../../../src","sources":["utils/enableDynamicLiveActivityHotReload.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,iBAAiB;AAEnD,SAASC,eAAe,QAAQ,oBAAoB;AAMpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kCAAkCA,CAAA,EAAe;EAC/D,IAAI,CAACC,OAAO,EAAE,OAAO,MAAM,CAAC,CAAC;EAE7B,MAAMC,GAAG,GAAGJ,iBAAiB,CAAC,CAAC;EAC/B,MAAMK,yBAAyB,GAAGC,MAAM,CAACC,4CAA4C;EACrF,MAAMC,oBAAoB,GAAG,IAAIC,GAAG,CAAS,CAAC;EAE9CH,MAAM,CAACC,4CAA4C,GAAIG,YAAY,IAAK;IACtE;IACA;IACA;IACA;IACA,IAAIN,GAAG,CAACO,WAAW,EAAE;MACnBH,oBAAoB,CAACI,GAAG,CAACF,YAAY,CAAC;MACtC;IACF;IACA,KAAKT,eAAe,CAAC,CAAC,CAACY,2BAA2B,CAAC,CAACH,YAAY,CAAC,CAAC;EACpE,CAAC;EAED,MAAMI,WAAW,GAAGV,GAAG,CAACW,OAAO,CAAC,MAAM;IACpC,MAAMC,aAAa,GAAGC,KAAK,CAACC,IAAI,CAACV,oBAAoB,CAAC;IACtDA,oBAAoB,CAACW,KAAK,CAAC,CAAC;IAC5B;IACA;IACA,KAAKlB,eAAe,CAAC,CAAC,CAACY,2BAA2B,CAACG,aAAa,CAACI,MAAM,GAAG,CAAC,GAAGJ,aAAa,GAAG,IAAI,CAAC;EACrG,CAAC,CAAC;EAEF,OAAO,MAAM;IACXF,WAAW,CAAC,CAAC;IACbR,MAAM,CAACC,4CAA4C,GAAGF,yBAAyB;EACjF,CAAC;AACH","ignoreList":[]}

package/build/module/utils/enableWidgetHotReload.js

@@ -1,11 +1,14 @@
 "use strict";
 
+import { getFastRefreshHub } from '@use-voltra/ios';
 import { reloadWidgets } from '../widgets/widget-api.js';
+
 /**
  * Trigger `reloadWidgets()` on every Metro Fast Refresh patch (DEV only).
  *
- * Hooks the global `__accept` callback Metro fires when a Fast Refresh patch
- * lands in the host app's JS runtime. When fired, calls
+ * Subscribes to the shared {@link getFastRefreshHub}, which wraps the global
+ * `__accept` callback Metro fires when a Fast Refresh patch lands in the host
+ * app's JS runtime. On each debounced patch it calls
  * `WidgetCenter.shared.reloadAllTimelines()` so WidgetKit re-invokes each widget
  * Provider, which re-fetches the freshest bundle from Metro and renders the
  * updated UI.
@@ -16,20 +19,15 @@ import { reloadWidgets } from '../widgets/widget-api.js';
  * workflow the dev still relies on WidgetKit's natural lifecycle refresh on
  * app foreground.
  *
- * Call once at app startup. Returns `dispose()` to restore the prior
- * `__accept` (rarely needed in practice). No-op in release builds.
+ * Call once at app startup. Returns `dispose()` to unsubscribe (rarely needed
+ * in practice). No-op in release builds.
  */
 export function enableWidgetHotReload() {
   if (!__DEV__) {
     return () => {};
   }
-  const oldAccept = global['__accept'];
-  global['__accept'] = (...args) => {
+  return getFastRefreshHub().onPatch(() => {
     void reloadWidgets();
-    oldAccept?.(...args);
-  };
-  return () => {
-    global['__accept'] = oldAccept;
-  };
+  });
 }
 //# sourceMappingURL=enableWidgetHotReload.js.map

package/build/module/utils/enableWidgetHotReload.js.map

@@ -1 +1 @@
-{"version":3,"names":["reloadWidgets","enableWidgetHotReload","__DEV__","oldAccept","global","args"],"sourceRoot":"../../../src","sources":["utils/enableWidgetHotReload.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,0BAA0B;AAMxD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAAA,EAAe;EAClD,IAAI,CAACC,OAAO,EAAE;IACZ,OAAO,MAAM,CAAC,CAAC;EACjB;EAEA,MAAMC,SAAS,GAAGC,MAAM,CAAC,UAAU,CAAC;EACpCA,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAGC,IAAI,KAAK;IAChC,KAAKL,aAAa,CAAC,CAAC;IACpBG,SAAS,GAAG,GAAGE,IAAI,CAAC;EACtB,CAAC;EAED,OAAO,MAAM;IACXD,MAAM,CAAC,UAAU,CAAC,GAAGD,SAAS;EAChC,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["getFastRefreshHub","reloadWidgets","enableWidgetHotReload","__DEV__","onPatch"],"sourceRoot":"../../../src","sources":["utils/enableWidgetHotReload.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,iBAAiB;AAEnD,SAASC,aAAa,QAAQ,0BAA0B;;AAExD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAAA,EAAe;EAClD,IAAI,CAACC,OAAO,EAAE;IACZ,OAAO,MAAM,CAAC,CAAC;EACjB;EAEA,OAAOH,iBAAiB,CAAC,CAAC,CAACI,OAAO,CAAC,MAAM;IACvC,KAAKH,aAAa,CAAC,CAAC;EACtB,CAAC,CAAC;AACJ","ignoreList":[]}

package/build/module/utils/useUpdateOnHMR.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import { getFastRefreshHub } from '@use-voltra/ios';
 import { useEffect, useState } from 'react';
 export const useUpdateOnHMR = () => {
   const [, forceUpdate] = useState(0);
@@ -7,14 +8,9 @@ export const useUpdateOnHMR = () => {
     if (!__DEV__) {
       return;
     }
-    const oldAccept = global['__accept'];
-    global['__accept'] = (...args) => {
+    return getFastRefreshHub().onPatch(() => {
       forceUpdate(prev => prev + 1);
-      oldAccept?.(...args);
-    };
-    return () => {
-      global['__accept'] = oldAccept;
-    };
+    });
   }, []);
 };
 //# sourceMappingURL=useUpdateOnHMR.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useState","useUpdateOnHMR","forceUpdate","__DEV__","oldAccept","global","args","prev"],"sourceRoot":"../../../src","sources":["utils/useUpdateOnHMR.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAM3C,OAAO,MAAMC,cAAc,GAAGA,CAAA,KAAM;EAClC,MAAM,GAAGC,WAAW,CAAC,GAAGF,QAAQ,CAAC,CAAC,CAAC;EAEnCD,SAAS,CAAC,MAAM;IACd,IAAI,CAACI,OAAO,EAAE;MACZ;IACF;IAEA,MAAMC,SAAS,GAAGC,MAAM,CAAC,UAAU,CAAC;IACpCA,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAGC,IAAI,KAAK;MAChCJ,WAAW,CAAEK,IAAI,IAAKA,IAAI,GAAG,CAAC,CAAC;MAC/BH,SAAS,GAAG,GAAGE,IAAI,CAAC;IACtB,CAAC;IAED,OAAO,MAAM;MACXD,MAAM,CAAC,UAAU,CAAC,GAAGD,SAAS;IAChC,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;AACR,CAAC","ignoreList":[]}
+{"version":3,"names":["getFastRefreshHub","useEffect","useState","useUpdateOnHMR","forceUpdate","__DEV__","onPatch","prev"],"sourceRoot":"../../../src","sources":["utils/useUpdateOnHMR.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,iBAAiB;AACnD,SAASC,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAE3C,OAAO,MAAMC,cAAc,GAAGA,CAAA,KAAM;EAClC,MAAM,GAAGC,WAAW,CAAC,GAAGF,QAAQ,CAAC,CAAC,CAAC;EAEnCD,SAAS,CAAC,MAAM;IACd,IAAI,CAACI,OAAO,EAAE;MACZ;IACF;IAEA,OAAOL,iBAAiB,CAAC,CAAC,CAACM,OAAO,CAAC,MAAM;MACvCF,WAAW,CAAEG,IAAI,IAAKA,IAAI,GAAG,CAAC,CAAC;IACjC,CAAC,CAAC;EACJ,CAAC,EAAE,EAAE,CAAC;AACR,CAAC","ignoreList":[]}

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

@@ -1,12 +1,21 @@
 "use strict";
 
 import { getNativeVoltra } from '../VoltraModule.js';
+/**
+ * @deprecated Use {@link setWidgetServerUpdate} with an `Authorization` header. This writes the
+ * same stored credentials and keeps the same replace-everything semantics, so migrating is a
+ * one-line change; it will be removed in a future major.
+ */
 export async function setWidgetServerCredentials(credentials) {
   if (!credentials.token) {
     throw new Error('[Voltra][iOS] setWidgetServerCredentials: token is required');
   }
   return getNativeVoltra().setWidgetServerCredentials(credentials);
 }
+
+/**
+ * @deprecated Use {@link clearWidgetServerUpdate} instead.
+ */
 export async function clearWidgetServerCredentials() {
   return getNativeVoltra().clearWidgetServerCredentials();
 }

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

@@ -1 +1 @@
-{"version":3,"names":["getNativeVoltra","setWidgetServerCredentials","credentials","token","Error","clearWidgetServerCredentials"],"sourceRoot":"../../../src","sources":["widgets/server-credentials.ts"],"mappings":";;AACA,SAASA,eAAe,QAAQ,oBAAoB;AAIpD,OAAO,eAAeC,0BAA0BA,CAACC,WAAoC,EAAiB;EACpG,IAAI,CAACA,WAAW,CAACC,KAAK,EAAE;IACtB,MAAM,IAAIC,KAAK,CAAC,6DAA6D,CAAC;EAChF;EAEA,OAAOJ,eAAe,CAAC,CAAC,CAACC,0BAA0B,CAACC,WAAW,CAAC;AAClE;AAEA,OAAO,eAAeG,4BAA4BA,CAAA,EAAkB;EAClE,OAAOL,eAAe,CAAC,CAAC,CAACK,4BAA4B,CAAC,CAAC;AACzD","ignoreList":[]}
+{"version":3,"names":["getNativeVoltra","setWidgetServerCredentials","credentials","token","Error","clearWidgetServerCredentials"],"sourceRoot":"../../../src","sources":["widgets/server-credentials.ts"],"mappings":";;AACA,SAASA,eAAe,QAAQ,oBAAoB;AAIpD;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,0BAA0BA,CAACC,WAAoC,EAAiB;EACpG,IAAI,CAACA,WAAW,CAACC,KAAK,EAAE;IACtB,MAAM,IAAIC,KAAK,CAAC,6DAA6D,CAAC;EAChF;EAEA,OAAOJ,eAAe,CAAC,CAAC,CAACC,0BAA0B,CAACC,WAAW,CAAC;AAClE;;AAEA;AACA;AACA;AACA,OAAO,eAAeG,4BAA4BA,CAAA,EAAkB;EAClE,OAAOL,eAAe,CAAC,CAAC,CAACK,4BAA4B,CAAC,CAAC;AACzD","ignoreList":[]}

package/build/module/widgets/server-update.js

@@ -0,0 +1,72 @@
+"use strict";
+
+import { getNativeVoltra } from '../VoltraModule.js';
+/**
+ * Overrides a server-driven widget's `serverUpdate` settings at runtime.
+ *
+ * The `serverUpdate` entry in app.json supplies the defaults; this replaces any of them for one
+ * widget, or for every server-driven widget when no `widgetId` is given. A widget-scoped call wins
+ * over a global one, and `headers` and `query` merge per key across the two.
+ *
+ * Each call replaces the whole layer it writes, so pass every field you want to keep. Setting
+ * anything reschedules the widgets it affects and fetches once immediately.
+ *
+ * @example Point a widget at the tenant's own backend once the user has logged in.
+ * ```ts
+ * await setWidgetServerUpdate(
+ *   { url: `https://${tenant}.example.com/widgets/portfolio`, headers: { Authorization: `Bearer ${token}` } },
+ *   { widgetId: 'portfolio' }
+ * )
+ * ```
+ *
+ * @example Take a widget over and drive it from the app until you hand it back.
+ * ```ts
+ * await setWidgetServerUpdate({ enabled: false }, { widgetId: 'portfolio' })
+ * await updateDynamicWidget('portfolio', localProps)
+ * ```
+ *
+ * @throws if the widget has no `serverUpdate` in app.json, if the URL is not https (plain http is
+ *   allowed only in a debug build, and only for a local dev host), or if `query` names one of the
+ *   parameters Voltra already sends.
+ */
+export async function setWidgetServerUpdate(settings, options) {
+  return getNativeVoltra().setWidgetServerUpdate(JSON.stringify(settings ?? {}), options?.widgetId ?? null);
+}
+
+/**
+ * Drops the runtime settings for one widget, or the global ones when no `widgetId` is given, so
+ * the widget falls back to what app.json configured.
+ *
+ * Clearing the global settings is the logout gesture: along with the settings it drops what the
+ * server last sent for every server-driven widget, so a Dynamic Widget goes back to `{}` with
+ * `env.serverUpdate.status` of `never` rather than showing the previous account's data. Credentials
+ * set with the deprecated `setWidgetServerCredentials` are stored separately — clear those with
+ * `clearWidgetServerCredentials`.
+ */
+export async function clearWidgetServerUpdate(options) {
+  return getNativeVoltra().clearWidgetServerUpdate(options?.widgetId ?? null);
+}
+
+/**
+ * Reads a widget's `serverUpdate` settings back, without reasoning about what was set where.
+ *
+ * With a `widgetId`, this is the fully resolved settings that widget would fetch with right now:
+ * every layer flattened and app.json's defaults applied — `null` if the widget is not
+ * server-driven. Without one, this is the raw contents of the global layer only — what the last
+ * `setWidgetServerUpdate(settings)` call (with no `widgetId`) wrote, with no defaults applied and
+ * every field optional — `null` if nothing has been set globally.
+ *
+ * @example Check what a widget is about to fetch from.
+ * ```ts
+ * const snapshot = await getWidgetServerUpdate({ widgetId: 'portfolio' })
+ * if (snapshot?.enabled) {
+ *   console.log(`portfolio fetches ${snapshot.url} every ${snapshot.intervalMinutes}m`)
+ * }
+ * ```
+ */
+
+export async function getWidgetServerUpdate(options) {
+  const json = await getNativeVoltra().getWidgetServerUpdate(options?.widgetId ?? null);
+  return json == null ? null : JSON.parse(json);
+}
+//# sourceMappingURL=server-update.js.map

package/build/module/widgets/server-update.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getNativeVoltra","setWidgetServerUpdate","settings","options","JSON","stringify","widgetId","clearWidgetServerUpdate","getWidgetServerUpdate","json","parse"],"sourceRoot":"../../../src","sources":["widgets/server-update.ts"],"mappings":";;AACA,SAASA,eAAe,QAAQ,oBAAoB;AASpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,qBAAqBA,CACzCC,QAAoC,EACpCC,OAAmC,EACpB;EACf,OAAOH,eAAe,CAAC,CAAC,CAACC,qBAAqB,CAACG,IAAI,CAACC,SAAS,CAACH,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAEC,OAAO,EAAEG,QAAQ,IAAI,IAAI,CAAC;AAC3G;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,uBAAuBA,CAACJ,OAAmC,EAAiB;EAChG,OAAOH,eAAe,CAAC,CAAC,CAACO,uBAAuB,CAACJ,OAAO,EAAEG,QAAQ,IAAI,IAAI,CAAC;AAC7E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,OAAO,eAAeE,qBAAqBA,CACzCL,OAAmC,EACsC;EACzE,MAAMM,IAAI,GAAG,MAAMT,eAAe,CAAC,CAAC,CAACQ,qBAAqB,CAACL,OAAO,EAAEG,QAAQ,IAAI,IAAI,CAAC;EACrF,OAAOG,IAAI,IAAI,IAAI,GAAG,IAAI,GAAGL,IAAI,CAACM,KAAK,CAACD,IAAI,CAAC;AAC/C","ignoreList":[]}