@webority/mobile-core 0.0.28 → 0.1.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
+export const DEFAULT_LOG_LEVEL=__DEV__?"info":"warn";const n={baseUrl:null,loggingEnabled:!0,logLevel:DEFAULT_LOG_LEVEL,environment:"Development",country:"in",appId:null,appVersion:null,logCurl:!1};let o={...n};export const setConfig=n=>{o={...o,...n}};export const getConfig=()=>o;export function getConfigValue(n,e){const t=o[n];return null!==t?t:e}export const resetConfig=()=>{o={...n}};

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
+import{useEffect as e,useRef as t}from"react";import{Linking as r}from"react-native";import{Logger as n}from"../logger/index.js";const o="[@webority/mobile-core]",decodeSafe=e=>{try{return decodeURIComponent(e.replace(/\+/g," "))}catch{return e}},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 r=t.split("#")[0]??"",n=r.indexOf("://");let o="",s=r;if(n>=0){const e=r.slice(0,n);if(!/^[a-zA-Z][a-zA-Z0-9+.-]*$/.test(e))return null;o=e.toLowerCase(),s=r.slice(n+3)}const i=s.indexOf("?"),c=i>=0?s.slice(0,i):s,l=(e=>{const t={};if(!e)return t;for(const r of e.split("&")){if(!r)continue;const e=r.indexOf("="),n=decodeSafe(e>=0?r.slice(0,e):r);n&&(t[n]=e>=0?decodeSafe(r.slice(e+1)):"")}return t})(i>=0?s.slice(i+1):"");let u="",a=c;if("http"===o||"https"===o){const e=c.indexOf("/");u=e>=0?c.slice(0,e):c,a=e>=0?c.slice(e+1):""}const f=trimSlashes(a),p=f?f.split("/").filter(Boolean):[];return o&&"http"!==o&&"https"!==o&&(u=p[0]??""),{url:t,scheme:o,host:u,path:f,segments:p,query:l}};const matchPattern=(e,t)=>{const r=trimSlashes(e).split("/").filter(Boolean);if(r.length!==t.length)return null;const n={};for(let e=0;e<r.length;e+=1){const o=r[e],s=t[e];if(o.startsWith(":")){const e=o.slice(1);if(!e)return null;n[e]=s}else if(o.toLowerCase()!==s.toLowerCase())return null}return n},matchRegExp=(e,t)=>{(e.global||e.sticky)&&(e.lastIndex=0);const r=e.exec(t);if(!r)return null;const n={};for(let e=1;e<r.length;e+=1){const t=r[e];void 0!==t&&(n[String(e)]=t)}for(const[e,t]of Object.entries(r.groups??{}))void 0!==t&&(n[e]=t);return n};let s=null,i=null,c=!1,l=null,u=null;const dispatch=e=>{const t=s;if(!t)return;const r=((e,t)=>{for(const r of e){const e="string"==typeof r.match?matchPattern(r.match,t.segments):matchRegExp(r.match,t.path);if(e)return{route:r,params:e}}return null})(t.routes,e);if(r)return r.route.requiresAuth&&!(s?.isAuthenticated?.()??1)?(l=e,void t.onUnauthenticated?.(e)):void r.route.handler(e,r.params);t.onUnmatched?.(e)},flushPending=()=>{const e=l;e&&(l=null,dispatch(e))},handleUrl=e=>{if(!s)return void n.error(`${o} 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 s.onUnmatched?.({url:"string"==typeof e?e:"",scheme:"",host:"",path:"",segments:[],query:{}});const r=t;(null!==u?u:s?.isReady?.()??1)?dispatch(r):l=r};export const DeepLink={configure:e=>{if(!e||!Array.isArray(e.routes))throw new Error(`${o} DeepLink.configure() needs a config object with a "routes" array. Pass { routes: [{ match: "order/:id", handler }] }.`);s=e},start:async()=>{if(!s)throw new Error(`${o} DeepLink.start() was called before configure(). Call DeepLink.configure({ routes }) first, or use the useDeepLink() hook.`);if(!c){c=!0,i=r.addEventListener("url",e=>{handleUrl(e.url)});try{const e=await r.getInitialURL();e&&handleUrl(e)}catch(e){n.error(`${o} DeepLink could not read the cold-start URL`,e)}}},stop:()=>{i?.remove?.(),i=null,c=!1,l=null,u=null},handleUrl:handleUrl,setReady:e=>{u=e,e&&flushPending()},replayPending:flushPending,getPending:()=>l};export const useDeepLink=r=>{const n=t(r);n.current=r,e(()=>(DeepLink.configure({get routes(){return n.current.routes},isReady:()=>n.current.isReady?.()??!0,isAuthenticated:()=>n.current.isAuthenticated?.()??!0,onUnauthenticated:e=>n.current.onUnauthenticated?.(e),onUnmatched:e=>n.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
+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:o}=t,s=asDirectoryPath(o.document.uri);return{dirs:{documents:s,cache:asDirectoryPath(o.cache.uri),downloads:s},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
+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
+import*as e from"expo-file-system";import{Platform as o}from"react-native";import{Logger as t}from"../logger/index.js";import{Permissions as r}from"../permissions/index.js";import{adaptExpoFileSystem as n}from"./adapters/expoFs.js";import{asNumber as a}from"./adapters/shared.js";const i="[@webority/mobile-core]";export class DownloadError extends Error{constructor(e,o,t){super(`${i} ${o}`),this.name="DownloadError",this.code=e,this.status=t,Object.setPrototypeOf(this,DownloadError.prototype)}}const describe=e=>e instanceof Error?e.message:String(e);let s,d=null;export const setFileSystemImplementation=e=>{d=e};const requireBackend=()=>{const o=d||(void 0===s&&(s=n(e)),s);if(!o)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 o},lastSegment=e=>{const o=e.split(/[/\\]/);return(t=o[o.length-1]??"",Array.from(t).filter(e=>(e.codePointAt(0)??0)>31).join("")).trim();var t},ensureStoragePermission=async e=>{if("android"!==o.OS||"downloads"!==e)return;if(("number"==typeof o.Version?o.Version:Number.parseInt(String(o.Version),10))>=29)return;const t=await r.ensure("storage");if("granted"!==t&&"limited"!==t)throw new DownloadError("permission-denied",`Storage permission is "${t}", 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.`),discardPartial=async(e,o)=>{try{await e.exists(o)&&await e.unlink(o)}catch(e){t.warn(`${i} Failed to remove the partial download at ${o}`,e)}};export const downloadFile=async e=>{const o=requireBackend(),t=e.destination??"documents",r=e.fileName?(e=>{const o=lastSegment(e);if(""===o||"."===o||".."===o)throw new DownloadError("write-failed",`"${e}" does not contain a usable file name. Pass an explicit fileName.`);return o})(e.fileName):(e=>{const o=(e.split("#")[0]?.split("?")[0]??"").split("/").pop()??"";let t=o;try{t=decodeURIComponent(o)}catch{}const r=lastSegment(t);return""===r||"."===r||".."===r?"download":r})(e.url);await ensureStoragePermission(t);const n=o.dirs[t],i=`${n}/${r}`;if(e.signal?.aborted)throw new DownloadError("aborted",`The download of ${r} was aborted before it started.`);let s=!1;try{await o.mkdir(n);const t=await o.exists(i);t&&!1===e.overwrite?s=!0:t&&await o.unlink(i)}catch(e){throw new DownloadError("write-failed",`Could not prepare ${i} for writing: ${describe(e)}`)}if(s){const t=await o.stat(i);return{path:i,bytes:a(t?.size),mimeType:e.mimeType,fromCache:!0}}const{onProgress:d}=e;let l;try{({data:l}=await e.client.get(e.url,{headers:{Accept:"*/*",...e.headers},responseType:"arraybuffer",timeout:3e5,signal:e.signal,onDownloadProgress:d?({loaded:e,total:o=0})=>d(e,o,o>0?e/o:0):void 0}))}catch(o){throw((e,o,t)=>{if(o.signal?.aborted)return new DownloadError("aborted",`The download of ${t} was aborted.`);const r=e??{};if("RequestOfflineError"===r.name)return new DownloadError("network",`The device is offline, so ${o.url} was not downloaded.`);const n=r.response?.status;return"number"==typeof n?new DownloadError("http-error",`The server answered ${n} for ${o.url}, so no file was saved.`,n):new DownloadError("network",`The download of ${o.url} failed: ${describe(e)}`)})(o,e,r)}if(e.signal?.aborted)throw new DownloadError("aborted",`The download of ${r} was aborted.`);const w=new Uint8Array(l??new ArrayBuffer(0));if(0===w.byteLength)throw emptyFile(e.url);try{await o.write(i,w)}catch(e){throw await discardPartial(o,i),new DownloadError("write-failed",`Could not write ${i}: ${describe(e)}`)}let c=0;try{c=await o.exists(i)?a((await o.stat(i)).size):0}catch(e){throw await discardPartial(o,i),new DownloadError("write-failed",`The download of ${r} finished but ${i} could not be read back: ${describe(e)}`)}if(c<=0)throw await discardPartial(o,i),emptyFile(e.url);return{path:i,bytes:c,mimeType:e.mimeType,fromCache:!1}};