expo-tiddlywiki-filesystem-android-external-storage 2.3.0 → 2.4.0

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

@@ -584,6 +584,46 @@ class ExternalStorageModule : Module() {
       GitHelper.gitReset(gitRootDir, ref, mode)
     }
 
+    AsyncFunction("gitClone") { url: String, directory: String, branch: String?, depth: Int, singleBranch: Boolean, noTags: Boolean, headers: String? ->
+      GitHelper.gitClone(url, directory, branch, depth, singleBranch, noTags, headers)
+    }
+
+    AsyncFunction("gitLog") { gitRootDir: String, ref: String?, maxCount: Int ->
+      GitHelper.gitLog(gitRootDir, ref, maxCount)
+    }
+
+    AsyncFunction("gitResolveRef") { gitRootDir: String, ref: String ->
+      GitHelper.gitResolveRef(gitRootDir, ref)
+    }
+
+    AsyncFunction("gitCurrentBranch") { gitRootDir: String ->
+      GitHelper.gitCurrentBranch(gitRootDir)
+    }
+
+    AsyncFunction("gitInit") { directory: String, defaultBranch: String ->
+      GitHelper.gitInit(directory, defaultBranch)
+    }
+
+    AsyncFunction("gitSetConfig") { gitRootDir: String, section: String, subsection: String?, name: String, value: String ->
+      GitHelper.gitSetConfig(gitRootDir, section, subsection, name, value)
+    }
+
+    AsyncFunction("gitAddRemote") { gitRootDir: String, remoteName: String, url: String ->
+      GitHelper.gitAddRemote(gitRootDir, remoteName, url)
+    }
+
+    AsyncFunction("gitReadBlob") { gitRootDir: String, ref: String, filepath: String, asBase64: Boolean ->
+      GitHelper.gitReadBlob(gitRootDir, ref, filepath, asBase64)
+    }
+
+    AsyncFunction("gitDiffTrees") { gitRootDir: String, oldRef: String, newRef: String ->
+      GitHelper.gitDiffTrees(gitRootDir, oldRef, newRef)
+    }
+
+    AsyncFunction("gitDiscardFileChanges") { gitRootDir: String, filepath: String ->
+      GitHelper.gitDiscardFileChanges(gitRootDir, filepath)
+    }
+
     // ─── TiddlyWiki batch file parsing ─────────────────────────────────
 
     /**

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

@@ -17,6 +17,7 @@ import org.json.JSONArray
 import org.json.JSONObject
 import java.io.ByteArrayOutputStream
 import java.io.File
+import android.util.Base64
 
 /**
  * All git-related operations using JGit — a pure Java implementation of Git.
@@ -548,4 +549,454 @@ internal object GitHelper {
     }
     return result.toString()
   }
+
+  // ─── Git clone (JGit) ───────────────────────────────────────────
+
+  /**
+   * Clone a remote repository into the specified directory.
+   * Uses JGit's CloneCommand for efficient native pack handling.
+   */
+  fun gitClone(
+    url: String,
+    directory: String,
+    branch: String?,
+    depth: Int,
+    singleBranch: Boolean,
+    noTags: Boolean,
+    headers: String?
+  ): String {
+    val result = JSONObject()
+    try {
+      val targetDir = File(directory)
+      val cloneCommand = Git.cloneRepository()
+        .setURI(url)
+        .setDirectory(targetDir)
+        .setCloneAllBranches(!singleBranch)
+
+      if (singleBranch && branch != null) {
+        cloneCommand.setBranch("refs/heads/$branch")
+        cloneCommand.setBranchesToClone(listOf("refs/heads/$branch"))
+      }
+
+      if (depth > 0) {
+        cloneCommand.setDepth(depth)
+      }
+
+      if (noTags) {
+        cloneCommand.setNoTags()
+      }
+
+      applyHeaders(cloneCommand, headers)
+
+      val git = cloneCommand.call()
+      val headId = git.repository.resolve(Constants.HEAD)
+
+      result.put("ok", true)
+      result.put("head", headId?.name ?: "")
+      android.util.Log.i("GitClone", "Cloned $url to $directory, HEAD=${headId?.name?.take(8)}")
+      git.repository.close()
+    } catch (e: Exception) {
+      result.put("ok", false)
+      result.put("error", e.message ?: "Unknown clone error")
+      android.util.Log.e("GitClone", "Clone failed: ${e.message}", e)
+    }
+    return result.toString()
+  }
+
+  // ─── Git log (JGit) ─────────────────────────────────────────────
+
+  /**
+   * Get commit history using JGit's LogCommand.
+   * Returns JSON array of commit objects.
+   */
+  fun gitLog(
+    gitRootDir: String,
+    ref: String?,
+    maxCount: Int
+  ): String {
+    val result = JSONObject()
+    try {
+      val repo = openRepo(gitRootDir)
+      try {
+        val git = Git(repo)
+        val logCommand = git.log()
+
+        if (ref != null && ref.isNotEmpty()) {
+          val resolved = repo.resolve(ref)
+          if (resolved != null) {
+            logCommand.add(resolved)
+          } else {
+            result.put("ok", true)
+            result.put("commits", JSONArray())
+            return result.toString()
+          }
+        } else {
+          logCommand.all()
+        }
+
+        logCommand.setMaxCount(maxCount)
+
+        val commits = JSONArray()
+        for (commit in logCommand.call()) {
+          val obj = JSONObject()
+          obj.put("oid", commit.id.name)
+          obj.put("message", commit.fullMessage)
+          obj.put("authorName", commit.authorIdent.name)
+          obj.put("authorEmail", commit.authorIdent.emailAddress)
+          obj.put("timestamp", commit.authorIdent.`when`.time)
+          val parents = JSONArray()
+          for (parent in commit.parents) {
+            parents.put(parent.id.name)
+          }
+          obj.put("parentOids", parents)
+          commits.put(obj)
+        }
+
+        result.put("ok", true)
+        result.put("commits", commits)
+      } finally {
+        repo.close()
+      }
+    } catch (e: Exception) {
+      result.put("ok", false)
+      result.put("error", e.message ?: "Unknown log error")
+    }
+    return result.toString()
+  }
+
+  // ─── Git resolve ref (JGit) ─────────────────────────────────────
+
+  /**
+   * Resolve a git reference to its SHA-1 hash.
+   */
+  fun gitResolveRef(
+    gitRootDir: String,
+    ref: String
+  ): String {
+    val result = JSONObject()
+    try {
+      val repo = openRepo(gitRootDir)
+      try {
+        val objectId = repo.resolve(ref)
+        if (objectId != null) {
+          result.put("ok", true)
+          result.put("oid", objectId.name)
+        } else {
+          result.put("ok", false)
+          result.put("error", "Cannot resolve ref: $ref")
+        }
+      } finally {
+        repo.close()
+      }
+    } catch (e: Exception) {
+      result.put("ok", false)
+      result.put("error", e.message ?: "Unknown error")
+    }
+    return result.toString()
+  }
+
+  // ─── Git current branch (JGit) ──────────────────────────────────
+
+  /**
+   * Get the current branch name.
+   * Returns the branch name or "HEAD" if detached.
+   */
+  fun gitCurrentBranch(gitRootDir: String): String {
+    val result = JSONObject()
+    try {
+      val repo = openRepo(gitRootDir)
+      try {
+        val branch = repo.branch
+        val fullBranch = repo.fullBranch
+        val isDetached = fullBranch == null || !fullBranch.startsWith("refs/heads/")
+
+        result.put("ok", true)
+        result.put("branch", branch ?: "")
+        result.put("isDetached", isDetached)
+
+        // Also list all branches
+        val git = Git(repo)
+        val localBranches = JSONArray()
+        for (ref in git.branchList().call()) {
+          localBranches.put(ref.name.removePrefix("refs/heads/"))
+        }
+        result.put("localBranches", localBranches)
+
+        val remoteBranches = JSONArray()
+        for (ref in git.branchList().setListMode(org.eclipse.jgit.api.ListBranchCommand.ListMode.REMOTE).call()) {
+          remoteBranches.put(ref.name.removePrefix("refs/remotes/"))
+        }
+        result.put("remoteBranches", remoteBranches)
+      } finally {
+        repo.close()
+      }
+    } catch (e: Exception) {
+      result.put("ok", false)
+      result.put("error", e.message ?: "Unknown error")
+    }
+    return result.toString()
+  }
+
+  // ─── Git init (JGit) ────────────────────────────────────────────
+
+  /**
+   * Initialize a new git repository.
+   */
+  fun gitInit(
+    directory: String,
+    defaultBranch: String
+  ): String {
+    val result = JSONObject()
+    try {
+      val targetDir = File(directory)
+      targetDir.mkdirs()
+      val git = Git.init()
+        .setDirectory(targetDir)
+        .setInitialBranch(defaultBranch)
+        .call()
+
+      result.put("ok", true)
+      android.util.Log.i("GitInit", "Initialized repo at $directory with branch $defaultBranch")
+      git.repository.close()
+    } catch (e: Exception) {
+      result.put("ok", false)
+      result.put("error", e.message ?: "Unknown init error")
+    }
+    return result.toString()
+  }
+
+  // ─── Git config (JGit) ──────────────────────────────────────────
+
+  /**
+   * Set a git config value. Primarily for remote.origin.url.
+   */
+  fun gitSetConfig(
+    gitRootDir: String,
+    section: String,
+    subsection: String?,
+    name: String,
+    value: String
+  ): String {
+    val result = JSONObject()
+    try {
+      val repo = openRepo(gitRootDir)
+      try {
+        val config = repo.config
+        config.setString(section, subsection, name, value)
+        config.save()
+        result.put("ok", true)
+      } finally {
+        repo.close()
+      }
+    } catch (e: Exception) {
+      result.put("ok", false)
+      result.put("error", e.message ?: "Unknown config error")
+    }
+    return result.toString()
+  }
+
+  /**
+   * Add a remote to the repository.
+   */
+  fun gitAddRemote(
+    gitRootDir: String,
+    remoteName: String,
+    url: String
+  ): String {
+    val result = JSONObject()
+    try {
+      val repo = openRepo(gitRootDir)
+      try {
+        val config = repo.config
+        config.setString("remote", remoteName, "url", url)
+        config.setString("remote", remoteName, "fetch", "+refs/heads/*:refs/remotes/$remoteName/*")
+        config.save()
+        result.put("ok", true)
+      } finally {
+        repo.close()
+      }
+    } catch (e: Exception) {
+      result.put("ok", false)
+      result.put("error", e.message ?: "Unknown error")
+    }
+    return result.toString()
+  }
+
+  // ─── Git read blob (JGit) ───────────────────────────────────────
+
+  /**
+   * Read a file (blob) at a specific commit reference.
+   * Returns base64-encoded content for binary, or utf8 text.
+   */
+  fun gitReadBlob(
+    gitRootDir: String,
+    ref: String,
+    filepath: String,
+    asBase64: Boolean
+  ): String {
+    val result = JSONObject()
+    try {
+      val repo = openRepo(gitRootDir)
+      try {
+        val commitId = repo.resolve(ref)
+          ?: throw Exception("Cannot resolve ref: $ref")
+        val walk = RevWalk(repo)
+        val commit = walk.parseCommit(commitId)
+        val tree = commit.tree
+
+        val treeWalk = TreeWalk.forPath(repo, filepath, tree)
+        if (treeWalk == null) {
+          result.put("ok", false)
+          result.put("error", "File not found in tree: $filepath at $ref")
+          walk.close()
+          return result.toString()
+        }
+
+        val objectId = treeWalk.getObjectId(0)
+        val loader = repo.newObjectReader().open(objectId)
+        val bytes = loader.bytes
+
+        result.put("ok", true)
+        if (asBase64) {
+          result.put("content", Base64.encodeToString(bytes, Base64.NO_WRAP))
+          result.put("encoding", "base64")
+        } else {
+          result.put("content", String(bytes, Charsets.UTF_8))
+          result.put("encoding", "utf8")
+        }
+        result.put("size", bytes.size)
+
+        walk.close()
+      } finally {
+        repo.close()
+      }
+    } catch (e: Exception) {
+      result.put("ok", false)
+      result.put("error", e.message ?: "Unknown error")
+    }
+    return result.toString()
+  }
+
+  // ─── Git diff trees (JGit) ──────────────────────────────────────
+
+  /**
+   * Diff two commits and return the list of changed files.
+   * This is the native equivalent of diffCommitTrees in JS.
+   */
+  fun gitDiffTrees(
+    gitRootDir: String,
+    oldRef: String,
+    newRef: String
+  ): String {
+    val result = JSONObject()
+    try {
+      val repo = openRepo(gitRootDir)
+      try {
+        val walk = RevWalk(repo)
+        val oldCommit = walk.parseCommit(repo.resolve(oldRef)
+          ?: throw Exception("Cannot resolve ref: $oldRef"))
+        val newCommit = walk.parseCommit(repo.resolve(newRef)
+          ?: throw Exception("Cannot resolve ref: $newRef"))
+
+        val diffFormatter = DiffFormatter(ByteArrayOutputStream())
+        diffFormatter.setRepository(repo)
+        val diffs = diffFormatter.scan(oldCommit.tree, newCommit.tree)
+
+        val files = JSONArray()
+        for (diff in diffs) {
+          val obj = JSONObject()
+          when (diff.changeType) {
+            DiffEntry.ChangeType.ADD -> {
+              obj.put("path", diff.newPath)
+              obj.put("type", "add")
+            }
+            DiffEntry.ChangeType.DELETE -> {
+              obj.put("path", diff.oldPath)
+              obj.put("type", "delete")
+            }
+            DiffEntry.ChangeType.MODIFY -> {
+              obj.put("path", diff.newPath)
+              obj.put("type", "modify")
+            }
+            DiffEntry.ChangeType.RENAME -> {
+              obj.put("path", diff.newPath)
+              obj.put("oldPath", diff.oldPath)
+              obj.put("type", "modify")
+            }
+            DiffEntry.ChangeType.COPY -> {
+              obj.put("path", diff.newPath)
+              obj.put("type", "add")
+            }
+          }
+          files.put(obj)
+        }
+
+        diffFormatter.close()
+        walk.close()
+
+        result.put("ok", true)
+        result.put("files", files)
+      } finally {
+        repo.close()
+      }
+    } catch (e: Exception) {
+      result.put("ok", false)
+      result.put("error", e.message ?: "Unknown error")
+    }
+    return result.toString()
+  }
+
+  // ─── Git discard file changes (JGit) ────────────────────────────
+
+  /**
+   * Discard changes to a specific file by checking out the HEAD version.
+   * If the file doesn't exist in HEAD (new file), delete it from working tree.
+   */
+  fun gitDiscardFileChanges(
+    gitRootDir: String,
+    filepath: String
+  ): String {
+    val result = JSONObject()
+    try {
+      val repo = openRepo(gitRootDir)
+      try {
+        val git = Git(repo)
+        val headId = repo.resolve(Constants.HEAD)
+
+        if (headId != null) {
+          // Check if file exists in HEAD
+          val walk = RevWalk(repo)
+          val commit = walk.parseCommit(headId)
+          val treeWalk = TreeWalk.forPath(repo, filepath, commit.tree)
+          walk.close()
+
+          if (treeWalk != null) {
+            // File exists in HEAD — checkout it
+            git.checkout()
+              .addPath(filepath)
+              .call()
+            result.put("ok", true)
+            result.put("action", "checkout")
+          } else {
+            // File doesn't exist in HEAD — it's untracked, delete it
+            val targetFile = File(File(gitRootDir), filepath)
+            if (targetFile.exists()) {
+              targetFile.delete()
+            }
+            result.put("ok", true)
+            result.put("action", "delete")
+          }
+        } else {
+          result.put("ok", false)
+          result.put("error", "Cannot resolve HEAD")
+        }
+      } finally {
+        repo.close()
+      }
+    } catch (e: Exception) {
+      result.put("ok", false)
+      result.put("error", e.message ?: "Unknown error")
+    }
+    return result.toString()
+  }
 }

