@webority/mobile-core 0.0.29 → 0.2.0

package/lib/module/geolocation/adapters/expoLocation.js

@@ -1,121 +1 @@
-"use strict";
-
-/**
- * The slice of expo-location this adapter uses. Verified against 57.0.14.
- *
- * The REQUIRE lives in the entry point beside this file, never here.
- */
-
-/**
- * expo-location's Accuracy enum is numeric (`Balanced = 3`, `Highest = 5`,
- * verified in Location.types.d.ts). The numbers are inlined rather than
- * imported so this file names no expo module and stays bundlable by an app
- * without expo installed.
- */
-const ACCURACY_BALANCED = 3;
-const ACCURACY_HIGHEST = 5;
-const toExpoOptions = options => {
-  const expo = {
-    accuracy: options?.enableHighAccuracy ? ACCURACY_HIGHEST : ACCURACY_BALANCED
-  };
-  if (typeof options?.distanceFilter === 'number') {
-    expo.distanceInterval = options.distanceFilter;
-  }
-  return expo;
-};
-
-/**
- * expo-location rejects with an Error; the seam expects the W3C-style numeric
- * codes the RN geolocation modules use, which the library then maps to its own
- * GeolocationError kinds. Classifying here rather than passing the raw Error
- * through is what makes an expo-backed app produce the same `permission-denied`
- * / `services-disabled` / `timeout` values as a NetInfo-backed one — which is
- * the whole point of having a seam.
- */
-const PERMISSION_PATTERN = /permission|denied|not (been )?granted|authoriz/i;
-const SERVICES_PATTERN = /location services|provider|disabled|switched off|turned off/i;
-const TIMEOUT_PATTERN = /time ?d? ?out|timeout/i;
-const toNativeError = raw => {
-  const message = raw instanceof Error ? raw.message : String(raw);
-  if (PERMISSION_PATTERN.test(message)) {
-    return {
-      code: 1,
-      message
-    };
-  }
-  if (TIMEOUT_PATTERN.test(message)) {
-    return {
-      code: 3,
-      message
-    };
-  }
-  // Code 2 covers both "services off" and "no fix". The library separates them
-  // by reading the message, so the message must travel intact — and where expo
-  // does not say "location services", the wording is normalised so it can.
-  if (SERVICES_PATTERN.test(message)) {
-    return {
-      code: 2,
-      message
-    };
-  }
-  return {
-    code: 2,
-    message
-  };
-};
-const toNativePosition = location => ({
-  coords: {
-    latitude: location.coords?.latitude ?? null,
-    longitude: location.coords?.longitude ?? null,
-    accuracy: location.coords?.accuracy ?? null,
-    altitude: location.coords?.altitude ?? null,
-    heading: location.coords?.heading ?? null,
-    speed: location.coords?.speed ?? null
-  },
-  timestamp: location.timestamp ?? null
-});
-
-/**
- * Adapts expo-location to the library's geolocation seam.
- *
- * The interesting half is `watchPosition`. The seam must hand back a numeric
- * watch id SYNCHRONOUSLY, while `watchPositionAsync` only resolves its
- * subscription later. So the adapter mints its own id immediately and stores
- * the subscription against it on arrival. `clearWatch` called during that
- * window records the id as cancelled, and the subscription is removed the
- * moment it lands — without that, a screen that unmounts before the watch
- * starts leaks a live GPS listener for the rest of the session, which is a
- * battery drain nobody would attribute to this code.
- */
-export const adaptExpoLocation = mod => {
-  const subscriptions = new Map();
-  let nextWatchId = 1;
-  return {
-    getCurrentPosition: (onSuccess, onError, options) => {
-      mod.getCurrentPositionAsync(toExpoOptions(options)).then(location => onSuccess(toNativePosition(location))).catch(error => onError?.(toNativeError(error)));
-    },
-    watchPosition: (onSuccess, onError, options) => {
-      const watchId = nextWatchId++;
-      subscriptions.set(watchId, null);
-      mod.watchPositionAsync(toExpoOptions(options), location => onSuccess(toNativePosition(location))).then(subscription => {
-        if (!subscriptions.has(watchId)) {
-          // clearWatch already ran. Remove immediately rather than storing a
-          // subscription nothing will ever clear.
-          subscription.remove();
-          return;
-        }
-        subscriptions.set(watchId, subscription);
-      }).catch(error => {
-        subscriptions.delete(watchId);
-        onError?.(toNativeError(error));
-      });
-      return watchId;
-    },
-    clearWatch: watchId => {
-      const subscription = subscriptions.get(watchId);
-      subscriptions.delete(watchId);
-      subscription?.remove();
-    }
-  };
-};
-//# sourceMappingURL=expoLocation.js.map
+"use strict";const ACCURACY_BALANCED=3,ACCURACY_HIGHEST=5,toExpoOptions=t=>{const e={accuracy:t?.enableHighAccuracy?5:3};return"number"==typeof t?.distanceFilter&&(e.distanceInterval=t.distanceFilter),e},PERMISSION_PATTERN=/permission|denied|not (been )?granted|authoriz/i,SERVICES_PATTERN=/location services|provider|disabled|switched off|turned off/i,TIMEOUT_PATTERN=/time ?d? ?out|timeout/i,toNativeError=t=>{const e=t instanceof Error?t.message:String(t);return PERMISSION_PATTERN.test(e)?{code:1,message:e}:TIMEOUT_PATTERN.test(e)?{code:3,message:e}:(SERVICES_PATTERN.test(e),{code:2,message:e})},toNativePosition=t=>({coords:{latitude:t.coords?.latitude??null,longitude:t.coords?.longitude??null,accuracy:t.coords?.accuracy??null,altitude:t.coords?.altitude??null,heading:t.coords?.heading??null,speed:t.coords?.speed??null},timestamp:t.timestamp??null});export const adaptExpoLocation=t=>{const e=new Map;let o=1;return{getCurrentPosition:(e,o,i)=>{t.getCurrentPositionAsync(toExpoOptions(i)).then(t=>e(toNativePosition(t))).catch(t=>o?.(toNativeError(t)))},watchPosition:(i,n,s)=>{const r=o++;return e.set(r,null),t.watchPositionAsync(toExpoOptions(s),t=>i(toNativePosition(t))).then(t=>{e.has(r)?e.set(r,t):t.remove()}).catch(t=>{e.delete(r),n?.(toNativeError(t))}),r},clearWatch:t=>{const o=e.get(t);e.delete(t),o?.remove()}}};

