pluresdb 1.0.1

package/examples/vscode-extension-example/src/extension.ts

@@ -0,0 +1,163 @@
+import * as vscode from "vscode";
+import { SQLiteCompatibleAPI } from "pluresdb";
+import * as path from "path";
+
+export function activate(context: vscode.ExtensionContext) {
+  console.log("PluresDB extension is now active!");
+
+  // Initialize PluresDB database
+  const db = new SQLiteCompatibleAPI({
+    config: {
+      dataDir: path.join(context.globalStorageUri.fsPath, "pluresdb"),
+      port: 34567,
+      host: "localhost",
+    },
+  });
+
+  // Start the database
+  db.start()
+    .then(() => {
+      console.log("PluresDB database started");
+
+      // Set up database schema
+      setupDatabase(db);
+    })
+    .catch((error) => {
+      console.error("Failed to start PluresDB:", error);
+      vscode.window.showErrorMessage("Failed to start PluresDB database");
+    });
+
+  // Register commands
+  const helloWorldCommand = vscode.commands.registerCommand("pluresdb-example.helloWorld", () => {
+    vscode.window.showInformationMessage("Hello World from PluresDB!");
+  });
+
+  const storeDataCommand = vscode.commands.registerCommand(
+    "pluresdb-example.storeData",
+    async () => {
+      const key = await vscode.window.showInputBox({
+        prompt: "Enter key to store",
+        placeHolder: "user:123",
+      });
+
+      if (key) {
+        const value = await vscode.window.showInputBox({
+          prompt: "Enter value (JSON)",
+          placeHolder: '{"name": "John", "email": "john@example.com"}',
+        });
+
+        if (value) {
+          try {
+            const parsedValue = JSON.parse(value);
+            await db.put(key, parsedValue);
+            vscode.window.showInformationMessage(`Stored data for key: ${key}`);
+          } catch (error) {
+            vscode.window.showErrorMessage(
+              `Failed to store data: ${error instanceof Error ? error.message : String(error)}`,
+            );
+          }
+        }
+      }
+    },
+  );
+
+  const retrieveDataCommand = vscode.commands.registerCommand(
+    "pluresdb-example.retrieveData",
+    async () => {
+      const key = await vscode.window.showInputBox({
+        prompt: "Enter key to retrieve",
+        placeHolder: "user:123",
+      });
+
+      if (key) {
+        try {
+          const value = await db.getValue(key);
+          if (value) {
+            const doc = await vscode.workspace.openTextDocument({
+              content: JSON.stringify(value, null, 2),
+              language: "json",
+            });
+            await vscode.window.showTextDocument(doc);
+          } else {
+            vscode.window.showInformationMessage("Key not found");
+          }
+        } catch (error) {
+          vscode.window.showErrorMessage(
+            `Failed to retrieve data: ${error instanceof Error ? error.message : String(error)}`,
+          );
+        }
+      }
+    },
+  );
+
+  const searchDataCommand = vscode.commands.registerCommand(
+    "pluresdb-example.searchData",
+    async () => {
+      const query = await vscode.window.showInputBox({
+        prompt: "Enter search query",
+        placeHolder: "machine learning",
+      });
+
+      if (query) {
+        try {
+          const results = await db.vectorSearch(query, 10);
+          const doc = await vscode.workspace.openTextDocument({
+            content: JSON.stringify(results, null, 2),
+            language: "json",
+          });
+          await vscode.window.showTextDocument(doc);
+        } catch (error) {
+          vscode.window.showErrorMessage(
+            `Search failed: ${error instanceof Error ? error.message : String(error)}`,
+          );
+        }
+      }
+    },
+  );
+
+  // Register all commands
+  context.subscriptions.push(
+    helloWorldCommand,
+    storeDataCommand,
+    retrieveDataCommand,
+    searchDataCommand,
+  );
+
+  // Clean up on deactivation
+  context.subscriptions.push({
+    dispose: () => {
+      db.stop().catch(console.error);
+    },
+  });
+}
+
+async function setupDatabase(db: SQLiteCompatibleAPI) {
+  try {
+    // Create tables for common VSCode extension use cases
+    await db.exec(`
+            CREATE TABLE IF NOT EXISTS settings (
+                key TEXT PRIMARY KEY,
+                value TEXT,
+                created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+            )
+        `);
+
+    await db.exec(`
+            CREATE TABLE IF NOT EXISTS documents (
+                id TEXT PRIMARY KEY,
+                content TEXT,
+                language TEXT,
+                file_path TEXT,
+                created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+            )
+        `);
+
+    console.log("Database schema created successfully");
+  } catch (error) {
+    console.error("Failed to create database schema:", error);
+  }
+}
+
+export function deactivate() {
+  console.log("PluresDB extension deactivated");
+}

