crumbtrail-tauri 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Crumbtrail
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS 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 OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# crumbtrail-tauri
+
+Tauri v2 plugin for Crumbtrail. Replaces the HTTP transport with native IPC — no separate server process needed.
+
+## Setup
+
+### 1. Rust side
+
+Add the plugin to your `src-tauri/Cargo.toml`:
+
+```toml
+[dependencies]
+tauri-plugin-crumbtrail = { path = "../packages/tauri/rust" }
+```
+
+Register it in `src-tauri/src/lib.rs` (the Tauri v2 CLI scaffold's `run()`
+entry point — `src-tauri/src/main.rs` just calls that `run()` and does not
+build the `tauri::Builder` itself, so the plugin is registered here, not in
+`main.rs`):
+
+```rust
+#[cfg_attr(mobile, tauri::mobile_entry_point)]
+pub fn run() {
+    tauri::Builder::default()
+        .plugin(tauri_plugin_crumbtrail::init())
+        .run(tauri::generate_context!())
+        .expect("error while running tauri application");
+}
+```
+
+### 2. Permissions
+
+Add to `src-tauri/capabilities/default.json`:
+
+```json
+{
+  "permissions": ["crumbtrail:default"]
+}
+```
+
+### 3. JavaScript side
+
+```bash
+pnpm add crumbtrail-core crumbtrail-tauri
+```
+
+```typescript
+import { Crumbtrail } from "crumbtrail-core";
+import { TauriTransport } from "crumbtrail-tauri";
+
+const logger = Crumbtrail.init({
+  transportInstance: new TauriTransport(),
+});
+
+// Use as normal
+logger.mark("app-ready");
+
+// When done
+await logger.stop();
+```
+
+## How it works
+
+The `TauriTransport` class implements `CrumbtrailTransport` using Tauri's `invoke()` IPC instead of HTTP `fetch()`. Events flow directly to the Rust backend which handles:
+
+- **Session management** — creates session directories, writes `meta.json`
+- **NDJSON writing** — appends events to `events.ndjson`
+- **Blob storage** — writes binary files (screenshots, video chunks)
+- **Post-processing** — generates `index.json` with error/request/navigation summaries
+
+## Session storage
+
+Sessions are stored at:
+
+```
+<app_data_dir>/crumbtrail-sessions/<session_id>/
+├── meta.json
+├── events.ndjson
+├── index.json
+├── frames/
+└── (blobs)
+```
+
+On macOS: `~/Library/Application Support/<bundle-id>/crumbtrail-sessions/`
+
+## MCP compatibility
+
+The MCP server from `crumbtrail-node` reads session directories directly. Point it at the same output path to use MCP tools with Tauri-captured sessions:
+
+```bash
+crumbtrail-server --output ~/Library/Application\ Support/<bundle-id>/crumbtrail-sessions
+```
+
+## Requirements
+
+- Tauri v2
+- Rust toolchain (rustup)

package/dist/index.cjs

