@dvai-bridge/capacitor 4.0.0

package/LICENSE

@@ -0,0 +1,51 @@
+# Deep Voice Ai Limited - Software License Agreement
+
+**Version 1.0.0**
+
+This License Agreement governs the use of the DVAI-Bridge software (the "Software"). By downloading, installing, or using the Software, you agree to be bound by the terms of this License.
+
+---
+
+## 1. LICENSE GRANTS
+
+### 1.1 Development and Personal Use (Free Tier)
+Deep Voice Ai Limited ("Licensor") grants you a non-exclusive, non-transferable, royalty-free license to use the Software solely for:
+- Internal development and testing purposes.
+- Non-commercial personal projects.
+- Academic and non-profit research.
+
+### 1.2 Commercial Use (Paid Tier)
+Any use of the Software for **Commercial Purposes** requires a separate, paid Commercial License from Licensor. "Commercial Purposes" include:
+- Use in production environments.
+- Integration into revenue-generating products or services.
+- Distribution to third-party customers for a fee.
+- Use by an entity with more than $100,000 USD in annual revenue.
+
+To obtain a Commercial License, contact `info@deepvoiceai.co` or visit `https://deepvoiceai.co/licensing`.
+
+---
+
+## 2. RESTRICTIONS
+Except as expressly permitted, you may not:
+- Sublicense, rent, lease, or resell the Software without express permission.
+- Remove any proprietary notices or branding from the Software.
+- Use the Software for any illegal or malicious purposes.
+
+---
+
+## 3. INTELLECTUAL PROPERTY
+The Software is owned by **Deep Voice Ai Limited** and is protected by copyright and intellectual property laws. This agreement does not transfer ownership of the Software.
+
+---
+
+## 4. NO WARRANTY
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE.
+
+---
+
+## 5. GOVERNING LAW
+This License shall be governed by and construed in accordance with the laws of the jurisdiction where Deep Voice Ai Limited is registered.
+
+---
+
+© 2026 Deep Voice Ai Limited. All rights reserved.

package/README.md