package/examples/vscode-extension-example/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "ES2020",
+    "outDir": "out",
+    "lib": ["ES2020"],
+    "sourceMap": true,
+    "rootDir": "src",
+    "strict": true
+  },
+  "exclude": ["node_modules", ".vscode-test"]
+}

package/examples/vscode-extension-integration.d.ts

@@ -0,0 +1,24 @@
+/**
+ * VSCode Extension Integration Example
+ * This shows how to integrate PluresDB into a VSCode extension
+ */
+import * as vscode from 'vscode';
+export declare class PluresExtension {
+    private plures;
+    private sqliteAPI;
+    private context;
+    constructor(context: vscode.ExtensionContext);
+    private setupEventHandlers;
+    activate(): Promise<void>;
+    deactivate(): Promise<void>;
+    private registerCommands;
+    private setupDatabase;
+    storeSetting(key: string, value: any): Promise<any>;
+    getSetting(key: string): Promise<any>;
+    storeDocument(id: string, content: string, language: string, filePath: string): Promise<any>;
+    searchDocuments(query: string): Promise<any>;
+    executeSQL(sql: string, params?: any[]): Promise<any>;
+}
+export declare function activate(context: vscode.ExtensionContext): PluresExtension;
+export declare function deactivate(extension: PluresExtension): void;
+//# sourceMappingURL=vscode-extension-integration.d.ts.map

package/examples/vscode-extension-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode-extension-integration.d.ts","sourceRoot":"","sources":["vscode-extension-integration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,OAAO,CAA0B;gBAE7B,OAAO,EAAE,MAAM,CAAC,gBAAgB;IA+B5C,OAAO,CAAC,kBAAkB;IAcpB,QAAQ;IAkBR,UAAU;IAShB,OAAO,CAAC,gBAAgB;YA6GV,aAAa;IAmCrB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAIpC,UAAU,CAAC,GAAG,EAAE,MAAM;IAItB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAS7E,eAAe,CAAC,KAAK,EAAE,MAAM;IAI7B,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO;CAGjD;AAGD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,gBAAgB,qBAIxD;AAGD,wBAAgB,UAAU,CAAC,SAAS,EAAE,iBAAiB,QAEtD"}

