@webority/mobile-core 0.0.29 → 0.2.0

package/lib/module/config/index.js

@@ -1,64 +1 @@
-"use strict";
-
-/**
- * Configuration management for Webority packages
- * Provides a flexible way to inject configuration without hard dependencies
- */
-
-/**
- * Info lines (each token refresh, each unauthorised URL) reach the device log
- * and any remote sink, so a release build that sets nothing logs warnings and
- * errors only.
- */
-export const DEFAULT_LOG_LEVEL = __DEV__ ? 'info' : 'warn';
-const DEFAULT_CONFIG = {
-  baseUrl: null,
-  loggingEnabled: true,
-  logLevel: DEFAULT_LOG_LEVEL,
-  environment: 'Development',
-  country: 'in',
-  appId: null,
-  appVersion: null,
-  logCurl: false
-};
-let globalConfig = {
-  ...DEFAULT_CONFIG
-};
-
-/**
- * Set global configuration for all Webority packages
- */
-export const setConfig = config => {
-  globalConfig = {
-    ...globalConfig,
-    ...config
-  };
-};
-
-/**
- * Get current configuration
- */
-export const getConfig = () => globalConfig;
-
-/**
- * Get a specific config value with optional fallback.
- * If the stored value is `null`, the fallback is returned (when provided).
- */
-
-export function getConfigValue(key, fallback) {
-  const value = globalConfig[key];
-  if (value !== null) {
-    return value;
-  }
-  return fallback;
-}
-
-/**
- * Reset configuration to defaults
- */
-export const resetConfig = () => {
-  globalConfig = {
-    ...DEFAULT_CONFIG
-  };
-};
-//# sourceMappingURL=index.js.map
+"use strict";export const DEFAULT_LOG_LEVEL=__DEV__?"info":"warn";export const DEFAULT_TIMEOUT_MS=3e4;export const DEFAULT_RETRIES=3;export const DEFAULT_CORRELATION_ID_HEADER="X-Correlation-Id";const DEFAULT_CONFIG={baseUrl:null,loggingEnabled:!0,logLevel:DEFAULT_LOG_LEVEL,environment:"Development",country:"in",appId:null,appVersion:null,commit:null,appBuild:null,appStoreId:null,logCurl:!1,timeoutMs:3e4,retries:3,correlationIdHeader:"X-Correlation-Id"};let globalConfig={...DEFAULT_CONFIG};export const setConfig=o=>{globalConfig={...globalConfig,...o}};export const getConfig=()=>globalConfig;export function getConfigValue(o,n){const l=globalConfig[o];return null!==l?l:n}export const resetConfig=()=>{globalConfig={...DEFAULT_CONFIG}};

package/lib/module/deepLink/index.js