package/lib/module/geolocation/index.js

@@ -1,347 +1 @@
-"use strict";
-
-import * as ExpoLocation from 'expo-location';
-import { useCallback, useEffect, useRef, useState } from 'react';
-import { Logger } from "../logger/index.js";
-import { Permissions } from "../permissions/index.js";
-// expo-location is a REQUIRED peer (unlike the other Expo permission
-// packages, which are optional and registered only when an app opts in by
-// importing their own entry point) — anything that reaches this module
-// already forces Metro to resolve expo-location, so self-registering its
-// permission kinds here costs nothing extra and makes Geolocation's
-// permission gating work without a separate app-level import.
-import "../permissions/location.js";
-import { adaptExpoLocation } from "./adapters/expoLocation.js";
-const PREFIX = '[@webority/mobile-core]';
-export class GeolocationError extends Error {
-  constructor(code, message) {
-    super(message);
-    this.name = 'GeolocationError';
-    this.code = code;
-    // Babel downlevels `class extends Error`, which breaks `instanceof` for
-    // subclasses unless the prototype is restored explicitly.
-    Object.setPrototypeOf(this, GeolocationError.prototype);
-  }
-}
-
-/** Minimal shape of the native geolocation module we depend on. */
-
-const DEFAULT_TIMEOUT_MS = 15000;
-const DEFAULT_RETRIES = 1;
-const DEFAULT_RETRY_DELAY_MS = 800;
-
-/** Only what a test or the showcase injected; null means use expo-location. */
-let backend = null;
-
-/**
- * expo-location is a required peer, so the JS module always resolves. What can
- * be missing is the NATIVE side: an app that installed the package without
- * running the native install gets a module whose calls are absent. Checking the
- * two the adapter needs is what lets `isAvailable` mean something and makes the
- * error below reachable.
- *
- * An INJECTED backend is taken on trust, like every other seam in this package.
- */
-const hasNativeLocation = mod => typeof mod?.getCurrentPositionAsync === 'function' && typeof mod?.watchPositionAsync === 'function';
-let expoBackend;
-const resolveBackend = () => {
-  if (backend) {
-    return backend;
-  }
-  if (expoBackend === undefined) {
-    const mod = ExpoLocation;
-    expoBackend = hasNativeLocation(mod) ? adaptExpoLocation(mod) : null;
-  }
-  return expoBackend;
-};
-
-/**
- * Replace the geolocation provider. Intended for TESTS and for the showcase,
- * which injects a denying provider to demo the permission and services-off
- * errors; an app gets expo-location without wiring anything. Pass `null` to
- * restore it.
- */
-export const setGeolocationImplementation = impl => {
-  backend = impl;
-};
-const requireBackend = op => {
-  const b = resolveBackend();
-  if (!b) {
-    throw new GeolocationError('unsupported', `${PREFIX} No geolocation provider is available; cannot ${op}. ` + 'expo-location did not load, which on a real build means the native ' + 'module was not linked.');
-  }
-  return b;
-};
-
-/**
- * Android reports "location services are switched off" through the same code 2
- * that also covers a genuine failure to fix a position, and the two need
- * different handling: one is fixed by the user in system settings, the other is
- * worth retrying. The message is the only signal that separates them.
- */
-const SERVICES_OFF_PATTERN = /(location|gps)[^.]{0,40}(disabled|switched off|turned off|not enabled)|no location provider|settings_not_satisfied|location services (are |is )?off/i;
-const toGeoError = raw => {
-  if (raw instanceof GeolocationError) {
-    return raw;
-  }
-  const native = raw ?? {};
-  const detail = typeof native.message === 'string' && native.message.length > 0 ? native.message : 'the provider gave no reason';
-  switch (native.code) {
-    case 1:
-      return new GeolocationError('permission-denied', `${PREFIX} Location permission was denied (${detail}). Request the ` + 'location permission before calling, or send the user to settings.');
-    case 2:
-      return SERVICES_OFF_PATTERN.test(detail) ? new GeolocationError('services-disabled', `${PREFIX} Location services are switched off (${detail}). Ask the user ` + 'to enable location in system settings; retrying will not help.') : new GeolocationError('position-unavailable', `${PREFIX} No position fix (${detail}).`);
-    case 3:
-      return new GeolocationError('timeout', `${PREFIX} Location request timed out (${detail}).`);
-    case 4:
-    case 5:
-      return new GeolocationError('services-disabled', `${PREFIX} Location services are unavailable on this device (${detail}). ` + 'Ask the user to enable location, or install Google Play services.');
-    default:
-      return new GeolocationError('position-unavailable', `${PREFIX} Location request failed (${detail}).`);
-  }
-};
-const RETRYABLE = ['timeout', 'position-unavailable'];
-const normalizeCoords = raw => {
-  const coords = raw?.coords;
-  if (!coords || !Number.isFinite(coords.latitude) || !Number.isFinite(coords.longitude)) {
-    return null;
-  }
-  return {
-    latitude: coords.latitude,
-    longitude: coords.longitude,
-    // An absent radius is treated as infinitely bad rather than perfect, so a
-    // provider that omits it can never satisfy `minimumAccuracyM` by accident.
-    accuracy: Number.isFinite(coords.accuracy) ? coords.accuracy : Number.POSITIVE_INFINITY,
-    altitude: Number.isFinite(coords.altitude) ? coords.altitude : null,
-    heading: Number.isFinite(coords.heading) ? coords.heading : null,
-    speed: Number.isFinite(coords.speed) ? coords.speed : null
-  };
-};
-const normalizePosition = raw => {
-  const coords = normalizeCoords(raw);
-  if (!coords) {
-    return null;
-  }
-  return {
-    coords,
-    timestamp: Number.isFinite(raw?.timestamp) ? raw?.timestamp : Date.now()
-  };
-};
-const toNativeOptions = options => {
-  const native = {
-    enableHighAccuracy: (options.accuracy ?? 'fine') === 'fine',
-    timeout: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
-    maximumAge: options.maximumAgeMs ?? 0
-  };
-  if (options.distanceFilterM !== undefined) {
-    native.distanceFilter = options.distanceFilterM;
-  }
-  return native;
-};
-const sleep = ms => new Promise(resolve => {
-  setTimeout(resolve, ms);
-});
-const ensureLocationPermission = async () => {
-  const status = await Permissions.ensure('location');
-  if (status === 'granted' || status === 'limited') {
-    return;
-  }
-  if (status === 'unavailable') {
-    Logger.warn(`${PREFIX} Location permission status is unavailable (expo-location is not installed, ` + 'or the check failed); attempting the location request anyway.');
-    return;
-  }
-  throw new GeolocationError('permission-denied', `${PREFIX} Location permission is "${status}". Grant it before requesting a position` + (status === 'blocked' ? ', or call Permissions.openSettings() to let the user fix it.' : '.'));
-};
-const positionOnce = (b, options) => {
-  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  return new Promise((resolve, reject) => {
-    let settled = false;
-    // The native timeout is passed through as well, but a provider that never
-    // calls back at all would otherwise hang the caller forever.
-    const timer = setTimeout(() => {
-      if (settled) {
-        return;
-      }
-      settled = true;
-      reject(new GeolocationError('timeout', `${PREFIX} Location request timed out after ${timeoutMs}ms. Raise timeoutMs, or use ` + "accuracy: 'coarse' where a network fix is good enough."));
-    }, timeoutMs);
-    const settle = run => {
-      if (settled) {
-        return;
-      }
-      settled = true;
-      clearTimeout(timer);
-      run();
-    };
-    const onSuccess = raw => settle(() => {
-      const position = normalizePosition(raw);
-      if (!position) {
-        reject(new GeolocationError('position-unavailable', `${PREFIX} The provider returned a fix without usable coordinates.`));
-        return;
-      }
-      const floor = options.minimumAccuracyM;
-      if (floor !== undefined && position.coords.accuracy > floor) {
-        reject(new GeolocationError('position-unavailable', `${PREFIX} Fix accuracy ${position.coords.accuracy}m is worse than the required ` + `${floor}m.`));
-        return;
-      }
-      resolve(position);
-    });
-    const onError = error => settle(() => reject(toGeoError(error)));
-    try {
-      b.getCurrentPosition(onSuccess, onError, toNativeOptions(options));
-    } catch (error) {
-      settle(() => reject(toGeoError(error)));
-    }
-  });
-};
-const getCurrentPosition = async (options = {}) => {
-  const b = requireBackend('get the current position');
-  await ensureLocationPermission();
-  const attempts = Math.max(0, Math.trunc(options.retries ?? DEFAULT_RETRIES)) + 1;
-  const retryDelayMs = options.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
-  let lastError = null;
-  for (let attempt = 0; attempt < attempts; attempt += 1) {
-    try {
-      return await positionOnce(b, options);
-    } catch (error) {
-      const geoError = toGeoError(error);
-      if (!RETRYABLE.includes(geoError.code)) {
-        throw geoError;
-      }
-      lastError = geoError;
-      if (attempt < attempts - 1 && retryDelayMs > 0) {
-        await sleep(retryDelayMs);
-      }
-    }
-  }
-  throw lastError ?? new GeolocationError('position-unavailable', `${PREFIX} Location request failed.`);
-};
-const watchPosition = (listener, options = {}) => {
-  const b = requireBackend('watch the position');
-  let cancelled = false;
-  let watchId = null;
-  const stop = () => {
-    if (cancelled) {
-      return;
-    }
-    cancelled = true;
-    if (watchId !== null) {
-      b.clearWatch(watchId);
-      watchId = null;
-    }
-  };
-  const fail = error => {
-    const geoError = toGeoError(error);
-    Logger.error(geoError.message);
-    options.onError?.(geoError);
-  };
-  void ensureLocationPermission().then(() => {
-    // The caller can unsubscribe while the permission gate is still pending;
-    // registering afterwards would leak a watch nothing can clear.
-    if (cancelled) {
-      return;
-    }
-    watchId = b.watchPosition(raw => {
-      if (cancelled) {
-        return;
-      }
-      const position = normalizePosition(raw);
-      if (!position) {
-        return;
-      }
-      const floor = options.minimumAccuracyM;
-      if (floor !== undefined && position.coords.accuracy > floor) {
-        return;
-      }
-      listener(position);
-    }, error => {
-      if (!cancelled) {
-        fail(error);
-      }
-    }, toNativeOptions(options));
-  }).catch(fail);
-  return stop;
-};
-const isAvailable = () => resolveBackend() !== null;
-export const Geolocation = {
-  getCurrentPosition,
-  watchPosition,
-  isAvailable
-};
-export const useCurrentPosition = (options = {}) => {
-  const {
-    enabled = true,
-    accuracy,
-    timeoutMs,
-    maximumAgeMs,
-    retries,
-    minimumAccuracyM,
-    retryDelayMs
-  } = options;
-  const [state, setState] = useState({
-    position: null,
-    error: null,
-    loading: enabled
-  });
-  const mountedRef = useRef(true);
-  // Identifies the in-flight request so a slow earlier fix cannot overwrite the
-  // result of a later refresh().
-  const requestRef = useRef(0);
-  useEffect(() => {
-    mountedRef.current = true;
-    return () => {
-      mountedRef.current = false;
-    };
-  }, []);
-
-  // Every dependency is a primitive read off `options`, so an inline options
-  // object (the normal call shape) does not re-create this on every render.
-  const run = useCallback(() => {
-    requestRef.current += 1;
-    const token = requestRef.current;
-    setState(prev => prev.loading ? prev : {
-      ...prev,
-      loading: true
-    });
-    const accept = next => {
-      if (mountedRef.current && requestRef.current === token) {
-        setState(next);
-      }
-    };
-    getCurrentPosition({
-      accuracy,
-      timeoutMs,
-      maximumAgeMs,
-      retries,
-      minimumAccuracyM,
-      retryDelayMs
-    }).then(position => accept({
-      position,
-      error: null,
-      loading: false
-    }), error => accept({
-      position: null,
-      error: toGeoError(error),
-      loading: false
-    }));
-  }, [accuracy, timeoutMs, maximumAgeMs, retries, minimumAccuracyM, retryDelayMs]);
-  useEffect(() => {
-    if (!enabled) {
-      // Discard any in-flight request so its result cannot land after opting out.
-      requestRef.current += 1;
-      setState(prev => prev.loading || prev.position !== null || prev.error !== null ? {
-        position: null,
-        error: null,
-        loading: false
-      } : prev);
-      return;
-    }
-    run();
-  }, [enabled, run]);
-  return {
-    position: state.position,
-    error: state.error,
-    loading: state.loading,
-    refresh: run
-  };
-};
-//# sourceMappingURL=index.js.map
+"use strict";import*as ExpoLocation from"expo-location";import{useCallback,useEffect,useRef,useState}from"react";import{Logger}from"../logger/index.js";import{Permissions}from"../permissions/index.js";import"../permissions/location.js";import{adaptExpoLocation}from"./adapters/expoLocation.js";const PREFIX="[@webority/mobile-core]";export class GeolocationError extends Error{constructor(e,o){super(o),this.name="GeolocationError",this.code=e,Object.setPrototypeOf(this,GeolocationError.prototype)}}const DEFAULT_TIMEOUT_MS=15e3,DEFAULT_RETRIES=1,DEFAULT_RETRY_DELAY_MS=800;let backend=null;const hasNativeLocation=e=>"function"==typeof e?.getCurrentPositionAsync&&"function"==typeof e?.watchPositionAsync;let expoBackend;const resolveBackend=()=>{if(backend)return backend;if(void 0===expoBackend){const e=ExpoLocation;expoBackend=hasNativeLocation(e)?adaptExpoLocation(e):null}return expoBackend};export const setGeolocationImplementation=e=>{backend=e};const requireBackend=e=>{const o=resolveBackend();if(!o)throw new GeolocationError("unsupported",`${PREFIX} No geolocation provider is available; cannot ${e}. expo-location did not load, which on a real build means the native module was not linked.`);return o},SERVICES_OFF_PATTERN=/(location|gps)[^.]{0,40}(disabled|switched off|turned off|not enabled)|no location provider|settings_not_satisfied|location services (are |is )?off/i,toGeoError=e=>{if(e instanceof GeolocationError)return e;const o=e??{},t="string"==typeof o.message&&o.message.length>0?o.message:"the provider gave no reason";switch(o.code){case 1:return new GeolocationError("permission-denied",`${PREFIX} Location permission was denied (${t}). Request the location permission before calling, or send the user to settings.`);case 2:return SERVICES_OFF_PATTERN.test(t)?new GeolocationError("services-disabled",`${PREFIX} Location services are switched off (${t}). Ask the user to enable location in system settings; retrying will not help.`):new GeolocationError("position-unavailable",`${PREFIX} No position fix (${t}).`);case 3:return new GeolocationError("timeout",`${PREFIX} Location request timed out (${t}).`);case 4:case 5:return new GeolocationError("services-disabled",`${PREFIX} Location services are unavailable on this device (${t}). Ask the user to enable location, or install Google Play services.`);default:return new GeolocationError("position-unavailable",`${PREFIX} Location request failed (${t}).`)}},RETRYABLE=["timeout","position-unavailable"],normalizeCoords=e=>{const o=e?.coords;return o&&Number.isFinite(o.latitude)&&Number.isFinite(o.longitude)?{latitude:o.latitude,longitude:o.longitude,accuracy:Number.isFinite(o.accuracy)?o.accuracy:Number.POSITIVE_INFINITY,altitude:Number.isFinite(o.altitude)?o.altitude:null,heading:Number.isFinite(o.heading)?o.heading:null,speed:Number.isFinite(o.speed)?o.speed:null}:null},normalizePosition=e=>{const o=normalizeCoords(e);return o?{coords:o,timestamp:Number.isFinite(e?.timestamp)?e?.timestamp:Date.now()}:null},toNativeOptions=e=>{const o={enableHighAccuracy:"fine"===(e.accuracy??"fine"),timeout:e.timeoutMs??15e3,maximumAge:e.maximumAgeMs??0};return void 0!==e.distanceFilterM&&(o.distanceFilter=e.distanceFilterM),o},sleep=e=>new Promise(o=>{setTimeout(o,e)}),ensureLocationPermission=async()=>{const e=await Permissions.ensure("location");if("granted"!==e&&"limited"!==e){if("unavailable"!==e)throw new GeolocationError("permission-denied",`${PREFIX} Location permission is "${e}". Grant it before requesting a position`+("blocked"===e?", or call Permissions.openSettings() to let the user fix it.":"."));Logger.warn(`${PREFIX} Location permission status is unavailable (expo-location is not installed, or the check failed); attempting the location request anyway.`)}},positionOnce=(e,o)=>{const t=o.timeoutMs??15e3;return new Promise((i,r)=>{let n=!1;const s=setTimeout(()=>{n||(n=!0,r(new GeolocationError("timeout",`${PREFIX} Location request timed out after ${t}ms. Raise timeoutMs, or use accuracy: 'coarse' where a network fix is good enough.`)))},t),settle=e=>{n||(n=!0,clearTimeout(s),e())},onSuccess=e=>settle(()=>{const t=normalizePosition(e);if(!t)return void r(new GeolocationError("position-unavailable",`${PREFIX} The provider returned a fix without usable coordinates.`));const n=o.minimumAccuracyM;void 0!==n&&t.coords.accuracy>n?r(new GeolocationError("position-unavailable",`${PREFIX} Fix accuracy ${t.coords.accuracy}m is worse than the required ${n}m.`)):i(t)}),onError=e=>settle(()=>r(toGeoError(e)));try{e.getCurrentPosition(onSuccess,onError,toNativeOptions(o))}catch(e){settle(()=>r(toGeoError(e)))}})},getCurrentPosition=async(e={})=>{const o=requireBackend("get the current position");await ensureLocationPermission();const t=Math.max(0,Math.trunc(e.retries??1))+1,i=e.retryDelayMs??800;let r=null;for(let n=0;n<t;n+=1)try{return await positionOnce(o,e)}catch(e){const o=toGeoError(e);if(!RETRYABLE.includes(o.code))throw o;r=o,n<t-1&&i>0&&await sleep(i)}throw r??new GeolocationError("position-unavailable",`${PREFIX} Location request failed.`)},watchPosition=(e,o={})=>{const t=requireBackend("watch the position");let i=!1,r=null;const fail=e=>{const t=toGeoError(e);Logger.error(t.message),o.onError?.(t)};return ensureLocationPermission().then(()=>{i||(r=t.watchPosition(t=>{if(i)return;const r=normalizePosition(t);if(!r)return;const n=o.minimumAccuracyM;void 0!==n&&r.coords.accuracy>n||e(r)},e=>{i||fail(e)},toNativeOptions(o)))}).catch(fail),()=>{i||(i=!0,null!==r&&(t.clearWatch(r),r=null))}},isAvailable=()=>null!==resolveBackend();export const Geolocation={getCurrentPosition:getCurrentPosition,watchPosition:watchPosition,isAvailable:isAvailable};export const useCurrentPosition=(e={})=>{const{enabled:o=!0,accuracy:t,timeoutMs:i,maximumAgeMs:r,retries:n,minimumAccuracyM:s,retryDelayMs:a}=e,[c,l]=useState({position:null,error:null,loading:o}),u=useRef(!0),d=useRef(0);useEffect(()=>(u.current=!0,()=>{u.current=!1}),[]);const m=useCallback(()=>{d.current+=1;const e=d.current;l(e=>e.loading?e:{...e,loading:!0});const accept=o=>{u.current&&d.current===e&&l(o)};getCurrentPosition({accuracy:t,timeoutMs:i,maximumAgeMs:r,retries:n,minimumAccuracyM:s,retryDelayMs:a}).then(e=>accept({position:e,error:null,loading:!1}),e=>accept({position:null,error:toGeoError(e),loading:!1}))},[t,i,r,n,s,a]);return useEffect(()=>{if(!o)return d.current+=1,void l(e=>e.loading||null!==e.position||null!==e.error?{position:null,error:null,loading:!1}:e);m()},[o,m]),{position:c.position,error:c.error,loading:c.loading,refresh:m}};

