@qvac/ocr-ggml 0.22.0 → 0.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/ocr-ggml",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "GGML-backed OCR addon for qvac (EasyOCR and DocTR pipelines on GGUF weights)",
   "addon": true,
   "engines": {
@@ -88,11 +88,14 @@
     "prettier": "^3.6.2",
     "prettier-config-holepunch": "^2.0.0",
     "typescript": "^5.9.2",
-    "typescript-eslint": "^8.63.0"
+    "typescript-eslint": "^8.63.0",
+    "cmake-npm": "^1.1.0",
+    "bare-os": "^3.6.2",
+    "bare-url": "^2.1.6"
   },
   "dependencies": {
     "@qvac/error": "^0.1.0",
-    "@qvac/fabric": "^0.10.0",
+    "@qvac/fabric": "^0.14.0",
     "@qvac/infer-base": "^0.6.2",
     "@qvac/logging": "^0.1.0",
     "bare-fetch": "^3.0.1",

package/prebuilds/darwin-x64/qvac__ocr-ggml.bare.exports

@@ -7,7 +7,7 @@
     ],
     "current_versions": [
       {
-        "version": "0.22"
+        "version": "0.24"
       }
     ],
     "exported_symbols": [

package/prebuilds/ios-arm64/qvac__ocr-ggml.bare.exports

@@ -7,7 +7,7 @@
     ],
     "current_versions": [
       {
-        "version": "0.22"
+        "version": "0.24"
       }
     ],
     "exported_symbols": [

package/prebuilds/ios-arm64-simulator/qvac__ocr-ggml.bare.exports

@@ -7,7 +7,7 @@
     ],
     "current_versions": [
       {
-        "version": "0.22"
+        "version": "0.24"
       }
     ],
     "exported_symbols": [

package/prebuilds/ios-x64-simulator/qvac__ocr-ggml.bare.exports

@@ -7,7 +7,7 @@
     ],
     "current_versions": [
       {
-        "version": "0.22"
+        "version": "0.24"
       }
     ],
     "exported_symbols": [

package/test/integration/utils.js

@@ -690,23 +690,55 @@ function prestagedModelPath(modelName) {
   return staged ? staged.src : null
 }
 
+// iOS kills an app that dirties more than 4 GiB in 24h, and there the staged
+// file already sits in the app's own writable Documents dir — so copying it
+// into the model dir spends that whole budget for nothing. Hardlink instead:
+// same inode, zero bytes. On Android the staging dir is a different filesystem,
+// so link() fails EXDEV and we fall back to the copy that has always run there.
+// `link`/`copy` are injectable so that fallback is unit-testable.
+function linkOrCopySync({ src, dest, link = fs.linkSync, copy = fs.copyFileSync }) {
+  // Same path in and out — the staged file IS the destination (a caller whose
+  // model dir is testDir itself). Deleting first would destroy the staged model
+  // and leave both link() and copy() failing ENOENT; the copy this replaced was
+  // a harmless no-op here.
+  if (path.resolve(src) === path.resolve(dest)) return 'link'
+
+  try {
+    fs.unlinkSync(dest)
+  } catch (_) {}
+
+  try {
+    link(src, dest)
+    return 'link'
+  } catch (err) {
+    console.log(
+      `[prestage] hardlink failed on ${platform} (${err.message}); falling back to a byte copy`
+    )
+  }
+
+  copy(src, dest)
+  return 'copy'
+}
+
 // The host pushes an exact byte-count sidecar with each model. Require both the
-// staged source and copied destination to match it so truncated adb/app copies
-// fall through to the network download.
+// staged source and the materialised destination to match it so truncated
+// adb/app transfers fall through to the network download.
 function copyPrestagedModel(modelName, destPath, minBytes = 1024 * 1024) {
   const staged = readPrestagedModel(modelName)
   if (!staged || staged.expectedSize < minBytes) return false
   try {
     const dir = path.dirname(destPath)
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
-    fs.copyFileSync(staged.src, destPath)
+    const how = linkOrCopySync({ src: staged.src, dest: destPath })
     if (fs.statSync(destPath).size === staged.expectedSize) {
-      console.log(`[prestage] Using pre-staged model ${modelName}`)
+      console.log(
+        `[prestage] Using pre-staged model ${modelName} (${how === 'link' ? 'hardlinked' : 'copied'})`
+      )
       return true
     }
     fs.unlinkSync(destPath)
   } catch (err) {
-    console.log(`[prestage] copy of ${modelName} failed: ${err.message}`)
+    console.log(`[prestage] staging of ${modelName} failed: ${err.message}`)
     try {
       fs.unlinkSync(destPath)
     } catch (_) {}
@@ -1418,6 +1450,7 @@ module.exports = {
   ensureModelPath,
   ensureDoctrModels,
   copyPrestagedModel,
+  linkOrCopySync,
   prestagedModelPath,
   GGML_MODELS_DIR,
   formatOCRPerformanceMetrics,