@@ -0,0 +1,70 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  TauriTransport: () => TauriTransport
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/transport.ts
+var import_core = require("@tauri-apps/api/core");
+var TauriTransport = class {
+  sessionId = "";
+  async startSession(sessionId, metadata) {
+    this.sessionId = sessionId;
+    await (0, import_core.invoke)("plugin:crumbtrail|start_session", { sessionId, metadata });
+  }
+  async endSession(sessionId) {
+    await (0, import_core.invoke)("plugin:crumbtrail|end_session", { sessionId });
+  }
+  async sendEvents(events) {
+    await (0, import_core.invoke)("plugin:crumbtrail|append_events", {
+      sessionId: this.sessionId,
+      events
+    });
+  }
+  async sendBlob(name, blob, metadata) {
+    const buffer = await blob.arrayBuffer();
+    await (0, import_core.invoke)("plugin:crumbtrail|write_blob", {
+      sessionId: this.sessionId,
+      name,
+      data: Array.from(new Uint8Array(buffer)),
+      metadata: metadata ?? {}
+    });
+  }
+  async sendBugReport(report, events, voiceBlob) {
+    await (0, import_core.invoke)("plugin:crumbtrail|flag_bug", {
+      report,
+      events
+    });
+    if (voiceBlob) {
+      const buffer = await voiceBlob.arrayBuffer();
+      await (0, import_core.invoke)("plugin:crumbtrail|write_bug_voice", {
+        bugId: report.bugId,
+        data: Array.from(new Uint8Array(buffer))
+      });
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TauriTransport
+});

package/dist/index.d.cts

@@ -0,0 +1,12 @@
+import { CrumbtrailTransport, BugEvent, BugReport } from 'crumbtrail-core';
+
+declare class TauriTransport implements CrumbtrailTransport {
+    private sessionId;
+    startSession(sessionId: string, metadata: Record<string, unknown>): Promise<void>;
+    endSession(sessionId: string): Promise<void>;
+    sendEvents(events: BugEvent[]): Promise<void>;
+    sendBlob(name: string, blob: Blob, metadata?: Record<string, unknown>): Promise<void>;
+    sendBugReport(report: BugReport, events: BugEvent[], voiceBlob?: Blob): Promise<void>;
+}
+
+export { TauriTransport };

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { CrumbtrailTransport, BugEvent, BugReport } from 'crumbtrail-core';
+
+declare class TauriTransport implements CrumbtrailTransport {
+    private sessionId;
+    startSession(sessionId: string, metadata: Record<string, unknown>): Promise<void>;
+    endSession(sessionId: string): Promise<void>;
+    sendEvents(events: BugEvent[]): Promise<void>;
+    sendBlob(name: string, blob: Blob, metadata?: Record<string, unknown>): Promise<void>;
+    sendBugReport(report: BugReport, events: BugEvent[], voiceBlob?: Blob): Promise<void>;
+}
+
+export { TauriTransport };

package/dist/index.js

@@ -0,0 +1,43 @@
+// src/transport.ts
+import { invoke } from "@tauri-apps/api/core";
+var TauriTransport = class {
+  sessionId = "";
+  async startSession(sessionId, metadata) {
+    this.sessionId = sessionId;
+    await invoke("plugin:crumbtrail|start_session", { sessionId, metadata });
+  }
+  async endSession(sessionId) {
+    await invoke("plugin:crumbtrail|end_session", { sessionId });
+  }
+  async sendEvents(events) {
+    await invoke("plugin:crumbtrail|append_events", {
+      sessionId: this.sessionId,
+      events
+    });
+  }
+  async sendBlob(name, blob, metadata) {
+    const buffer = await blob.arrayBuffer();
+    await invoke("plugin:crumbtrail|write_blob", {
+      sessionId: this.sessionId,
+      name,
+      data: Array.from(new Uint8Array(buffer)),
+      metadata: metadata ?? {}
+    });
+  }
+  async sendBugReport(report, events, voiceBlob) {
+    await invoke("plugin:crumbtrail|flag_bug", {
+      report,
+      events
+    });
+    if (voiceBlob) {
+      const buffer = await voiceBlob.arrayBuffer();
+      await invoke("plugin:crumbtrail|write_bug_voice", {
+        bugId: report.bugId,
+        data: Array.from(new Uint8Array(buffer))
+      });
+    }
+  }
+};
+export {
+  TauriTransport
+};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "crumbtrail-tauri",
+  "version": "0.2.0",
+  "type": "module",
+  "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"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@tauri-apps/api": "^2.0.0"
+  },
+  "peerDependencies": {
+    "crumbtrail-core": "^0.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "tsup": "^8.5.0",
+    "vitest": "^3.2.0",
+    "crumbtrail-core": "^0.2.0"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/crumbtrail-dev/crumbtrail-js/tree/main/packages/tauri#readme",
+  "bugs": {
+    "url": "https://github.com/crumbtrail-dev/crumbtrail-js/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/crumbtrail-dev/crumbtrail-js.git",
+    "directory": "packages/tauri"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "clean": "rm -rf dist"
+  }
+}