react-native-store-version 1.4.2 → 2.0.0

package/dist/compare.js

@@ -0,0 +1,68 @@
+import { StoreVersionError } from './errors.js';
+import { compareSegments, compareVersions, validateAndParse, } from './vendor/compare-versions.js';
+/**
+ * v1 互換のバージョン比較。不正な値は compare-versions のエラー
+ * （`Invalid argument not valid semver ('x' received)` など）をそのまま投げる。
+ * v1 のメッセージを変えないために、ここでは包まない
+ */
+export const compareVersion = (local, remote) => {
+    switch (compareVersions(local, remote)) {
+        case -1:
+            return 'new';
+        case 1:
+            return 'old';
+        default:
+            return 'equal';
+    }
+};
+/** `compareVersion` の結果から v1 の `detail` を作る */
+export const toDetail = (result) => {
+    switch (result) {
+        case 'new':
+            return 'remote > local';
+        case 'old':
+            return 'remote < local';
+        default:
+            return 'remote === local';
+    }
+};
+/**
+ * remote が local より新しいときの差分の種類。major / minor / patch の数字を比べ、最初に違う所で決める。
+ * 3 つとも同じ（4 桁目以降やプレリリースだけの差）なら `patch`。欠けた桁は 0 とみなす。
+ * 入力は検証済みであること（不正値は compare-versions のエラーになる）
+ */
+export const diffType = (local, remote) => {
+    const l = validateAndParse(local);
+    const r = validateAndParse(remote);
+    const types = ['major', 'minor', 'patch'];
+    for (let i = 0; i < types.length; i++) {
+        // ワイルドカード（`1.x`）は compare-versions と同じく同値として扱われる
+        if (compareSegments([l[i]], [r[i]]) !== 0) {
+            return types[i];
+        }
+    }
+    return 'patch';
+};
+/** message に入れる値の表現。例外を投げない（BigInt や循環参照のオブジェクトでも） */
+const describe = (value) => typeof value === 'string' ? JSON.stringify(value) : `(${typeof value})`;
+/**
+ * 比較できる値かを確かめる。だめなら `StoreVersionError('INVALID_VERSION')`（cause に元のエラー）を投げる。
+ * `label` は message に入れる、どの値かの名前（`local` / `remote` / `minimum`）
+ */
+export const assertValidVersion = (value, label) => {
+    try {
+        validateAndParse(value);
+    }
+    catch (cause) {
+        throw new StoreVersionError('INVALID_VERSION', `${label} version is invalid: ${describe(value)}`, { cause });
+    }
+};
+/**
+ * v2 の判定用の比較。不正値は `StoreVersionError('INVALID_VERSION')`（cause に元のエラー）で投げる。
+ * `labels` は message に入れる、a / b それぞれの名前（既定は `local` / `remote`）
+ */
+export const compareVersionOrThrow = (a, b, labels = ['local', 'remote']) => {
+    assertValidVersion(a, labels[0]);
+    assertValidVersion(b, labels[1]);
+    return compareVersion(a, b);
+};

package/dist/detect.d.ts