package/examples/vscode-extension-integration.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * VSCode Extension Integration Example
+ * This shows how to integrate PluresDB into a VSCode extension
+ */
+var __createBinding =
+  (this && this.__createBinding) ||
+  (Object.create
+    ? function (o, m, k, k2) {
+        if (k2 === undefined) k2 = k;
+        var desc = Object.getOwnPropertyDescriptor(m, k);
+        if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+          desc = {
+            enumerable: true,
+            get: function () {
+              return m[k];
+            },
+          };
+        }
+        Object.defineProperty(o, k2, desc);
+      }
+    : function (o, m, k, k2) {
+        if (k2 === undefined) k2 = k;
+        o[k2] = m[k];
+      });
+var __setModuleDefault =
+  (this && this.__setModuleDefault) ||
+  (Object.create
+    ? function (o, v) {
+        Object.defineProperty(o, "default", { enumerable: true, value: v });
+      }
+    : function (o, v) {
+        o["default"] = v;
+      });
+var __importStar =
+  (this && this.__importStar) ||
+  (function () {
+    var ownKeys = function (o) {
+      ownKeys =
+        Object.getOwnPropertyNames ||
+        function (o) {
+          var ar = [];
+          for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+          return ar;
+        };
+      return ownKeys(o);
+    };
+    return function (mod) {
+      if (mod && mod.__esModule) return mod;
+      var result = {};
+      if (mod != null)
+        for (var k = ownKeys(mod), i = 0; i < k.length; i++)
+          if (k[i] !== "default") __createBinding(result, mod, k[i]);
+      __setModuleDefault(result, mod);
+      return result;
+    };
+  })();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluresExtension = void 0;
+exports.activate = activate;
+exports.deactivate = deactivate;
+const vscode = __importStar(require("vscode"));
+const pluresdb_1 = require("pluresdb");
+class PluresExtension {
+  plures;
+  sqliteAPI;
+  context;
+  constructor(context) {
+    this.context = context;
+    // Initialize PluresDB with VSCode-specific configuration
+    this.plures = new pluresdb_1.PluresNode({
+      config: {
+        port: 34567,
+        host: "localhost",
+        dataDir: path.join(context.globalStorageUri.fsPath, "pluresdb"),
+        webPort: 34568,
+        logLevel: "info",
+      },
+      autoStart: false, // We'll start it manually
+    });
+    // Create SQLite-compatible API
+    this.sqliteAPI = new pluresdb_1.SQLiteCompatibleAPI({
+      config: {
+        port: 34567,
+        host: "localhost",
+        dataDir: path.join(context.globalStorageUri.fsPath, "pluresdb"),
+        webPort: 34568,
+        logLevel: "info",
+      },
+      autoStart: false,
+    });
+    // Set up event handlers
+    this.setupEventHandlers();
+  }
+  setupEventHandlers() {
+    this.plures.on("started", () => {
+      vscode.window.showInformationMessage("PluresDB database started");
+    });
+    this.plures.on("stopped", () => {
+      vscode.window.showInformationMessage("PluresDB database stopped");
+    });
+    this.plures.on("error", (error) => {
+      vscode.window.showErrorMessage(`PluresDB error: ${error.message}`);
+    });
+  }
+  async activate() {
+    try {
+      // Start PluresDB
+      await this.plures.start();
+      await this.sqliteAPI.start();
+      // Register commands
+      this.registerCommands();
+      // Set up database schema
+      await this.setupDatabase();
+      vscode.window.showInformationMessage("PluresDB extension activated");
+    } catch (error) {
+      vscode.window.showErrorMessage(`Failed to activate PluresDB: ${error.message}`);
+    }
+  }
+  async deactivate() {
+    try {
+      await this.plures.stop();
+      await this.sqliteAPI.stop();
+    } catch (error) {
+      console.error("Error stopping PluresDB:", error);
+    }
+  }
+  registerCommands() {
+    // Command to open PluresDB web UI
+    const openWebUI = vscode.commands.registerCommand("pluresdb.openWebUI", () => {
+      const webUrl = this.plures.getWebUrl();
+      vscode.env.openExternal(vscode.Uri.parse(webUrl));
+    });
+    // Command to execute SQL query
+    const executeQuery = vscode.commands.registerCommand("pluresdb.executeQuery", async () => {
+      const sql = await vscode.window.showInputBox({
+        prompt: "Enter SQL query",
+        placeHolder: "SELECT * FROM users",
+      });
+      if (sql) {
+        try {
+          const result = await this.sqliteAPI.all(sql);
+          const doc = await vscode.workspace.openTextDocument({
+            content: JSON.stringify(result, null, 2),
+            language: "json",
+          });
+          await vscode.window.showTextDocument(doc);
+        } catch (error) {
+          vscode.window.showErrorMessage(`Query failed: ${error.message}`);
+        }
+      }
+    });
+    // Command to perform vector search
+    const vectorSearch = vscode.commands.registerCommand("pluresdb.vectorSearch", async () => {
+      const query = await vscode.window.showInputBox({
+        prompt: "Enter search query",
+        placeHolder: "machine learning",
+      });
+      if (query) {
+        try {
+          const results = await this.sqliteAPI.vectorSearch(query, 10);
+          const doc = await vscode.workspace.openTextDocument({
+            content: JSON.stringify(results, null, 2),
+            language: "json",
+          });
+          await vscode.window.showTextDocument(doc);
+        } catch (error) {
+          vscode.window.showErrorMessage(`Vector search failed: ${error.message}`);
+        }
+      }
+    });
+    // Command to store data
+    const storeData = vscode.commands.registerCommand("pluresdb.storeData", async () => {
+      const key = await vscode.window.showInputBox({
+        prompt: "Enter key",
+        placeHolder: "user:123",
+      });
+      if (key) {
+        const value = await vscode.window.showInputBox({
+          prompt: "Enter value (JSON)",
+          placeHolder: '{"name": "John", "email": "john@example.com"}',
+        });
+        if (value) {
+          try {
+            const parsedValue = JSON.parse(value);
+            await this.sqliteAPI.put(key, parsedValue);
+            vscode.window.showInformationMessage(`Stored data for key: ${key}`);
+          } catch (error) {
+            vscode.window.showErrorMessage(`Failed to store data: ${error.message}`);
+          }
+        }
+      }
+    });
+    // Command to retrieve data
+    const retrieveData = vscode.commands.registerCommand("pluresdb.retrieveData", async () => {
+      const key = await vscode.window.showInputBox({
+        prompt: "Enter key to retrieve",
+        placeHolder: "user:123",
+      });
+      if (key) {
+        try {
+          const value = await this.sqliteAPI.getValue(key);
+          if (value) {
+            const doc = await vscode.workspace.openTextDocument({
+              content: JSON.stringify(value, null, 2),
+              language: "json",
+            });
+            await vscode.window.showTextDocument(doc);
+          } else {
+            vscode.window.showInformationMessage("Key not found");
+          }
+        } catch (error) {
+          vscode.window.showErrorMessage(`Failed to retrieve data: ${error.message}`);
+        }
+      }
+    });
+    // Register all commands
+    this.context.subscriptions.push(openWebUI, executeQuery, vectorSearch, storeData, retrieveData);
+  }
+  async setupDatabase() {
+    // Create tables for common VSCode extension use cases
+    const tables = [
+      `CREATE TABLE IF NOT EXISTS settings (
+        key TEXT PRIMARY KEY,
+        value TEXT,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      )`,
+      `CREATE TABLE IF NOT EXISTS documents (
+        id TEXT PRIMARY KEY,
+        content TEXT,
+        language TEXT,
+        file_path TEXT,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      )`,
+      `CREATE TABLE IF NOT EXISTS search_history (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        query TEXT,
+        results_count INTEGER,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      )`,
+    ];
+    for (const sql of tables) {
+      try {
+        await this.sqliteAPI.exec(sql);
+      } catch (error) {
+        console.error("Error creating table:", error);
+      }
+    }
+  }
+  // Public API methods for other parts of the extension
+  async storeSetting(key, value) {
+    return this.sqliteAPI.put(`settings:${key}`, value);
+  }
+  async getSetting(key) {
+    return this.sqliteAPI.getValue(`settings:${key}`);
+  }
+  async storeDocument(id, content, language, filePath) {
+    return this.sqliteAPI.put(`documents:${id}`, {
+      content,
+      language,
+      filePath,
+      updatedAt: new Date().toISOString(),
+    });
+  }
+  async searchDocuments(query) {
+    return this.sqliteAPI.vectorSearch(query, 20);
+  }
+  async executeSQL(sql, params = []) {
+    return this.sqliteAPI.all(sql, params);
+  }
+}
+exports.PluresExtension = PluresExtension;
+// Extension activation function
+function activate(context) {
+  const extension = new PluresExtension(context);
+  extension.activate();
+  return extension;
+}
+// Extension deactivation function
+function deactivate(extension) {
+  extension.deactivate();
+}
+//# sourceMappingURL=vscode-extension-integration.js.map

