@plures/pluresdb 1.6.10 → 2.9.7

package/legacy/node-wrapper.ts

@@ -1,329 +0,0 @@
-/**
- * Node.js Wrapper for PluresDB
- * This module provides a Node.js-compatible API for VSCode extensions
- */
-
-import { ChildProcess, spawn } from "node:child_process";
-import { EventEmitter } from "node:events";
-import * as path from "node:path";
-import * as fs from "node:fs";
-import * as os from "node:os";
-
-export interface PluresDBConfig {
-  port?: number;
-  host?: string;
-  dataDir?: string;
-  webPort?: number;
-  logLevel?: "debug" | "info" | "warn" | "error";
-}
-
-export interface PluresDBOptions {
-  config?: PluresDBConfig;
-  autoStart?: boolean;
-  denoPath?: string;
-}
-
-export class PluresNode extends EventEmitter {
-  private process: ChildProcess | null = null;
-  private config: PluresDBConfig;
-  private denoPath: string;
-  private isRunning = false;
-  private apiUrl: string = "";
-
-  constructor(options: PluresDBOptions = {}) {
-    super();
-
-    this.config = {
-      port: 34567,
-      host: "localhost",
-      dataDir: path.join(os.homedir(), ".pluresdb"),
-      webPort: 34568,
-      logLevel: "info",
-      ...options.config,
-    };
-
-    this.denoPath = options.denoPath || this.findDenoPath();
-
-    if (options.autoStart !== false) {
-      this.start();
-    }
-  }
-
-  private findDenoPath(): string {
-    // Try to find Deno in common locations
-    const possiblePaths = [
-      "deno", // In PATH
-      path.join(os.homedir(), ".deno", "bin", "deno"),
-      path.join(os.homedir(), ".local", "bin", "deno"),
-      "/usr/local/bin/deno",
-      "/opt/homebrew/bin/deno",
-      "C:\\Users\\" + os.userInfo().username + "\\.deno\\bin\\deno.exe",
-      "C:\\Program Files\\deno\\deno.exe",
-    ];
-
-    for (const denoPath of possiblePaths) {
-      try {
-        if (fs.existsSync(denoPath) || this.isCommandAvailable(denoPath)) {
-          return denoPath;
-        }
-      } catch {
-        // Continue to next path
-      }
-    }
-
-    throw new Error(
-      "Deno not found. Please install Deno from https://deno.land/",
-    );
-  }
-
-  private isCommandAvailable(command: string): boolean {
-    try {
-      require("child_process").execSync(`"${command}" --version`, {
-        stdio: "ignore",
-      });
-      return true;
-    } catch {
-      return false;
-    }
-  }
-
-  async start(): Promise<void> {
-    if (this.isRunning) {
-      return;
-    }
-
-    return new Promise((resolve, reject) => {
-      try {
-        // Ensure data directory exists
-        if (!fs.existsSync(this.config.dataDir!)) {
-          fs.mkdirSync(this.config.dataDir!, { recursive: true });
-        }
-
-        // Find the main.ts file
-        const mainTsPath = path.join(__dirname, "main.ts");
-        if (!fs.existsSync(mainTsPath)) {
-          throw new Error(
-            "PluresDB main.ts not found. Please ensure the package is properly installed.",
-          );
-        }
-
-        // Start the Deno process
-        const args = [
-          "run",
-          "-A",
-          mainTsPath,
-          "serve",
-          "--port",
-          this.config.port!.toString(),
-          "--host",
-          this.config.host!,
-          "--data-dir",
-          this.config.dataDir!,
-        ];
-
-        this.process = spawn(this.denoPath, args, {
-          stdio: ["pipe", "pipe", "pipe"],
-          cwd: path.dirname(__dirname),
-        });
-
-        this.apiUrl = `http://${this.config.host}:${this.config.port}`;
-
-        // Handle process events
-        this.process.on("error", (error) => {
-          this.emit("error", error);
-          reject(error);
-        });
-
-        this.process.on("exit", (code) => {
-          this.isRunning = false;
-          this.emit("exit", code);
-        });
-
-        // Wait for server to start
-        this.waitForServer()
-          .then(() => {
-            this.isRunning = true;
-            this.emit("started");
-            resolve();
-          })
-          .catch(reject);
-
-        // Handle stdout/stderr
-        this.process.stdout?.on("data", (data) => {
-          const output = data.toString();
-          this.emit("stdout", output);
-        });
-
-        this.process.stderr?.on("data", (data) => {
-          const output = data.toString();
-          this.emit("stderr", output);
-        });
-      } catch (error) {
-        reject(error);
-      }
-    });
-  }
-
-  private async waitForServer(timeout = 10000): Promise<void> {
-    const startTime = Date.now();
-
-    while (Date.now() - startTime < timeout) {
-      try {
-        const response = await fetch(`${this.apiUrl}/api/config`);
-        if (response.ok) {
-          return;
-        }
-      } catch {
-        // Server not ready yet
-      }
-
-      await new Promise((resolve) => setTimeout(resolve, 100));
-    }
-
-    throw new Error("Server failed to start within timeout");
-  }
-
-  async stop(): Promise<void> {
-    if (!this.isRunning || !this.process) {
-      return;
-    }
-
-    return new Promise((resolve) => {
-      this.process!.kill("SIGTERM");
-
-      this.process!.on("exit", () => {
-        this.isRunning = false;
-        this.emit("stopped");
-        resolve();
-      });
-
-      // Force kill after 5 seconds
-      setTimeout(() => {
-        if (this.process && this.isRunning) {
-          this.process.kill("SIGKILL");
-        }
-        resolve();
-      }, 5000);
-    });
-  }
-
-  getApiUrl(): string {
-    return this.apiUrl;
-  }
-
-  getWebUrl(): string {
-    return `http://${this.config.host}:${this.config.webPort}`;
-  }
-
-  isServerRunning(): boolean {
-    return this.isRunning;
-  }
-
-  // SQLite-compatible API methods
-  async query(sql: string, params: any[] = []): Promise<any> {
-    const response = await fetch(`${this.apiUrl}/api/query`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ sql, params }),
-    });
-
-    if (!response.ok) {
-      throw new Error(`Query failed: ${response.statusText}`);
-    }
-
-    return response.json();
-  }
-
-  async put(key: string, value: any): Promise<void> {
-    const response = await fetch(`${this.apiUrl}/api/data`, {
-      method: "PUT",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ key, value }),
-    });
-
-    if (!response.ok) {
-      throw new Error(`Put failed: ${response.statusText}`);
-    }
-  }
-
-  async get(key: string): Promise<any> {
-    const response = await fetch(
-      `${this.apiUrl}/api/data/${encodeURIComponent(key)}`,
-    );
-
-    if (!response.ok) {
-      if (response.status === 404) {
-        return null;
-      }
-      throw new Error(`Get failed: ${response.statusText}`);
-    }
-
-    return response.json();
-  }
-
-  async delete(key: string): Promise<void> {
-    const response = await fetch(
-      `${this.apiUrl}/api/data/${encodeURIComponent(key)}`,
-      {
-        method: "DELETE",
-      },
-    );
-
-    if (!response.ok) {
-      throw new Error(`Delete failed: ${response.statusText}`);
-    }
-  }
-
-  async vectorSearch(query: string, limit = 10): Promise<any[]> {
-    const response = await fetch(`${this.apiUrl}/api/vsearch`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ query, limit }),
-    });
-
-    if (!response.ok) {
-      throw new Error(`Vector search failed: ${response.statusText}`);
-    }
-
-    return response.json() as Promise<any[]>;
-  }
-
-  async list(prefix?: string): Promise<string[]> {
-    const url = prefix
-      ? `${this.apiUrl}/api/list?prefix=${encodeURIComponent(prefix)}`
-      : `${this.apiUrl}/api/list`;
-    const response = await fetch(url);
-
-    if (!response.ok) {
-      throw new Error(`List failed: ${response.statusText}`);
-    }
-
-    return response.json() as Promise<string[]>;
-  }
-
-  async getConfig(): Promise<any> {
-    const response = await fetch(`${this.apiUrl}/api/config`);
-
-    if (!response.ok) {
-      throw new Error(`Get config failed: ${response.statusText}`);
-    }
-
-    return response.json();
-  }
-
-  async setConfig(config: any): Promise<void> {
-    const response = await fetch(`${this.apiUrl}/api/config`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(config),
-    });
-
-    if (!response.ok) {
-      throw new Error(`Set config failed: ${response.statusText}`);
-    }
-  }
-}
-
-// Export the main class and types
-export { PluresNode as default };
-export * from "./types/index";

