@plures/pluresdb 1.6.10 → 2.9.7

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@plures/pluresdb",
-  "version": "1.6.10",
+  "version": "2.9.7",
   "description": "P2P Graph Database with SQLite Compatibility - Local-first, offline-first database for modern applications",
-  "main": "dist/node-index.js",
-  "types": "dist/node-index.d.ts",
+  "main": "dist/napi/index.js",
+  "types": "dist/napi/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/napi/index.d.ts",
+      "require": "./dist/napi/index.js",
+      "default": "./dist/napi/index.js"
+    },
+    "./legacy": {
       "types": "./dist/node-index.d.ts",
       "require": "./dist/node-index.js",
       "default": "./dist/node-index.js"
@@ -20,6 +25,11 @@
       "require": "./dist/better-sqlite3.js",
       "default": "./dist/better-sqlite3.js"
     },
+    "./embedded": {
+      "types": "./embedded.d.ts",
+      "require": "./embedded.js",
+      "default": "./embedded.js"
+    },
     "./vscode": {
       "types": "./dist/vscode/extension.d.ts",
       "require": "./dist/vscode/extension.js",
@@ -98,10 +108,12 @@
   },
   "files": [
     "dist/",
-    "web/svelte/dist/",
-    "legacy/",
-    "examples/",
-    "scripts/",
+    "embedded.js",
+    "embedded.d.ts",
+    "crates/pluresdb-node/index.d.ts",
+    "crates/pluresdb-node/index.js",
+    "crates/pluresdb-node/*.node",
+    "scripts/postinstall.js",
     "README.md",
     "LICENSE",
     "package.json"
@@ -109,12 +121,13 @@
   "dependencies": {
     "cors": "^2.8.5",
     "express": "^5.1.0",
+    "hyperswarm": "^4.8.4",
     "ws": "^8.18.3"
   },
   "devDependencies": {
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
-    "@types/node": "^22.10.0",
+    "@types/node": "^22.19.11",
     "@types/vscode": "^1.104.0",
     "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.46.4",

package/examples/basic-usage.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=basic-usage.d.ts.map

package/examples/basic-usage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"basic-usage.d.ts","sourceRoot":"","sources":["basic-usage.ts"],"names":[],"mappings":""}

package/examples/basic-usage.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const database_ts_1 = require("../src/core/database.ts");
-const db = new database_ts_1.GunDB();
-await db.ready();
-await db.put("user:alice", {
-  name: "Alice",
-  age: 30,
-  city: "London",
-  vector: undefined,
-});
-const user = await db.get("user:alice");
-console.log("User:", user);
-db.on("user:alice", (node) => console.log("Updated user:alice:", node));
-await db.put("note:1", { text: "I love visiting museums in London" });
-await db.put("note:2", { text: "Best pizza in New York" });
-await db.put("note:3", { text: "Parks and galleries around London are great" });
-const results = await db.vectorSearch("Find things about London", 5);
-console.log(
-  "Semantic search results:",
-  results.map((n) => ({
-    id: n.id,
-    text: n.data.text,
-  })),
-);
-//# sourceMappingURL=basic-usage.js.map

package/examples/basic-usage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"basic-usage.js","sourceRoot":"","sources":["basic-usage.ts"],"names":[],"mappings":";;AAAA,yDAAgD;AAEhD,MAAM,EAAE,GAAG,IAAI,mBAAK,EAAE,CAAC;AACvB,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;AAEjB,MAAM,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE;IACzB,IAAI,EAAE,OAAO;IACb,GAAG,EAAE,EAAE;IACP,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,SAAS;CAClB,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACxC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAE3B,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC,CAAC;AAExE,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,mCAAmC,EAAE,CAAC,CAAC;AACtE,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAC;AAC3D,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,6CAA6C,EAAE,CAAC,CAAC;AAEhF,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,0BAA0B,EAAE,CAAC,CAAC,CAAC;AACrE,OAAO,CAAC,GAAG,CACT,0BAA0B,EAC1B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClB,EAAE,EAAE,CAAC,CAAC,EAAE;IACR,IAAI,EAAG,CAAC,CAAC,IAAgC,CAAC,IAAI;CAC/C,CAAC,CAAC,CACJ,CAAC"}

package/examples/basic-usage.ts

@@ -1,29 +0,0 @@
-import { GunDB } from "../src/core/database.ts";
-
-const db = new GunDB();
-await db.ready();
-
-await db.put("user:alice", {
-  name: "Alice",
-  age: 30,
-  city: "London",
-  vector: undefined,
-});
-
-const user = await db.get("user:alice");
-console.log("User:", user);
-
-db.on("user:alice", (node) => console.log("Updated user:alice:", node));
-
-await db.put("note:1", { text: "I love visiting museums in London" });
-await db.put("note:2", { text: "Best pizza in New York" });
-await db.put("note:3", { text: "Parks and galleries around London are great" });
-
-const results = await db.vectorSearch("Find things about London", 5);
-console.log(
-  "Semantic search results:",
-  results.map((n) => ({
-    id: n.id,
-    text: (n.data as Record<string, unknown>).text,
-  })),
-);

package/examples/browser-demo/README.md