@@ -0,0 +1,68 @@
+/**
+ * ネイティブのバージョン（expo-application → react-native-device-info の順）。取れなければ null。
+ * v1 互換の checkVersion は version と ID を別々に省略できるので、{@link detectApp} を通さずにこれを直接使う
+ * （パッケージの入口からは export しない）
+ */
+export declare const nativeVersion: () => string | null;
+/**
+ * ネイティブの ID（bundleId / package name。expo-application → react-native-device-info の順）。取れなければ null。
+ * checkVersion も直接使う（{@link nativeVersion} と同じ理由）
+ */
+export declare const nativeAppId: () => string | null;
+/**
+ * Expo Go の applicationId（Expo Go 自体のストア版と比べてしまうのを防ぐ。expo-constants には依存しない）。
+ * iOS の bundle ID は `host.exp.Exponent`（E が大文字。@expo/cli の EXPO_GO_BUNDLE_IDENTIFIER）、
+ * Android の package name は `host.exp.exponent`
+ */
+export declare const EXPO_GO_APPLICATION_IDS: readonly string[];
+/**
+ * 判定をしない理由。
+ * - `web`: `Platform.OS === 'web'`（`applicationId` などが取れない）
+ * - `unsupported-platform`: ios / android / web 以外（react-native-windows / macOS など。ストアの版と比べる意味が無い）
+ * - `expo-go`: Expo Go の中で動いている
+ */
+export type SkipReason = 'web' | 'unsupported-platform' | 'expo-go';
+/**
+ * 判定をしない環境なら、その理由を返す。判定する環境なら null。
+ * Expo Go はネイティブの ID（expo-application / react-native-device-info）で見る（明示的に渡された ID では見ない）
+ */
+export declare const getSkipReason: (os?: string) => SkipReason | null;
+/** 自動取得の代わりに明示的に渡す値（渡した値が最優先） */
+export type DetectParams = {
+    /**
+     * アプリのバージョン。必ずネイティブのバージョン（iOS の `CFBundleShortVersionString` / Android の `versionName`）を渡す。
+     * `Constants.expoConfig.version` や `package.json` の値は JS バンドルに含まれ、OTA 更新で変わってしまう
+     * （ネイティブは古いのに「更新済み」と誤判定し、force が出なくなる）ので使わないこと。
+     * 省略すると expo-application の `nativeApplicationVersion` → react-native-device-info の `getVersion()` の順に取る
+     */
+    version?: string | null;
+    /** iOS の bundleId。省略すると expo-application の `applicationId` → react-native-device-info の `getBundleId()` の順に取る */
+    bundleId?: string | null;
+    /** Android の package name。省略すると expo-application の `applicationId` → react-native-device-info の `getBundleId()` の順に取る */
+    packageName?: string | null;
+};
+/** {@link detectApp} の結果 */
+export type DetectedApp = {
+    platform: 'ios' | 'android';
+    /** ネイティブのバージョン */
+    version: string;
+    /** iOS は bundleId、Android は package name */
+    appId: string;
+};
+/**
+ * local version と ID を求める。順に試す: 1. 明示的に渡された値 2. expo-application 3. react-native-device-info。
+ * どれでも取れなければ、何を入れればよいかを書いた `LOCAL_VERSION_UNAVAILABLE` を投げる
+ */
+export declare const detectApp: (platform: 'ios' | 'android', params?: DetectParams) => DetectedApp;
+/** {@link detect} の結果。判定しない環境なら `skipped` に理由が入る */
+export type DetectResult = {
+    skipped: SkipReason;
+} | ({
+    skipped: null;
+} & DetectedApp);
+/**
+ * `Platform.OS` から、判定しない環境か（{@link getSkipReason}）を見て、判定する環境なら local version と ID を求める
+ * （{@link detectApp}）。取れなければ `LOCAL_VERSION_UNAVAILABLE` を投げる
+ */
+export declare const detect: (params?: DetectParams) => DetectResult;
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAwDA;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAO,MAAM,GAAG,IAEZ,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAO,MAAM,GAAG,IAC+B,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAGnD,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,sBAAsB,GAAG,SAAS,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAQ,MAAM,KAAiB,UAAU,GAAG,IAYrE,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iHAAiH;IACjH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yHAAyH;IACzH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,4BAA4B;AAC5B,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAKF;;;GAGG;AACH,eAAO,MAAM,SAAS,aACV,KAAK,GAAG,SAAS,WACnB,YAAY,KACnB,WAiBF,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,YAAY,GACpB;IAAE,OAAO,EAAE,UAAU,CAAA;CAAE,GACvB,CAAC;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG,WAAW,CAAC,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,MAAM,YAAY,YAAY,KAAQ,YAOlD,CAAC"}

package/dist/detect.js