package/lib/module/index.js

@@ -1,57 +1 @@
-"use strict";
-
-/**
- * The main barrel deliberately does NOT re-export the modules that need a native
- * package. Metro resolves requires statically, so anything reachable from here
- * is resolved for every consumer, which would make an optional peer mandatory
- * for anyone importing anything at all. Those live behind their own import
- * paths instead:
- *
- *   @webority/mobile-core/permissions  per kind, its own Expo module
- *   @webority/mobile-core/compressor   expo-image-manipulator + expo-file-system
- *   @webority/mobile-core/geolocation  a geolocation provider
- *   @webority/mobile-core/sqlite       expo-sqlite
- *   @webority/mobile-core/download     a filesystem module
- *   @webority/mobile-core/share        expo-sharing
- *   @webority/mobile-core/smsRetriever Android only, own TurboModule
- *
- * One more path is separate for size, not for a native package:
- *
- *   @webority/mobile-core/phone/countries  245 English country names
- *
- * Token storage is the exception and IS on the main barrel, because the HTTP
- * client reads the bearer token. It needs no optional peer: the backend is
- * expo-secure-store, and `expo` is required anyway.
- */
-// API clients
-export { buildCurl, logCurl } from "./api/curl.js";
-export { default as publicClient } from "./api/publicClient.js";
-export { attachRetry, isRetryableStatus } from "./api/retry.js";
-export { refreshAccessToken } from "./api/tokenRefresh.js";
-export { default as userClient, injectStore, injectUserAuth, RequestOfflineError, resetRefreshState, SESSION_TERMINATION_CODES } from "./api/userClient.js";
-// Auth / token storage
-export { ACCESS_TOKEN_KEY, getToken, REFRESH_TOKEN_KEY, removeToken, setKeychainImplementation, storeToken } from "./auth/authStore.js";
-export { decodeJWT, getJWTExpiry, isJWTExpired } from "./auth/jwt.js";
-// Configuration
-export { getConfig, getConfigValue, resetConfig, setConfig } from "./config/index.js";
-// Deep links
-export { DeepLink, parseDeepLink, useDeepLink } from "./deepLink/index.js";
-// Formatters
-export { AsYouType, addDays, clampNationalNumber, countryFlagEmoji, detectPhoneCountry, diffMs, formatCompactNumber, formatCurrency, formatDate, formatDateDDMMMYYYY, formatDateISO, formatDatePattern, formatDateTime, formatNumber, formatPercent, formatPhone, formatPhoneAsTyped, formatRelativeTime, formatTime, formatTime12h, formatTimeInWindowsZone, formatTimeInZone, getCountries, getCountryCallingCode, getInitials, getPhoneCountries, isDateAfter, isDateBefore, isSameDay, isSupportedCountry, isValidNationalNumber, isValidPhoneNumber, maxNationalNumberLength, normalizePhone, parsePhoneNumber, parsePhoneNumberFromString, splitPhoneNumber, startOfDay, validatePhoneNumberLength } from "./formatters/index.js";
-// Initialization
-export { initWebority } from "./initSDK.js";
-export { initUserAuth } from "./initUserAuth.js";
-// Logger
-export { configureLogger, getDeviceContext, Logger, setDeviceContext, setRemoteLogger } from "./logger/index.js";
-// Network status (the NetworkStatusBanner UI lives in @webority/mobile-ui)
-export { addNetworkStatusListener, getNetworkStatus, setNetworkStatusImplementation, useNetworkStatus } from "./network/index.js";
-// Storage: the API and the seam. No native package is required; wire one with
-// setStorageImplementation to get persistence.
-export { isStorageAvailable, Storage, setStorageImplementation } from "./storage/index.js";
-// Bytes
-export { encodeBase64 } from "./utils/base64.js";
-// Validators
-export { isAadhaar, isAlphanumeric, isBetween, isEmail, isGstin, isHexColor, isIfsc, isIndianMobile, isIndianPincode, isInteger, isNonEmpty, isNumeric, isPan, isPhone, isStrongPassword, isUrl, maxLength, minLength } from "./validators/index.js";
-// Version check (the ForceUpdateDialog UI lives in @webority/mobile-ui)
-export { setDeviceInfoImplementation, useVersionCheck, VersionCheck } from "./versionCheck/index.js";
-//# sourceMappingURL=index.js.map
+"use strict";export{ACCOUNT_ID_HEADER,CLIENT_BUILD_HEADER,CLIENT_KIND,CLIENT_KIND_HEADER,getClientBuild}from"./api/clientHeaders.js";export{buildCurl,logCurl}from"./api/curl.js";export{addMinAppVersionListener,getMinAppVersion,MIN_APP_VERSION_HEADER}from"./api/minAppVersion.js";export{default as publicClient}from"./api/publicClient.js";export{applyRequestDefaults,newCorrelationId}from"./api/requestDefaults.js";export{attachRetry,IDEMPOTENCY_KEY_HEADER,isNeverSentError,isRetryableFailure,isRetryableStatus,retryAfterMs}from"./api/retry.js";export{refreshAccessToken}from"./api/tokenRefresh.js";export{default as userClient,injectStore,injectUserAuth,RequestOfflineError,resetRefreshState,SESSION_TERMINATION_CODES,SIGN_OUT_REASON_HEADER}from"./api/userClient.js";export{ACCESS_TOKEN_KEY,addSessionEndedListener,clearSession,getSessionUser,getToken,LEGACY_REFRESH_TOKEN_LIFETIME_MS,REFRESH_TOKEN_KEY,removeSessionUser,removeToken,SESSION_USER_KEY,setKeychainImplementation,setLegacyTokenKeys,storeSessionUser,storeToken}from"./auth/authStore.js";export{decodeJWT,getJWTExpiry,isJWTExpired}from"./auth/jwt.js";export{getConfig,getConfigValue,resetConfig,setConfig}from"./config/index.js";export{DeepLink,parseDeepLink,useDeepLink}from"./deepLink/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{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{initWebority}from"./initSDK.js";export{initUserAuth}from"./initUserAuth.js";export{configureLogger,getDeviceContext,Logger,setDeviceContext,setRemoteLogger}from"./logger/index.js";export{crashlyticsRemoteLogger}from"./logger/crashlytics.js";export{addNetworkStatusListener,getNetworkStatus,setNetworkStatusImplementation,useNetworkStatus}from"./network/index.js";export{PUSH_STATUS}from"./push/status.js";export{isStorageAvailable,Storage,setStorageImplementation}from"./storage/index.js";export{encodeBase64}from"./utils/base64.js";export{isAadhaar,isAlphanumeric,isBetween,isEmail,isGstin,isHexColor,isIfsc,isIndianMobile,isIndianPincode,isInteger,isNonEmpty,isNumeric,isPan,isPhone,isStrongPassword,isUrl,maxLength,minLength}from"./validators/index.js";export{isBuildBelowMinimum,parseBuildNumber,setDeviceInfoImplementation,useVersionCheck,VersionCheck}from"./versionCheck/index.js";

