@axonpack/preview 0.0.0-stage → 0.1.0

package/build/stores/previews/previews.store.js

@@ -0,0 +1,134 @@
+import { useSyncExternalStore } from "react";
+import { currentPlatform, resolveBuildKey, } from "../../utils/config/config.util";
+import { downloadPreview } from "../../services/previews/download.service";
+import { deleteLocalPreview, listLocalPreviews, } from "../../services/previews/local-previews.service";
+import { nativeModule, selectedPreviewId, } from "../../services/native/native.service";
+import { previewBundlePath } from "../../services/previews/select.service";
+import { fetchPreviews } from "../../services/previews/remote.service";
+let state = {
+    loading: false,
+    error: null,
+    buildKey: null,
+    remote: null,
+    local: [],
+    downloading: {},
+    activeId: null,
+    broken: [],
+};
+const listeners = new Set();
+const set = (patch) => {
+    state = { ...state, ...patch };
+    listeners.forEach((listener) => listener());
+};
+const readLocal = async () => {
+    const platform = currentPlatform();
+    const nativeState = nativeModule()?.state() ?? {};
+    set({
+        local: platform ? await listLocalPreviews(platform) : [],
+        activeId: selectedPreviewId(nativeState),
+        broken: nativeState.broken ?? [],
+    });
+};
+const message = (error) => error instanceof Error ? error.message : String(error);
+export const previewsStore = {
+    getState: () => state,
+    subscribe(listener) {
+        listeners.add(listener);
+        return () => listeners.delete(listener);
+    },
+    /** Reads the downloads on the device, then asks the bucket for this build's list. */
+    async refresh(config) {
+        set({
+            loading: true,
+            error: null,
+            buildKey: resolveBuildKey(config),
+        });
+        try {
+            await readLocal();
+            const index = await fetchPreviews(config);
+            set({ remote: index.previews, loading: false });
+        }
+        catch (error) {
+            set({ loading: false, error: message(error) });
+        }
+    },
+    async download(config, id) {
+        const entry = state.remote?.find((p) => p.id === id);
+        if (!entry || id in state.downloading)
+            return;
+        set({ downloading: { ...state.downloading, [id]: 0 }, error: null });
+        try {
+            await downloadPreview(config, entry, ({ bytes, totalBytes }) => set({
+                downloading: {
+                    ...state.downloading,
+                    [id]: totalBytes ? bytes / totalBytes : 0,
+                },
+            }));
+        }
+        catch (error) {
+            set({ error: message(error) });
+        }
+        finally {
+            const { [id]: _, ...rest } = state.downloading;
+            set({ downloading: rest });
+            await readLocal();
+        }
+    },
+    /**
+     * Restarts into a preview, downloading it first when it is not on the device, or into the base
+     * bundle with null. A preview with an update keeps its downloaded copy until QA updates it.
+     */
+    async switchTo(config, id) {
+        const native = nativeModule();
+        const platform = currentPlatform();
+        if (!native || !platform)
+            return;
+        if (id !== null &&
+            !state.local.some((p) => p.id === id && p.key === state.buildKey)) {
+            await previewsStore.download(config, id);
+            if (!state.local.some((p) => p.id === id))
+                return;
+        }
+        const local = state.local.find((p) => p.id === id);
+        // A native side older than this JS (an app not rebuilt since the package changed) throws here.
+        // The list shows the reason instead of the button silently doing nothing.
+        try {
+            // "Back to base" also stops a local Metro server, so it always means the default.
+            if (id === null && typeof native.selectLocalServer === "function") {
+                native.selectLocalServer(null, null);
+            }
+            native.select(id === null ? null : previewBundlePath(id), local?.key ?? null);
+            native.reload();
+        }
+        catch (error) {
+            set({ error: message(error) });
+        }
+    },
+    /** Deletes a download. If it is the one running, the app goes back to the base bundle first. */
+    async remove(id) {
+        const platform = currentPlatform();
+        if (!platform)
+            return;
+        const native = nativeModule();
+        try {
+            if (state.activeId === id && native) {
+                native.select(null, null);
+                native.reload();
+            }
+            deleteLocalPreview(id, platform);
+        }
+        catch (error) {
+            set({ error: message(error) });
+        }
+        await readLocal();
+    },
+    /** Deletes every download made for another native build. */
+    async removeIncompatible() {
+        for (const preview of state.local) {
+            if (preview.key !== state.buildKey)
+                await previewsStore.remove(preview.id);
+        }
+    },
+};
+export const usePreviewsState = () => useSyncExternalStore(previewsStore.subscribe, previewsStore.getState);
+//# sourceMappingURL=previews.store.js.map

