@multiplatform.one/platform 7.10.0 → 7.15.0

package/README.md

@@ -52,6 +52,73 @@ export function saveFile(contents: string) {
 Flags are evaluated once at module load and are safe to use in render logic
 and module scope.
 
+## Save bytes to a file
+
+Import the opt-in subpath from a user action:
+
+```ts
+import { FileSaveError, saveFile } from "@multiplatform.one/platform/file";
+
+try {
+  const result = await saveFile({
+    bytes: new TextEncoder().encode("café\n"),
+    filename: "example.txt",
+    mimeType: "text/plain; charset=utf-8",
+  });
+  // Render the returned status, not a blanket success message.
+} catch (error) {
+  if (error instanceof FileSaveError) {
+    console.error(error.code, error.cause, error.cleanupError);
+  }
+}
+```
+
+| Result | What it establishes |
+| --- | --- |
+| `written` | Native byte writing completed at `uri`, with `byteLength` and `requestedFilename`. The actual `filename` is optional. Cloud synchronization is not confirmed. |
+| `download-requested` | A browser download was activated. Browser completion or cancellation is unknown. |
+| `not-saved`, reason `cancelled-or-refused` | The native picker reported cancellation or refused directory access. No file was created. iOS reports these with the same code. |
+
+`WrittenFile.requestedFilename` always records the supplied filename. The optional
+`filename` reports the actual name only for an iOS file URI. Android content URIs
+omit it: Expo 55.0.26 derives `File.name` from the URI, which can contain an opaque
+document ID instead of a provider display name. Consumers must distinguish the
+requested name from an actual name and use `uri` for the saved destination.
+
+Errors reject with `FileSaveError`: `invalid-input`, `unavailable`, `busy`,
+`picker-failed` or `write-failed`. The original failure is in `cause`.
+`cleanupError` records a second failure removing a partially written new file.
+Only `ERR_PICKER_CANCELLED` and `ERR_FILE_PICKING_CANCELLED` are classified as
+`not-saved`; other picker errors remain observable.
+
+Native iOS/Android requires `expo-file-system` (`~55.0.26`, tested against
+55.0.26) in the app and its native binary. Install it explicitly in the native
+host. JavaScript or an OTA update cannot add a missing native module. The module
+loads only when `saveFile` is invoked, and isn't exported through the platform
+root. Other hosts require browser download support or return `unavailable`.
+
+Native opens the system directory picker and creates a new child through the
+selected provider. It doesn't request overwrite. A provider can refuse an
+existing name or choose a suffix. `requestedFilename` doesn't confirm which name
+the provider chose; `filename` is omitted when that metadata isn't established.
+Successful files belong to the user and are **never automatically deleted**.
+On write failure, cleanup attempts to delete only the newly created child.
+No shared cache file or share sheet is involved.
+
+Pass a `Uint8Array`, a nonempty single filename without separators, dot/dot-dot
+or control characters, and a MIME type. Unicode filenames and empty files are
+valid. Bytes are copied before awaiting the directory picker, including the
+exact range of a sliced view. Native creation uses the MIME type without
+parameters; the browser Blob retains the supplied type.
+
+The existing root `downloadFile` and `downloadBlob` remain synchronous `void`
+helpers. Blob URLs are released after 60 seconds; this delay manages resources
+and does not indicate that a download completed.
+
+`Platform/FileSave` is a generic Storybook specimen for parent browser/native
+checks. Unit tests model native boundaries. Packed ESM/CJS and Metro checks
+are package preflight, not real-device save evidence or registry publication.
+
 ## License
 
 Apache-2.0

package/dist/cjs/config/devOrigin.cjs

@@ -0,0 +1,42 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var devOrigin_exports = {};
+__export(devOrigin_exports, {
+  devHostFromHostUri: () => devHostFromHostUri,
+  resolveDevOrigin: () => resolveDevOrigin
+});
+module.exports = __toCommonJS(devOrigin_exports);
+var import_devOriginSource = require("./devOriginSource.cjs");
+const loopbackOrigin = /^([a-z][a-z0-9+.-]*:\/\/)(localhost|127\.0\.0\.1)(?=[:/?#]|$)/i;
+function devHostFromHostUri(hostUri) {
+  if (!hostUri) return void 0;
+  const authority = hostUri.replace(/^[a-z][a-z0-9+.-]*:\/\//i, "").split(/[/?#]/, 1)[0];
+  const host = authority.startsWith("[") ? authority.slice(0, authority.indexOf("]") + 1) : authority.split(":", 1)[0];
+  return host || void 0;
+}
+function resolveDevOrigin(url, source = (0, import_devOriginSource.devOriginSource)()) {
+  if (source.isWeb) return url;
+  const host = devHostFromHostUri(source.hostUri);
+  if (!host) return url;
+  return url.replace(loopbackOrigin, `$1${host}`);
+}

package/dist/cjs/config/devOriginSource.cjs

@@ -0,0 +1,32 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var devOriginSource_exports = {};
+__export(devOriginSource_exports, {
+  devOriginSource: () => devOriginSource
+});
+module.exports = __toCommonJS(devOriginSource_exports);
+function devOriginSource() {
+  return {
+    isWeb: true
+  };
+}

package/dist/cjs/config/index.cjs

@@ -28,5 +28,6 @@ __export(config_exports, {
 module.exports = __toCommonJS(config_exports);
 var import_config = require("./config.cjs");
 __reExport(config_exports, require("./config.cjs"), module.exports);
+__reExport(config_exports, require("./devOrigin.cjs"), module.exports);
 __reExport(config_exports, require("./runtimeConfig.cjs"), module.exports);
 const config = new import_config.Config();

package/dist/cjs/file/index.cjs

@@ -0,0 +1,30 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var file_exports = {};
+__export(file_exports, {
+  FileSaveError: () => import_types.FileSaveError,
+  saveFile: () => import_saveFile.saveFile
+});
+module.exports = __toCommonJS(file_exports);
+var import_saveFile = require("./saveFile.cjs");
+var import_types = require("./types.cjs");

package/dist/cjs/file/saveFile.cjs

@@ -0,0 +1,47 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var saveFile_exports = {};
+__export(saveFile_exports, {
+  saveFile: () => saveFile
+});
+module.exports = __toCommonJS(saveFile_exports);
+var import_downloadFile = require("../utils/downloadFile.cjs");
+var import_types = require("./types.cjs");
+async function saveFile(options) {
+  const input = (0, import_types.prepareFileSave)(options);
+  if (typeof document === "undefined" || !document.body || typeof Blob === "undefined" || typeof URL === "undefined" || typeof URL.createObjectURL !== "function" || typeof URL.revokeObjectURL !== "function" || !("download" in document.createElement("a"))) {
+    throw new import_types.FileSaveError("unavailable", "Browser file downloads are unavailable.");
+  }
+  try {
+    (0, import_downloadFile.downloadBlob)(new Blob([input.bytes], {
+      type: input.mimeType
+    }), input.filename);
+  } catch (cause) {
+    throw new import_types.FileSaveError("write-failed", "The browser download could not be requested.", {
+      cause
+    });
+  }
+  return {
+    status: "download-requested"
+  };
+}

package/dist/cjs/file/types.cjs

@@ -0,0 +1,56 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var types_exports = {};
+__export(types_exports, {
+  FileSaveError: () => FileSaveError,
+  prepareFileSave: () => prepareFileSave
+});
+module.exports = __toCommonJS(types_exports);
+class FileSaveError extends Error {
+  code;
+  cleanupError;
+  constructor(code, message, options) {
+    super(message, options);
+    this.name = "FileSaveError";
+    this.code = code;
+    this.cleanupError = options?.cleanupError;
+  }
+}
+function hasControlCharacters(value) {
+  return Array.from(value).some(character => character.charCodeAt(0) < 32 || character.charCodeAt(0) === 127);
+}
+function prepareFileSave(options) {
+  if (!options || !(options.bytes instanceof Uint8Array) || typeof options.filename !== "string" || !options.filename.trim() || options.filename === "." || options.filename === ".." || /[/\\]/.test(options.filename) || hasControlCharacters(options.filename) || typeof options.mimeType !== "string" || hasControlCharacters(options.mimeType)) {
+    throw new FileSaveError("invalid-input", "Provide bytes, a single filename and a MIME type.");
+  }
+  const nativeMimeType = options.mimeType.split(";", 1)[0].trim();
+  if (!/^[\w!#$%&'*+.^`|~-]+\/[\w!#$%&'*+.^`|~-]+$/.test(nativeMimeType)) {
+    throw new FileSaveError("invalid-input", "Provide a MIME type with a type and subtype.");
+  }
+  return {
+    bytes: Uint8Array.from(options.bytes),
+    filename: options.filename,
+    mimeType: options.mimeType,
+    nativeMimeType
+  };
+}

package/dist/cjs/utils/downloadFile.cjs

@@ -31,11 +31,17 @@ function downloadFile(url, filename) {
   a.href = url;
   a.download = filename;
   document.body.appendChild(a);
-  a.click();
-  document.body.removeChild(a);
+  try {
+    a.click();
+  } finally {
+    a.remove();
+  }
 }
 function downloadBlob(blob, filename) {
   const url = URL.createObjectURL(blob);
-  downloadFile(url, filename);
-  URL.revokeObjectURL(url);
+  try {
+    downloadFile(url, filename);
+  } finally {
+    setTimeout(() => URL.revokeObjectURL(url), 6e4);
+  }
 }

package/dist/esm/config/devOrigin.mjs

@@ -0,0 +1,16 @@
+import { devOriginSource } from "./devOriginSource.mjs";
+const loopbackOrigin = /^([a-z][a-z0-9+.-]*:\/\/)(localhost|127\.0\.0\.1)(?=[:/?#]|$)/i;
+function devHostFromHostUri(hostUri) {
+  if (!hostUri) return void 0;
+  const authority = hostUri.replace(/^[a-z][a-z0-9+.-]*:\/\//i, "").split(/[/?#]/, 1)[0];
+  const host = authority.startsWith("[") ? authority.slice(0, authority.indexOf("]") + 1) : authority.split(":", 1)[0];
+  return host || void 0;
+}
+function resolveDevOrigin(url, source = devOriginSource()) {
+  if (source.isWeb) return url;
+  const host = devHostFromHostUri(source.hostUri);
+  if (!host) return url;
+  return url.replace(loopbackOrigin, `$1${host}`);
+}
+export { devHostFromHostUri, resolveDevOrigin };
+//# sourceMappingURL=devOrigin.mjs.map

package/dist/esm/config/devOrigin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["devOriginSource","loopbackOrigin","devHostFromHostUri","hostUri","authority","replace","split","host","startsWith","slice","indexOf","resolveDevOrigin","url","source","isWeb"],"sources":["../../../src/config/devOrigin.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,eAAA,QAAuB;AAgBhC,MAAMC,cAAA,GAAiB;AAGhB,SAASC,mBAAmBC,OAAA,EAAiD;EAClF,IAAI,CAACA,OAAA,EAAS,OAAO;EACrB,MAAMC,SAAA,GAAYD,OAAA,CAAQE,OAAA,CAAQ,4BAA4B,EAAE,EAAEC,KAAA,CAAM,SAAS,CAAC,EAAE,CAAC;EACrF,MAAMC,IAAA,GAAOH,SAAA,CAAUI,UAAA,CAAW,GAAG,IACjCJ,SAAA,CAAUK,KAAA,CAAM,GAAGL,SAAA,CAAUM,OAAA,CAAQ,GAAG,IAAI,CAAC,IAC7CN,SAAA,CAAUE,KAAA,CAAM,KAAK,CAAC,EAAE,CAAC;EAC7B,OAAOC,IAAA,IAAQ;AACjB;AAaO,SAASI,iBAAiBC,GAAA,EAAaC,MAAA,GAA0Bb,eAAA,CAAgB,GAAW;EACjG,IAAIa,MAAA,CAAOC,KAAA,EAAO,OAAOF,GAAA;EACzB,MAAML,IAAA,GAAOL,kBAAA,CAAmBW,MAAA,CAAOV,OAAO;EAC9C,IAAI,CAACI,IAAA,EAAM,OAAOK,GAAA;EAClB,OAAOA,GAAA,CAAIP,OAAA,CAAQJ,cAAA,EAAgB,KAAKM,IAAI,EAAE;AAChD","ignoreList":[]}

package/dist/esm/config/devOriginSource.mjs

@@ -0,0 +1,7 @@
+function devOriginSource() {
+  return {
+    isWeb: true
+  };
+}
+export { devOriginSource };
+//# sourceMappingURL=devOriginSource.mjs.map

package/dist/esm/config/devOriginSource.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["devOriginSource","isWeb"],"sources":["../../../src/config/devOriginSource.ts"],"sourcesContent":[null],"mappings":"AAEO,SAASA,gBAAA,EAAmC;EACjD,OAAO;IAAEC,KAAA,EAAO;EAAK;AACvB","ignoreList":[]}

package/dist/esm/config/index.mjs

@@ -1,5 +1,6 @@
 import { Config } from "./config.mjs";
 export * from "./config.mjs";
+export * from "./devOrigin.mjs";
 export * from "./runtimeConfig.mjs";
 const config = new Config();
 export { config };

package/dist/esm/config/index.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["Config","config"],"sources":["../../../src/config/index.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,MAAA,QAAc;AAKvB,cAAc;AACd,cAAc;AAJd,MAAMC,MAAA,GAAS,IAAID,MAAA,CAAO","ignoreList":[]}
+{"version":3,"names":["Config","config"],"sources":["../../../src/config/index.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,MAAA,QAAc;AAKvB,cAAc;AACd,cAAc;AACd,cAAc;AALd,MAAMC,MAAA,GAAS,IAAID,MAAA,CAAO","ignoreList":[]}

package/dist/esm/file/index.mjs

@@ -0,0 +1,4 @@
+import { saveFile } from "./saveFile.mjs";
+import { FileSaveError } from "./types.mjs";
+export { FileSaveError, saveFile };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/file/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["saveFile","FileSaveError"],"sources":["../../../src/file/index.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAA,QAAgB;AACzB,SAASC,aAAA,QAAqB","ignoreList":[]}

package/dist/esm/file/saveFile.mjs

@@ -0,0 +1,22 @@
+import { downloadBlob } from "../utils/downloadFile.mjs";
+import { FileSaveError, prepareFileSave } from "./types.mjs";
+async function saveFile(options) {
+  const input = prepareFileSave(options);
+  if (typeof document === "undefined" || !document.body || typeof Blob === "undefined" || typeof URL === "undefined" || typeof URL.createObjectURL !== "function" || typeof URL.revokeObjectURL !== "function" || !("download" in document.createElement("a"))) {
+    throw new FileSaveError("unavailable", "Browser file downloads are unavailable.");
+  }
+  try {
+    downloadBlob(new Blob([input.bytes], {
+      type: input.mimeType
+    }), input.filename);
+  } catch (cause) {
+    throw new FileSaveError("write-failed", "The browser download could not be requested.", {
+      cause
+    });
+  }
+  return {
+    status: "download-requested"
+  };
+}
+export { saveFile };
+//# sourceMappingURL=saveFile.mjs.map

package/dist/esm/file/saveFile.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["downloadBlob","FileSaveError","prepareFileSave","saveFile","options","input","document","body","Blob","URL","createObjectURL","revokeObjectURL","createElement","bytes","type","mimeType","filename","cause","status"],"sources":["../../../src/file/saveFile.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,YAAA,QAAoB;AAC7B,SAASC,aAAA,EAA0DC,eAAA,QAAuB;AAE1F,eAAsBC,SAASC,OAAA,EAAmD;EAChF,MAAMC,KAAA,GAAQH,eAAA,CAAgBE,OAAO;EACrC,IACE,OAAOE,QAAA,KAAa,eACpB,CAACA,QAAA,CAASC,IAAA,IACV,OAAOC,IAAA,KAAS,eAChB,OAAOC,GAAA,KAAQ,eACf,OAAOA,GAAA,CAAIC,eAAA,KAAoB,cAC/B,OAAOD,GAAA,CAAIE,eAAA,KAAoB,cAC/B,EAAE,cAAcL,QAAA,CAASM,aAAA,CAAc,GAAG,IAC1C;IACA,MAAM,IAAIX,aAAA,CAAc,eAAe,yCAAyC;EAClF;EACA,IAAI;IACFD,YAAA,CAAa,IAAIQ,IAAA,CAAK,CAACH,KAAA,CAAMQ,KAAK,GAAG;MAAEC,IAAA,EAAMT,KAAA,CAAMU;IAAS,CAAC,GAAGV,KAAA,CAAMW,QAAQ;EAChF,SAASC,KAAA,EAAO;IACd,MAAM,IAAIhB,aAAA,CAAc,gBAAgB,gDAAgD;MACtFgB;IACF,CAAC;EACH;EACA,OAAO;IAAEC,MAAA,EAAQ;EAAqB;AACxC","ignoreList":[]}

package/dist/esm/file/types.mjs

@@ -0,0 +1,30 @@
+class FileSaveError extends Error {
+  code;
+  cleanupError;
+  constructor(code, message, options) {
+    super(message, options);
+    this.name = "FileSaveError";
+    this.code = code;
+    this.cleanupError = options?.cleanupError;
+  }
+}
+function hasControlCharacters(value) {
+  return Array.from(value).some(character => character.charCodeAt(0) < 32 || character.charCodeAt(0) === 127);
+}
+function prepareFileSave(options) {
+  if (!options || !(options.bytes instanceof Uint8Array) || typeof options.filename !== "string" || !options.filename.trim() || options.filename === "." || options.filename === ".." || /[/\\]/.test(options.filename) || hasControlCharacters(options.filename) || typeof options.mimeType !== "string" || hasControlCharacters(options.mimeType)) {
+    throw new FileSaveError("invalid-input", "Provide bytes, a single filename and a MIME type.");
+  }
+  const nativeMimeType = options.mimeType.split(";", 1)[0].trim();
+  if (!/^[\w!#$%&'*+.^`|~-]+\/[\w!#$%&'*+.^`|~-]+$/.test(nativeMimeType)) {
+    throw new FileSaveError("invalid-input", "Provide a MIME type with a type and subtype.");
+  }
+  return {
+    bytes: Uint8Array.from(options.bytes),
+    filename: options.filename,
+    mimeType: options.mimeType,
+    nativeMimeType
+  };
+}
+export { FileSaveError, prepareFileSave };
+//# sourceMappingURL=types.mjs.map

package/dist/esm/file/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["FileSaveError","Error","code","cleanupError","constructor","message","options","name","hasControlCharacters","value","Array","from","some","character","charCodeAt","prepareFileSave","bytes","Uint8Array","filename","trim","test","mimeType","nativeMimeType","split"],"sources":["../../../src/file/types.ts"],"sourcesContent":[null],"mappings":"AA0BO,MAAMA,aAAA,SAAsBC,KAAA,CAAM;EAC9BC,IAAA;EACAC,YAAA;EAETC,YACEF,IAAA,EACAG,OAAA,EACAC,OAAA,EACA;IACA,MAAMD,OAAA,EAASC,OAAO;IACtB,KAAKC,IAAA,GAAO;IACZ,KAAKL,IAAA,GAAOA,IAAA;IACZ,KAAKC,YAAA,GAAeG,OAAA,EAASH,YAAA;EAC/B;AACF;AAEA,SAASK,qBAAqBC,KAAA,EAAe;EAC3C,OAAOC,KAAA,CAAMC,IAAA,CAAKF,KAAK,EAAEG,IAAA,CACtBC,SAAA,IAAcA,SAAA,CAAUC,UAAA,CAAW,CAAC,IAAI,MAAMD,SAAA,CAAUC,UAAA,CAAW,CAAC,MAAM,GAC7E;AACF;AAEO,SAASC,gBAAgBT,OAAA,EAA0B;EACxD,IACE,CAACA,OAAA,IACD,EAAEA,OAAA,CAAQU,KAAA,YAAiBC,UAAA,KAC3B,OAAOX,OAAA,CAAQY,QAAA,KAAa,YAC5B,CAACZ,OAAA,CAAQY,QAAA,CAASC,IAAA,CAAK,KACvBb,OAAA,CAAQY,QAAA,KAAa,OACrBZ,OAAA,CAAQY,QAAA,KAAa,QACrB,QAAQE,IAAA,CAAKd,OAAA,CAAQY,QAAQ,KAC7BV,oBAAA,CAAqBF,OAAA,CAAQY,QAAQ,KACrC,OAAOZ,OAAA,CAAQe,QAAA,KAAa,YAC5Bb,oBAAA,CAAqBF,OAAA,CAAQe,QAAQ,GACrC;IACA,MAAM,IAAIrB,aAAA,CAAc,iBAAiB,mDAAmD;EAC9F;EACA,MAAMsB,cAAA,GAAiBhB,OAAA,CAAQe,QAAA,CAASE,KAAA,CAAM,KAAK,CAAC,EAAE,CAAC,EAAEJ,IAAA,CAAK;EAC9D,IAAI,CAAC,6CAA6CC,IAAA,CAAKE,cAAc,GAAG;IACtE,MAAM,IAAItB,aAAA,CAAc,iBAAiB,8CAA8C;EACzF;EACA,OAAO;IACLgB,KAAA,EAAOC,UAAA,CAAWN,IAAA,CAAKL,OAAA,CAAQU,KAAK;IACpCE,QAAA,EAAUZ,OAAA,CAAQY,QAAA;IAClBG,QAAA,EAAUf,OAAA,CAAQe,QAAA;IAClBC;EACF;AACF","ignoreList":[]}

package/dist/esm/utils/downloadFile.mjs

@@ -3,13 +3,19 @@ function downloadFile(url, filename) {
   a.href = url;
   a.download = filename;
   document.body.appendChild(a);
-  a.click();
-  document.body.removeChild(a);
+  try {
+    a.click();
+  } finally {
+    a.remove();
+  }
 }
 function downloadBlob(blob, filename) {
   const url = URL.createObjectURL(blob);
-  downloadFile(url, filename);
-  URL.revokeObjectURL(url);
+  try {
+    downloadFile(url, filename);
+  } finally {
+    setTimeout(() => URL.revokeObjectURL(url), 6e4);
+  }
 }
 export { downloadBlob, downloadFile };
 //# sourceMappingURL=downloadFile.mjs.map

package/dist/esm/utils/downloadFile.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["downloadFile","url","filename","a","document","createElement","href","download","body","appendChild","click","removeChild","downloadBlob","blob","URL","createObjectURL","revokeObjectURL"],"sources":["../../../src/utils/downloadFile.ts"],"sourcesContent":[null],"mappings":"AAAO,SAASA,aAAaC,GAAA,EAAaC,QAAA,EAAwB;EAChE,MAAMC,CAAA,GAAIC,QAAA,CAASC,aAAA,CAAc,GAAG;EACpCF,CAAA,CAAEG,IAAA,GAAOL,GAAA;EACTE,CAAA,CAAEI,QAAA,GAAWL,QAAA;EACbE,QAAA,CAASI,IAAA,CAAKC,WAAA,CAAYN,CAAC;EAC3BA,CAAA,CAAEO,KAAA,CAAM;EACRN,QAAA,CAASI,IAAA,CAAKG,WAAA,CAAYR,CAAC;AAC7B;AAEO,SAASS,aAAaC,IAAA,EAAYX,QAAA,EAAwB;EAC/D,MAAMD,GAAA,GAAMa,GAAA,CAAIC,eAAA,CAAgBF,IAAI;EACpCb,YAAA,CAAaC,GAAA,EAAKC,QAAQ;EAC1BY,GAAA,CAAIE,eAAA,CAAgBf,GAAG;AACzB","ignoreList":[]}
+{"version":3,"names":["downloadFile","url","filename","a","document","createElement","href","download","body","appendChild","click","remove","downloadBlob","blob","URL","createObjectURL","setTimeout","revokeObjectURL"],"sources":["../../../src/utils/downloadFile.ts"],"sourcesContent":[null],"mappings":"AAAO,SAASA,aAAaC,GAAA,EAAaC,QAAA,EAAwB;EAChE,MAAMC,CAAA,GAAIC,QAAA,CAASC,aAAA,CAAc,GAAG;EACpCF,CAAA,CAAEG,IAAA,GAAOL,GAAA;EACTE,CAAA,CAAEI,QAAA,GAAWL,QAAA;EACbE,QAAA,CAASI,IAAA,CAAKC,WAAA,CAAYN,CAAC;EAC3B,IAAI;IACFA,CAAA,CAAEO,KAAA,CAAM;EACV,UAAE;IACAP,CAAA,CAAEQ,MAAA,CAAO;EACX;AACF;AAEO,SAASC,aAAaC,IAAA,EAAYX,QAAA,EAAwB;EAC/D,MAAMD,GAAA,GAAMa,GAAA,CAAIC,eAAA,CAAgBF,IAAI;EACpC,IAAI;IACFb,YAAA,CAAaC,GAAA,EAAKC,QAAQ;EAC5B,UAAE;IAEAc,UAAA,CAAW,MAAMF,GAAA,CAAIG,eAAA,CAAgBhB,GAAG,GAAG,GAAM;EACnD;AACF","ignoreList":[]}

package/file.ts

@@ -0,0 +1 @@
+export * from "./src/file/index";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/platform",
-  "version": "7.10.0",
+  "version": "7.15.0",
   "description": "Platform detection flags and utilities for multiplatform.one",
   "keywords": [
     "detection",
@@ -12,11 +12,12 @@
   "author": "BitSpur",
   "repository": {
     "type": "git",
-    "url": "git+https://gitlab.com/bitspur/frappe/multiplatform.one.git",
+    "url": "git+https://git.corp.bitspur.com/multiplatform.one/mpo.git",
     "directory": "public/platform"
   },
   "source": "src/index.ts",
   "files": [
+    "file.ts",
     "dist",
     "src",
     "types",
@@ -31,6 +32,14 @@
     "./rnw-overrides": {
       "types": "./src/rnw_overrides.d.ts"
     },
+    "./file": {
+      "source": "./src/file/index.ts",
+      "react-native": "./src/file/index.ts",
+      "types": "./types/file/index.d.ts",
+      "import": "./dist/esm/file/index.mjs",
+      "require": "./dist/cjs/file/index.cjs",
+      "default": "./dist/cjs/file/index.cjs"
+    },
     ".": {
       "source": "./src/index.ts",
       "react-native": "./src/index.ts",
@@ -47,24 +56,29 @@
     "@tamagui/constants": "2.7.6"
   },
   "devDependencies": {
+    "@multiplatform.one/config": "7.15.0",
     "@tamagui/build": "2.7.6",
     "@types/chrome": "^0.1.40",
     "@types/firefox-webext-browser": "^143.0.0",
     "@vitest/coverage-v8": "^4.1.5",
+    "expo-file-system": "55.0.26",
     "happy-dom": "^20.9.0",
     "react": "19.2.5",
     "typescript": "~5.9.3",
-    "vitest": "^4.1.5",
-    "@multiplatform.one/config": "7.10.0"
+    "vitest": "^4.1.5"
   },
   "peerDependencies": {
     "expo-constants": "~55.0.15",
+    "expo-file-system": "~55.0.26",
     "react": "^19.1.0"
   },
   "peerDependenciesMeta": {
     "expo-constants": {
       "optional": true
     },
+    "expo-file-system": {
+      "optional": true
+    },
     "react": {
       "optional": true
     }

package/src/config/config.native.ts

@@ -1,4 +1,5 @@
 import constants from "expo-constants";
+import { resolveDevOrigin } from "./devOrigin";
 import type { IConfig } from "./types";
 
 export class Config implements IConfig {
@@ -14,7 +15,7 @@ export class Config implements IConfig {
   private _resolveConfig() {
     return Object.keys(this._config).reduce<Record<string, string>>((config, key) => {
       const value = this._lookupEnv(key) || this._config[key];
-      if (typeof value !== "undefined") config[key] = value;
+      if (typeof value !== "undefined") config[key] = resolveDevOrigin(value);
       return config;
     }, {});
   }

package/src/config/devOrigin.spec.ts

@@ -0,0 +1,79 @@
+import { describe, expect, it } from "vitest";
+import { devHostFromHostUri, resolveDevOrigin } from "./devOrigin";
+
+const phone = { isWeb: false, hostUri: "10.0.0.5:3456" };
+
+describe("resolveDevOrigin", () => {
+  it("returns the url unchanged on web, even with a hostUri", () => {
+    expect(
+      resolveDevOrigin("http://localhost:8000", { isWeb: true, hostUri: "10.0.0.5:3456" }),
+    ).toBe("http://localhost:8000");
+  });
+
+  it("rewrites a localhost origin to the hostUri host on native", () => {
+    expect(resolveDevOrigin("http://localhost:8000", phone)).toBe("http://10.0.0.5:8000");
+  });
+
+  it("rewrites the 127.0.0.1 spelling too", () => {
+    expect(resolveDevOrigin("http://127.0.0.1:8000", phone)).toBe("http://10.0.0.5:8000");
+  });
+
+  it("keeps the configured port, path, query and scheme", () => {
+    expect(resolveDevOrigin("http://localhost:8080/auth/realms/myrealm?x=1#f", phone)).toBe(
+      "http://10.0.0.5:8080/auth/realms/myrealm?x=1#f",
+    );
+    expect(resolveDevOrigin("ws://localhost:9000/socket.io", phone)).toBe(
+      "ws://10.0.0.5:9000/socket.io",
+    );
+    expect(resolveDevOrigin("http://localhost", phone)).toBe("http://10.0.0.5");
+  });
+
+  it("leaves non-loopback hosts untouched", () => {
+    expect(resolveDevOrigin("http://192.168.1.20:8000", phone)).toBe("http://192.168.1.20:8000");
+    expect(resolveDevOrigin("https://bench.example.com", phone)).toBe("https://bench.example.com");
+    expect(resolveDevOrigin("http://localhost.example.com:8000", phone)).toBe(
+      "http://localhost.example.com:8000",
+    );
+  });
+
+  it("leaves the url alone when there is no hostUri (release build)", () => {
+    expect(resolveDevOrigin("http://localhost:8000", { isWeb: false })).toBe(
+      "http://localhost:8000",
+    );
+    expect(resolveDevOrigin("http://localhost:8000", { isWeb: false, hostUri: "" })).toBe(
+      "http://localhost:8000",
+    );
+  });
+
+  it("passes values that are not urls through untouched", () => {
+    expect(resolveDevOrigin("8080", phone)).toBe("8080");
+    expect(resolveDevOrigin("localhost:8000", phone)).toBe("localhost:8000");
+    expect(resolveDevOrigin("", phone)).toBe("");
+  });
+
+  it("defaults to the web source in this environment", () => {
+    expect(resolveDevOrigin("http://localhost:8000")).toBe("http://localhost:8000");
+  });
+});
+
+describe("devHostFromHostUri", () => {
+  it("takes the host out of host:port", () => {
+    expect(devHostFromHostUri("10.0.0.5:3456")).toBe("10.0.0.5");
+    expect(devHostFromHostUri("dev.local")).toBe("dev.local");
+  });
+
+  it("strips a scheme and a path when a manifest carries them", () => {
+    expect(devHostFromHostUri("http://10.0.0.5:3456/index.bundle")).toBe("10.0.0.5");
+    expect(devHostFromHostUri("exp://10.0.0.5:3456")).toBe("10.0.0.5");
+  });
+
+  it("keeps an IPv6 literal bracketed", () => {
+    expect(devHostFromHostUri("[fd00::2]:3456")).toBe("[fd00::2]");
+  });
+
+  it("returns undefined for nothing", () => {
+    expect(devHostFromHostUri(undefined)).toBeUndefined();
+    expect(devHostFromHostUri("")).toBeUndefined();
+    expect(devHostFromHostUri(":3456")).toBeUndefined();
+  });
+});