react-native-buffered-blob 1.0.0

package/lib/module/errors.js

@@ -0,0 +1,45 @@
+"use strict";
+
+export let ErrorCode = /*#__PURE__*/function (ErrorCode) {
+  ErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+  ErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+  ErrorCode["FILE_ALREADY_EXISTS"] = "FILE_ALREADY_EXISTS";
+  ErrorCode["NOT_A_FILE"] = "NOT_A_FILE";
+  ErrorCode["NOT_A_DIRECTORY"] = "NOT_A_DIRECTORY";
+  ErrorCode["DIRECTORY_NOT_EMPTY"] = "DIRECTORY_NOT_EMPTY";
+  ErrorCode["IO_ERROR"] = "IO_ERROR";
+  ErrorCode["INVALID_ARGUMENT"] = "INVALID_ARGUMENT";
+  ErrorCode["DOWNLOAD_FAILED"] = "DOWNLOAD_FAILED";
+  ErrorCode["DOWNLOAD_CANCELLED"] = "DOWNLOAD_CANCELLED";
+  ErrorCode["READER_CLOSED"] = "READER_CLOSED";
+  ErrorCode["WRITER_CLOSED"] = "WRITER_CLOSED";
+  ErrorCode["UNKNOWN"] = "UNKNOWN";
+  return ErrorCode;
+}({});
+export class BlobError extends Error {
+  constructor(code, message, path) {
+    super(message);
+    this.name = 'BlobError';
+    this.code = code;
+    this.path = path;
+    Object.setPrototypeOf(this, BlobError.prototype);
+  }
+}
+
+/**
+ * Parse native error with format "[ERROR_CODE] message" into BlobError.
+ */
+export function wrapError(e, path) {
+  if (e instanceof BlobError) {
+    return e;
+  }
+  const message = e instanceof Error ? e.message : String(e);
+  const match = /^\[([A-Z_]+)\]\s*(.*)$/.exec(message);
+  if (match) {
+    const [, code, msg] = match;
+    const errorCode = Object.values(ErrorCode).includes(code) ? code : ErrorCode.UNKNOWN;
+    return new BlobError(errorCode, msg || message, path);
+  }
+  return new BlobError(ErrorCode.UNKNOWN, message, path);
+}
+//# sourceMappingURL=errors.js.map

