react-native-store-version 1.4.1 → 2.0.0-beta.1

package/dist/react/useStoreVersion.d.ts

@@ -0,0 +1,121 @@
+import { type ComponentType } from 'react';
+import type { ColorValue, ImageSourcePropType } from 'react-native';
+import type { CompareDetail, CompareResult, DiffType } from '../compare.ts';
+import type { StoreVersionError } from '../errors.ts';
+import type { Action } from '../policy.ts';
+import type { StoreVersionForceTexts, StoreVersionTexts, StoreVersionWarningTexts } from './texts.ts';
+/**
+ * 進行状態。
+ * - `idle`: まだ判定していない（マウント直後。バックグラウンドのままマウントされたら active になるまで）
+ * - `checking`: 判定中
+ * - `ready`: 判定できた（`result` / `action` などに値が入る）
+ * - `skipped`: 判定しない環境（web / ios・android 以外の OS / Expo Go / `enabled={false}`）。`onError` は呼ばない
+ * - `error`: 判定できなかった（`error` に理由。UI は出さない）
+ */
+export type StoreVersionStatus = 'idle' | 'checking' | 'ready' | 'skipped' | 'error';
+/** {@link useStoreVersion} の戻り値 */
+export type UseStoreVersionResult = {
+    /** 進行状態 */
+    status: StoreVersionStatus;
+    /**
+     * 比較の結果（`ready` のときのみ。再チェック中の `checking` では前回の ready の値）。v1 の `checkVersion()` と同じ値で、policy では変わらない。
+     * 最新バージョンが比較できず、最低バージョンで force になったときは null
+     */
+    result: CompareResult | null;
+    /** v1 の `checkVersion()` と同じ `detail`（`result` と同じく、ready と再チェック中のみ） */
+    detail: CompareDetail | null;
+    /**
+     * policy と最低バージョンを当てた結果（`result` と同じく、ready と再チェック中のみ）。デフォルト UI はこれで出す。
+     * 再チェックの間も前回の値のままなので、force のモーダルは再チェック中に消えない
+     */
+    action: Action | null;
+    /** 差分の種類（`result` が `'new'` のときのみ） */
+    diff: DiffType | null;
+    /** `action` が `warning` だが「あとで」（`dismiss`）が押されて UI を出していない。remote が変われば false に戻る */
+    dismissed: boolean;
+    /** アプリのバージョン（ネイティブのバージョン）。判定を始めた後に入る */
+    local: string | null;
+    /** 最新バージョン（`result` と同じく、ready と再チェック中のみ） */
+    remote: string | null;
+    /** 開くべきストアの URL（`result` と同じく、ready と再チェック中のみ）。iOS で URL を取得中・取得に失敗したときは null */
+    storeUrl: string | null;
+    /** iOS でストアのバージョンを使ったときの `releaseNotes`（`result` と同じく、ready と再チェック中のみ）。Android と `getLatestVersion` 使用時は undefined */
+    releaseNotes: string | undefined;
+    /**
+     * ストアのアプリのページを開く。iOS で URL を取得中なら待ち、取れていなければその場でもう一度 lookup する。
+     * 開けたら true、開けなかったら false で resolve する（reject しない。`onPress={openStore}` のまま使える）。
+     * 失敗（iOS の lookup の失敗・`Linking.openURL` の失敗・判定前や skipped で開く先が分からない）は
+     * `STORE_URL_UNAVAILABLE` で `onError` に渡す。`status` / `error` は変えない
+     */
+    openStore: () => Promise<boolean>;
+    /** warning を閉じる（同じ remote のバージョンの間は出さない。メモリだけに持つので、次に起動したら再び出る） */
+    dismiss: () => void;
+    /**
+     * 手動で再チェックする（判定中なら、それを取り消してやり直す）。再チェックの間も前回の結果は残り、失敗したら前回の結果に戻る。
+     * バックグラウンドの間に呼ばれたら、active になってから始める
+     */
+    recheck: () => void;
+    /** 判定できなかった理由（`error` のときのみ。再チェックの失敗では前回の結果に戻るので入らない。`onError` には渡る） */
+    error: StoreVersionError | null;
+};
+/**
+ * `components.Force` に渡す props。このコンポーネントが描くのはカードの中身だけで、Modal・幕・配置・
+ * Android の戻るボタンで閉じないこと・開閉のアニメーションはライブラリが持つ。
+ * 置かれ方: 左右 24 の余白の内側で画面の縦中央、ScrollView の中。カードの面（背景・角丸・影・最大幅 480）はライブラリは掛けないので、
+ * このコンポーネントが自分で描く
+ */
+export type StoreVersionForceProps = {
+    local: string;
+    /** 最新バージョン。Play の版が比較できず、最低バージョンで force になったときは null */
+    remote: string | null;
+    storeUrl: string | null;
+    releaseNotes: string | undefined;
+    /** `{remote}` / `{local}` を置き換え済みの文言 */
+    texts: StoreVersionForceTexts;
+    icon: ImageSourcePropType | undefined;
+    /** 開けたら true、開けなかったら false（reject しない。失敗は `onError` に渡る） */
+    openStore: () => Promise<boolean>;
+};
+/**
+ * `components.Warning` に渡す props。Force の props に加えて `dismiss`（「あとで」）。このコンポーネントが描くのはシートの中身だけで、
+ * Modal・幕・配置・戻るボタン / 背景タップで `dismiss` すること・開閉のアニメーションはライブラリが持つ。
+ * 置かれ方: 画面幅で下寄せ、ScrollView の中。シートの面（背景・角丸・影・最大幅 480）はライブラリは掛けないので、
+ * このコンポーネントが自分で描く
+ */
+export type StoreVersionWarningProps = Omit<StoreVersionForceProps, 'texts'> & {
+    /** `{remote}` / `{local}` を置き換え済みの文言 */
+    texts: StoreVersionWarningTexts;
+    dismiss: () => void;
+};
+/**
+ * デフォルト UI の中身の差し替え。差し替えられるのはカード（Force）/ シート（Warning）の中身だけ。
+ * Modal、幕（オーバーレイ）の色、配置、Android の戻るボタンと背景タップの扱い（Force は閉じない、Warning は `dismiss`）、
+ * 開閉のアニメーションはライブラリが持ち、差し替えても変わらない。
+ * 置かれ方: Force は左右 24 の余白の内側で画面の縦中央、Warning は画面幅で下寄せ。どちらも ScrollView の中。
+ * カード / シートの面（背景・角丸・影・最大幅 480）はライブラリは掛けないので、差し替えたコンポーネントが自分で描く
+ */
+export type StoreVersionComponents = {
+    Force?: ComponentType<StoreVersionForceProps>;
+    Warning?: ComponentType<StoreVersionWarningProps>;
+};
+/** デフォルト UI に渡す表示の設定（Provider の props をそのまま置く） */
+export type StoreVersionDisplay = {
+    ui: boolean;
+    texts: StoreVersionTexts | undefined;
+    icon: ImageSourcePropType | undefined;
+    components: StoreVersionComponents | undefined;
+    primaryColor: ColorValue | undefined;
+};
+/**
+ * 判定の状態の Context（hook が読む。パッケージの入口からは export しない）。
+ * 表示の設定とは分けてある（インラインの `texts` などで Provider が描画し直しても、hook を使う側を描画し直さないように）
+ */
+export declare const StoreVersionStateContext: import("react").Context<UseStoreVersionResult | null>;
+/** 表示の設定の Context（デフォルト UI が読む。パッケージの入口からは export しない） */
+export declare const StoreVersionDisplayContext: import("react").Context<StoreVersionDisplay | null>;
+/**
+ * `StoreVersionProvider` が持つ判定結果を読む。Provider 配下ならどこでも呼べ、何箇所で呼んでも fetch は増えない。
+ * Provider の外で呼ぶと throw する
+ */
+export declare const useStoreVersion: () => UseStoreVersionResult;
+//# sourceMappingURL=useStoreVersion.d.ts.map