package/build/stores/previews/previews.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previews.store.js","sourceRoot":"","sources":["../../../src/stores/previews/previews.store.ts"],"names":[],"mappings":"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","sourcesContent":["import { useSyncExternalStore } from \"react\";\n\nimport {\n  PreviewConfig,\n  currentPlatform,\n  resolveBuildKey,\n} from \"../../utils/config/config.util\";\nimport type { IndexEntry } from \"../../utils/previews/layout.util\";\nimport { downloadPreview } from \"../../services/previews/download.service\";\nimport {\n  LocalPreview,\n  deleteLocalPreview,\n  listLocalPreviews,\n} from \"../../services/previews/local-previews.service\";\nimport {\n  nativeModule,\n  selectedPreviewId,\n} from \"../../services/native/native.service\";\nimport { previewBundlePath } from \"../../services/previews/select.service\";\nimport { fetchPreviews } from \"../../services/previews/remote.service\";\n\nexport type PreviewsState = {\n  loading: boolean;\n  error: string | null;\n  /** This build's key; downloads made for any other are incompatible. */\n  buildKey: string | null;\n  /** What the bucket lists for this build. Null until it has answered once. */\n  remote: IndexEntry[] | null;\n  local: LocalPreview[];\n  /** Download progress by id, from 0 to 1. */\n  downloading: Record<string, number>;\n  /** The preview the next start loads, or null for the base bundle. */\n  activeId: string | null;\n  /** Previews that stopped before they finished starting, so the base bundle loaded instead. */\n  broken: string[];\n};\n\nlet state: PreviewsState = {\n  loading: false,\n  error: null,\n  buildKey: null,\n  remote: null,\n  local: [],\n  downloading: {},\n  activeId: null,\n  broken: [],\n};\nconst listeners = new Set<() => void>();\n\nconst set = (patch: Partial<PreviewsState>) => {\n  state = { ...state, ...patch };\n  listeners.forEach((listener) => listener());\n};\n\nconst readLocal = async () => {\n  const platform = currentPlatform();\n  const nativeState = nativeModule()?.state() ?? {};\n  set({\n    local: platform ? await listLocalPreviews(platform) : [],\n    activeId: selectedPreviewId(nativeState),\n    broken: nativeState.broken ?? [],\n  });\n};\n\nconst message = (error: unknown) =>\n  error instanceof Error ? error.message : String(error);\n\nexport const previewsStore = {\n  getState: () => state,\n  subscribe(listener: () => void) {\n    listeners.add(listener);\n    return () => listeners.delete(listener);\n  },\n\n  /** Reads the downloads on the device, then asks the bucket for this build's list. */\n  async refresh(config: PreviewConfig) {\n    set({\n      loading: true,\n      error: null,\n      buildKey: resolveBuildKey(config),\n    });\n    try {\n      await readLocal();\n      const index = await fetchPreviews(config);\n      set({ remote: index.previews, loading: false });\n    } catch (error) {\n      set({ loading: false, error: message(error) });\n    }\n  },\n\n  async download(config: PreviewConfig, id: string) {\n    const entry = state.remote?.find((p) => p.id === id);\n    if (!entry || id in state.downloading) return;\n    set({ downloading: { ...state.downloading, [id]: 0 }, error: null });\n    try {\n      await downloadPreview(config, entry, ({ bytes, totalBytes }) =>\n        set({\n          downloading: {\n            ...state.downloading,\n            [id]: totalBytes ? bytes / totalBytes : 0,\n          },\n        }),\n      );\n    } catch (error) {\n      set({ error: message(error) });\n    } finally {\n      const { [id]: _, ...rest } = state.downloading;\n      set({ downloading: rest });\n      await readLocal();\n    }\n  },\n\n  /**\n   * Restarts into a preview, downloading it first when it is not on the device, or into the base\n   * bundle with null. A preview with an update keeps its downloaded copy until QA updates it.\n   */\n  async switchTo(config: PreviewConfig, id: string | null) {\n    const native = nativeModule();\n    const platform = currentPlatform();\n    if (!native || !platform) return;\n    if (\n      id !== null &&\n      !state.local.some((p) => p.id === id && p.key === state.buildKey)\n    ) {\n      await previewsStore.download(config, id);\n      if (!state.local.some((p) => p.id === id)) return;\n    }\n    const local = state.local.find((p) => p.id === id);\n    // A native side older than this JS (an app not rebuilt since the package changed) throws here.\n    // The list shows the reason instead of the button silently doing nothing.\n    try {\n      // \"Back to base\" also stops a local Metro server, so it always means the default.\n      if (id === null && typeof native.selectLocalServer === \"function\") {\n        native.selectLocalServer(null, null);\n      }\n      native.select(\n        id === null ? null : previewBundlePath(id),\n        local?.key ?? null,\n      );\n      native.reload();\n    } catch (error) {\n      set({ error: message(error) });\n    }\n  },\n\n  /** Deletes a download. If it is the one running, the app goes back to the base bundle first. */\n  async remove(id: string) {\n    const platform = currentPlatform();\n    if (!platform) return;\n    const native = nativeModule();\n    try {\n      if (state.activeId === id && native) {\n        native.select(null, null);\n        native.reload();\n      }\n      deleteLocalPreview(id, platform);\n    } catch (error) {\n      set({ error: message(error) });\n    }\n    await readLocal();\n  },\n\n  /** Deletes every download made for another native build. */\n  async removeIncompatible() {\n    for (const preview of state.local) {\n      if (preview.key !== state.buildKey)\n        await previewsStore.remove(preview.id);\n    }\n  },\n};\n\nexport const usePreviewsState = () =>\n  useSyncExternalStore(previewsStore.subscribe, previewsStore.getState);\n"]}

package/build/utils/config/config.util.d.ts

@@ -0,0 +1,39 @@
+import type { Platform } from "../previews/layout.util";
+import { S3Config } from "../../services/s3/s3.service";
+/**
+ * What the app passes in. It mirrors the publish side's `.env`: the same bucket URL, plus a
+ * read-only key when the bucket is private. Nothing here is read from the environment; the app
+ * decides where each value comes from.
+ */
+export type PreviewConfig = {
+    /** Previews are on only when this is true. The app decides per build; nothing is detected. */
+    enabled: boolean;
+    /**
+     * Where the previews are. With a read key: `<endpoint>/<bucket>[/<folder>]`, the same value as
+     * `PREVIEW_S3_URL` when publishing. Without one, any address the objects are public under:
+     * that same URL for a public bucket, or R2's `https://pub-<id>.r2.dev` or a CDN.
+     */
+    url: string;
+    /** Read-only key, for a private bucket. Leave out for a public one. Never the write key. */
+    readAccessKeyId?: string;
+    readSecretAccessKey?: string;
+    /** Signing region. Default us-east-1, which MinIO and R2 accept. */
+    region?: string;
+    /**
+     * Lists the Metro servers for this app running on the developer's computer, and switches
+     * between them live. Debug builds only; off unless `enabled` is true.
+     */
+    devPreviewServers?: boolean;
+    /** Extra headers on every read, for a proxy, CDN or tunnel in front of the bucket. */
+    headers?: Record<string, string>;
+    /**
+     * This build's key (`version-<app version>` or `fingerprint-<hash>`), only when the config plugin
+     * is not used to bake it in.
+     */
+    buildKey?: string;
+};
+export declare function toS3Config(config: PreviewConfig): S3Config;
+export declare const currentPlatform: () => Platform | null;
+/** The build to ask previews for. Null means previews cannot be listed on this build. */
+export declare const resolveBuildKey: (config: PreviewConfig) => string | null;
+//# sourceMappingURL=config.util.d.ts.map