package/lib/module/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ErrorCode","BlobError","Error","constructor","code","message","path","name","Object","setPrototypeOf","prototype","wrapError","e","String","match","exec","msg","errorCode","values","includes","UNKNOWN"],"sourceRoot":"../../src","sources":["errors.ts"],"mappings":";;AAAA,WAAYA,SAAS,0BAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAAA,OAATA,SAAS;AAAA;AAgBrB,OAAO,MAAMC,SAAS,SAASC,KAAK,CAAC;EAInCC,WAAWA,CAACC,IAAe,EAAEC,OAAe,EAAEC,IAAa,EAAE;IAC3D,KAAK,CAACD,OAAO,CAAC;IACd,IAAI,CAACE,IAAI,GAAG,WAAW;IACvB,IAAI,CAACH,IAAI,GAAGA,IAAI;IAChB,IAAI,CAACE,IAAI,GAAGA,IAAI;IAChBE,MAAM,CAACC,cAAc,CAAC,IAAI,EAAER,SAAS,CAACS,SAAS,CAAC;EAClD;AACF;;AAEA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAACC,CAAU,EAAEN,IAAa,EAAa;EAC9D,IAAIM,CAAC,YAAYX,SAAS,EAAE;IAC1B,OAAOW,CAAC;EACV;EAEA,MAAMP,OAAO,GAAGO,CAAC,YAAYV,KAAK,GAAGU,CAAC,CAACP,OAAO,GAAGQ,MAAM,CAACD,CAAC,CAAC;EAC1D,MAAME,KAAK,GAAG,wBAAwB,CAACC,IAAI,CAACV,OAAO,CAAC;EAEpD,IAAIS,KAAK,EAAE;IACT,MAAM,GAAGV,IAAI,EAAEY,GAAG,CAAC,GAAGF,KAAK;IAC3B,MAAMG,SAAS,GAAGT,MAAM,CAACU,MAAM,CAAClB,SAAS,CAAC,CAACmB,QAAQ,CAACf,IAAiB,CAAC,GACjEA,IAAI,GACLJ,SAAS,CAACoB,OAAO;IACrB,OAAO,IAAInB,SAAS,CAACgB,SAAS,EAAED,GAAG,IAAIX,OAAO,EAAEC,IAAI,CAAC;EACvD;EAEA,OAAO,IAAIL,SAAS,CAACD,SAAS,CAACoB,OAAO,EAAEf,OAAO,EAAEC,IAAI,CAAC;AACxD","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,25 @@
+"use strict";
+
+// Errors
+export { ErrorCode, BlobError, wrapError } from "./errors.js";
+
+// Paths
+export { Dirs, join, dirname, basename, extname } from "./paths.js";
+
+// Types
+
+export { HashAlgorithm, FileType } from "./types.js";
+
+// API - Streaming
+export { createReader } from "./api/readFile.js";
+export { createWriter } from "./api/writeFile.js";
+
+// API - File Operations
+export { exists, stat, unlink, mkdir, ls, cp, mv } from "./api/fileOps.js";
+
+// API - Hashing
+export { hashFile } from "./api/hash.js";
+
+// API - Download
+export { download } from "./api/download.js";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ErrorCode","BlobError","wrapError","Dirs","join","dirname","basename","extname","HashAlgorithm","FileType","createReader","createWriter","exists","stat","unlink","mkdir","ls","cp","mv","hashFile","download"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA,SAASA,SAAS,EAAEC,SAAS,EAAEC,SAAS,QAAQ,aAAU;;AAE1D;AACA,SAASC,IAAI,EAAEC,IAAI,EAAEC,OAAO,EAAEC,QAAQ,EAAEC,OAAO,QAAQ,YAAS;;AAEhE;;AAOA,SAASC,aAAa,EAAEC,QAAQ,QAAQ,YAAS;;AAEjD;AACA,SAASC,YAAY,QAAQ,mBAAgB;AAC7C,SAASC,YAAY,QAAQ,oBAAiB;;AAE9C;AACA,SAASC,MAAM,EAAEC,IAAI,EAAEC,MAAM,EAAEC,KAAK,EAAEC,EAAE,EAAEC,EAAE,EAAEC,EAAE,QAAQ,kBAAe;;AAEvE;AACA,SAASC,QAAQ,QAAQ,eAAY;;AAErC;AACA,SAASC,QAAQ,QAAQ,mBAAgB","ignoreList":[]}

package/lib/module/module.js

@@ -0,0 +1,19 @@
+"use strict";
+
+import NativeModule from "./NativeBufferedBlob.js";
+
+// Install JSI HostObject on first import
+const installed = NativeModule.install();
+if (!installed) {
+  throw new Error('[BufferedBlob] Failed to install JSI streaming bridge. Ensure the native module is linked.');
+}
+// Access the JSI HostObject installed by native
+function getStreamingProxy() {
+  const proxy = globalThis.__BufferedBlobStreaming;
+  if (!proxy) {
+    throw new Error('[BufferedBlob] Streaming proxy not available. Make sure install() was called.');
+  }
+  return proxy;
+}
+export { NativeModule, getStreamingProxy };
+//# sourceMappingURL=module.js.map

package/lib/module/module.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModule","installed","install","Error","getStreamingProxy","proxy","globalThis","__BufferedBlobStreaming"],"sourceRoot":"../../src","sources":["module.ts"],"mappings":";;AAAA,OAAOA,YAAY,MAAM,yBAAsB;;AAE/C;AACA,MAAMC,SAAS,GAAGD,YAAY,CAACE,OAAO,CAAC,CAAC;AACxC,IAAI,CAACD,SAAS,EAAE;EACd,MAAM,IAAIE,KAAK,CACb,4FACF,CAAC;AACH;AA4BA;AACA,SAASC,iBAAiBA,CAAA,EAAmB;EAC3C,MAAMC,KAAK,GAAGC,UAAU,CAACC,uBAAuB;EAChD,IAAI,CAACF,KAAK,EAAE;IACV,MAAM,IAAIF,KAAK,CACb,+EACF,CAAC;EACH;EACA,OAAOE,KAAK;AACd;AAEA,SAASL,YAAY,EAAEI,iBAAiB","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/paths.js