package/dist/react/useStoreVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoreVersion.d.ts","sourceRoot":"","sources":["../../src/react/useStoreVersion.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAA6B,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,UAAU,GACV,OAAO,GACP,SAAS,GACT,OAAO,CAAC;AAEZ,mCAAmC;AACnC,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW;IACX,MAAM,EAAE,kBAAkB,CAAC;IAC3B;;;OAGG;IACH,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,wEAAwE;IACxE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sCAAsC;IACtC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,qFAAqF;IACrF,SAAS,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sHAAsH;IACtH,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;;OAKG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,mEAAmE;IACnE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,wEAAwE;IACxE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,wCAAwC;IACxC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,IAAI,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACtC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,GAAG;IAC7E,wCAAwC;IACxC,KAAK,EAAE,wBAAwB,CAAC;IAChC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;CACnD,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACrC,IAAI,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACtC,UAAU,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC/C,YAAY,EAAE,UAAU,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,uDACc,CAAC;AAGpD,0DAA0D;AAC1D,eAAO,MAAM,0BAA0B,qDACU,CAAC;AAGlD;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,qBAQlC,CAAC"}

package/dist/react/useStoreVersion.js

@@ -0,0 +1,23 @@
+// Provider が持つ判定結果を配下に配る Context と、それを読むだけの hook。
+// 判定は Provider が 1 つだけ持つので、hook を何箇所で使っても fetch は増えない
+import { createContext, useContext } from 'react';
+/**
+ * 判定の状態の Context（hook が読む。パッケージの入口からは export しない）。
+ * 表示の設定とは分けてある（インラインの `texts` などで Provider が描画し直しても、hook を使う側を描画し直さないように）
+ */
+export const StoreVersionStateContext = createContext(null);
+StoreVersionStateContext.displayName = 'StoreVersionStateContext';
+/** 表示の設定の Context（デフォルト UI が読む。パッケージの入口からは export しない） */
+export const StoreVersionDisplayContext = createContext(null);
+StoreVersionDisplayContext.displayName = 'StoreVersionDisplayContext';
+/**
+ * `StoreVersionProvider` が持つ判定結果を読む。Provider 配下ならどこでも呼べ、何箇所で呼んでも fetch は増えない。
+ * Provider の外で呼ぶと throw する
+ */
+export const useStoreVersion = () => {
+    const state = useContext(StoreVersionStateContext);
+    if (state === null) {
+        throw new Error('useStoreVersion() must be called inside <StoreVersionProvider>. Wrap your app (or the component tree that calls it) with <StoreVersionProvider> from react-native-store-version.');
+    }
+    return state;
+};

