@webority/mobile-core 0.5.0 → 0.6.0

package/README.md

@@ -29,6 +29,7 @@ import { Geolocation } from '@webority/mobile-core/geolocation';
 import { openDatabase } from '@webority/mobile-core/sqlite';
 import { downloadFile } from '@webority/mobile-core/download';
 import { shareFile } from '@webority/mobile-core/share';
+import { requestReviewAfterSuccess } from '@webority/mobile-core/review';
 import { initPush, enablePush, usePush } from '@webority/mobile-core/push';
 import { definePushActionTask } from '@webority/mobile-core/push/task';
 import { compressImage } from '@webority/mobile-core/compressor';
@@ -164,6 +165,19 @@ the listener and the Android task can each report it) runs once.
 Storage and network status stay on the main barrel but load no package on their own. Wire them at
 startup with `setStorageImplementation` and `setNetworkStatusImplementation` if you want them.
 
+## Build number header and forced updates
+
+Both HTTP clients send `X-App-Build: <integer>` on every request: the app's whole build number
+(`VERSION_INTERNAL`, Android versionCode, iOS CFBundleVersion). The API compares it with its minimum
+and answers an older build with 426 `client_update_required`. The number comes from
+`initWebority({ appBuild })` (`setConfig({ appBuild })`), else from expo-application's
+`nativeBuildVersion`. Without a whole number the header is left off, and the server never refuses a
+request without it. `X-Client-Build` (`<appVersion>+<commit>`) is unchanged.
+
+A 426 `client_update_required` opens the same force-update flow as the `X-Min-App-Version` response
+header: `useVersionCheck` turns `isUpdateRequired` on. The floor is the header when the reply has
+one, else the body's `minVersion`, else one above this build. A 426 is never retried.
+
 ## Quiet requests and log redaction
 
 Both HTTP clients log a failed response through `Logger.error`. For a call whose failure the app

package/lib/commonjs/api/clientHeaders.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.getClientBuild=exports.applyClientHeaders=exports.applyAccountIdHeader=exports.CLIENT_KIND_HEADER=exports.CLIENT_KIND=exports.CLIENT_BUILD_HEADER=exports.ACCOUNT_ID_HEADER=void 0;var _index=require("../config/index.js");const CLIENT_BUILD_HEADER=exports.CLIENT_BUILD_HEADER="X-Client-Build",CLIENT_KIND_HEADER=exports.CLIENT_KIND_HEADER="X-Client-Kind",ACCOUNT_ID_HEADER=exports.ACCOUNT_ID_HEADER="X-Account-Id",CLIENT_KIND=exports.CLIENT_KIND="MobileApp",getClientBuild=()=>{const e=(0,_index.getConfigValue)("appVersion");if(!e)return null;const t=(0,_index.getConfigValue)("commit");return t?`${e}+${t}`:e};exports.getClientBuild=getClientBuild;const setIfAbsent=(e,t,s)=>{s&&!e.has(t)&&e.set(t,s)},applyClientHeaders=e=>{e.interceptors.request.use(e=>(setIfAbsent(e.headers,CLIENT_KIND_HEADER,CLIENT_KIND),setIfAbsent(e.headers,CLIENT_BUILD_HEADER,getClientBuild()),e))};exports.applyClientHeaders=applyClientHeaders;const applyAccountIdHeader=async(e,t)=>{const s=t?await t():null;s&&e.set(ACCOUNT_ID_HEADER,s)};exports.applyAccountIdHeader=applyAccountIdHeader;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.getClientBuild=exports.applyClientHeaders=exports.applyAccountIdHeader=exports.CLIENT_KIND_HEADER=exports.CLIENT_KIND=exports.CLIENT_BUILD_HEADER=exports.APP_BUILD_HEADER=exports.ACCOUNT_ID_HEADER=void 0;var _index=require("../config/index.js"),_appBuild=require("../versionCheck/appBuild.js");const CLIENT_BUILD_HEADER=exports.CLIENT_BUILD_HEADER="X-Client-Build",APP_BUILD_HEADER=exports.APP_BUILD_HEADER="X-App-Build",CLIENT_KIND_HEADER=exports.CLIENT_KIND_HEADER="X-Client-Kind",ACCOUNT_ID_HEADER=exports.ACCOUNT_ID_HEADER="X-Account-Id",CLIENT_KIND=exports.CLIENT_KIND="MobileApp",getClientBuild=()=>{const e=(0,_index.getConfigValue)("appVersion");if(!e)return null;const t=(0,_index.getConfigValue)("commit");return t?`${e}+${t}`:e};exports.getClientBuild=getClientBuild;const setIfAbsent=(e,t,s)=>{s&&!e.has(t)&&e.set(t,s)},applyClientHeaders=e=>{e.interceptors.request.use(e=>{setIfAbsent(e.headers,CLIENT_KIND_HEADER,CLIENT_KIND),setIfAbsent(e.headers,CLIENT_BUILD_HEADER,getClientBuild());const t=(0,_appBuild.readAppBuild)();return setIfAbsent(e.headers,APP_BUILD_HEADER,null===t?null:String(t)),e})};exports.applyClientHeaders=applyClientHeaders;const applyAccountIdHeader=async(e,t)=>{const s=t?await t():null;s&&e.set(ACCOUNT_ID_HEADER,s)};exports.applyAccountIdHeader=applyAccountIdHeader;

