@webority/mobile-core 0.15.0 → 0.16.0

package/lib/module/push/push.js

@@ -1 +1 @@
-"use strict";import{useSyncExternalStore}from"react";import{Platform}from"react-native";import{Logger}from"../logger/index.js";let resolved,override=null;export const setPushImplementation=e=>{override=e};export const resolveModules=()=>{if(override)return override;if(void 0!==resolved)return resolved;try{if(require("expo").isRunningInExpoGo())return resolved=null,resolved;const e=require("expo-notifications"),t=require("expo-application");resolved={notifications:e,applicationId:t.applicationId,getApnsEnvironment:()=>t.getIosPushNotificationServiceEnvironmentAsync()}}catch(e){Logger.warn("[push] expo-notifications is not available; push is off",e),resolved=null}return resolved};let state={status:"unknown",enabled:!1};const subscribers=new Set,setState=e=>{state={...state,...e};for(const e of subscribers)e()};let config=null,channelsReady=Promise.resolve(),tokenSubscription=null,actionHandler=null;const receiveHandlers=new Set;let listening=!1,listeningForReceived=!1;const pendingResponses=[],routedAt=new Map,REPEAT_WINDOW_MS=1e4,requireConfig=()=>{if(!config)throw new Error("[@webority/mobile-core] call initPush before enablePush or disablePush.");return config},toPermissionStatus=e=>e.granted?"granted":"denied"===e.status?e.canAskAgain?"denied":"blocked":"undetermined",toStringData=e=>{const t={};for(const[n,o]of Object.entries(e??{}))null!=o&&(t[n]="object"==typeof o?JSON.stringify(o):String(o));return t},contentData=e=>{const t=e.request.content;if(t.data)return toStringData(t.data);if("string"==typeof t.dataString)try{return toStringData(JSON.parse(t.dataString))}catch(e){Logger.error("[push] notification data is not JSON",e)}return{}},triggerData=e=>{const t=e.request.trigger,n={...t?.remoteMessage?.data??{}};for(const[e,o]of Object.entries(t?.payload??{}))"aps"===e||"body"===e&&"object"==typeof o||(n[e]=o);return toStringData(n)},notificationData=e=>({...triggerData(e),...contentData(e)}),responseData=e=>notificationData(e.notification);export const toPushReceived=e=>({notificationId:e.request.identifier,title:e.request.content.title??null,body:e.request.content.body??null,data:notificationData(e)});export const toPushAction=e=>({actionId:e.actionIdentifier,...e.userText?{userText:e.userText}:{},data:responseData(e),notificationId:e.notification.request.identifier});export const toNotificationActions=e=>e.map(e=>({identifier:e.id,buttonTitle:e.title,...e.textInput?{textInput:{submitButtonTitle:e.textInput.submitTitle,placeholder:e.textInput.placeholder}}:{},options:{opensAppToForeground:e.opensApp??!0,isDestructive:e.destructive??!1,isAuthenticationRequired:e.authenticationRequired??!1}}));const routeResponse=async(e,t)=>{const n=`${t.notification.request.identifier}:${t.actionIdentifier}`,o=routedAt.get(n);if(void 0!==o&&Date.now()-o<1e4)return;if(t.actionIdentifier!==e.DEFAULT_ACTION_IDENTIFIER&&actionHandler){routedAt.set(n,Date.now());try{await actionHandler(toPushAction(t))}catch(e){Logger.error("[push] onAction threw",e)}}else if(config){routedAt.set(n,Date.now());try{config.onOpen(responseData(t))}catch(e){Logger.error("[push] onOpen threw",e)}}else pendingResponses.push(t)},drainPending=async e=>{const t=pendingResponses.splice(0);for(const n of t)await routeResponse(e,n)},listenForResponses=e=>{listening||(listening=!0,e.addNotificationResponseReceivedListener(t=>{routeResponse(e,t)}),e.getLastNotificationResponseAsync().then(async t=>(t&&await routeResponse(e,t),e.clearLastNotificationResponseAsync?.())).catch(e=>Logger.error("[push] reading the launch notification failed",e)))};export const routeTaskPayload=async e=>{const t=resolveModules(),n=e;t&&"string"==typeof n?.actionIdentifier&&"string"==typeof n.notification?.request?.identifier&&await routeResponse(t.notifications,n)};const createChannels=async(e,t)=>{for(const n of t)try{await e.setNotificationChannelAsync(n.id,{name:n.name,importance:"high"===n.importance?e.AndroidImportance.HIGH:e.AndroidImportance.DEFAULT})}catch(e){Logger.error(`[push] creating channel ${n.id} failed`,e)}},APNS_ENVIRONMENTS={development:"Development",production:"Production"},readApnsEnvironment=async e=>{try{return APNS_ENVIRONMENTS[await e.getApnsEnvironment()??""]??null}catch(e){return Logger.warn("[push] reading the APNs environment failed",e),null}},toDevice=async(e,t)=>{const n="android"===e.type?"Fcm":"ios"===e.type?"Apns":null;if(!n||"string"!=typeof e.data)return null;if(!t.applicationId)throw new Error("[@webority/mobile-core] push needs the app bundle id from expo-application.");return{installationId:await requireConfig().getInstallationId(),platform:n,token:e.data,appId:t.applicationId,apnsEnvironment:"Apns"===n?await readApnsEnvironment(t):null}};export const initPush=e=>{const t=null===config;if(config=e,!t)return;const n=resolveModules();if(!n)return void setState({status:"unavailable"});const o=n.notifications;o.setNotificationHandler({handleNotification:async()=>{const e=config?.showInForeground?.()??!0;return{shouldShowBanner:e,shouldShowList:e,shouldPlaySound:e&&(config?.playSoundInForeground?.()??!0),shouldSetBadge:!0}}}),"android"===Platform.OS&&e.androidChannels?.length&&(channelsReady=createChannels(o,e.androidChannels)),listenForResponses(o),drainPending(o),o.getPermissionsAsync().then(e=>setState({status:toPermissionStatus(e)})).catch(e=>Logger.error("[push] permission check failed",e))};let registering=null,registeredKey=null,unregistering=null,tokenDrop=Promise.resolve();const registerOnce=e=>{const t=JSON.stringify(e);if(registering?.key===t)return registering.promise;const n=requireConfig().register(e).then(()=>{registeredKey=t}).finally(()=>{registering?.promise===n&&(registering=null)});return registering={key:t,promise:n},n};export const enablePush=async({prompt:e=!0}={})=>{requireConfig();const t=resolveModules();if(!t)return setState({status:"unavailable"}),"unavailable";const n=t.notifications;await channelsReady,await tokenDrop;let o=await n.getPermissionsAsync();if(!o.granted&&e&&(o=await n.requestPermissionsAsync()),!o.granted){const e=toPermissionStatus(o);return setState({status:e}),e}const i=await toDevice(await n.getDevicePushTokenAsync(),t);return i?(await registerOnce(i),tokenSubscription?.remove(),tokenSubscription=n.addPushTokenListener(e=>{(unregistering??Promise.resolve()).then(()=>state.enabled?toDevice(e,t):null).then(e=>e&&JSON.stringify(e)!==registeredKey?registerOnce(e):void 0).catch(e=>Logger.error("[push] re-registering a new token failed",e))}),setState({status:"granted",enabled:!0}),"granted"):(setState({status:"unavailable"}),"unavailable")};const stopFollowingToken=()=>{tokenSubscription?.remove(),tokenSubscription=null,registeredKey=null,setState({enabled:!1})};export const disablePush=async()=>{const e=requireConfig(),t=await e.getInstallationId();await(registering?.promise.catch(()=>{}));let settle=()=>{};const n=new Promise(e=>{settle=e});unregistering=n;try{await e.unregister(t),stopFollowingToken()}finally{unregistering===n&&(unregistering=null),settle()}};export const resetPush=async()=>{stopFollowingToken();const e=resolveModules();if(!e)return;const t=e.notifications.unregisterForNotificationsAsync();tokenDrop=t.catch(()=>{}),await t};export const setBadgeCount=async e=>{const t=resolveModules();t&&await t.notifications.setBadgeCountAsync(e)};export const dismissAllNotifications=async()=>{const e=resolveModules();if(e)try{await e.notifications.dismissAllNotificationsAsync()}catch(e){Logger.warn("[push] dismissing the notifications failed",e)}};export const setCategories=async e=>{const t=resolveModules();if(t)for(const n of e)await t.notifications.setNotificationCategoryAsync(n.id,toNotificationActions(n.actions))};export const onAction=e=>{actionHandler=e;const t=resolveModules();return t&&(listenForResponses(t.notifications),drainPending(t.notifications)),()=>{actionHandler===e&&(actionHandler=null)}};export const onReceive=e=>{receiveHandlers.add(e);const t=resolveModules();return t&&!listeningForReceived&&(listeningForReceived=!0,t.notifications.addNotificationReceivedListener(e=>{const t=toPushReceived(e);for(const e of[...receiveHandlers])try{e(t)}catch(e){Logger.error("[push] onReceive threw",e)}})),()=>{receiveHandlers.delete(e)}};export const notifyLocal=async({title:e,body:t,data:n})=>{const o=resolveModules();o&&await o.notifications.scheduleNotificationAsync({content:{title:e,body:t,data:n??{}},trigger:null})};const subscribe=e=>(subscribers.add(e),()=>{subscribers.delete(e)}),getSnapshot=()=>state,enable=async()=>{await enablePush()};export const usePush=()=>({...useSyncExternalStore(subscribe,getSnapshot,getSnapshot),enable:enable,disable:disablePush});
+"use strict";import{useSyncExternalStore}from"react";import{Platform}from"react-native";import{Logger}from"../logger/index.js";let resolved,override=null;export const setPushImplementation=e=>{override=e};export const resolveModules=()=>{if(override)return override;if(void 0!==resolved)return resolved;try{if(require("expo").isRunningInExpoGo())return resolved=null,resolved;const e=require("expo-notifications"),t=require("expo-application");resolved={notifications:e,applicationId:t.applicationId,getApnsEnvironment:()=>t.getIosPushNotificationServiceEnvironmentAsync()}}catch(e){Logger.warn("[push] expo-notifications is not available; push is off",e),resolved=null}return resolved};let state={status:"unknown",enabled:!1};const subscribers=new Set,setState=e=>{state={...state,...e};for(const e of subscribers)e()};let config=null,channelsReady=Promise.resolve(),tokenSubscription=null,actionHandler=null;const receiveHandlers=new Set;let listening=!1,listeningForReceived=!1;const pendingResponses=[],routedAt=new Map,REPEAT_WINDOW_MS=1e4,requireConfig=()=>{if(!config)throw new Error("[@webority/mobile-core] call initPush before enablePush or disablePush.");return config},toPermissionStatus=e=>e.granted?"granted":"denied"===e.status?e.canAskAgain?"denied":"blocked":"undetermined",toStringData=e=>{const t={};for(const[n,o]of Object.entries(e??{}))null!=o&&(t[n]="object"==typeof o?JSON.stringify(o):String(o));return t},contentData=e=>{const t=e.request.content;if(t.data)return toStringData(t.data);if("string"==typeof t.dataString)try{return toStringData(JSON.parse(t.dataString))}catch(e){Logger.error("[push] notification data is not JSON",e)}return{}},triggerData=e=>{const t=e.request.trigger,n={...t?.remoteMessage?.data??{}};for(const[e,o]of Object.entries(t?.payload??{}))"aps"===e||"body"===e&&"object"==typeof o||(n[e]=o);return toStringData(n)},notificationData=e=>({...triggerData(e),...contentData(e)}),responseData=e=>notificationData(e.notification);export const toPushReceived=e=>({notificationId:e.request.identifier,title:e.request.content.title??null,body:e.request.content.body??null,data:notificationData(e)});export const toPushAction=e=>({actionId:e.actionIdentifier,...e.userText?{userText:e.userText}:{},data:responseData(e),notificationId:e.notification.request.identifier});export const toNotificationActions=e=>e.map(e=>({identifier:e.id,buttonTitle:e.title,...e.textInput?{textInput:{submitButtonTitle:e.textInput.submitTitle,placeholder:e.textInput.placeholder}}:{},options:{opensAppToForeground:e.opensApp??!0,isDestructive:e.destructive??!1,isAuthenticationRequired:e.authenticationRequired??!1}}));const routeResponse=async(e,t)=>{const n=`${t.notification.request.identifier}:${t.actionIdentifier}`,o=routedAt.get(n);if(void 0!==o&&Date.now()-o<1e4)return;if(t.actionIdentifier!==e.DEFAULT_ACTION_IDENTIFIER&&actionHandler){routedAt.set(n,Date.now());try{await actionHandler(toPushAction(t))}catch(e){Logger.error("[push] onAction threw",e)}}else if(config){routedAt.set(n,Date.now());try{config.onOpen(responseData(t))}catch(e){Logger.error("[push] onOpen threw",e)}}else pendingResponses.push(t)},drainPending=async e=>{const t=pendingResponses.splice(0);for(const n of t)await routeResponse(e,n)},listenForResponses=e=>{listening||(listening=!0,e.addNotificationResponseReceivedListener(t=>{routeResponse(e,t)}),e.getLastNotificationResponseAsync().then(async t=>(t&&await routeResponse(e,t),e.clearLastNotificationResponseAsync?.())).catch(e=>Logger.error("[push] reading the launch notification failed",e)))};export const routeTaskPayload=async e=>{const t=resolveModules(),n=e;t&&"string"==typeof n?.actionIdentifier&&"string"==typeof n.notification?.request?.identifier&&await routeResponse(t.notifications,n)};const createChannels=async(e,t)=>{for(const n of t)try{await e.setNotificationChannelAsync(n.id,{name:n.name,importance:"high"===n.importance?e.AndroidImportance.HIGH:e.AndroidImportance.DEFAULT})}catch(e){Logger.error(`[push] creating channel ${n.id} failed`,e)}},APNS_ENVIRONMENTS={development:"Development",production:"Production"},readApnsEnvironment=async e=>{try{return APNS_ENVIRONMENTS[await e.getApnsEnvironment()??""]??null}catch(e){return Logger.warn("[push] reading the APNs environment failed",e),null}},deviceTimeZone=()=>Intl.DateTimeFormat().resolvedOptions().timeZone||null,toDevice=async(e,t)=>{const n="android"===e.type?"Fcm":"ios"===e.type?"Apns":null;if(!n||"string"!=typeof e.data)return null;if(!t.applicationId)throw new Error("[@webority/mobile-core] push needs the app bundle id from expo-application.");return{installationId:await requireConfig().getInstallationId(),platform:n,token:e.data,appId:t.applicationId,apnsEnvironment:"Apns"===n?await readApnsEnvironment(t):null,timeZone:deviceTimeZone()}};export const initPush=e=>{const t=null===config;if(config=e,!t)return;const n=resolveModules();if(!n)return void setState({status:"unavailable"});const o=n.notifications;o.setNotificationHandler({handleNotification:async()=>{const e=config?.showInForeground?.()??!0;return{shouldShowBanner:e,shouldShowList:e,shouldPlaySound:e&&(config?.playSoundInForeground?.()??!0),shouldSetBadge:!0}}}),"android"===Platform.OS&&e.androidChannels?.length&&(channelsReady=createChannels(o,e.androidChannels)),listenForResponses(o),drainPending(o),o.getPermissionsAsync().then(e=>setState({status:toPermissionStatus(e)})).catch(e=>Logger.error("[push] permission check failed",e))};let registering=null,registeredKey=null,unregistering=null,tokenDrop=Promise.resolve();const registerOnce=e=>{const t=JSON.stringify(e);if(registering?.key===t)return registering.promise;const n=requireConfig().register(e).then(()=>{registeredKey=t}).finally(()=>{registering?.promise===n&&(registering=null)});return registering={key:t,promise:n},n};export const enablePush=async({prompt:e=!0}={})=>{requireConfig();const t=resolveModules();if(!t)return setState({status:"unavailable"}),"unavailable";const n=t.notifications;await channelsReady,await tokenDrop;let o=await n.getPermissionsAsync();if(!o.granted&&e&&(o=await n.requestPermissionsAsync()),!o.granted){const e=toPermissionStatus(o);return setState({status:e}),e}const i=await toDevice(await n.getDevicePushTokenAsync(),t);return i?(await registerOnce(i),tokenSubscription?.remove(),tokenSubscription=n.addPushTokenListener(e=>{(unregistering??Promise.resolve()).then(()=>state.enabled?toDevice(e,t):null).then(e=>e&&JSON.stringify(e)!==registeredKey?registerOnce(e):void 0).catch(e=>Logger.error("[push] re-registering a new token failed",e))}),setState({status:"granted",enabled:!0}),"granted"):(setState({status:"unavailable"}),"unavailable")};const stopFollowingToken=()=>{tokenSubscription?.remove(),tokenSubscription=null,registeredKey=null,setState({enabled:!1})};export const disablePush=async()=>{const e=requireConfig(),t=await e.getInstallationId();await(registering?.promise.catch(()=>{}));let settle=()=>{};const n=new Promise(e=>{settle=e});unregistering=n;try{await e.unregister(t),stopFollowingToken()}finally{unregistering===n&&(unregistering=null),settle()}};export const resetPush=async()=>{stopFollowingToken();const e=resolveModules();if(!e)return;const t=e.notifications.unregisterForNotificationsAsync();tokenDrop=t.catch(()=>{}),await t};export const setBadgeCount=async e=>{const t=resolveModules();t&&await t.notifications.setBadgeCountAsync(e)};export const dismissAllNotifications=async()=>{const e=resolveModules();if(e)try{await e.notifications.dismissAllNotificationsAsync()}catch(e){Logger.warn("[push] dismissing the notifications failed",e)}};export const setCategories=async e=>{const t=resolveModules();if(t)for(const n of e)await t.notifications.setNotificationCategoryAsync(n.id,toNotificationActions(n.actions))};export const onAction=e=>{actionHandler=e;const t=resolveModules();return t&&(listenForResponses(t.notifications),drainPending(t.notifications)),()=>{actionHandler===e&&(actionHandler=null)}};export const onReceive=e=>{receiveHandlers.add(e);const t=resolveModules();return t&&!listeningForReceived&&(listeningForReceived=!0,t.notifications.addNotificationReceivedListener(e=>{const t=toPushReceived(e);for(const e of[...receiveHandlers])try{e(t)}catch(e){Logger.error("[push] onReceive threw",e)}})),()=>{receiveHandlers.delete(e)}};export const notifyLocal=async({title:e,body:t,data:n})=>{const o=resolveModules();o&&await o.notifications.scheduleNotificationAsync({content:{title:e,body:t,data:n??{}},trigger:null})};const subscribe=e=>(subscribers.add(e),()=>{subscribers.delete(e)}),getSnapshot=()=>state,enable=async()=>{await enablePush()};export const usePush=()=>({...useSyncExternalStore(subscribe,getSnapshot,getSnapshot),enable:enable,disable:disablePush});