@@ -0,0 +1,32 @@
+"use strict";
+
+import { NativeModule } from "./module.js";
+const constants = NativeModule.getConstants();
+export const Dirs = Object.freeze({
+  document: constants.documentDir,
+  cache: constants.cacheDir,
+  temp: constants.tempDir,
+  download: constants.downloadDir
+});
+export function join(...parts) {
+  const result = parts.filter(Boolean).join('/').replace(/\/+/g, '/');
+  return result.length > 1 ? result.replace(/\/$/, '') : result;
+}
+export function dirname(path) {
+  const idx = path.lastIndexOf('/');
+  return idx === -1 ? '.' : path.substring(0, idx);
+}
+export function basename(path, ext) {
+  const idx = path.lastIndexOf('/');
+  const name = idx === -1 ? path : path.substring(idx + 1);
+  if (ext && name.endsWith(ext)) {
+    return name.substring(0, name.length - ext.length);
+  }
+  return name;
+}
+export function extname(path) {
+  const name = basename(path);
+  const idx = name.lastIndexOf('.');
+  return idx <= 0 ? '' : name.substring(idx);
+}
+//# sourceMappingURL=paths.js.map

package/lib/module/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModule","constants","getConstants","Dirs","Object","freeze","document","documentDir","cache","cacheDir","temp","tempDir","download","downloadDir","join","parts","result","filter","Boolean","replace","length","dirname","path","idx","lastIndexOf","substring","basename","ext","name","endsWith","extname"],"sourceRoot":"../../src","sources":["paths.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,aAAU;AAEvC,MAAMC,SAAS,GAAGD,YAAY,CAACE,YAAY,CAAC,CAAC;AAE7C,OAAO,MAAMC,IAAI,GAAGC,MAAM,CAACC,MAAM,CAAC;EAChCC,QAAQ,EAAEL,SAAS,CAACM,WAAW;EAC/BC,KAAK,EAAEP,SAAS,CAACQ,QAAQ;EACzBC,IAAI,EAAET,SAAS,CAACU,OAAO;EACvBC,QAAQ,EAAEX,SAAS,CAACY;AACtB,CAAC,CAAC;AAEF,OAAO,SAASC,IAAIA,CAAC,GAAGC,KAAe,EAAU;EAC/C,MAAMC,MAAM,GAAGD,KAAK,CAACE,MAAM,CAACC,OAAO,CAAC,CAACJ,IAAI,CAAC,GAAG,CAAC,CAACK,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;EACnE,OAAOH,MAAM,CAACI,MAAM,GAAG,CAAC,GAAGJ,MAAM,CAACG,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAGH,MAAM;AAC/D;AAEA,OAAO,SAASK,OAAOA,CAACC,IAAY,EAAU;EAC5C,MAAMC,GAAG,GAAGD,IAAI,CAACE,WAAW,CAAC,GAAG,CAAC;EACjC,OAAOD,GAAG,KAAK,CAAC,CAAC,GAAG,GAAG,GAAGD,IAAI,CAACG,SAAS,CAAC,CAAC,EAAEF,GAAG,CAAC;AAClD;AAEA,OAAO,SAASG,QAAQA,CAACJ,IAAY,EAAEK,GAAY,EAAU;EAC3D,MAAMJ,GAAG,GAAGD,IAAI,CAACE,WAAW,CAAC,GAAG,CAAC;EACjC,MAAMI,IAAI,GAAGL,GAAG,KAAK,CAAC,CAAC,GAAGD,IAAI,GAAGA,IAAI,CAACG,SAAS,CAACF,GAAG,GAAG,CAAC,CAAC;EACxD,IAAII,GAAG,IAAIC,IAAI,CAACC,QAAQ,CAACF,GAAG,CAAC,EAAE;IAC7B,OAAOC,IAAI,CAACH,SAAS,CAAC,CAAC,EAAEG,IAAI,CAACR,MAAM,GAAGO,GAAG,CAACP,MAAM,CAAC;EACpD;EACA,OAAOQ,IAAI;AACb;AAEA,OAAO,SAASE,OAAOA,CAACR,IAAY,EAAU;EAC5C,MAAMM,IAAI,GAAGF,QAAQ,CAACJ,IAAI,CAAC;EAC3B,MAAMC,GAAG,GAAGK,IAAI,CAACJ,WAAW,CAAC,GAAG,CAAC;EACjC,OAAOD,GAAG,IAAI,CAAC,GAAG,EAAE,GAAGK,IAAI,CAACH,SAAS,CAACF,GAAG,CAAC;AAC5C","ignoreList":[]}