package/examples/vscode-extension-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode-extension-integration.js","sourceRoot":"","sources":["vscode-extension-integration.ts"],"names":[],"mappings":"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"}

package/examples/vscode-extension-integration.ts

@@ -0,0 +1,41 @@
+/**
+ * VSCode Extension Integration Example
+ * This shows how to integrate PluresDB into a VSCode extension
+ */
+
+import * as vscode from "vscode";
+import {
+  createPluresExtension,
+  PluresVSCodeExtension,
+  ExtensionContextLike,
+  VSCodeAPI,
+} from "../src/vscode/extension.ts";
+
+let extensionInstance: PluresVSCodeExtension | undefined;
+
+export async function activate(context: vscode.ExtensionContext) {
+  const mappedContext: ExtensionContextLike = {
+    subscriptions: context.subscriptions,
+    globalStorageUri: { fsPath: context.globalStorageUri.fsPath },
+  };
+
+  const vscodeApi = vscode as unknown as VSCodeAPI;
+  extensionInstance = createPluresExtension(vscodeApi, mappedContext);
+
+  await extensionInstance.activate();
+
+  context.subscriptions.push({
+    dispose: () => {
+      extensionInstance?.deactivate().catch((error) => {
+        console.error("Failed to deactivate PluresDB extension", error);
+      });
+    },
+  });
+
+  return extensionInstance;
+}
+
+export async function deactivate() {
+  await extensionInstance?.deactivate();
+  extensionInstance = undefined;
+}

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "pluresdb",
+  "version": "1.0.1",
+  "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",
+  "exports": {
+    ".": {
+      "types": "./dist/node-index.d.ts",
+      "require": "./dist/node-index.js",
+      "default": "./dist/node-index.js"
+    },
+    "./node": {
+      "types": "./dist/node-index.d.ts",
+      "require": "./dist/node-index.js",
+      "default": "./dist/node-index.js"
+    },
+    "./vscode": {
+      "types": "./dist/vscode/extension.d.ts",
+      "require": "./dist/vscode/extension.js",
+      "default": "./dist/vscode/extension.js"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "require": "./dist/cli.js",
+      "default": "./dist/cli.js"
+    },
+    "./types": {
+      "types": "./dist/types/node-types.d.ts",
+      "require": "./dist/types/node-types.js",
+      "default": "./dist/types/node-types.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "pluresdb": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "npm run build:lib && npm run build:web",
+    "build:lib": "tsc -p tsconfig.json",
+    "build:web": "cd web/svelte && npm install && npm run build",
+    "dev": "deno run -A --unstable-kv --watch src/main.ts serve --port 34567",
+    "start": "node dist/cli.js serve",
+    "test": "deno test -A --unstable-kv",
+    "verify": "npm run build:lib && npm test",
+    "prepare": "npm run build:lib",
+    "prepublishOnly": "npm run verify && npm run build:web",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "keywords": [
+    "database",
+    "graph-database",
+    "p2p",
+    "sqlite",
+    "local-first",
+    "offline-first",
+    "crdt",
+    "vector-search",
+    "deno",
+    "typescript",
+    "vscode",
+    "extension",
+    "embedded",
+    "sync",
+    "encryption"
+  ],
+  "author": "Plures Organization",
+  "license": "AGPL-3.0",
+  "homepage": "https://github.com/plures/pluresdb#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/plures/pluresdb.git"
+  },
+  "bugs": {
+    "url": "https://github.com/plures/pluresdb/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=8.0.0"
+  },
+  "files": [
+    "dist/",
+    "web/svelte/dist/",
+    "src/",
+    "examples/",
+    "scripts/",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "dependencies": {
+    "cors": "^2.8.5",
+    "express": "^4.21.2",
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^4.17.23",
+    "@types/node": "^20.19.19",
+    "@types/vscode": "^1.104.0",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^8.45.0",
+    "@typescript-eslint/parser": "^8.45.0",
+    "eslint": "^9.36.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "prettier": "^3.6.2",
+    "prettier-plugin-svelte": "^3.4.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/scripts/compiled-crud-verify.ts

@@ -0,0 +1,28 @@
+import { GunDB } from "../src/core/database.ts";
+
+const serverUrl = Deno.env.get("SERVER_URL") ?? "ws://localhost:34567";
+
+const clientA = new GunDB();
+const clientB = new GunDB();
+
+const kvA = await Deno.makeTempFile({ prefix: "kv_", suffix: ".sqlite" });
+const kvB = await Deno.makeTempFile({ prefix: "kv_", suffix: ".sqlite" });
+
+await clientA.ready(kvA);
+await clientB.ready(kvB);
+
+clientA.connect(serverUrl);
+clientB.connect(serverUrl);
+
+const id = `bin:crud:${crypto.randomUUID()}`;
+
+const receivedOnB = new Promise<void>((resolve) => clientB.on(id, (n) => n && resolve()));
+
+await clientA.put(id, { text: "compiled works" } as Record<string, unknown>);
+
+await receivedOnB;
+
+await clientA.close();
+await clientB.close();
+
+console.log("COMPILED-CRUD-OK", id);