@@ -1,280 +1 @@
-"use strict";
-
-import { useEffect, useRef } from 'react';
-import { Linking } from 'react-native';
-import { Logger } from "../logger/index.js";
-const PREFIX = '[@webority/mobile-core]';
-const decodeSafe = value => {
-  try {
-    return decodeURIComponent(value.replace(/\+/g, ' '));
-  } catch {
-    return value;
-  }
-};
-const parseQuery = raw => {
-  const out = {};
-  if (!raw) {
-    return out;
-  }
-  for (const pair of raw.split('&')) {
-    if (!pair) {
-      continue;
-    }
-    const eq = pair.indexOf('=');
-    const key = decodeSafe(eq >= 0 ? pair.slice(0, eq) : pair);
-    if (!key) {
-      continue;
-    }
-    out[key] = eq >= 0 ? decodeSafe(pair.slice(eq + 1)) : '';
-  }
-  return out;
-};
-const trimSlashes = value => value.replace(/^\/+/, '').replace(/\/+$/, '');
-
-/**
- * Parse a deep-link URL. Returns null for anything that is not a usable URL so
- * a hostile or truncated link can never throw on the native event path.
- */
-export const parseDeepLink = url => {
-  if (typeof url !== 'string') {
-    return null;
-  }
-  const trimmed = url.trim();
-  if (!trimmed || /\s/.test(trimmed)) {
-    return null;
-  }
-  const withoutFragment = trimmed.split('#')[0] ?? '';
-  const schemeEnd = withoutFragment.indexOf('://');
-  let scheme = '';
-  let rest = withoutFragment;
-  if (schemeEnd >= 0) {
-    const rawScheme = withoutFragment.slice(0, schemeEnd);
-    if (!/^[a-zA-Z][a-zA-Z0-9+.-]*$/.test(rawScheme)) {
-      return null;
-    }
-    scheme = rawScheme.toLowerCase();
-    rest = withoutFragment.slice(schemeEnd + 3);
-  }
-  const queryStart = rest.indexOf('?');
-  const rawPath = queryStart >= 0 ? rest.slice(0, queryStart) : rest;
-  const query = parseQuery(queryStart >= 0 ? rest.slice(queryStart + 1) : '');
-  let host = '';
-  let pathPart = rawPath;
-  if (scheme === 'http' || scheme === 'https') {
-    const slash = rawPath.indexOf('/');
-    host = slash >= 0 ? rawPath.slice(0, slash) : rawPath;
-    pathPart = slash >= 0 ? rawPath.slice(slash + 1) : '';
-  }
-  const path = trimSlashes(pathPart);
-  const segments = path ? path.split('/').filter(Boolean) : [];
-  if (scheme && scheme !== 'http' && scheme !== 'https') {
-    host = segments[0] ?? '';
-  }
-  return {
-    url: trimmed,
-    scheme,
-    host,
-    path,
-    segments,
-    query
-  };
-};
-const matchPattern = (pattern, segments) => {
-  const patternSegments = trimSlashes(pattern).split('/').filter(Boolean);
-  if (patternSegments.length !== segments.length) {
-    return null;
-  }
-  const params = {};
-  for (let i = 0; i < patternSegments.length; i += 1) {
-    const p = patternSegments[i];
-    const s = segments[i];
-    if (p.startsWith(':')) {
-      const name = p.slice(1);
-      if (!name) {
-        return null;
-      }
-      params[name] = s;
-    } else if (p.toLowerCase() !== s.toLowerCase()) {
-      return null;
-    }
-  }
-  return params;
-};
-const matchRegExp = (pattern, path) => {
-  // A /g or /y pattern carries lastIndex between calls, so the same link would
-  // match on one dispatch and miss on the next.
-  if (pattern.global || pattern.sticky) {
-    pattern.lastIndex = 0;
-  }
-  const result = pattern.exec(path);
-  if (!result) {
-    return null;
-  }
-  const params = {};
-  for (let i = 1; i < result.length; i += 1) {
-    const group = result[i];
-    if (group !== undefined) {
-      params[String(i)] = group;
-    }
-  }
-  for (const [name, value] of Object.entries(result.groups ?? {})) {
-    if (value !== undefined) {
-      params[name] = value;
-    }
-  }
-  return params;
-};
-const matchRoute = (routes, link) => {
-  for (const route of routes) {
-    const params = typeof route.match === 'string' ? matchPattern(route.match, link.segments) : matchRegExp(route.match, link.path);
-    if (params) {
-      return {
-        route,
-        params
-      };
-    }
-  }
-  return null;
-};
-let config = null;
-let subscription = null;
-let started = false;
-let pending = null;
-let readyOverride = null;
-const isReady = () => {
-  if (readyOverride !== null) {
-    return readyOverride;
-  }
-  return config?.isReady?.() ?? true;
-};
-const isAuthenticated = () => config?.isAuthenticated?.() ?? true;
-const dispatch = link => {
-  const active = config;
-  if (!active) {
-    return;
-  }
-  const matched = matchRoute(active.routes, link);
-  if (!matched) {
-    active.onUnmatched?.(link);
-    return;
-  }
-  if (matched.route.requiresAuth && !isAuthenticated()) {
-    pending = link;
-    active.onUnauthenticated?.(link);
-    return;
-  }
-  matched.route.handler(link, matched.params);
-};
-const flushPending = () => {
-  const link = pending;
-  if (!link) {
-    return;
-  }
-  // Cleared BEFORE dispatch: a handler that navigates can re-enter this path,
-  // and a link that fires twice is the classic deep-link duplicate-screen bug.
-  pending = null;
-  dispatch(link);
-};
-const configure = next => {
-  if (!next || !Array.isArray(next.routes)) {
-    throw new Error(`${PREFIX} DeepLink.configure() needs a config object with a "routes" array. ` + 'Pass { routes: [{ match: "order/:id", handler }] }.');
-  }
-  config = next;
-};
-const handleUrl = url => {
-  if (!config) {
-    Logger.error(`${PREFIX} DeepLink received a URL before configure() was called; the link was dropped. ` + 'Call DeepLink.configure({ routes }) (or useDeepLink) during app start.');
-    return;
-  }
-  const parsed = parseDeepLink(url);
-  // A malformed URL still reaches the app through onUnmatched, with the raw
-  // value in `url`, rather than vanishing.
-  if (!parsed) {
-    config.onUnmatched?.({
-      url: typeof url === 'string' ? url : '',
-      scheme: '',
-      host: '',
-      path: '',
-      segments: [],
-      query: {}
-    });
-    return;
-  }
-  const link = parsed;
-  if (!isReady()) {
-    pending = link;
-    return;
-  }
-  dispatch(link);
-};
-const start = async () => {
-  if (!config) {
-    throw new Error(`${PREFIX} DeepLink.start() was called before configure(). ` + 'Call DeepLink.configure({ routes }) first, or use the useDeepLink() hook.');
-  }
-  if (started) {
-    return;
-  }
-  started = true;
-  // Subscribe before reading the cold-start URL so a link arriving during the
-  // await is not lost.
-  subscription = Linking.addEventListener('url', event => {
-    handleUrl(event.url);
-  });
-  try {
-    const initial = await Linking.getInitialURL();
-    if (initial) {
-      handleUrl(initial);
-    }
-  } catch (error) {
-    Logger.error(`${PREFIX} DeepLink could not read the cold-start URL`, error);
-  }
-};
-const stop = () => {
-  subscription?.remove?.();
-  subscription = null;
-  started = false;
-  pending = null;
-  readyOverride = null;
-};
-const setReady = ready => {
-  readyOverride = ready;
-  if (ready) {
-    flushPending();
-  }
-};
-export const DeepLink = {
-  configure,
-  start,
-  stop,
-  handleUrl,
-  setReady,
-  /** Replay the stashed link, once. Call after a successful login. */
-  replayPending: flushPending,
-  getPending: () => pending
-};
-
-/**
- * Configure and start the deep-link service for the lifetime of a component.
- * The stored config delegates to the latest render, so new route closures do
- * not tear down and re-subscribe the native listener.
- */
-export const useDeepLink = deepLinkConfig => {
-  const configRef = useRef(deepLinkConfig);
-  configRef.current = deepLinkConfig;
-  useEffect(() => {
-    DeepLink.configure({
-      get routes() {
-        return configRef.current.routes;
-      },
-      isReady: () => configRef.current.isReady?.() ?? true,
-      isAuthenticated: () => configRef.current.isAuthenticated?.() ?? true,
-      onUnauthenticated: link => configRef.current.onUnauthenticated?.(link),
-      onUnmatched: link => configRef.current.onUnmatched?.(link)
-    });
-    void DeepLink.start();
-    return () => {
-      DeepLink.stop();
-    };
-  }, []);
-};
-//# sourceMappingURL=index.js.map
+"use strict";import{useEffect,useRef}from"react";import{Linking}from"react-native";import{Logger}from"../logger/index.js";const PREFIX="[@webority/mobile-core]",decodeSafe=e=>{try{return decodeURIComponent(e.replace(/\+/g," "))}catch{return e}},parseQuery=e=>{const t={};if(!e)return t;for(const n of e.split("&")){if(!n)continue;const e=n.indexOf("="),r=decodeSafe(e>=0?n.slice(0,e):n);r&&(t[r]=e>=0?decodeSafe(n.slice(e+1)):"")}return t},trimSlashes=e=>e.replace(/^\/+/,"").replace(/\/+$/,"");export const parseDeepLink=e=>{if("string"!=typeof e)return null;const t=e.trim();if(!t||/\s/.test(t))return null;const n=t.split("#")[0]??"",r=n.indexOf("://");let i="",s=n;if(r>=0){const e=n.slice(0,r);if(!/^[a-zA-Z][a-zA-Z0-9+.-]*$/.test(e))return null;i=e.toLowerCase(),s=n.slice(r+3)}const o=s.indexOf("?"),c=o>=0?s.slice(0,o):s,a=parseQuery(o>=0?s.slice(o+1):"");let l="",u=c;if("http"===i||"https"===i){const e=c.indexOf("/");l=e>=0?c.slice(0,e):c,u=e>=0?c.slice(e+1):""}const d=trimSlashes(u),f=d?d.split("/").filter(Boolean):[];return i&&"http"!==i&&"https"!==i&&(l=f[0]??""),{url:t,scheme:i,host:l,path:d,segments:f,query:a}};const matchPattern=(e,t)=>{const n=trimSlashes(e).split("/").filter(Boolean);if(n.length!==t.length)return null;const r={};for(let e=0;e<n.length;e+=1){const i=n[e],s=t[e];if(i.startsWith(":")){const e=i.slice(1);if(!e)return null;r[e]=s}else if(i.toLowerCase()!==s.toLowerCase())return null}return r},matchRegExp=(e,t)=>{(e.global||e.sticky)&&(e.lastIndex=0);const n=e.exec(t);if(!n)return null;const r={};for(let e=1;e<n.length;e+=1){const t=n[e];void 0!==t&&(r[String(e)]=t)}for(const[e,t]of Object.entries(n.groups??{}))void 0!==t&&(r[e]=t);return r},matchRoute=(e,t)=>{for(const n of e){const e="string"==typeof n.match?matchPattern(n.match,t.segments):matchRegExp(n.match,t.path);if(e)return{route:n,params:e}}return null};let config=null,subscription=null,started=!1,pending=null,readyOverride=null;const isReady=()=>null!==readyOverride?readyOverride:config?.isReady?.()??!0,isAuthenticated=()=>config?.isAuthenticated?.()??!0,dispatch=e=>{const t=config;if(!t)return;const n=matchRoute(t.routes,e);if(n)return n.route.requiresAuth&&!isAuthenticated()?(pending=e,void t.onUnauthenticated?.(e)):void n.route.handler(e,n.params);t.onUnmatched?.(e)},flushPending=()=>{const e=pending;e&&(pending=null,dispatch(e))},configure=e=>{if(!e||!Array.isArray(e.routes))throw new Error(`${PREFIX} DeepLink.configure() needs a config object with a "routes" array. Pass { routes: [{ match: "order/:id", handler }] }.`);config=e},handleUrl=e=>{if(!config)return void Logger.error(`${PREFIX} DeepLink received a URL before configure() was called; the link was dropped. Call DeepLink.configure({ routes }) (or useDeepLink) during app start.`);const t=parseDeepLink(e);if(!t)return void config.onUnmatched?.({url:"string"==typeof e?e:"",scheme:"",host:"",path:"",segments:[],query:{}});const n=t;isReady()?dispatch(n):pending=n},start=async()=>{if(!config)throw new Error(`${PREFIX} DeepLink.start() was called before configure(). Call DeepLink.configure({ routes }) first, or use the useDeepLink() hook.`);if(!started){started=!0,subscription=Linking.addEventListener("url",e=>{handleUrl(e.url)});try{const e=await Linking.getInitialURL();e&&handleUrl(e)}catch(e){Logger.error(`${PREFIX} DeepLink could not read the cold-start URL`,e)}}},stop=()=>{subscription?.remove?.(),subscription=null,started=!1,pending=null,readyOverride=null},setReady=e=>{readyOverride=e,e&&flushPending()};export const DeepLink={configure:configure,start:start,stop:stop,handleUrl:handleUrl,setReady:setReady,replayPending:flushPending,getPending:()=>pending};export const useDeepLink=e=>{const t=useRef(e);t.current=e,useEffect(()=>(DeepLink.configure({get routes(){return t.current.routes},isReady:()=>t.current.isReady?.()??!0,isAuthenticated:()=>t.current.isAuthenticated?.()??!0,onUnauthenticated:e=>t.current.onUnauthenticated?.(e),onUnmatched:e=>t.current.onUnmatched?.(e)}),DeepLink.start(),()=>{DeepLink.stop()}),[])};