@@ -0,0 +1,199 @@
+![DVAI-Bridge](/assets/banner.png)
+
+# DVAI-Bridge
+
+<!-- [![Smoke — real models](https://github.com/Westenets/dvai-bridge/actions/workflows/smoke-real-models.yml/badge.svg?branch=main)](https://github.com/Westenets/dvai-bridge/actions/workflows/smoke-real-models.yml) -->
+
+[![License](https://img.shields.io/badge/License-Commercial-blue.svg)](LICENSE) ![Node.js](https://img.shields.io/badge/Node.js-22+-green?logo=node.js) ![TypeScript](https://img.shields.io/badge/TypeScript-5.6+-blue?logo=typescript) ![Swift](https://img.shields.io/badge/Swift-5.9+-F05138?logo=swift) ![Kotlin](https://img.shields.io/badge/Kotlin-2.0+-7F52FF?logo=kotlin) ![Flutter](https://img.shields.io/badge/Flutter-3.39+-02569B?logo=flutter) ![.NET](https://img.shields.io/badge/.NET-10.0_LTS-512BD4?logo=dotnet)
+
+> **The local OpenAI server you embed inside your app.**
+> One library. One HTTP wire. Every platform. Zero install for your users.
+
+**Docs:** [dvai-bridge.deepvoiceai.co](https://dvai-bridge.deepvoiceai.co)
+
+```ts
+import { DVAI } from "@dvai-bridge/core";
+import OpenAI from "openai";
+
+const dvai = new DVAI({ backend: "transformers" });
+await dvai.initialize();
+
+const openai = new OpenAI({ baseURL: dvai.baseUrl, apiKey: "ignored" });
+await openai.chat.completions.create({
+  model: dvai.transformersModelId,
+  messages: [{ role: "user", content: "Hello!" }],
+});
+```
+
+That's it. A real OpenAI-compatible server is now running inside your app's
+own process. Point any OpenAI client — LangChain, the OpenAI SDK, the Vercel
+AI SDK, anything — at `dvai.baseUrl` and your agent code keeps working.
+
+Built by **[Deep Voice AI](https://deepvoiceai.co)**.
+
+---
+
+## Why it exists
+
+Local AI works beautifully on a laptop with **Ollama + LangChain**. Then you
+try to ship the app and your users don't have Ollama. Mobile can't run it.
+Corporate IT won't add another daemon. So you reinvent the same plumbing —
+spawn an inference engine, bind a port, translate to OpenAI HTTP, handle
+CORS, manage lifecycle, wrap the accelerator of the day per platform — and
+do it all over again for every target OS.
+
+DVAI-Bridge is that plumbing, packaged as a library, for every client
+platform.
+
+---
+
+## What you get
+
+- **One OpenAI HTTP surface.** Bound on `127.0.0.1` (or `0.0.0.0` for
+  device-to-device). Streaming, embeddings, models, recovery — all built in.
+- **Six SDKs.** `@dvai-bridge/core` + `react` + `vanilla` + `capacitor`,
+  `DVAIBridge` (Swift / iOS), `co.deepvoiceai:dvai-bridge` (Kotlin / Android),
+  `@dvai-bridge/react-native`, `dvai_bridge` (Flutter), `co.deepvoiceai.dvai-bridge` (.NET).
+- **Nine backends.** WebLLM, Transformers.js, llama.cpp, Apple Foundation
+  Models, MLX, CoreML / ANE, MediaPipe LLM, LiteRT, ONNX Runtime GenAI —
+  selected per-platform, invisible to your agent code.
+- **Native acceleration** wherever it runs: WebGPU in browsers, CUDA / Metal
+  / Vulkan / DirectML on desktop, ANE / Metal / MLX on iOS, NNAPI / QNN
+  Hexagon / GPU delegate on Android.
+- **Multimodal.** Text, image, audio, video — declarative loader for
+  cutting-edge models (Gemma 4, LLaVA, Idefics) without waiting for library
+  updates.
+- **Distributed inference (v3.0+).** Phone too slow? Offload to your laptop
+  on the same Wi-Fi via mDNS pairing — same OpenAI wire, transparent to
+  your code. Internet path via a self-hostable rendezvous server.
+- **DVAI Hub (v3.1+).** A first-party desktop utility that turns any device
+  into a strong-peer for the rest of your fleet. Brand-neutral install via
+  Homebrew / winget / GitHub Releases, OR fork it for your own branded
+  companion. Routes through Ollama / LM Studio / vLLM / llama-server /
+  llamafile if you've already got those running.
+- **Zero user install.** It's a library, not a daemon. `npm install`,
+  `cocoapods`, gradle — your CI already has the muscle for it.
+
+---
+
+## Supported platforms
+
+| Stack | Package | Backends |
+| --- | --- | --- |
+| Browser (React, Vue, Svelte, vanilla JS) | `@dvai-bridge/core` + `react` / `vanilla` | WebLLM (WebGPU), Transformers.js (WebGPU / WASM SIMD) |
+| Node / Bun / Electron | `@dvai-bridge/core` | Transformers.js, native llama.cpp |
+| Capacitor hybrid mobile | `@dvai-bridge/capacitor` + backend slice | Native llama.cpp (Metal iOS, Vulkan / CPU Android) |
+| iOS native (Swift) | `DVAIBridge` (SPM / CocoaPods) | llama.cpp (Metal), CoreML / ANE, Apple Foundation Models, MLX |
+| Android native (Kotlin / Java) | `co.deepvoiceai:dvai-bridge` (AAR) | llama.cpp, MediaPipe LLM, LiteRT, NNAPI / QNN |
+| React Native (≥0.77, TurboModule) | `@dvai-bridge/react-native` | All iOS + Android backends (delegates) |
+| Flutter (≥3.39) | `dvai_bridge` (pub.dev) | All iOS + Android backends (Pigeon channels) |
+| .NET 10 LTS (MAUI / Avalonia / WinUI / Catalyst / desktop) | `co.deepvoiceai.dvai-bridge*` (NuGet) | iOS / Android delegate to native; desktop = llama.cpp + ONNX Runtime GenAI + ML.NET |
+
+Full quickstart per platform: [dvai-bridge.deepvoiceai.co/guide/getting-started](https://dvai-bridge.deepvoiceai.co/guide/getting-started)
+
+---
+
+## Examples
+
+```ts
+// React
+import { DVAIProvider, useDVAI } from "@dvai-bridge/react";
+<DVAIProvider config={{ backend: "transformers" }}>
+  <Chat />
+</DVAIProvider>;
+function Chat() {
+  const { isReady, baseUrl } = useDVAI();
+  return isReady ? <div>Local AI live at {baseUrl}</div> : <Loading />;
+}
+```
+
+```swift
+// iOS
+let server = try await DVAIBridge.shared.start()
+// server.baseUrl = "http://127.0.0.1:38883/v1"
+```
+
+```kotlin
+// Android
+val server = DVAIBridge.start(context)
+// server.baseUrl = "http://127.0.0.1:38883/v1"
+```
+
+```dart
+// Flutter
+final state = await DVAIBridge.instance.start(
+  backend: BackendKind.auto,
+  modelPath: '/path/to/model.gguf',
+);
+// state.baseUrl = "http://127.0.0.1:38883/v1"
+```
+
+```csharp
+// .NET
+var server = await DVAIBridge.Shared.StartAsync(new StartOptions {
+    Backend = BackendKind.Auto,
+    ModelPath = "/path/to/model.gguf",
+});
+// server.BaseUrl = "http://127.0.0.1:38883/v1"
+```
+
+Multimodal, streaming, embeddings, distributed offload, the Hub —
+everything's at the [docs site](https://dvai-bridge.deepvoiceai.co).
+
+---
+
+## What's new in v3.1
+
+- **DVAI Hub** — Tauri desktop utility that's the strong-peer side of v3
+  distributed inference. `brew install deepvoiceai/dvai-hub/dvai-hub` (or
+  `winget install DeepVoiceAI.DVAIHub`) → mobile apps on the same Wi-Fi
+  pair with it and offload heavy inference. [Guide →](https://dvai-bridge.deepvoiceai.co/guide/dvai-hub)
+- **External-engine bridge.** Hub surfaces Ollama / LM Studio / vLLM /
+  llama-server / llamafile as additional backend pools so paired apps
+  serve from whatever's already cached. Opt-in per engine.
+- **Strict substitution policy.** Models with mismatched family / version /
+  size / type are refused by default; quant-only mismatches gated behind a
+  per-pairing `preferBetterQuant` flag. No silent mis-routing.
+- **HMAC-signed identity** on `/v1/chat/completions`. Per-app audit logs
+  surface who served what, with structured `(appId, peerDeviceId,
+  engine, requestedModel, servedModel, outcome)` rows.
+- **Library finalization.** `httpBindHost` (LAN bind), `chatCompletionInterceptor`
+  (extension point), HMAC primitives re-exported, `/v1/dvai/*` routes
+  actually dispatched, TransformersBackend Node-mode device fix.
+  [Migration v3.0 → v3.1 →](https://dvai-bridge.deepvoiceai.co/migration/v3.0-to-v3.1)
+
+---
+
+## Robustness
+
+Streaming-correct (SSE passthrough + blank-chunk detection), generation
+timeout, automatic engine-state recovery on fatal errors, port fallback,
+worker offloading, Private Network Access ready, CORS configured. The
+boring substrate so your agent code never has to think about it.
+
+---
+
+## Licensing
+
+Dual: **free for development & personal use** on `localhost` (verified at
+runtime). **Commercial use** requires a license key — `info@deepvoiceai.co`.
+
+---
+
+## Contributing
+
+PRs welcome.
+
+```bash
+pnpm install
+pnpm build
+bash scripts/build-all.sh   # full matrix (auto-skips per-host)
+```
+
+[`CONTRIBUTING.md`](./CONTRIBUTING.md) for the PR flow. Per-platform
+contributor docs (iOS / Android / RN / Flutter / .NET) under
+[`docs/development/`](./docs/development/).
+
+---
+
+© Deep Voice AI Limited. All rights reserved.

package/dist/index.cjs

@@ -0,0 +1,203 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DVAIBridge: () => DVAIBridge
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/dispatch.ts
+var import_core = require("@capacitor/core");
+var PLUGIN_NAME_BY_BACKEND = {
+  llama: "DVAIBridgeLlama",
+  foundation: "DVAIBridgeFoundation",
+  mediapipe: "DVAIBridgeMediaPipe",
+  mlx: "DVAIBridgeMLX"
+};
+var activePlugin = null;
+var activeBackend = null;
+function pluginFor(backend) {
+  const name = PLUGIN_NAME_BY_BACKEND[backend];
+  return (0, import_core.registerPlugin)(name);
+}
+function isPluginNotImplementedError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  return /not implemented|not available|UNIMPLEMENTED/i.test(msg);
+}
+function assertBackendCompatibleWithPlatform(backend) {
+  if (backend === "foundation" || backend === "mlx") {
+    let platform;
+    try {
+      platform = import_core.Capacitor?.getPlatform?.();
+    } catch {
+    }
+    if (platform === "android") {
+      const label = backend === "foundation" ? "Apple Foundation Models" : "MLX";
+      throw new Error(
+        `[DVAI] ${label} is iOS-only. Use backend: "llama" or "mediapipe" on Android.`
+      );
+    }
+  }
+}
+var dispatch = {
+  async start(opts) {
+    assertBackendCompatibleWithPlatform(opts.backend);
+    const native = pluginFor(opts.backend);
+    try {
+      const result = await native.start(opts);
+      activePlugin = native;
+      activeBackend = opts.backend;
+      return result;
+    } catch (err) {
+      if (isPluginNotImplementedError(err)) {
+        throw new Error(
+          `[DVAI] Backend "${opts.backend}" selected but the corresponding plugin is not installed. Run: npm install @dvai-bridge/capacitor-${opts.backend} && npx cap sync`
+        );
+      }
+      throw err;
+    }
+  },
+  async stop() {
+    if (!activePlugin) return;
+    try {
+      await activePlugin.stop();
+    } finally {
+      activePlugin = null;
+      activeBackend = null;
+    }
+  },
+  async status() {
+    if (!activePlugin) return { running: false };
+    return activePlugin.status();
+  },
+  __reset() {
+    activePlugin = null;
+    activeBackend = null;
+  },
+  __activePlugin() {
+    return activePlugin;
+  }
+};
+
+// src/index.ts
+var DVAIBridge = {
+  /** Start the embedded HTTP server with the chosen backend. Returns the URL. */
+  async start(opts) {
+    return dispatch.start(opts);
+  },
+  /** Stop the server and unload the model. Idempotent. */
+  async stop() {
+    return dispatch.stop();
+  },
+  /** Status snapshot — useful for UI reactivity. */
+  async status() {
+    return dispatch.status();
+  },
+  /** Subscribe to load/progress events. */
+  async addProgressListener(cb) {
+    const native = dispatch.__activePlugin();
+    if (!native) {
+      throw new Error("[DVAI] addProgressListener called before start()");
+    }
+    return native.addListener("progress", cb);
+  },
+  /**
+   * v3.0+ — distributed inference. Subscribe to one of the bridge's
+   * named event channels. Currently:
+   *
+   *  - `"pairingRequest"`: emitted when an inbound peer requests pairing.
+   *    The handler receives a {@link PairingRequest}; respond via
+   *    {@link respondToPairing}. Default behaviour without a listener
+   *    is to deny inbound pairing requests.
+   *
+   * Must be called after a successful {@link start} — the listener is
+   * dispatched on the active backend plugin, which is established by
+   * `start()`. Calling before `start()` throws.
+   */
+  async addListener(eventName, cb) {
+    if (eventName !== "pairingRequest") {
+      throw new Error(
+        `[DVAI] addListener: unknown event name "${eventName}". Valid: "pairingRequest".`
+      );
+    }
+    const native = dispatch.__activePlugin();
+    if (!native) {
+      throw new Error("[DVAI] addListener called before start()");
+    }
+    return native.addListener("pairingRequest", cb);
+  },
+  /**
+   * v3.0+ — distributed inference. Resolve a pending {@link PairingRequest}
+   * received via the `"pairingRequest"` event. Pass the request `id` and
+   * the user's decision; the native side records the decision and either
+   * lets the pairing proceed or rejects it.
+   *
+   * Idempotent — responding twice to the same `requestId` resolves
+   * cleanly on subsequent calls.
+   */
+  async respondToPairing(requestId, approved) {
+    const native = dispatch.__activePlugin();
+    if (!native) {
+      throw new Error("[DVAI] respondToPairing called before start()");
+    }
+    await native.respondToPairing({ requestId, approved });
+  },
+  /** Resumable, checksum-verified, app-data-cached download. */
+  async downloadModel(opts) {
+    const native = await modelManagementPlugin();
+    return native.downloadModel(opts);
+  },
+  async listCachedModels() {
+    const native = await modelManagementPlugin();
+    const result = await native.listCachedModels();
+    return result.models;
+  },
+  async deleteCachedModel(filename) {
+    const native = await modelManagementPlugin();
+    await native.deleteCachedModel({ filename });
+  },
+  async cacheDir() {
+    const native = await modelManagementPlugin();
+    const result = await native.cacheDir();
+    return result.path;
+  }
+};
+async function modelManagementPlugin() {
+  const active = dispatch.__activePlugin();
+  if (active) return active;
+  const { registerPlugin: registerPlugin2 } = await import("@capacitor/core");
+  return registerPlugin2("DVAIBridgeLlama");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DVAIBridge
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/dispatch.ts"],"sourcesContent":["import { dispatch } from \"./dispatch.js\";\nimport type {\n  StartOptions,\n  StartResult,\n  StatusInfo,\n  ProgressEvent,\n  DownloadOptions,\n  CachedModelInfo,\n  CapacitorBackend,\n  NativePluginInterface,\n  OffloadConfig,\n  PairingRequest,\n  Peer,\n} from \"./types.js\";\n\nexport type {\n  CapacitorBackend,\n  StartOptions,\n  StartResult,\n  StatusInfo,\n  ProgressEvent,\n  DownloadOptions,\n  CachedModelInfo,\n  NativePluginInterface,\n  OffloadConfig,\n  PairingRequest,\n  Peer,\n};\n\nexport const DVAIBridge = {\n  /** Start the embedded HTTP server with the chosen backend. Returns the URL. */\n  async start(opts: StartOptions): Promise<StartResult> {\n    return dispatch.start(opts);\n  },\n\n  /** Stop the server and unload the model. Idempotent. */\n  async stop(): Promise<void> {\n    return dispatch.stop();\n  },\n\n  /** Status snapshot — useful for UI reactivity. */\n  async status(): Promise<StatusInfo> {\n    return dispatch.status();\n  },\n\n  /** Subscribe to load/progress events. */\n  async addProgressListener(\n    cb: (e: ProgressEvent) => void,\n  ): Promise<{ remove: () => Promise<void> }> {\n    const native = dispatch.__activePlugin();\n    if (!native) {\n      throw new Error(\"[DVAI] addProgressListener called before start()\");\n    }\n    return native.addListener(\"progress\", cb);\n  },\n\n  /**\n   * v3.0+ — distributed inference. Subscribe to one of the bridge's\n   * named event channels. Currently:\n   *\n   *  - `\"pairingRequest\"`: emitted when an inbound peer requests pairing.\n   *    The handler receives a {@link PairingRequest}; respond via\n   *    {@link respondToPairing}. Default behaviour without a listener\n   *    is to deny inbound pairing requests.\n   *\n   * Must be called after a successful {@link start} — the listener is\n   * dispatched on the active backend plugin, which is established by\n   * `start()`. Calling before `start()` throws.\n   */\n  async addListener(\n    eventName: \"pairingRequest\",\n    cb: (req: PairingRequest) => void,\n  ): Promise<{ remove: () => Promise<void> }> {\n    if (eventName !== \"pairingRequest\") {\n      throw new Error(\n        `[DVAI] addListener: unknown event name \"${eventName}\". Valid: \"pairingRequest\".`,\n      );\n    }\n    const native = dispatch.__activePlugin();\n    if (!native) {\n      throw new Error(\"[DVAI] addListener called before start()\");\n    }\n    return native.addListener(\"pairingRequest\", cb);\n  },\n\n  /**\n   * v3.0+ — distributed inference. Resolve a pending {@link PairingRequest}\n   * received via the `\"pairingRequest\"` event. Pass the request `id` and\n   * the user's decision; the native side records the decision and either\n   * lets the pairing proceed or rejects it.\n   *\n   * Idempotent — responding twice to the same `requestId` resolves\n   * cleanly on subsequent calls.\n   */\n  async respondToPairing(requestId: string, approved: boolean): Promise<void> {\n    const native = dispatch.__activePlugin();\n    if (!native) {\n      throw new Error(\"[DVAI] respondToPairing called before start()\");\n    }\n    await native.respondToPairing({ requestId, approved });\n  },\n\n  /** Resumable, checksum-verified, app-data-cached download. */\n  async downloadModel(opts: DownloadOptions): Promise<{ path: string; cached: boolean }> {\n    const native = await modelManagementPlugin();\n    return native.downloadModel(opts);\n  },\n\n  async listCachedModels(): Promise<CachedModelInfo[]> {\n    const native = await modelManagementPlugin();\n    const result = await native.listCachedModels();\n    return result.models;\n  },\n\n  async deleteCachedModel(filename: string): Promise<void> {\n    const native = await modelManagementPlugin();\n    await native.deleteCachedModel({ filename });\n  },\n\n  async cacheDir(): Promise<string> {\n    const native = await modelManagementPlugin();\n    const result = await native.cacheDir();\n    return result.path;\n  },\n};\n\n/**\n * Resolve the plugin that owns model-management methods (downloadModel,\n * listCachedModels, deleteCachedModel, cacheDir). In Phase 1, only the\n * `llama` backend implements these — `foundation` rejects (Apple manages\n * models internally) and `mediapipe` rejects (developer-managed paths).\n *\n * If a non-llama plugin is currently active, model management still routes\n * to the llama plugin (caller can install + use it without `start()`).\n * The native side may reject if the plugin isn't installed; the resulting\n * Capacitor \"plugin not implemented\" error is the right surface.\n */\nasync function modelManagementPlugin(): Promise<NativePluginInterface> {\n  const active = dispatch.__activePlugin();\n  if (active) return active;\n  const { registerPlugin } = await import(\"@capacitor/core\");\n  return registerPlugin<NativePluginInterface>(\"DVAIBridgeLlama\");\n}\n","import { Capacitor, registerPlugin } from \"@capacitor/core\";\r\nimport type {\r\n  CapacitorBackend,\r\n  NativePluginInterface,\r\n  StartOptions,\r\n  StartResult,\r\n  StatusInfo,\r\n} from \"./types.js\";\r\n\r\nconst PLUGIN_NAME_BY_BACKEND: Record<CapacitorBackend, string> = {\r\n  llama: \"DVAIBridgeLlama\",\r\n  foundation: \"DVAIBridgeFoundation\",\r\n  mediapipe: \"DVAIBridgeMediaPipe\",\r\n  mlx: \"DVAIBridgeMLX\",\r\n};\r\n\r\nlet activePlugin: NativePluginInterface | null = null;\r\nlet activeBackend: CapacitorBackend | null = null;\r\n\r\nfunction pluginFor(backend: CapacitorBackend): NativePluginInterface {\r\n  const name = PLUGIN_NAME_BY_BACKEND[backend];\r\n  return registerPlugin<NativePluginInterface>(name);\r\n}\r\n\r\nfunction isPluginNotImplementedError(err: unknown): boolean {\r\n  const msg = err instanceof Error ? err.message : String(err);\r\n  return /not implemented|not available|UNIMPLEMENTED/i.test(msg);\r\n}\r\n\r\n/**\r\n * Apple Foundation Models is iOS-only. On Android, no amount of plugin-\r\n * install will help — surface a clear error rather than the generic\r\n * \"install the plugin\" wording from the not-implemented fallback.\r\n */\r\nfunction assertBackendCompatibleWithPlatform(backend: CapacitorBackend): void {\r\n  if (backend === \"foundation\" || backend === \"mlx\") {\r\n    let platform: string | undefined;\r\n    try {\r\n      platform = Capacitor?.getPlatform?.();\r\n    } catch {\r\n      // Capacitor.getPlatform() can throw in non-runtime contexts (SSR,\r\n      // unit tests without the Capacitor shim). Fall through silently —\r\n      // the native call will then surface its own error.\r\n    }\r\n    if (platform === \"android\") {\r\n      const label = backend === \"foundation\" ? \"Apple Foundation Models\" : \"MLX\";\r\n      throw new Error(\r\n        `[DVAI] ${label} is iOS-only. Use backend: \"llama\" or \"mediapipe\" on Android.`,\r\n      );\r\n    }\r\n  }\r\n}\r\n\r\nexport const dispatch = {\r\n  async start(opts: StartOptions): Promise<StartResult> {\r\n    assertBackendCompatibleWithPlatform(opts.backend);\r\n    const native = pluginFor(opts.backend);\r\n    try {\r\n      const result = await native.start(opts);\r\n      activePlugin = native;\r\n      activeBackend = opts.backend;\r\n      return result;\r\n    } catch (err) {\r\n      if (isPluginNotImplementedError(err)) {\r\n        throw new Error(\r\n          `[DVAI] Backend \"${opts.backend}\" selected but the corresponding plugin is not installed. ` +\r\n            `Run: npm install @dvai-bridge/capacitor-${opts.backend} && npx cap sync`,\r\n        );\r\n      }\r\n      throw err;\r\n    }\r\n  },\r\n\r\n  async stop(): Promise<void> {\r\n    if (!activePlugin) return;\r\n    try {\r\n      await activePlugin.stop();\r\n    } finally {\r\n      activePlugin = null;\r\n      activeBackend = null;\r\n    }\r\n  },\r\n\r\n  async status(): Promise<StatusInfo> {\r\n    if (!activePlugin) return { running: false };\r\n    return activePlugin.status();\r\n  },\r\n\r\n  __reset(): void {\r\n    activePlugin = null;\r\n    activeBackend = null;\r\n  },\r\n\r\n  __activePlugin(): NativePluginInterface | null {\r\n    return activePlugin;\r\n  },\r\n};\r\n"],"mappings":"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","names":["registerPlugin"]}

package/dist/index.d.cts

@@ -0,0 +1,297 @@
+/**
+ * @dvai-bridge/capacitor — public type definitions.
+ * These types are also imported by backend plugin packages
+ * (capacitor-llama, capacitor-foundation, capacitor-mediapipe)
+ * to keep the JS↔native contract consistent.
+ */
+type CapacitorBackend = "llama" | "foundation" | "mediapipe" | "mlx";
+interface StartOptions {
+    /** Which native backend plugin to dispatch to. */
+    backend: CapacitorBackend;
+    /** Path to the GGUF model file (llama backend) or .task file (mediapipe). Not used by foundation. */
+    modelPath?: string;
+    /** Optional path to mmproj (vision projector) for llama vision models. */
+    mmprojPath?: string;
+    /** Llama: GPU layers offloaded (default 99 = max). */
+    gpuLayers?: number;
+    /** Llama / mediapipe: context window. */
+    contextSize?: number;
+    /** Llama: CPU threads. */
+    threads?: number;
+    /** Llama: initialize in embedding mode (chat will not work; embeddings will). */
+    embeddingMode?: boolean;
+    /** HTTP server base port; retries +1 up to httpMaxPortAttempts on EADDRINUSE. Default 38883. */
+    httpBasePort?: number;
+    /** Default 16. */
+    httpMaxPortAttempts?: number;
+    /** CORS Access-Control-Allow-Origin. "*", a single origin, or a list. Default "*". */
+    corsOrigin?: string | string[];
+    /** Auto-unload the model when OS emits low-memory warning. Default false. */
+    autoUnloadOnLowMemory?: boolean;
+    /** Native log verbosity. Default "info". */
+    logLevel?: "silent" | "info" | "debug";
+    /**
+     * v3.0+ — distributed inference / device offload.
+     *
+     * When `offload.enabled` is true, the native side runs mDNS discovery
+     * (and optionally a rendezvous WebSocket) to find peer dvai-bridge
+     * instances and offloads inference requests when the local device
+     * can't serve the model fast enough. See
+     * [the distributed-inference guide](https://dvai-bridge.deepvoiceai.co/guide/distributed-inference)
+     * for the full contract.
+     *
+     * Pairing-request UI is surfaced via the `"pairingRequest"` event
+     * (see {@link DVAIBridge.addListener}); the function callback in the
+     * JS-side `OffloadConfig.onPairingRequest` cannot cross the Capacitor
+     * plugin boundary, so consumers use the event surface instead.
+     */
+    offload?: OffloadConfig;
+    /**
+     * v3.2.2+ — path (or fetchable URL) to your DVAI-Bridge license JWT.
+     *
+     * The Capacitor bridge forwards this string to the native backend
+     * plugin (`DVAIBridgeLlama`, `DVAIBridgeFoundation`,
+     * `DVAIBridgeMediaPipe`, `DVAIBridgeMLX`). Each native validator runs
+     * its own offline JWT verification (signature + expiry + audience +
+     * platform binding) against the iOS bundle identifier or Android
+     * package name — see `@dvai-bridge/core/license` for the canonical
+     * JWT format. The validators are authoritative; this JS-side
+     * forwarding is the only plumbing needed.
+     *
+     * Override priority on the native side (matches `DVAIConfig`):
+     *   1. `licenseToken` (below) — inline JWT string, highest priority
+     *   2. `licenseKeyPath` (this field) — explicit path or URL
+     *   3. Platform default locations + env-var fallbacks
+     *
+     * Free-tier behaviour (no license, expired, invalid) is enforced by
+     * the native validator and surfaced via the platform's standard
+     * error channel. The JS layer never inspects this value beyond
+     * forwarding it.
+     */
+    licenseKeyPath?: string;
+    /**
+     * v3.2.2+ — inline DVAI-Bridge license JWT (the full token string).
+     *
+     * Use when injecting the license via runtime config rather than a
+     * bundled file — typical for over-the-air license refresh or when
+     * the same Capacitor binary serves multiple licensees that each
+     * receive their own token from your backend.
+     *
+     * If both `licenseToken` and `licenseKeyPath` are set, `licenseToken`
+     * wins on the native side.
+     */
+    licenseToken?: string;
+}
+/**
+ * v3.0+ — distributed inference / device offload config. Wire-friendly
+ * subset of the JS-side `@dvai-bridge/core` `OffloadConfig` — function
+ * callbacks (`onPairingRequest`, `onOffload`, `customDiscovery`) are not
+ * representable across the Capacitor plugin boundary, so they're surfaced
+ * via {@link DVAIBridge.addListener}'s `"pairingRequest"` channel instead.
+ *
+ * See [the distributed-inference guide](https://dvai-bridge.deepvoiceai.co/guide/distributed-inference)
+ * for the full feature description.
+ */
+interface OffloadConfig {
+    /** Master switch. Default false; offload is opt-in at v3.0. */
+    enabled: boolean;
+    /** Run mDNS to discover LAN peers. Default: true when `enabled`. */
+    discoverLAN?: boolean;
+    /** Below this tok/s, look for a peer. Default: 10. */
+    minLocalCapability?: number;
+    /** Optional rendezvous-server URL — enables internet path if set. */
+    rendezvousUrl?: string;
+    /** Optional pre-known peers (skip discovery). */
+    knownPeers?: Peer[];
+}
+/**
+ * Peer dvai-bridge instance discovered on the LAN or via rendezvous.
+ * Mirrors `@dvai-bridge/core` `Peer` 1:1 across SDKs. Surfaced via
+ * {@link PairingRequest.peer} and consumed via {@link OffloadConfig.knownPeers}.
+ */
+interface Peer {
+    /** Stable per-install device ID of the peer. */
+    deviceId: string;
+    /** Human-readable hint (iOS device name, hostname, etc.). */
+    deviceName: string;
+    /** Library SemVer the peer is running. */
+    dvaiVersion: string;
+    /** OpenAI-compatible base URL the peer's local server exposes. */
+    baseUrl: string;
+    /** Models the peer claims to have loaded right now. */
+    loadedModels: string[];
+    /** Peer-reported capability map: `{ modelId → tok/s }`. Advisory. */
+    capability: Record<string, number>;
+    /** Discovery source. */
+    via: "mdns" | "static" | "rendezvous" | "custom";
+    /** Whether the peer's URL uses TLS. */
+    secure: boolean;
+    /** Last-seen unix ms. */
+    lastSeenAt: number;
+}
+/**
+ * A request for the consumer app to approve (or deny) pairing with a
+ * remote peer. Emitted on the `"pairingRequest"` channel
+ * (see {@link DVAIBridge.addListener}). The consumer calls
+ * {@link DVAIBridge.respondToPairing} with the {@link PairingRequest.id}
+ * and the user's decision.
+ */
+interface PairingRequest {
+    /** Stable id used to correlate the response via {@link DVAIBridge.respondToPairing}. */
+    id: string;
+    /** The peer requesting to pair. */
+    peer: Peer;
+    /**
+     * Convenience accessor for `peer.deviceName`. The migration guide and
+     * iOS `PairingRequest.peerDeviceName` use this name; surfacing it
+     * directly keeps consumer-facing code shorter.
+     */
+    peerDeviceName: string;
+    /** Unix-ms deadline after which the pending request is auto-denied. */
+    expiresAt: number;
+}
+interface StartResult {
+    /** URL the host app passes to its OpenAI SDK. e.g. "http://127.0.0.1:38883/v1". */
+    baseUrl: string;
+    /** Bound HTTP port. */
+    port: number;
+    /** Resolved backend. */
+    backend: CapacitorBackend;
+    /** Model identifier echoed in /v1/models responses. */
+    modelId: string;
+}
+/**
+ * Lifecycle progress event emitted by `addProgressListener`.
+ *
+ * Phase semantics:
+ * - `"download"`: bytes streaming from a remote URL into the on-disk
+ *   `.partial` file. `bytesReceived` / `bytesTotal` / `percent` populated.
+ * - `"verify"`: final sha256 check after download completes (or after a
+ *   resumed `.partial` is rehashed). Usually no byte fields.
+ * - `"load"`: native plugin loading the model into engine memory
+ *   (mmap / GPU upload / etc.). Usually no byte fields; some backends
+ *   may report `percent`.
+ * - `"ready"`: terminal state, model is live and serving.
+ * - `"error"`: terminal state, populated `message` describes the failure.
+ */
+interface ProgressEvent {
+    phase: "download" | "verify" | "load" | "ready" | "error";
+    bytesReceived?: number;
+    bytesTotal?: number;
+    percent?: number;
+    message?: string;
+}
+interface StatusInfo {
+    running: boolean;
+    backend?: CapacitorBackend;
+    baseUrl?: string;
+}
+interface DownloadOptions {
+    /** Source URL (HTTP or HTTPS). */
+    url: string;
+    /** Required SHA-256 of the final file (lowercase hex). */
+    sha256: string;
+    /** Override destination filename. Default: URL basename. */
+    destFilename?: string;
+    /** Extra request headers (e.g. for HuggingFace gated repos). */
+    headers?: Record<string, string>;
+    /** Progress callback. Throttled to ~10 calls/sec. */
+    onProgress?: (e: ProgressEvent) => void;
+}
+interface CachedModelInfo {
+    filename: string;
+    path: string;
+    bytes: number;
+    sha256: string;
+}
+/**
+ * Native plugin interface — what each backend plugin (llama, foundation,
+ * mediapipe) implements on the native side. The JS shim calls these.
+ */
+interface NativePluginInterface {
+    start(options: StartOptions): Promise<StartResult>;
+    stop(): Promise<void>;
+    status(): Promise<StatusInfo>;
+    downloadModel(options: DownloadOptions): Promise<{
+        path: string;
+        cached: boolean;
+    }>;
+    listCachedModels(): Promise<{
+        models: CachedModelInfo[];
+    }>;
+    deleteCachedModel(options: {
+        filename: string;
+    }): Promise<void>;
+    cacheDir(): Promise<{
+        path: string;
+    }>;
+    addListener(eventName: "progress", listenerFunc: (e: ProgressEvent) => void): Promise<{
+        remove: () => Promise<void>;
+    }>;
+    /**
+     * v3.0+ — distributed inference. Subscribe to inbound pairing
+     * requests emitted when a remote peer wants to pair with this device.
+     * Consumers respond by calling {@link respondToPairing} with the
+     * request's `id` and a boolean decision.
+     */
+    addListener(eventName: "pairingRequest", listenerFunc: (req: PairingRequest) => void): Promise<{
+        remove: () => Promise<void>;
+    }>;
+    /**
+     * v3.0+ — distributed inference. Resolve a pending {@link PairingRequest}
+     * by `id`. Idempotent — responding twice resolves cleanly.
+     */
+    respondToPairing(options: {
+        requestId: string;
+        approved: boolean;
+    }): Promise<void>;
+}
+
+declare const DVAIBridge: {
+    /** Start the embedded HTTP server with the chosen backend. Returns the URL. */
+    start(opts: StartOptions): Promise<StartResult>;
+    /** Stop the server and unload the model. Idempotent. */
+    stop(): Promise<void>;
+    /** Status snapshot — useful for UI reactivity. */
+    status(): Promise<StatusInfo>;
+    /** Subscribe to load/progress events. */
+    addProgressListener(cb: (e: ProgressEvent) => void): Promise<{
+        remove: () => Promise<void>;
+    }>;
+    /**
+     * v3.0+ — distributed inference. Subscribe to one of the bridge's
+     * named event channels. Currently:
+     *
+     *  - `"pairingRequest"`: emitted when an inbound peer requests pairing.
+     *    The handler receives a {@link PairingRequest}; respond via
+     *    {@link respondToPairing}. Default behaviour without a listener
+     *    is to deny inbound pairing requests.
+     *
+     * Must be called after a successful {@link start} — the listener is
+     * dispatched on the active backend plugin, which is established by
+     * `start()`. Calling before `start()` throws.
+     */
+    addListener(eventName: "pairingRequest", cb: (req: PairingRequest) => void): Promise<{
+        remove: () => Promise<void>;
+    }>;
+    /**
+     * v3.0+ — distributed inference. Resolve a pending {@link PairingRequest}
+     * received via the `"pairingRequest"` event. Pass the request `id` and
+     * the user's decision; the native side records the decision and either
+     * lets the pairing proceed or rejects it.
+     *
+     * Idempotent — responding twice to the same `requestId` resolves
+     * cleanly on subsequent calls.
+     */
+    respondToPairing(requestId: string, approved: boolean): Promise<void>;
+    /** Resumable, checksum-verified, app-data-cached download. */
+    downloadModel(opts: DownloadOptions): Promise<{
+        path: string;
+        cached: boolean;
+    }>;
+    listCachedModels(): Promise<CachedModelInfo[]>;
+    deleteCachedModel(filename: string): Promise<void>;
+    cacheDir(): Promise<string>;
+};
+
+export { type CachedModelInfo, type CapacitorBackend, DVAIBridge, type DownloadOptions, type NativePluginInterface, type OffloadConfig, type PairingRequest, type Peer, type ProgressEvent, type StartOptions, type StartResult, type StatusInfo };

package/dist/index.d.ts

@@ -0,0 +1,297 @@
+/**
+ * @dvai-bridge/capacitor — public type definitions.
+ * These types are also imported by backend plugin packages
+ * (capacitor-llama, capacitor-foundation, capacitor-mediapipe)
+ * to keep the JS↔native contract consistent.
+ */
+type CapacitorBackend = "llama" | "foundation" | "mediapipe" | "mlx";
+interface StartOptions {
+    /** Which native backend plugin to dispatch to. */
+    backend: CapacitorBackend;
+    /** Path to the GGUF model file (llama backend) or .task file (mediapipe). Not used by foundation. */
+    modelPath?: string;
+    /** Optional path to mmproj (vision projector) for llama vision models. */
+    mmprojPath?: string;
+    /** Llama: GPU layers offloaded (default 99 = max). */
+    gpuLayers?: number;
+    /** Llama / mediapipe: context window. */
+    contextSize?: number;
+    /** Llama: CPU threads. */
+    threads?: number;
+    /** Llama: initialize in embedding mode (chat will not work; embeddings will). */
+    embeddingMode?: boolean;
+    /** HTTP server base port; retries +1 up to httpMaxPortAttempts on EADDRINUSE. Default 38883. */
+    httpBasePort?: number;
+    /** Default 16. */
+    httpMaxPortAttempts?: number;
+    /** CORS Access-Control-Allow-Origin. "*", a single origin, or a list. Default "*". */
+    corsOrigin?: string | string[];
+    /** Auto-unload the model when OS emits low-memory warning. Default false. */
+    autoUnloadOnLowMemory?: boolean;
+    /** Native log verbosity. Default "info". */
+    logLevel?: "silent" | "info" | "debug";
+    /**
+     * v3.0+ — distributed inference / device offload.
+     *
+     * When `offload.enabled` is true, the native side runs mDNS discovery
+     * (and optionally a rendezvous WebSocket) to find peer dvai-bridge
+     * instances and offloads inference requests when the local device
+     * can't serve the model fast enough. See
+     * [the distributed-inference guide](https://dvai-bridge.deepvoiceai.co/guide/distributed-inference)
+     * for the full contract.
+     *
+     * Pairing-request UI is surfaced via the `"pairingRequest"` event
+     * (see {@link DVAIBridge.addListener}); the function callback in the
+     * JS-side `OffloadConfig.onPairingRequest` cannot cross the Capacitor
+     * plugin boundary, so consumers use the event surface instead.
+     */
+    offload?: OffloadConfig;
+    /**
+     * v3.2.2+ — path (or fetchable URL) to your DVAI-Bridge license JWT.
+     *
+     * The Capacitor bridge forwards this string to the native backend
+     * plugin (`DVAIBridgeLlama`, `DVAIBridgeFoundation`,
+     * `DVAIBridgeMediaPipe`, `DVAIBridgeMLX`). Each native validator runs
+     * its own offline JWT verification (signature + expiry + audience +
+     * platform binding) against the iOS bundle identifier or Android
+     * package name — see `@dvai-bridge/core/license` for the canonical
+     * JWT format. The validators are authoritative; this JS-side
+     * forwarding is the only plumbing needed.
+     *
+     * Override priority on the native side (matches `DVAIConfig`):
+     *   1. `licenseToken` (below) — inline JWT string, highest priority
+     *   2. `licenseKeyPath` (this field) — explicit path or URL
+     *   3. Platform default locations + env-var fallbacks
+     *
+     * Free-tier behaviour (no license, expired, invalid) is enforced by
+     * the native validator and surfaced via the platform's standard
+     * error channel. The JS layer never inspects this value beyond
+     * forwarding it.
+     */
+    licenseKeyPath?: string;
+    /**
+     * v3.2.2+ — inline DVAI-Bridge license JWT (the full token string).
+     *
+     * Use when injecting the license via runtime config rather than a
+     * bundled file — typical for over-the-air license refresh or when
+     * the same Capacitor binary serves multiple licensees that each
+     * receive their own token from your backend.
+     *
+     * If both `licenseToken` and `licenseKeyPath` are set, `licenseToken`
+     * wins on the native side.
+     */
+    licenseToken?: string;
+}
+/**
+ * v3.0+ — distributed inference / device offload config. Wire-friendly
+ * subset of the JS-side `@dvai-bridge/core` `OffloadConfig` — function
+ * callbacks (`onPairingRequest`, `onOffload`, `customDiscovery`) are not
+ * representable across the Capacitor plugin boundary, so they're surfaced
+ * via {@link DVAIBridge.addListener}'s `"pairingRequest"` channel instead.
+ *
+ * See [the distributed-inference guide](https://dvai-bridge.deepvoiceai.co/guide/distributed-inference)
+ * for the full feature description.
+ */
+interface OffloadConfig {
+    /** Master switch. Default false; offload is opt-in at v3.0. */
+    enabled: boolean;
+    /** Run mDNS to discover LAN peers. Default: true when `enabled`. */
+    discoverLAN?: boolean;
+    /** Below this tok/s, look for a peer. Default: 10. */
+    minLocalCapability?: number;
+    /** Optional rendezvous-server URL — enables internet path if set. */
+    rendezvousUrl?: string;
+    /** Optional pre-known peers (skip discovery). */
+    knownPeers?: Peer[];
+}
+/**
+ * Peer dvai-bridge instance discovered on the LAN or via rendezvous.
+ * Mirrors `@dvai-bridge/core` `Peer` 1:1 across SDKs. Surfaced via
+ * {@link PairingRequest.peer} and consumed via {@link OffloadConfig.knownPeers}.
+ */
+interface Peer {
+    /** Stable per-install device ID of the peer. */
+    deviceId: string;
+    /** Human-readable hint (iOS device name, hostname, etc.). */
+    deviceName: string;
+    /** Library SemVer the peer is running. */
+    dvaiVersion: string;
+    /** OpenAI-compatible base URL the peer's local server exposes. */
+    baseUrl: string;
+    /** Models the peer claims to have loaded right now. */
+    loadedModels: string[];
+    /** Peer-reported capability map: `{ modelId → tok/s }`. Advisory. */
+    capability: Record<string, number>;
+    /** Discovery source. */
+    via: "mdns" | "static" | "rendezvous" | "custom";
+    /** Whether the peer's URL uses TLS. */
+    secure: boolean;
+    /** Last-seen unix ms. */
+    lastSeenAt: number;
+}
+/**
+ * A request for the consumer app to approve (or deny) pairing with a
+ * remote peer. Emitted on the `"pairingRequest"` channel
+ * (see {@link DVAIBridge.addListener}). The consumer calls
+ * {@link DVAIBridge.respondToPairing} with the {@link PairingRequest.id}
+ * and the user's decision.
+ */
+interface PairingRequest {
+    /** Stable id used to correlate the response via {@link DVAIBridge.respondToPairing}. */
+    id: string;
+    /** The peer requesting to pair. */
+    peer: Peer;
+    /**
+     * Convenience accessor for `peer.deviceName`. The migration guide and
+     * iOS `PairingRequest.peerDeviceName` use this name; surfacing it
+     * directly keeps consumer-facing code shorter.
+     */
+    peerDeviceName: string;
+    /** Unix-ms deadline after which the pending request is auto-denied. */
+    expiresAt: number;
+}
+interface StartResult {
+    /** URL the host app passes to its OpenAI SDK. e.g. "http://127.0.0.1:38883/v1". */
+    baseUrl: string;
+    /** Bound HTTP port. */
+    port: number;
+    /** Resolved backend. */
+    backend: CapacitorBackend;
+    /** Model identifier echoed in /v1/models responses. */
+    modelId: string;
+}
+/**
+ * Lifecycle progress event emitted by `addProgressListener`.
+ *
+ * Phase semantics:
+ * - `"download"`: bytes streaming from a remote URL into the on-disk
+ *   `.partial` file. `bytesReceived` / `bytesTotal` / `percent` populated.
+ * - `"verify"`: final sha256 check after download completes (or after a
+ *   resumed `.partial` is rehashed). Usually no byte fields.
+ * - `"load"`: native plugin loading the model into engine memory
+ *   (mmap / GPU upload / etc.). Usually no byte fields; some backends
+ *   may report `percent`.
+ * - `"ready"`: terminal state, model is live and serving.
+ * - `"error"`: terminal state, populated `message` describes the failure.
+ */
+interface ProgressEvent {
+    phase: "download" | "verify" | "load" | "ready" | "error";
+    bytesReceived?: number;
+    bytesTotal?: number;
+    percent?: number;
+    message?: string;
+}
+interface StatusInfo {
+    running: boolean;
+    backend?: CapacitorBackend;
+    baseUrl?: string;
+}
+interface DownloadOptions {
+    /** Source URL (HTTP or HTTPS). */
+    url: string;
+    /** Required SHA-256 of the final file (lowercase hex). */
+    sha256: string;
+    /** Override destination filename. Default: URL basename. */
+    destFilename?: string;
+    /** Extra request headers (e.g. for HuggingFace gated repos). */
+    headers?: Record<string, string>;
+    /** Progress callback. Throttled to ~10 calls/sec. */
+    onProgress?: (e: ProgressEvent) => void;
+}
+interface CachedModelInfo {
+    filename: string;
+    path: string;
+    bytes: number;
+    sha256: string;
+}
+/**
+ * Native plugin interface — what each backend plugin (llama, foundation,
+ * mediapipe) implements on the native side. The JS shim calls these.
+ */
+interface NativePluginInterface {
+    start(options: StartOptions): Promise<StartResult>;
+    stop(): Promise<void>;
+    status(): Promise<StatusInfo>;
+    downloadModel(options: DownloadOptions): Promise<{
+        path: string;
+        cached: boolean;
+    }>;
+    listCachedModels(): Promise<{
+        models: CachedModelInfo[];
+    }>;
+    deleteCachedModel(options: {
+        filename: string;
+    }): Promise<void>;
+    cacheDir(): Promise<{
+        path: string;
+    }>;
+    addListener(eventName: "progress", listenerFunc: (e: ProgressEvent) => void): Promise<{
+        remove: () => Promise<void>;
+    }>;
+    /**
+     * v3.0+ — distributed inference. Subscribe to inbound pairing
+     * requests emitted when a remote peer wants to pair with this device.
+     * Consumers respond by calling {@link respondToPairing} with the
+     * request's `id` and a boolean decision.
+     */
+    addListener(eventName: "pairingRequest", listenerFunc: (req: PairingRequest) => void): Promise<{
+        remove: () => Promise<void>;
+    }>;
+    /**
+     * v3.0+ — distributed inference. Resolve a pending {@link PairingRequest}
+     * by `id`. Idempotent — responding twice resolves cleanly.
+     */
+    respondToPairing(options: {
+        requestId: string;
+        approved: boolean;
+    }): Promise<void>;
+}
+
+declare const DVAIBridge: {
+    /** Start the embedded HTTP server with the chosen backend. Returns the URL. */
+    start(opts: StartOptions): Promise<StartResult>;
+    /** Stop the server and unload the model. Idempotent. */
+    stop(): Promise<void>;
+    /** Status snapshot — useful for UI reactivity. */
+    status(): Promise<StatusInfo>;
+    /** Subscribe to load/progress events. */
+    addProgressListener(cb: (e: ProgressEvent) => void): Promise<{
+        remove: () => Promise<void>;
+    }>;
+    /**
+     * v3.0+ — distributed inference. Subscribe to one of the bridge's
+     * named event channels. Currently:
+     *
+     *  - `"pairingRequest"`: emitted when an inbound peer requests pairing.
+     *    The handler receives a {@link PairingRequest}; respond via
+     *    {@link respondToPairing}. Default behaviour without a listener
+     *    is to deny inbound pairing requests.
+     *
+     * Must be called after a successful {@link start} — the listener is
+     * dispatched on the active backend plugin, which is established by
+     * `start()`. Calling before `start()` throws.
+     */
+    addListener(eventName: "pairingRequest", cb: (req: PairingRequest) => void): Promise<{
+        remove: () => Promise<void>;
+    }>;
+    /**
+     * v3.0+ — distributed inference. Resolve a pending {@link PairingRequest}
+     * received via the `"pairingRequest"` event. Pass the request `id` and
+     * the user's decision; the native side records the decision and either
+     * lets the pairing proceed or rejects it.
+     *
+     * Idempotent — responding twice to the same `requestId` resolves
+     * cleanly on subsequent calls.
+     */
+    respondToPairing(requestId: string, approved: boolean): Promise<void>;
+    /** Resumable, checksum-verified, app-data-cached download. */
+    downloadModel(opts: DownloadOptions): Promise<{
+        path: string;
+        cached: boolean;
+    }>;
+    listCachedModels(): Promise<CachedModelInfo[]>;
+    deleteCachedModel(filename: string): Promise<void>;
+    cacheDir(): Promise<string>;
+};
+
+export { type CachedModelInfo, type CapacitorBackend, DVAIBridge, type DownloadOptions, type NativePluginInterface, type OffloadConfig, type PairingRequest, type Peer, type ProgressEvent, type StartOptions, type StartResult, type StatusInfo };

package/dist/index.js

@@ -0,0 +1,166 @@
+// src/dispatch.ts
+import { Capacitor, registerPlugin } from "@capacitor/core";
+var PLUGIN_NAME_BY_BACKEND = {
+  llama: "DVAIBridgeLlama",
+  foundation: "DVAIBridgeFoundation",
+  mediapipe: "DVAIBridgeMediaPipe",
+  mlx: "DVAIBridgeMLX"
+};
+var activePlugin = null;
+var activeBackend = null;
+function pluginFor(backend) {
+  const name = PLUGIN_NAME_BY_BACKEND[backend];
+  return registerPlugin(name);
+}
+function isPluginNotImplementedError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  return /not implemented|not available|UNIMPLEMENTED/i.test(msg);
+}
+function assertBackendCompatibleWithPlatform(backend) {
+  if (backend === "foundation" || backend === "mlx") {
+    let platform;
+    try {
+      platform = Capacitor?.getPlatform?.();
+    } catch {
+    }
+    if (platform === "android") {
+      const label = backend === "foundation" ? "Apple Foundation Models" : "MLX";
+      throw new Error(
+        `[DVAI] ${label} is iOS-only. Use backend: "llama" or "mediapipe" on Android.`
+      );
+    }
+  }
+}
+var dispatch = {
+  async start(opts) {
+    assertBackendCompatibleWithPlatform(opts.backend);
+    const native = pluginFor(opts.backend);
+    try {
+      const result = await native.start(opts);
+      activePlugin = native;
+      activeBackend = opts.backend;
+      return result;
+    } catch (err) {
+      if (isPluginNotImplementedError(err)) {
+        throw new Error(
+          `[DVAI] Backend "${opts.backend}" selected but the corresponding plugin is not installed. Run: npm install @dvai-bridge/capacitor-${opts.backend} && npx cap sync`
+        );
+      }
+      throw err;
+    }
+  },
+  async stop() {
+    if (!activePlugin) return;
+    try {
+      await activePlugin.stop();
+    } finally {
+      activePlugin = null;
+      activeBackend = null;
+    }
+  },
+  async status() {
+    if (!activePlugin) return { running: false };
+    return activePlugin.status();
+  },
+  __reset() {
+    activePlugin = null;
+    activeBackend = null;
+  },
+  __activePlugin() {
+    return activePlugin;
+  }
+};
+
+// src/index.ts
+var DVAIBridge = {
+  /** Start the embedded HTTP server with the chosen backend. Returns the URL. */
+  async start(opts) {
+    return dispatch.start(opts);
+  },
+  /** Stop the server and unload the model. Idempotent. */
+  async stop() {
+    return dispatch.stop();
+  },
+  /** Status snapshot — useful for UI reactivity. */
+  async status() {
+    return dispatch.status();
+  },
+  /** Subscribe to load/progress events. */
+  async addProgressListener(cb) {
+    const native = dispatch.__activePlugin();
+    if (!native) {
+      throw new Error("[DVAI] addProgressListener called before start()");
+    }
+    return native.addListener("progress", cb);
+  },
+  /**
+   * v3.0+ — distributed inference. Subscribe to one of the bridge's
+   * named event channels. Currently:
+   *
+   *  - `"pairingRequest"`: emitted when an inbound peer requests pairing.
+   *    The handler receives a {@link PairingRequest}; respond via
+   *    {@link respondToPairing}. Default behaviour without a listener
+   *    is to deny inbound pairing requests.
+   *
+   * Must be called after a successful {@link start} — the listener is
+   * dispatched on the active backend plugin, which is established by
+   * `start()`. Calling before `start()` throws.
+   */
+  async addListener(eventName, cb) {
+    if (eventName !== "pairingRequest") {
+      throw new Error(
+        `[DVAI] addListener: unknown event name "${eventName}". Valid: "pairingRequest".`
+      );
+    }
+    const native = dispatch.__activePlugin();
+    if (!native) {
+      throw new Error("[DVAI] addListener called before start()");
+    }
+    return native.addListener("pairingRequest", cb);
+  },
+  /**
+   * v3.0+ — distributed inference. Resolve a pending {@link PairingRequest}
+   * received via the `"pairingRequest"` event. Pass the request `id` and
+   * the user's decision; the native side records the decision and either
+   * lets the pairing proceed or rejects it.
+   *
+   * Idempotent — responding twice to the same `requestId` resolves
+   * cleanly on subsequent calls.
+   */
+  async respondToPairing(requestId, approved) {
+    const native = dispatch.__activePlugin();
+    if (!native) {
+      throw new Error("[DVAI] respondToPairing called before start()");
+    }
+    await native.respondToPairing({ requestId, approved });
+  },
+  /** Resumable, checksum-verified, app-data-cached download. */
+  async downloadModel(opts) {
+    const native = await modelManagementPlugin();
+    return native.downloadModel(opts);
+  },
+  async listCachedModels() {
+    const native = await modelManagementPlugin();
+    const result = await native.listCachedModels();
+    return result.models;
+  },
+  async deleteCachedModel(filename) {
+    const native = await modelManagementPlugin();
+    await native.deleteCachedModel({ filename });
+  },
+  async cacheDir() {
+    const native = await modelManagementPlugin();
+    const result = await native.cacheDir();
+    return result.path;
+  }
+};
+async function modelManagementPlugin() {
+  const active = dispatch.__activePlugin();
+  if (active) return active;
+  const { registerPlugin: registerPlugin2 } = await import("@capacitor/core");
+  return registerPlugin2("DVAIBridgeLlama");
+}
+export {
+  DVAIBridge
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dispatch.ts","../src/index.ts"],"sourcesContent":["import { Capacitor, registerPlugin } from \"@capacitor/core\";\r\nimport type {\r\n  CapacitorBackend,\r\n  NativePluginInterface,\r\n  StartOptions,\r\n  StartResult,\r\n  StatusInfo,\r\n} from \"./types.js\";\r\n\r\nconst PLUGIN_NAME_BY_BACKEND: Record<CapacitorBackend, string> = {\r\n  llama: \"DVAIBridgeLlama\",\r\n  foundation: \"DVAIBridgeFoundation\",\r\n  mediapipe: \"DVAIBridgeMediaPipe\",\r\n  mlx: \"DVAIBridgeMLX\",\r\n};\r\n\r\nlet activePlugin: NativePluginInterface | null = null;\r\nlet activeBackend: CapacitorBackend | null = null;\r\n\r\nfunction pluginFor(backend: CapacitorBackend): NativePluginInterface {\r\n  const name = PLUGIN_NAME_BY_BACKEND[backend];\r\n  return registerPlugin<NativePluginInterface>(name);\r\n}\r\n\r\nfunction isPluginNotImplementedError(err: unknown): boolean {\r\n  const msg = err instanceof Error ? err.message : String(err);\r\n  return /not implemented|not available|UNIMPLEMENTED/i.test(msg);\r\n}\r\n\r\n/**\r\n * Apple Foundation Models is iOS-only. On Android, no amount of plugin-\r\n * install will help — surface a clear error rather than the generic\r\n * \"install the plugin\" wording from the not-implemented fallback.\r\n */\r\nfunction assertBackendCompatibleWithPlatform(backend: CapacitorBackend): void {\r\n  if (backend === \"foundation\" || backend === \"mlx\") {\r\n    let platform: string | undefined;\r\n    try {\r\n      platform = Capacitor?.getPlatform?.();\r\n    } catch {\r\n      // Capacitor.getPlatform() can throw in non-runtime contexts (SSR,\r\n      // unit tests without the Capacitor shim). Fall through silently —\r\n      // the native call will then surface its own error.\r\n    }\r\n    if (platform === \"android\") {\r\n      const label = backend === \"foundation\" ? \"Apple Foundation Models\" : \"MLX\";\r\n      throw new Error(\r\n        `[DVAI] ${label} is iOS-only. Use backend: \"llama\" or \"mediapipe\" on Android.`,\r\n      );\r\n    }\r\n  }\r\n}\r\n\r\nexport const dispatch = {\r\n  async start(opts: StartOptions): Promise<StartResult> {\r\n    assertBackendCompatibleWithPlatform(opts.backend);\r\n    const native = pluginFor(opts.backend);\r\n    try {\r\n      const result = await native.start(opts);\r\n      activePlugin = native;\r\n      activeBackend = opts.backend;\r\n      return result;\r\n    } catch (err) {\r\n      if (isPluginNotImplementedError(err)) {\r\n        throw new Error(\r\n          `[DVAI] Backend \"${opts.backend}\" selected but the corresponding plugin is not installed. ` +\r\n            `Run: npm install @dvai-bridge/capacitor-${opts.backend} && npx cap sync`,\r\n        );\r\n      }\r\n      throw err;\r\n    }\r\n  },\r\n\r\n  async stop(): Promise<void> {\r\n    if (!activePlugin) return;\r\n    try {\r\n      await activePlugin.stop();\r\n    } finally {\r\n      activePlugin = null;\r\n      activeBackend = null;\r\n    }\r\n  },\r\n\r\n  async status(): Promise<StatusInfo> {\r\n    if (!activePlugin) return { running: false };\r\n    return activePlugin.status();\r\n  },\r\n\r\n  __reset(): void {\r\n    activePlugin = null;\r\n    activeBackend = null;\r\n  },\r\n\r\n  __activePlugin(): NativePluginInterface | null {\r\n    return activePlugin;\r\n  },\r\n};\r\n","import { dispatch } from \"./dispatch.js\";\nimport type {\n  StartOptions,\n  StartResult,\n  StatusInfo,\n  ProgressEvent,\n  DownloadOptions,\n  CachedModelInfo,\n  CapacitorBackend,\n  NativePluginInterface,\n  OffloadConfig,\n  PairingRequest,\n  Peer,\n} from \"./types.js\";\n\nexport type {\n  CapacitorBackend,\n  StartOptions,\n  StartResult,\n  StatusInfo,\n  ProgressEvent,\n  DownloadOptions,\n  CachedModelInfo,\n  NativePluginInterface,\n  OffloadConfig,\n  PairingRequest,\n  Peer,\n};\n\nexport const DVAIBridge = {\n  /** Start the embedded HTTP server with the chosen backend. Returns the URL. */\n  async start(opts: StartOptions): Promise<StartResult> {\n    return dispatch.start(opts);\n  },\n\n  /** Stop the server and unload the model. Idempotent. */\n  async stop(): Promise<void> {\n    return dispatch.stop();\n  },\n\n  /** Status snapshot — useful for UI reactivity. */\n  async status(): Promise<StatusInfo> {\n    return dispatch.status();\n  },\n\n  /** Subscribe to load/progress events. */\n  async addProgressListener(\n    cb: (e: ProgressEvent) => void,\n  ): Promise<{ remove: () => Promise<void> }> {\n    const native = dispatch.__activePlugin();\n    if (!native) {\n      throw new Error(\"[DVAI] addProgressListener called before start()\");\n    }\n    return native.addListener(\"progress\", cb);\n  },\n\n  /**\n   * v3.0+ — distributed inference. Subscribe to one of the bridge's\n   * named event channels. Currently:\n   *\n   *  - `\"pairingRequest\"`: emitted when an inbound peer requests pairing.\n   *    The handler receives a {@link PairingRequest}; respond via\n   *    {@link respondToPairing}. Default behaviour without a listener\n   *    is to deny inbound pairing requests.\n   *\n   * Must be called after a successful {@link start} — the listener is\n   * dispatched on the active backend plugin, which is established by\n   * `start()`. Calling before `start()` throws.\n   */\n  async addListener(\n    eventName: \"pairingRequest\",\n    cb: (req: PairingRequest) => void,\n  ): Promise<{ remove: () => Promise<void> }> {\n    if (eventName !== \"pairingRequest\") {\n      throw new Error(\n        `[DVAI] addListener: unknown event name \"${eventName}\". Valid: \"pairingRequest\".`,\n      );\n    }\n    const native = dispatch.__activePlugin();\n    if (!native) {\n      throw new Error(\"[DVAI] addListener called before start()\");\n    }\n    return native.addListener(\"pairingRequest\", cb);\n  },\n\n  /**\n   * v3.0+ — distributed inference. Resolve a pending {@link PairingRequest}\n   * received via the `\"pairingRequest\"` event. Pass the request `id` and\n   * the user's decision; the native side records the decision and either\n   * lets the pairing proceed or rejects it.\n   *\n   * Idempotent — responding twice to the same `requestId` resolves\n   * cleanly on subsequent calls.\n   */\n  async respondToPairing(requestId: string, approved: boolean): Promise<void> {\n    const native = dispatch.__activePlugin();\n    if (!native) {\n      throw new Error(\"[DVAI] respondToPairing called before start()\");\n    }\n    await native.respondToPairing({ requestId, approved });\n  },\n\n  /** Resumable, checksum-verified, app-data-cached download. */\n  async downloadModel(opts: DownloadOptions): Promise<{ path: string; cached: boolean }> {\n    const native = await modelManagementPlugin();\n    return native.downloadModel(opts);\n  },\n\n  async listCachedModels(): Promise<CachedModelInfo[]> {\n    const native = await modelManagementPlugin();\n    const result = await native.listCachedModels();\n    return result.models;\n  },\n\n  async deleteCachedModel(filename: string): Promise<void> {\n    const native = await modelManagementPlugin();\n    await native.deleteCachedModel({ filename });\n  },\n\n  async cacheDir(): Promise<string> {\n    const native = await modelManagementPlugin();\n    const result = await native.cacheDir();\n    return result.path;\n  },\n};\n\n/**\n * Resolve the plugin that owns model-management methods (downloadModel,\n * listCachedModels, deleteCachedModel, cacheDir). In Phase 1, only the\n * `llama` backend implements these — `foundation` rejects (Apple manages\n * models internally) and `mediapipe` rejects (developer-managed paths).\n *\n * If a non-llama plugin is currently active, model management still routes\n * to the llama plugin (caller can install + use it without `start()`).\n * The native side may reject if the plugin isn't installed; the resulting\n * Capacitor \"plugin not implemented\" error is the right surface.\n */\nasync function modelManagementPlugin(): Promise<NativePluginInterface> {\n  const active = dispatch.__activePlugin();\n  if (active) return active;\n  const { registerPlugin } = await import(\"@capacitor/core\");\n  return registerPlugin<NativePluginInterface>(\"DVAIBridgeLlama\");\n}\n"],"mappings":";AAAA,SAAS,WAAW,sBAAsB;AAS1C,IAAM,yBAA2D;AAAA,EAC/D,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,KAAK;AACP;AAEA,IAAI,eAA6C;AACjD,IAAI,gBAAyC;AAE7C,SAAS,UAAU,SAAkD;AACnE,QAAM,OAAO,uBAAuB,OAAO;AAC3C,SAAO,eAAsC,IAAI;AACnD;AAEA,SAAS,4BAA4B,KAAuB;AAC1D,QAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,SAAO,+CAA+C,KAAK,GAAG;AAChE;AAOA,SAAS,oCAAoC,SAAiC;AAC5E,MAAI,YAAY,gBAAgB,YAAY,OAAO;AACjD,QAAI;AACJ,QAAI;AACF,iBAAW,WAAW,cAAc;AAAA,IACtC,QAAQ;AAAA,IAIR;AACA,QAAI,aAAa,WAAW;AAC1B,YAAM,QAAQ,YAAY,eAAe,4BAA4B;AACrE,YAAM,IAAI;AAAA,QACR,UAAU,KAAK;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AACF;AAEO,IAAM,WAAW;AAAA,EACtB,MAAM,MAAM,MAA0C;AACpD,wCAAoC,KAAK,OAAO;AAChD,UAAM,SAAS,UAAU,KAAK,OAAO;AACrC,QAAI;AACF,YAAM,SAAS,MAAM,OAAO,MAAM,IAAI;AACtC,qBAAe;AACf,sBAAgB,KAAK;AACrB,aAAO;AAAA,IACT,SAAS,KAAK;AACZ,UAAI,4BAA4B,GAAG,GAAG;AACpC,cAAM,IAAI;AAAA,UACR,mBAAmB,KAAK,OAAO,qGACc,KAAK,OAAO;AAAA,QAC3D;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAM,OAAsB;AAC1B,QAAI,CAAC,aAAc;AACnB,QAAI;AACF,YAAM,aAAa,KAAK;AAAA,IAC1B,UAAE;AACA,qBAAe;AACf,sBAAgB;AAAA,IAClB;AAAA,EACF;AAAA,EAEA,MAAM,SAA8B;AAClC,QAAI,CAAC,aAAc,QAAO,EAAE,SAAS,MAAM;AAC3C,WAAO,aAAa,OAAO;AAAA,EAC7B;AAAA,EAEA,UAAgB;AACd,mBAAe;AACf,oBAAgB;AAAA,EAClB;AAAA,EAEA,iBAA+C;AAC7C,WAAO;AAAA,EACT;AACF;;;ACnEO,IAAM,aAAa;AAAA;AAAA,EAExB,MAAM,MAAM,MAA0C;AACpD,WAAO,SAAS,MAAM,IAAI;AAAA,EAC5B;AAAA;AAAA,EAGA,MAAM,OAAsB;AAC1B,WAAO,SAAS,KAAK;AAAA,EACvB;AAAA;AAAA,EAGA,MAAM,SAA8B;AAClC,WAAO,SAAS,OAAO;AAAA,EACzB;AAAA;AAAA,EAGA,MAAM,oBACJ,IAC0C;AAC1C,UAAM,SAAS,SAAS,eAAe;AACvC,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,kDAAkD;AAAA,IACpE;AACA,WAAO,OAAO,YAAY,YAAY,EAAE;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,YACJ,WACA,IAC0C;AAC1C,QAAI,cAAc,kBAAkB;AAClC,YAAM,IAAI;AAAA,QACR,2CAA2C,SAAS;AAAA,MACtD;AAAA,IACF;AACA,UAAM,SAAS,SAAS,eAAe;AACvC,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,0CAA0C;AAAA,IAC5D;AACA,WAAO,OAAO,YAAY,kBAAkB,EAAE;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,iBAAiB,WAAmB,UAAkC;AAC1E,UAAM,SAAS,SAAS,eAAe;AACvC,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,+CAA+C;AAAA,IACjE;AACA,UAAM,OAAO,iBAAiB,EAAE,WAAW,SAAS,CAAC;AAAA,EACvD;AAAA;AAAA,EAGA,MAAM,cAAc,MAAmE;AACrF,UAAM,SAAS,MAAM,sBAAsB;AAC3C,WAAO,OAAO,cAAc,IAAI;AAAA,EAClC;AAAA,EAEA,MAAM,mBAA+C;AACnD,UAAM,SAAS,MAAM,sBAAsB;AAC3C,UAAM,SAAS,MAAM,OAAO,iBAAiB;AAC7C,WAAO,OAAO;AAAA,EAChB;AAAA,EAEA,MAAM,kBAAkB,UAAiC;AACvD,UAAM,SAAS,MAAM,sBAAsB;AAC3C,UAAM,OAAO,kBAAkB,EAAE,SAAS,CAAC;AAAA,EAC7C;AAAA,EAEA,MAAM,WAA4B;AAChC,UAAM,SAAS,MAAM,sBAAsB;AAC3C,UAAM,SAAS,MAAM,OAAO,SAAS;AACrC,WAAO,OAAO;AAAA,EAChB;AACF;AAaA,eAAe,wBAAwD;AACrE,QAAM,SAAS,SAAS,eAAe;AACvC,MAAI,OAAQ,QAAO;AACnB,QAAM,EAAE,gBAAAA,gBAAe,IAAI,MAAM,OAAO,iBAAiB;AACzD,SAAOA,gBAAsC,iBAAiB;AAChE;","names":["registerPlugin"]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@dvai-bridge/capacitor",
+  "version": "4.0.0",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "description": "JS routing shim for DVAI-Bridge Capacitor backend plugins. Dispatches to capacitor-llama, capacitor-foundation, or capacitor-mediapipe.",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dvai-bridge",
+    "capacitor",
+    "local-ai",
+    "openai-compatible"
+  ],
+  "author": "Deep Chakraborty <https://github.com/dk013>",
+  "license": "Custom (See LICENSE)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/westenets/dvai-bridge.git"
+  },
+  "peerDependencies": {
+    "@capacitor/core": "^6.0.0 || ^7.0.0 || ^8.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}