@@ -1,204 +0,0 @@
-# PluresDB Browser Demo
-
-A fully-functional browser-based demo of PluresDB's local-first integration with WebAssembly.
-
-## Features
-
-- 🚀 Local-first database running entirely in the browser
-- 📝 Add, list, and delete users
-- 💾 Automatic persistence with IndexedDB
-- 🎨 Beautiful, modern UI
-- ⚡ Real-time updates
-- 🔌 Offline-first by default
-
-## Running the Demo
-
-### Option 1: With WASM (Recommended)
-
-The WASM bindings are now complete! Run the demo entirely in-browser without any server:
-
-1. Build the WASM module:
-   ```bash
-   cd crates/pluresdb-wasm
-   wasm-pack build --target web
-   ```
-
-2. Serve the demo with a local HTTP server:
-   ```bash
-   # Using Python
-   python -m http.server 8000
-   
-   # Or using Node.js
-   npx http-server
-   ```
-
-3. Open `http://localhost:8000/examples/browser-demo/index.html` in your browser
-
-4. The demo will automatically use WASM mode with IndexedDB persistence - no server needed!
-
-### Option 2: With PluresDB Server (Fallback)
-
-For testing network mode:
-
-1. Start the PluresDB server:
-   ```bash
-   npm start
-   ```
-
-2. Open `index.html` in your browser - it will fall back to network mode
-
-## What This Demonstrates
-
-### Local-First Integration
-- **WebAssembly**: Runs PluresDB core directly in the browser
-- **IndexedDB**: Automatic data persistence
-- **Auto-detection**: Automatically uses WASM when available
-- **Network fallback**: Falls back to HTTP REST when needed
-- **Unified API**: Same API regardless of backend
-
-### Database Operations
-- **Put**: Insert or update records with persistence
-- **Get**: Retrieve records by ID
-- **List**: Query all records
-- **Delete**: Remove records from memory and IndexedDB
-- **Clear**: Wipe all data
-
-### User Interface
-- Clean, modern design
-- Real-time status updates
-- Interactive user management
-- Console output for debugging
-
-## Architecture
-
-### WASM Mode (Default)
-```
-┌─────────────────────────────────┐
-│   Browser (index.html)          │
-│                                 │
-│   PluresDBLocalFirst            │
-│   (Auto-detection)              │
-│           │                     │
-│           ▼                     │
-│   PluresDBBrowser (WASM)        │
-│           │                     │
-│           ▼                     │
-│   IndexedDB (Persistence)       │
-│                                 │
-└─────────────────────────────────┘
-     100% In-Browser
-     No Network Required
-```
-
-### Network Mode (Fallback)
-```
-┌─────────────────────────────────┐
-│   Browser (index.html)          │
-│                                 │
-│   PluresDBLocalFirst            │
-│   (Auto-detection)              │
-│           │                     │
-│           └─ Network            │
-│                   │             │
-└───────────────────┼─────────────┘
-                    │ HTTP
-        ┌───────────▼──────────┐
-        │   PluresDB Server    │
-        │   (port 34567)       │
-        └──────────────────────┘
-```
-
-## Performance
-
-With WASM mode enabled:
-
-| Metric | Network Mode | WASM Mode | Improvement |
-|--------|--------------|-----------|-------------|
-| **Latency** | ~50-100ms | ~0.1ms | **500-1000x faster** |
-| **Throughput** | ~100 ops/s | ~100k ops/s | **1000x faster** |
-| **Offline** | ❌ Requires server | ✅ Fully offline | **100% available** |
-| **Network** | Required | None | **Zero bandwidth** |
-| **Persistence** | Server-side | IndexedDB | **Local storage** |
-
-## Development
-
-To modify the demo:
-
-1. Edit `index.html` - all code is in a single file for simplicity
-2. Rebuild WASM if you modified Rust code:
-   ```bash
-   cd crates/pluresdb-wasm
-   wasm-pack build --target web
-   ```
-3. Refresh the browser to see changes
-4. Use browser DevTools (F12) to debug
-
-## Integration with Your App
-
-To integrate PluresDB local-first into your own application:
-
-```javascript
-import { PluresDBLocalFirst } from "@plures/pluresdb/local-first";
-
-// Auto-detects best mode (WASM in browser)
-const db = new PluresDBLocalFirst({ mode: "auto" });
-
-// Or force WASM mode
-const db = new PluresDBLocalFirst({ mode: "wasm", dbName: "my-app" });
-
-// Use the API
-await db.put("user:1", { name: "Alice", email: "alice@example.com" });
-const user = await db.get("user:1");
-```
-
-See the [Local-First Integration Guide](../../docs/LOCAL_FIRST_INTEGRATION.md) for complete documentation.
-
-## Troubleshooting
-
-### WASM not loading
-
-1. Make sure you built the WASM module:
-   ```bash
-   cd crates/pluresdb-wasm
-   wasm-pack build --target web
-   ```
-
-2. Check browser console for errors
-
-3. Ensure you're using a local HTTP server (not file://)
-
-### "Failed to connect" error (network mode)
-
-Make sure the PluresDB server is running:
-```bash
-npm start
-```
-
-The server should be listening on port 34567.
-
-### IndexedDB not persisting data
-
-1. Check browser console for IndexedDB errors
-2. Make sure you called `init_persistence()` on the WASM instance
-3. Check browser storage settings (some browsers block IndexedDB in private mode)
-
-## Browser Compatibility
-
-WASM mode is supported in:
-- ✅ Chrome/Edge 57+
-- ✅ Firefox 52+
-- ✅ Safari 11+
-- ✅ Opera 44+
-
-IndexedDB is supported in all modern browsers.
-
-## Next Steps
-
-- [Browser WASM Integration Guide](../browser-wasm-integration.md)
-- [Local-First Integration Methodology](../../docs/LOCAL_FIRST_INTEGRATION.md)
-- [Tauri Integration Example](../tauri-integration.md)
-- [IPC Integration Example](../ipc-demo/README.md)
-
-## License
-
-AGPL-3.0 - see [LICENSE](../../LICENSE)