package/build/utils/config/config.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.util.d.ts","sourceRoot":"","sources":["../../../src/utils/config/config.util.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAEL,QAAQ,EAET,MAAM,8BAA8B,CAAC;AAEtC;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,8FAA8F;IAC9F,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,4FAA4F;IAC5F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,CAgB1D;AAED,eAAO,MAAM,eAAe,QAAO,QAAQ,GAAG,IACiC,CAAC;AAEhF,yFAAyF;AACzF,eAAO,MAAM,eAAe,GAAI,QAAQ,aAAa,KAAG,MAAM,GAAG,IAClC,CAAC"}

package/build/utils/config/config.util.js

@@ -0,0 +1,24 @@
+import { Platform as RNPlatform } from "react-native";
+import { buildKey } from "../../services/native/build-info.service";
+import { DEFAULT_REGION, parseBucketUrl, } from "../../services/s3/s3.service";
+export function toS3Config(config) {
+    const region = config.region ?? DEFAULT_REGION;
+    const { headers } = config;
+    // Signing needs the bucket apart from the endpoint; a plain read only needs the base address.
+    if (config.readAccessKeyId && config.readSecretAccessKey) {
+        return {
+            ...parseBucketUrl(config.url),
+            region,
+            credentials: {
+                accessKeyId: config.readAccessKeyId,
+                secretAccessKey: config.readSecretAccessKey,
+            },
+            headers,
+        };
+    }
+    return { endpoint: config.url.trim(), region, headers };
+}
+export const currentPlatform = () => RNPlatform.OS === "android" || RNPlatform.OS === "ios" ? RNPlatform.OS : null;
+/** The build to ask previews for. Null means previews cannot be listed on this build. */
+export const resolveBuildKey = (config) => config.buildKey ?? buildKey();
+//# sourceMappingURL=config.util.js.map

package/build/utils/config/config.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.util.js","sourceRoot":"","sources":["../../../src/utils/config/config.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAEpE,OAAO,EACL,cAAc,EAEd,cAAc,GACf,MAAM,8BAA8B,CAAC;AAmCtC,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC;IAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC3B,8FAA8F;IAC9F,IAAI,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;QACzD,OAAO;YACL,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC;YAC7B,MAAM;YACN,WAAW,EAAE;gBACX,WAAW,EAAE,MAAM,CAAC,eAAe;gBACnC,eAAe,EAAE,MAAM,CAAC,mBAAmB;aAC5C;YACD,OAAO;SACR,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,GAAoB,EAAE,CACnD,UAAU,CAAC,EAAE,KAAK,SAAS,IAAI,UAAU,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAEhF,yFAAyF;AACzF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAqB,EAAiB,EAAE,CACtE,MAAM,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC","sourcesContent":["import { Platform as RNPlatform } from \"react-native\";\n\nimport { buildKey } from \"../../services/native/build-info.service\";\nimport type { Platform } from \"../previews/layout.util\";\nimport {\n  DEFAULT_REGION,\n  S3Config,\n  parseBucketUrl,\n} from \"../../services/s3/s3.service\";\n\n/**\n * What the app passes in. It mirrors the publish side's `.env`: the same bucket URL, plus a\n * read-only key when the bucket is private. Nothing here is read from the environment; the app\n * decides where each value comes from.\n */\nexport type PreviewConfig = {\n  /** Previews are on only when this is true. The app decides per build; nothing is detected. */\n  enabled: boolean;\n  /**\n   * Where the previews are. With a read key: `<endpoint>/<bucket>[/<folder>]`, the same value as\n   * `PREVIEW_S3_URL` when publishing. Without one, any address the objects are public under:\n   * that same URL for a public bucket, or R2's `https://pub-<id>.r2.dev` or a CDN.\n   */\n  url: string;\n  /** Read-only key, for a private bucket. Leave out for a public one. Never the write key. */\n  readAccessKeyId?: string;\n  readSecretAccessKey?: string;\n  /** Signing region. Default us-east-1, which MinIO and R2 accept. */\n  region?: string;\n  /**\n   * Lists the Metro servers for this app running on the developer's computer, and switches\n   * between them live. Debug builds only; off unless `enabled` is true.\n   */\n  devPreviewServers?: boolean;\n  /** Extra headers on every read, for a proxy, CDN or tunnel in front of the bucket. */\n  headers?: Record<string, string>;\n  /**\n   * This build's key (`version-<app version>` or `fingerprint-<hash>`), only when the config plugin\n   * is not used to bake it in.\n   */\n  buildKey?: string;\n};\n\nexport function toS3Config(config: PreviewConfig): S3Config {\n  const region = config.region ?? DEFAULT_REGION;\n  const { headers } = config;\n  // Signing needs the bucket apart from the endpoint; a plain read only needs the base address.\n  if (config.readAccessKeyId && config.readSecretAccessKey) {\n    return {\n      ...parseBucketUrl(config.url),\n      region,\n      credentials: {\n        accessKeyId: config.readAccessKeyId,\n        secretAccessKey: config.readSecretAccessKey,\n      },\n      headers,\n    };\n  }\n  return { endpoint: config.url.trim(), region, headers };\n}\n\nexport const currentPlatform = (): Platform | null =>\n  RNPlatform.OS === \"android\" || RNPlatform.OS === \"ios\" ? RNPlatform.OS : null;\n\n/** The build to ask previews for. Null means previews cannot be listed on this build. */\nexport const resolveBuildKey = (config: PreviewConfig): string | null =>\n  config.buildKey ?? buildKey();\n"]}

package/build/utils/config/expo-config.util.d.ts

@@ -0,0 +1,30 @@
+import { Compatibility, Platform } from "../previews/layout.util";
+/** The parts of an Expo app config this package reads. */
+export type AppConfig = {
+    version?: string;
+    plugins?: (string | [string, unknown?])[];
+    ios?: {
+        version?: string;
+        buildNumber?: string;
+    };
+    android?: {
+        version?: string;
+        versionCode?: number;
+    };
+};
+export declare const PLUGIN_NAME = "@axonpack/preview";
+/** The `compatibility` option of the plugin entry in the app config, or the default. */
+export declare function compatibilityOf(config: AppConfig): Compatibility;
+/** The app version a platform's build reports: its own `version` when set, else `expo.version`. */
+export declare const appVersionOf: (config: AppConfig, platform: Platform) => string;
+export declare const buildNumberOf: (config: AppConfig, platform: Platform) => string;
+/**
+ * The setting to publish with: the app config's, unless `--compatibility` overrides it. The
+ * warnings say when the two disagree (the build would not see the previews) and what appVersion
+ * mode cannot catch.
+ */
+export declare function resolveCompatibility(fromApp: Compatibility, flag: string | undefined): {
+    compatibility: Compatibility;
+    warnings: string[];
+};
+//# sourceMappingURL=expo-config.util.d.ts.map