package/lib/commonjs/api/minAppVersion.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.readMinAppVersion=exports.getMinAppVersion=exports.addMinAppVersionListener=exports.MIN_APP_VERSION_HEADER=void 0;var _index=require("../logger/index.js");const MIN_APP_VERSION_HEADER=exports.MIN_APP_VERSION_HEADER="X-Min-App-Version";let current=null;const listeners=new Set,getMinAppVersion=()=>current;exports.getMinAppVersion=getMinAppVersion;const addMinAppVersionListener=e=>(listeners.add(e),null!==current&&e(current),()=>{listeners.delete(e)});exports.addMinAppVersionListener=addMinAppVersionListener;const readHeader=e=>{if(!e||"object"!=typeof e)return;const r=e.get;return"function"==typeof r?r.call(e,MIN_APP_VERSION_HEADER):e[MIN_APP_VERSION_HEADER.toLowerCase()]},record=e=>{const r=readHeader(e?.headers);if(null==r||""===r)return;const n=String(r).trim();if(!/^\d+$/.test(n))return void _index.Logger.warn(`[minAppVersion] ignored a non-integer ${MIN_APP_VERSION_HEADER}: ${n}`);const t=Number.parseInt(n,10);if(t!==current){current=t;for(const e of[...listeners])try{e(t)}catch(e){_index.Logger.error("[minAppVersion] a listener threw",e)}}},readMinAppVersion=e=>{e.interceptors.response.use(e=>(record(e),e),e=>(record(e?.response),Promise.reject(e)))};exports.readMinAppVersion=readMinAppVersion;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.readMinAppVersion=exports.getMinAppVersion=exports.addMinAppVersionListener=exports.MIN_APP_VERSION_HEADER=void 0;var _index=require("../logger/index.js"),_appBuild=require("../versionCheck/appBuild.js"),_buildNumber=require("../versionCheck/buildNumber.js");const MIN_APP_VERSION_HEADER=exports.MIN_APP_VERSION_HEADER="X-Min-App-Version";let current=null;const listeners=new Set,getMinAppVersion=()=>current;exports.getMinAppVersion=getMinAppVersion;const addMinAppVersionListener=e=>(listeners.add(e),null!==current&&e(current),()=>{listeners.delete(e)});exports.addMinAppVersionListener=addMinAppVersionListener;const readHeader=e=>{if(!e||"object"!=typeof e)return;const r=e.get;return"function"==typeof r?r.call(e,MIN_APP_VERSION_HEADER):e[MIN_APP_VERSION_HEADER.toLowerCase()]},setFloor=e=>{if(e!==current){current=e;for(const r of[...listeners])try{r(e)}catch(e){_index.Logger.error("[minAppVersion] a listener threw",e)}}},record=e=>{const r=readHeader(e?.headers);if(null==r||""===r)return;const n=String(r).trim();/^\d+$/.test(n)?setFloor(Number.parseInt(n,10)):_index.Logger.warn(`[minAppVersion] ignored a non-integer ${MIN_APP_VERSION_HEADER}: ${n}`)},bodyField=(e,r)=>e&&"object"==typeof e?e[r]:void 0,recordUpdateRequired=e=>{if(426!==e?.status||"client_update_required"!==bodyField(e.data,"code"))return;const r=(0,_appBuild.readAppBuild)(),n=(0,_buildNumber.parseBuildNumber)(bodyField(e.data,"minVersion"))??(null===r?null:r+1);null!==n&&setFloor(Math.max(current??0,n))},readMinAppVersion=e=>{e.interceptors.response.use(e=>(record(e),e),e=>{const r=e?.response;return record(r),recordUpdateRequired(r),Promise.reject(e)})};exports.readMinAppVersion=readMinAppVersion;

package/lib/commonjs/review/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.requestReviewAfterSuccess=exports.configureReviewPrompt=exports.REVIEW_PROMPT_STORAGE_KEY=exports.DEFAULT_REVIEW_COOL_DOWN_DAYS=void 0;var _index=require("../logger/index.js"),_index2=require("../storage/index.js");const TAG="[reviewPrompt]",DAY_MS=864e5,DEFAULT_REVIEW_COOL_DOWN_DAYS=exports.DEFAULT_REVIEW_COOL_DOWN_DAYS=90,REVIEW_PROMPT_STORAGE_KEY=exports.REVIEW_PROMPT_STORAGE_KEY="@webority/review-prompt",storeReview=()=>require("expo-store-review");let coolDownDays=DEFAULT_REVIEW_COOL_DOWN_DAYS,inFlight=!1;const configureReviewPrompt=(e={})=>{const o=e.coolDownDays??DEFAULT_REVIEW_COOL_DOWN_DAYS;if(!Number.isFinite(o)||o<0)throw new Error(`[@webority/mobile-core] configureReviewPrompt: coolDownDays must be a number of days, 0 or more; got ${String(o)}.`);o<DEFAULT_REVIEW_COOL_DOWN_DAYS&&_index.Logger.warn(`${TAG} coolDownDays ${o} is under the ${DEFAULT_REVIEW_COOL_DOWN_DAYS}-day minimum for store builds.`),coolDownDays=o};exports.configureReviewPrompt=configureReviewPrompt;const withinCoolDown=(e,o)=>{if(!e)return!1;const r=Date.parse(e.lastAskedUtc);return!Number.isNaN(r)&&o-r<coolDownDays*DAY_MS},storeCanPrompt=async()=>{try{const e=storeReview();return await e.isAvailableAsync()&&await e.hasAction()}catch(e){return _index.Logger.warn(`${TAG} the store review module is not available`,e),!1}},requestReviewAfterSuccess=async e=>{if(inFlight)return"skipped-cooldown";inFlight=!0;try{const o=await _index2.Storage.getJson(REVIEW_PROMPT_STORAGE_KEY),r=Date.now();if(withinCoolDown(o,r))return"skipped-cooldown";if(!await storeCanPrompt())return"skipped-unavailable";try{await storeReview().requestReview()}catch(o){return _index.Logger.warn(`${TAG} the store review request failed after "${e}"`,o),"skipped-unavailable"}const t={lastAskedUtc:new Date(r).toISOString(),moment:e};return await _index2.Storage.setJson(REVIEW_PROMPT_STORAGE_KEY,t)||_index.Logger.warn(`${TAG} the prompt time could not be stored, so the cool-down may not hold`),_index.Logger.info(`${TAG} review prompt requested after "${e}"`),"shown"}finally{inFlight=!1}};exports.requestReviewAfterSuccess=requestReviewAfterSuccess;