package/dist/request.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 呼び出し元の `signal` が abort されたときに投げるエラー（`name === 'AbortError'`）。
+ * 古い Hermes には DOMException が無いので、name だけを合わせた Error にする
+ */
+export declare const createAbortError: () => Error;
+/** `createAbortError` や fetch の abort で投げられたエラーか */
+export declare const isAbortError: (error: unknown) => boolean;
+/** 呼び出し元の signal とタイムアウトを 1 つにまとめた signal（{@link createScope}） */
+export type Scope = {
+    /** 呼び出し元の signal が abort されたとき、またはタイムアウトしたときに abort される */
+    readonly signal: AbortSignal;
+    /** abort の理由がタイムアウトだったか */
+    readonly timedOut: boolean;
+    /** 自分から abort する（タイムアウト扱いにはしない） */
+    abort(): void;
+    /** タイマーと呼び出し元の signal への登録を外す（終わったら必ず呼ぶ） */
+    dispose(): void;
+};
+/**
+ * 呼び出し元の `signal` と `timeoutMs` から、どちらかで abort される signal を作る。
+ * `timeoutMs` が未指定（または正の有限の数でない）ならタイムアウトしない
+ */
+export declare const createScope: ({ signal, timeoutMs, }?: {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}) => Scope;
+/**
+ * `promise` の完了か `signal` の abort の早い方で終わる。abort なら `createAbortError()` で reject する。
+ * `signal` を見ない処理（開発者の `getLatestVersion` など）を、タイムアウトや呼び出し元の abort で打ち切るため。
+ * 打ち切った後に `promise` が reject しても unhandled rejection にはならない
+ */
+export declare const raceAbort: <T>(promise: PromiseLike<T>, signal: AbortSignal) => Promise<T>;
+/** {@link requestText} の結果。成功・失敗を問わず status と本文を返す（status の扱いは fetcher が決める） */
+export type TextResponse = {
+    readonly status: number;
+    readonly body: string;
+};
+/** {@link requestText} のオプション */
+export type RequestOptions = {
+    /**
+     * この呼び出し元のタイムアウト（ms）。未指定ならタイムアウトしない（10 秒の既定は Provider が渡す）。
+     * 共有中の取得に後から加わった呼び出し元も、自分の `timeoutMs` で数える（ほかの呼び出し元の値には影響されない）。
+     * 時間切れの呼び出し元だけが `TIMEOUT` で抜け、その時点で待っている呼び出し元がいなければ fetch も止める
+     */
+    timeoutMs?: number;
+    /**
+     * この呼び出し元の取り消し。abort するとこの呼び出し元だけが `AbortError` で抜ける。
+     * ほかの呼び出し元が同じ取得を待っていれば fetch は続く
+     */
+    signal?: AbortSignal;
+    /**
+     * iTunes Lookup の CDN キャッシュを避ける。URL の末尾にタイムスタンプ（`&<ts>`）を付け、
+     * `cache-control: no-cache` を送る（v1 と同じ形）
+     */
+    noCache?: boolean;
+};
+/**
+ * {@link requestText} の `NETWORK` のうち、応答（status）は受け取ったが本文の読み込みに失敗したものなら、その status を返す。
+ * fetch 自体が失敗した場合やほかの値なら undefined。v1 互換の checkVersion が、v1 と同じく Android の 200 以外を
+ * 本文より先に `androidStoreURL is invalid.` にするために使う（パッケージの入口からは export しない）
+ */
+export declare const failedResponseStatusOf: (error: unknown) => number | undefined;
+/**
+ * `url` を取得して status と本文を返す。同じ取得先（タイムスタンプを付ける前の URL と `noCache`）への同時の呼び出しは
+ * 1 回の fetch にまとめ、完了したら（成功・失敗とも）共有をやめる（次の呼び出しは取り直す。キャッシュしない）。
+ *
+ * - 通信の失敗（fetch の reject / 本文の読み込みの失敗）は `StoreVersionError('NETWORK')`（cause に元のエラー）
+ * - この呼び出し元のタイムアウトは `StoreVersionError('TIMEOUT')`
+ * - この呼び出し元の `signal` の abort は `AbortError`（{@link isAbortError}）
+ * - 実際の fetch を止めるのは、待っている呼び出し元が全員抜けたとき。タイムアウトで抜けた場合はすぐ止め、
+ *   abort で抜けた場合は次のタスクまで待ってから止める（StrictMode では 1 回目の effect の cleanup の abort の直後に
+ *   2 回目の effect が同じ取得に加わるので、それを受け取れるようにするため）。上位（resolve など）のタイムアウトは
+ *   `signal` の abort として届くので、abort と同じく次のタスクで止める
+ *
+ * HTTP の status は見ない（200 以外の扱いは fetcher が決める）
+ */
+export declare const requestText: (url: string, { timeoutMs, signal, noCache }?: RequestOptions) => Promise<TextResponse>;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,KAInC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,OAGO,CAAC;AAStD,kEAAkE;AAClE,MAAM,MAAM,KAAK,GAAG;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,mCAAmC;IACnC,KAAK,IAAI,IAAI,CAAC;IACd,4CAA4C;IAC5C,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,4BAGrB;IACD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAQ,KA6CR,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,WAChB,WAAW,CAAC,CAAC,CAAC,UACf,WAAW,KAClB,OAAO,CAAC,CAAC,CAkBR,CAAC;AAEL,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,UAAW,OAAO,KAAG,MAAM,GAAG,SAGlD,CAAC;AAqFhB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,QACjB,MAAM,mCAC6B,cAAc,KACrD,OAAO,CAAC,YAAY,CA6DnB,CAAC"}