package/build/utils/config/expo-config.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo-config.util.d.ts","sourceRoot":"","sources":["../../../src/utils/config/expo-config.util.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,QAAQ,EAET,MAAM,yBAAyB,CAAC;AAEjC,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,GAAG,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD,CAAC;AAEF,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAehE;AAED,mGAAmG;AACnG,eAAO,MAAM,YAAY,GAAI,QAAQ,SAAS,EAAE,UAAU,QAAQ,KAAG,MACV,CAAC;AAE5D,eAAO,MAAM,aAAa,GAAI,QAAQ,SAAS,EAAE,UAAU,QAAQ,KAAG,MAKnE,CAAC;AAEJ;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB;IAAE,aAAa,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAmBtD"}

package/build/utils/config/expo-config.util.js

@@ -0,0 +1,43 @@
+import { DEFAULT_COMPATIBILITY, isCompatibility, } from "../previews/layout.util";
+export const PLUGIN_NAME = "@axonpack/preview";
+/** The `compatibility` option of the plugin entry in the app config, or the default. */
+export function compatibilityOf(config) {
+    for (const plugin of config.plugins ?? []) {
+        if (Array.isArray(plugin) && plugin[0] === PLUGIN_NAME) {
+            const option = plugin[1]
+                ?.compatibility;
+            if (option === undefined)
+                break;
+            if (!isCompatibility(option)) {
+                throw new Error(`${PLUGIN_NAME}: compatibility must be "appVersion" or "fingerprint"`);
+            }
+            return option;
+        }
+    }
+    return DEFAULT_COMPATIBILITY;
+}
+/** The app version a platform's build reports: its own `version` when set, else `expo.version`. */
+export const appVersionOf = (config, platform) => String(config[platform]?.version ?? config.version ?? "");
+export const buildNumberOf = (config, platform) => String((platform === "ios"
+    ? config.ios?.buildNumber
+    : config.android?.versionCode) ?? "");
+/**
+ * The setting to publish with: the app config's, unless `--compatibility` overrides it. The
+ * warnings say when the two disagree (the build would not see the previews) and what appVersion
+ * mode cannot catch.
+ */
+export function resolveCompatibility(fromApp, flag) {
+    if (flag !== undefined && !isCompatibility(flag)) {
+        throw new Error(`--compatibility must be appVersion or fingerprint, not ${flag}`);
+    }
+    const compatibility = flag ?? fromApp;
+    const warnings = [];
+    if (compatibility !== fromApp) {
+        warnings.push(`--compatibility ${compatibility} differs from the app config (${fromApp}), so a build of this app will not list this preview.`);
+    }
+    if (compatibility === "appVersion") {
+        warnings.push("Matched by app version: a native change without a version bump is not detected. Bump the version after native changes, or use fingerprint.");
+    }
+    return { compatibility, warnings };
+}
+//# sourceMappingURL=expo-config.util.js.map

package/build/utils/config/expo-config.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo-config.util.js","sourceRoot":"","sources":["../../../src/utils/config/expo-config.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,qBAAqB,EAErB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAUjC,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAE/C,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC;YACvD,MAAM,MAAM,GAAI,MAAM,CAAC,CAAC,CAA6C;gBACnE,EAAE,aAAa,CAAC;YAClB,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM;YAChC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CACb,GAAG,WAAW,uDAAuD,CACtE,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAiB,EAAE,QAAkB,EAAU,EAAE,CAC5E,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAiB,EAAE,QAAkB,EAAU,EAAE,CAC7E,MAAM,CACJ,CAAC,QAAQ,KAAK,KAAK;IACjB,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,WAAW;IACzB,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,CACvC,CAAC;AAEJ;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAsB,EACtB,IAAwB;IAExB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,0DAA0D,IAAI,EAAE,CACjE,CAAC;IACJ,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,IAAI,OAAO,CAAC;IACtC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,aAAa,KAAK,OAAO,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CACX,mBAAmB,aAAa,iCAAiC,OAAO,uDAAuD,CAChI,CAAC;IACJ,CAAC;IACD,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CACX,4IAA4I,CAC7I,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AACrC,CAAC","sourcesContent":["import {\n  Compatibility,\n  DEFAULT_COMPATIBILITY,\n  Platform,\n  isCompatibility,\n} from \"../previews/layout.util\";\n\n/** The parts of an Expo app config this package reads. */\nexport type AppConfig = {\n  version?: string;\n  plugins?: (string | [string, unknown?])[];\n  ios?: { version?: string; buildNumber?: string };\n  android?: { version?: string; versionCode?: number };\n};\n\nexport const PLUGIN_NAME = \"@axonpack/preview\";\n\n/** The `compatibility` option of the plugin entry in the app config, or the default. */\nexport function compatibilityOf(config: AppConfig): Compatibility {\n  for (const plugin of config.plugins ?? []) {\n    if (Array.isArray(plugin) && plugin[0] === PLUGIN_NAME) {\n      const option = (plugin[1] as { compatibility?: unknown } | undefined)\n        ?.compatibility;\n      if (option === undefined) break;\n      if (!isCompatibility(option)) {\n        throw new Error(\n          `${PLUGIN_NAME}: compatibility must be \"appVersion\" or \"fingerprint\"`,\n        );\n      }\n      return option;\n    }\n  }\n  return DEFAULT_COMPATIBILITY;\n}\n\n/** The app version a platform's build reports: its own `version` when set, else `expo.version`. */\nexport const appVersionOf = (config: AppConfig, platform: Platform): string =>\n  String(config[platform]?.version ?? config.version ?? \"\");\n\nexport const buildNumberOf = (config: AppConfig, platform: Platform): string =>\n  String(\n    (platform === \"ios\"\n      ? config.ios?.buildNumber\n      : config.android?.versionCode) ?? \"\",\n  );\n\n/**\n * The setting to publish with: the app config's, unless `--compatibility` overrides it. The\n * warnings say when the two disagree (the build would not see the previews) and what appVersion\n * mode cannot catch.\n */\nexport function resolveCompatibility(\n  fromApp: Compatibility,\n  flag: string | undefined,\n): { compatibility: Compatibility; warnings: string[] } {\n  if (flag !== undefined && !isCompatibility(flag)) {\n    throw new Error(\n      `--compatibility must be appVersion or fingerprint, not ${flag}`,\n    );\n  }\n  const compatibility = flag ?? fromApp;\n  const warnings: string[] = [];\n  if (compatibility !== fromApp) {\n    warnings.push(\n      `--compatibility ${compatibility} differs from the app config (${fromApp}), so a build of this app will not list this preview.`,\n    );\n  }\n  if (compatibility === \"appVersion\") {\n    warnings.push(\n      \"Matched by app version: a native change without a version bump is not detected. Bump the version after native changes, or use fingerprint.\",\n    );\n  }\n  return { compatibility, warnings };\n}\n"]}