package/lib/commonjs/versionCheck/appBuild.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.setDeviceInfo=exports.readAppBuild=exports.getDeviceInfo=exports.expoApplicationBackend=void 0;var Application=_interopRequireWildcard(require("expo-application")),_index=require("../config/index.js"),_buildNumber=require("./buildNumber.js");function _interopRequireWildcard(e,i){if("function"==typeof WeakMap)var t=new WeakMap,n=new WeakMap;return(_interopRequireWildcard=function(e,i){if(!i&&e&&e.__esModule)return e;var r,o,p={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return p;if(r=i?n:t){if(r.has(e))return r.get(e);r.set(e,p)}for(const i in e)"default"!==i&&{}.hasOwnProperty.call(e,i)&&((o=(r=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,i))&&(o.get||o.set)?r(p,i,o):p[i]=e[i]);return p})(e,i)}const expoApplicationBackend=exports.expoApplicationBackend={getBundleId:()=>Application.applicationId??"",getVersion:()=>Application.nativeApplicationVersion??"",getBuildNumber:()=>Application.nativeBuildVersion??""};let deviceInfo=null;const setDeviceInfo=e=>{deviceInfo=e};exports.setDeviceInfo=setDeviceInfo;const getDeviceInfo=()=>deviceInfo;exports.getDeviceInfo=getDeviceInfo;const readAppBuild=()=>{const e=(0,_buildNumber.parseBuildNumber)((0,_index.getConfigValue)("appBuild"));if(null!==e)return e;try{return(0,_buildNumber.parseBuildNumber)(deviceInfo?.getBuildNumber?.()??expoApplicationBackend.getBuildNumber())}catch{return null}};exports.readAppBuild=readAppBuild;

package/lib/commonjs/versionCheck/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=exports.VersionCheck=void 0,Object.defineProperty(exports,"isBuildBelowMinimum",{enumerable:!0,get:function(){return _buildNumber.isBuildBelowMinimum}}),Object.defineProperty(exports,"parseBuildNumber",{enumerable:!0,get:function(){return _buildNumber.parseBuildNumber}}),exports.useVersionCheck=exports.setDeviceInfoImplementation=void 0;var Application=_interopRequireWildcard(require("expo-application")),_react=require("react"),_minAppVersion=require("../api/minAppVersion.js"),_index=require("../config/index.js"),_index2=require("../logger/index.js"),_buildNumber=require("./buildNumber.js");function _interopRequireWildcard(e,r){if("function"==typeof WeakMap)var i=new WeakMap,t=new WeakMap;return(_interopRequireWildcard=function(e,r){if(!r&&e&&e.__esModule)return e;var n,o,l={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return l;if(n=r?t:i){if(n.has(e))return n.get(e);n.set(e,l)}for(const r in e)"default"!==r&&{}.hasOwnProperty.call(e,r)&&((o=(n=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,r))&&(o.get||o.set)?n(l,r,o):l[r]=e[r]);return l})(e,r)}const expoApplicationBackend={getBundleId:()=>Application.applicationId??"",getVersion:()=>Application.nativeApplicationVersion??"",getBuildNumber:()=>Application.nativeBuildVersion??""};let deviceInfo=null;const setDeviceInfoImplementation=e=>{deviceInfo=e};exports.setDeviceInfoImplementation=setDeviceInfoImplementation;const missing=(e,r)=>{const i=new Error(`[VersionCheck] the app's ${e} is not available. Call setConfig({ ${r}: ... }) — every Webority app already has this value in appsettings.Compiled.json — or setDeviceInfoImplementation() with a native provider.`);return _index2.Logger.error(i.message),i},getSystemName=()=>{const{Platform:e}=require("react-native");return e.OS},getBundleId=()=>{const e=(0,_index.getConfigValue)("appId");if(e)return e;const r=(deviceInfo??expoApplicationBackend).getBundleId();if(r)return r;throw missing("store identifier","appId")},getBuildNumber=()=>{const e=(0,_buildNumber.parseBuildNumber)((0,_index.getConfigValue)("appBuild"));if(null!==e)return e;const r=(0,_buildNumber.parseBuildNumber)(deviceInfo?.getBuildNumber?.()??expoApplicationBackend.getBuildNumber());if(null!==r)return r;throw missing("build number","appBuild")},getCountry=()=>(0,_index.getConfigValue)("country","in").toLowerCase(),subscribeMinimum=e=>(0,_minAppVersion.addMinAppVersionListener)(()=>e()),getFallbackStoreUrl=()=>{const e=getSystemName().toLowerCase(),r=getCountry();if("ios"===e){const e=(0,_index.getConfigValue)("appStoreId");return e?`https://apps.apple.com/${r}/app/id${e}`:`https://apps.apple.com/${r}/app/${getBundleId()}`}return`https://play.google.com/store/apps/details?id=${getBundleId()}&hl=${r}`},storeUrlOrNull=()=>{try{return getFallbackStoreUrl()}catch{return null}},checkForUpdates=()=>{const e=(0,_buildNumber.isBuildBelowMinimum)(getBuildNumber(),(0,_minAppVersion.getMinAppVersion)());return{isNewVersionAvailable:e,updateType:e?"major":null,url:e?storeUrlOrNull():null}},VersionCheck=exports.VersionCheck={isNewVersionAvailable:async()=>checkForUpdates(),openUpdateUrl:async e=>{const{Linking:r}=require("react-native");try{if(e)_index2.Logger.info(`Opening app store URL: ${e}`),await r.openURL(e);else{const e=getFallbackStoreUrl();_index2.Logger.info(`Opening fallback store URL: ${e}`),await r.openURL(e)}return!0}catch(i){const t=i instanceof Error?i.message:String(i);_index2.Logger.error(`Failed to open store URL: ${t}`);try{if(e){const e=getFallbackStoreUrl();return _index2.Logger.info(`Trying fallback store URL: ${e}`),await r.openURL(e),!0}}catch(e){const r=e instanceof Error?e.message:String(e);_index2.Logger.error(`Failed to open fallback URL: ${r}`)}return!1}},getFallbackStoreUrl:getFallbackStoreUrl},NOT_REQUIRED={isUpdateRequired:!1,updateUrl:null},useVersionCheck=(e,r=(0,_index.getConfigValue)("environment","Development"))=>{const i=(0,_react.useSyncExternalStore)(subscribeMinimum,_minAppVersion.getMinAppVersion,_minAppVersion.getMinAppVersion);return(0,_react.useMemo)(()=>{if(!e||"Production"!==r||null===i)return NOT_REQUIRED;try{if(!(0,_buildNumber.isBuildBelowMinimum)(getBuildNumber(),i))return NOT_REQUIRED}catch{return NOT_REQUIRED}return{isUpdateRequired:!0,updateUrl:storeUrlOrNull()}},[e,r,i])};exports.useVersionCheck=useVersionCheck;var _default=exports.default=VersionCheck;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=exports.VersionCheck=void 0,Object.defineProperty(exports,"isBuildBelowMinimum",{enumerable:!0,get:function(){return _buildNumber.isBuildBelowMinimum}}),Object.defineProperty(exports,"parseBuildNumber",{enumerable:!0,get:function(){return _buildNumber.parseBuildNumber}}),Object.defineProperty(exports,"readAppBuild",{enumerable:!0,get:function(){return _appBuild.readAppBuild}}),exports.useVersionCheck=exports.setDeviceInfoImplementation=void 0;var _react=require("react"),_minAppVersion=require("../api/minAppVersion.js"),_index=require("../config/index.js"),_index2=require("../logger/index.js"),_appBuild=require("./appBuild.js"),_buildNumber=require("./buildNumber.js");const setDeviceInfoImplementation=e=>{(0,_appBuild.setDeviceInfo)(e)};exports.setDeviceInfoImplementation=setDeviceInfoImplementation;const missing=(e,r)=>{const t=new Error(`[VersionCheck] the app's ${e} is not available. Call setConfig({ ${r}: ... }) — every Webority app already has this value in appsettings.Compiled.json — or setDeviceInfoImplementation() with a native provider.`);return _index2.Logger.error(t.message),t},getSystemName=()=>{const{Platform:e}=require("react-native");return e.OS},getBundleId=()=>{const e=(0,_index.getConfigValue)("appId");if(e)return e;const r=((0,_appBuild.getDeviceInfo)()??_appBuild.expoApplicationBackend).getBundleId();if(r)return r;throw missing("store identifier","appId")},getBuildNumber=()=>{const e=(0,_appBuild.readAppBuild)();if(null!==e)return e;throw missing("build number","appBuild")},getCountry=()=>(0,_index.getConfigValue)("country","in").toLowerCase(),subscribeMinimum=e=>(0,_minAppVersion.addMinAppVersionListener)(()=>e()),getFallbackStoreUrl=()=>{const e=getSystemName().toLowerCase(),r=getCountry();if("ios"===e){const e=(0,_index.getConfigValue)("appStoreId");return e?`https://apps.apple.com/${r}/app/id${e}`:`https://apps.apple.com/${r}/app/${getBundleId()}`}return`https://play.google.com/store/apps/details?id=${getBundleId()}&hl=${r}`},storeUrlOrNull=()=>{try{return getFallbackStoreUrl()}catch{return null}},checkForUpdates=()=>{const e=(0,_buildNumber.isBuildBelowMinimum)(getBuildNumber(),(0,_minAppVersion.getMinAppVersion)());return{isNewVersionAvailable:e,updateType:e?"major":null,url:e?storeUrlOrNull():null}},VersionCheck=exports.VersionCheck={isNewVersionAvailable:async()=>checkForUpdates(),openUpdateUrl:async e=>{const{Linking:r}=require("react-native");try{if(e)_index2.Logger.info(`Opening app store URL: ${e}`),await r.openURL(e);else{const e=getFallbackStoreUrl();_index2.Logger.info(`Opening fallback store URL: ${e}`),await r.openURL(e)}return!0}catch(t){const i=t instanceof Error?t.message:String(t);_index2.Logger.error(`Failed to open store URL: ${i}`);try{if(e){const e=getFallbackStoreUrl();return _index2.Logger.info(`Trying fallback store URL: ${e}`),await r.openURL(e),!0}}catch(e){const r=e instanceof Error?e.message:String(e);_index2.Logger.error(`Failed to open fallback URL: ${r}`)}return!1}},getFallbackStoreUrl:getFallbackStoreUrl},NOT_REQUIRED={isUpdateRequired:!1,updateUrl:null},useVersionCheck=(e,r=(0,_index.getConfigValue)("environment","Development"))=>{const t=(0,_react.useSyncExternalStore)(subscribeMinimum,_minAppVersion.getMinAppVersion,_minAppVersion.getMinAppVersion);return(0,_react.useMemo)(()=>{if(!e||"Production"!==r||null===t)return NOT_REQUIRED;try{if(!(0,_buildNumber.isBuildBelowMinimum)(getBuildNumber(),t))return NOT_REQUIRED}catch{return NOT_REQUIRED}return{isUpdateRequired:!0,updateUrl:storeUrlOrNull()}},[e,r,t])};exports.useVersionCheck=useVersionCheck;var _default=exports.default=VersionCheck;

package/lib/module/api/clientHeaders.js

@@ -1 +1 @@
-"use strict";import{getConfigValue}from"../config/index.js";export const CLIENT_BUILD_HEADER="X-Client-Build";export const CLIENT_KIND_HEADER="X-Client-Kind";export const ACCOUNT_ID_HEADER="X-Account-Id";export const CLIENT_KIND="MobileApp";export const getClientBuild=()=>{const t=getConfigValue("appVersion");if(!t)return null;const e=getConfigValue("commit");return e?`${t}+${e}`:t};const setIfAbsent=(t,e,n)=>{n&&!t.has(e)&&t.set(e,n)};export const applyClientHeaders=t=>{t.interceptors.request.use(t=>(setIfAbsent(t.headers,"X-Client-Kind","MobileApp"),setIfAbsent(t.headers,"X-Client-Build",getClientBuild()),t))};export const applyAccountIdHeader=async(t,e)=>{const n=e?await e():null;n&&t.set("X-Account-Id",n)};
+"use strict";import{getConfigValue}from"../config/index.js";import{readAppBuild}from"../versionCheck/appBuild.js";export const CLIENT_BUILD_HEADER="X-Client-Build";export const APP_BUILD_HEADER="X-App-Build";export const CLIENT_KIND_HEADER="X-Client-Kind";export const ACCOUNT_ID_HEADER="X-Account-Id";export const CLIENT_KIND="MobileApp";export const getClientBuild=()=>{const e=getConfigValue("appVersion");if(!e)return null;const t=getConfigValue("commit");return t?`${e}+${t}`:e};const setIfAbsent=(e,t,n)=>{n&&!e.has(t)&&e.set(t,n)};export const applyClientHeaders=e=>{e.interceptors.request.use(e=>{setIfAbsent(e.headers,"X-Client-Kind","MobileApp"),setIfAbsent(e.headers,"X-Client-Build",getClientBuild());const t=readAppBuild();return setIfAbsent(e.headers,"X-App-Build",null===t?null:String(t)),e})};export const applyAccountIdHeader=async(e,t)=>{const n=t?await t():null;n&&e.set("X-Account-Id",n)};

package/lib/module/api/minAppVersion.js

@@ -1 +1 @@
-"use strict";import{Logger}from"../logger/index.js";export const MIN_APP_VERSION_HEADER="X-Min-App-Version";let current=null;const listeners=new Set;export const getMinAppVersion=()=>current;export const addMinAppVersionListener=e=>(listeners.add(e),null!==current&&e(current),()=>{listeners.delete(e)});const readHeader=e=>{if(!e||"object"!=typeof e)return;const r=e.get;return"function"==typeof r?r.call(e,"X-Min-App-Version"):e["X-Min-App-Version".toLowerCase()]},record=e=>{const r=readHeader(e?.headers);if(null==r||""===r)return;const n=String(r).trim();if(!/^\d+$/.test(n))return void Logger.warn(`[minAppVersion] ignored a non-integer X-Min-App-Version: ${n}`);const t=Number.parseInt(n,10);if(t!==current){current=t;for(const e of[...listeners])try{e(t)}catch(e){Logger.error("[minAppVersion] a listener threw",e)}}};export const readMinAppVersion=e=>{e.interceptors.response.use(e=>(record(e),e),e=>(record(e?.response),Promise.reject(e)))};
+"use strict";import{Logger}from"../logger/index.js";import{readAppBuild}from"../versionCheck/appBuild.js";import{parseBuildNumber}from"../versionCheck/buildNumber.js";export const MIN_APP_VERSION_HEADER="X-Min-App-Version";let current=null;const listeners=new Set;export const getMinAppVersion=()=>current;export const addMinAppVersionListener=e=>(listeners.add(e),null!==current&&e(current),()=>{listeners.delete(e)});const readHeader=e=>{if(!e||"object"!=typeof e)return;const r=e.get;return"function"==typeof r?r.call(e,"X-Min-App-Version"):e["X-Min-App-Version".toLowerCase()]},setFloor=e=>{if(e!==current){current=e;for(const r of[...listeners])try{r(e)}catch(e){Logger.error("[minAppVersion] a listener threw",e)}}},record=e=>{const r=readHeader(e?.headers);if(null==r||""===r)return;const t=String(r).trim();/^\d+$/.test(t)?setFloor(Number.parseInt(t,10)):Logger.warn(`[minAppVersion] ignored a non-integer X-Min-App-Version: ${t}`)},bodyField=(e,r)=>e&&"object"==typeof e?e[r]:void 0,recordUpdateRequired=e=>{if(426!==e?.status||"client_update_required"!==bodyField(e.data,"code"))return;const r=readAppBuild(),t=parseBuildNumber(bodyField(e.data,"minVersion"))??(null===r?null:r+1);null!==t&&setFloor(Math.max(current??0,t))};export const readMinAppVersion=e=>{e.interceptors.response.use(e=>(record(e),e),e=>{const r=e?.response;return record(r),recordUpdateRequired(r),Promise.reject(e)})};

package/lib/module/review/index.js

@@ -0,0 +1 @@
+"use strict";import{Logger}from"../logger/index.js";import{Storage}from"../storage/index.js";const TAG="[reviewPrompt]",DAY_MS=864e5;export const DEFAULT_REVIEW_COOL_DOWN_DAYS=90;export const REVIEW_PROMPT_STORAGE_KEY="@webority/review-prompt";const storeReview=()=>require("expo-store-review");let coolDownDays=90,inFlight=!1;export const configureReviewPrompt=(e={})=>{const o=e.coolDownDays??90;if(!Number.isFinite(o)||o<0)throw new Error(`[@webority/mobile-core] configureReviewPrompt: coolDownDays must be a number of days, 0 or more; got ${String(o)}.`);o<90&&Logger.warn(`${TAG} coolDownDays ${o} is under the 90-day minimum for store builds.`),coolDownDays=o};const withinCoolDown=(e,o)=>{if(!e)return!1;const t=Date.parse(e.lastAskedUtc);return!Number.isNaN(t)&&o-t<coolDownDays*DAY_MS},storeCanPrompt=async()=>{try{const e=storeReview();return await e.isAvailableAsync()&&await e.hasAction()}catch(e){return Logger.warn(`${TAG} the store review module is not available`,e),!1}};export const requestReviewAfterSuccess=async e=>{if(inFlight)return"skipped-cooldown";inFlight=!0;try{const o=await Storage.getJson("@webority/review-prompt"),t=Date.now();if(withinCoolDown(o,t))return"skipped-cooldown";if(!await storeCanPrompt())return"skipped-unavailable";try{await storeReview().requestReview()}catch(o){return Logger.warn(`${TAG} the store review request failed after "${e}"`,o),"skipped-unavailable"}const r={lastAskedUtc:new Date(t).toISOString(),moment:e};return await Storage.setJson("@webority/review-prompt",r)||Logger.warn(`${TAG} the prompt time could not be stored, so the cool-down may not hold`),Logger.info(`${TAG} review prompt requested after "${e}"`),"shown"}finally{inFlight=!1}};

package/lib/module/versionCheck/appBuild.js

@@ -0,0 +1 @@
+"use strict";import*as Application from"expo-application";import{getConfigValue}from"../config/index.js";import{parseBuildNumber}from"./buildNumber.js";export const expoApplicationBackend={getBundleId:()=>Application.applicationId??"",getVersion:()=>Application.nativeApplicationVersion??"",getBuildNumber:()=>Application.nativeBuildVersion??""};let deviceInfo=null;export const setDeviceInfo=e=>{deviceInfo=e};export const getDeviceInfo=()=>deviceInfo;export const readAppBuild=()=>{const e=parseBuildNumber(getConfigValue("appBuild"));if(null!==e)return e;try{return parseBuildNumber(deviceInfo?.getBuildNumber?.()??expoApplicationBackend.getBuildNumber())}catch{return null}};

package/lib/module/versionCheck/index.js

@@ -1 +1 @@
-"use strict";import*as Application from"expo-application";import{useMemo,useSyncExternalStore}from"react";import{addMinAppVersionListener,getMinAppVersion}from"../api/minAppVersion.js";import{getConfigValue}from"../config/index.js";import{Logger}from"../logger/index.js";import{isBuildBelowMinimum,parseBuildNumber}from"./buildNumber.js";const expoApplicationBackend={getBundleId:()=>Application.applicationId??"",getVersion:()=>Application.nativeApplicationVersion??"",getBuildNumber:()=>Application.nativeBuildVersion??""};let deviceInfo=null;export const setDeviceInfoImplementation=e=>{deviceInfo=e};const missing=(e,r)=>{const t=new Error(`[VersionCheck] the app's ${e} is not available. Call setConfig({ ${r}: ... }) — every Webority app already has this value in appsettings.Compiled.json — or setDeviceInfoImplementation() with a native provider.`);return Logger.error(t.message),t},getSystemName=()=>{const{Platform:e}=require("react-native");return e.OS},getBundleId=()=>{const e=getConfigValue("appId");if(e)return e;const r=(deviceInfo??expoApplicationBackend).getBundleId();if(r)return r;throw missing("store identifier","appId")},getBuildNumber=()=>{const e=parseBuildNumber(getConfigValue("appBuild"));if(null!==e)return e;const r=parseBuildNumber(deviceInfo?.getBuildNumber?.()??expoApplicationBackend.getBuildNumber());if(null!==r)return r;throw missing("build number","appBuild")},getCountry=()=>getConfigValue("country","in").toLowerCase(),subscribeMinimum=e=>addMinAppVersionListener(()=>e()),getFallbackStoreUrl=()=>{const e=getSystemName().toLowerCase(),r=getCountry();if("ios"===e){const e=getConfigValue("appStoreId");return e?`https://apps.apple.com/${r}/app/id${e}`:`https://apps.apple.com/${r}/app/${getBundleId()}`}return`https://play.google.com/store/apps/details?id=${getBundleId()}&hl=${r}`},storeUrlOrNull=()=>{try{return getFallbackStoreUrl()}catch{return null}},checkForUpdates=()=>{const e=isBuildBelowMinimum(getBuildNumber(),getMinAppVersion());return{isNewVersionAvailable:e,updateType:e?"major":null,url:e?storeUrlOrNull():null}};export const VersionCheck={isNewVersionAvailable:async()=>checkForUpdates(),openUpdateUrl:async e=>{const{Linking:r}=require("react-native");try{if(e)Logger.info(`Opening app store URL: ${e}`),await r.openURL(e);else{const e=getFallbackStoreUrl();Logger.info(`Opening fallback store URL: ${e}`),await r.openURL(e)}return!0}catch(t){const i=t instanceof Error?t.message:String(t);Logger.error(`Failed to open store URL: ${i}`);try{if(e){const e=getFallbackStoreUrl();return Logger.info(`Trying fallback store URL: ${e}`),await r.openURL(e),!0}}catch(e){const r=e instanceof Error?e.message:String(e);Logger.error(`Failed to open fallback URL: ${r}`)}return!1}},getFallbackStoreUrl:getFallbackStoreUrl};const NOT_REQUIRED={isUpdateRequired:!1,updateUrl:null};export const useVersionCheck=(e,r=getConfigValue("environment","Development"))=>{const t=useSyncExternalStore(subscribeMinimum,getMinAppVersion,getMinAppVersion);return useMemo(()=>{if(!e||"Production"!==r||null===t)return NOT_REQUIRED;try{if(!isBuildBelowMinimum(getBuildNumber(),t))return NOT_REQUIRED}catch{return NOT_REQUIRED}return{isUpdateRequired:!0,updateUrl:storeUrlOrNull()}},[e,r,t])};export default VersionCheck;export{isBuildBelowMinimum,parseBuildNumber}from"./buildNumber.js";
+"use strict";import{useMemo,useSyncExternalStore}from"react";import{addMinAppVersionListener,getMinAppVersion}from"../api/minAppVersion.js";import{getConfigValue}from"../config/index.js";import{Logger}from"../logger/index.js";import{expoApplicationBackend,getDeviceInfo,readAppBuild,setDeviceInfo}from"./appBuild.js";import{isBuildBelowMinimum}from"./buildNumber.js";export const setDeviceInfoImplementation=e=>{setDeviceInfo(e)};const missing=(e,r)=>{const t=new Error(`[VersionCheck] the app's ${e} is not available. Call setConfig({ ${r}: ... }) — every Webority app already has this value in appsettings.Compiled.json — or setDeviceInfoImplementation() with a native provider.`);return Logger.error(t.message),t},getSystemName=()=>{const{Platform:e}=require("react-native");return e.OS},getBundleId=()=>{const e=getConfigValue("appId");if(e)return e;const r=(getDeviceInfo()??expoApplicationBackend).getBundleId();if(r)return r;throw missing("store identifier","appId")},getBuildNumber=()=>{const e=readAppBuild();if(null!==e)return e;throw missing("build number","appBuild")},getCountry=()=>getConfigValue("country","in").toLowerCase(),subscribeMinimum=e=>addMinAppVersionListener(()=>e()),getFallbackStoreUrl=()=>{const e=getSystemName().toLowerCase(),r=getCountry();if("ios"===e){const e=getConfigValue("appStoreId");return e?`https://apps.apple.com/${r}/app/id${e}`:`https://apps.apple.com/${r}/app/${getBundleId()}`}return`https://play.google.com/store/apps/details?id=${getBundleId()}&hl=${r}`},storeUrlOrNull=()=>{try{return getFallbackStoreUrl()}catch{return null}},checkForUpdates=()=>{const e=isBuildBelowMinimum(getBuildNumber(),getMinAppVersion());return{isNewVersionAvailable:e,updateType:e?"major":null,url:e?storeUrlOrNull():null}};export const VersionCheck={isNewVersionAvailable:async()=>checkForUpdates(),openUpdateUrl:async e=>{const{Linking:r}=require("react-native");try{if(e)Logger.info(`Opening app store URL: ${e}`),await r.openURL(e);else{const e=getFallbackStoreUrl();Logger.info(`Opening fallback store URL: ${e}`),await r.openURL(e)}return!0}catch(t){const o=t instanceof Error?t.message:String(t);Logger.error(`Failed to open store URL: ${o}`);try{if(e){const e=getFallbackStoreUrl();return Logger.info(`Trying fallback store URL: ${e}`),await r.openURL(e),!0}}catch(e){const r=e instanceof Error?e.message:String(e);Logger.error(`Failed to open fallback URL: ${r}`)}return!1}},getFallbackStoreUrl:getFallbackStoreUrl};const NOT_REQUIRED={isUpdateRequired:!1,updateUrl:null};export const useVersionCheck=(e,r=getConfigValue("environment","Development"))=>{const t=useSyncExternalStore(subscribeMinimum,getMinAppVersion,getMinAppVersion);return useMemo(()=>{if(!e||"Production"!==r||null===t)return NOT_REQUIRED;try{if(!isBuildBelowMinimum(getBuildNumber(),t))return NOT_REQUIRED}catch{return NOT_REQUIRED}return{isUpdateRequired:!0,updateUrl:storeUrlOrNull()}},[e,r,t])};export default VersionCheck;export{readAppBuild}from"./appBuild.js";export{isBuildBelowMinimum,parseBuildNumber}from"./buildNumber.js";

package/lib/typescript/commonjs/api/clientHeaders.d.ts

@@ -1,5 +1,6 @@
 import type { AxiosInstance } from 'axios';
 export declare const CLIENT_BUILD_HEADER = "X-Client-Build";
+export declare const APP_BUILD_HEADER = "X-App-Build";
 export declare const CLIENT_KIND_HEADER = "X-Client-Kind";
 export declare const ACCOUNT_ID_HEADER = "X-Account-Id";
 /** The server picks session rules and the minimum version per kind; the names match its enum. */
@@ -8,7 +9,10 @@ export declare const CLIENT_KIND: ClientKind;
 /** `<appVersion>+<commit>`, `<appVersion>` when no commit was stamped, `null` before init. */
 export declare const getClientBuild: () => string | null;
 /**
- * Stamps X-Client-Kind and X-Client-Build on every request. A value the app
+ * Stamps X-Client-Kind, X-Client-Build and X-App-Build on every request.
+ * X-App-Build is the whole build number the server compares with its minimum;
+ * it is left off when the build is unknown, because the server never refuses a
+ * request without it and a guessed number could strand a current build. A value the app
  * already set (a default header, or a per-request one) wins, so an app that
  * wired them by hand keeps working unchanged.
  */

package/lib/typescript/commonjs/index.d.ts

@@ -11,6 +11,7 @@
  *   @webority/mobile-core/sqlite       expo-sqlite
  *   @webority/mobile-core/download     a filesystem module
  *   @webority/mobile-core/share        expo-sharing
+ *   @webority/mobile-core/review       expo-store-review
  *   @webority/mobile-core/secureScreen expo-screen-capture
  *   @webority/mobile-core/updates      expo-updates
  *   @webority/mobile-core/smsRetriever Android only, own TurboModule

package/lib/typescript/commonjs/review/index.d.ts

@@ -0,0 +1,42 @@
+/** The fleet's minimum: no more than one prompt in 90 days per user. */
+export declare const DEFAULT_REVIEW_COOL_DOWN_DAYS = 90;
+/** Where the last prompt is remembered, through mobile-core's `Storage`. */
+export declare const REVIEW_PROMPT_STORAGE_KEY = "@webority/review-prompt";
+export interface ReviewPromptOptions {
+    /** Days to wait after a prompt before the next one. Defaults to 90, the fleet minimum. */
+    coolDownDays?: number;
+}
+/** What was stored when the prompt last showed. */
+export interface ReviewPromptRecord {
+    /** When the prompt was last requested, as an ISO 8601 UTC string. */
+    lastAskedUtc: string;
+    /** The success moment that asked. */
+    moment: string;
+}
+export type ReviewPromptResult = 'shown' | 'skipped-cooldown' | 'skipped-unavailable';
+/**
+ * Sets the cool-down between prompts. Each call replaces the previous options, so
+ * `configureReviewPrompt({})` restores the default. Throws on a negative or
+ * non-finite number of days, which is a programming error.
+ */
+export declare const configureReviewPrompt: (options?: ReviewPromptOptions) => void;
+/**
+ * Shows the platform's rating prompt after a success moment, at most once per
+ * cool-down (90 days by default, see `configureReviewPrompt`).
+ *
+ * Call it only after a success moment and once for that moment; never after an
+ * error and never behind a "Do you like the app?" question (App Store guideline
+ * 5.6.1, Google Play's review policy).
+ *
+ * Resolves, never rejects:
+ * - `shown`: the prompt was requested and the time and `moment` were stored. The
+ *   platform still decides whether it appears, and caps how often it does.
+ * - `skipped-cooldown`: the last prompt is inside the cool-down, or another call
+ *   is still running.
+ * - `skipped-unavailable`: the device or build has no in-app review (no store,
+ *   a simulator, the native module missing), or the request failed. Logged.
+ *
+ * @param moment a short name for the success moment, such as `survey-submitted`.
+ */
+export declare const requestReviewAfterSuccess: (moment: string) => Promise<ReviewPromptResult>;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/versionCheck/appBuild.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Minimal device-info shape we depend on.
+ *
+ * This is a LAST RESORT, not the primary path. Every Webority app carries its
+ * store id and build number in `appsettings.Compiled.json`, so
+ * `setConfig({ appId, appBuild })` covers both without a native module, and
+ * expo-application covers an app that wires neither. `getBuildNumber` is
+ * optional so an injector written before the server-driven check still fits;
+ * without it the build number comes from expo-application.
+ */
+export interface DeviceInfoLike {
+    getBundleId: () => string;
+    getVersion: () => string;
+    getBuildNumber?: () => string;
+}
+/**
+ * expo-application, read at call time: its values are module CONSTANTS, and
+ * capturing them here would snapshot them before the native module has
+ * initialised. Config still wins over this.
+ */
+export declare const expoApplicationBackend: Required<DeviceInfoLike>;
+export declare const setDeviceInfo: (impl: DeviceInfoLike | null) => void;
+export declare const getDeviceInfo: () => DeviceInfoLike | null;
+/**
+ * The app's internal build number (`VERSION_INTERNAL`: Android versionCode, iOS
+ * CFBundleVersion) from `setConfig({ appBuild })`, else the device info, else
+ * expo-application; `null` when none of them holds an integer. Never throws.
+ */
+export declare const readAppBuild: () => number | null;
+//# sourceMappingURL=appBuild.d.ts.map

package/lib/typescript/commonjs/versionCheck/index.d.ts

@@ -1,19 +1,5 @@
 import { type Environment } from '../config';
-/**
- * Minimal device-info shape we depend on.
- *
- * This is a LAST RESORT, not the primary path. Every Webority app carries its
- * store id and build number in `appsettings.Compiled.json`, so
- * `setConfig({ appId, appBuild })` covers both without a native module, and
- * expo-application covers an app that wires neither. `getBuildNumber` is
- * optional so an injector written before the server-driven check still fits;
- * without it the build number comes from expo-application.
- */
-interface DeviceInfoLike {
-    getBundleId: () => string;
-    getVersion: () => string;
-    getBuildNumber?: () => string;
-}
+import { type DeviceInfoLike } from './appBuild';
 /**
  * Supply the app identity from a native module instead of config.
  * Prefer `setConfig({ appId, appBuild })` — it needs no native dependency.
@@ -86,6 +72,7 @@ export declare const VersionCheck: VersionCheckType;
  */
 export declare const useVersionCheck: (isAppReady: boolean, environment?: Environment) => UpdateInfo;
 export default VersionCheck;
+export { readAppBuild } from './appBuild';
 export { isBuildBelowMinimum, parseBuildNumber } from './buildNumber';
 export type { DeviceInfoLike };
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/api/clientHeaders.d.ts

@@ -1,5 +1,6 @@
 import type { AxiosInstance } from 'axios';
 export declare const CLIENT_BUILD_HEADER = "X-Client-Build";
+export declare const APP_BUILD_HEADER = "X-App-Build";
 export declare const CLIENT_KIND_HEADER = "X-Client-Kind";
 export declare const ACCOUNT_ID_HEADER = "X-Account-Id";
 /** The server picks session rules and the minimum version per kind; the names match its enum. */
@@ -8,7 +9,10 @@ export declare const CLIENT_KIND: ClientKind;
 /** `<appVersion>+<commit>`, `<appVersion>` when no commit was stamped, `null` before init. */
 export declare const getClientBuild: () => string | null;
 /**
- * Stamps X-Client-Kind and X-Client-Build on every request. A value the app
+ * Stamps X-Client-Kind, X-Client-Build and X-App-Build on every request.
+ * X-App-Build is the whole build number the server compares with its minimum;
+ * it is left off when the build is unknown, because the server never refuses a
+ * request without it and a guessed number could strand a current build. A value the app
  * already set (a default header, or a per-request one) wins, so an app that
  * wired them by hand keeps working unchanged.
  */

package/lib/typescript/module/index.d.ts

@@ -11,6 +11,7 @@
  *   @webority/mobile-core/sqlite       expo-sqlite
  *   @webority/mobile-core/download     a filesystem module
  *   @webority/mobile-core/share        expo-sharing
+ *   @webority/mobile-core/review       expo-store-review
  *   @webority/mobile-core/secureScreen expo-screen-capture
  *   @webority/mobile-core/updates      expo-updates
  *   @webority/mobile-core/smsRetriever Android only, own TurboModule

package/lib/typescript/module/review/index.d.ts

@@ -0,0 +1,42 @@
+/** The fleet's minimum: no more than one prompt in 90 days per user. */
+export declare const DEFAULT_REVIEW_COOL_DOWN_DAYS = 90;
+/** Where the last prompt is remembered, through mobile-core's `Storage`. */
+export declare const REVIEW_PROMPT_STORAGE_KEY = "@webority/review-prompt";
+export interface ReviewPromptOptions {
+    /** Days to wait after a prompt before the next one. Defaults to 90, the fleet minimum. */
+    coolDownDays?: number;
+}
+/** What was stored when the prompt last showed. */
+export interface ReviewPromptRecord {
+    /** When the prompt was last requested, as an ISO 8601 UTC string. */
+    lastAskedUtc: string;
+    /** The success moment that asked. */
+    moment: string;
+}
+export type ReviewPromptResult = 'shown' | 'skipped-cooldown' | 'skipped-unavailable';
+/**
+ * Sets the cool-down between prompts. Each call replaces the previous options, so
+ * `configureReviewPrompt({})` restores the default. Throws on a negative or
+ * non-finite number of days, which is a programming error.
+ */
+export declare const configureReviewPrompt: (options?: ReviewPromptOptions) => void;
+/**
+ * Shows the platform's rating prompt after a success moment, at most once per
+ * cool-down (90 days by default, see `configureReviewPrompt`).
+ *
+ * Call it only after a success moment and once for that moment; never after an
+ * error and never behind a "Do you like the app?" question (App Store guideline
+ * 5.6.1, Google Play's review policy).
+ *
+ * Resolves, never rejects:
+ * - `shown`: the prompt was requested and the time and `moment` were stored. The
+ *   platform still decides whether it appears, and caps how often it does.
+ * - `skipped-cooldown`: the last prompt is inside the cool-down, or another call
+ *   is still running.
+ * - `skipped-unavailable`: the device or build has no in-app review (no store,
+ *   a simulator, the native module missing), or the request failed. Logged.
+ *
+ * @param moment a short name for the success moment, such as `survey-submitted`.
+ */
+export declare const requestReviewAfterSuccess: (moment: string) => Promise<ReviewPromptResult>;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/versionCheck/appBuild.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Minimal device-info shape we depend on.
+ *
+ * This is a LAST RESORT, not the primary path. Every Webority app carries its
+ * store id and build number in `appsettings.Compiled.json`, so
+ * `setConfig({ appId, appBuild })` covers both without a native module, and
+ * expo-application covers an app that wires neither. `getBuildNumber` is
+ * optional so an injector written before the server-driven check still fits;
+ * without it the build number comes from expo-application.
+ */
+export interface DeviceInfoLike {
+    getBundleId: () => string;
+    getVersion: () => string;
+    getBuildNumber?: () => string;
+}
+/**
+ * expo-application, read at call time: its values are module CONSTANTS, and
+ * capturing them here would snapshot them before the native module has
+ * initialised. Config still wins over this.
+ */
+export declare const expoApplicationBackend: Required<DeviceInfoLike>;
+export declare const setDeviceInfo: (impl: DeviceInfoLike | null) => void;
+export declare const getDeviceInfo: () => DeviceInfoLike | null;
+/**
+ * The app's internal build number (`VERSION_INTERNAL`: Android versionCode, iOS
+ * CFBundleVersion) from `setConfig({ appBuild })`, else the device info, else
+ * expo-application; `null` when none of them holds an integer. Never throws.
+ */
+export declare const readAppBuild: () => number | null;
+//# sourceMappingURL=appBuild.d.ts.map

package/lib/typescript/module/versionCheck/index.d.ts

@@ -1,19 +1,5 @@
 import { type Environment } from '../config/index.js';
-/**
- * Minimal device-info shape we depend on.
- *
- * This is a LAST RESORT, not the primary path. Every Webority app carries its
- * store id and build number in `appsettings.Compiled.json`, so
- * `setConfig({ appId, appBuild })` covers both without a native module, and
- * expo-application covers an app that wires neither. `getBuildNumber` is
- * optional so an injector written before the server-driven check still fits;
- * without it the build number comes from expo-application.
- */
-interface DeviceInfoLike {
-    getBundleId: () => string;
-    getVersion: () => string;
-    getBuildNumber?: () => string;
-}
+import { type DeviceInfoLike } from './appBuild.js';
 /**
  * Supply the app identity from a native module instead of config.
  * Prefer `setConfig({ appId, appBuild })` — it needs no native dependency.
@@ -86,6 +72,7 @@ export declare const VersionCheck: VersionCheckType;
  */
 export declare const useVersionCheck: (isAppReady: boolean, environment?: Environment) => UpdateInfo;
 export default VersionCheck;
+export { readAppBuild } from './appBuild.js';
 export { isBuildBelowMinimum, parseBuildNumber } from './buildNumber.js';
 export type { DeviceInfoLike };
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webority/mobile-core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Platform layer for Webority React Native apps: HTTP clients, auth/token storage, config, logging, formatters, validators, network status, permissions, storage, version checks and over-the-air updates. No UI.",
   "keywords": [
     "react-native",
@@ -162,6 +162,16 @@
         "default": "./lib/commonjs/share/index.js"
       }
     },
+    "./review": {
+      "import": {
+        "types": "./lib/typescript/module/review/index.d.ts",
+        "default": "./lib/module/review/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/review/index.d.ts",
+        "default": "./lib/commonjs/review/index.js"
+      }
+    },
     "./secureScreen": {
       "import": {
         "types": "./lib/typescript/module/secureScreen/index.d.ts",
@@ -299,6 +309,7 @@
     "expo-secure-store": ">=57.0.0",
     "expo-sharing": ">=57.0.0",
     "expo-sqlite": ">=57.0.0",
+    "expo-store-review": ">=57.0.0",
     "expo-task-manager": ">=57.0.0",
     "expo-updates": ">=57.0.0",
     "react": "^19.1.0",
@@ -342,6 +353,9 @@
     "expo-sharing": {
       "optional": true
     },
+    "expo-store-review": {
+      "optional": true
+    },
     "expo-task-manager": {
       "optional": true
     },