package/lib/module/initSDK.js

@@ -1,61 +1 @@
-"use strict";
-
-/**
- * Simple initialization API for Webority packages
- * One function to configure everything needed
- */
-
-import { setKeychainImplementation } from "./auth/authStore.js";
-import { DEFAULT_LOG_LEVEL, setConfig } from "./config/index.js";
-import { Logger } from "./logger/index.js";
-import { setNetworkStatusImplementation } from "./network/networkStatus.js";
-import { setStorageImplementation } from "./storage/index.js";
-/**
- * Initialize Webority packages with your project configuration.
- *
- * @example
- * // Basic setup
- * initWebority({
- *   baseUrl: 'https://api.myapp.com'
- * });
- *
- * @example
- * // Full configuration
- * initWebority({
- *   baseUrl: 'https://api.myapp.com',
- *   loggingEnabled: __DEV__,
- *   logLevel: 'warn',
- *   environment: __DEV__ ? 'Development' : 'Production'
- * });
- */
-export const initWebority = config => {
-  if (!config.baseUrl) {
-    throw new Error('baseUrl is required for Webority packages initialization');
-  }
-  setConfig({
-    baseUrl: config.baseUrl,
-    loggingEnabled: config.loggingEnabled ?? true,
-    logLevel: config.logLevel || DEFAULT_LOG_LEVEL,
-    environment: config.environment || 'Development',
-    country: (config.country || 'in').toLowerCase(),
-    appId: config.appId ?? null,
-    appVersion: config.appVersion ?? null,
-    logCurl: config.logCurl ?? false
-  });
-
-  // Only what the caller actually passed is wired. Calling a setter with
-  // `undefined` would reset a backend an app had already injected by hand,
-  // which is why each is guarded rather than passed straight through.
-  const backends = config.backends;
-  if (backends?.storage) {
-    setStorageImplementation(backends.storage);
-  }
-  if (backends?.keychain) {
-    setKeychainImplementation(backends.keychain);
-  }
-  if (backends?.network) {
-    setNetworkStatusImplementation(backends.network);
-  }
-  Logger.info('[@webority/mobile-core] initialized');
-};
-//# sourceMappingURL=initSDK.js.map
+"use strict";import{setKeychainImplementation}from"./auth/authStore.js";import{DEFAULT_CORRELATION_ID_HEADER,DEFAULT_LOG_LEVEL,DEFAULT_RETRIES,DEFAULT_TIMEOUT_MS,setConfig}from"./config/index.js";import{Logger}from"./logger/index.js";import{setNetworkStatusImplementation}from"./network/networkStatus.js";import{setStorageImplementation}from"./storage/index.js";export const initWebority=e=>{if(!e.baseUrl)throw new Error("baseUrl is required for Webority packages initialization");setConfig({baseUrl:e.baseUrl,loggingEnabled:e.loggingEnabled??!0,logLevel:e.logLevel||DEFAULT_LOG_LEVEL,environment:e.environment||"Development",country:(e.country||"in").toLowerCase(),appId:e.appId??null,appVersion:e.appVersion??null,commit:e.commit??null,appBuild:e.appBuild??null,appStoreId:e.appStoreId??null,logCurl:e.logCurl??!1,timeoutMs:e.timeoutMs??DEFAULT_TIMEOUT_MS,retries:e.retries??DEFAULT_RETRIES,correlationIdHeader:void 0===e.correlationIdHeader?DEFAULT_CORRELATION_ID_HEADER:e.correlationIdHeader});const t=e.backends;t?.storage&&setStorageImplementation(t.storage),t?.keychain&&setKeychainImplementation(t.keychain),t?.network&&setNetworkStatusImplementation(t.network),Logger.info("[@webority/mobile-core] initialized")};