package/legacy/plugins/README.md

@@ -1,181 +0,0 @@
-# PluresDB Plugin System
-
-The PluresDB plugin system allows you to extend the database with custom functionality.
-
-## Plugin Types
-
-### 1. Embedding Providers
-
-Add custom embedding providers for vector search:
-
-```typescript
-// For Deno projects
-import { Plugin, EmbeddingProvider } from "../legacy/plugins/plugin-system.ts";
-
-// For Node.js projects (after compilation)
-// import { Plugin, EmbeddingProvider } from "./legacy/plugins/plugin-system";
-
-class MyEmbeddingProvider implements EmbeddingProvider {
-  name = "my-embeddings";
-  dimensions = 384;
-  
-  async embed(text: string): Promise<number[]> {
-    // Your embedding logic here
-    return new Array(this.dimensions).fill(0);
-  }
-}
-
-const plugin: Plugin = {
-  id: "my-plugin",
-  name: "My Plugin",
-  version: "1.0.0",
-  embeddingProviders: [new MyEmbeddingProvider()],
-};
-```
-
-### 2. UI Panels
-
-Add custom UI panels to the web interface:
-
-```typescript
-import MyPanel from "./MyPanel.svelte";
-
-const plugin: Plugin = {
-  id: "my-ui-plugin",
-  name: "My UI Plugin",
-  version: "1.0.0",
-  uiPanels: [{
-    id: "my-panel",
-    name: "My Panel",
-    icon: "🎨",
-    component: MyPanel,
-    order: 100,
-  }],
-};
-```
-
-### 3. Query Transformers
-
-Transform queries before execution:
-
-```typescript
-const plugin: Plugin = {
-  id: "query-plugin",
-  name: "Query Plugin",
-  version: "1.0.0",
-  queryTransformers: [{
-    id: "my-transformer",
-    async transform(query: any) {
-      // Modify query here
-      return { ...query, enhanced: true };
-    },
-  }],
-};
-```
-
-### 4. Data Validators
-
-Validate data before storage:
-
-```typescript
-const plugin: Plugin = {
-  id: "validator-plugin",
-  name: "Validator Plugin",
-  version: "1.0.0",
-  dataValidators: [{
-    id: "email-validator",
-    async validate(data: Record<string, unknown>) {
-      if (data.email && typeof data.email === "string") {
-        const isValid = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(data.email);
-        if (!isValid) {
-          return {
-            valid: false,
-            errors: ["Invalid email format"],
-          };
-        }
-      }
-      return { valid: true };
-    },
-  }],
-};
-```
-
-## Registering Plugins
-
-```typescript
-// For Deno projects
-import { pluginManager } from "../legacy/plugins/plugin-system.ts";
-import { myPlugin } from "./my-plugin.ts";
-
-// For Node.js projects (after compilation)
-// import { pluginManager } from "./legacy/plugins/plugin-system";
-// import { myPlugin } from "./my-plugin";
-
-// Register plugin
-await pluginManager.register(myPlugin);
-
-// Use custom embedding provider
-const provider = pluginManager.getEmbeddingProvider("my-embeddings");
-if (provider) {
-  const embedding = await provider.embed("Hello, world!");
-}
-
-// Unregister plugin
-await pluginManager.unregister("my-plugin");
-```
-
-## Complete Example
-
-See `example-embedding-plugin.ts` for a complete example plugin.
-
-## API Reference
-
-### Plugin Interface
-
-```typescript
-interface Plugin {
-  id: string;
-  name: string;
-  version: string;
-  description?: string;
-  embeddingProviders?: EmbeddingProvider[];
-  uiPanels?: UIPanel[];
-  queryTransformers?: QueryTransformer[];
-  dataValidators?: DataValidator[];
-  init?(): Promise<void>;
-  destroy?(): Promise<void>;
-}
-```
-
-### PluginManager Methods
-
-- `register(plugin: Plugin): Promise<void>` - Register a plugin
-- `unregister(pluginId: string): Promise<void>` - Unregister a plugin
-- `getPlugins(): Plugin[]` - Get all registered plugins
-- `getEmbeddingProvider(name: string): EmbeddingProvider | undefined`
-- `getEmbeddingProviders(): EmbeddingProvider[]`
-- `getUIPanel(id: string): UIPanel | undefined`
-- `getUIPanels(): UIPanel[]`
-- `getQueryTransformer(id: string): QueryTransformer | undefined`
-- `getQueryTransformers(): QueryTransformer[]`
-- `getDataValidator(id: string): DataValidator | undefined`
-- `getDataValidators(): DataValidator[]`
-- `transformQuery(query: any): Promise<any>` - Apply all transformers
-- `validateData(data: Record<string, unknown>): Promise<{valid: boolean; errors: string[]}>` - Validate with all validators
-
-## Best Practices
-
-1. **Unique IDs**: Use unique, descriptive IDs for plugins and their components
-2. **Error Handling**: Handle errors gracefully in your plugin code
-3. **Cleanup**: Implement `destroy()` to clean up resources
-4. **Documentation**: Document your plugin's functionality and configuration
-5. **Testing**: Test your plugin thoroughly before deployment
-6. **Versioning**: Use semantic versioning for your plugins
-
-## Security Considerations
-
-- Validate all input data in your plugins
-- Avoid storing sensitive data (API keys, etc.) in plugin code
-- Use environment variables for configuration
-- Review third-party dependencies carefully
-- Test plugins in a safe environment before production use