package/dist/request.js

@@ -0,0 +1,227 @@
+// ストアへの取得の共通部分（タイムアウト / in-flight の共有 / iTunes のキャッシュ回避）。
+// react-native を import しない（Node でも動かす。canary でも使う）。
+// 古い Hermes に無い API（AbortSignal.timeout / AbortSignal.any / DOMException など）は使わず、
+// AbortController と setTimeout だけで組む
+import { StoreVersionError } from './errors.js';
+/**
+ * 呼び出し元の `signal` が abort されたときに投げるエラー（`name === 'AbortError'`）。
+ * 古い Hermes には DOMException が無いので、name だけを合わせた Error にする
+ */
+export const createAbortError = () => {
+    const error = new Error('The operation was aborted.');
+    error.name = 'AbortError';
+    return error;
+};
+/** `createAbortError` や fetch の abort で投げられたエラーか */
+export const isAbortError = (error) => typeof error === 'object' &&
+    error !== null &&
+    error.name === 'AbortError';
+// setTimeout は 2^31 - 1 ms を超えるとすぐに発火する（オーバーフロー）ので、そこで頭打ちにする
+const MAX_TIMEOUT_MS = 2147483647;
+/** タイムアウトを入れるか。正の有限の数のときだけ（0 / 負 / NaN / Infinity / 未指定はタイムアウトなし） */
+const hasTimeout = (timeoutMs) => typeof timeoutMs === 'number' && timeoutMs > 0 && timeoutMs !== Infinity;
+/**
+ * 呼び出し元の `signal` と `timeoutMs` から、どちらかで abort される signal を作る。
+ * `timeoutMs` が未指定（または正の有限の数でない）ならタイムアウトしない
+ */
+export const createScope = ({ signal, timeoutMs, } = {}) => {
+    const controller = new AbortController();
+    let timedOut = false;
+    let timer;
+    const dispose = () => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+        signal?.removeEventListener('abort', onAbort);
+    };
+    function onAbort() {
+        dispose();
+        controller.abort();
+    }
+    if (signal?.aborted) {
+        controller.abort();
+    }
+    else {
+        signal?.addEventListener('abort', onAbort);
+        if (hasTimeout(timeoutMs)) {
+            timer = setTimeout(() => {
+                timer = undefined;
+                timedOut = true;
+                dispose();
+                controller.abort();
+            }, Math.min(timeoutMs, MAX_TIMEOUT_MS));
+        }
+    }
+    return {
+        signal: controller.signal,
+        get timedOut() {
+            return timedOut;
+        },
+        abort: () => {
+            dispose();
+            controller.abort();
+        },
+        dispose,
+    };
+};
+/**
+ * `promise` の完了か `signal` の abort の早い方で終わる。abort なら `createAbortError()` で reject する。
+ * `signal` を見ない処理（開発者の `getLatestVersion` など）を、タイムアウトや呼び出し元の abort で打ち切るため。
+ * 打ち切った後に `promise` が reject しても unhandled rejection にはならない
+ */
+export const raceAbort = (promise, signal) => new Promise((resolve, reject) => {
+    const onAbort = () => reject(createAbortError());
+    if (signal.aborted) {
+        onAbort();
+    }
+    else {
+        signal.addEventListener('abort', onAbort);
+    }
+    promise.then((value) => {
+        signal.removeEventListener('abort', onAbort);
+        resolve(value);
+    }, (error) => {
+        signal.removeEventListener('abort', onAbort);
+        reject(error);
+    });
+});
+// 本文の読み込みに失敗した NETWORK のエラーと、その応答の status。StoreVersionError にフィールドを足さずに（公開の形を変えずに）
+// v1 互換の checkVersion へ status を渡すため。WeakMap なのでエラーが捨てられれば消える（キャッシュではない）
+const failedResponseStatus = new WeakMap();
+/**
+ * {@link requestText} の `NETWORK` のうち、応答（status）は受け取ったが本文の読み込みに失敗したものなら、その status を返す。
+ * fetch 自体が失敗した場合やほかの値なら undefined。v1 互換の checkVersion が、v1 と同じく Android の 200 以外を
+ * 本文より先に `androidStoreURL is invalid.` にするために使う（パッケージの入口からは export しない）
+ */
+export const failedResponseStatusOf = (error) => typeof error === 'object' && error !== null
+    ? failedResponseStatus.get(error)
+    : undefined;
+// 取得中のものだけを持つ（完了したら消す。結果は保持しない）。キーはタイムスタンプを付ける前の取得先
+const inflight = new Map();
+const clearIdleTimer = (entry) => {
+    if (entry.idleTimer !== undefined) {
+        clearTimeout(entry.idleTimer);
+        entry.idleTimer = undefined;
+    }
+};
+/** 誰も待っていなければ fetch を止める。後から来た呼び出し元は新しく取り直す */
+const stopIfIdle = (entry) => {
+    clearIdleTimer(entry);
+    if (entry.settled || entry.waiters > 0) {
+        return;
+    }
+    if (inflight.get(entry.key) === entry) {
+        inflight.delete(entry.key);
+    }
+    entry.controller.abort();
+};
+const start = (key, url, noCache) => {
+    const controller = new AbortController();
+    // v1 と同じく、タイムスタンプはクエリの最後に `&<ts>` で付ける
+    const target = noCache
+        ? `${url}${url.includes('?') ? '&' : '?'}${Date.now()}`
+        : url;
+    const init = noCache
+        ? { headers: { 'cache-control': 'no-cache' }, signal: controller.signal }
+        : { signal: controller.signal };
+    const promise = (async () => {
+        let status;
+        try {
+            const response = await fetch(target, init);
+            status = response.status;
+            return { status, body: await response.text() };
+        }
+        catch (cause) {
+            const error = new StoreVersionError('NETWORK', `request to ${url} failed`, { cause });
+            // 応答は来たが本文の読み込みに失敗した場合だけ、その status を添える（{@link failedResponseStatusOf}）
+            if (typeof status === 'number') {
+                failedResponseStatus.set(error, status);
+            }
+            throw error;
+        }
+    })();
+    const entry = {
+        key,
+        promise,
+        controller,
+        waiters: 0,
+        settled: false,
+        idleTimer: undefined,
+    };
+    const settle = () => {
+        entry.settled = true;
+        clearIdleTimer(entry);
+        if (inflight.get(key) === entry) {
+            inflight.delete(key);
+        }
+    };
+    // 待っている呼び出し元が全員抜けた後の reject（abort）も、ここで受けるので unhandled rejection にならない
+    promise.then(settle, settle);
+    return entry;
+};
+/**
+ * `url` を取得して status と本文を返す。同じ取得先（タイムスタンプを付ける前の URL と `noCache`）への同時の呼び出しは
+ * 1 回の fetch にまとめ、完了したら（成功・失敗とも）共有をやめる（次の呼び出しは取り直す。キャッシュしない）。
+ *
+ * - 通信の失敗（fetch の reject / 本文の読み込みの失敗）は `StoreVersionError('NETWORK')`（cause に元のエラー）
+ * - この呼び出し元のタイムアウトは `StoreVersionError('TIMEOUT')`
+ * - この呼び出し元の `signal` の abort は `AbortError`（{@link isAbortError}）
+ * - 実際の fetch を止めるのは、待っている呼び出し元が全員抜けたとき。タイムアウトで抜けた場合はすぐ止め、
+ *   abort で抜けた場合は次のタスクまで待ってから止める（StrictMode では 1 回目の effect の cleanup の abort の直後に
+ *   2 回目の effect が同じ取得に加わるので、それを受け取れるようにするため）。上位（resolve など）のタイムアウトは
+ *   `signal` の abort として届くので、abort と同じく次のタスクで止める
+ *
+ * HTTP の status は見ない（200 以外の扱いは fetcher が決める）
+ */
+export const requestText = (url, { timeoutMs, signal, noCache = false } = {}) => new Promise((resolve, reject) => {
+    const scope = createScope({ signal, timeoutMs });
+    if (scope.signal.aborted) {
+        reject(createAbortError());
+        return;
+    }
+    const key = `${noCache ? 'no-cache ' : ''}${url}`;
+    let entry = inflight.get(key);
+    if (!entry) {
+        entry = start(key, url, noCache);
+        inflight.set(key, entry);
+    }
+    const joined = entry;
+    joined.waiters += 1;
+    clearIdleTimer(joined);
+    let done = false;
+    const finish = () => {
+        done = true;
+        scope.signal.removeEventListener('abort', onLeave);
+        scope.dispose();
+    };
+    // finish() で外すので、結果を受け取った後には呼ばれない
+    function onLeave() {
+        const timedOut = scope.timedOut;
+        finish();
+        joined.waiters -= 1;
+        if (joined.waiters === 0) {
+            if (timedOut) {
+                stopIfIdle(joined);
+            }
+            else {
+                joined.idleTimer = setTimeout(() => stopIfIdle(joined), 0);
+            }
+        }
+        reject(timedOut
+            ? new StoreVersionError('TIMEOUT', `request to ${url} timed out after ${timeoutMs}ms`)
+            : createAbortError());
+    }
+    scope.signal.addEventListener('abort', onLeave);
+    joined.promise.then((value) => {
+        if (!done) {
+            finish();
+            resolve(value);
+        }
+    }, (error) => {
+        if (!done) {
+            finish();
+            reject(error);
+        }
+    });
+});

