@plures/pluresdb 1.5.3 → 2.9.6

package/legacy/better-sqlite3-shared.ts

@@ -1,157 +0,0 @@
-import { QueryResult } from "./types/node-types";
-
-export function isPlainObject(
-  value: unknown,
-): value is Record<string, unknown> {
-  if (value === null || typeof value !== "object") {
-    return false;
-  }
-  const proto = Object.getPrototypeOf(value);
-  return proto === Object.prototype || proto === null;
-}
-
-export function normalizeParameterInput(args: unknown[]): unknown[] {
-  if (args.length === 0) {
-    return [];
-  }
-  if (args.length === 1) {
-    const first = args[0];
-    if (Array.isArray(first)) {
-      return first;
-    }
-    if (isPlainObject(first)) {
-      return [first];
-    }
-    return [first];
-  }
-  return args;
-}
-
-function expandDotNotation(
-  row: Record<string, unknown>,
-): Record<string, unknown> {
-  const result: Record<string, unknown> = {};
-  for (const [key, value] of Object.entries(row)) {
-    const parts = key.split(".");
-    let cursor: Record<string, unknown> = result;
-    for (let index = 0; index < parts.length; index++) {
-      const part = parts[index];
-      if (index === parts.length - 1) {
-        cursor[part] = value;
-      } else {
-        const next = cursor[part];
-        if (!isPlainObject(next)) {
-          cursor[part] = {};
-        }
-        cursor = cursor[part] as Record<string, unknown>;
-      }
-    }
-  }
-  return result;
-}
-
-export function shapeRow(
-  row: unknown,
-  columns: string[] | undefined,
-  mode: { raw: boolean; pluck: boolean; expand: boolean },
-): unknown {
-  if (mode.raw) {
-    return row;
-  }
-
-  let normalized: unknown;
-
-  if (Array.isArray(row)) {
-    if (columns && columns.length > 0) {
-      const mapped: Record<string, unknown> = {};
-      columns.forEach((column, index) => {
-        mapped[column] = row[index];
-      });
-      normalized = mapped;
-    } else {
-      normalized = [...row];
-    }
-  } else if (isPlainObject(row)) {
-    normalized = { ...(row as Record<string, unknown>) };
-  } else {
-    normalized = row;
-  }
-
-  if (mode.pluck) {
-    if (Array.isArray(row)) {
-      return row[0];
-    }
-    if (isPlainObject(row)) {
-      const keys = Object.keys(row as Record<string, unknown>);
-      return keys.length > 0
-        ? (row as Record<string, unknown>)[keys[0]]
-        : undefined;
-    }
-    if (columns && columns.length > 0 && isPlainObject(normalized)) {
-      return (normalized as Record<string, unknown>)[columns[0]];
-    }
-    return normalized;
-  }
-
-  if (mode.expand && isPlainObject(normalized)) {
-    return expandDotNotation(normalized as Record<string, unknown>);
-  }
-
-  return normalized;
-}
-
-export function normalizeQueryResult(raw: unknown): QueryResult {
-  if (
-    raw && typeof raw === "object" && "rows" in (raw as Record<string, unknown>)
-  ) {
-    const result = raw as Partial<QueryResult> & Record<string, unknown>;
-    const columnsValue = Array.isArray(result.columns) ? result.columns : [];
-    const rowsValue = Array.isArray(result.rows) ? result.rows : [];
-    const changesValue = typeof result.changes === "number"
-      ? result.changes
-      : 0;
-    const lastInsertRowIdValue = typeof result.lastInsertRowId === "number"
-      ? result.lastInsertRowId
-      : typeof (result as Record<string, unknown>).lastInsertRowid === "number"
-      ? Number((result as Record<string, unknown>).lastInsertRowid)
-      : 0;
-
-    return {
-      rows: rowsValue,
-      columns: columnsValue,
-      changes: changesValue,
-      lastInsertRowId: lastInsertRowIdValue,
-    };
-  }
-
-  if (Array.isArray(raw)) {
-    return {
-      rows: raw,
-      columns: [],
-      changes: 0,
-      lastInsertRowId: 0,
-    };
-  }
-
-  if (raw === undefined || raw === null) {
-    return { rows: [], columns: [], changes: 0, lastInsertRowId: 0 };
-  }
-
-  return {
-    rows: [raw],
-    columns: [],
-    changes: 0,
-    lastInsertRowId: 0,
-  };
-}
-
-export function splitSqlStatements(sql: string): string[] {
-  return sql
-    .split(/;\s*(?=(?:[^"']|"[^"]*"|'[^']*')*$)/)
-    .map((statement) => statement.trim())
-    .filter((statement) => statement.length > 0);
-}
-
-export function sanitizeDataDirName(name: string): string {
-  return name.replace(/[\s\\/:]+/g, "_").replace(/_+/g, "_");
-}

package/legacy/better-sqlite3.ts

@@ -1,4 +0,0 @@
-import { BetterSQLite3Database, BetterSQLite3Statement } from "./node-index";
-
-export default BetterSQLite3Database;
-export { BetterSQLite3Database, BetterSQLite3Statement };

package/legacy/cli.ts

@@ -1,241 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * CLI wrapper for PluresDB in Node.js environment
- * This allows VSCode extensions to use pluresdb as a regular npm package
- */
-
-import { PluresNode } from "./node-wrapper";
-import * as path from "path";
-import * as fs from "fs";
-import process from "node:process";
-
-// Parse command line arguments
-const args = process.argv.slice(2);
-const command = args[0];
-
-if (!command) {
-  console.log(`
-PluresDB - P2P Graph Database with SQLite Compatibility
-
-Usage: pluresdb <command> [options]
-
-Commands:
-  serve                    Start the PluresDB server
-  put <key> <value>        Store a key-value pair
-  get <key>                Retrieve a value by key
-  delete <key>             Delete a key-value pair
-  query <sql>              Execute SQL query
-  vsearch <query>          Perform vector search
-  list [prefix]            List all keys (optionally with prefix)
-  config                   Show configuration
-  config set <key> <value> Set configuration value
-  --help                   Show this help message
-  --version                Show version
-
-Examples:
-  pluresdb serve --port 8080
-  pluresdb put "user:123" '{"name": "John"}'
-  pluresdb get "user:123"
-  pluresdb query "SELECT * FROM users"
-  pluresdb vsearch "machine learning"
-`);
-  process.exit(0);
-}
-
-if (command === "--version") {
-  const packageJson = JSON.parse(
-    fs.readFileSync(path.join(__dirname, "../package.json"), "utf8"),
-  );
-  console.log(packageJson.version);
-  process.exit(0);
-}
-
-if (command === "--help") {
-  console.log(`
-PluresDB - P2P Graph Database with SQLite Compatibility
-
-Usage: pluresdb <command> [options]
-
-Commands:
-  serve                    Start the PluresDB server
-  put <key> <value>        Store a key-value pair
-  get <key>                Retrieve a value by key
-  delete <key>             Delete a key-value pair
-  query <sql>              Execute SQL query
-  vsearch <query>          Perform vector search
-  list [prefix]            List all keys (optionally with prefix)
-  config                   Show configuration
-  config set <key> <value> Set configuration value
-  --help                   Show this help message
-  --version                Show version
-
-Examples:
-  pluresdb serve --port 8080
-  pluresdb put "user:123" '{"name": "John"}'
-  pluresdb get "user:123"
-  pluresdb query "SELECT * FROM users"
-  pluresdb vsearch "machine learning"
-`);
-  process.exit(0);
-}
-
-// Parse options
-const options: any = {};
-let i = 1;
-while (i < args.length) {
-  const arg = args[i];
-  if (arg.startsWith("--")) {
-    const key = arg.substring(2);
-    const value = args[i + 1];
-    if (value && !value.startsWith("--")) {
-      options[key] = value;
-      i += 2;
-    } else {
-      options[key] = true;
-      i += 1;
-    }
-  } else {
-    i += 1;
-  }
-}
-
-async function main() {
-  try {
-    if (command === "serve") {
-      const config = {
-        port: options.port ? parseInt(options.port) : 34567,
-        host: options.host || "localhost",
-        dataDir: options["data-dir"] ||
-          path.join(require("os").homedir(), ".pluresdb"),
-        webPort: options["web-port"] ? parseInt(options["web-port"]) : 34568,
-        logLevel: options["log-level"] || "info",
-      };
-
-      const plures = new PluresNode({ config, autoStart: true });
-
-      console.log(`🚀 PluresDB server starting...`);
-      console.log(`📊 API: http://${config.host}:${config.port}`);
-      console.log(`🌐 Web UI: http://${config.host}:${config.webPort}`);
-      console.log(`📁 Data: ${config.dataDir}`);
-      console.log(`\nPress Ctrl+C to stop the server`);
-
-      // Handle graceful shutdown
-      process.on("SIGINT", async () => {
-        console.log("\n🛑 Shutting down PluresDB...");
-        await plures.stop();
-        process.exit(0);
-      });
-
-      // Keep the process alive
-      await new Promise(() => {});
-    } else {
-      // For other commands, we need to start the server first
-      const plures = new PluresNode({ autoStart: true });
-
-      try {
-        switch (command) {
-          case "put":
-            if (args.length < 3) {
-              console.error("Error: put command requires key and value");
-              process.exit(1);
-            }
-            const key = args[1];
-            const value = JSON.parse(args[2]);
-            await plures.put(key, value);
-            console.log(`✅ Stored: ${key}`);
-            break;
-
-          case "get":
-            if (args.length < 2) {
-              console.error("Error: get command requires key");
-              process.exit(1);
-            }
-            const getKey = args[1];
-            const result = await plures.get(getKey);
-            if (result === null) {
-              console.log("Key not found");
-            } else {
-              console.log(JSON.stringify(result, null, 2));
-            }
-            break;
-
-          case "delete":
-            if (args.length < 2) {
-              console.error("Error: delete command requires key");
-              process.exit(1);
-            }
-            const deleteKey = args[1];
-            await plures.delete(deleteKey);
-            console.log(`✅ Deleted: ${deleteKey}`);
-            break;
-
-          case "query":
-            if (args.length < 2) {
-              console.error("Error: query command requires SQL");
-              process.exit(1);
-            }
-            const sql = args[1];
-            const queryResult = await plures.query(sql);
-            console.log(JSON.stringify(queryResult, null, 2));
-            break;
-
-          case "vsearch":
-            if (args.length < 2) {
-              console.error("Error: vsearch command requires query");
-              process.exit(1);
-            }
-            const searchQuery = args[1];
-            const limit = options.limit ? parseInt(options.limit) : 10;
-            const searchResult = await plures.vectorSearch(searchQuery, limit);
-            console.log(JSON.stringify(searchResult, null, 2));
-            break;
-
-          case "list":
-            const prefix = args[1];
-            const listResult = await plures.list(prefix);
-            console.log(JSON.stringify(listResult, null, 2));
-            break;
-
-          case "config":
-            if (args[1] === "set") {
-              if (args.length < 4) {
-                console.error("Error: config set requires key and value");
-                process.exit(1);
-              }
-              const configKey = args[2];
-              const configValue = args[3];
-              await plures.setConfig({ [configKey]: configValue });
-              console.log(`✅ Set config: ${configKey} = ${configValue}`);
-            } else {
-              const config = await plures.getConfig();
-              console.log(JSON.stringify(config, null, 2));
-            }
-            break;
-
-          default:
-            console.error(`Unknown command: ${command}`);
-            console.log('Run "pluresdb --help" for usage information');
-            process.exit(1);
-        }
-      } finally {
-        await plures.stop();
-      }
-    }
-  } catch (error) {
-    console.error(
-      "Error:",
-      error instanceof Error ? error.message : String(error),
-    );
-    process.exit(1);
-  }
-}
-
-// Run the main function
-main().catch((error) => {
-  console.error(
-    "Fatal error:",
-    error instanceof Error ? error.message : String(error),
-  );
-  process.exit(1);
-});

package/legacy/config.ts

@@ -1,50 +0,0 @@
-export interface AppConfig {
-  kvPath?: string;
-  port?: number;
-  peers?: string[];
-  apiPortOffset?: number; // default 1
-}
-
-export async function loadConfig(): Promise<AppConfig> {
-  const path = getConfigPath();
-  try {
-    const text = await Deno.readTextFile(path);
-    const cfg = JSON.parse(text) as AppConfig;
-    return cfg;
-  } catch {
-    return {};
-  }
-}
-
-export async function saveConfig(cfg: AppConfig): Promise<void> {
-  const path = getConfigPath();
-  await ensureDirForFile(path);
-  await Deno.writeTextFile(path, JSON.stringify(cfg, null, 2));
-}
-
-export function getConfigPath(): string {
-  const appName = "PluresDB";
-  try {
-    const os = Deno.build.os;
-    if (os === "windows") {
-      const appData = Deno.env.get("APPDATA") || Deno.env.get("LOCALAPPDATA") ||
-        ".";
-      return `${appData}\\${appName}\\config.json`;
-    }
-    const home = Deno.env.get("HOME") || ".";
-    return `${home}/.${appName.toLowerCase()}/config.json`;
-  } catch {
-    return `./config.json`;
-  }
-}
-
-async function ensureDirForFile(filePath: string): Promise<void> {
-  const sep = filePath.includes("\\") ? "\\" : "/";
-  const dir = filePath.split(sep).slice(0, -1).join(sep);
-  if (!dir) return;
-  try {
-    await Deno.mkdir(dir, { recursive: true });
-  } catch {
-    /* ignore */
-  }
-}

package/legacy/core/crdt.ts

@@ -1,107 +0,0 @@
-import type { NodeRecord, VectorClock } from "../types/index.ts";
-
-export function mergeVectorClocks(a: VectorClock, b: VectorClock): VectorClock {
-  const merged: VectorClock = {};
-  const keys = new Set([...Object.keys(a ?? {}), ...Object.keys(b ?? {})]);
-  for (const key of keys) {
-    merged[key] = Math.max(a?.[key] ?? 0, b?.[key] ?? 0);
-  }
-  return merged;
-}
-
-function isPlainObject(val: unknown): val is Record<string, unknown> {
-  return typeof val === "object" && val !== null && !Array.isArray(val);
-}
-
-function deepMergeWithDeletes(
-  base: Record<string, unknown>,
-  incoming: Record<string, unknown>,
-  baseState: Record<string, number> | undefined,
-  incomingState: Record<string, number> | undefined,
-  now: number,
-): { data: Record<string, unknown>; state: Record<string, number> } {
-  const out: Record<string, unknown> = { ...base };
-  const outState: Record<string, number> = { ...(baseState ?? {}) };
-  for (const [key, incVal] of Object.entries(incoming)) {
-    const baseVal = out[key];
-    const incTs = (incomingState ?? {})[key] ?? now; // default to now if missing
-    const baseTs = (baseState ?? {})[key] ?? 0;
-    if (incTs < baseTs) continue; // base wins
-
-    if (incVal === null) {
-      delete out[key];
-      outState[key] = incTs;
-      continue;
-    }
-    if (isPlainObject(baseVal) && isPlainObject(incVal)) {
-      const merged = deepMergeWithDeletes(
-        baseVal as Record<string, unknown>,
-        incVal as Record<string, unknown>,
-        baseState,
-        incomingState,
-        now,
-      );
-      out[key] = merged.data;
-      outState[key] = incTs;
-    } else {
-      out[key] = incVal as unknown;
-      outState[key] = incTs;
-    }
-  }
-  return { data: out, state: outState };
-}
-
-export function mergeNodes(
-  local: NodeRecord | null,
-  incoming: NodeRecord,
-): NodeRecord {
-  if (!local) return incoming;
-  if (local.id !== incoming.id) {
-    throw new Error("mergeNodes called with mismatched ids");
-  }
-
-  if (incoming.timestamp > local.timestamp) {
-    const merged = deepMergeWithDeletes(
-      local.data,
-      incoming.data,
-      local.state,
-      incoming.state,
-      incoming.timestamp,
-    );
-    return {
-      id: local.id,
-      data: merged.data,
-      vector: incoming.vector ?? local.vector,
-      type: incoming.type ?? local.type,
-      timestamp: incoming.timestamp,
-      state: merged.state,
-      vectorClock: mergeVectorClocks(local.vectorClock, incoming.vectorClock),
-    };
-  }
-  if (incoming.timestamp < local.timestamp) {
-    return {
-      ...local,
-      vectorClock: mergeVectorClocks(local.vectorClock, incoming.vectorClock),
-    };
-  }
-
-  // Equal timestamps: deterministic field-wise merge with per-field state
-  const merged = deepMergeWithDeletes(
-    local.data,
-    incoming.data,
-    local.state,
-    incoming.state,
-    incoming.timestamp,
-  );
-  const mergedVector = incoming.vector ?? local.vector;
-  const mergedType = incoming.type ?? local.type;
-  return {
-    id: local.id,
-    data: merged.data,
-    vector: mergedVector,
-    type: mergedType,
-    timestamp: incoming.timestamp, // ties keep timestamp
-    state: merged.state,
-    vectorClock: mergeVectorClocks(local.vectorClock, incoming.vectorClock),
-  };
-}