package/legacy/plugins/example-embedding-plugin.ts

@@ -1,56 +0,0 @@
-import type { Plugin, EmbeddingProvider } from "./plugin-system";
-
-/**
- * Example Custom Embedding Provider Plugin
- * 
- * This plugin demonstrates how to add a custom embedding provider to PluresDB.
- * It provides a simple character-based embedding for demonstration purposes.
- */
-
-class SimpleEmbeddingProvider implements EmbeddingProvider {
-  name = "simple-char-embeddings";
-  dimensions = 256;
-
-  /**
-   * Generate simple character-based embeddings
-   * Maps characters to vector positions
-   */
-  async embed(text: string): Promise<number[]> {
-    const vector = new Array(this.dimensions).fill(0);
-    
-    // Simple algorithm: increment vector position for each character
-    for (let i = 0; i < text.length && i < this.dimensions; i++) {
-      const charCode = text.charCodeAt(i);
-      vector[charCode % this.dimensions] += 1;
-    }
-    
-    // Normalize
-    const magnitude = Math.sqrt(vector.reduce((sum, val) => sum + val * val, 0));
-    if (magnitude > 0) {
-      for (let i = 0; i < vector.length; i++) {
-        vector[i] /= magnitude;
-      }
-    }
-    
-    return vector;
-  }
-}
-
-export const customEmbeddingsPlugin: Plugin = {
-  id: "custom-embeddings",
-  name: "Custom Embeddings Provider",
-  version: "1.0.0",
-  description: "Provides a simple character-based embedding provider for PluresDB",
-  
-  embeddingProviders: [
-    new SimpleEmbeddingProvider(),
-  ],
-  
-  async init() {
-    console.log("Custom embeddings plugin initialized");
-  },
-  
-  async destroy() {
-    console.log("Custom embeddings plugin destroyed");
-  },
-};