package/build/index.d.ts

@@ -203,6 +203,100 @@ interface IExternalStorageModule {
      * @returns JSON string: `{"ok":true,"ref":"abc123"}` or `{"ok":false,"error":"..."}`
      */
     gitReset(gitRootDir: string, ref: string, mode: string): Promise<string>;
+    /**
+     * Clone a remote repository using native JGit.
+     *
+     * @param url          Remote repository URL
+     * @param directory    Destination directory
+     * @param branch       Branch to clone (null for default)
+     * @param depth        Depth for shallow clone (0 for full)
+     * @param singleBranch Whether to clone only the specified branch
+     * @param noTags       Whether to skip fetching tags
+     * @param headers      Optional HTTP headers as JSON string
+     * @returns JSON string: `{"ok":true,"head":"abc123"}` or `{"ok":false,"error":"..."}`
+     */
+    gitClone(url: string, directory: string, branch: string | null, depth: number, singleBranch: boolean, noTags: boolean, headers?: string | null): Promise<string>;
+    /**
+     * Get commit history using native git log.
+     *
+     * @param gitRootDir  Absolute path to the git working directory
+     * @param ref         Branch or ref to start from (null for all)
+     * @param maxCount    Maximum number of commits to return
+     * @returns JSON string: `{"ok":true,"commits":[{"oid","message","authorName","authorEmail","timestamp","parentOids"}]}`
+     */
+    gitLog(gitRootDir: string, ref: string | null, maxCount: number): Promise<string>;
+    /**
+     * Resolve a git reference to its SHA-1 hash.
+     *
+     * @param gitRootDir  Absolute path to the git working directory
+     * @param ref         Reference to resolve (e.g. "HEAD", "refs/heads/main", "origin/main")
+     * @returns JSON string: `{"ok":true,"oid":"abc123"}` or `{"ok":false,"error":"..."}`
+     */
+    gitResolveRef(gitRootDir: string, ref: string): Promise<string>;
+    /**
+     * Get current branch name and branch listings.
+     *
+     * @param gitRootDir  Absolute path to the git working directory
+     * @returns JSON string: `{"ok":true,"branch":"main","isDetached":false,"localBranches":[],"remoteBranches":[]}`
+     */
+    gitCurrentBranch(gitRootDir: string): Promise<string>;
+    /**
+     * Initialize a new git repository.
+     *
+     * @param directory     Directory to initialize
+     * @param defaultBranch Default branch name (e.g. "main")
+     * @returns JSON string: `{"ok":true}` or `{"ok":false,"error":"..."}`
+     */
+    gitInit(directory: string, defaultBranch: string): Promise<string>;
+    /**
+     * Set a git config value.
+     *
+     * @param gitRootDir  Absolute path to the git working directory
+     * @param section     Config section (e.g. "remote")
+     * @param subsection  Config subsection (e.g. "origin"), null for no subsection
+     * @param name        Config key (e.g. "url")
+     * @param value       Config value
+     * @returns JSON string: `{"ok":true}` or `{"ok":false,"error":"..."}`
+     */
+    gitSetConfig(gitRootDir: string, section: string, subsection: string | null, name: string, value: string): Promise<string>;
+    /**
+     * Add a remote to the repository.
+     *
+     * @param gitRootDir  Absolute path to the git working directory
+     * @param remoteName  Remote name (e.g. "origin")
+     * @param url         Remote URL
+     * @returns JSON string: `{"ok":true}` or `{"ok":false,"error":"..."}`
+     */
+    gitAddRemote(gitRootDir: string, remoteName: string, url: string): Promise<string>;
+    /**
+     * Read a file (blob) at a specific commit reference.
+     *
+     * @param gitRootDir  Absolute path to the git working directory
+     * @param ref         Commit ref to read from
+     * @param filepath    Relative path within the repository
+     * @param asBase64    If true, return content as base64; otherwise as utf8 string
+     * @returns JSON string: `{"ok":true,"content":"...","encoding":"base64"|"utf8","size":N}`
+     */
+    gitReadBlob(gitRootDir: string, ref: string, filepath: string, asBase64: boolean): Promise<string>;
+    /**
+     * Diff two commits and return changed files list.
+     * Native equivalent of tree-walking diff.
+     *
+     * @param gitRootDir  Absolute path to the git working directory
+     * @param oldRef      Old commit ref
+     * @param newRef      New commit ref
+     * @returns JSON string: `{"ok":true,"files":[{"path":"...","type":"add"|"modify"|"delete"}]}`
+     */
+    gitDiffTrees(gitRootDir: string, oldRef: string, newRef: string): Promise<string>;
+    /**
+     * Discard uncommitted changes for a specific file.
+     * Checks out the HEAD version, or deletes the file if it's untracked.
+     *
+     * @param gitRootDir  Absolute path to the git working directory
+     * @param filepath    Relative path of the file to discard
+     * @returns JSON string: `{"ok":true,"action":"checkout"|"delete"}` or `{"ok":false,"error":"..."}`
+     */
+    gitDiscardFileChanges(gitRootDir: string, filepath: string): Promise<string>;
 }
 export declare const ExternalStorage: IExternalStorageModule;
 /**

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;AAiPD,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\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;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"]}

package/ios/ExternalStorageModule.swift

@@ -243,6 +243,46 @@ public class ExternalStorageModule: Module {
     AsyncFunction("gitReset") { (gitRootDir: String, ref: String, mode: String) -> String in
       try GitHelper.gitReset(gitRootDir: gitRootDir, ref: ref, mode: mode)
     }
+
+    AsyncFunction("gitClone") { (url: String, directory: String, branch: String?, depth: Int, singleBranch: Bool, noTags: Bool, headers: String?) -> String in
+      try GitHelper.gitClone(url: url, directory: directory, branch: branch, depth: depth, singleBranch: singleBranch, noTags: noTags, headers: headers)
+    }
+
+    AsyncFunction("gitLog") { (gitRootDir: String, ref: String?, maxCount: Int) -> String in
+      try GitHelper.gitLog(gitRootDir: gitRootDir, ref: ref, maxCount: maxCount)
+    }
+
+    AsyncFunction("gitResolveRef") { (gitRootDir: String, ref: String) -> String in
+      try GitHelper.gitResolveRef(gitRootDir: gitRootDir, ref: ref)
+    }
+
+    AsyncFunction("gitCurrentBranch") { (gitRootDir: String) -> String in
+      try GitHelper.gitCurrentBranch(gitRootDir: gitRootDir)
+    }
+
+    AsyncFunction("gitInit") { (directory: String, defaultBranch: String) -> String in
+      try GitHelper.gitInit(directory: directory, defaultBranch: defaultBranch)
+    }
+
+    AsyncFunction("gitSetConfig") { (gitRootDir: String, section: String, subsection: String?, name: String, value: String) -> String in
+      try GitHelper.gitSetConfig(gitRootDir: gitRootDir, section: section, subsection: subsection, name: name, value: value)
+    }
+
+    AsyncFunction("gitAddRemote") { (gitRootDir: String, remoteName: String, url: String) -> String in
+      try GitHelper.gitAddRemote(gitRootDir: gitRootDir, remoteName: remoteName, url: url)
+    }
+
+    AsyncFunction("gitReadBlob") { (gitRootDir: String, ref: String, filepath: String, asBase64: Bool) -> String in
+      try GitHelper.gitReadBlob(gitRootDir: gitRootDir, ref: ref, filepath: filepath, asBase64: asBase64)
+    }
+
+    AsyncFunction("gitDiffTrees") { (gitRootDir: String, oldRef: String, newRef: String) -> String in
+      try GitHelper.gitDiffTrees(gitRootDir: gitRootDir, oldRef: oldRef, newRef: newRef)
+    }
+
+    AsyncFunction("gitDiscardFileChanges") { (gitRootDir: String, filepath: String) -> String in
+      try GitHelper.gitDiscardFileChanges(gitRootDir: gitRootDir, filepath: filepath)
+    }
   }
 
   // ─── Static helpers ──────────────────────────────────────────────

package/ios/GitHelper.swift

@@ -725,6 +725,68 @@ enum GitHelper {
   static func gitReset(
     gitRootDir: String, ref: String, mode: String
   ) throws -> String {
-    return "{\"ok\":false,\"error\":\"Native git reset not available on iOS (no libgit2). Use isomorphic-git fallback.\"}"
+    return "{\"ok\":false,\"error\":\"Native git reset not available on iOS (no libgit2).\"}"
+  }
+
+  static func gitClone(
+    url: String, directory: String, branch: String?, depth: Int,
+    singleBranch: Bool, noTags: Bool, headers: String?
+  ) throws -> String {
+    return "{\"ok\":false,\"error\":\"Native git clone not available on iOS (no libgit2).\"}"
+  }
+
+  static func gitLog(
+    gitRootDir: String, ref: String?, maxCount: Int
+  ) throws -> String {
+    return "{\"ok\":false,\"error\":\"Native git log not available on iOS (no libgit2).\"}"
+  }
+
+  static func gitResolveRef(
+    gitRootDir: String, ref: String
+  ) throws -> String {
+    return "{\"ok\":false,\"error\":\"Native git resolveRef not available on iOS (no libgit2).\"}"
+  }
+
+  static func gitCurrentBranch(
+    gitRootDir: String
+  ) throws -> String {
+    return "{\"ok\":false,\"error\":\"Native git currentBranch not available on iOS (no libgit2).\"}"
+  }
+
+  static func gitInit(
+    directory: String, defaultBranch: String
+  ) throws -> String {
+    return "{\"ok\":false,\"error\":\"Native git init not available on iOS (no libgit2).\"}"
+  }
+
+  static func gitSetConfig(
+    gitRootDir: String, section: String, subsection: String?,
+    name: String, value: String
+  ) throws -> String {
+    return "{\"ok\":false,\"error\":\"Native git setConfig not available on iOS (no libgit2).\"}"
+  }
+
+  static func gitAddRemote(
+    gitRootDir: String, remoteName: String, url: String
+  ) throws -> String {
+    return "{\"ok\":false,\"error\":\"Native git addRemote not available on iOS (no libgit2).\"}"
+  }
+
+  static func gitReadBlob(
+    gitRootDir: String, ref: String, filepath: String, asBase64: Bool
+  ) throws -> String {
+    return "{\"ok\":false,\"error\":\"Native git readBlob not available on iOS (no libgit2).\"}"
+  }
+
+  static func gitDiffTrees(
+    gitRootDir: String, oldRef: String, newRef: String
+  ) throws -> String {
+    return "{\"ok\":false,\"error\":\"Native git diffTrees not available on iOS (no libgit2).\"}"
+  }
+
+  static func gitDiscardFileChanges(
+    gitRootDir: String, filepath: String
+  ) throws -> String {
+    return "{\"ok\":false,\"error\":\"Native git discardFileChanges not available on iOS (no libgit2).\"}"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-tiddlywiki-filesystem-android-external-storage",
-  "version": "2.3.0",
+  "version": "2.4.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

@@ -265,6 +265,110 @@ interface IExternalStorageModule {
    * @returns JSON string: `{"ok":true,"ref":"abc123"}` or `{"ok":false,"error":"..."}`
    */
   gitReset(gitRootDir: string, ref: string, mode: string): Promise<string>;
