@qvac/sdk 0.6.0 → 0.7.0

package/expo/plugins/patches/android-link.mjs

@@ -0,0 +1,63 @@
+/**
+ * Patched android/link.mjs for manifest-aware native addon linking.
+ *
+ * If qvac/addons.manifest.json exists, only links the allowlisted addons.
+ * Otherwise, falls back to linking all installed addons.
+ *
+ * This file is copied over react-native-bare-kit/android/link.mjs
+ * by withMobileBundle.ts during expo prebuild.
+ */
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import link from "bare-link";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const projectRoot = path.join(__dirname, "..", "..", "..");
+const addonsDir = path.join(__dirname, "src", "main", "addons");
+
+if (fs.existsSync(addonsDir)) {
+  console.log("[QVAC] Cleaning existing addons directory...");
+  fs.rmSync(addonsDir, { recursive: true, force: true });
+}
+
+const manifestPath = path.join(projectRoot, "qvac", "addons.manifest.json");
+
+let pkg = null;
+if (fs.existsSync(manifestPath)) {
+  try {
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+    const addons = Array.isArray(manifest.addons) ? manifest.addons : [];
+
+    if (addons.length > 0) {
+      console.log(
+        `[QVAC] Using addons manifest (${addons.length} addons): ${addons.join(", ")}`,
+      );
+      pkg = {
+        name: "qvac-addon-linker",
+        version: "0.0.0",
+        dependencies: Object.fromEntries(addons.map((name) => [name, "*"])),
+      };
+    } else {
+      console.log("[QVAC] Addons manifest is empty, linking all addons");
+    }
+  } catch (err) {
+    console.warn(
+      "[QVAC] Failed to parse addons manifest, linking all addons:",
+      err.message,
+    );
+  }
+} else {
+  console.log("[QVAC] No addons manifest found, linking all addons");
+}
+
+for await (const resource of link(
+  projectRoot,
+  {
+    target: ["android-arm64", "android-arm", "android-ia32", "android-x64"],
+    out: addonsDir,
+  },
+  pkg,
+)) {
+  console.log("Wrote", resource);
+}

package/expo/plugins/patches/ios-link.mjs

@@ -0,0 +1,63 @@
+/**
+ * Patched ios/link.mjs for manifest-aware native addon linking.
+ *
+ * If qvac/addons.manifest.json exists, only links the allowlisted addons.
+ * Otherwise, falls back to linking all installed addons.
+ *
+ * This file is copied over react-native-bare-kit/ios/link.mjs
+ * by withMobileBundle.ts during expo prebuild.
+ */
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import link from "bare-link";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const projectRoot = path.join(__dirname, "..", "..", "..");
+const addonsDir = path.join(__dirname, "addons");
+
+if (fs.existsSync(addonsDir)) {
+  console.log("[QVAC] Cleaning existing addons directory...");
+  fs.rmSync(addonsDir, { recursive: true, force: true });
+}
+
+const manifestPath = path.join(projectRoot, "qvac", "addons.manifest.json");
+
+let pkg = null;
+if (fs.existsSync(manifestPath)) {
+  try {
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+    const addons = Array.isArray(manifest.addons) ? manifest.addons : [];
+
+    if (addons.length > 0) {
+      console.log(
+        `[QVAC] Using addons manifest (${addons.length} addons): ${addons.join(", ")}`,
+      );
+      pkg = {
+        name: "qvac-addon-linker",
+        version: "0.0.0",
+        dependencies: Object.fromEntries(addons.map((name) => [name, "*"])),
+      };
+    } else {
+      console.log("[QVAC] Addons manifest is empty, linking all addons");
+    }
+  } catch (err) {
+    console.warn(
+      "[QVAC] Failed to parse addons manifest, linking all addons:",
+      err.message,
+    );
+  }
+} else {
+  console.log("[QVAC] No addons manifest found, linking all addons");
+}
+
+for await (const resource of link(
+  projectRoot,
+  {
+    target: ["ios-arm64", "ios-arm64-simulator", "ios-x64-simulator"],
+    out: addonsDir,
+  },
+  pkg,
+)) {
+  console.log("Wrote", resource);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,9 +16,46 @@
       "import": "./dist/server/worker.js",
       "require": "./dist/server/worker.js"
     },