package/build/utils/dev-preview-servers/merge-servers.util.d.ts

@@ -0,0 +1,47 @@
+import { type AppConfig } from "../config/expo-config.util";
+import { type Platform } from "../previews/layout.util";
+import type { RegisteredServer } from "../../constants/dev-preview-servers/dev-preview-servers.const";
+/** A Metro server on the developer's computer that this app can run from (debug builds only). */
+export type DevPreviewServer = {
+    /** `host:port`, also what Android's dev support connects to. */
+    hostPort: string;
+    host: string;
+    port: number;
+    /** The bundle URL the server's manifest gives for this platform; what iOS loads. */
+    url: string;
+    title: string;
+    name: string;
+    slug: string;
+    version: string | null;
+    branch: string | null;
+    worktree: string | null;
+    /** The native build key the server's code is for; null when it cannot be told. */
+    key: string | null;
+    /** Whether `key` matches the installed build: true, false, or null for "unknown". */
+    compatible: boolean | null;
+    /** Announced by `preview start` (with branch and worktree), or only found by the scan. */
+    announced: boolean;
+};
+export type ScannedServer = {
+    host: string;
+    port: number;
+    url: string;
+    expo: AppConfig & {
+        slug?: string;
+        name?: string;
+    };
+};
+/**
+ * Turns what the registry announced and what the scan found into this app's list: other apps'
+ * servers (another slug) are left out, the same app with another native key is kept but marked
+ * incompatible, and a server found both ways uses the registry's details.
+ */
+export declare function mergeServers(input: {
+    registry: RegisteredServer[];
+    scanned: ScannedServer[];
+    /** The slug the config plugin baked into the build. Only its servers are listed. */
+    appSlug: string;
+    buildKey: string | null;
+    platform: Platform;
+}): DevPreviewServer[];
+//# sourceMappingURL=merge-servers.util.d.ts.map

package/build/utils/dev-preview-servers/merge-servers.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-servers.util.d.ts","sourceRoot":"","sources":["../../../src/utils/dev-preview-servers/merge-servers.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+DAA+D,CAAC;AAEtG,iGAAiG;AACjG,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,kFAAkF;IAClF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,qFAAqF;IACrF,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,0FAA0F;IAC1F,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,gBAAgB,EAAE,CA+BrB"}

package/build/utils/dev-preview-servers/merge-servers.util.js

@@ -0,0 +1,37 @@
+import { appVersionOf, compatibilityOf, } from "../config/expo-config.util";
+import { compatibilityKey } from "../previews/layout.util";
+/**
+ * Turns what the registry announced and what the scan found into this app's list: other apps'
+ * servers (another slug) are left out, the same app with another native key is kept but marked
+ * incompatible, and a server found both ways uses the registry's details.
+ */
+export function mergeServers(input) {
+    const servers = [];
+    for (const found of input.scanned) {
+        const announced = input.registry.find((r) => r.port === found.port);
+        const slug = announced?.slug ?? found.expo.slug ?? "";
+        if (slug !== input.appSlug)
+            continue;
+        const key = announced?.keys[input.platform] ??
+            (compatibilityOf(found.expo) === "appVersion"
+                ? compatibilityKey("appVersion", appVersionOf(found.expo, input.platform))
+                : null);
+        servers.push({
+            hostPort: `${found.host}:${found.port}`,
+            host: found.host,
+            port: found.port,
+            url: found.url,
+            title: announced?.title || found.expo.name || slug,
+            name: announced?.name ?? found.expo.name ?? "",
+            slug,
+            version: appVersionOf(found.expo, input.platform) || null,
+            branch: announced?.branch || null,
+            worktree: announced?.worktree || null,
+            key,
+            compatible: key && input.buildKey ? key === input.buildKey : null,
+            announced: Boolean(announced),
+        });
+    }
+    return servers.sort((a, b) => a.port - b.port);
+}
+//# sourceMappingURL=merge-servers.util.js.map