package/lib/module/download/adapters/expoFs.js

@@ -1,64 +1 @@
-"use strict";
-
-/**
- * expo-file-system. Shape verified against 57.0.6, where the legacy function
- * API (`downloadAsync`, `getInfoAsync`) still exists on the main entry point
- * but every one of those functions THROWS at runtime; they now live behind
- * `expo-file-system/legacy`. This adapter therefore uses the class API only.
- *
- * The REQUIRE lives in the entry point beside this file, never here.
- */
-
-/**
- * expo reports a directory as a URI with a trailing slash, and the download
- * module joins a directory to a file name with a `/` of its own.
- */
-const asDirectoryPath = uri => uri.replace(/\/+$/, '');
-export const adaptExpoFileSystem = mod => {
-  const lib = mod?.default ?? mod;
-  if (typeof lib?.File !== 'function' || typeof lib.File.prototype?.write !== 'function') {
-    return null;
-  }
-  const {
-    File,
-    Directory,
-    Paths
-  } = lib;
-  const documents = asDirectoryPath(Paths.document.uri);
-  return {
-    dirs: {
-      documents,
-      cache: asDirectoryPath(Paths.cache.uri),
-      // expo exposes no public Downloads directory, so a "downloads" request
-      // lands in the app's documents directory instead of the shared folder.
-      downloads: documents
-    },
-    write: (path, bytes) => {
-      const file = new File(path);
-      file.create({
-        intermediates: true,
-        overwrite: true
-      });
-      file.write(bytes);
-      return Promise.resolve();
-    },
-    exists: path => Promise.resolve(new File(path).exists),
-    stat: path => Promise.resolve({
-      size: new File(path).size
-    }),
-    unlink: path => {
-      new File(path).delete();
-      return Promise.resolve();
-    },
-    // The download module calls this for a directory that usually already
-    // exists, so it must be idempotent rather than throw on the second run.
-    mkdir: path => {
-      new Directory(path).create({
-        intermediates: true,
-        idempotent: true
-      });
-      return Promise.resolve();
-    }
-  };
-};
-//# sourceMappingURL=expoFs.js.map
+"use strict";const asDirectoryPath=e=>e.replace(/\/+$/,"");export const adaptExpoFileSystem=e=>{const t=e?.default??e;if("function"!=typeof t?.File||"function"!=typeof t.File.prototype?.write)return null;const{File:r,Directory:i,Paths:s}=t,o=asDirectoryPath(s.document.uri);return{dirs:{documents:o,cache:asDirectoryPath(s.cache.uri),downloads:o},write:(e,t)=>{const i=new r(e);return i.create({intermediates:!0,overwrite:!0}),i.write(t),Promise.resolve()},exists:e=>Promise.resolve(new r(e).exists),stat:e=>Promise.resolve({size:new r(e).size}),unlink:e=>(new r(e).delete(),Promise.resolve()),mkdir:e=>(new i(e).create({intermediates:!0,idempotent:!0}),Promise.resolve())}};