+    "./llamacpp-completion/plugin": {
+      "types": "./dist/server/bare/plugins/llamacpp-completion/plugin.d.ts",
+      "import": "./dist/server/bare/plugins/llamacpp-completion/plugin.js"
+    },
+    "./llamacpp-embedding/plugin": {
+      "types": "./dist/server/bare/plugins/llamacpp-embedding/plugin.d.ts",
+      "import": "./dist/server/bare/plugins/llamacpp-embedding/plugin.js"
+    },
+    "./whispercpp-transcription/plugin": {
+      "types": "./dist/server/bare/plugins/whispercpp-transcription/plugin.d.ts",
+      "import": "./dist/server/bare/plugins/whispercpp-transcription/plugin.js"
+    },
+    "./nmtcpp-translation/plugin": {
+      "types": "./dist/server/bare/plugins/nmtcpp-translation/plugin.d.ts",
+      "import": "./dist/server/bare/plugins/nmtcpp-translation/plugin.js"
+    },
+    "./onnx-tts/plugin": {
+      "types": "./dist/server/bare/plugins/onnx-tts/plugin.d.ts",
+      "import": "./dist/server/bare/plugins/onnx-tts/plugin.js"
+    },
+    "./onnx-ocr/plugin": {
+      "types": "./dist/server/bare/plugins/onnx-ocr/plugin.d.ts",
+      "import": "./dist/server/bare/plugins/onnx-ocr/plugin.js"
+    },
+    "./plugin-utils": {
+      "types": "./dist/schemas/plugin.d.ts",
+      "import": "./dist/schemas/plugin.js"
+    },
     "./expo-plugin": "./dist/expo/plugins/index.js",
     "./worker.mobile.bundle": "./dist/worker.mobile.bundle.js",