package/lib/module/utils/imageCompression.js

@@ -1 +1 @@
-"use strict";import{File}from"expo-file-system";import{ImageManipulator}from"expo-image-manipulator";import{Logger}from"../logger/index.js";export class ImageUnreadableError extends Error{constructor(e,t){super(`Image is unreadable (${t}): ${e||"<empty uri>"}`),this.name="ImageUnreadableError",this.uri=e}}const release=e=>{try{e?.release?.()}catch{}},expoBackend={stat:async e=>{const t=new File(e);return t.exists?null==t.size?null:{exists:!0,size:t.size}:{exists:!1,size:0}},remove:async e=>{new File(e).delete()},open:async e=>{const t=ImageManipulator.manipulate(e);let i;try{i=await t.renderAsync()}finally{release(t)}return{width:i.width,height:i.height,encode:async({width:e,height:t,quality:a,format:r})=>{const n=ImageManipulator.manipulate(i);let o=null;try{void 0===e&&void 0===t||n.resize({width:e??null,height:t??null}),o=await n.renderAsync();const i=await o.saveAsync({compress:a,format:r});return{uri:i.uri,width:i.width,height:i.height}}finally{release(o),release(n)}},close:()=>release(i)}}};let backend=null;export const setImageCompressorImplementation=e=>{backend=e};const resolveBackend=()=>backend??expoBackend,EIGHT_MB=8388608,THREE_MB=3145728;export const qualityForFileSize=e=>null==e?.7:e>8388608?.6:e>3145728?.7:.8;const DEFAULT_MAX_SIZE=1500,DEFAULT_MIN_QUALITY=.4,QUALITY_STEP=.1,SIZE_STEP=.75,MIN_SIDE=320,FORMAT={jpg:{encode:"jpeg",mimeType:"image/jpeg"},png:{encode:"png",mimeType:"image/png"},webp:{encode:"webp",mimeType:"image/webp"}},MIME_BY_EXTENSION={jpg:"image/jpeg",jpeg:"image/jpeg",png:"image/png",webp:"image/webp",gif:"image/gif",heic:"image/heic",heif:"image/heif",bmp:"image/bmp",tif:"image/tiff",tiff:"image/tiff"},lastSegment=e=>{const t=e.split(/[?#]/)[0]??"";return decodeURIComponentSafe(t.slice(t.lastIndexOf("/")+1))},decodeURIComponentSafe=e=>{try{return decodeURIComponent(e)}catch{return e}},extensionOf=e=>{const t=e.lastIndexOf(".");return t>0?e.slice(t+1).toLowerCase():""},withoutExtension=e=>{const t=e.lastIndexOf(".");return t>0?e.slice(0,t):e},baseNameFor=(e,t)=>withoutExtension(t?.trim()||lastSegment(e))||"image",round1=e=>Math.round(10*e)/10,safeStat=async(e,t)=>{try{return await e.stat(t)}catch{return null}},safeRemove=async(e,t)=>{try{await e.remove(t)}catch{}},renderWithin=async(e,t,i,a,r)=>{const n=Math.max(t.width,t.height)>i?t.width>=t.height?{width:i}:{height:i}:{},o=await t.encode({...n,quality:a,format:r}),s=await safeStat(e,o.uri);if(s&&(!s.exists||0===s.size))throw await safeRemove(e,o.uri),new ImageUnreadableError(o.uri,"the encoder wrote an empty file");return{...o,size:s?.size??null}},originalResult=(e,t,i,a)=>{const r=extensionOf(lastSegment(e))||"jpg",n=MIME_BY_EXTENSION[r]??"image/jpeg",o=`${i}.${r}`;return{uri:e,width:a?.width??null,height:a?.height??null,size:t,mimeType:n,extension:r,fileName:o,compressed:!1,quality:null,part:{uri:e,name:o,type:n}}};export const compressImage=async(e,t={})=>{if(!e)throw new ImageUnreadableError(e,"no uri");const i=resolveBackend(),{maxSize:a=DEFAULT_MAX_SIZE,output:r="jpg",maxBytes:n,minQuality:o=DEFAULT_MIN_QUALITY,name:s}=t,l=FORMAT[r]??FORMAT.jpg,m=baseNameFor(e,s),g=await safeStat(i,e);if(g&&!g.exists)throw new ImageUnreadableError(e,"the file does not exist");if(g&&0===g.size)throw new ImageUnreadableError(e,"the file is empty");const h=g?.size??t.fileSize??null;let c;try{c=await i.open(e)}catch(t){throw Logger.error("[imageCompression] could not decode the image",t),new ImageUnreadableError(e,"the photo could not be decoded")}try{let e=t.quality??qualityForFileSize(h),s=a,g=await renderWithin(i,c,s,e,l.encode);if(void 0!==n)for(;null!==g.size&&g.size>n;){if("png"!==r&&round1(e-.1)>=o)e=round1(e-.1);else{const e=Math.max(g.width,g.height);if(e<=320)break;s=Math.max(320,Math.floor(.75*e))}const t=await renderWithin(i,c,s,e,l.encode);await safeRemove(i,g.uri),g=t}const p=`${m}.${r}`;return{uri:g.uri,width:g.width,height:g.height,size:g.size,mimeType:l.mimeType,extension:r,fileName:p,compressed:!0,quality:"png"===r?null:e,part:{uri:g.uri,name:p,type:l.mimeType}}}catch(t){if(t instanceof ImageUnreadableError)throw t;Logger.error("[imageCompression] encoding failed; retrying once as jpeg at quality 0.7",t);try{const e=await renderWithin(i,c,a,.7,"jpeg"),t=`${m}.jpg`;return{uri:e.uri,width:e.width,height:e.height,size:e.size,mimeType:"image/jpeg",extension:"jpg",fileName:t,compressed:!0,quality:.7,part:{uri:e.uri,name:t,type:"image/jpeg"}}}catch(t){if(t instanceof ImageUnreadableError)throw t;Logger.error("[imageCompression] jpeg retry failed",t);if(Math.max(c.width,c.height)<=a&&(void 0===n||null!==h&&h<=n))return originalResult(e,h,m,{width:c.width,height:c.height});throw new ImageUnreadableError(e,"the photo could not be prepared for upload")}}finally{c.close()}};
+"use strict";import{File}from"expo-file-system";import{ImageManipulator}from"expo-image-manipulator";import{Logger}from"../logger/index.js";export class ImageUnreadableError extends Error{constructor(e,t){super(`Image is unreadable (${t}): ${e||"<empty uri>"}`),this.name="ImageUnreadableError",this.uri=e}}const release=e=>{try{e?.release?.()}catch{}},expoBackend={stat:async e=>{const t=new File(e);return t.exists?null==t.size?null:{exists:!0,size:t.size}:{exists:!1,size:0}},remove:async e=>{new File(e).delete()},open:async e=>{const t=ImageManipulator.manipulate(e);let i;try{i=await t.renderAsync()}finally{release(t)}return{width:i.width,height:i.height,encode:async({width:e,height:t,quality:a,format:r})=>{const n=ImageManipulator.manipulate(i);let o=null;try{void 0===e&&void 0===t||n.resize({width:e??null,height:t??null}),o=await n.renderAsync();const i=await o.saveAsync({compress:a,format:r});return{uri:i.uri,width:i.width,height:i.height}}finally{release(o),release(n)}},close:()=>release(i)}}};let backend=null;export const setImageCompressorImplementation=e=>{backend=e};const resolveBackend=()=>backend??expoBackend,EIGHT_MB=8388608,THREE_MB=3145728;export const qualityForFileSize=e=>null==e?.7:e>8388608?.6:e>3145728?.7:.8;const DEFAULT_MAX_SIZE=1500,DEFAULT_MIN_QUALITY=.4,QUALITY_STEP=.1,SIZE_STEP=.75,MIN_SIDE=320,FORMAT={jpg:{encode:"jpeg",mimeType:"image/jpeg"},png:{encode:"png",mimeType:"image/png"},webp:{encode:"webp",mimeType:"image/webp"}},MIME_BY_EXTENSION={jpg:"image/jpeg",jpeg:"image/jpeg",png:"image/png",webp:"image/webp",gif:"image/gif",heic:"image/heic",heif:"image/heif",bmp:"image/bmp",tif:"image/tiff",tiff:"image/tiff"},lastSegment=e=>{const t=e.split(/[?#]/)[0]??"";return decodeURIComponentSafe(t.slice(t.lastIndexOf("/")+1))},decodeURIComponentSafe=e=>{try{return decodeURIComponent(e)}catch{return e}},extensionOf=e=>{const t=e.lastIndexOf(".");return t>0?e.slice(t+1).toLowerCase():""},withoutExtension=e=>{const t=e.lastIndexOf(".");return t>0?e.slice(0,t):e},baseNameFor=(e,t)=>withoutExtension(t?.trim()||lastSegment(e))||"image",round1=e=>Math.round(10*e)/10,safeStat=async(e,t)=>{try{return await e.stat(t)}catch{return null}},safeRemove=async(e,t)=>{try{await e.remove(t)}catch{}},renderWithin=async(e,t,i,a,r)=>{const n=Math.max(t.width,t.height)>i?t.width>=t.height?{width:i}:{height:i}:{},o=await t.encode({...n,quality:a,format:r}),s=await safeStat(e,o.uri);if(s&&(!s.exists||0===s.size))throw await safeRemove(e,o.uri),new ImageUnreadableError(o.uri,"the encoder wrote an empty file");return{...o,size:s?.size??null}},originalResult=(e,t,i,a)=>{const r=extensionOf(lastSegment(e))||"jpg",n=MIME_BY_EXTENSION[r]??"image/jpeg",o=`${i}.${r}`;return{uri:e,width:a?.width??null,height:a?.height??null,size:t,mimeType:n,extension:r,fileName:o,compressed:!1,quality:null,part:{uri:e,name:o,type:n}}};export const compressImage=async(e,t={})=>{if(!e)throw new ImageUnreadableError(e,"no uri");const i=resolveBackend(),{maxSize:a=DEFAULT_MAX_SIZE,output:r="jpg",maxBytes:n,minQuality:o=DEFAULT_MIN_QUALITY,name:s}=t,l=FORMAT[r]??FORMAT.jpg,m=baseNameFor(e,s),g=await safeStat(i,e);if(g&&!g.exists)throw new ImageUnreadableError(e,"the file does not exist");if(g&&0===g.size)throw new ImageUnreadableError(e,"the file is empty");const h=g?.size??t.fileSize??null;let c,p;try{c=await i.open(e)}catch(t){throw Logger.error("[imageCompression] could not decode the image",t),new ImageUnreadableError(e,"the photo could not be decoded")}try{let e=t.quality??qualityForFileSize(h),s=a;if(p=await renderWithin(i,c,s,e,l.encode),void 0!==n)for(;null!==p.size&&p.size>n;){if("png"!==r&&round1(e-.1)>=o)e=round1(e-.1);else{const e=Math.max(p.width,p.height);if(e<=320)break;s=Math.max(320,Math.floor(.75*e))}const t=await renderWithin(i,c,s,e,l.encode);await safeRemove(i,p.uri),p=t}const g=`${m}.${r}`;return{uri:p.uri,width:p.width,height:p.height,size:p.size,mimeType:l.mimeType,extension:r,fileName:g,compressed:!0,quality:"png"===r?null:e,part:{uri:p.uri,name:g,type:l.mimeType}}}catch(t){if(p&&await safeRemove(i,p.uri),t instanceof ImageUnreadableError)throw t;Logger.error("[imageCompression] encoding failed; retrying once as jpeg at quality 0.7",t);try{const e=await renderWithin(i,c,a,.7,"jpeg"),t=`${m}.jpg`;return{uri:e.uri,width:e.width,height:e.height,size:e.size,mimeType:"image/jpeg",extension:"jpg",fileName:t,compressed:!0,quality:.7,part:{uri:e.uri,name:t,type:"image/jpeg"}}}catch(t){if(t instanceof ImageUnreadableError)throw t;Logger.error("[imageCompression] jpeg retry failed",t);if(Math.max(c.width,c.height)<=a&&(void 0===n||null!==h&&h<=n))return originalResult(e,h,m,{width:c.width,height:c.height});throw new ImageUnreadableError(e,"the photo could not be prepared for upload")}}finally{c.close()}};

package/lib/typescript/commonjs/errors/extractApiError.d.ts

@@ -12,9 +12,9 @@
  * legacy `error`, `title`, then `Request failed (<status>)`. `title` is last because it is
  * the ProblemDetails category ("Bad Request"), not the curated sentence.
  *
- * Two things never become `message`: a 5xx body (our failure, nothing the user can act on)
- * and anything that reads like an exception dump. The server's text goes on `detail` for
- * the logger instead.
+ * Never a `message`: anything that reads like an exception dump, and a 5xx body unless it is
+ * coded (not `internal_error`) and its `message` is user-safe. The server's text goes on
+ * `detail` for the logger either way.
  */
 export interface ApiError {
     /** Stable snake_case branch key from the server (`not_found`, `validation_failed`). Branch on it, never render it. */
@@ -36,14 +36,17 @@ export declare const SERVER_FAILURE_MESSAGE = "Something went wrong on our side.
 export declare const OFFLINE_MESSAGE = "You appear to be offline. Check your connection and try again.";
 export declare const TIMEOUT_MESSAGE = "That took too long to respond. Check your connection and try again.";
 export declare const UNEXPECTED_MESSAGE = "Something went wrong. Please try again.";
+export declare const UNREACHABLE_MESSAGE = "We couldn't reach the server. Check your connection and try again.";
 /** `code` for a request the caller cancelled (axios `CanceledError`). Never toasted. */
 export declare const REQUEST_CANCELED_CODE = "request_canceled";
 /** `code` for a response that failed schema validation at the service boundary. */
 export declare const CONTRACT_ERROR_CODE = "contract_error";
 /** `code` for a request that got no answer in time (axios `ECONNABORTED` / `ETIMEDOUT`). `offline` is true. */
 export declare const TIMEOUT_CODE = "timeout";
-/** `code` for a request that never reached the server (offline, DNS, CORS, a dropped connection). `offline` is true. */
+/** `code` for a request that got no answer from the server (DNS, CORS, a dropped connection, a server that is down). `offline` is true. */
 export declare const NETWORK_CODE = "network";
+/** `code` for a request refused because the device reports no connection. `offline` is true. */
+export declare const OFFLINE_CODE = "offline";
 /** `Items[0].UnitPrice` -> `items[0].unitPrice`; `$.email` (System.Text.Json path) -> `email`. */
 export declare const toFieldPath: (key: string) => string;
 export declare const isApiError: (value: unknown) => value is ApiError;
@@ -57,8 +60,8 @@ export declare const isNoResponse: (error: unknown) => boolean;
  * The sentence a screen shows for a failure: the server's own curated message when it sent one,
  * otherwise the screen's `fallback` ("We couldn't save the project."), otherwise the library's
  * generic sentence. A lost answer always reads as the connection message, because "check your
- * connection" is more accurate than any screen's fallback. A 5xx, a cancelled request and a body
- * with no usable sentence count as "the server said nothing usable".
+ * connection" is more accurate than any screen's fallback. A 5xx without a curated sentence, a
+ * cancelled request and a body with no usable sentence count as "the server said nothing usable".
  *
  * `fallback: null` is the "say nothing" mode, for a screen that shows only what the server
  * curated (a live panel that keeps its last result): it returns null when the server said

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

@@ -1,3 +1,3 @@
 export type { ApiError } from './extractApiError';
-export { apiErrorMessage, CONTRACT_ERROR_CODE, extractApiError, isApiError, isNoResponse, NETWORK_CODE, OFFLINE_MESSAGE, REQUEST_CANCELED_CODE, SERVER_FAILURE_MESSAGE, TIMEOUT_CODE, TIMEOUT_MESSAGE, toFieldPath, UNEXPECTED_MESSAGE } from './extractApiError';
+export { apiErrorMessage, CONTRACT_ERROR_CODE, extractApiError, isApiError, isNoResponse, NETWORK_CODE, OFFLINE_CODE, OFFLINE_MESSAGE, REQUEST_CANCELED_CODE, SERVER_FAILURE_MESSAGE, TIMEOUT_CODE, TIMEOUT_MESSAGE, toFieldPath, UNEXPECTED_MESSAGE, UNREACHABLE_MESSAGE } from './extractApiError';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/formatters/currency.d.ts

@@ -3,7 +3,7 @@
  * `signDisplay`, ...), passed through to Intl.NumberFormat.
  */
 export interface FormatCurrencyOptions extends Omit<Intl.NumberFormatOptions, 'style' | 'currency'> {
-    /** ISO 4217 currency code. Defaults to `'INR'`. */
+    /** ISO 4217 currency code. A missing or empty one warns and prints INR. */
     currency?: string;
     /** BCP-47 locale tag. Defaults to the configured locale, else `'en-IN'` (Indian numbering system). */
     locale?: string;
@@ -20,9 +20,10 @@ export interface FormatCurrencyOptions extends Omit<Intl.NumberFormatOptions, 's
     empty?: string;
 }
 /**
- * Format an amount as currency. Defaults to **INR** with Indian numbering (`en-IN`),
- * which matches the standard convention across Webority projects. Called with no
- * options: "₹1,50,000" for 150000, "₹1,234.50" for 1234.5, and `''` for a missing amount.
+ * Format an amount as currency. Pass an ISO 4217 code: a missing or empty one warns and
+ * prints **INR** with Indian numbering (`en-IN`), the convention across Webority projects.
+ * With `{ currency: 'INR' }`: "₹1,50,000" for 150000, "₹1,234.50" for 1234.5, and `''` for a
+ * missing amount.
  * Once the app configures a locale (`configureFormatters({ locale })`), the amount is
  * written in that locale and a missing amount prints the configured placeholder ("-").
  * A configured `numberStyle` sets the decimal mark and group separator; the locale keeps
@@ -31,11 +32,11 @@ export interface FormatCurrencyOptions extends Omit<Intl.NumberFormatOptions, 's
  * use `formatMinor`.
  *
  * @example
- * formatCurrency(150000)            // ₹1,50,000
- * formatCurrency(1234.5)            // ₹1,234.50
- * formatCurrency(99, { currency: 'USD', locale: 'en-US' }) // $99
- * formatCurrency(150000, { stripSymbol: true })            // 1,50,000
- * formatCurrency(1500000, { notation: 'compact' })         // ₹15L
+ * formatCurrency(150000, { currency: 'INR' })                  // ₹1,50,000
+ * formatCurrency(1234.5, { currency: 'INR' })                  // ₹1,234.50
+ * formatCurrency(99, { currency: 'USD', locale: 'en-US' })     // $99
+ * formatCurrency(150000, { currency: 'INR', stripSymbol: true }) // 1,50,000
+ * formatCurrency(1500000, { currency: 'INR', notation: 'compact' }) // ₹15L
  */
 export declare const formatCurrency: (amount: number | string | null | undefined, options?: FormatCurrencyOptions) => string;
 //# sourceMappingURL=currency.d.ts.map

package/lib/typescript/commonjs/formatters/house.d.ts

@@ -1,37 +1,3 @@
-/**
- * The house formatters: DD-MMM-YYYY dates, IST by default or the viewer's own
- * zone with a label, Indian digit grouping by default, money in minor units,
- * and one empty placeholder. Byte-identical in @webority/mobile-core and
- * @webority/web-core.
- *
- * Same output on Hermes and in every browser is the design constraint, so the
- * text is assembled here rather than by Intl. Engines disagree on month
- * abbreviations ("Sep" or "Sept"), on the space before AM/PM (a plain or a
- * narrow no-break space), on zone names ("IST" or "GMT+5:30") and on which
- * Intl options exist at all (Hermes has no RelativeTimeFormat and no
- * trailingZeroDisplay). IST and the viewer's zone are therefore computed with
- * plain Date arithmetic; Intl is used only to read the wall clock of an
- * explicitly named IANA zone, through formatToParts with numeric fields, to
- * read the locale's 12- or 24-hour clock, and where a caller asks for Intl
- * output itself (Intl number options, `formatRelative({ intl: true })`).
- *
- * Called with no options (house defaults: zone IST, locale en-IN, empty "-"):
- * - formatDate(v) "08-Apr-2026"; formatTime(v) "8:05 PM"; formatDateTime(v) "08-Apr-2026, 8:05 PM";
- * - formatRelative(v) "5 minutes ago", "in 3 days", "just now";
- * - formatNumber(v) "1,23,456.789" (Indian grouping, up to 3 decimals);
- * - formatPercent(0.42) "42%"; formatMinor(15000000) "₹1,50,000.00";
- * - a missing or unreadable value "-".
- *
- * With a configured locale (`configureFormatters({ locale })`), the words and separators come
- * from Intl for that locale and the date order stays DD-MMM-YYYY. For en-IN in the viewer zone:
- * "08-Sept-2026", "08:05 pm", "08-Sept-2026, 08:05 pm IST", "yesterday", "12,34,567.891",
- * "₹1,50,000". For de-DE: "08-Sept-2026", "20:05", "1.234.567,891".
- *
- * A configured `numberStyle` puts its decimal mark and group separator in every number and amount,
- * whichever path wrote it: "1.23.456,789" for `'CommaWithPointGroups'` with the house text. A
- * configured `dateOrder` other than DD-MMM-YYYY writes the date as digits from the wall clock,
- * in every locale: "08/04/2026", "04/08/2026", "2026-04-08".
- */
 import { type NumberGrouping, type ZoneMode } from './formatConfig';
 /** A date the house formatters accept; null, undefined and "" read as missing. */
 export type DateValue = Date | string | number | null | undefined;
@@ -96,7 +62,7 @@ export interface FormatPercentOptions extends FormatNumberOptions {
     scale?: 'ratio' | 'percent';
 }
 export interface FormatMinorOptions {
-    /** ISO 4217 code. Defaults to `'INR'`. */
+    /** ISO 4217 code. A missing or empty one warns and prints INR. */
     currency?: string;
     /** Defaults to Indian grouping for INR and international grouping for every other currency. */
     grouping?: NumberGrouping;
@@ -138,7 +104,7 @@ export declare const formatNumber: (value: number | string | null | undefined, o
 export declare const formatPercent: (value: number | string | null | undefined, options?: FormatPercentOptions) => string;
 /**
  * Money held in minor units (paise, cents), which is how every API carries
- * it: formatMinor(15000000) gives "₹1,50,000.00". The split into whole and
+ * it: formatMinor(15000000, { currency: 'INR' }) gives "₹1,50,000.00". The split into whole and
  * fractional units is done on the integer's digits, so no floating-point
  * division can shift a paisa. A fractional input is rounded to the nearest
  * minor unit. A currency without a known symbol prints its code: "AED 1,000.00".

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

@@ -52,15 +52,15 @@ export { getConfig, getConfigValue, resetConfig, setConfig } from './config';
 export type { DeepLinkConfig, DeepLinkRoute, ParsedLink } from './deepLink';
 export { DeepLink, parseDeepLink, useDeepLink } from './deepLink';
 export type { ApiError } from './errors';
-export { apiErrorMessage, CONTRACT_ERROR_CODE, extractApiError, isApiError, isNoResponse, NETWORK_CODE, OFFLINE_MESSAGE, REQUEST_CANCELED_CODE, SERVER_FAILURE_MESSAGE, TIMEOUT_CODE, TIMEOUT_MESSAGE, toFieldPath, UNEXPECTED_MESSAGE } from './errors';
+export { apiErrorMessage, CONTRACT_ERROR_CODE, extractApiError, isApiError, isNoResponse, NETWORK_CODE, OFFLINE_CODE, OFFLINE_MESSAGE, REQUEST_CANCELED_CODE, SERVER_FAILURE_MESSAGE, TIMEOUT_CODE, TIMEOUT_MESSAGE, toFieldPath, UNEXPECTED_MESSAGE, UNREACHABLE_MESSAGE } from './errors';
 export type { DateInput, DateOrder, DateStyle, DateValue, FormatCurrencyOptions, FormatDateOptions, FormatDateTimeOptions, FormatMinorOptions, FormatNumberOptions, FormatPercentOptions, FormatPhoneOptions, FormatRelativeOptions, FormatTimeOptions, FormatterConfig, NumberGrouping, NumberStyle, PhoneCountry, PhoneCountryEntry, PhoneNumber, PhoneNumberType, PhoneParts, PhoneValidationKind, TimeStyle, ZoneMode, ZoneOption } from './formatters';
 export { AsYouType, addDays, clampNationalNumber, configureFormatters, countryFlagEmoji, detectPhoneCountry, diffMs, formatCompactNumber, formatCurrency, formatDate, formatDateDDMMMYYYY, formatDateISO, formatDatePattern, formatDateTime, formatMinor, formatNumber, formatPercent, formatPhone, formatPhoneAsTyped, formatRelative, formatRelativeTime, formatTime, formatTime12h, formatTimeInWindowsZone, formatTimeInZone, getCountries, getCountryCallingCode, getFormatterConfig, getInitials, getPhoneCountries, isDateAfter, isDateBefore, isSameDay, isSupportedCountry, isValidNationalNumber, isValidPhoneNumber, maxNationalNumberLength, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString, splitPhoneNumber, startOfDay, validatePhoneNumberLength } from './formatters';
 export type { InitConfig } from './initSDK';
 export { initWebority } from './initSDK';
 export type { TokenRefreshConfig, TokenRefreshResult, UserAuthOptions } from './initUserAuth';
 export { initUserAuth } from './initUserAuth';
-export type { DeviceContext, LoggerOptions, LoggerType, RemoteLogger, RequestFailedContext } from './logger';
-export { configureLogger, getDeviceContext, Logger, setDeviceContext, setRemoteLogger } from './logger';
+export type { DeviceContext, LoggerBreadcrumb, LoggerOptions, LoggerType, RemoteLogger, RequestFailedContext } from './logger';
+export { configureLogger, getDeviceContext, Logger, setDeviceContext } from './logger';
 export type { CrashlyticsModule } from './logger/crashlytics';
 export { crashlyticsRemoteLogger } from './logger/crashlytics';
 export type { NetworkConnectionType, NetworkStatus, NetworkStatusLike, NetworkStatusListener } from './network';

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

@@ -4,11 +4,17 @@
  */
 import { type KeychainLike } from './auth/authStore';
 import { type Environment, type LogLevel } from './config';
+import { type RemoteLogger } from './logger';
 import { type NetInfoLike } from './network/networkStatus';
 import { setStorageImplementation } from './storage';
 export interface InitConfig {
     /** Your API base URL (required) */
     baseUrl: string;
+    /**
+     * Where errors and breadcrumbs go: a RemoteLogger adapter (e.g. `crashlyticsRemoteLogger`), or
+     * `null` for a build without crash reporting. Required: omitting it throws at start-up.
+     */
+    remoteLogger: RemoteLogger | null;
     /** Enable/disable logging. Defaults to `true`. */
     loggingEnabled?: boolean;
     /** Log level. Defaults to `'info'` in development and `'warn'` in a release build. */
@@ -68,13 +74,15 @@ export interface InitConfig {
  * @example
  * // Basic setup
  * initWebority({
- *   baseUrl: 'https://api.myapp.com'
+ *   baseUrl: 'https://api.myapp.com',
+ *   remoteLogger: null
  * });
  *
  * @example
  * // Full configuration
  * initWebority({
  *   baseUrl: 'https://api.myapp.com',
+ *   remoteLogger: crashlyticsRemoteLogger(crashlytics),
  *   loggingEnabled: __DEV__,
  *   logLevel: 'warn',
  *   environment: __DEV__ ? 'Development' : 'Production'

package/lib/typescript/commonjs/logger/crashlytics.d.ts

@@ -12,13 +12,13 @@ export interface CrashlyticsModule<Instance = unknown> {
     setAttribute: (crashlytics: Instance, name: string, value: string) => Promise<unknown>;
 }
 /**
- * Builds the `setRemoteLogger` adapter for Firebase Crashlytics:
+ * Builds the `remoteLogger` adapter for Firebase Crashlytics, passed to `initWebority`:
  *
  * ```ts
  * import * as crashlytics from '@react-native-firebase/crashlytics';
- * import { crashlyticsRemoteLogger, setRemoteLogger } from '@webority/mobile-core';
+ * import { crashlyticsRemoteLogger, initWebority } from '@webority/mobile-core';
  *
- * setRemoteLogger(crashlyticsRemoteLogger(crashlytics));
+ * initWebority({ baseUrl, remoteLogger: crashlyticsRemoteLogger(crashlytics) });
  * ```
  *
  * Breadcrumbs and log lines become Crashlytics log lines, errors become

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

@@ -1,8 +1,8 @@
 import { type LogLevel } from '../config';
 type LogFn = (message: string, ...optionalParams: unknown[]) => void;
 /**
- * Optional remote sink. Apps wire this via `setRemoteLogger()` to forward errors
- * and breadcrumbs to Crashlytics, Sentry, Bugsnag, etc. — without making the
+ * Remote sink. Apps pass one to `initWebority({ remoteLogger })` to forward errors
+ * and breadcrumbs to Crashlytics, Sentry, Bugsnag, etc., without making the
  * library depend on any of them.
  *
  * Every method is optional; the library calls only what the adapter implements.
@@ -20,10 +20,7 @@ export interface RemoteLogger {
     /** Forward a leveled console message. */
     log?: (level: LogLevel, message: string, optionalParams: unknown[]) => void;
 }
-/**
- * Inject a remote logger adapter (e.g. Firebase Crashlytics, Sentry).
- * Pass `null` to detach. Safe to call before or after `initWebority`.
- */
+/** Set by `initWebority`; `null` detaches. Not part of the package's public API. */
 export declare const setRemoteLogger: (impl: RemoteLogger | null) => void;
 /**
  * Device / app context attached once at boot (platform, OS version, app version,
@@ -47,6 +44,12 @@ export interface DeviceContext {
  */
 export declare const setDeviceContext: (context: DeviceContext | null) => void;
 export declare const getDeviceContext: () => DeviceContext | null;
+export interface LoggerBreadcrumb {
+    message: string;
+    data?: Record<string, unknown>;
+    /** When it was recorded, ISO 8601 in UTC. */
+    timestampUtc: string;
+}
 /** Tuning knobs for screen history and duplicate-error suppression. */
 export interface LoggerOptions {
     /** Identical errors within this window are collapsed. Default 5000ms. 0 disables dedupe. */
@@ -55,8 +58,15 @@ export interface LoggerOptions {
     dedupeMaxPerWindow?: number;
     /** Cap on tracked screen history. Default 20. */
     screenHistoryLimit?: number;
+    /** Extra keys masked in logs, added to the built-in list. */
+    redactKeys?: string[];
+    /** Breadcrumbs kept for Logger.getBreadcrumbs(). Default 50. */
+    breadcrumbLimit?: number;
 }
-/** Configure dedupe window/threshold and screen history size. Merges with current options. */
+/**
+ * Configure dedupe, screen history, breadcrumbs and redaction. Merges with current options;
+ * a `redactKeys` list replaces the app keys given before, and omitting it keeps them.
+ */
 export declare const configureLogger: (options: LoggerOptions) => void;
 /** What `Logger.requestFailed` is told about the call beside the error itself. */
 export interface RequestFailedContext {
@@ -76,7 +86,7 @@ export interface LoggerType {
     info: LogFn;
     warn: LogFn;
     error: LogFn;
-    /** Append a breadcrumb to the remote sink (and log at info level). */
+    /** Append a breadcrumb to the ring and the remote sink (and log at info level). Data is redacted before it is kept. */
     breadcrumb: (message: string, data?: Record<string, unknown>) => void;
     /** Record a non-fatal error with optional context. */
     recordError: (error: unknown, context?: Record<string, unknown>) => void;
@@ -92,6 +102,8 @@ export interface LoggerType {
     getCurrentScreen: () => string | null;
     /** Bounded history of tracked screen names, oldest first. */
     getScreenHistory: () => string[];
+    /** Copy of the breadcrumb ring, oldest first, capped at configureLogger({ breadcrumbLimit }). */
+    getBreadcrumbs: () => LoggerBreadcrumb[];
 }
 export declare const Logger: LoggerType;
 export {};

package/lib/typescript/commonjs/logger/redact.d.ts

@@ -1,3 +1,5 @@
+/** Rebuilds the masking rules from the built-in list plus `extraKeys`. Replaces any earlier extras. */
+export declare const configureRedaction: (extraKeys: readonly string[]) => void;
 export declare const redactString: (input: string) => string;
 /** Returns a copy with secrets masked; Errors are masked in place so identity and stack survive. */
 export declare const redact: <T>(value: T) => T;

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

@@ -14,6 +14,8 @@ export interface PushDevice {
      * (the simulator), so the server falls back to its own setting.
      */
     apnsEnvironment: PushApnsEnvironment | null;
+    /** The device's IANA time zone, such as `Europe/London`. Null when the platform cannot name it. */
+    timeZone: string | null;
 }
 /** A notification that arrived while the app was open. */
 export interface PushReceived {

package/lib/typescript/module/errors/extractApiError.d.ts

@@ -12,9 +12,9 @@
  * legacy `error`, `title`, then `Request failed (<status>)`. `title` is last because it is
  * the ProblemDetails category ("Bad Request"), not the curated sentence.
  *
- * Two things never become `message`: a 5xx body (our failure, nothing the user can act on)
- * and anything that reads like an exception dump. The server's text goes on `detail` for
- * the logger instead.
+ * Never a `message`: anything that reads like an exception dump, and a 5xx body unless it is
+ * coded (not `internal_error`) and its `message` is user-safe. The server's text goes on
+ * `detail` for the logger either way.
  */
 export interface ApiError {
     /** Stable snake_case branch key from the server (`not_found`, `validation_failed`). Branch on it, never render it. */
@@ -36,14 +36,17 @@ export declare const SERVER_FAILURE_MESSAGE = "Something went wrong on our side.
 export declare const OFFLINE_MESSAGE = "You appear to be offline. Check your connection and try again.";
 export declare const TIMEOUT_MESSAGE = "That took too long to respond. Check your connection and try again.";
 export declare const UNEXPECTED_MESSAGE = "Something went wrong. Please try again.";
+export declare const UNREACHABLE_MESSAGE = "We couldn't reach the server. Check your connection and try again.";
 /** `code` for a request the caller cancelled (axios `CanceledError`). Never toasted. */
 export declare const REQUEST_CANCELED_CODE = "request_canceled";
 /** `code` for a response that failed schema validation at the service boundary. */
 export declare const CONTRACT_ERROR_CODE = "contract_error";
 /** `code` for a request that got no answer in time (axios `ECONNABORTED` / `ETIMEDOUT`). `offline` is true. */
 export declare const TIMEOUT_CODE = "timeout";
-/** `code` for a request that never reached the server (offline, DNS, CORS, a dropped connection). `offline` is true. */
+/** `code` for a request that got no answer from the server (DNS, CORS, a dropped connection, a server that is down). `offline` is true. */
 export declare const NETWORK_CODE = "network";
+/** `code` for a request refused because the device reports no connection. `offline` is true. */
+export declare const OFFLINE_CODE = "offline";
 /** `Items[0].UnitPrice` -> `items[0].unitPrice`; `$.email` (System.Text.Json path) -> `email`. */
 export declare const toFieldPath: (key: string) => string;
 export declare const isApiError: (value: unknown) => value is ApiError;
@@ -57,8 +60,8 @@ export declare const isNoResponse: (error: unknown) => boolean;
  * The sentence a screen shows for a failure: the server's own curated message when it sent one,
  * otherwise the screen's `fallback` ("We couldn't save the project."), otherwise the library's
  * generic sentence. A lost answer always reads as the connection message, because "check your
- * connection" is more accurate than any screen's fallback. A 5xx, a cancelled request and a body
- * with no usable sentence count as "the server said nothing usable".
+ * connection" is more accurate than any screen's fallback. A 5xx without a curated sentence, a
+ * cancelled request and a body with no usable sentence count as "the server said nothing usable".
  *
  * `fallback: null` is the "say nothing" mode, for a screen that shows only what the server
  * curated (a live panel that keeps its last result): it returns null when the server said

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

@@ -1,3 +1,3 @@
 export type { ApiError } from './extractApiError.js';
-export { apiErrorMessage, CONTRACT_ERROR_CODE, extractApiError, isApiError, isNoResponse, NETWORK_CODE, OFFLINE_MESSAGE, REQUEST_CANCELED_CODE, SERVER_FAILURE_MESSAGE, TIMEOUT_CODE, TIMEOUT_MESSAGE, toFieldPath, UNEXPECTED_MESSAGE } from './extractApiError.js';
+export { apiErrorMessage, CONTRACT_ERROR_CODE, extractApiError, isApiError, isNoResponse, NETWORK_CODE, OFFLINE_CODE, OFFLINE_MESSAGE, REQUEST_CANCELED_CODE, SERVER_FAILURE_MESSAGE, TIMEOUT_CODE, TIMEOUT_MESSAGE, toFieldPath, UNEXPECTED_MESSAGE, UNREACHABLE_MESSAGE } from './extractApiError.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/formatters/currency.d.ts

@@ -3,7 +3,7 @@
  * `signDisplay`, ...), passed through to Intl.NumberFormat.
  */
 export interface FormatCurrencyOptions extends Omit<Intl.NumberFormatOptions, 'style' | 'currency'> {
-    /** ISO 4217 currency code. Defaults to `'INR'`. */
+    /** ISO 4217 currency code. A missing or empty one warns and prints INR. */
     currency?: string;
     /** BCP-47 locale tag. Defaults to the configured locale, else `'en-IN'` (Indian numbering system). */
     locale?: string;
@@ -20,9 +20,10 @@ export interface FormatCurrencyOptions extends Omit<Intl.NumberFormatOptions, 's
     empty?: string;
 }
 /**
- * Format an amount as currency. Defaults to **INR** with Indian numbering (`en-IN`),
- * which matches the standard convention across Webority projects. Called with no
- * options: "₹1,50,000" for 150000, "₹1,234.50" for 1234.5, and `''` for a missing amount.
+ * Format an amount as currency. Pass an ISO 4217 code: a missing or empty one warns and
+ * prints **INR** with Indian numbering (`en-IN`), the convention across Webority projects.
+ * With `{ currency: 'INR' }`: "₹1,50,000" for 150000, "₹1,234.50" for 1234.5, and `''` for a
+ * missing amount.
  * Once the app configures a locale (`configureFormatters({ locale })`), the amount is
  * written in that locale and a missing amount prints the configured placeholder ("-").
  * A configured `numberStyle` sets the decimal mark and group separator; the locale keeps
@@ -31,11 +32,11 @@ export interface FormatCurrencyOptions extends Omit<Intl.NumberFormatOptions, 's
  * use `formatMinor`.
  *
  * @example
- * formatCurrency(150000)            // ₹1,50,000
- * formatCurrency(1234.5)            // ₹1,234.50
- * formatCurrency(99, { currency: 'USD', locale: 'en-US' }) // $99
- * formatCurrency(150000, { stripSymbol: true })            // 1,50,000
- * formatCurrency(1500000, { notation: 'compact' })         // ₹15L
+ * formatCurrency(150000, { currency: 'INR' })                  // ₹1,50,000
+ * formatCurrency(1234.5, { currency: 'INR' })                  // ₹1,234.50
+ * formatCurrency(99, { currency: 'USD', locale: 'en-US' })     // $99
+ * formatCurrency(150000, { currency: 'INR', stripSymbol: true }) // 1,50,000
+ * formatCurrency(1500000, { currency: 'INR', notation: 'compact' }) // ₹15L
  */
 export declare const formatCurrency: (amount: number | string | null | undefined, options?: FormatCurrencyOptions) => string;
 //# sourceMappingURL=currency.d.ts.map

package/lib/typescript/module/formatters/house.d.ts

@@ -1,37 +1,3 @@
-/**
- * The house formatters: DD-MMM-YYYY dates, IST by default or the viewer's own
- * zone with a label, Indian digit grouping by default, money in minor units,
- * and one empty placeholder. Byte-identical in @webority/mobile-core and
- * @webority/web-core.
- *
- * Same output on Hermes and in every browser is the design constraint, so the
- * text is assembled here rather than by Intl. Engines disagree on month
- * abbreviations ("Sep" or "Sept"), on the space before AM/PM (a plain or a
- * narrow no-break space), on zone names ("IST" or "GMT+5:30") and on which
- * Intl options exist at all (Hermes has no RelativeTimeFormat and no
- * trailingZeroDisplay). IST and the viewer's zone are therefore computed with
- * plain Date arithmetic; Intl is used only to read the wall clock of an
- * explicitly named IANA zone, through formatToParts with numeric fields, to
- * read the locale's 12- or 24-hour clock, and where a caller asks for Intl
- * output itself (Intl number options, `formatRelative({ intl: true })`).
- *
- * Called with no options (house defaults: zone IST, locale en-IN, empty "-"):
- * - formatDate(v) "08-Apr-2026"; formatTime(v) "8:05 PM"; formatDateTime(v) "08-Apr-2026, 8:05 PM";
- * - formatRelative(v) "5 minutes ago", "in 3 days", "just now";
- * - formatNumber(v) "1,23,456.789" (Indian grouping, up to 3 decimals);
- * - formatPercent(0.42) "42%"; formatMinor(15000000) "₹1,50,000.00";
- * - a missing or unreadable value "-".
- *
- * With a configured locale (`configureFormatters({ locale })`), the words and separators come
- * from Intl for that locale and the date order stays DD-MMM-YYYY. For en-IN in the viewer zone:
- * "08-Sept-2026", "08:05 pm", "08-Sept-2026, 08:05 pm IST", "yesterday", "12,34,567.891",
- * "₹1,50,000". For de-DE: "08-Sept-2026", "20:05", "1.234.567,891".
- *
- * A configured `numberStyle` puts its decimal mark and group separator in every number and amount,
- * whichever path wrote it: "1.23.456,789" for `'CommaWithPointGroups'` with the house text. A
- * configured `dateOrder` other than DD-MMM-YYYY writes the date as digits from the wall clock,
- * in every locale: "08/04/2026", "04/08/2026", "2026-04-08".
- */
 import { type NumberGrouping, type ZoneMode } from './formatConfig.js';
 /** A date the house formatters accept; null, undefined and "" read as missing. */
 export type DateValue = Date | string | number | null | undefined;
@@ -96,7 +62,7 @@ export interface FormatPercentOptions extends FormatNumberOptions {
     scale?: 'ratio' | 'percent';
 }
 export interface FormatMinorOptions {
-    /** ISO 4217 code. Defaults to `'INR'`. */
+    /** ISO 4217 code. A missing or empty one warns and prints INR. */
     currency?: string;
     /** Defaults to Indian grouping for INR and international grouping for every other currency. */
     grouping?: NumberGrouping;
@@ -138,7 +104,7 @@ export declare const formatNumber: (value: number | string | null | undefined, o
 export declare const formatPercent: (value: number | string | null | undefined, options?: FormatPercentOptions) => string;
 /**
  * Money held in minor units (paise, cents), which is how every API carries
- * it: formatMinor(15000000) gives "₹1,50,000.00". The split into whole and
+ * it: formatMinor(15000000, { currency: 'INR' }) gives "₹1,50,000.00". The split into whole and
  * fractional units is done on the integer's digits, so no floating-point
  * division can shift a paisa. A fractional input is rounded to the nearest
  * minor unit. A currency without a known symbol prints its code: "AED 1,000.00".

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

@@ -52,15 +52,15 @@ export { getConfig, getConfigValue, resetConfig, setConfig } from './config/inde
 export type { DeepLinkConfig, DeepLinkRoute, ParsedLink } from './deepLink/index.js';
 export { DeepLink, parseDeepLink, useDeepLink } from './deepLink/index.js';
 export type { ApiError } from './errors/index.js';
-export { apiErrorMessage, CONTRACT_ERROR_CODE, extractApiError, isApiError, isNoResponse, NETWORK_CODE, OFFLINE_MESSAGE, REQUEST_CANCELED_CODE, SERVER_FAILURE_MESSAGE, TIMEOUT_CODE, TIMEOUT_MESSAGE, toFieldPath, UNEXPECTED_MESSAGE } from './errors/index.js';
+export { apiErrorMessage, CONTRACT_ERROR_CODE, extractApiError, isApiError, isNoResponse, NETWORK_CODE, OFFLINE_CODE, OFFLINE_MESSAGE, REQUEST_CANCELED_CODE, SERVER_FAILURE_MESSAGE, TIMEOUT_CODE, TIMEOUT_MESSAGE, toFieldPath, UNEXPECTED_MESSAGE, UNREACHABLE_MESSAGE } from './errors/index.js';
 export type { DateInput, DateOrder, DateStyle, DateValue, FormatCurrencyOptions, FormatDateOptions, FormatDateTimeOptions, FormatMinorOptions, FormatNumberOptions, FormatPercentOptions, FormatPhoneOptions, FormatRelativeOptions, FormatTimeOptions, FormatterConfig, NumberGrouping, NumberStyle, PhoneCountry, PhoneCountryEntry, PhoneNumber, PhoneNumberType, PhoneParts, PhoneValidationKind, TimeStyle, ZoneMode, ZoneOption } from './formatters/index.js';
 export { AsYouType, addDays, clampNationalNumber, configureFormatters, countryFlagEmoji, detectPhoneCountry, diffMs, formatCompactNumber, formatCurrency, formatDate, formatDateDDMMMYYYY, formatDateISO, formatDatePattern, formatDateTime, formatMinor, formatNumber, formatPercent, formatPhone, formatPhoneAsTyped, formatRelative, formatRelativeTime, formatTime, formatTime12h, formatTimeInWindowsZone, formatTimeInZone, getCountries, getCountryCallingCode, getFormatterConfig, getInitials, getPhoneCountries, isDateAfter, isDateBefore, isSameDay, isSupportedCountry, isValidNationalNumber, isValidPhoneNumber, maxNationalNumberLength, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString, splitPhoneNumber, startOfDay, validatePhoneNumberLength } from './formatters/index.js';
 export type { InitConfig } from './initSDK.js';
 export { initWebority } from './initSDK.js';
 export type { TokenRefreshConfig, TokenRefreshResult, UserAuthOptions } from './initUserAuth.js';
 export { initUserAuth } from './initUserAuth.js';
-export type { DeviceContext, LoggerOptions, LoggerType, RemoteLogger, RequestFailedContext } from './logger/index.js';
-export { configureLogger, getDeviceContext, Logger, setDeviceContext, setRemoteLogger } from './logger/index.js';
+export type { DeviceContext, LoggerBreadcrumb, LoggerOptions, LoggerType, RemoteLogger, RequestFailedContext } from './logger/index.js';
+export { configureLogger, getDeviceContext, Logger, setDeviceContext } from './logger/index.js';
 export type { CrashlyticsModule } from './logger/crashlytics.js';
 export { crashlyticsRemoteLogger } from './logger/crashlytics.js';
 export type { NetworkConnectionType, NetworkStatus, NetworkStatusLike, NetworkStatusListener } from './network/index.js';

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

@@ -4,11 +4,17 @@
  */
 import { type KeychainLike } from './auth/authStore.js';
 import { type Environment, type LogLevel } from './config/index.js';
+import { type RemoteLogger } from './logger/index.js';
 import { type NetInfoLike } from './network/networkStatus.js';
 import { setStorageImplementation } from './storage/index.js';
 export interface InitConfig {
     /** Your API base URL (required) */
     baseUrl: string;
+    /**
+     * Where errors and breadcrumbs go: a RemoteLogger adapter (e.g. `crashlyticsRemoteLogger`), or
+     * `null` for a build without crash reporting. Required: omitting it throws at start-up.
+     */
+    remoteLogger: RemoteLogger | null;
     /** Enable/disable logging. Defaults to `true`. */
     loggingEnabled?: boolean;
     /** Log level. Defaults to `'info'` in development and `'warn'` in a release build. */
@@ -68,13 +74,15 @@ export interface InitConfig {
  * @example
  * // Basic setup
  * initWebority({
- *   baseUrl: 'https://api.myapp.com'
+ *   baseUrl: 'https://api.myapp.com',
+ *   remoteLogger: null
  * });
  *
  * @example
  * // Full configuration
  * initWebority({
  *   baseUrl: 'https://api.myapp.com',
+ *   remoteLogger: crashlyticsRemoteLogger(crashlytics),
  *   loggingEnabled: __DEV__,
  *   logLevel: 'warn',
  *   environment: __DEV__ ? 'Development' : 'Production'

package/lib/typescript/module/logger/crashlytics.d.ts

@@ -12,13 +12,13 @@ export interface CrashlyticsModule<Instance = unknown> {
     setAttribute: (crashlytics: Instance, name: string, value: string) => Promise<unknown>;
 }
 /**
- * Builds the `setRemoteLogger` adapter for Firebase Crashlytics:
+ * Builds the `remoteLogger` adapter for Firebase Crashlytics, passed to `initWebority`:
  *
  * ```ts
  * import * as crashlytics from '@react-native-firebase/crashlytics';
- * import { crashlyticsRemoteLogger, setRemoteLogger } from '@webority/mobile-core';
+ * import { crashlyticsRemoteLogger, initWebority } from '@webority/mobile-core';
  *
- * setRemoteLogger(crashlyticsRemoteLogger(crashlytics));
+ * initWebority({ baseUrl, remoteLogger: crashlyticsRemoteLogger(crashlytics) });
  * ```
  *
  * Breadcrumbs and log lines become Crashlytics log lines, errors become