package/lib/module/download/adapters/shared.js

@@ -1,8 +1 @@
-"use strict";
-
-/** Coerce a driver-supplied size, which some report as a string. */
-export const asNumber = value => {
-  const n = typeof value === 'number' ? value : Number(value);
-  return Number.isFinite(n) ? n : 0;
-};
-//# sourceMappingURL=shared.js.map
+"use strict";export const asNumber=e=>{const r="number"==typeof e?e:Number(e);return Number.isFinite(r)?r:0};

package/lib/module/download/index.js

@@ -1,242 +1 @@
-"use strict";
-
-import * as ExpoFileSystem from 'expo-file-system';
-import { Platform } from 'react-native';
-import { Logger } from "../logger/index.js";
-import { Permissions } from "../permissions/index.js";
-import { adaptExpoFileSystem } from "./adapters/expoFs.js";
-import { asNumber } from "./adapters/shared.js";
-const PREFIX = '[@webority/mobile-core]';
-
-/** Android stopped requiring a storage permission for a Downloads write at API 29. */
-const SCOPED_STORAGE_API_LEVEL = 29;
-
-/** A file can take far longer than the 30 s the fleet's JSON clients allow. */
-const DOWNLOAD_TIMEOUT_MS = 300000;
-
-/**
- * The slice of a filesystem module this module actually uses. expo-file-system
- * is adapted onto it, and a test or the showcase can inject its own with
- * `setFileSystemImplementation`.
- */
-
-/**
- * The slice of an HTTP client a download needs. The app's axios instance
- * (mobile-core's `userClient` or `publicClient`, or its own) satisfies it as is,
- * so whatever that client adds to a request (bearer token, tenant header, refresh
- * and retry on 401) applies to the download too. Declared structurally, as
- * mobile-support's client is, so no axios type leaks into the declarations.
- */
-
-export class DownloadError extends Error {
-  constructor(code, message, status) {
-    super(`${PREFIX} ${message}`);
-    this.name = 'DownloadError';
-    this.code = code;
-    this.status = status;
-    // Babel's class transform can drop the prototype link, which makes
-    // `instanceof DownloadError` false in the transpiled build.
-    Object.setPrototypeOf(this, DownloadError.prototype);
-  }
-}
-const describe = error => error instanceof Error ? error.message : String(error);
-
-/** Only what a test or the showcase injected; null means use expo-file-system. */
-let backend = null;
-
-/**
- * expo-file-system, adapted once and memoised. The adapter is shape-checked, so
- * a build where the native module did not link returns null and the guided
- * error below still fires rather than a confusing property access.
- */
-let expoBackend;
-const resolveBackend = () => {
-  if (backend) {
-    return backend;
-  }
-  if (expoBackend === undefined) {
-    expoBackend = adaptExpoFileSystem(ExpoFileSystem);
-  }
-  return expoBackend;
-};
-
-/**
- * Replace the filesystem backend. Intended for TESTS and for the showcase,
- * which injects a denying backend to demo the permission error; an app gets
- * expo-file-system without wiring anything. Pass `null` to restore it.
- */
-export const setFileSystemImplementation = impl => {
-  backend = impl;
-};
-const requireBackend = () => {
-  const fs = resolveBackend();
-  if (!fs) {
-    throw new DownloadError('unsupported', 'No filesystem module is available, so files cannot be downloaded. ' + 'expo-file-system did not load, which on a real build means the native module ' + 'was not linked.');
-  }
-  return fs;
-};
-const stripControlChars = value => Array.from(value).filter(char => (char.codePointAt(0) ?? 0) > 0x1f).join('');
-const lastSegment = raw => {
-  const segments = raw.split(/[/\\]/);
-  return stripControlChars(segments[segments.length - 1] ?? '').trim();
-};
-
-/**
- * Reduce a caller- or server-supplied name to a single path segment: `../../evil.pdf`
- * must land inside the destination directory as `evil.pdf` rather than escaping it.
- */
-const sanitiseFileName = raw => {
-  const base = lastSegment(raw);
-  if (base === '' || base === '.' || base === '..') {
-    throw new DownloadError('write-failed', `"${raw}" does not contain a usable file name. Pass an explicit fileName.`);
-  }
-  return base;
-};
-const fileNameFromUrl = url => {
-  const withoutQuery = url.split('#')[0]?.split('?')[0] ?? '';
-  const last = withoutQuery.split('/').pop() ?? '';
-  let decoded = last;
-  try {
-    decoded = decodeURIComponent(last);
-  } catch {
-    // A malformed escape sequence is not a reason to fail the download.
-  }
-  const base = lastSegment(decoded);
-  return base === '' || base === '.' || base === '..' ? 'download' : base;
-};
-const androidApiLevel = () => typeof Platform.Version === 'number' ? Platform.Version : Number.parseInt(String(Platform.Version), 10);
-const ensureStoragePermission = async destination => {
-  if (Platform.OS !== 'android' || destination !== 'downloads') {
-    return;
-  }
-  if (androidApiLevel() >= SCOPED_STORAGE_API_LEVEL) {
-    return;
-  }
-  const status = await Permissions.ensure('storage');
-  if (status === 'granted' || status === 'limited') {
-    return;
-  }
-  throw new DownloadError('permission-denied', `Storage permission is "${status}", so nothing can be written to the Downloads folder ` + 'on this Android version. Ask the user to grant it (Permissions.openSettings()), or ' + 'download to the "documents" destination instead.');
-};
-const emptyFile = url => new DownloadError('empty-file', `The download of ${url} produced an empty file, so nothing was saved. ` + 'Check that the URL is correct and that the request carried the credentials the ' + 'server expects.');
-const requestFailed = (error, options, fileName) => {
-  if (options.signal?.aborted) {
-    return new DownloadError('aborted', `The download of ${fileName} was aborted.`);
-  }
-  const e = error ?? {};
-  // By name, not instanceof: a second copy of mobile-core would fail instanceof.
-  if (e.name === 'RequestOfflineError') {
-    return new DownloadError('network', `The device is offline, so ${options.url} was not downloaded.`);
-  }
-  const status = e.response?.status;
-  if (typeof status === 'number') {
-    return new DownloadError('http-error', `The server answered ${status} for ${options.url}, so no file was saved.`, status);
-  }
-  return new DownloadError('network', `The download of ${options.url} failed: ${describe(error)}`);
-};
-const discardPartial = async (fs, path) => {
-  try {
-    if (await fs.exists(path)) {
-      await fs.unlink(path);
-    }
-  } catch (error) {
-    Logger.warn(`${PREFIX} Failed to remove the partial download at ${path}`, error);
-  }
-};
-
-/**
- * Download a file to the device through the app's own HTTP client, so it is
- * authenticated exactly as the app's other calls are. The whole file is held
- * in memory before it is written, which suits documents and reports rather
- * than large media.
- *
- * A finished download is always verified to be non-empty: a 0-byte file looks
- * like a success to every caller and then wedges whatever consumes it, so it is
- * reported as `empty-file` and nothing is kept.
- */
-export const downloadFile = async options => {
-  const fs = requireBackend();
-  const destination = options.destination ?? 'documents';
-  const fileName = options.fileName ? sanitiseFileName(options.fileName) : fileNameFromUrl(options.url);
-  await ensureStoragePermission(destination);
-  const directory = fs.dirs[destination];
-  const path = `${directory}/${fileName}`;
-  if (options.signal?.aborted) {
-    throw new DownloadError('aborted', `The download of ${fileName} was aborted before it started.`);
-  }
-  let reuseExisting = false;
-  try {
-    await fs.mkdir(directory);
-    const exists = await fs.exists(path);
-    if (exists && options.overwrite === false) {
-      reuseExisting = true;
-    } else if (exists) {
-      await fs.unlink(path);
-    }
-  } catch (error) {
-    throw new DownloadError('write-failed', `Could not prepare ${path} for writing: ${describe(error)}`);
-  }
-  if (reuseExisting) {
-    const stat = await fs.stat(path);
-    return {
-      path,
-      bytes: asNumber(stat?.size),
-      mimeType: options.mimeType,
-      fromCache: true
-    };
-  }
-  const {
-    onProgress
-  } = options;
-  let data;
-  try {
-    ({
-      data
-    } = await options.client.get(options.url, {
-      headers: {
-        Accept: '*/*',
-        ...options.headers
-      },
-      responseType: 'arraybuffer',
-      timeout: DOWNLOAD_TIMEOUT_MS,
-      signal: options.signal,
-      onDownloadProgress: onProgress ? ({
-        loaded,
-        total = 0
-      }) => onProgress(loaded, total, total > 0 ? loaded / total : 0) : undefined
-    }));
-  } catch (error) {
-    throw requestFailed(error, options, fileName);
-  }
-  if (options.signal?.aborted) {
-    throw new DownloadError('aborted', `The download of ${fileName} was aborted.`);
-  }
-  const received = new Uint8Array(data ?? new ArrayBuffer(0));
-  if (received.byteLength === 0) {
-    throw emptyFile(options.url);
-  }
-  try {
-    await fs.write(path, received);
-  } catch (error) {
-    await discardPartial(fs, path);
-    throw new DownloadError('write-failed', `Could not write ${path}: ${describe(error)}`);
-  }
-  let bytes = 0;
-  try {
-    bytes = (await fs.exists(path)) ? asNumber((await fs.stat(path)).size) : 0;
-  } catch (error) {
-    await discardPartial(fs, path);
-    throw new DownloadError('write-failed', `The download of ${fileName} finished but ${path} could not be read back: ${describe(error)}`);
-  }
-  if (bytes <= 0) {
-    await discardPartial(fs, path);
-    throw emptyFile(options.url);
-  }
-  return {
-    path,
-    bytes,
-    mimeType: options.mimeType,
-    fromCache: false
-  };
-};
-//# sourceMappingURL=index.js.map
+"use strict";import*as ExpoFileSystem from"expo-file-system";import{Platform}from"react-native";import{Logger}from"../logger/index.js";import{Permissions}from"../permissions/index.js";import{adaptExpoFileSystem}from"./adapters/expoFs.js";import{asNumber}from"./adapters/shared.js";const PREFIX="[@webority/mobile-core]",SCOPED_STORAGE_API_LEVEL=29,DOWNLOAD_TIMEOUT_MS=3e5;export class DownloadError extends Error{constructor(e,r,o){super(`${PREFIX} ${r}`),this.name="DownloadError",this.code=e,this.status=o,Object.setPrototypeOf(this,DownloadError.prototype)}}const describe=e=>e instanceof Error?e.message:String(e);let expoBackend,backend=null;const resolveBackend=()=>backend||(void 0===expoBackend&&(expoBackend=adaptExpoFileSystem(ExpoFileSystem)),expoBackend);export const setFileSystemImplementation=e=>{backend=e};const requireBackend=()=>{const e=resolveBackend();if(!e)throw new DownloadError("unsupported","No filesystem module is available, so files cannot be downloaded. expo-file-system did not load, which on a real build means the native module was not linked.");return e},stripControlChars=e=>Array.from(e).filter(e=>(e.codePointAt(0)??0)>31).join(""),lastSegment=e=>{const r=e.split(/[/\\]/);return stripControlChars(r[r.length-1]??"").trim()},sanitiseFileName=e=>{const r=lastSegment(e);if(""===r||"."===r||".."===r)throw new DownloadError("write-failed",`"${e}" does not contain a usable file name. Pass an explicit fileName.`);return r},fileNameFromUrl=e=>{const r=(e.split("#")[0]?.split("?")[0]??"").split("/").pop()??"";let o=r;try{o=decodeURIComponent(r)}catch{}const t=lastSegment(o);return""===t||"."===t||".."===t?"download":t},androidApiLevel=()=>"number"==typeof Platform.Version?Platform.Version:Number.parseInt(String(Platform.Version),10),ensureStoragePermission=async e=>{if("android"!==Platform.OS||"downloads"!==e)return;if(androidApiLevel()>=29)return;const r=await Permissions.ensure("storage");if("granted"!==r&&"limited"!==r)throw new DownloadError("permission-denied",`Storage permission is "${r}", so nothing can be written to the Downloads folder on this Android version. Ask the user to grant it (Permissions.openSettings()), or download to the "documents" destination instead.`)},emptyFile=e=>new DownloadError("empty-file",`The download of ${e} produced an empty file, so nothing was saved. Check that the URL is correct and that the request carried the credentials the server expects.`),requestFailed=(e,r,o)=>{if(r.signal?.aborted)return new DownloadError("aborted",`The download of ${o} was aborted.`);const t=e??{};if("RequestOfflineError"===t.name)return new DownloadError("network",`The device is offline, so ${r.url} was not downloaded.`);const a=t.response?.status;return"number"==typeof a?new DownloadError("http-error",`The server answered ${a} for ${r.url}, so no file was saved.`,a):new DownloadError("network",`The download of ${r.url} failed: ${describe(e)}`)},discardPartial=async(e,r)=>{try{await e.exists(r)&&await e.unlink(r)}catch(e){Logger.warn(`${PREFIX} Failed to remove the partial download at ${r}`,e)}};export const downloadFile=async e=>{const r=requireBackend(),o=e.destination??"documents",t=e.fileName?sanitiseFileName(e.fileName):fileNameFromUrl(e.url);await ensureStoragePermission(o);const a=r.dirs[o],n=`${a}/${t}`;if(e.signal?.aborted)throw new DownloadError("aborted",`The download of ${t} was aborted before it started.`);let i=!1;try{await r.mkdir(a);const o=await r.exists(n);o&&!1===e.overwrite?i=!0:o&&await r.unlink(n)}catch(e){throw new DownloadError("write-failed",`Could not prepare ${n} for writing: ${describe(e)}`)}if(i){const o=await r.stat(n);return{path:n,bytes:asNumber(o?.size),mimeType:e.mimeType,fromCache:!0}}const{onProgress:s}=e;let d;try{({data:d}=await e.client.get(e.url,{headers:{Accept:"*/*",...e.headers},responseType:"arraybuffer",timeout:3e5,signal:e.signal,onDownloadProgress:s?({loaded:e,total:r=0})=>s(e,r,r>0?e/r:0):void 0}))}catch(r){throw requestFailed(r,e,t)}if(e.signal?.aborted)throw new DownloadError("aborted",`The download of ${t} was aborted.`);const l=new Uint8Array(d??new ArrayBuffer(0));if(0===l.byteLength)throw emptyFile(e.url);try{await r.write(n,l)}catch(e){throw await discardPartial(r,n),new DownloadError("write-failed",`Could not write ${n}: ${describe(e)}`)}let w=0;try{w=await r.exists(n)?asNumber((await r.stat(n)).size):0}catch(e){throw await discardPartial(r,n),new DownloadError("write-failed",`The download of ${t} finished but ${n} could not be read back: ${describe(e)}`)}if(w<=0)throw await discardPartial(r,n),emptyFile(e.url);return{path:n,bytes:w,mimeType:e.mimeType,fromCache:!1}};