package/build/utils/dev-preview-servers/merge-servers.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-servers.util.js","sourceRoot":"","sources":["../../../src/utils/dev-preview-servers/merge-servers.util.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,eAAe,GAEhB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAiB,MAAM,yBAAyB,CAAC;AAgC1E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAO5B;IACC,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,SAAS,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QACtD,IAAI,IAAI,KAAK,KAAK,CAAC,OAAO;YAAE,SAAS;QACrC,MAAM,GAAG,GACP,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC/B,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,YAAY;gBAC3C,CAAC,CAAC,gBAAgB,CACd,YAAY,EACZ,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CACzC;gBACH,CAAC,CAAC,IAAI,CAAC,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC;YACX,QAAQ,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE;YACvC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI;YAClD,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE;YAC9C,IAAI;YACJ,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI;YACzD,MAAM,EAAE,SAAS,EAAE,MAAM,IAAI,IAAI;YACjC,QAAQ,EAAE,SAAS,EAAE,QAAQ,IAAI,IAAI;YACrC,GAAG;YACH,UAAU,EAAE,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;YACjE,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC","sourcesContent":["import {\n  appVersionOf,\n  compatibilityOf,\n  type AppConfig,\n} from \"../config/expo-config.util\";\nimport { compatibilityKey, type Platform } from \"../previews/layout.util\";\nimport type { RegisteredServer } from \"../../constants/dev-preview-servers/dev-preview-servers.const\";\n\n/** A Metro server on the developer's computer that this app can run from (debug builds only). */\nexport type DevPreviewServer = {\n  /** `host:port`, also what Android's dev support connects to. */\n  hostPort: string;\n  host: string;\n  port: number;\n  /** The bundle URL the server's manifest gives for this platform; what iOS loads. */\n  url: string;\n  title: string;\n  name: string;\n  slug: string;\n  version: string | null;\n  branch: string | null;\n  worktree: string | null;\n  /** The native build key the server's code is for; null when it cannot be told. */\n  key: string | null;\n  /** Whether `key` matches the installed build: true, false, or null for \"unknown\". */\n  compatible: boolean | null;\n  /** Announced by `preview start` (with branch and worktree), or only found by the scan. */\n  announced: boolean;\n};\n\nexport type ScannedServer = {\n  host: string;\n  port: number;\n  url: string;\n  expo: AppConfig & { slug?: string; name?: string };\n};\n\n/**\n * Turns what the registry announced and what the scan found into this app's list: other apps'\n * servers (another slug) are left out, the same app with another native key is kept but marked\n * incompatible, and a server found both ways uses the registry's details.\n */\nexport function mergeServers(input: {\n  registry: RegisteredServer[];\n  scanned: ScannedServer[];\n  /** The slug the config plugin baked into the build. Only its servers are listed. */\n  appSlug: string;\n  buildKey: string | null;\n  platform: Platform;\n}): DevPreviewServer[] {\n  const servers: DevPreviewServer[] = [];\n  for (const found of input.scanned) {\n    const announced = input.registry.find((r) => r.port === found.port);\n    const slug = announced?.slug ?? found.expo.slug ?? \"\";\n    if (slug !== input.appSlug) continue;\n    const key =\n      announced?.keys[input.platform] ??\n      (compatibilityOf(found.expo) === \"appVersion\"\n        ? compatibilityKey(\n            \"appVersion\",\n            appVersionOf(found.expo, input.platform),\n          )\n        : null);\n    servers.push({\n      hostPort: `${found.host}:${found.port}`,\n      host: found.host,\n      port: found.port,\n      url: found.url,\n      title: announced?.title || found.expo.name || slug,\n      name: announced?.name ?? found.expo.name ?? \"\",\n      slug,\n      version: appVersionOf(found.expo, input.platform) || null,\n      branch: announced?.branch || null,\n      worktree: announced?.worktree || null,\n      key,\n      compatible: key && input.buildKey ? key === input.buildKey : null,\n      announced: Boolean(announced),\n    });\n  }\n  return servers.sort((a, b) => a.port - b.port);\n}\n"]}

package/build/utils/preview-list/theme.util.d.ts

@@ -0,0 +1,5 @@
+import type { PreviewListTheme } from "../../components/preview-list/preview-list.types";
+/** Merges a partial theme over the light or dark base. */
+export declare const resolveTheme: (partial: Partial<PreviewListTheme> | undefined, systemScheme: string | null | undefined) => PreviewListTheme;
+export declare const formatSize: (bytes: number) => string;
+//# sourceMappingURL=theme.util.d.ts.map

package/build/utils/preview-list/theme.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.util.d.ts","sourceRoot":"","sources":["../../../src/utils/preview-list/theme.util.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEzF,0DAA0D;AAC1D,eAAO,MAAM,YAAY,GACvB,SAAS,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,EAC9C,cAAc,MAAM,GAAG,IAAI,GAAG,SAAS,KACtC,gBAKF,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAGQ,CAAC"}

package/build/utils/preview-list/theme.util.js

@@ -0,0 +1,12 @@
+import { DARK_THEME, LIGHT_THEME, } from "../../constants/preview-list/theme.const";
+/** Merges a partial theme over the light or dark base. */
+export const resolveTheme = (partial, systemScheme) => {
+    const mode = partial?.mode ?? "auto";
+    const dark = mode === "dark" || (mode === "auto" && systemScheme === "dark");
+    const base = dark ? DARK_THEME : LIGHT_THEME;
+    return { ...base, ...partial, fonts: { ...base.fonts, ...partial?.fonts } };
+};
+export const formatSize = (bytes) => bytes >= 1024 * 1024
+    ? `${(bytes / 1024 / 1024).toFixed(1)} MB`
+    : `${Math.max(1, Math.round(bytes / 1024))} KB`;
+//# sourceMappingURL=theme.util.js.map

package/build/utils/preview-list/theme.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.util.js","sourceRoot":"","sources":["../../../src/utils/preview-list/theme.util.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,GACZ,MAAM,0CAA0C,CAAC;AAGlD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,OAA8C,EAC9C,YAAuC,EACrB,EAAE;IACpB,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,MAAM,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,YAAY,KAAK,MAAM,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;IAC7C,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;AAC9E,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAClD,KAAK,IAAI,IAAI,GAAG,IAAI;IAClB,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;IAC1C,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC","sourcesContent":["import {\n  DARK_THEME,\n  LIGHT_THEME,\n} from \"../../constants/preview-list/theme.const\";\nimport type { PreviewListTheme } from \"../../components/preview-list/preview-list.types\";\n\n/** Merges a partial theme over the light or dark base. */\nexport const resolveTheme = (\n  partial: Partial<PreviewListTheme> | undefined,\n  systemScheme: string | null | undefined,\n): PreviewListTheme => {\n  const mode = partial?.mode ?? \"auto\";\n  const dark = mode === \"dark\" || (mode === \"auto\" && systemScheme === \"dark\");\n  const base = dark ? DARK_THEME : LIGHT_THEME;\n  return { ...base, ...partial, fonts: { ...base.fonts, ...partial?.fonts } };\n};\n\nexport const formatSize = (bytes: number): string =>\n  bytes >= 1024 * 1024\n    ? `${(bytes / 1024 / 1024).toFixed(1)} MB`\n    : `${Math.max(1, Math.round(bytes / 1024))} KB`;\n"]}

package/build/utils/previews/layout.util.d.ts