+
+  /**
+   * Clone a remote repository using native JGit.
+   *
+   * @param url          Remote repository URL
+   * @param directory    Destination directory
+   * @param branch       Branch to clone (null for default)
+   * @param depth        Depth for shallow clone (0 for full)
+   * @param singleBranch Whether to clone only the specified branch
+   * @param noTags       Whether to skip fetching tags
+   * @param headers      Optional HTTP headers as JSON string
+   * @returns JSON string: `{"ok":true,"head":"abc123"}` or `{"ok":false,"error":"..."}`
+   */
+  gitClone(url: string, directory: string, branch: string | null, depth: number, singleBranch: boolean, noTags: boolean, headers?: string | null): Promise<string>;
+
+  /**
+   * Get commit history using native git log.
+   *
+   * @param gitRootDir  Absolute path to the git working directory
+   * @param ref         Branch or ref to start from (null for all)
+   * @param maxCount    Maximum number of commits to return
+   * @returns JSON string: `{"ok":true,"commits":[{"oid","message","authorName","authorEmail","timestamp","parentOids"}]}`
+   */
+  gitLog(gitRootDir: string, ref: string | null, maxCount: number): Promise<string>;
+
+  /**
+   * Resolve a git reference to its SHA-1 hash.
+   *
+   * @param gitRootDir  Absolute path to the git working directory
+   * @param ref         Reference to resolve (e.g. "HEAD", "refs/heads/main", "origin/main")
+   * @returns JSON string: `{"ok":true,"oid":"abc123"}` or `{"ok":false,"error":"..."}`
+   */
+  gitResolveRef(gitRootDir: string, ref: string): Promise<string>;
+
+  /**
+   * Get current branch name and branch listings.
+   *
+   * @param gitRootDir  Absolute path to the git working directory
+   * @returns JSON string: `{"ok":true,"branch":"main","isDetached":false,"localBranches":[],"remoteBranches":[]}`
+   */
+  gitCurrentBranch(gitRootDir: string): Promise<string>;
+
+  /**
+   * Initialize a new git repository.
+   *
+   * @param directory     Directory to initialize
+   * @param defaultBranch Default branch name (e.g. "main")
+   * @returns JSON string: `{"ok":true}` or `{"ok":false,"error":"..."}`
+   */
+  gitInit(directory: string, defaultBranch: string): Promise<string>;
+
+  /**
+   * Set a git config value.
+   *
+   * @param gitRootDir  Absolute path to the git working directory
+   * @param section     Config section (e.g. "remote")
+   * @param subsection  Config subsection (e.g. "origin"), null for no subsection
+   * @param name        Config key (e.g. "url")
+   * @param value       Config value
+   * @returns JSON string: `{"ok":true}` or `{"ok":false,"error":"..."}`
+   */
+  gitSetConfig(gitRootDir: string, section: string, subsection: string | null, name: string, value: string): Promise<string>;
+
+  /**
+   * Add a remote to the repository.
+   *
+   * @param gitRootDir  Absolute path to the git working directory
+   * @param remoteName  Remote name (e.g. "origin")
+   * @param url         Remote URL
+   * @returns JSON string: `{"ok":true}` or `{"ok":false,"error":"..."}`
+   */
+  gitAddRemote(gitRootDir: string, remoteName: string, url: string): Promise<string>;
+
+  /**
+   * Read a file (blob) at a specific commit reference.
+   *
+   * @param gitRootDir  Absolute path to the git working directory
+   * @param ref         Commit ref to read from
+   * @param filepath    Relative path within the repository
+   * @param asBase64    If true, return content as base64; otherwise as utf8 string
+   * @returns JSON string: `{"ok":true,"content":"...","encoding":"base64"|"utf8","size":N}`
+   */
+  gitReadBlob(gitRootDir: string, ref: string, filepath: string, asBase64: boolean): Promise<string>;
+
+  /**
+   * Diff two commits and return changed files list.
+   * Native equivalent of tree-walking diff.
+   *
+   * @param gitRootDir  Absolute path to the git working directory
+   * @param oldRef      Old commit ref
+   * @param newRef      New commit ref
+   * @returns JSON string: `{"ok":true,"files":[{"path":"...","type":"add"|"modify"|"delete"}]}`
+   */
+  gitDiffTrees(gitRootDir: string, oldRef: string, newRef: string): Promise<string>;
+
+  /**
+   * Discard uncommitted changes for a specific file.
+   * Checks out the HEAD version, or deletes the file if it's untracked.
+   *
+   * @param gitRootDir  Absolute path to the git working directory
+   * @param filepath    Relative path of the file to discard
+   * @returns JSON string: `{"ok":true,"action":"checkout"|"delete"}` or `{"ok":false,"error":"..."}`
+   */
+  gitDiscardFileChanges(gitRootDir: string, filepath: string): Promise<string>;
 }
 
 export const ExternalStorage: IExternalStorageModule = new Proxy({} as IExternalStorageModule, {