expo-tiddlywiki-filesystem-android-external-storage 2.7.0 → 2.9.0

package/android/src/main/java/expo/modules/externalstorage/ExternalStorageModule.kt

@@ -568,6 +568,10 @@ class ExternalStorageModule : Module() {
       GitHelper.gitPush(gitRootDir, remoteName, localBranch, remoteBranch, force, headers)
     }
 
+    AsyncFunction("gitCreateBundle") { gitRootDir: String, remoteName: String, localBranch: String, remoteBranch: String ->
+      GitHelper.gitCreateBundle(gitRootDir, remoteName, localBranch, remoteBranch)
+    }
+
     AsyncFunction("gitFetch") { gitRootDir: String, remoteName: String, branch: String, headers: String? ->
       GitHelper.gitFetch(gitRootDir, remoteName, branch, headers)
     }

package/android/src/main/java/expo/modules/externalstorage/GitHelper.kt

@@ -369,6 +369,80 @@ internal object GitHelper {
     return result.toString()
   }
 
+  // ─── Git bundle creation (for push via HTTP POST) ───────────────
+
+  /**
+   * Create a git bundle containing commits on localBranch that are ahead of
+   * remoteName/remoteBranch. Returns a base64-encoded bundle string, or
+   * a JSON error if there's nothing to bundle.
+   *
+   * This avoids JGit's broken SmartHttpPushConnection (which throws
+   * "Starting read stage without written request data pending is not supported"
+   * due to MultiRequestService not marking finalRequest=true for push).
+   *
+   * The bundle is sent by the JS layer via HTTP POST to the desktop's
+   * /receive-bundle endpoint, which runs `git fetch <bundle> master:mobile-incoming`.
+   */
+  fun gitCreateBundle(
+    gitRootDir: String,
+    remoteName: String,
+    localBranch: String,
+    remoteBranch: String
+  ): String {
+    val result = JSONObject()
+    try {
+      val repo = openRepo(gitRootDir)
+      try {
+        ensureProtocolV0(repo)
+        val localRef = repo.resolve("refs/heads/$localBranch")
+          ?: throw Exception("Local branch $localBranch not found")
+        val remoteRef = repo.resolve("refs/remotes/$remoteName/$remoteBranch")
+
+        val revWalk = RevWalk(repo)
+        try {
+          val localCommit = revWalk.parseCommit(localRef)
+
+          val bundleWriter = org.eclipse.jgit.transport.BundleWriter(repo)
+
+          // Include the local branch tip
+          bundleWriter.include("refs/heads/$localBranch", localRef)
+
+          // If we have a remote tracking ref, mark it as assumed (prerequisite).
+          // The receiving end must have this commit.
+          if (remoteRef != null) {
+            val remoteCommit = revWalk.parseCommit(remoteRef)
+            bundleWriter.assume(remoteCommit)
+          }
+
+          // Configure pack for low memory (Android)
+          val packConfig = org.eclipse.jgit.storage.pack.PackConfig(repo)
+          bundleWriter.setPackConfig(packConfig)
+
+          // Write bundle to memory
+          val baos = ByteArrayOutputStream()
+          bundleWriter.writeBundle(org.eclipse.jgit.lib.NullProgressMonitor.INSTANCE, baos)
+
+          val bundleBytes = baos.toByteArray()
+          val base64Bundle = Base64.encodeToString(bundleBytes, Base64.NO_WRAP)
+
+          result.put("ok", true)
+          result.put("bundle", base64Bundle)
+          result.put("bundleSize", bundleBytes.size)
+          android.util.Log.i("GitBundle", "Bundle created: ${bundleBytes.size} bytes, local=$localBranch remote=$remoteName/$remoteBranch")
+        } finally {
+          revWalk.close()
+        }
+      } finally {
+        repo.close()
+      }
+    } catch (e: Exception) {
+      result.put("ok", false)
+      result.put("error", e.message ?: "Unknown bundle error")
+      android.util.Log.e("GitBundle", "Bundle creation failed: ${e.message}", e)
+    }
+    return result.toString()
+  }
+
   // ─── Git fetch (JGit) ───────────────────────────────────────────
 
   /**

package/build/index.d.ts

@@ -162,6 +162,18 @@ interface IExternalStorageModule {
      * @returns JSON string: `{"ok":true,"updates":[...]}` or `{"ok":false,"error":"..."}`
      */
     gitPush(gitRootDir: string, remoteName: string, localBranch: string, remoteBranch: string, force: boolean, headers?: string | null): Promise<string>;