package/dist/resolve.d.ts

@@ -0,0 +1,98 @@
+import { type CompareDetail, type CompareResult, type DiffType } from './compare.ts';
+import { StoreVersionError } from './errors.ts';
+import { type VersionGetter } from './fetchers/custom.ts';
+import { type StoreUrlResult } from './fetchers/ios.ts';
+import { type Action, type Policy } from './policy.ts';
+export type { StoreUrlResult, VersionGetter };
+/** {@link resolve} の引数 */
+export type ResolveParams = {
+    platform: 'ios' | 'android';
+    /**
+     * アプリのバージョン。必ずネイティブのバージョン（iOS の `CFBundleShortVersionString` / Android の `versionName`）を渡す。
+     * `Constants.expoConfig.version` や `package.json` の値は OTA 更新で変わってしまうので使わない
+     */
+    version: string;
+    /** iOS は bundleId、Android は package name */
+    appId: string;
+    /** iTunes Lookup の `country`（Android では使わない） */
+    country: string;
+    /** 省略 / null はデフォルト（`{ major: 'force', minor: 'warning', patch: 'warning' }`） */
+    policy?: Policy | null;
+    /** 指定するとストアのバージョンは使わない（iOS はストア URL を得るためだけに lookup する。Android はストアに問い合わせない） */
+    getLatestVersion?: VersionGetter | null;
+    /** これ未満は差分に関係なく force */
+    getMinimumVersion?: VersionGetter | null;
+    /**
+     * 判定全体のタイムアウト（ms）。最新バージョンと最低バージョンの取得の両方に同じものが効く。
+     * 最新バージョンが間に合わなければ `TIMEOUT` で reject する。最新バージョンが間に合い、最低バージョンだけが
+     * 間に合わなければ、最低バージョンの判定だけを飛ばして続ける（`MINIMUM_VERSION_FAILED`。cause に `TIMEOUT`）。
+     * 未指定（または正の有限の数でない）ならタイムアウトしない。10 秒の既定は Provider が渡す
+     */
+    timeoutMs?: number;
+    /** 判定の取り消し（abort すると `AbortError` で reject する） */
+    signal?: AbortSignal;
+};
+/** {@link resolve} の結果（判定できたとき） */
+export type ResolveResult = {
+    /**
+     * 最新バージョン（ストア、または `getLatestVersion` の値）。比較できない値でもそのまま入る。
+     * Play Store のページから版を取れなかった（Varies with device / 比較できない版）が、最低バージョンで force になったときだけ null
+     */
+    latest: string | null;
+    /** `getMinimumVersion` の値。指定なし（空文字 / null / undefined）・未指定・取得の失敗は null。比較できない値でもそのまま入る */
+    minimum: string | null;
+    /**
+     * 判定の時点で分かっているストアの URL。iOS で URL を取れていない（lookup 中・失敗・`trackViewUrl` が無い）ときは null。
+     * 理由は {@link ResolveResult.storeUrlResult} の `error`（lookup 中なら、終わってから受け取れる）
+     */
+    storeUrl: string | null;
+    /**
+     * ストアの URL の取得の完了（reject しない）。iOS で `getLatestVersion` を使うときは判定と並行に走る lookup の結果で、
+     * 判定はこれを待たずに返る（lookup にも `timeoutMs` と `signal` が効き続ける）。それ以外は判定の時点で完了している。
+     * 失敗は `STORE_URL_UNAVAILABLE`（cause に lookup のエラー。タイムアウトなら `TIMEOUT`、`signal` の abort なら `AbortError`）
+     */
+    storeUrlResult: Promise<StoreUrlResult>;
+    /** iOS でストアのバージョンを使ったときの `releaseNotes`。`getLatestVersion` 使用時と Android は undefined */
+    releaseNotes?: string;
+    /** v1 の `compareVersion(local, latest)` と同じ（policy では変わらない）。最新が比較できず最低バージョンで force になったときは null */
+    result: CompareResult | null;
+    /** v1 と同じ `detail`。`result` が null なら null */
+    detail: CompareDetail | null;
+    /** policy と最低バージョンから決まる扱い */
+    action: Action;
+    /** 差分の種類（`result === 'new'` のときだけ） */
+    diff: DiffType | null;
+    /**
+     * 判定を止めなかったが `onError` に渡すべきエラー（空なら無し）。
+     * `MINIMUM_VERSION_FAILED`（getMinimumVersion の失敗・タイムアウト・比較できない最低バージョン）と、
+     * 最新が比較できないが最低バージョンで force にしたときの `INVALID_VERSION`
+     */
+    errors: readonly StoreVersionError[];
+};
+/**
+ * {@link resolve} が reject したエラーに添えた、`onError` に渡すべきほかのエラー（無ければ空）。
+ * 例: 最新バージョンと最低バージョンがどちらも比較できないときは、reject の `INVALID_VERSION` に
+ * `MINIMUM_VERSION_FAILED` が添えてある（開発者のバグを onError で気づけるように）
+ */
+export declare const attachedErrorsOf: (error: unknown) => readonly StoreVersionError[];
+/**
+ * 1 回の判定を行う。latest（ストア / `getLatestVersion`）と minimum（`getMinimumVersion`）は並行に取得し、
+ * `evaluatePolicy` で判定する。
+ *
+ * 判定を止めるエラーは `StoreVersionError` で reject する（`onError` に渡す。UI は出さない）:
+ * - `POLICY_FAILED`: 値で指定した policy が不正（取得の前に検証する）/ policy の関数が throw・不正な値
+ * - `INVALID_VERSION`: local が比較できない（取得の前に検証する）/ 最新が比較できず、最低バージョンでも force にならない
+ * - `TIMEOUT`: 最新バージョン（ストア / `getLatestVersion`）が `timeoutMs` までに取れない
+ *   （最低バージョンだけが間に合わないときは止めず、`MINIMUM_VERSION_FAILED` を `errors` に入れて続ける）
+ * - `NETWORK` / `NOT_FOUND` / `PARSE_FAILED`: ストアの取得の失敗
+ * - `LATEST_VERSION_FAILED`: `getLatestVersion` の失敗（ストアにはフォールバックしない）
+ * - `signal` の abort は `AbortError`
+ *
+ * reject したエラーに、止めなかったエラー（getMinimumVersion の失敗・比較できない最低バージョン）が添えてあれば
+ * {@link attachedErrorsOf} で取れる。latest の取得の失敗（`NETWORK` / `NOT_FOUND` / `PARSE_FAILED` / `TIMEOUT` /
+ * `LATEST_VERSION_FAILED`）で止めるときは、その時点で getMinimumVersion が完了していれば添え、完了していなければ添えない
+ * （待たない）。呼び出し元の abort（判定の取り消し）で止めるときは何も添えない。
+ * 判定を止めないエラーは {@link ResolveResult.errors} に入る。
+ */
+export declare const resolve: (params: ResolveParams) => Promise<ResolveResult>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,cAAc,EAGpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,MAAM,EAGX,KAAK,MAAM,EAGZ,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAE9C,0BAA0B;AAC1B,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,yBAAyB;IACzB,iBAAiB,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACzC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,mCAAmC;AACnC,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACxC,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mGAAmG;IACnG,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,8CAA8C;IAC9C,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB;;;;OAIG;IACH,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACtC,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UACpB,OAAO,KACb,SAAS,iBAAiB,EAC+C,CAAC;AAsE7E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO,WACV,aAAa,KACpB,OAAO,CAAC,aAAa,CAuLvB,CAAC"}