@@ -0,0 +1,103 @@
+// local version / ID の自動取得と、何もしない環境の判定
+import { Platform } from 'react-native';
+import { StoreVersionError } from './errors.js';
+/** `default` export の形（CJS / ESM の相互運用でどちらにもなりうる）でも、名前付きの形でも同じものを取り出す */
+const pick = (mod, key) => {
+    if (typeof mod !== 'object' || mod === null) {
+        return undefined;
+    }
+    const value = mod[key];
+    if (value !== undefined) {
+        return value;
+    }
+    const fallback = mod.default;
+    return typeof fallback === 'object' && fallback !== null
+        ? fallback[key]
+        : undefined;
+};
+const nonEmpty = (value) => typeof value === 'string' && value !== '' ? value : null;
+const fromExpoApplication = (key) => {
+    try {
+        return nonEmpty(pick(require('expo-application'), key));
+    }
+    catch {
+        return null;
+    }
+};
+const fromDeviceInfo = (key) => {
+    try {
+        const fn = pick(require('react-native-device-info'), key);
+        // ネイティブモジュールが無い（Expo Go など）と呼び出しで throw するので、ここも catch に入れる
+        return typeof fn === 'function' ? nonEmpty(fn()) : null;
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * ネイティブのバージョン（expo-application → react-native-device-info の順）。取れなければ null。
+ * v1 互換の checkVersion は version と ID を別々に省略できるので、{@link detectApp} を通さずにこれを直接使う
+ * （パッケージの入口からは export しない）
+ */
+export const nativeVersion = () => fromExpoApplication('nativeApplicationVersion') ??
+    fromDeviceInfo('getVersion');
+/**
+ * ネイティブの ID（bundleId / package name。expo-application → react-native-device-info の順）。取れなければ null。
+ * checkVersion も直接使う（{@link nativeVersion} と同じ理由）
+ */
+export const nativeAppId = () => fromExpoApplication('applicationId') ?? fromDeviceInfo('getBundleId');
+/**
+ * Expo Go の applicationId（Expo Go 自体のストア版と比べてしまうのを防ぐ。expo-constants には依存しない）。
+ * iOS の bundle ID は `host.exp.Exponent`（E が大文字。@expo/cli の EXPO_GO_BUNDLE_IDENTIFIER）、
+ * Android の package name は `host.exp.exponent`
+ */
+export const EXPO_GO_APPLICATION_IDS = Object.freeze([
+    'host.exp.Exponent',
+    'host.exp.exponent',
+]);
+/**
+ * 判定をしない環境なら、その理由を返す。判定する環境なら null。
+ * Expo Go はネイティブの ID（expo-application / react-native-device-info）で見る（明示的に渡された ID では見ない）
+ */
+export const getSkipReason = (os = Platform.OS) => {
+    if (os === 'web') {
+        return 'web';
+    }
+    if (os !== 'ios' && os !== 'android') {
+        return 'unsupported-platform';
+    }
+    const appId = nativeAppId();
+    if (appId !== null && EXPO_GO_APPLICATION_IDS.includes(appId)) {
+        return 'expo-go';
+    }
+    return null;
+};
+const INSTALL_HINT = 'install expo-application (Expo) or react-native-device-info (bare React Native)';
+/**
+ * local version と ID を求める。順に試す: 1. 明示的に渡された値 2. expo-application 3. react-native-device-info。
+ * どれでも取れなければ、何を入れればよいかを書いた `LOCAL_VERSION_UNAVAILABLE` を投げる
+ */
+export const detectApp = (platform, params = {}) => {
+    const version = nonEmpty(params.version) ?? nativeVersion();
+    if (version === null) {
+        throw new StoreVersionError('LOCAL_VERSION_UNAVAILABLE', `could not get the app version: ${INSTALL_HINT}, or pass \`version\` (the native version: ${platform === 'ios' ? 'CFBundleShortVersionString' : 'versionName'}. Do not use Constants.expoConfig.version or package.json, which OTA updates change)`);
+    }
+    const idName = platform === 'ios' ? 'bundleId' : 'packageName';
+    const appId = nonEmpty(params[idName]) ?? nativeAppId();
+    if (appId === null) {
+        throw new StoreVersionError('LOCAL_VERSION_UNAVAILABLE', `could not get the app ${platform === 'ios' ? 'bundle ID' : 'package name'}: ${INSTALL_HINT}, or pass \`${idName}\``);
+    }
+    return { platform, version, appId };
+};
+/**
+ * `Platform.OS` から、判定しない環境か（{@link getSkipReason}）を見て、判定する環境なら local version と ID を求める
+ * （{@link detectApp}）。取れなければ `LOCAL_VERSION_UNAVAILABLE` を投げる
+ */
+export const detect = (params = {}) => {
+    const os = Platform.OS;
+    const skipped = getSkipReason(os);
+    if (skipped !== null) {
+        return { skipped };
+    }
+    return { skipped: null, ...detectApp(os, params) };
+};

package/dist/errors.d.ts

@@ -0,0 +1,33 @@
+/**
+ * {@link StoreVersionError} の `code`。
+ *
+ * - `LOCAL_VERSION_UNAVAILABLE`: アプリのバージョン / ID が取れない
+ * - `TIMEOUT`: タイムアウト
+ * - `NETWORK`: HTTP エラー / ネットワークエラー / iTunes Lookup の応答が JSON として読めない・`results[0].version` が文字列でない
+ * - `NOT_FOUND`: ストアにアプリが無い（iTunes Lookup の results が空、Google Play の 404）
+ * - `PARSE_FAILED`: Play Store の HTML からバージョンを抽出できない
+ * - `INVALID_VERSION`: バージョンが比較できない（`Varies with device` など）
+ * - `LATEST_VERSION_FAILED`: `getLatestVersion` が throw した / 不正な値を返した
+ * - `MINIMUM_VERSION_FAILED`: `getMinimumVersion` が throw した / 不正な値を返した / タイムアウトした（cause は `TIMEOUT`）
+ * - `STORE_URL_UNAVAILABLE`: ストアの URL を取れない / 開けない。iOS の URL の lookup の失敗（起動時・ストアを開くとき。
+ *   `trackViewUrl` が無い場合も）と、ストアを開く `Linking.openURL` 自体の失敗（Android は `market://` と https の両方が失敗したとき）。
+ *   cause に元のエラー。判定の `status` / `error` は変えない
+ * - `POLICY_FAILED`: `policy` の関数が throw した / 不正な値を返した（`'force' | 'warning' | 'none'` 以外）
+ */
+export type StoreVersionErrorCode = 'LOCAL_VERSION_UNAVAILABLE' | 'TIMEOUT' | 'NETWORK' | 'NOT_FOUND' | 'PARSE_FAILED' | 'INVALID_VERSION' | 'LATEST_VERSION_FAILED' | 'MINIMUM_VERSION_FAILED' | 'STORE_URL_UNAVAILABLE' | 'POLICY_FAILED';
+export interface StoreVersionError {
+    /** 元になったエラー（あれば） */
+    readonly cause?: unknown;
+}
+/**
+ * このライブラリが `onError` などに渡すエラー。`code` で原因を区別できる。
+ * 元になったエラーがあれば `cause` に入る。
+ */
+export declare class StoreVersionError extends Error {
+    /** エラーの種類 */
+    readonly code: StoreVersionErrorCode;
+    constructor(code: StoreVersionErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,qBAAqB,GAC7B,2BAA2B,GAC3B,SAAS,GACT,SAAS,GACT,WAAW,GACX,cAAc,GACd,iBAAiB,GACjB,uBAAuB,GACvB,wBAAwB,GACxB,uBAAuB,GACvB,eAAe,CAAC;AAIpB,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AAEH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,aAAa;IACb,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAErC,YACE,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAc9B;CACF"}

package/dist/errors.js

@@ -0,0 +1,23 @@
+/**
+ * このライブラリが `onError` などに渡すエラー。`code` で原因を区別できる。
+ * 元になったエラーがあれば `cause` に入る。
+ */
+// biome-ignore lint/suspicious/noUnsafeDeclarationMerging: cause の型だけを足す意図的な宣言マージ（上の interface）
+export class StoreVersionError extends Error {
+    /** エラーの種類 */
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = 'StoreVersionError';
+        this.code = code;
+        // 古い Hermes は Error の第 2 引数（cause）を無視するので、残らなければ自分で代入する
+        if (options && 'cause' in options && !('cause' in this)) {
+            Object.defineProperty(this, 'cause', {
+                value: options.cause,
+                writable: true,
+                configurable: true,
+                enumerable: false,
+            });
+        }
+    }
+}

package/dist/fetchers/android.d.ts

@@ -0,0 +1,53 @@
+/** 取得先。`packageName`（v2 の既定）か、ストア URL そのもの（v1 互換。checkVersion が使う） */
+export type AndroidTarget = {
+    packageName: string;
+} | {
+    storeUrl: string;
+};
+/** {@link fetchAndroidVersion} のオプション */
+export type AndroidFetchOptions = {
+    /** 未指定ならタイムアウトしない（`requestText` の `timeoutMs`） */
+    timeoutMs?: number;
+    signal?: AbortSignal;
+};
+/** {@link fetchAndroidVersion} の結果 */
+export type AndroidFetchResult = {
+    /** 比較できることを確かめた版 */
+    version: string;
+    /** 取得したページの URL */
+    storeUrl: string;
+};
+/** package name からアプリの詳細ページの URL を組み立てる。クエリ（`hl` / `gl`）は付けない */
+export declare const playStoreUrl: (packageName: string) => string;
+/**
+ * 抽出に使うパターン。実ページの fixture にどのパターンが当たるか（当たらないか）をテストで確かめるために出している
+ * （パッケージの入口からは export しない）
+ */
+export declare const PLAY_VERSION_PATTERNS: Readonly<{
+    versionSlot: RegExp;
+    emptyVersionSlot: RegExp;
+    v1: RegExp;
+}>;
+/**
+ * Play Store の HTML から版を取り出す。
+ *
+ * 1. 版の位置の文字列（構造に錨を下ろしたパターン）
+ * 2. 版の位置が空なら `INVALID_VERSION`（Varies with device）
+ * 3. v1 のパターン（数字とドットだけ）
+ * 4. どれにも当たらなければ `PARSE_FAILED`
+ *
+ * 取れた文字列が比較できない（`50616-r-2026-11-03` など）なら `INVALID_VERSION`
+ */
+export declare const extractPlayVersion: (html: string) => string;
+/**
+ * Play Store のアプリの詳細ページを取得して版を返す。
+ *
+ * - 404 → `NOT_FOUND`（Google Play に無い: 未公開・取り下げなど。iOS の results が空と同じ扱い。本文の読み込みに失敗しても同じ）
+ * - 通信の失敗 / 200・404 以外 → `NETWORK`
+ * - 版の位置が空 / 比較できない版 → `INVALID_VERSION`、抽出できない → `PARSE_FAILED`（{@link extractPlayVersion}）
+ * - タイムアウト → `TIMEOUT`、`signal` の abort → `AbortError`
+ *
+ * `{ storeUrl }` は URL をそのまま取得する（検証も書き換えもしない。v1 互換の入口で、URL の検証は呼び出し側で行う）
+ */
+export declare const fetchAndroidVersion: (target: AndroidTarget, { timeoutMs, signal }?: AndroidFetchOptions) => Promise<AndroidFetchResult>;
+//# sourceMappingURL=android.d.ts.map

package/dist/fetchers/android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android.d.ts","sourceRoot":"","sources":["../../src/fetchers/android.ts"],"names":[],"mappings":"AAKA,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,yCAAyC;AACzC,MAAM,MAAM,mBAAmB,GAAG;IAChC,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,sCAAsC;AACtC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,YAAY,gBAAiB,MAAM,KAAG,MACiC,CAAC;AAkBrF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;CACZ,CAIC,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,SAAU,MAAM,KAAG,MAoBjD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,WACtB,aAAa,0BACE,mBAAmB,KACzC,OAAO,CAAC,kBAAkB,CAiC5B,CAAC"}

package/dist/fetchers/android.js

@@ -0,0 +1,91 @@
+// Google Play（アプリの詳細ページの HTML）の取得。react-native を import しない（Node でも動かす）
+import { assertValidVersion } from '../compare.js';
+import { StoreVersionError } from '../errors.js';
+import { failedResponseStatusOf, requestText } from '../request.js';
+/** package name からアプリの詳細ページの URL を組み立てる。クエリ（`hl` / `gl`）は付けない */
+export const playStoreUrl = (packageName) => `https://play.google.com/store/apps/details?id=${encodeURIComponent(packageName)}`;
+// 実ページ（__tests__/__fixtures__/store/）に対して確かめたパターン。
+// 版は `,null,null,null,[[["<versionName>"]],[[[N]],[[[M,"<最低 OS>"]]]]]` に入っている。
+// `ds:N` の番号や hash は取得ごとに変わるので錨にしない。版より前にレビューの要素（古い版を持つ）が来ることがあるので、
+// 数字だけを拾うパターンを先に試すと古い版を返してしまう
+/** 1. 版の位置の文字列を取る（構造に錨を下ろす。数字でない versionName も取れる） */
+const VERSION_SLOT = /\[\[\["([^"\\]{1,64})"\]\],\[\[\[\d+\]\],\[\[\[\d+,"[^"\\]{0,16}"\]\]\]\]\]/;
+/**
+ * 版の位置が空（`[null,[]]`。Google Play の「Varies with device」。ページにその文言は無い）。
+ * 版の位置の前置き（`,null,null,null,`）と空の版（`[[null,[]],`）だけを錨にする。後ろ（最低 OS など）まで決め打ちにすると、
+ * 少し違う形の Varies のページで当たらず、v1 のパターンが別の場所（レビューの古い版など）を拾ってしまうため
+ */
+const EMPTY_VERSION_SLOT = /,null,null,null,\[\[null,\[\]\],/;
+/** 2. v1 のパターン（数字とドットだけの版） */
+const V1_VERSION = /\[\[\[['"]((\d+\.)+\d+)['"]\]\],/;
+/**
+ * 抽出に使うパターン。実ページの fixture にどのパターンが当たるか（当たらないか）をテストで確かめるために出している
+ * （パッケージの入口からは export しない）
+ */
+export const PLAY_VERSION_PATTERNS = Object.freeze({
+    versionSlot: VERSION_SLOT,
+    emptyVersionSlot: EMPTY_VERSION_SLOT,
+    v1: V1_VERSION,
+});
+/**
+ * Play Store の HTML から版を取り出す。
+ *
+ * 1. 版の位置の文字列（構造に錨を下ろしたパターン）
+ * 2. 版の位置が空なら `INVALID_VERSION`（Varies with device）
+ * 3. v1 のパターン（数字とドットだけ）
+ * 4. どれにも当たらなければ `PARSE_FAILED`
+ *
+ * 取れた文字列が比較できない（`50616-r-2026-11-03` など）なら `INVALID_VERSION`
+ */
+export const extractPlayVersion = (html) => {
+    let version = html.match(VERSION_SLOT)?.[1];
+    if (version === undefined) {
+        // 版の位置が空だと分かるなら、ほかの場所の数字を拾わずに Varies として扱う
+        if (EMPTY_VERSION_SLOT.test(html)) {
+            throw new StoreVersionError('INVALID_VERSION', 'the Play Store page has no version for this app (Varies with device)');
+        }
+        version = html.match(V1_VERSION)?.[1];
+    }
+    if (version === undefined) {
+        throw new StoreVersionError('PARSE_FAILED', 'could not find the version in the Play Store page');
+    }
+    assertValidVersion(version, 'remote');
+    return version;
+};
+/**
+ * Play Store のアプリの詳細ページを取得して版を返す。
+ *
+ * - 404 → `NOT_FOUND`（Google Play に無い: 未公開・取り下げなど。iOS の results が空と同じ扱い。本文の読み込みに失敗しても同じ）
+ * - 通信の失敗 / 200・404 以外 → `NETWORK`
+ * - 版の位置が空 / 比較できない版 → `INVALID_VERSION`、抽出できない → `PARSE_FAILED`（{@link extractPlayVersion}）
+ * - タイムアウト → `TIMEOUT`、`signal` の abort → `AbortError`
+ *
+ * `{ storeUrl }` は URL をそのまま取得する（検証も書き換えもしない。v1 互換の入口で、URL の検証は呼び出し側で行う）
+ */
+export const fetchAndroidVersion = async (target, { timeoutMs, signal } = {}) => {
+    const url = 'packageName' in target
+        ? playStoreUrl(target.packageName)
+        : target.storeUrl;
+    const notFound = () => new StoreVersionError('NOT_FOUND', 'packageName' in target
+        ? `the app (packageName "${target.packageName}") is not found on Google Play`
+        : `the app (${url}) is not found on Google Play`);
+    let response;
+    try {
+        response = await requestText(url, { timeoutMs, signal });
+    }
+    catch (error) {
+        // 404 の本文の読み込みに失敗しても、status が 404 なら NOT_FOUND（本文の読み方で code が変わらないように）
+        if (failedResponseStatusOf(error) === 404) {
+            throw notFound();
+        }
+        throw error;
+    }
+    const { status, body } = response;
+    if (status === 404) {
+        throw notFound();
+    }
+    if (status !== 200) {
+        throw new StoreVersionError('NETWORK', `the Play Store responded with status ${status}`);
+    }
+    return { version: extractPlayVersion(body), storeUrl: url };
+};

package/dist/fetchers/custom.d.ts

@@ -0,0 +1,29 @@
+/** {@link VersionGetter} が受け取る値 */
+export type VersionGetterContext = {
+    /** 判定しているプラットフォーム */
+    platform: 'ios' | 'android';
+    /**
+     * タイムアウト時（と判定の取り消し時）に abort される。fetch に渡せば通信も止まる。
+     * 1 回の判定の `getLatestVersion` と `getMinimumVersion` には同じ signal が渡り、判定ごとに新しいものになる
+     * （同じ取得元から両方を取るときは、signal ごとに取得を 1 回にまとめられる）
+     */
+    signal: AbortSignal;
+};
+/**
+ * バージョン文字列を 1 つ返す async 関数（`getLatestVersion` / `getMinimumVersion`）。
+ * Firebase Remote Config や自前の JSON などから返す想定。失敗したら throw すればよい。
+ * `signal` を fetch に渡さないと、タイムアウト後も通信は続く（判定には使われない）
+ */
+export type VersionGetter = (ctx: VersionGetterContext) => Promise<string | null | undefined>;
+/**
+ * `getLatestVersion` を呼ぶ。throw した / 空文字・null・undefined / 文字列でない値なら `LATEST_VERSION_FAILED`
+ * （throw したときは cause に元のエラー）。比較できない文字列はそのまま返す（判定で `INVALID_VERSION` になる）
+ */
+export declare const callLatestVersion: (getter: VersionGetter, ctx: VersionGetterContext) => Promise<string>;
+/**
+ * `getMinimumVersion` を呼ぶ。空文字 / null / undefined は「指定なし」で null を返す。
+ * throw した / 文字列でない値なら `MINIMUM_VERSION_FAILED`（throw したときは cause に元のエラー）。
+ * 比較できない文字列はそのまま返す（判定で最低バージョンだけを飛ばす）
+ */
+export declare const callMinimumVersion: (getter: VersionGetter, ctx: VersionGetterContext) => Promise<string | null>;
+//# sourceMappingURL=custom.d.ts.map

package/dist/fetchers/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/fetchers/custom.ts"],"names":[],"mappings":"AAGA,mCAAmC;AACnC,MAAM,MAAM,oBAAoB,GAAG;IACjC,qBAAqB;IACrB,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,oBAAoB,KACtB,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAKxC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,WACpB,aAAa,OAChB,oBAAoB,KACxB,OAAO,CAAC,MAAM,CAkBhB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,WACrB,aAAa,OAChB,oBAAoB,KACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAqBvB,CAAC"}

package/dist/fetchers/custom.js

@@ -0,0 +1,41 @@
+// 開発者が渡す取得元（getLatestVersion / getMinimumVersion）の呼び出し。react-native を import しない
+import { StoreVersionError } from '../errors.js';
+const describe = (value) => value === null ? 'null' : `(${typeof value})`;
+/**
+ * `getLatestVersion` を呼ぶ。throw した / 空文字・null・undefined / 文字列でない値なら `LATEST_VERSION_FAILED`
+ * （throw したときは cause に元のエラー）。比較できない文字列はそのまま返す（判定で `INVALID_VERSION` になる）
+ */
+export const callLatestVersion = async (getter, ctx) => {
+    let value;
+    try {
+        value = await getter(ctx);
+    }
+    catch (cause) {
+        throw new StoreVersionError('LATEST_VERSION_FAILED', 'getLatestVersion threw', { cause });
+    }
+    if (typeof value !== 'string' || value === '') {
+        throw new StoreVersionError('LATEST_VERSION_FAILED', `getLatestVersion returned ${value === '' ? 'an empty string' : `an invalid value: ${describe(value)}`}`);
+    }
+    return value;
+};
+/**
+ * `getMinimumVersion` を呼ぶ。空文字 / null / undefined は「指定なし」で null を返す。
+ * throw した / 文字列でない値なら `MINIMUM_VERSION_FAILED`（throw したときは cause に元のエラー）。
+ * 比較できない文字列はそのまま返す（判定で最低バージョンだけを飛ばす）
+ */
+export const callMinimumVersion = async (getter, ctx) => {
+    let value;
+    try {
+        value = await getter(ctx);
+    }
+    catch (cause) {
+        throw new StoreVersionError('MINIMUM_VERSION_FAILED', 'getMinimumVersion threw', { cause });
+    }
+    if (value == null || value === '') {
+        return null;
+    }
+    if (typeof value !== 'string') {
+        throw new StoreVersionError('MINIMUM_VERSION_FAILED', `getMinimumVersion returned an invalid value: ${describe(value)}`);
+    }
+    return value;
+};

package/dist/fetchers/ios.d.ts

@@ -0,0 +1,61 @@
+import { StoreVersionError } from '../errors.ts';
+/** lookup の引き先。`bundleId`（v2 の既定）か、ストア URL から抜き出した数字の App ID（v1 互換の URL 方式） */
+export type IOSLookupTarget = {
+    bundleId: string;
+} | {
+    appId: string;
+};
+/** {@link lookupIOS} のオプション */
+export type IOSLookupOptions = {
+    /** 未指定ならタイムアウトしない（`requestText` の `timeoutMs`） */
+    timeoutMs?: number;
+    signal?: AbortSignal;
+};
+/** {@link lookupIOS} の結果 */
+export type IOSLookupResult = {
+    /** `results[0].version` */
+    version: string;
+    /** `results[0].trackViewUrl`（ストアを開く URL）。応答に無ければ null */
+    storeUrl: string | null;
+    /** `results[0].releaseNotes`。応答に無ければ undefined */
+    releaseNotes?: string;
+};
+/**
+ * App Store の URL（`https://apps.apple.com/jp/app/github/id1477376905` など）から数字の App ID を抜き出す。
+ * v1 と同じ正規表現。取れなければ null
+ */
+export declare const appIdFromStoreUrl: (storeUrl: string) => string | null;
+/** lookup の URL（タイムスタンプを付ける前。in-flight の共有のキーにもなる） */
+export declare const lookupUrl: (target: IOSLookupTarget, country: string) => string;
+/**
+ * iTunes Lookup API で App Store の版を引く。v1 と同じく URL にタイムスタンプを付け、`cache-control: no-cache` を送る。
+ *
+ * - 通信の失敗 / 200 以外 / JSON として読めない / `results[0].version` が文字列でない → `NETWORK`
+ * - `results` が空（未リリース・その国で未配信）→ `NOT_FOUND`
+ * - タイムアウト → `TIMEOUT`、`signal` の abort → `AbortError`
+ */
+export declare const lookupIOS: (target: IOSLookupTarget, country: string, { timeoutMs, signal }?: IOSLookupOptions) => Promise<IOSLookupResult>;
+/**
+ * ストアを開く URL の取得結果。reject しない形にしてある（判定とは別に後から受け取るので、
+ * 誰も待っていなくても unhandled rejection にならないように）
+ */
+export type StoreUrlResult = {
+    storeUrl: string;
+    error: null;
+} | {
+    storeUrl: null;
+    error: StoreVersionError;
+};
+/** lookup に失敗して URL を取れなかったときの `STORE_URL_UNAVAILABLE`。cause に lookup のエラー */
+export declare const storeUrlUnavailable: (cause: unknown) => {
+    storeUrl: null;
+    error: StoreVersionError;
+};
+/** lookup の `storeUrl` から {@link StoreUrlResult} を作る（trackViewUrl が無ければ `STORE_URL_UNAVAILABLE`） */
+export declare const toStoreUrlResult: (storeUrl: string | null) => StoreUrlResult;
+/**
+ * bundleId で lookup して、ストアを開く URL（`trackViewUrl`）だけを取る。`version` / `releaseNotes` は使わない
+ * （`getLatestVersion` の値と食い違いうるため）。失敗は reject せず `STORE_URL_UNAVAILABLE`（cause に lookup のエラー）で返す
+ */
+export declare const lookupStoreUrl: (bundleId: string, country: string, options?: IOSLookupOptions) => Promise<StoreUrlResult>;
+//# sourceMappingURL=ios.d.ts.map

package/dist/fetchers/ios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios.d.ts","sourceRoot":"","sources":["../../src/fetchers/ios.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,+BAA+B;AAC/B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,4BAA4B;AAC5B,MAAM,MAAM,eAAe,GAAG;IAC5B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAAc,MAAM,KAAG,MAAM,GAAG,IACd,CAAC;AAEjD,sDAAsD;AACtD,eAAO,MAAM,SAAS,WAAY,eAAe,WAAW,MAAM,KAAG,MAMpE,CAAC;AAOF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,WACZ,eAAe,WACd,MAAM,0BACQ,gBAAgB,KACtC,OAAO,CAAC,eAAe,CAyDzB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GACjC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEjD,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,UACvB,OAAO,KACb;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAO3C,CAAC;AAEH,oGAAoG;AACpG,eAAO,MAAM,gBAAgB,aAAc,MAAM,GAAG,IAAI,KAAG,cAS5B,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,cAAc,aACf,MAAM,WACP,MAAM,YACN,gBAAgB,KACxB,OAAO,CAAC,cAAc,CAItB,CAAC"}