@@ -0,0 +1,89 @@
+export declare const SCHEMA = 1;
+export type Platform = "android" | "ios";
+export declare const PLATFORMS: Platform[];
+/**
+ * How a preview is matched to a native build. `appVersion` (the default) trusts the app's version:
+ * simple, but a native change without a version bump goes unnoticed. `fingerprint` hashes the
+ * native side, so any native change makes older previews incompatible.
+ */
+export type Compatibility = "appVersion" | "fingerprint";
+export declare const DEFAULT_COMPATIBILITY: Compatibility;
+export declare const isCompatibility: (value: unknown) => value is Compatibility;
+/**
+ * The key a build and its previews share. Characters a bucket path should not carry are replaced,
+ * so any version string works. app.plugin.js builds the same key; a test keeps the two in step.
+ */
+export declare const compatibilityKey: (compatibility: Compatibility, value: string) => string;
+/** The setting a key was made with, read back from its prefix. */
+export declare const compatibilityOfKey: (key: string) => Compatibility;
+/** What `expo export:embed` names the bundle, so a preview folder matches what a build embeds. */
+export declare const BUNDLE_FILE: Record<Platform, string>;
+export type ManifestFile = {
+    path: string;
+    sha256: string;
+    size: number;
+};
+/** Shown to QA in the list, and kept in both the manifest and the index entry. */
+export type PreviewInfo = {
+    id: string;
+    title: string;
+    branch: string;
+    commit: string;
+    author: string;
+    publishedAt: string;
+    appVersion: string;
+    buildNumber: string;
+    compatibility: Compatibility;
+    /** The native build's fingerprint when it was published, whatever the compatibility setting. */
+    fingerprint: string;
+};
+export type Manifest = PreviewInfo & {
+    schema: number;
+    platform: Platform;
+    key: string;
+    bundle: string;
+    hermesVersion: number | null;
+    changelog: string;
+    files: ManifestFile[];
+};
+export type IndexEntry = PreviewInfo & {
+    /** Changes whenever any file changes, so the app can tell its download is out of date. */
+    revision: string;
+    size: number;
+    changelog: string;
+    manifest: string;
+};
+export type PlatformIndex = {
+    schema: number;
+    platform: Platform;
+    key: string;
+    compatibility: Compatibility;
+    updatedAt: string;
+    previews: IndexEntry[];
+};
+export type RootVersion = {
+    platform: Platform;
+    key: string;
+    compatibility: Compatibility;
+    appVersion: string;
+    buildNumber: string;
+    fingerprint: string;
+    count: number;
+    updatedAt: string;
+    index: string;
+    previews: {
+        id: string;
+        title: string;
+        publishedAt: string;
+    }[];
+};
+export type RootIndex = {
+    schema: number;
+    updatedAt: string;
+    versions: RootVersion[];
+};
+export declare const ROOT_INDEX_KEY = "index.json";
+export declare const fileKey: (sha256: string) => string;
+export declare const platformIndexKey: (platform: Platform, key: string) => string;
+export declare const manifestKey: (platform: Platform, key: string, id: string) => string;
+//# sourceMappingURL=layout.util.d.ts.map

package/build/utils/previews/layout.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.util.d.ts","sourceRoot":"","sources":["../../../src/utils/previews/layout.util.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,MAAM,IAAI,CAAC;AAExB,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAEzC,eAAO,MAAM,SAAS,EAAE,QAAQ,EAAuB,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzD,eAAO,MAAM,qBAAqB,EAAE,aAA4B,CAAC;AAEjE,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,aACP,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,eAAe,aAAa,EAC5B,OAAO,MAAM,KACZ,MACwG,CAAC;AAE5G,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,aACU,CAAC;AAE5D,kGAAkG;AAClG,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAGhD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,kFAAkF;AAClF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,gGAAgG;IAChG,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG;IACrC,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,cAAc,eAAe,CAAC;AAC3C,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,WAAsB,CAAC;AAC7D,eAAO,MAAM,gBAAgB,GAAI,UAAU,QAAQ,EAAE,KAAK,MAAM,WAC/B,CAAC;AAClC,eAAO,MAAM,WAAW,GAAI,UAAU,QAAQ,EAAE,KAAK,MAAM,EAAE,IAAI,MAAM,WAC7B,CAAC"}

package/build/utils/previews/layout.util.js

@@ -0,0 +1,30 @@
+// The bucket layout and file formats, shared by the CLI that writes them and the app that reads them.
+//
+//   index.json                            every native build and its previews, for people
+//   index/<platform>/<key>.json           what one native build can run; the app reads this
+//   previews/<platform>/<key>/<id>.json   one preview's manifest: its files and changelog
+//   files/<sha256>                        bundle and image blobs, shared between previews
+//
+// <key> names the native build a preview runs on: `version-<app version>` or
+// `fingerprint-<hash>`, depending on the app's `compatibility` setting.
+export const SCHEMA = 1;
+export const PLATFORMS = ["android", "ios"];
+export const DEFAULT_COMPATIBILITY = "appVersion";
+export const isCompatibility = (value) => value === "appVersion" || value === "fingerprint";
+/**
+ * The key a build and its previews share. Characters a bucket path should not carry are replaced,
+ * so any version string works. app.plugin.js builds the same key; a test keeps the two in step.
+ */
+export const compatibilityKey = (compatibility, value) => `${compatibility === "appVersion" ? "version" : "fingerprint"}-${value.replace(/[^A-Za-z0-9._-]/g, "_")}`;
+/** The setting a key was made with, read back from its prefix. */
+export const compatibilityOfKey = (key) => key.startsWith("version-") ? "appVersion" : "fingerprint";
+/** What `expo export:embed` names the bundle, so a preview folder matches what a build embeds. */
+export const BUNDLE_FILE = {
+    android: "index.android.bundle",
+    ios: "main.jsbundle",
+};
+export const ROOT_INDEX_KEY = "index.json";
+export const fileKey = (sha256) => `files/${sha256}`;
+export const platformIndexKey = (platform, key) => `index/${platform}/${key}.json`;
+export const manifestKey = (platform, key, id) => `previews/${platform}/${key}/${id}.json`;
+//# sourceMappingURL=layout.util.js.map

