@use-voltra/expo-plugin 2.2.0 → 2.3.1

package/build/esm/serverUpdate.js

@@ -0,0 +1,112 @@
+/**
+ * Config rules for `serverUpdate`, shared by the Expo plugins and the `voltra` CLI.
+ *
+ * `serverUpdate` marks a widget as server-driven for both render engines. On a widget with
+ * `entry` the device fetches a JSON object and hands it to the bundled JS as props; without
+ * `entry` the server returns a full Voltra payload. Widgets without `entry` keep exactly the
+ * rules they had before ADR 0002, so no existing config breaks.
+ *
+ * `url` is optional. `serverUpdate: {}` means "server-driven, URL supplied at runtime" through
+ * `setWidgetServerUpdate`, which covers per-tenant backends whose URL is only known after login.
+ *
+ * These helpers report problems instead of throwing so each caller can raise its own error type.
+ *
+ * The `voltra` CLI validates `serverUpdate` from its own copy of this module; keep the two in
+ * sync.
+ */
+/**
+ * Interval floor and default for a widget with `entry`. WorkManager cannot run periodic work
+ * more often than every 15 minutes, and WidgetKit stretches timelines requested closer together
+ * than five minutes, so a smaller number would only mislead.
+ */
+export const DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES = 15;
+/** Hosts allowed over plain `http`, for talking to a dev server from a simulator or emulator. */
+const LOCAL_HTTP_HOSTS = new Set(['localhost', '127.0.0.1', '::1', '10.0.2.2', '10.0.3.2']);
+/**
+ * Resolves the interval a widget should be scheduled on.
+ *
+ * A widget with `entry` is clamped up to {@link DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES}
+ * with a warning, because a shorter interval is not something either platform can honour. A
+ * payload widget keeps the platform's existing rule and is rejected below the floor.
+ */
+export function resolveServerUpdateInterval(options) {
+    const { intervalMinutes, context, hasEntry, defaultIntervalMinutes, minimumIntervalMinutes } = options;
+    const fallback = hasEntry ? DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES : defaultIntervalMinutes;
+    if (intervalMinutes === undefined) {
+        return { kind: 'ok', intervalMinutes: fallback };
+    }
+    if (typeof intervalMinutes !== 'number' || !Number.isFinite(intervalMinutes)) {
+        return { kind: 'invalid', error: `${context}.intervalMinutes must be a number` };
+    }
+    if (!Number.isInteger(intervalMinutes)) {
+        return { kind: 'invalid', error: `${context}.intervalMinutes must be an integer` };
+    }
+    if (hasEntry) {
+        if (intervalMinutes < DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES) {
+            return {
+                kind: 'clamped',
+                intervalMinutes: DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES,
+                warning: `${context}.intervalMinutes is ${intervalMinutes}, below the ` +
+                    `${DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES} minute floor for widgets with an entry. ` +
+                    `Using ${DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES}.`,
+            };
+        }
+        return { kind: 'ok', intervalMinutes };
+    }
+    if (intervalMinutes < minimumIntervalMinutes) {
+        return { kind: 'invalid', error: `${context}.intervalMinutes must be at least ${minimumIntervalMinutes}` };
+    }
+    return { kind: 'ok', intervalMinutes };
+}
+/**
+ * Checks `serverUpdate.url`. An absent URL is fine — the app supplies it at runtime through
+ * `setWidgetServerUpdate`.
+ *
+ * A URL that is not an absolute `http`/`https` URL is rejected: no platform HTTP stack here
+ * accepts one, so such a config could only ever have failed to fetch. Plain `http` to a
+ * non-local host is reported as insecure rather than rejected — App Transport Security and
+ * Android's cleartext policy already block it in a release build, and rejecting it outright
+ * would break configs that point at a LAN dev server.
+ */
+export function resolveServerUpdateUrl(url, context) {
+    if (url === undefined) {
+        return { kind: 'ok' };
+    }
+    if (typeof url !== 'string' || !url.trim()) {
+        return { kind: 'invalid', error: `${context}.url must be a non-empty string` };
+    }
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return { kind: 'invalid', error: `${context}.url must be an absolute http(s) URL, received '${url}'` };
+    }
+    if (parsed.protocol === 'https:') {
+        return { kind: 'ok' };
+    }
+    if (parsed.protocol !== 'http:') {
+        return { kind: 'invalid', error: `${context}.url must be an absolute http(s) URL, received '${url}'` };
+    }
+    if (isLocalHttpHost(parsed.hostname)) {
+        return { kind: 'ok' };
+    }
+    return {
+        kind: 'insecure',
+        warning: `${context}.url uses plain http ('${url}'). Release builds block cleartext traffic, so the ` +
+            'widget will not fetch outside a development build. Use https, or a local dev host ' +
+            `(${[...LOCAL_HTTP_HOSTS].join(', ')}).`,
+    };
+}
+/** True for the hosts Voltra allows over plain `http` — dev servers reachable from a simulator. */
+export function isLocalHttpHost(hostname) {
+    return LOCAL_HTTP_HOSTS.has(hostname.replace(/^\[|\]$/g, ''));
+}
+/** Validates `serverUpdate.refresh`. Returns an error message, or `undefined` when it is fine. */
+export function validateServerUpdateRefresh(refresh, context) {
+    if (refresh !== undefined && typeof refresh !== 'boolean') {
+        return `${context}.refresh must be a boolean`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=serverUpdate.js.map

package/build/esm/serverUpdate.js.map

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

package/build/esm/utils/packageVersion.js

@@ -0,0 +1,13 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createRequire } from 'node:module';
+export function resolveInstalledPackageVersion(projectRoot, packageName) {
+    const projectRequire = createRequire(path.join(projectRoot, 'package.json'));
+    const packageJsonPath = projectRequire.resolve(`${packageName}/package.json`);
+    const manifest = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+    if (typeof manifest.version !== 'string' || manifest.version.length === 0) {
+        throw new Error(`Package ${packageName} does not declare a valid version in ${packageJsonPath}.`);
+    }
+    return manifest.version;
+}
+//# sourceMappingURL=packageVersion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../../../src/utils/packageVersion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAM3C,MAAM,UAAU,8BAA8B,CAAC,WAAmB,EAAE,WAAmB;IACrF,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAA;IAC5E,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,WAAW,eAAe,CAAC,CAAA;IAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAoB,CAAA;IAExF,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,wCAAwC,eAAe,GAAG,CAAC,CAAA;IACnG,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAA;AACzB,CAAC"}

package/build/esm/utils/prerender.js

@@ -1,141 +1,38 @@
-import fs from 'node:fs';
 import path from 'node:path';
-import { createRequire } from 'node:module';
-import vm from 'node:vm';
-import * as babel from '@babel/core';
-import { MODULE_EXTENSIONS } from '../constants';
+import { createWidgetModuleLoader } from '@use-voltra/compiler';
 import { logger } from './logger';
 import { isWidgetLocalizedMap } from './widgetLabel';
-const PRERENDER_PACKAGE_REDIRECTS = {
-    '@use-voltra/ios-client': '@use-voltra/ios',
-    '@use-voltra/android-client': '@use-voltra/android',
-};
 /**
- * Check if a module specifier is a relative or absolute path (local file)
- */
-function isLocalModule(moduleSpecifier) {
-    return moduleSpecifier.startsWith('.') || moduleSpecifier.startsWith('/');
-}
-/**
- * Resolve a module path, trying different extensions
- */
-function resolveModulePath(moduleSpecifier, fromDir) {
-    const basePath = path.resolve(fromDir, moduleSpecifier);
-    for (const ext of MODULE_EXTENSIONS) {
-        const fullPath = basePath + ext;
-        if (fs.existsSync(fullPath) && fs.statSync(fullPath).isFile()) {
-            return fullPath;
-        }
-    }
-    // Try index files if it's a directory
-    if (fs.existsSync(basePath) && fs.statSync(basePath).isDirectory()) {
-        for (const ext of MODULE_EXTENSIONS) {
-            const indexPath = path.join(basePath, 'index' + ext);
-            if (fs.existsSync(indexPath)) {
-                return indexPath;
-            }
-        }
-    }
-    return null;
-}
-function getProjectBabelConfigPath(projectRoot) {
-    const configPath = path.join(projectRoot, 'babel.config.js');
-    return fs.existsSync(configPath) ? configPath : null;
-}
-function getFallbackExpoPreset(projectRoot) {
-    return require.resolve('babel-preset-expo', { paths: [projectRoot] });
-}
-/**
- * Transpile a file with Babel
+ * Create the loader used to evaluate widget source during prebuild.
+ *
+ * Evaluation rules live in `@use-voltra/compiler` so that prebuild, `voltra apply`, and
+ * the Metro widget bundler agree on what widget code may import.
  */
-function transpileFile(filePath, projectRoot) {
-    const code = fs.readFileSync(filePath, 'utf8');
-    const projectBabelConfigPath = getProjectBabelConfigPath(projectRoot);
-    const result = babel.transformSync(code, {
-        cwd: projectRoot,
-        filename: filePath,
-        ...(projectBabelConfigPath
-            ? { configFile: projectBabelConfigPath }
-            : {
-                babelrc: false,
-                configFile: false,
-                presets: [getFallbackExpoPreset(projectRoot)],
-            }),
+export function createPrerenderWidgetModuleLoader(projectRoot, platform) {
+    return createWidgetModuleLoader({
+        projectRoot,
+        platform,
+        onWarning: (message) => logger.warn(message),
     });
-    if (!result || !result.code) {
-        throw new Error(`Babel transpilation failed for ${filePath}`);
-    }
-    return result.code;
+}
+function resolveLoader({ projectRoot, platform, loader }) {
+    return loader ?? createPrerenderWidgetModuleLoader(projectRoot, platform);
 }
 /**
- * Evaluate a widget module using Babel transpilation and Node.js VM.
- * This allows executing widget code that uses JSX and React components.
- * Local module dependencies are also transpiled with the same Babel settings.
+ * Evaluate a widget module and return its exports object.
  *
  * Exported so platform-specific prerender flows can reuse the same module loader rather
- * than duplicating the Babel + VM scaffolding. The returned value is the module's exports
- * object — callers decide whether to read `.default`, a named export, etc.
+ * than duplicating the Babel + VM scaffolding. Callers decide whether to read `.default`,
+ * a named export, etc.
  */
-export function evaluateWidgetModuleExports(projectRoot, filePath, warnedRedirects = new Set()) {
-    // Cache for already-evaluated modules to handle circular dependencies
-    const moduleCache = new Map();
-    const projectRequire = createRequire(path.join(projectRoot, 'package.json'));
-    /**
-     * Custom require that transpiles local modules with Babel
-     */
-    function customRequire(moduleSpecifier, currentDir) {
-        // For non-local modules (npm packages), use native require
-        if (!isLocalModule(moduleSpecifier)) {
-            const redirectedSpecifier = PRERENDER_PACKAGE_REDIRECTS[moduleSpecifier];
-            if (redirectedSpecifier) {
-                if (!warnedRedirects.has(moduleSpecifier)) {
-                    warnedRedirects.add(moduleSpecifier);
-                    logger.warn(`Prerendering initial state imported '${moduleSpecifier}'. Using '${redirectedSpecifier}' instead.`);
-                }
-                return projectRequire(redirectedSpecifier);
-            }
-            return projectRequire(moduleSpecifier);
-        }
-        // Resolve the local module path
-        const resolvedPath = resolveModulePath(moduleSpecifier, currentDir);
-        if (!resolvedPath) {
-            throw new Error(`Cannot resolve module '${moduleSpecifier}' from '${currentDir}'`);
-        }
-        // Return cached module if already evaluated
-        if (moduleCache.has(resolvedPath)) {
-            return moduleCache.get(resolvedPath);
-        }
-        // Transpile and evaluate the module
-        const transpiledCode = transpileFile(resolvedPath, projectRoot);
-        const moduleDir = path.dirname(resolvedPath);
-        const mockModule = { exports: {} };
-        // Create require function bound to the module's directory
-        const boundRequire = (spec) => customRequire(spec, moduleDir);
-        const context = vm.createContext({
-            exports: mockModule.exports,
-            module: mockModule,
-            require: boundRequire,
-            __filename: resolvedPath,
-            __dirname: moduleDir,
-            console: console,
-            process: process,
-        });
-        // Cache before evaluation to handle circular dependencies
-        moduleCache.set(resolvedPath, mockModule.exports);
-        const script = new vm.Script(transpiledCode, { filename: resolvedPath });
-        script.runInContext(context);
-        // Update cache with final exports (in case module.exports was reassigned)
-        moduleCache.set(resolvedPath, mockModule.exports);
-        return mockModule.exports;
-    }
-    return customRequire(filePath, path.dirname(filePath));
+export function evaluateWidgetModuleExports(filePath, options) {
+    return resolveLoader(options).load(filePath);
 }
 /**
  * Evaluate a widget file as a server-style WidgetVariants module and return its object export.
  */
-export function evaluateWidgetModule(projectRoot, filePath, warnedRedirects = new Set()) {
-    const exports = evaluateWidgetModuleExports(projectRoot, filePath, warnedRedirects);
-    const widgetVariants = exports.default || exports;
+export function evaluateWidgetModule(filePath, options) {
+    const widgetVariants = resolveLoader(options).loadDefaultExport(filePath);
     if (!widgetVariants || typeof widgetVariants !== 'object') {
         throw new Error('Widget file must export a WidgetVariants object or have a default export of WidgetVariants');
     }
@@ -151,11 +48,12 @@ export function evaluateWidgetModule(projectRoot, filePath, warnedRedirects = ne
  * @param widgets - Array of widget configurations
  * @param projectRoot - Root directory of the Expo project
  * @param renderer - The renderer function to use (voltra/server or voltra/android/server)
+ * @param platform - Platform being prebuilt
  * @returns Map of widgetId -> (locale key -> prerendered JSON string)
  */
-export async function prerenderWidgetState(widgets, projectRoot, renderer) {
+export async function prerenderWidgetState(widgets, projectRoot, renderer, platform) {
     const prerenderedStates = new Map();
-    const warnedRedirects = new Set();
+    const loader = createPrerenderWidgetModuleLoader(projectRoot, platform);
     for (const widget of widgets) {
         if (!widget.initialStatePath) {
             continue;
@@ -168,7 +66,7 @@ export async function prerenderWidgetState(widgets, projectRoot, renderer) {
         try {
             for (const [localeKey, relativePath] of Object.entries(perLocalePaths)) {
                 const absoluteWidgetPath = path.resolve(projectRoot, relativePath);
-                const widgetVariants = evaluateWidgetModule(projectRoot, absoluteWidgetPath, warnedRedirects);
+                const widgetVariants = evaluateWidgetModule(absoluteWidgetPath, { projectRoot, platform, loader });
                 const prerenderedState = renderer(widgetVariants);
                 inner.set(localeKey, prerenderedState);
             }

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

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

package/build/esm/widgetServerUpdate.js

@@ -0,0 +1,59 @@
+import { resolveServerUpdateInterval, resolveServerUpdateUrl, validateServerUpdateRefresh } from './serverUpdate';
+import { logger } from './utils/logger';
+export function validateWidgetServerUpdate(serverUpdate, widgetId, rules) {
+    if (serverUpdate === undefined) {
+        return;
+    }
+    const context = `Widget '${widgetId}': serverUpdate`;
+    if (typeof serverUpdate !== 'object' || serverUpdate === null || Array.isArray(serverUpdate)) {
+        throw new Error(`${context} must be an object`);
+    }
+    const { url, intervalMinutes, refresh } = serverUpdate;
+    const resolvedUrl = resolveServerUpdateUrl(url, context);
+    if (resolvedUrl.kind === 'invalid') {
+        throw new Error(resolvedUrl.error);
+    }
+    if (resolvedUrl.kind === 'insecure') {
+        logger.warn(resolvedUrl.warning);
+    }
+    const interval = resolveServerUpdateInterval({
+        intervalMinutes,
+        context,
+        hasEntry: rules.hasEntry,
+        defaultIntervalMinutes: rules.defaultIntervalMinutes,
+        minimumIntervalMinutes: rules.minimumIntervalMinutes,
+    });
+    if (interval.kind === 'invalid') {
+        throw new Error(interval.error);
+    }
+    if (interval.kind === 'clamped') {
+        logger.warn(interval.warning);
+    }
+    const refreshError = validateServerUpdateRefresh(refresh, context);
+    if (refreshError) {
+        throw new Error(refreshError);
+    }
+}
+/**
+ * Applies defaults to a validated `serverUpdate`. Generators call this instead of reading
+ * `intervalMinutes` directly, so the value written into a plist or a generated asset is the one
+ * the widget will actually be scheduled on.
+ */
+export function resolveWidgetServerUpdate(serverUpdate, rules) {
+    const interval = resolveServerUpdateInterval({
+        intervalMinutes: serverUpdate.intervalMinutes,
+        context: 'serverUpdate',
+        hasEntry: rules.hasEntry,
+        defaultIntervalMinutes: rules.defaultIntervalMinutes,
+        minimumIntervalMinutes: rules.minimumIntervalMinutes,
+    });
+    return {
+        url: serverUpdate.url,
+        // An invalid interval cannot reach here — validateWidgetServerUpdate throws on it first — but
+        // if the two are ever called out of order, falling back to the platform's own default is less
+        // surprising than silently switching a payload widget to the Dynamic one.
+        intervalMinutes: interval.kind === 'invalid' ? rules.defaultIntervalMinutes : interval.intervalMinutes,
+        refresh: serverUpdate.refresh === true,
+    };
+}
+//# sourceMappingURL=widgetServerUpdate.js.map

package/build/esm/widgetServerUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgetServerUpdate.js","sourceRoot":"","sources":["../../src/widgetServerUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AACjH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAgCvC,MAAM,UAAU,0BAA0B,CACxC,YAAqB,EACrB,QAAgB,EAChB,KAA8B;IAE9B,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAM;IACR,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,QAAQ,iBAAiB,CAAA;IAEpD,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7F,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,oBAAoB,CAAC,CAAA;IACjD,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,YAAwC,CAAA;IAElF,MAAM,WAAW,GAAG,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAExD,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,MAAM,QAAQ,GAAG,2BAA2B,CAAC;QAC3C,eAAe;QACf,OAAO;QACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;QACpD,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;KACrD,CAAC,CAAA;IAEF,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACjC,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;IAED,MAAM,YAAY,GAAG,2BAA2B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAElE,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;IAC/B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,YAAsC,EACtC,KAA8B;IAE9B,MAAM,QAAQ,GAAG,2BAA2B,CAAC;QAC3C,eAAe,EAAE,YAAY,CAAC,eAAe;QAC7C,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;QACpD,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;KACrD,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,EAAE,YAAY,CAAC,GAAG;QACrB,8FAA8F;QAC9F,8FAA8F;QAC9F,0EAA0E;QAC1E,eAAe,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe;QACtG,OAAO,EAAE,YAAY,CAAC,OAAO,KAAK,IAAI;KACvC,CAAA;AACH,CAAC"}

package/build/types/constants.d.ts

@@ -1,5 +1,3 @@
-/** Extensions to try when resolving module paths for pre-rendering */
-export declare const MODULE_EXTENSIONS: string[];
 /** Maximum image size in bytes for widget / Live Activity assets (4KB limit) */
 export declare const MAX_IMAGE_SIZE_BYTES = 4096;
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,UAAqC,CAAA;AAEnE,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,OAAO,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,OAAO,CAAA"}

package/build/types/dynamic-live-activity.d.ts

@@ -0,0 +1,2 @@
+export { getDynamicLiveActivityAttributesType } from '@use-voltra/core/dynamic-live-activity';
+//# sourceMappingURL=dynamic-live-activity.d.ts.map

package/build/types/dynamic-live-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-live-activity.d.ts","sourceRoot":"","sources":["../../src/dynamic-live-activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAA"}

package/build/types/index.d.ts

@@ -1,11 +1,18 @@
-export { MAX_IMAGE_SIZE_BYTES, MODULE_EXTENSIONS } from './constants';
-export type { DynamicWidgetEntryConfig, DynamicWidgetManifest, DynamicWidgetManifestWidget, DynamicWidgetPlatform, WidgetInitialStatePath, WidgetLabel, WidgetLocalizedCopy, } from './types';
+export { MAX_IMAGE_SIZE_BYTES } from './constants';
+export { getDynamicLiveActivityAttributesType } from './dynamic-live-activity';
+export type { DynamicWidgetEntryConfig, DynamicLiveActivityEntryConfig, DynamicLiveActivityManifest, DynamicLiveActivityManifestDefinition, DynamicWidgetManifest, DynamicWidgetManifestWidget, DynamicWidgetPlatform, WidgetInitialStatePath, WidgetLabel, WidgetLocalizedCopy, } from './types';
+export type { ServerUpdateIntervalResolution, ServerUpdateUrlResolution } from './serverUpdate';
+export { DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES, isLocalHttpHost, resolveServerUpdateInterval, resolveServerUpdateUrl, validateServerUpdateRefresh, } from './serverUpdate';
+export type { ResolvedWidgetServerUpdateConfig, WidgetServerUpdateConfig, WidgetServerUpdateRules, } from './widgetServerUpdate';
+export { resolveWidgetServerUpdate, validateWidgetServerUpdate } from './widgetServerUpdate';
 export { assertValidLocaleKey, normalizeWidgetEntryPath, validateHomeScreenWidgetId, validateInitialStatePath, validateWidgetEntry, validateWidgetLabel, } from './validation';
 export { addApplicationGroupsEntitlement } from './utils/entitlements';
 export { resolveFontPaths } from './utils/fonts';
 export { normalizeLocaleTag, pickLocalizedValue } from './utils/localePick';
 export { logger } from './utils/logger';
-export type { PrerenderableWidget, PrerenderedWidgetStates, WidgetRenderer } from './utils/prerender';
-export { evaluateWidgetModule, evaluateWidgetModuleExports, prerenderWidgetState } from './utils/prerender';
+export { resolveInstalledPackageVersion } from './utils/packageVersion';
+export type { PrerenderableWidget, PrerenderedWidgetStates, WidgetModuleEvaluationOptions, WidgetRenderer, } from './utils/prerender';
+export { createPrerenderWidgetModuleLoader, evaluateWidgetModule, evaluateWidgetModuleExports, prerenderWidgetState, } from './utils/prerender';
+export type { WidgetModuleLoader, WidgetModulePlatform } from '@use-voltra/compiler';
 export { isWidgetLocalizedMap, widgetLabelEnglish } from './utils/widgetLabel';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACrE,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACrG,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC3G,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAA;AAC9E,YAAY,EACV,wBAAwB,EACxB,8BAA8B,EAC9B,2BAA2B,EAC3B,qCAAqC,EACrC,qBAAqB,EACrB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAA;AAC/F,OAAO,EACL,6CAA6C,EAC7C,eAAe,EACf,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,gCAAgC,EAChC,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AAC5F,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAA;AACvE,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,EAC7B,cAAc,GACf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,iCAAiC,EACjC,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AACpF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA"}

package/build/types/serverUpdate.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Config rules for `serverUpdate`, shared by the Expo plugins and the `voltra` CLI.
+ *
+ * `serverUpdate` marks a widget as server-driven for both render engines. On a widget with
+ * `entry` the device fetches a JSON object and hands it to the bundled JS as props; without
+ * `entry` the server returns a full Voltra payload. Widgets without `entry` keep exactly the
+ * rules they had before ADR 0002, so no existing config breaks.
+ *
+ * `url` is optional. `serverUpdate: {}` means "server-driven, URL supplied at runtime" through
+ * `setWidgetServerUpdate`, which covers per-tenant backends whose URL is only known after login.
+ *
+ * These helpers report problems instead of throwing so each caller can raise its own error type.
+ *
+ * The `voltra` CLI validates `serverUpdate` from its own copy of this module; keep the two in
+ * sync.
+ */
+/**
+ * Interval floor and default for a widget with `entry`. WorkManager cannot run periodic work
+ * more often than every 15 minutes, and WidgetKit stretches timelines requested closer together
+ * than five minutes, so a smaller number would only mislead.
+ */
+export declare const DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES = 15;
+/** Outcome of resolving `serverUpdate.intervalMinutes` against a platform's floor. */
+export type ServerUpdateIntervalResolution = {
+    kind: 'ok';
+    intervalMinutes: number;
+} | {
+    kind: 'clamped';
+    intervalMinutes: number;
+    warning: string;
+} | {
+    kind: 'invalid';
+    error: string;
+};
+export interface ResolveServerUpdateIntervalOptions {
+    /** Raw `intervalMinutes` from app.json, if the widget set one. */
+    intervalMinutes: unknown;
+    /** Config path used in messages, e.g. `android.widgets[portfolio].serverUpdate`. */
+    context: string;
+    /** True when the widget has an `entry` and therefore renders on device. */
+    hasEntry: boolean;
+    /** Interval used when the widget does not set one. Ignored for widgets with `entry`. */
+    defaultIntervalMinutes: number;
+    /** Platform floor for payload widgets. Ignored for widgets with `entry`. */
+    minimumIntervalMinutes: number;
+}
+/**
+ * Resolves the interval a widget should be scheduled on.
+ *
+ * A widget with `entry` is clamped up to {@link DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES}
+ * with a warning, because a shorter interval is not something either platform can honour. A
+ * payload widget keeps the platform's existing rule and is rejected below the floor.
+ */
+export declare function resolveServerUpdateInterval(options: ResolveServerUpdateIntervalOptions): ServerUpdateIntervalResolution;
+/** Outcome of checking `serverUpdate.url`. */
+export type ServerUpdateUrlResolution = {
+    kind: 'ok';
+} | {
+    kind: 'insecure';
+    warning: string;
+} | {
+    kind: 'invalid';
+    error: string;
+};
+/**
+ * Checks `serverUpdate.url`. An absent URL is fine — the app supplies it at runtime through
+ * `setWidgetServerUpdate`.
+ *
+ * A URL that is not an absolute `http`/`https` URL is rejected: no platform HTTP stack here
+ * accepts one, so such a config could only ever have failed to fetch. Plain `http` to a
+ * non-local host is reported as insecure rather than rejected — App Transport Security and
+ * Android's cleartext policy already block it in a release build, and rejecting it outright
+ * would break configs that point at a LAN dev server.
+ */
+export declare function resolveServerUpdateUrl(url: unknown, context: string): ServerUpdateUrlResolution;
+/** True for the hosts Voltra allows over plain `http` — dev servers reachable from a simulator. */
+export declare function isLocalHttpHost(hostname: string): boolean;
+/** Validates `serverUpdate.refresh`. Returns an error message, or `undefined` when it is fine. */
+export declare function validateServerUpdateRefresh(refresh: unknown, context: string): string | undefined;
+//# sourceMappingURL=serverUpdate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serverUpdate.d.ts","sourceRoot":"","sources":["../../src/serverUpdate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,eAAO,MAAM,6CAA6C,KAAK,CAAA;AAK/D,sFAAsF;AACtF,MAAM,MAAM,8BAA8B,GACtC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtC,MAAM,WAAW,kCAAkC;IACjD,kEAAkE;IAClE,eAAe,EAAE,OAAO,CAAA;IACxB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAA;IACf,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAA;IACjB,wFAAwF;IACxF,sBAAsB,EAAE,MAAM,CAAA;IAC9B,4EAA4E;IAC5E,sBAAsB,EAAE,MAAM,CAAA;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kCAAkC,GAC1C,8BAA8B,CAoChC;AAED,8CAA8C;AAC9C,MAAM,MAAM,yBAAyB,GACjC;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtC;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,yBAAyB,CAoC/F;AAED,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,kGAAkG;AAClG,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMjG"}

package/build/types/types.d.ts

@@ -21,6 +21,28 @@ export interface DynamicWidgetManifest {
     platform: DynamicWidgetPlatform;
     widgets: DynamicWidgetManifestWidget[];
 }
+/**
+ * Generated by the iOS config plugin for Metro's Dynamic Live Activity pipeline.
+ * This intentionally does not share the Dynamic Widget manifest: an ID may exist in
+ * both collections and each collection has a separate runtime and bundle namespace.
+ */
+export interface DynamicLiveActivityManifestDefinition {
+    id: string;
+    entry: string;
+}
+export interface DynamicLiveActivityManifest {
+    version: 1;
+    platform: 'ios';
+    liveActivities: DynamicLiveActivityManifestDefinition[];
+}
+/**
+ * Shared app.json entry contract for Dynamic Live Activities.
+ * @experimental
+ */
+export interface DynamicLiveActivityEntryConfig {
+    id: string;
+    entry: string;
+}
 /**
  * Per-locale strings for widget picker/gallery labels (`displayName`, `description`).
  * Keys should be BCP-47-style locale tags (e.g. `en`, `pl`, `pt-BR`). Plain `string` is still allowed for a single-language setup.

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,SAAS,CAAA;AAErD;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,CAAA;IACV,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,OAAO,EAAE,2BAA2B,EAAE,CAAA;CACvC;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAExD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,mBAAmB,CAAA;AAEtD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,mBAAmB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,SAAS,CAAA;AAErD;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,CAAA;IACV,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,OAAO,EAAE,2BAA2B,EAAE,CAAA;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,qCAAqC;IACpD,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,CAAC,CAAA;IACV,QAAQ,EAAE,KAAK,CAAA;IACf,cAAc,EAAE,qCAAqC,EAAE,CAAA;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAExD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,mBAAmB,CAAA;AAEtD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,mBAAmB,CAAA"}

package/build/types/utils/packageVersion.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveInstalledPackageVersion(projectRoot: string, packageName: string): string;
+//# sourceMappingURL=packageVersion.d.ts.map

package/build/types/utils/packageVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageVersion.d.ts","sourceRoot":"","sources":["../../../src/utils/packageVersion.ts"],"names":[],"mappings":"AAQA,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAU/F"}