package/lib/module/types.js

@@ -0,0 +1,15 @@
+"use strict";
+
+// NOTE: Enums changed from numeric (Nitro) to string (Turbo Module compatibility)
+export let HashAlgorithm = /*#__PURE__*/function (HashAlgorithm) {
+  HashAlgorithm["SHA256"] = "sha256";
+  HashAlgorithm["MD5"] = "md5";
+  return HashAlgorithm;
+}({});
+export let FileType = /*#__PURE__*/function (FileType) {
+  FileType["FILE"] = "file";
+  FileType["DIRECTORY"] = "directory";
+  FileType["UNKNOWN"] = "unknown";
+  return FileType;
+}({});
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["HashAlgorithm","FileType"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AAAA;AACA,WAAYA,aAAa,0BAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAA,OAAbA,aAAa;AAAA;AAKzB,WAAYC,QAAQ,0BAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAAA,OAARA,QAAQ;AAAA","ignoreList":[]}

package/lib/module/wrappers.js

@@ -0,0 +1,107 @@
+"use strict";
+
+import { BlobError, ErrorCode } from "./errors.js";
+
+/**
+ * Wraps a native reader handle with explicit getter delegation.
+ * IMPORTANT: Does NOT use spread operator on HostObject (getters would be lost).
+ * Instead, proxies each property access through getReaderInfo().
+ */
+export function wrapReader(handleId, streaming) {
+  let closed = false;
+  return {
+    get handleId() {
+      return handleId;
+    },
+    get fileSize() {
+      return streaming.getReaderInfo(handleId).fileSize;
+    },
+    get bytesRead() {
+      return streaming.getReaderInfo(handleId).bytesRead;
+    },
+    get isEOF() {
+      return streaming.getReaderInfo(handleId).isEOF;
+    },
+    readNextChunk() {
+      if (closed) {
+        throw new BlobError(ErrorCode.READER_CLOSED, 'Reader is already closed');
+      }
+      return streaming.readNextChunk(handleId);
+    },
+    close() {
+      if (!closed) {
+        closed = true;
+        streaming.close(handleId);
+      }
+    },
+    [Symbol.dispose]() {
+      if (!closed) {
+        closed = true;
+        streaming.close(handleId);
+      }
+    }
+  };
+}
+
+/**
+ * Wraps a native writer handle with explicit getter delegation.
+ * IMPORTANT: Does NOT use spread operator on HostObject (getters would be lost).
+ */
+export function wrapWriter(handleId, streaming) {
+  let closed = false;
+  return {
+    get handleId() {
+      return handleId;
+    },
+    get bytesWritten() {
+      return streaming.getWriterInfo(handleId).bytesWritten;
+    },
+    /**
+     * Write data to the file.
+     *
+     * **Backpressure warning:** Each call queues data to the native write
+     * pipeline. You MUST await each write() call before issuing the next
+     * one. Failing to await writes can cause unbounded memory growth as
+     * ArrayBuffer copies accumulate in the native queue.
+     *
+     * @example
+     * ```ts
+     * // Correct - sequential writes with await
+     * for (const chunk of chunks) {
+     *   await writer.write(chunk);
+     * }
+     *
+     * // WRONG - parallel writes without backpressure
+     * chunks.forEach(chunk => writer.write(chunk)); // Do NOT do this
+     * ```
+     *
+     * @param data - The ArrayBuffer to write
+     * @returns Promise resolving to the number of bytes written
+     */
+    write(data) {
+      if (closed) {
+        throw new BlobError(ErrorCode.WRITER_CLOSED, 'Writer is already closed');
+      }
+      return streaming.write(handleId, data);
+    },
+    flush() {
+      if (closed) {
+        throw new BlobError(ErrorCode.WRITER_CLOSED, 'Writer is already closed');
+      }
+      return streaming.flush(handleId);
+    },
+    close() {
+      if (!closed) {
+        closed = true;
+        streaming.close(handleId);
+      }
+    },
+    [Symbol.dispose]() {
+      if (!closed) {
+        closed = true;
+        streaming.close(handleId);
+      }
+    }
+  };
+}
+//# sourceMappingURL=wrappers.js.map

package/lib/module/wrappers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BlobError","ErrorCode","wrapReader","handleId","streaming","closed","fileSize","getReaderInfo","bytesRead","isEOF","readNextChunk","READER_CLOSED","close","Symbol","dispose","wrapWriter","bytesWritten","getWriterInfo","write","data","WRITER_CLOSED","flush"],"sourceRoot":"../../src","sources":["wrappers.ts"],"mappings":";;AAEA,SAASA,SAAS,EAAEC,SAAS,QAAQ,aAAU;;AAE/C;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CACxBC,QAAgB,EAChBC,SAAyB,EACb;EACZ,IAAIC,MAAM,GAAG,KAAK;EAElB,OAAO;IACL,IAAIF,QAAQA,CAAA,EAAG;MACb,OAAOA,QAAQ;IACjB,CAAC;IACD,IAAIG,QAAQA,CAAA,EAAG;MACb,OAAOF,SAAS,CAACG,aAAa,CAACJ,QAAQ,CAAC,CAACG,QAAQ;IACnD,CAAC;IACD,IAAIE,SAASA,CAAA,EAAG;MACd,OAAOJ,SAAS,CAACG,aAAa,CAACJ,QAAQ,CAAC,CAACK,SAAS;IACpD,CAAC;IACD,IAAIC,KAAKA,CAAA,EAAG;MACV,OAAOL,SAAS,CAACG,aAAa,CAACJ,QAAQ,CAAC,CAACM,KAAK;IAChD,CAAC;IACDC,aAAaA,CAAA,EAAG;MACd,IAAIL,MAAM,EAAE;QACV,MAAM,IAAIL,SAAS,CACjBC,SAAS,CAACU,aAAa,EACvB,0BACF,CAAC;MACH;MACA,OAAOP,SAAS,CAACM,aAAa,CAACP,QAAQ,CAAC;IAC1C,CAAC;IACDS,KAAKA,CAAA,EAAG;MACN,IAAI,CAACP,MAAM,EAAE;QACXA,MAAM,GAAG,IAAI;QACbD,SAAS,CAACQ,KAAK,CAACT,QAAQ,CAAC;MAC3B;IACF,CAAC;IACD,CAACU,MAAM,CAACC,OAAO,IAAI;MACjB,IAAI,CAACT,MAAM,EAAE;QACXA,MAAM,GAAG,IAAI;QACbD,SAAS,CAACQ,KAAK,CAACT,QAAQ,CAAC;MAC3B;IACF;EACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASY,UAAUA,CACxBZ,QAAgB,EAChBC,SAAyB,EACb;EACZ,IAAIC,MAAM,GAAG,KAAK;EAElB,OAAO;IACL,IAAIF,QAAQA,CAAA,EAAG;MACb,OAAOA,QAAQ;IACjB,CAAC;IACD,IAAIa,YAAYA,CAAA,EAAG;MACjB,OAAOZ,SAAS,CAACa,aAAa,CAACd,QAAQ,CAAC,CAACa,YAAY;IACvD,CAAC;IACD;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACIE,KAAKA,CAACC,IAAiB,EAAE;MACvB,IAAId,MAAM,EAAE;QACV,MAAM,IAAIL,SAAS,CACjBC,SAAS,CAACmB,aAAa,EACvB,0BACF,CAAC;MACH;MACA,OAAOhB,SAAS,CAACc,KAAK,CAACf,QAAQ,EAAEgB,IAAI,CAAC;IACxC,CAAC;IACDE,KAAKA,CAAA,EAAG;MACN,IAAIhB,MAAM,EAAE;QACV,MAAM,IAAIL,SAAS,CACjBC,SAAS,CAACmB,aAAa,EACvB,0BACF,CAAC;MACH;MACA,OAAOhB,SAAS,CAACiB,KAAK,CAAClB,QAAQ,CAAC;IAClC,CAAC;IACDS,KAAKA,CAAA,EAAG;MACN,IAAI,CAACP,MAAM,EAAE;QACXA,MAAM,GAAG,IAAI;QACbD,SAAS,CAACQ,KAAK,CAACT,QAAQ,CAAC;MAC3B;IACF,CAAC;IACD,CAACU,MAAM,CAACC,OAAO,IAAI;MACjB,IAAI,CAACT,MAAM,EAAE;QACXA,MAAM,GAAG,IAAI;QACbD,SAAS,CAACQ,KAAK,CAACT,QAAQ,CAAC;MAC3B;IACF;EACF,CAAC;AACH","ignoreList":[]}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/NativeBufferedBlob.d.ts

@@ -0,0 +1,37 @@
+import type { TurboModule } from 'react-native';
+export interface Spec extends TurboModule {
+    install(): boolean;
+    openRead(path: string, bufferSize: number): number;
+    openWrite(path: string, append: boolean): number;
+    createDownload(url: string, destPath: string, headers: Object): number;
+    closeHandle(handleId: number): void;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<{
+        path: string;
+        name: string;
+        size: number;
+        type: string;
+        lastModified: number;
+    }>;
+    unlink(path: string): Promise<void>;
+    mkdir(path: string): Promise<void>;
+    ls(path: string): Promise<Array<{
+        path: string;
+        name: string;
+        size: number;
+        type: string;
+        lastModified: number;
+    }>>;
+    cp(srcPath: string, destPath: string): Promise<void>;
+    mv(srcPath: string, destPath: string): Promise<void>;
+    hashFile(path: string, algorithm: string): Promise<string>;
+    getConstants(): {
+        documentDir: string;
+        cacheDir: string;
+        tempDir: string;
+        downloadDir: string;
+    };
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeBufferedBlob.d.ts.map

package/lib/typescript/src/NativeBufferedBlob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeBufferedBlob.d.ts","sourceRoot":"","sources":["../../../src/NativeBufferedBlob.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,OAAO,IAAI,OAAO,CAAC;IAKnB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACnD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACjD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAIvE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAGpC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CACvB,KAAK,CAAC;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CACH,CAAC;IACF,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGrD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAG3D,YAAY,IAAI;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;;AAED,wBAAsE"}

package/lib/typescript/src/api/download.d.ts

@@ -0,0 +1,13 @@
+import type { DownloadProgress } from '../types';
+export interface DownloadOptions {
+    url: string;
+    destPath: string;
+    headers?: Record<string, string>;
+    onProgress?: (progress: DownloadProgress) => void;
+}
+export interface DownloadHandle {
+    promise: Promise<void>;
+    cancel: () => void;
+}
+export declare function download(options: DownloadOptions): DownloadHandle;
+//# sourceMappingURL=download.d.ts.map

package/lib/typescript/src/api/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../../src/api/download.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA6BjE"}

package/lib/typescript/src/api/fileOps.d.ts

@@ -0,0 +1,9 @@
+import type { FileInfo } from '../types';
+export declare function exists(path: string): Promise<boolean>;
+export declare function stat(path: string): Promise<FileInfo>;
+export declare function unlink(path: string): Promise<void>;
+export declare function mkdir(path: string): Promise<void>;
+export declare function ls(path: string): Promise<FileInfo[]>;
+export declare function cp(srcPath: string, destPath: string): Promise<void>;
+export declare function mv(srcPath: string, destPath: string): Promise<void>;
+//# sourceMappingURL=fileOps.d.ts.map

package/lib/typescript/src/api/fileOps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileOps.d.ts","sourceRoot":"","sources":["../../../../src/api/fileOps.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAwBzC,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM3D;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAO1D;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxD;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvD;AAED,wBAAsB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAO1D;AAED,wBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE;AAED,wBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE"}

package/lib/typescript/src/api/hash.d.ts

@@ -0,0 +1,3 @@
+import { HashAlgorithm } from '../types';
+export declare function hashFile(path: string, algorithm?: HashAlgorithm): Promise<string>;
+//# sourceMappingURL=hash.d.ts.map

package/lib/typescript/src/api/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../src/api/hash.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,aAAoC,GAC9C,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/lib/typescript/src/api/readFile.d.ts

@@ -0,0 +1,3 @@
+import type { BlobReader } from '../types';
+export declare function createReader(path: string, bufferSize?: number): BlobReader;
+//# sourceMappingURL=readFile.d.ts.map

package/lib/typescript/src/api/readFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readFile.d.ts","sourceRoot":"","sources":["../../../../src/api/readFile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAA4B,GACvC,UAAU,CA0BZ"}

package/lib/typescript/src/api/writeFile.d.ts

@@ -0,0 +1,3 @@
+import type { BlobWriter } from '../types';
+export declare function createWriter(path: string, append?: boolean): BlobWriter;
+//# sourceMappingURL=writeFile.d.ts.map

package/lib/typescript/src/api/writeFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFile.d.ts","sourceRoot":"","sources":["../../../../src/api/writeFile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,OAAe,GACtB,UAAU,CAeZ"}

package/lib/typescript/src/errors.d.ts

@@ -0,0 +1,25 @@
+export declare enum ErrorCode {
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    FILE_ALREADY_EXISTS = "FILE_ALREADY_EXISTS",
+    NOT_A_FILE = "NOT_A_FILE",
+    NOT_A_DIRECTORY = "NOT_A_DIRECTORY",
+    DIRECTORY_NOT_EMPTY = "DIRECTORY_NOT_EMPTY",
+    IO_ERROR = "IO_ERROR",
+    INVALID_ARGUMENT = "INVALID_ARGUMENT",
+    DOWNLOAD_FAILED = "DOWNLOAD_FAILED",
+    DOWNLOAD_CANCELLED = "DOWNLOAD_CANCELLED",
+    READER_CLOSED = "READER_CLOSED",
+    WRITER_CLOSED = "WRITER_CLOSED",
+    UNKNOWN = "UNKNOWN"
+}
+export declare class BlobError extends Error {
+    readonly code: ErrorCode;
+    readonly path?: string;
+    constructor(code: ErrorCode, message: string, path?: string);
+}
+/**
+ * Parse native error with format "[ERROR_CODE] message" into BlobError.
+ */
+export declare function wrapError(e: unknown, path?: string): BlobError;
+//# sourceMappingURL=errors.d.ts.map

package/lib/typescript/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IACnB,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,UAAU,eAAe;IACzB,eAAe,oBAAoB;IACnC,mBAAmB,wBAAwB;IAC3C,QAAQ,aAAa;IACrB,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,kBAAkB,uBAAuB;IACzC,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,OAAO,YAAY;CACpB;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAElB,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAO5D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAiB9D"}

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

@@ -0,0 +1,11 @@
+export { ErrorCode, BlobError, wrapError } from './errors';
+export { Dirs, join, dirname, basename, extname } from './paths';
+export type { FileInfo, DownloadProgress, BlobReader, BlobWriter, } from './types';
+export { HashAlgorithm, FileType } from './types';
+export { createReader } from './api/readFile';
+export { createWriter } from './api/writeFile';
+export { exists, stat, unlink, mkdir, ls, cp, mv } from './api/fileOps';
+export { hashFile } from './api/hash';
+export { download } from './api/download';
+export type { DownloadOptions, DownloadHandle } from './api/download';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG3D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGjE,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAGxE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,23 @@
+import NativeModule from './NativeBufferedBlob';
+export interface StreamingProxy {
+    readNextChunk(handleId: number): Promise<ArrayBuffer | null>;
+    write(handleId: number, data: ArrayBuffer): Promise<number>;
+    flush(handleId: number): Promise<void>;
+    close(handleId: number): void;
+    startDownload(handleId: number, onProgress: (bytesDownloaded: number, totalBytes: number, progress: number) => void): Promise<void>;
+    cancelDownload(handleId: number): void;
+    getReaderInfo(handleId: number): {
+        fileSize: number;
+        bytesRead: number;
+        isEOF: boolean;
+    };
+    getWriterInfo(handleId: number): {
+        bytesWritten: number;
+    };
+}
+declare global {
+    var __BufferedBlobStreaming: StreamingProxy | undefined;
+}
+declare function getStreamingProxy(): StreamingProxy;
+export { NativeModule, getStreamingProxy };
+//# sourceMappingURL=module.d.ts.map

package/lib/typescript/src/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,sBAAsB,CAAC;AAUhD,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CACV,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,KACb,IAAI,GACR,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;QAC/B,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,uBAAuB,EAAE,cAAc,GAAG,SAAS,CAAC;CACzD;AAGD,iBAAS,iBAAiB,IAAI,cAAc,CAQ3C;AAED,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/lib/typescript/src/paths.d.ts

@@ -0,0 +1,11 @@
+export declare const Dirs: Readonly<{
+    document: string;
+    cache: string;
+    temp: string;
+    download: string;
+}>;
+export declare function join(...parts: string[]): string;
+export declare function dirname(path: string): string;
+export declare function basename(path: string, ext?: string): string;
+export declare function extname(path: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/lib/typescript/src/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/paths.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,IAAI;;;;;EAKf,CAAC;AAEH,wBAAgB,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAG/C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5C"}

package/lib/typescript/src/types.d.ts

@@ -0,0 +1,37 @@
+export declare enum HashAlgorithm {
+    SHA256 = "sha256",
+    MD5 = "md5"
+}
+export declare enum FileType {
+    FILE = "file",
+    DIRECTORY = "directory",
+    UNKNOWN = "unknown"
+}
+export interface FileInfo {
+    path: string;
+    name: string;
+    size: number;
+    type: FileType;
+    lastModified: number;
+}
+export interface DownloadProgress {
+    bytesDownloaded: number;
+    totalBytes: number;
+    progress: number;
+}
+export interface BlobReader extends Disposable {
+    readonly handleId: number;
+    readonly fileSize: number;
+    readonly bytesRead: number;
+    readonly isEOF: boolean;
+    readNextChunk(): Promise<ArrayBuffer | null>;
+    close(): void;
+}
+export interface BlobWriter extends Disposable {
+    readonly handleId: number;
+    readonly bytesWritten: number;
+    write(data: ArrayBuffer): Promise<number>;
+    flush(): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AACA,oBAAY,aAAa;IACvB,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ;AAED,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,aAAa,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,IAAI,CAAC;CACf"}

package/lib/typescript/src/wrappers.d.ts

@@ -0,0 +1,14 @@
+import type { StreamingProxy } from './module';
+import type { BlobReader, BlobWriter } from './types';
+/**
+ * Wraps a native reader handle with explicit getter delegation.
+ * IMPORTANT: Does NOT use spread operator on HostObject (getters would be lost).
+ * Instead, proxies each property access through getReaderInfo().
+ */
+export declare function wrapReader(handleId: number, streaming: StreamingProxy): BlobReader;
+/**
+ * Wraps a native writer handle with explicit getter delegation.
+ * IMPORTANT: Does NOT use spread operator on HostObject (getters would be lost).
+ */
+export declare function wrapWriter(handleId: number, streaming: StreamingProxy): BlobWriter;
+//# sourceMappingURL=wrappers.d.ts.map

package/lib/typescript/src/wrappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrappers.d.ts","sourceRoot":"","sources":["../../../src/wrappers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGtD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,cAAc,GACxB,UAAU,CAsCZ;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,cAAc,GACxB,UAAU,CA+DZ"}