-    "./models": "./dist/models/hyperdrive/models.js"
+    "./worker-core": {
+      "import": "./dist/server/worker-core.js"
+    },
+    "./plugins": {
+      "import": "./dist/server/plugins/index.js"
+    },
+    "./logging": {
+      "import": "./dist/logging/index.js"
+    },
+    "./pear-pre": "./dist/pear/pre.js"
   },
   "imports": {
     "#rpc": {
@@ -35,14 +72,19 @@
   "files": [
     "bare-imports.json",
     "dist/**/*",
+    "expo/plugins/patches/**/*",
     "!dist/**/*.map",
     "!**/package-lock.json",
     "!**/yarn.lock",
     "!**/pnpm-lock.yaml",
-    "!**/bun.lock"
+    "!**/bun.lock",
+    "LICENSE",
+    "NOTICE"
   ],
   "scripts": {
     "test:unit": "bun run scripts/run-unit-tests.ts",
+    "test:security": "bun run scripts/run-security-tests.ts",
+    "test:security:bare": "bun run scripts/run-security-tests-bare.ts",
     "lint": "eslint . --max-warnings=0 && bun run typecheck",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "lint:fix": "eslint . --fix",
@@ -61,26 +103,27 @@
     "docs_api:website": "typedoc --out ./docs/api/website --entryPoints index.ts --entryPointStrategy expand --readme none",
     "docs_api:markdown": "typedoc --plugin typedoc-plugin-markdown --out ./docs/api/markdown --entryPoints index.ts --entryPointStrategy expand --readme none && sed -i '1,4d' ./docs/api/markdown/README.md",
     "docs_api": "bun run docs_api:website && bun run docs_api:markdown",
-    "check-models": "node ./scripts/update-models.js --check",
-    "check-models:hook": "node ./scripts/update-models.js --check --non-blocking",
-    "update-models": "node ./scripts/update-models.js",
-    "changelog:generate": "node ./scripts/changelog-generate.cjs && prettier --write changelog",
+    "check-models": "tsx ./models/update-models/index.ts --check",
+    "check-models:hook": "tsx ./models/update-models/index.ts --check --non-blocking",
+    "update-models": "tsx ./models/update-models/index.ts",
+    "changelog:generate": "node ../../scripts/sdk/generate-changelog-sdk-pod.cjs --package=qvac-sdk && prettier --write changelog",
     "docs:gen-pages": "remark \"docs/*.mdx\" --output .docs-build",
     "docs:gen-api": "typedoc --options docs/typedoc.jsonc"
   },
   "dependencies": {
     "@qvac/decoder-audio": "^0.3.3",
     "@qvac/dl-filesystem": "^0.2.0",
-    "@qvac/embed-llamacpp": "^0.10.3",
+    "@qvac/embed-llamacpp": "^0.10.7",
     "@qvac/error": "^0.1.1",
     "@qvac/langdetect-text": "^0.1.0",
-    "@qvac/llm-llamacpp": "^0.8.5",
+    "@qvac/llm-llamacpp": "^0.8.9",
     "@qvac/logging": "^0.1.0",
     "@qvac/ocr-onnx": "^0.1.5",
     "@qvac/rag": "^0.4.2",
     "@qvac/transcription-whispercpp": "^0.3.17",
-    "@qvac/translation-nmtcpp": "^0.3.6",
-    "@qvac/tts-onnx": "^0.2.13",
+    "@qvac/translation-nmtcpp": "^0.3.9",
+    "@qvac/tts-onnx": "^0.5.4",
+    "@qvac/registry-client": "^0.2.0",
     "fast-safe-stringify": "2.1.1",
     "which-runtime": "^1.3.2",
     "zod": "^4.0.17"
@@ -90,10 +133,11 @@
     "@expo/config-plugins": "^54.0.1",
     "@lancedb/lancedb": "^0.21.3",
     "@modelcontextprotocol/sdk": "^1.12.1",
+    "@qvac/cli": "^0.1.3",
     "@sqliteai/sqlite-wasm": "3.50.4-sync.0.8.30-vector.0.9.23",
     "@types/node": "^24.2.1",
     "@types/tar-stream": "^3.1.4",
-    "bare-pack": "^1.5.1",
+    "bare-pack": "^2.0.0",
     "bare-readline": "^1.2.0",
     "brittle": "^3.19.1",
     "chromadb": "^3.0.14",
@@ -107,12 +151,14 @@
     "globals": "^16.3.0",
     "husky": "^9.1.7",
     "hyperdb": "^4.16.1",
+    "pear-pipe": "^1.0.6",
     "prettier": "^3.6.2",
     "react-native-bare-kit": "^0.11.5",
     "remark-cli": "^12.0.1",
     "remark-code-import": "^1.2.0",
     "remark-frontmatter": "^5.0.0",
     "remark-mdx": "^3.1.1",
+    "tsx": "^4.21.0",
     "typedoc": "^0.28.11",
     "typedoc-plugin-frontmatter": "^1.3.1",
     "typedoc-plugin-markdown": "^4.8.1",
@@ -121,6 +167,7 @@
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "@qvac/cli": "^0.1.2",
     "bare-abort-controller": "^1.0.0",
     "bare-buffer": "^3.4.2",
     "bare-crypto": "^1.11.2",
@@ -139,21 +186,30 @@
     "bare-stream": "^2.7.0",
     "bare-subprocess": "^5.2.1",
     "bare-zlib": "^1.3.1",
+    "compact-encoding": "^2.19.0",
     "corestore": "^7.4.5",
     "events": "^3.3.0",
+    "expo-build-properties": ">=0.12.0",
     "expo-device": "^8.0.0",
     "expo-file-system": "^19.0.15",
     "hyperdb": "^4.19.0",
     "hyperdrive": "^13.0.1",
     "hyperswarm": "^4.12.1",
     "llm-splitter": "~0.2.0",
+    "pear-pipe": "^1.0.6",
     "react-native-bare-kit": "^0.11.5",
     "tar-stream": "^3.1.7"
   },
   "peerDependenciesMeta": {
+    "@qvac/cli": {
+      "optional": true
+    },
     "@modelcontextprotocol/sdk": {
       "optional": true
     },
+    "expo-build-properties": {
+      "optional": true
+    },
     "expo-device": {
       "optional": true
     },
@@ -162,6 +218,12 @@
     },
     "react-native-bare-kit": {
       "optional": true
+    },
+    "compact-encoding": {
+      "optional": true
+    },
+    "pear-pipe": {
+      "optional": true
     }
   },
   "patchedDependencies": {},

package/dist/examples/text-to-speech.d.ts

@@ -1,3 +0,0 @@
-export declare function createWav(audioBuffer: number[], sampleRate?: number, filename?: string): void;
-export declare function playAudio(audioBuffer: Buffer): void;
-//# sourceMappingURL=text-to-speech.d.ts.map

package/dist/examples/text-to-speech.js

@@ -1,137 +0,0 @@
-import { loadModel, textToSpeech, unloadModel, TTS_PIPER_NORMAN_EN_US_ONNX_MEDIUM, TTS_PIPER_NORMAN_EN_US_ONNX_MEDIUM_CONFIG, } from "@qvac/sdk";
-import { writeFileSync, unlinkSync } from "fs";
-import { spawnSync } from "child_process";
-import { platform } from "os";
-// Get eSpeakDataPath from command line arguments or use default
-const eSpeakDataPath = process.argv[2];
-console.log(`Using eSpeak data path: ${eSpeakDataPath}`);
-if (!eSpeakDataPath) {
-    console.error("eSpeakDataPath is required");
-    process.exit(1);
-}
-try {
-    const modelId = await loadModel({
-        modelSrc: TTS_PIPER_NORMAN_EN_US_ONNX_MEDIUM,
-        modelType: "tts",
-        configSrc: TTS_PIPER_NORMAN_EN_US_ONNX_MEDIUM_CONFIG,
-        eSpeakDataPath,
-        modelConfig: {
-            language: "en",
-        },
-        onProgress: (progress) => {
-            console.log(progress);
-        },
-    });
-    console.log(`Model loaded: ${modelId}`);
-    // Test TTS
-    console.log("🎵 Testing Text-to-Speech...");
-    const result = textToSpeech({
-        modelId,
-        text: `QVAC SDK is the canonical entry point to QVAC. Written in TypeScript, it provides all QVAC capabilities through a unified interface while also abstracting away the complexity of running your application in a JS environment other than Bare. Supported JS environments include Bare, Node.js, Expo and Bun.`,
-        inputType: "text",
-        stream: false,
-    });
-    const audioBuffer = await result.buffer;
-    console.log(`TTS complete. Total bytes: ${audioBuffer.length}`);
-    // Save and play audio
-    console.log("💾 Saving audio to file...");
-    createWav(audioBuffer, 22050, "tts-output.wav");
-    console.log("✅ Audio saved to tts-output.wav");
-    console.log("🔊 Playing audio...");
-    const audioData = int16ArrayToBuffer(audioBuffer);
-    const wavBuffer = Buffer.concat([
-        createWavHeader(audioData.length),
-        audioData,
-    ]);
-    playAudio(wavBuffer);
-    console.log("✅ Audio playback complete");
-    // Unload the model
-    await unloadModel({ modelId });
-    console.log("Model unloaded");
-}
-catch (error) {
-    console.error("❌ Error:", error);
-    process.exit(1);
-}
-// Function to create WAV header for 16-bit PCM audio
-function createWavHeader(dataLength, sampleRate = 22050) {
-    const header = Buffer.alloc(44);
-    // RIFF header
-    header.write("RIFF", 0);
-    header.writeUInt32LE(36 + dataLength, 4);
-    header.write("WAVE", 8);
-    // fmt chunk
-    header.write("fmt ", 12);
-    header.writeUInt32LE(16, 16); // fmt chunk size
-    header.writeUInt16LE(1, 20); // PCM format
-    header.writeUInt16LE(1, 22); // mono
-    header.writeUInt32LE(sampleRate, 24);
-    header.writeUInt32LE(sampleRate * 2, 28); // byte rate
-    header.writeUInt16LE(2, 32); // block align
-    header.writeUInt16LE(16, 34); // bits per sample
-    // data chunk
-    header.write("data", 36);
-    header.writeUInt32LE(dataLength, 40);
-    return header;
-}
-// Function to convert Int16Array to Buffer
-function int16ArrayToBuffer(int16Array) {
-    const buffer = Buffer.alloc(int16Array.length * 2);
-    for (let i = 0; i < int16Array.length; i++) {
-        const value = int16Array[i] ?? 0;
-        buffer.writeInt16LE(value, i * 2);
-    }
-    return buffer;
-}
-// Function to create and save WAV file (similar to reference implementation)
-export function createWav(audioBuffer, sampleRate = 22050, filename = "output.wav") {
-    const audioData = int16ArrayToBuffer(audioBuffer);
-    const wavHeader = createWavHeader(audioData.length, sampleRate);
-    const wavFile = Buffer.concat([wavHeader, audioData]);
-    writeFileSync(filename, wavFile);
-    console.log(`WAV file saved as: ${filename}`);
-}
-// Function to play audio using system audio players
-export function playAudio(audioBuffer) {
-    const currentPlatform = platform();
-    const tempFile = `/tmp/audio-${Date.now()}.wav`;
-    // Write audio buffer to temporary file
-    writeFileSync(tempFile, audioBuffer);
-    let audioPlayer;
-    let args;
-    switch (currentPlatform) {
-        case "darwin":
-            audioPlayer = "afplay";
-            args = [tempFile];
-            break;
-        case "linux":
-            audioPlayer = "aplay";
-            args = [tempFile];
-            break;
-        case "win32":
-            audioPlayer = "powershell";
-            args = [
-                "-Command",
-                `Add-Type -AssemblyName presentationCore; (New-Object Media.SoundPlayer).LoadStream([System.IO.File]::ReadAllBytes('${tempFile}')).PlaySync()`,
-            ];
-            break;
-        default:
-            audioPlayer = "aplay";
-            args = [tempFile];
-    }
-    const result = spawnSync(audioPlayer, args, {
-        stdio: ["inherit", "inherit", "inherit"],
-    });
-    try {
-        unlinkSync(tempFile);
-    }
-    catch {
-        // Ignore cleanup errors
-    }
-    if (result.error) {
-        throw new Error(`Audio player failed: ${result.error.message}`);
-    }
-    if (result.status !== 0) {
-        throw new Error(`Audio player exited with code ${result.status}`);
-    }
-}