package/build/utils/previews/layout.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.util.js","sourceRoot":"","sources":["../../../src/utils/previews/layout.util.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,EAAE;AACF,0FAA0F;AAC1F,4FAA4F;AAC5F,0FAA0F;AAC1F,0FAA0F;AAC1F,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AAExE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC;AAIxB,MAAM,CAAC,MAAM,SAAS,GAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AASxD,MAAM,CAAC,MAAM,qBAAqB,GAAkB,YAAY,CAAC;AAEjE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAc,EAA0B,EAAE,CACxE,KAAK,KAAK,YAAY,IAAI,KAAK,KAAK,aAAa,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,aAA4B,EAC5B,KAAa,EACL,EAAE,CACV,GAAG,aAAa,KAAK,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,EAAE,CAAC;AAE5G,kEAAkE;AAClE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAiB,EAAE,CAC/D,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;AAE5D,kGAAkG;AAClG,MAAM,CAAC,MAAM,WAAW,GAA6B;IACnD,OAAO,EAAE,sBAAsB;IAC/B,GAAG,EAAE,eAAe;CACrB,CAAC;AAiEF,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAC3C,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAkB,EAAE,GAAW,EAAE,EAAE,CAClE,SAAS,QAAQ,IAAI,GAAG,OAAO,CAAC;AAClC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAkB,EAAE,GAAW,EAAE,EAAU,EAAE,EAAE,CACzE,YAAY,QAAQ,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC","sourcesContent":["// The bucket layout and file formats, shared by the CLI that writes them and the app that reads them.\n//\n//   index.json                            every native build and its previews, for people\n//   index/<platform>/<key>.json           what one native build can run; the app reads this\n//   previews/<platform>/<key>/<id>.json   one preview's manifest: its files and changelog\n//   files/<sha256>                        bundle and image blobs, shared between previews\n//\n// <key> names the native build a preview runs on: `version-<app version>` or\n// `fingerprint-<hash>`, depending on the app's `compatibility` setting.\n\nexport const SCHEMA = 1;\n\nexport type Platform = \"android\" | \"ios\";\n\nexport const PLATFORMS: Platform[] = [\"android\", \"ios\"];\n\n/**\n * How a preview is matched to a native build. `appVersion` (the default) trusts the app's version:\n * simple, but a native change without a version bump goes unnoticed. `fingerprint` hashes the\n * native side, so any native change makes older previews incompatible.\n */\nexport type Compatibility = \"appVersion\" | \"fingerprint\";\n\nexport const DEFAULT_COMPATIBILITY: Compatibility = \"appVersion\";\n\nexport const isCompatibility = (value: unknown): value is Compatibility =>\n  value === \"appVersion\" || value === \"fingerprint\";\n\n/**\n * The key a build and its previews share. Characters a bucket path should not carry are replaced,\n * so any version string works. app.plugin.js builds the same key; a test keeps the two in step.\n */\nexport const compatibilityKey = (\n  compatibility: Compatibility,\n  value: string,\n): string =>\n  `${compatibility === \"appVersion\" ? \"version\" : \"fingerprint\"}-${value.replace(/[^A-Za-z0-9._-]/g, \"_\")}`;\n\n/** The setting a key was made with, read back from its prefix. */\nexport const compatibilityOfKey = (key: string): Compatibility =>\n  key.startsWith(\"version-\") ? \"appVersion\" : \"fingerprint\";\n\n/** What `expo export:embed` names the bundle, so a preview folder matches what a build embeds. */\nexport const BUNDLE_FILE: Record<Platform, string> = {\n  android: \"index.android.bundle\",\n  ios: \"main.jsbundle\",\n};\n\nexport type ManifestFile = { path: string; sha256: string; size: number };\n\n/** Shown to QA in the list, and kept in both the manifest and the index entry. */\nexport type PreviewInfo = {\n  id: string;\n  title: string;\n  branch: string;\n  commit: string;\n  author: string;\n  publishedAt: string;\n  appVersion: string;\n  buildNumber: string;\n  compatibility: Compatibility;\n  /** The native build's fingerprint when it was published, whatever the compatibility setting. */\n  fingerprint: string;\n};\n\nexport type Manifest = PreviewInfo & {\n  schema: number;\n  platform: Platform;\n  key: string;\n  bundle: string;\n  hermesVersion: number | null;\n  changelog: string;\n  files: ManifestFile[];\n};\n\nexport type IndexEntry = PreviewInfo & {\n  /** Changes whenever any file changes, so the app can tell its download is out of date. */\n  revision: string;\n  size: number;\n  changelog: string;\n  manifest: string;\n};\n\nexport type PlatformIndex = {\n  schema: number;\n  platform: Platform;\n  key: string;\n  compatibility: Compatibility;\n  updatedAt: string;\n  previews: IndexEntry[];\n};\n\nexport type RootVersion = {\n  platform: Platform;\n  key: string;\n  compatibility: Compatibility;\n  appVersion: string;\n  buildNumber: string;\n  fingerprint: string;\n  count: number;\n  updatedAt: string;\n  index: string;\n  previews: { id: string; title: string; publishedAt: string }[];\n};\n\nexport type RootIndex = {\n  schema: number;\n  updatedAt: string;\n  versions: RootVersion[];\n};\n\nexport const ROOT_INDEX_KEY = \"index.json\";\nexport const fileKey = (sha256: string) => `files/${sha256}`;\nexport const platformIndexKey = (platform: Platform, key: string) =>\n  `index/${platform}/${key}.json`;\nexport const manifestKey = (platform: Platform, key: string, id: string) =>\n  `previews/${platform}/${key}/${id}.json`;\n"]}

package/build/utils/previews/preview-items.util.d.ts

@@ -0,0 +1,23 @@
+import type { IndexEntry } from "./layout.util";
+import type { LocalPreview } from "../../services/previews/local-previews.service";
+import type { PreviewsState } from "../../stores/previews/previews.store";
+export type PreviewStatus = "available" | "downloading" | "downloaded" | "update-available" | "unpublished" | "broken";
+export type PreviewItem = {
+    id: string;
+    /** The bucket's entry, or the one saved with the download once it is unpublished. */
+    entry: IndexEntry;
+    status: PreviewStatus;
+    /** 0 to 1 while downloading. */
+    progress: number | null;
+    active: boolean;
+    local: LocalPreview | null;
+};
+/**
+ * The list QA sees for this build: everything the bucket offers, plus downloads it no longer lists
+ * (unpublished). Downloads for another build go to `incompatible` instead; nothing expires.
+ */
+export declare function previewItems(state: PreviewsState): {
+    items: PreviewItem[];
+    incompatible: LocalPreview[];
+};
+//# sourceMappingURL=preview-items.util.d.ts.map