+    /**
+     * Create a git bundle containing unpushed commits (local branch tip minus remote tracking branch).
+     * Returns base64-encoded bundle data that can be HTTP-POSTed to the desktop for unbundling.
+     * This avoids JGit's broken HTTP push (SmartHttpPushConnection) entirely.
+     *
+     * @param gitRootDir    Absolute path to the git working directory
+     * @param remoteName    Remote name (e.g. "origin")
+     * @param localBranch   Local branch name (e.g. "master")
+     * @param remoteBranch  Remote branch name (e.g. "master")
+     * @returns JSON string: `{"ok":true,"bundleBase64":"..."}` or `{"ok":false,"error":"..."}`
+     */
+    gitCreateBundle(gitRootDir: string, remoteName: string, localBranch: string, remoteBranch: string): Promise<string>;
     /**
      * Fetch from remote using native JGit (efficient pack handling).
      *

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,IAAI,OAA2C,CAAC;AAEhD;;;;GAIG;AACH,SAAS,eAAe;IACtB,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,iEAAiE;IACjE,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAsE,CAAC;IAClI,OAAO,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IACjD,OAAO,OAAO,CAAC;AACjB,CAAC;AAyVD,MAAM,CAAC,MAAM,eAAe,GAA2B,IAAI,KAAK,CAAC,EAA4B,EAAE;IAC7F,GAAG,CAAC,OAAO,EAAE,QAAQ;QACnB,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,OAAQ,GAAmD,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC;CACF,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,IAAI,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/**\n * TypeScript bindings for the ExternalStorage native module.\n *\n * This module uses raw java.io.File on Android to bypass Expo FileSystem's\n * directory whitelist. It allows reading/writing to shared external storage\n * when MANAGE_EXTERNAL_STORAGE permission is granted.\n *\n * All path arguments are plain filesystem paths (e.g. \"/storage/emulated/0/Documents/TidGi/\").\n * Do NOT pass file:// URIs — strip the scheme before calling.\n */\nimport { Platform } from 'react-native';\n\nlet _module: IExternalStorageModule | undefined;\n\n/**\n * Lazily load the native module. Wrapped in a function so that the app does NOT\n * crash at import time if the native module is missing (e.g. on iOS or when the\n * binary was built without it).\n */\nfunction getNativeModule(): IExternalStorageModule {\n  if (_module) return _module;\n  if (Platform.OS !== 'android' && Platform.OS !== 'ios') {\n    throw new Error('ExternalStorage native module is only available on Android and iOS');\n  }\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const { requireNativeModule } = require('expo-modules-core') as { requireNativeModule: (name: string) => IExternalStorageModule };\n  _module = requireNativeModule('ExternalStorage');\n  return _module;\n}\n\ninterface FileInfo {\n  exists: boolean;\n  isDirectory: boolean;\n  size: number;\n  /** Milliseconds since epoch */\n  modificationTime: number;\n}\n\ninterface BatchWriteResult {\n  writtenCount: number;\n}\n\ninterface HttpPostToFileResult {\n  statusCode: number;\n  headers: Record<string, string>;\n  bytesWritten: number;\n}\n\ninterface DownloadFileResumableResult {\n  statusCode: number;\n  /** Final size of the file on disk after download */\n  totalBytes: number;\n  /** true if the download resumed from a partial file (HTTP 206) */\n  resumed: boolean;\n}\n\ninterface ExtractTarResult {\n  filesExtracted: number;\n}\n\ninterface ReadFileChunkResult {\n  /** Base64-encoded chunk data */\n  data: string;\n  bytesRead: number;\n}\n\ninterface IExternalStorageModule {\n  exists(path: string): Promise<boolean>;\n  getInfo(path: string): Promise<FileInfo>;\n\n  mkdir(path: string): Promise<void>;\n  readDir(path: string): Promise<string[]>;\n  /** Recursively list all files under a directory, returning relative paths. Skips .git etc. */\n  readDirRecursive(path: string): Promise<string[]>;\n  rmdir(path: string): Promise<void>;\n\n  readFileUtf8(path: string): Promise<string>;\n  readFileBase64(path: string): Promise<string>;\n  writeFileUtf8(path: string, content: string): Promise<void>;\n  writeFileBase64(path: string, base64Content: string): Promise<void>;\n  /**\n   * Append a Base64-encoded chunk to a file, optionally truncating first.\n   *\n   * Designed for streaming large writes from JS in bounded-memory chunks\n   * (e.g. 512 KB each) so the JVM never allocates the full file content,\n   * avoiding OOM on 50+ MB git pack files.\n   *\n   * @param truncateFirst Pass `true` for the first chunk to create/truncate\n   *                      the file, then `false` for subsequent chunks.\n   */\n  appendFileBase64(path: string, base64Content: string, truncateFirst: boolean): Promise<void>;\n  writeFilesBase64(paths: string[], base64Contents: string[]): Promise<BatchWriteResult>;\n  deleteFile(path: string): Promise<void>;\n\n  isExternalStorageWritable(): Promise<boolean>;\n  getExternalStorageDirectory(): Promise<string>;\n  /** Android 11+ (API 30): check if MANAGE_EXTERNAL_STORAGE is granted. Pre-30 returns true. */\n  isExternalStorageManager(): Promise<boolean>;\n\n  /**\n   * HTTP POST with the response body streamed directly to a file on disk,\n   * **never buffering the full response in JVM/Hermes heap**.\n   *\n   * Designed for git-upload-pack which can return 100+ MB packfiles.\n   *\n   * @param url         Target URL\n   * @param headers     HTTP headers as `{ key: value }`\n   * @param bodyBase64  Request body encoded as Base64 (binary git protocol data)\n   * @param destPath    Plain filesystem path to write the response body to\n   * @param contentType MIME type for the request body\n   */\n  httpPostToFile(\n    url: string,\n    headers: Record<string, string>,\n    bodyBase64: string,\n    destPath: string,\n    contentType: string,\n  ): Promise<HttpPostToFileResult>;\n\n  /**\n   * Read a chunk of a file starting at `offset` for up to `length` bytes.\n   * Returns Base64-encoded data and actual bytes read.\n   *\n   * Use this to stream a large file into JS in bounded-memory chunks.\n   */\n  readFileChunk(path: string, offset: number, length: number): Promise<ReadFileChunkResult>;\n\n  /**\n   * Download a file via HTTP GET with resumable download support.\n   *\n   * If `destPath` already exists on disk (from a previous interrupted download),\n   * sends `Range: bytes=<existingSize>-` to resume. The server must respond\n   * with 206 Partial Content for resume to work; otherwise the file is\n   * overwritten from scratch (200 response).\n   *\n   * @param url       Target URL\n   * @param headers   Extra HTTP headers (e.g. Authorization, ETag)\n   * @param destPath  Plain filesystem path for the downloaded file\n   */\n  downloadFileResumable(\n    url: string,\n    headers: Record<string, string>,\n    destPath: string,\n  ): Promise<DownloadFileResumableResult>;\n\n  /**\n   * Extract an uncompressed tar archive to a destination directory.\n   * Uses a native tar parser — no third-party dependency.\n   * Supports POSIX ustar and GNU long-name extensions.\n   * Validates paths to prevent directory traversal attacks.\n   *\n   * @param tarPath  Path to the .tar file\n   * @param destDir  Destination directory (created if needed)\n   */\n  extractTar(tarPath: string, destDir: string): Promise<ExtractTarResult>;\n\n  /**\n   * Parse a batch of TiddlyWiki tiddler files entirely in native Kotlin.\n   *\n   * This is the critical performance optimization for initial wiki loading:\n   * a single bridge call processes 100+ files in parallel, returning a\n   * ready-to-inject JSON array string. Eliminates per-file bridge round-trips.\n   *\n   * Supports .tid, .json, and .meta files. Applies skinny logic:\n   * - System tiddlers ($:/) → always full text\n   * - Plugins (application/json + plugin-type) → always full text\n   * - Module tiddlers (module-type) → always full text\n   * - Small tiddlers (< 10KB body) → full text\n   * - Large user tiddlers → skinny (_is_skinny: \"yes\", text omitted)\n   *\n   * @param filePaths     Array of absolute filesystem paths\n   * @param quickLoadMode If true, all tiddlers returned as skinny\n   * @returns JSON string: serialized array of tiddler field objects\n   */\n  batchParseTidFiles(filePaths: string[], quickLoadMode: boolean): Promise<string>;\n\n  /**\n   * Lightweight native git status using direct git-index parsing.\n   *\n   * Parses `.git/index` to get tracked files and their stat-cache entries,\n   * then compares against the working directory using file size and mtime.\n   * Orders of magnitude faster than isomorphic-git's `statusMatrix` because:\n   * - No JS↔Native bridge round-trips per file\n   * - Uses stat-cache (size+mtime) instead of SHA-1 re-hashing\n   * - Parallel file walking in Java\n   *\n   * @param gitRootDir The root directory of the git repository (parent of .git/)\n   * @returns JSON string: `[{\"path\":\"tiddlers/foo.tid\",\"type\":\"add\"|\"modify\"|\"delete\"}, ...]`\n   */\n  gitStatus(gitRootDir: string): Promise<string>;\n\n  /**\n   * Debug function returning diagnostic info about the git repository state.\n   * @returns JSON string with root/gitDir/index existence and git dir children\n   */\n  gitStatusDebug(gitRootDir: string): Promise<string>;\n\n  /**\n   * Build `.git/index` natively by reading the HEAD tree from pack files,\n   * stat'ing all files on disk, and writing a v2 index file.\n   *\n   * This is used after archive clone where TidGi Desktop's tar export\n   * doesn't include `.git/index`.\n   *\n   * @param gitRootDir The root directory of the git repository (parent of .git/)\n   * @returns JSON string: `{\"ok\":true,\"entries\":N,\"indexSize\":M}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  buildGitIndex(gitRootDir: string): Promise<string>;\n\n  /**\n   * Push local branch to remote using native JGit (efficient pack building).\n   * Avoids OOM from isomorphic-git's JS-based pack construction on large repos.\n   *\n   * @param gitRootDir   Absolute path to the git working directory\n   * @param remoteName   Remote name (e.g. \"origin\")\n   * @param localBranch  Local branch name (e.g. \"main\")\n   * @param remoteBranch Remote branch ref (e.g. \"refs/heads/mobile-incoming\")\n   * @param force        Whether to force push\n   * @param headers      Optional HTTP headers as JSON string\n   * @returns JSON string: `{\"ok\":true,\"updates\":[...]}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitPush(gitRootDir: string, remoteName: string, localBranch: string, remoteBranch: string, force: boolean, headers?: string | null): Promise<string>;\n\n  /**\n   * Fetch from remote using native JGit (efficient pack handling).\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param remoteName  Remote name (e.g. \"origin\")\n   * @param branch      Branch to fetch\n   * @param headers     Optional HTTP headers as JSON string\n   * @returns JSON string: `{\"ok\":true,\"updates\":[...]}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitFetch(gitRootDir: string, remoteName: string, branch: string, headers?: string | null): Promise<string>;\n\n  /**\n   * Compare two commits and checkout only changed/new files to the working tree.\n   * Avoids full checkout which OOMs on large repos.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param oldOid      Old commit SHA (before fetch)\n   * @param newOid      New commit SHA (after fetch)\n   * @returns JSON string: `{\"ok\":true,\"count\":N,\"files\":[...]}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitCheckoutChangedFiles(gitRootDir: string, oldOid: string, newOid: string): Promise<string>;\n\n  /**\n   * Stage all changes and commit using native git (JGit on Android).\n   * Replaces isomorphic-git's statusMatrix + add/remove loop which OOMs on large repos.\n   *\n   * @param gitRootDir   Absolute path to the git working directory\n   * @param message      Commit message\n   * @param authorName   Author name\n   * @param authorEmail  Author email\n   * @returns JSON string: `{\"ok\":true,\"commitId\":\"abc123\"}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitAddAndCommit(gitRootDir: string, message: string, authorName: string, authorEmail: string): Promise<string>;\n\n  /**\n   * Reset the current branch to a specific ref using native git (JGit on Android).\n   * Supports hard, mixed, and soft reset modes.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param ref         Target ref (e.g. \"origin/main\", commit SHA)\n   * @param mode        Reset mode: \"hard\", \"mixed\", or \"soft\"\n   * @returns JSON string: `{\"ok\":true,\"ref\":\"abc123\"}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitReset(gitRootDir: string, ref: string, mode: string): Promise<string>;\n\n  /**\n   * Clone a remote repository using native JGit.\n   *\n   * @param url          Remote repository URL\n   * @param directory    Destination directory\n   * @param branch       Branch to clone (null for default)\n   * @param depth        Depth for shallow clone (0 for full)\n   * @param singleBranch Whether to clone only the specified branch\n   * @param noTags       Whether to skip fetching tags\n   * @param headers      Optional HTTP headers as JSON string\n   * @returns JSON string: `{\"ok\":true,\"head\":\"abc123\"}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitClone(url: string, directory: string, branch: string | null, depth: number, singleBranch: boolean, noTags: boolean, headers?: string | null): Promise<string>;\n\n  /**\n   * Get commit history using native git log.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param ref         Branch or ref to start from (null for all)\n   * @param maxCount    Maximum number of commits to return\n   * @returns JSON string: `{\"ok\":true,\"commits\":[{\"oid\",\"message\",\"authorName\",\"authorEmail\",\"timestamp\",\"parentOids\"}]}`\n   */\n  gitLog(gitRootDir: string, ref: string | null, maxCount: number): Promise<string>;\n\n  /**\n   * Resolve a git reference to its SHA-1 hash.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param ref         Reference to resolve (e.g. \"HEAD\", \"refs/heads/main\", \"origin/main\")\n   * @returns JSON string: `{\"ok\":true,\"oid\":\"abc123\"}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitResolveRef(gitRootDir: string, ref: string): Promise<string>;\n\n  /**\n   * Get current branch name and branch listings.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @returns JSON string: `{\"ok\":true,\"branch\":\"main\",\"isDetached\":false,\"localBranches\":[],\"remoteBranches\":[]}`\n   */\n  gitCurrentBranch(gitRootDir: string): Promise<string>;\n\n  /**\n   * Initialize a new git repository.\n   *\n   * @param directory     Directory to initialize\n   * @param defaultBranch Default branch name (e.g. \"main\")\n   * @returns JSON string: `{\"ok\":true}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitInit(directory: string, defaultBranch: string): Promise<string>;\n\n  /**\n   * Set a git config value.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param section     Config section (e.g. \"remote\")\n   * @param subsection  Config subsection (e.g. \"origin\"), null for no subsection\n   * @param name        Config key (e.g. \"url\")\n   * @param value       Config value\n   * @returns JSON string: `{\"ok\":true}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitSetConfig(gitRootDir: string, section: string, subsection: string | null, name: string, value: string): Promise<string>;\n\n  /**\n   * Add a remote to the repository.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param remoteName  Remote name (e.g. \"origin\")\n   * @param url         Remote URL\n   * @returns JSON string: `{\"ok\":true}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitAddRemote(gitRootDir: string, remoteName: string, url: string): Promise<string>;\n\n  /**\n   * Read a file (blob) at a specific commit reference.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param ref         Commit ref to read from\n   * @param filepath    Relative path within the repository\n   * @param asBase64    If true, return content as base64; otherwise as utf8 string\n   * @returns JSON string: `{\"ok\":true,\"content\":\"...\",\"encoding\":\"base64\"|\"utf8\",\"size\":N}`\n   */\n  gitReadBlob(gitRootDir: string, ref: string, filepath: string, asBase64: boolean): Promise<string>;\n\n  /**\n   * Diff two commits and return changed files list.\n   * Native equivalent of tree-walking diff.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param oldRef      Old commit ref\n   * @param newRef      New commit ref\n   * @returns JSON string: `{\"ok\":true,\"files\":[{\"path\":\"...\",\"type\":\"add\"|\"modify\"|\"delete\"}]}`\n   */\n  gitDiffTrees(gitRootDir: string, oldRef: string, newRef: string): Promise<string>;\n\n  /**\n   * Discard uncommitted changes for a specific file.\n   * Checks out the HEAD version, or deletes the file if it's untracked.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param filepath    Relative path of the file to discard\n   * @returns JSON string: `{\"ok\":true,\"action\":\"checkout\"|\"delete\"}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitDiscardFileChanges(gitRootDir: string, filepath: string): Promise<string>;\n}\n\nexport const ExternalStorage: IExternalStorageModule = new Proxy({} as IExternalStorageModule, {\n  get(_target, property) {\n    const mod = getNativeModule();\n    return (mod as unknown as Record<string | symbol, unknown>)[property];\n  },\n});\n\n/**\n * Strip file:// prefix from a URI to produce a plain filesystem path.\n * Safe to call on paths that are already plain.\n */\nexport function toPlainPath(uriOrPath: string): string {\n  if (uriOrPath.startsWith('file://')) {\n    return uriOrPath.slice('file://'.length);\n  }\n  return uriOrPath;\n}\n\nexport type { BatchWriteResult, DownloadFileResumableResult, ExtractTarResult, FileInfo, HttpPostToFileResult, IExternalStorageModule, ReadFileChunkResult };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,IAAI,OAA2C,CAAC;AAEhD;;;;GAIG;AACH,SAAS,eAAe;IACtB,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,iEAAiE;IACjE,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAsE,CAAC;IAClI,OAAO,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IACjD,OAAO,OAAO,CAAC;AACjB,CAAC;AAsWD,MAAM,CAAC,MAAM,eAAe,GAA2B,IAAI,KAAK,CAAC,EAA4B,EAAE;IAC7F,GAAG,CAAC,OAAO,EAAE,QAAQ;QACnB,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,OAAQ,GAAmD,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC;CACF,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,IAAI,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/**\n * TypeScript bindings for the ExternalStorage native module.\n *\n * This module uses raw java.io.File on Android to bypass Expo FileSystem's\n * directory whitelist. It allows reading/writing to shared external storage\n * when MANAGE_EXTERNAL_STORAGE permission is granted.\n *\n * All path arguments are plain filesystem paths (e.g. \"/storage/emulated/0/Documents/TidGi/\").\n * Do NOT pass file:// URIs — strip the scheme before calling.\n */\nimport { Platform } from 'react-native';\n\nlet _module: IExternalStorageModule | undefined;\n\n/**\n * Lazily load the native module. Wrapped in a function so that the app does NOT\n * crash at import time if the native module is missing (e.g. on iOS or when the\n * binary was built without it).\n */\nfunction getNativeModule(): IExternalStorageModule {\n  if (_module) return _module;\n  if (Platform.OS !== 'android' && Platform.OS !== 'ios') {\n    throw new Error('ExternalStorage native module is only available on Android and iOS');\n  }\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const { requireNativeModule } = require('expo-modules-core') as { requireNativeModule: (name: string) => IExternalStorageModule };\n  _module = requireNativeModule('ExternalStorage');\n  return _module;\n}\n\ninterface FileInfo {\n  exists: boolean;\n  isDirectory: boolean;\n  size: number;\n  /** Milliseconds since epoch */\n  modificationTime: number;\n}\n\ninterface BatchWriteResult {\n  writtenCount: number;\n}\n\ninterface HttpPostToFileResult {\n  statusCode: number;\n  headers: Record<string, string>;\n  bytesWritten: number;\n}\n\ninterface DownloadFileResumableResult {\n  statusCode: number;\n  /** Final size of the file on disk after download */\n  totalBytes: number;\n  /** true if the download resumed from a partial file (HTTP 206) */\n  resumed: boolean;\n}\n\ninterface ExtractTarResult {\n  filesExtracted: number;\n}\n\ninterface ReadFileChunkResult {\n  /** Base64-encoded chunk data */\n  data: string;\n  bytesRead: number;\n}\n\ninterface IExternalStorageModule {\n  exists(path: string): Promise<boolean>;\n  getInfo(path: string): Promise<FileInfo>;\n\n  mkdir(path: string): Promise<void>;\n  readDir(path: string): Promise<string[]>;\n  /** Recursively list all files under a directory, returning relative paths. Skips .git etc. */\n  readDirRecursive(path: string): Promise<string[]>;\n  rmdir(path: string): Promise<void>;\n\n  readFileUtf8(path: string): Promise<string>;\n  readFileBase64(path: string): Promise<string>;\n  writeFileUtf8(path: string, content: string): Promise<void>;\n  writeFileBase64(path: string, base64Content: string): Promise<void>;\n  /**\n   * Append a Base64-encoded chunk to a file, optionally truncating first.\n   *\n   * Designed for streaming large writes from JS in bounded-memory chunks\n   * (e.g. 512 KB each) so the JVM never allocates the full file content,\n   * avoiding OOM on 50+ MB git pack files.\n   *\n   * @param truncateFirst Pass `true` for the first chunk to create/truncate\n   *                      the file, then `false` for subsequent chunks.\n   */\n  appendFileBase64(path: string, base64Content: string, truncateFirst: boolean): Promise<void>;\n  writeFilesBase64(paths: string[], base64Contents: string[]): Promise<BatchWriteResult>;\n  deleteFile(path: string): Promise<void>;\n\n  isExternalStorageWritable(): Promise<boolean>;\n  getExternalStorageDirectory(): Promise<string>;\n  /** Android 11+ (API 30): check if MANAGE_EXTERNAL_STORAGE is granted. Pre-30 returns true. */\n  isExternalStorageManager(): Promise<boolean>;\n\n  /**\n   * HTTP POST with the response body streamed directly to a file on disk,\n   * **never buffering the full response in JVM/Hermes heap**.\n   *\n   * Designed for git-upload-pack which can return 100+ MB packfiles.\n   *\n   * @param url         Target URL\n   * @param headers     HTTP headers as `{ key: value }`\n   * @param bodyBase64  Request body encoded as Base64 (binary git protocol data)\n   * @param destPath    Plain filesystem path to write the response body to\n   * @param contentType MIME type for the request body\n   */\n  httpPostToFile(\n    url: string,\n    headers: Record<string, string>,\n    bodyBase64: string,\n    destPath: string,\n    contentType: string,\n  ): Promise<HttpPostToFileResult>;\n\n  /**\n   * Read a chunk of a file starting at `offset` for up to `length` bytes.\n   * Returns Base64-encoded data and actual bytes read.\n   *\n   * Use this to stream a large file into JS in bounded-memory chunks.\n   */\n  readFileChunk(path: string, offset: number, length: number): Promise<ReadFileChunkResult>;\n\n  /**\n   * Download a file via HTTP GET with resumable download support.\n   *\n   * If `destPath` already exists on disk (from a previous interrupted download),\n   * sends `Range: bytes=<existingSize>-` to resume. The server must respond\n   * with 206 Partial Content for resume to work; otherwise the file is\n   * overwritten from scratch (200 response).\n   *\n   * @param url       Target URL\n   * @param headers   Extra HTTP headers (e.g. Authorization, ETag)\n   * @param destPath  Plain filesystem path for the downloaded file\n   */\n  downloadFileResumable(\n    url: string,\n    headers: Record<string, string>,\n    destPath: string,\n  ): Promise<DownloadFileResumableResult>;\n\n  /**\n   * Extract an uncompressed tar archive to a destination directory.\n   * Uses a native tar parser — no third-party dependency.\n   * Supports POSIX ustar and GNU long-name extensions.\n   * Validates paths to prevent directory traversal attacks.\n   *\n   * @param tarPath  Path to the .tar file\n   * @param destDir  Destination directory (created if needed)\n   */\n  extractTar(tarPath: string, destDir: string): Promise<ExtractTarResult>;\n\n  /**\n   * Parse a batch of TiddlyWiki tiddler files entirely in native Kotlin.\n   *\n   * This is the critical performance optimization for initial wiki loading:\n   * a single bridge call processes 100+ files in parallel, returning a\n   * ready-to-inject JSON array string. Eliminates per-file bridge round-trips.\n   *\n   * Supports .tid, .json, and .meta files. Applies skinny logic:\n   * - System tiddlers ($:/) → always full text\n   * - Plugins (application/json + plugin-type) → always full text\n   * - Module tiddlers (module-type) → always full text\n   * - Small tiddlers (< 10KB body) → full text\n   * - Large user tiddlers → skinny (_is_skinny: \"yes\", text omitted)\n   *\n   * @param filePaths     Array of absolute filesystem paths\n   * @param quickLoadMode If true, all tiddlers returned as skinny\n   * @returns JSON string: serialized array of tiddler field objects\n   */\n  batchParseTidFiles(filePaths: string[], quickLoadMode: boolean): Promise<string>;\n\n  /**\n   * Lightweight native git status using direct git-index parsing.\n   *\n   * Parses `.git/index` to get tracked files and their stat-cache entries,\n   * then compares against the working directory using file size and mtime.\n   * Orders of magnitude faster than isomorphic-git's `statusMatrix` because:\n   * - No JS↔Native bridge round-trips per file\n   * - Uses stat-cache (size+mtime) instead of SHA-1 re-hashing\n   * - Parallel file walking in Java\n   *\n   * @param gitRootDir The root directory of the git repository (parent of .git/)\n   * @returns JSON string: `[{\"path\":\"tiddlers/foo.tid\",\"type\":\"add\"|\"modify\"|\"delete\"}, ...]`\n   */\n  gitStatus(gitRootDir: string): Promise<string>;\n\n  /**\n   * Debug function returning diagnostic info about the git repository state.\n   * @returns JSON string with root/gitDir/index existence and git dir children\n   */\n  gitStatusDebug(gitRootDir: string): Promise<string>;\n\n  /**\n   * Build `.git/index` natively by reading the HEAD tree from pack files,\n   * stat'ing all files on disk, and writing a v2 index file.\n   *\n   * This is used after archive clone where TidGi Desktop's tar export\n   * doesn't include `.git/index`.\n   *\n   * @param gitRootDir The root directory of the git repository (parent of .git/)\n   * @returns JSON string: `{\"ok\":true,\"entries\":N,\"indexSize\":M}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  buildGitIndex(gitRootDir: string): Promise<string>;\n\n  /**\n   * Push local branch to remote using native JGit (efficient pack building).\n   * Avoids OOM from isomorphic-git's JS-based pack construction on large repos.\n   *\n   * @param gitRootDir   Absolute path to the git working directory\n   * @param remoteName   Remote name (e.g. \"origin\")\n   * @param localBranch  Local branch name (e.g. \"main\")\n   * @param remoteBranch Remote branch ref (e.g. \"refs/heads/mobile-incoming\")\n   * @param force        Whether to force push\n   * @param headers      Optional HTTP headers as JSON string\n   * @returns JSON string: `{\"ok\":true,\"updates\":[...]}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitPush(gitRootDir: string, remoteName: string, localBranch: string, remoteBranch: string, force: boolean, headers?: string | null): Promise<string>;\n\n  /**\n   * Create a git bundle containing unpushed commits (local branch tip minus remote tracking branch).\n   * Returns base64-encoded bundle data that can be HTTP-POSTed to the desktop for unbundling.\n   * This avoids JGit's broken HTTP push (SmartHttpPushConnection) entirely.\n   *\n   * @param gitRootDir    Absolute path to the git working directory\n   * @param remoteName    Remote name (e.g. \"origin\")\n   * @param localBranch   Local branch name (e.g. \"master\")\n   * @param remoteBranch  Remote branch name (e.g. \"master\")\n   * @returns JSON string: `{\"ok\":true,\"bundleBase64\":\"...\"}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitCreateBundle(gitRootDir: string, remoteName: string, localBranch: string, remoteBranch: string): Promise<string>;\n\n  /**\n   * Fetch from remote using native JGit (efficient pack handling).\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param remoteName  Remote name (e.g. \"origin\")\n   * @param branch      Branch to fetch\n   * @param headers     Optional HTTP headers as JSON string\n   * @returns JSON string: `{\"ok\":true,\"updates\":[...]}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitFetch(gitRootDir: string, remoteName: string, branch: string, headers?: string | null): Promise<string>;\n\n  /**\n   * Compare two commits and checkout only changed/new files to the working tree.\n   * Avoids full checkout which OOMs on large repos.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param oldOid      Old commit SHA (before fetch)\n   * @param newOid      New commit SHA (after fetch)\n   * @returns JSON string: `{\"ok\":true,\"count\":N,\"files\":[...]}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitCheckoutChangedFiles(gitRootDir: string, oldOid: string, newOid: string): Promise<string>;\n\n  /**\n   * Stage all changes and commit using native git (JGit on Android).\n   * Replaces isomorphic-git's statusMatrix + add/remove loop which OOMs on large repos.\n   *\n   * @param gitRootDir   Absolute path to the git working directory\n   * @param message      Commit message\n   * @param authorName   Author name\n   * @param authorEmail  Author email\n   * @returns JSON string: `{\"ok\":true,\"commitId\":\"abc123\"}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitAddAndCommit(gitRootDir: string, message: string, authorName: string, authorEmail: string): Promise<string>;\n\n  /**\n   * Reset the current branch to a specific ref using native git (JGit on Android).\n   * Supports hard, mixed, and soft reset modes.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param ref         Target ref (e.g. \"origin/main\", commit SHA)\n   * @param mode        Reset mode: \"hard\", \"mixed\", or \"soft\"\n   * @returns JSON string: `{\"ok\":true,\"ref\":\"abc123\"}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitReset(gitRootDir: string, ref: string, mode: string): Promise<string>;\n\n  /**\n   * Clone a remote repository using native JGit.\n   *\n   * @param url          Remote repository URL\n   * @param directory    Destination directory\n   * @param branch       Branch to clone (null for default)\n   * @param depth        Depth for shallow clone (0 for full)\n   * @param singleBranch Whether to clone only the specified branch\n   * @param noTags       Whether to skip fetching tags\n   * @param headers      Optional HTTP headers as JSON string\n   * @returns JSON string: `{\"ok\":true,\"head\":\"abc123\"}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitClone(url: string, directory: string, branch: string | null, depth: number, singleBranch: boolean, noTags: boolean, headers?: string | null): Promise<string>;\n\n  /**\n   * Get commit history using native git log.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param ref         Branch or ref to start from (null for all)\n   * @param maxCount    Maximum number of commits to return\n   * @returns JSON string: `{\"ok\":true,\"commits\":[{\"oid\",\"message\",\"authorName\",\"authorEmail\",\"timestamp\",\"parentOids\"}]}`\n   */\n  gitLog(gitRootDir: string, ref: string | null, maxCount: number): Promise<string>;\n\n  /**\n   * Resolve a git reference to its SHA-1 hash.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param ref         Reference to resolve (e.g. \"HEAD\", \"refs/heads/main\", \"origin/main\")\n   * @returns JSON string: `{\"ok\":true,\"oid\":\"abc123\"}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitResolveRef(gitRootDir: string, ref: string): Promise<string>;\n\n  /**\n   * Get current branch name and branch listings.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @returns JSON string: `{\"ok\":true,\"branch\":\"main\",\"isDetached\":false,\"localBranches\":[],\"remoteBranches\":[]}`\n   */\n  gitCurrentBranch(gitRootDir: string): Promise<string>;\n\n  /**\n   * Initialize a new git repository.\n   *\n   * @param directory     Directory to initialize\n   * @param defaultBranch Default branch name (e.g. \"main\")\n   * @returns JSON string: `{\"ok\":true}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitInit(directory: string, defaultBranch: string): Promise<string>;\n\n  /**\n   * Set a git config value.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param section     Config section (e.g. \"remote\")\n   * @param subsection  Config subsection (e.g. \"origin\"), null for no subsection\n   * @param name        Config key (e.g. \"url\")\n   * @param value       Config value\n   * @returns JSON string: `{\"ok\":true}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitSetConfig(gitRootDir: string, section: string, subsection: string | null, name: string, value: string): Promise<string>;\n\n  /**\n   * Add a remote to the repository.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param remoteName  Remote name (e.g. \"origin\")\n   * @param url         Remote URL\n   * @returns JSON string: `{\"ok\":true}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitAddRemote(gitRootDir: string, remoteName: string, url: string): Promise<string>;\n\n  /**\n   * Read a file (blob) at a specific commit reference.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param ref         Commit ref to read from\n   * @param filepath    Relative path within the repository\n   * @param asBase64    If true, return content as base64; otherwise as utf8 string\n   * @returns JSON string: `{\"ok\":true,\"content\":\"...\",\"encoding\":\"base64\"|\"utf8\",\"size\":N}`\n   */\n  gitReadBlob(gitRootDir: string, ref: string, filepath: string, asBase64: boolean): Promise<string>;\n\n  /**\n   * Diff two commits and return changed files list.\n   * Native equivalent of tree-walking diff.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param oldRef      Old commit ref\n   * @param newRef      New commit ref\n   * @returns JSON string: `{\"ok\":true,\"files\":[{\"path\":\"...\",\"type\":\"add\"|\"modify\"|\"delete\"}]}`\n   */\n  gitDiffTrees(gitRootDir: string, oldRef: string, newRef: string): Promise<string>;\n\n  /**\n   * Discard uncommitted changes for a specific file.\n   * Checks out the HEAD version, or deletes the file if it's untracked.\n   *\n   * @param gitRootDir  Absolute path to the git working directory\n   * @param filepath    Relative path of the file to discard\n   * @returns JSON string: `{\"ok\":true,\"action\":\"checkout\"|\"delete\"}` or `{\"ok\":false,\"error\":\"...\"}`\n   */\n  gitDiscardFileChanges(gitRootDir: string, filepath: string): Promise<string>;\n}\n\nexport const ExternalStorage: IExternalStorageModule = new Proxy({} as IExternalStorageModule, {\n  get(_target, property) {\n    const mod = getNativeModule();\n    return (mod as unknown as Record<string | symbol, unknown>)[property];\n  },\n});\n\n/**\n * Strip file:// prefix from a URI to produce a plain filesystem path.\n * Safe to call on paths that are already plain.\n */\nexport function toPlainPath(uriOrPath: string): string {\n  if (uriOrPath.startsWith('file://')) {\n    return uriOrPath.slice('file://'.length);\n  }\n  return uriOrPath;\n}\n\nexport type { BatchWriteResult, DownloadFileResumableResult, ExtractTarResult, FileInfo, HttpPostToFileResult, IExternalStorageModule, ReadFileChunkResult };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-tiddlywiki-filesystem-android-external-storage",
-  "version": "2.7.0",
+  "version": "2.9.0",
   "description": "Expo native module for TidGi-Mobile: filesystem I/O + TiddlyWiki .tid/.meta/.json batch parsing + git status in Kotlin (Android) and Swift (iOS)",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/src/index.ts

@@ -221,6 +221,19 @@ interface IExternalStorageModule {
    */
   gitPush(gitRootDir: string, remoteName: string, localBranch: string, remoteBranch: string, force: boolean, headers?: string | null): Promise<string>;
 
+  /**
+   * Create a git bundle containing unpushed commits (local branch tip minus remote tracking branch).
+   * Returns base64-encoded bundle data that can be HTTP-POSTed to the desktop for unbundling.
+   * This avoids JGit's broken HTTP push (SmartHttpPushConnection) entirely.
+   *
+   * @param gitRootDir    Absolute path to the git working directory
+   * @param remoteName    Remote name (e.g. "origin")
+   * @param localBranch   Local branch name (e.g. "master")
+   * @param remoteBranch  Remote branch name (e.g. "master")
+   * @returns JSON string: `{"ok":true,"bundleBase64":"..."}` or `{"ok":false,"error":"..."}`
+   */
+  gitCreateBundle(gitRootDir: string, remoteName: string, localBranch: string, remoteBranch: string): Promise<string>;
+
   /**
    * Fetch from remote using native JGit (efficient pack handling).
    *