package/lib/module/initUserAuth.js

@@ -1,33 +1 @@
-"use strict";
-
-import { injectStore, injectUserAuth } from "./api/userClient.js";
-import { Logger } from "./logger/index.js";
-
-/** The tokens a refresh response carries, with their expiry timestamps. */
-
-/**
- * How the library calls the app's refresh endpoint. The call goes through
- * `publicClient`, and the new tokens are stored under the library's own keys.
- */
-
-/**
- * Wire the user client to the app: the Redux store it dispatches `logout` to,
- * and the refresh endpoint it calls when an access token expires or a request
- * answers 401. Only a 400 or 401 from that endpoint, or a missing or expired
- * refresh token, logs out; a network error, timeout or 5xx keeps the session.
- *
- * @example
- * initUserAuth(store, { logout, refresh: { path: '/Account/RefreshToken' } });
- */
-export const initUserAuth = (store, options) => {
-  if (!store) {
-    throw new Error('Redux store is required for user package initialization');
-  }
-  if (!options.logout || !options.refresh?.path) {
-    throw new Error('initUserAuth needs a logout action and refresh.path');
-  }
-  injectStore(store);
-  injectUserAuth(options);
-  Logger.info('[@webority/mobile-core] user auth wired to the store');
-};
-//# sourceMappingURL=initUserAuth.js.map
+"use strict";import{injectStore,injectUserAuth}from"./api/userClient.js";import{setLegacyTokenKeys}from"./auth/authStore.js";import{Logger}from"./logger/index.js";export const initUserAuth=(e,r)=>{if(!e)throw new Error("Redux store is required for user package initialization");if(!r.logout||!r.refresh?.path)throw new Error("initUserAuth needs a logout action and refresh.path");injectStore(e),injectUserAuth(r),setLegacyTokenKeys(r.legacyKeys??null),Logger.info("[@webority/mobile-core] user auth wired to the store")};

package/lib/module/logger/crashlytics.js

@@ -0,0 +1 @@
+"use strict";const toError=r=>r instanceof Error?r:new Error(String(r)),describe=r=>{try{return JSON.stringify(r)}catch{return String(r)}};export const crashlyticsRemoteLogger=r=>{const send=t=>{try{const e=t(r.getCrashlytics());e&&"function"==typeof e.catch&&e.catch(()=>{})}catch{}};return{breadcrumb:(t,e)=>send(o=>r.log(o,e?`${t} ${describe(e)}`:t)),recordError:(t,e)=>{e&&send(t=>r.log(t,`context ${describe(e)}`)),send(e=>r.recordError(e,toError(t)))},setUser:t=>send(e=>r.setUserId(e,t??"")),setAttribute:(t,e)=>send(o=>r.setAttribute(o,t,null===e?"":String(e))),log:(t,e)=>send(o=>r.log(o,`[${t.toUpperCase()}] ${e}`))}};