@elizaos/plugin-sql 1.6.5-alpha.9 → 1.6.5

package/dist/browser/index.browser.d.ts

@@ -1,11 +0,0 @@
-import { type IDatabaseAdapter, type UUID, type Plugin } from '@elizaos/core/browser';
-/**
- * Create a PGlite adapter for the browser (in-memory by default).
- * No Postgres fallback in browser builds.
- */
-export declare function createDatabaseAdapter(_config: {
-    dataDir?: string;
-}, agentId: UUID): IDatabaseAdapter;
-export declare const plugin: Plugin;
-export default plugin;
-export { DatabaseMigrationService } from './migration-service';

package/dist/browser/migration-service.d.ts

@@ -1,43 +0,0 @@
-import { type Plugin } from '@elizaos/core';
-import { RuntimeMigrator } from './runtime-migrator';
-import type { DrizzleDatabase } from './types';
-export declare class DatabaseMigrationService {
-    private db;
-    private registeredSchemas;
-    private migrator;
-    constructor();
-    /**
-     * Initialize service with database connection
-     * @param db - Drizzle database instance
-     */
-    initializeWithDatabase(db: DrizzleDatabase): Promise<void>;
-    /**
-     * Auto-discover and register schemas from plugins
-     * @param plugins - Array of plugins to scan for schemas
-     */
-    discoverAndRegisterPluginSchemas(plugins: Plugin[]): void;
-    /**
-     * Register a schema for a specific plugin
-     * @param pluginName - Plugin identifier
-     * @param schema - Drizzle schema object
-     */
-    registerSchema(pluginName: string, schema: any): void;
-    /**
-     * Run migrations for all registered plugins
-     * @param options - Migration options
-     * @param options.verbose - Log detailed output (default: true in dev, false in prod)
-     * @param options.force - Allow destructive migrations
-     * @param options.dryRun - Preview changes without applying
-     * @throws Error if any migration fails or destructive changes blocked
-     */
-    runAllPluginMigrations(options?: {
-        verbose?: boolean;
-        force?: boolean;
-        dryRun?: boolean;
-    }): Promise<void>;
-    /**
-     * Get the runtime migrator instance for advanced operations
-     * @returns RuntimeMigrator instance or null if not initialized
-     */
-    getMigrator(): RuntimeMigrator | null;
-}

package/dist/browser/pglite/adapter.d.ts

@@ -1,68 +0,0 @@
-import { type UUID, type Agent, type Entity, type Memory } from '@elizaos/core';
-import { BaseDrizzleAdapter } from '../base';
-import { type EmbeddingDimensionColumn } from '../schema/embedding';
-import type { PGliteClientManager } from './manager';
-/**
- * PgliteDatabaseAdapter class represents an adapter for interacting with a PgliteDatabase.
- * Extends BaseDrizzleAdapter.
- *
- * @constructor
- * @param {UUID} agentId - The ID of the agent.
- * @param {PGliteClientManager} manager - The manager for the Pglite client.
- *
- * @method withDatabase
- * @param {() => Promise<T>} operation - The operation to perform on the database.
- * @return {Promise<T>} - The result of the operation.
- *
- * @method init
- * @return {Promise<void>} - A Promise that resolves when the initialization is complete.
- *
- * @method close
- * @return {void} - A Promise that resolves when the database is closed.
- */
-export declare class PgliteDatabaseAdapter extends BaseDrizzleAdapter {
-    private manager;
-    protected embeddingDimension: EmbeddingDimensionColumn;
-    /**
-     * Constructor for creating an instance of a class.
-     * @param {UUID} agentId - The unique identifier for the agent.
-     * @param {PGliteClientManager} manager - The manager for the Pglite client.
-     */
-    constructor(agentId: UUID, manager: PGliteClientManager);
-    getEntityByIds(entityIds: UUID[]): Promise<Entity[] | null>;
-    getMemoriesByServerId(_params: {
-        serverId: UUID;
-        count?: number;
-    }): Promise<Memory[]>;
-    ensureAgentExists(agent: Partial<Agent>): Promise<Agent>;
-    /**
-     * Asynchronously runs the provided database operation while checking if the database is currently shutting down.
-     * If the database is shutting down, a warning is logged and null is returned.
-     *
-     * @param {Function} operation - The database operation to be performed.
-     * @returns {Promise<T>} A promise that resolves with the result of the database operation.
-     */
-    protected withDatabase<T>(operation: () => Promise<T>): Promise<T>;
-    /**
-     * Asynchronously initializes the database by running migrations.
-     *
-     * @returns {Promise<void>} A Promise that resolves when the database initialization is complete.
-     */
-    init(): Promise<void>;
-    /**
-     * Checks if the database connection is ready and active.
-     * For PGLite, this checks if the client is not in a shutting down state.
-     * @returns {Promise<boolean>} A Promise that resolves to true if the connection is healthy.
-     */
-    isReady(): Promise<boolean>;
-    /**
-     * Asynchronously closes the database.
-     */
-    close(): Promise<void>;
-    /**
-     * Asynchronously retrieves the connection from the client.
-     *
-     * @returns {Promise<PGlite>} A Promise that resolves with the connection.
-     */
-    getConnection(): Promise<import("@electric-sql/pglite").PGlite>;
-}

package/dist/browser/pglite/manager.d.ts

@@ -1,21 +0,0 @@
-import { PGlite, type PGliteOptions } from '@electric-sql/pglite';
-import type { IDatabaseClientManager } from '../types';
-/**
- * Class representing a database client manager for PGlite.
- * @implements { IDatabaseClientManager }
- */
-export declare class PGliteClientManager implements IDatabaseClientManager<PGlite> {
-    private client;
-    private shuttingDown;
-    /**
-     * Constructor for creating a new instance of PGlite with the provided options.
-     * Initializes the PGlite client with additional extensions.
-     * @param {PGliteOptions} options - The options to configure the PGlite client.
-     */
-    constructor(options: PGliteOptions);
-    getConnection(): PGlite;
-    isShuttingDown(): boolean;
-    initialize(): Promise<void>;
-    close(): Promise<void>;
-    private setupShutdownHandlers;
-}

package/dist/browser/runtime-migrator/drizzle-adapters/database-introspector.d.ts

@@ -1,62 +0,0 @@
-import type { DrizzleDB, SchemaSnapshot } from '../types';
-/**
- * Introspect the current database state and generate a snapshot
- * This is used when no previous snapshot exists for a plugin
- * to capture the existing database state before migrations
- */
-export declare class DatabaseIntrospector {
-    private db;
-    constructor(db: DrizzleDB);
-    /**
-     * Introspect all tables in the database and generate a snapshot
-     * @param schemaName - Schema to introspect (default: 'public')
-     * @returns Schema snapshot of current database state
-     */
-    introspectSchema(schemaName?: string): Promise<SchemaSnapshot>;
-    /**
-     * Get all tables in a schema
-     */
-    private getTables;
-    /**
-     * Get columns for a table
-     */
-    private getColumns;
-    /**
-     * Get indexes for a table
-     */
-    private getIndexes;
-    /**
-     * Get foreign keys for a table
-     */
-    private getForeignKeys;
-    /**
-     * Get primary keys for a table
-     */
-    private getPrimaryKeys;
-    /**
-     * Get unique constraints for a table
-     */
-    private getUniqueConstraints;
-    /**
-     * Get check constraints for a table
-     */
-    private getCheckConstraints;
-    /**
-     * Get enums in a schema
-     */
-    private getEnums;
-    /**
-     * Parse default value for a column
-     */
-    private parseDefault;
-    /**
-     * Check if tables exist for a plugin by checking if any tables exist in its schema
-     * @param pluginName - Name of the plugin
-     * @returns True if tables exist, false otherwise
-     */
-    hasExistingTables(pluginName: string): Promise<boolean>;
-    /**
-     * Derive schema name from plugin name
-     */
-    private deriveSchemaName;
-}

package/dist/browser/runtime-migrator/drizzle-adapters/diff-calculator.d.ts

@@ -1,59 +0,0 @@
-import type { SchemaSnapshot } from '../types';
-export interface SchemaDiff {
-    tables: {
-        created: string[];
-        deleted: string[];
-        modified: Array<{
-            name: string;
-            changes: any;
-        }>;
-    };
-    columns: {
-        added: Array<{
-            table: string;
-            column: string;
-            definition: any;
-        }>;
-        deleted: Array<{
-            table: string;
-            column: string;
-        }>;
-        modified: Array<{
-            table: string;
-            column: string;
-            changes: any;
-        }>;
-    };
-    indexes: {
-        created: any[];
-        deleted: any[];
-        altered: Array<{
-            old: any;
-            new: any;
-        }>;
-    };
-    foreignKeys: {
-        created: any[];
-        deleted: any[];
-        altered: Array<{
-            old: any;
-            new: any;
-        }>;
-    };
-    uniqueConstraints: {
-        created: any[];
-        deleted: any[];
-    };
-    checkConstraints: {
-        created: any[];
-        deleted: any[];
-    };
-}
-/**
- * Calculate the difference between two snapshots
- */
-export declare function calculateDiff(previousSnapshot: SchemaSnapshot | null, currentSnapshot: SchemaSnapshot): Promise<SchemaDiff>;
-/**
- * Check if a diff has any changes
- */
-export declare function hasDiffChanges(diff: SchemaDiff): boolean;

package/dist/browser/runtime-migrator/drizzle-adapters/snapshot-generator.d.ts

@@ -1,18 +0,0 @@
-import type { SchemaSnapshot } from '../types';
-/**
- * Generate a snapshot from a Drizzle schema
- * This is a port of Drizzle's pgSerializer.generatePgSnapshot
- */
-export declare function generateSnapshot(schema: any): Promise<SchemaSnapshot>;
-/**
- * Calculate hash of a snapshot for change detection
- */
-export declare function hashSnapshot(snapshot: SchemaSnapshot): string;
-/**
- * Create an empty snapshot for initial migration
- */
-export declare function createEmptySnapshot(): SchemaSnapshot;
-/**
- * Compare two snapshots and detect if there are changes
- */
-export declare function hasChanges(previousSnapshot: SchemaSnapshot | null, currentSnapshot: SchemaSnapshot): boolean;

package/dist/browser/runtime-migrator/drizzle-adapters/sql-generator.d.ts

@@ -1,38 +0,0 @@
-import type { SchemaSnapshot } from '../types';
-import type { SchemaDiff } from './diff-calculator';
-/**
- * Data loss detection result
- * Based on Drizzle's pgPushUtils approach
- */
-export interface DataLossCheck {
-    hasDataLoss: boolean;
-    tablesToRemove: string[];
-    columnsToRemove: string[];
-    tablesToTruncate: string[];
-    typeChanges: Array<{
-        table: string;
-        column: string;
-        from: string;
-        to: string;
-    }>;
-    warnings: string[];
-    requiresConfirmation: boolean;
-}
-/**
- * Check for potential data loss in schema changes
- * Based on Drizzle's pgSuggestions function
- */
-export declare function checkForDataLoss(diff: SchemaDiff): DataLossCheck;
-/**
- * Generate SQL statements from a schema diff
- * This follows Drizzle's approach: create all tables first, then add foreign keys
- */
-export declare function generateMigrationSQL(previousSnapshot: SchemaSnapshot | null, currentSnapshot: SchemaSnapshot, diff?: SchemaDiff): Promise<string[]>;
-/**
- * Generate SQL for renaming a table
- */
-export declare function generateRenameTableSQL(oldName: string, newName: string): string;
-/**
- * Generate SQL for renaming a column
- */
-export declare function generateRenameColumnSQL(table: string, oldName: string, newName: string): string;

package/dist/browser/runtime-migrator/extension-manager.d.ts

@@ -1,6 +0,0 @@
-import type { DrizzleDB } from './types';
-export declare class ExtensionManager {
-    private db;
-    constructor(db: DrizzleDB);
-    installRequiredExtensions(extensions: string[]): Promise<void>;
-}

package/dist/browser/runtime-migrator/index.d.ts

@@ -1,8 +0,0 @@
-export { RuntimeMigrator } from './runtime-migrator';
-export * from './types';
-export { MigrationTracker } from './storage/migration-tracker';
-export { JournalStorage } from './storage/journal-storage';
-export { SnapshotStorage } from './storage/snapshot-storage';
-export { generateSnapshot, hashSnapshot, createEmptySnapshot, hasChanges, } from './drizzle-adapters/snapshot-generator';
-export { calculateDiff, hasDiffChanges, type SchemaDiff } from './drizzle-adapters/diff-calculator';
-export { generateMigrationSQL, generateRenameTableSQL, generateRenameColumnSQL, } from './drizzle-adapters/sql-generator';

package/dist/browser/runtime-migrator/runtime-migrator.d.ts

@@ -1,96 +0,0 @@
-import type { DrizzleDB, RuntimeMigrationOptions } from './types';
-import { type DataLossCheck } from './drizzle-adapters/sql-generator';
-export declare class RuntimeMigrator {
-    private db;
-    private migrationTracker;
-    private journalStorage;
-    private snapshotStorage;
-    private extensionManager;
-    private introspector;
-    constructor(db: DrizzleDB);
-    /**
-     * Get expected schema name for a plugin
-     * @elizaos/plugin-sql uses 'public' schema (core application)
-     * All other plugins should use namespaced schemas
-     */
-    private getExpectedSchemaName;
-    /**
-     * Ensure all schemas used in the snapshot exist
-     */
-    private ensureSchemasExist;
-    /**
-     * Validate schema usage and provide warnings
-     */
-    private validateSchemaUsage;
-    /**
-     * Generate a stable advisory lock ID from plugin name
-     * PostgreSQL advisory locks use bigint, so we need to hash the plugin name
-     * and convert to a stable bigint value
-     */
-    private getAdvisoryLockId;
-    /**
-     * Validate that a value is a valid PostgreSQL bigint
-     * PostgreSQL bigint range: -9223372036854775808 to 9223372036854775807
-     */
-    private validateBigInt;
-    /**
-     * Detect if a connection string represents a real PostgreSQL database
-     * (not PGLite, in-memory, or other non-PostgreSQL databases)
-     *
-     * This method handles various connection string formats including:
-     * - Standard postgres:// and postgresql:// URLs
-     * - Cloud provider URLs (AWS, Azure, GCP, Supabase, Neon, etc.)
-     * - Connection strings with query parameters
-     * - Non-standard schemes (pgbouncer://, etc.)
-     * - IP addresses with ports
-     *
-     * @param connectionUrl - Database connection string to check
-     * @returns true if this is a real PostgreSQL database connection
-     */
-    private isRealPostgresDatabase;
-    /**
-     * Initialize migration system - create necessary tables
-     * @throws Error if table creation fails
-     */
-    initialize(): Promise<void>;
-    /**
-     * Run migrations for a plugin/schema
-     * @param pluginName - Plugin identifier
-     * @param schema - Drizzle schema object
-     * @param options - Migration options (verbose, force, dryRun, allowDataLoss)
-     * @throws Error if destructive migrations blocked or migration fails
-     */
-    migrate(pluginName: string, schema: any, options?: RuntimeMigrationOptions): Promise<void>;
-    /**
-     * Execute migration in a transaction
-     */
-    private executeMigration;
-    /**
-     * Generate migration tag (like 0000_jazzy_shard)
-     */
-    private generateMigrationTag;
-    /**
-     * Get migration status for a plugin
-     * @param pluginName - Plugin identifier
-     * @returns Migration history and current state
-     */
-    getStatus(pluginName: string): Promise<{
-        hasRun: boolean;
-        lastMigration: any;
-        journal: any;
-        snapshots: number;
-    }>;
-    /**
-     * Reset migrations for a plugin (dangerous - for development only)
-     * @param pluginName - Plugin identifier
-     * @warning Deletes all migration history - use only in development
-     */
-    reset(pluginName: string): Promise<void>;
-    /**
-     * Check if a migration would cause data loss without executing it
-     * @param pluginName - Plugin identifier
-     * @param schema - Drizzle schema to check
-     * @returns Data loss analysis or null if no changes
-     */
-    checkMigration(pluginName: string, schema: any): Promise<DataLossCheck | null>;
-}

package/dist/browser/runtime-migrator/schema-transformer.d.ts

@@ -1,16 +0,0 @@
-/**
- * Transform a plugin's schema to use the appropriate namespace
- *
- * @elizaos/plugin-sql uses 'public' schema (no transformation)
- * Other plugins get their tables wrapped in a namespaced schema
- */
-export declare function transformPluginSchema(pluginName: string, schema: any): any;
-/**
- * Derive a valid PostgreSQL schema name from a plugin name
- */
-export declare function deriveSchemaName(pluginName: string): string;
-/**
- * Create a namespaced schema helper for plugins
- * This is what plugins should ideally use to define their tables
- */
-export declare function createPluginSchema(pluginName: string): import("drizzle-orm/pg-core").PgSchema<string>;

package/dist/browser/runtime-migrator/storage/journal-storage.d.ts

@@ -1,10 +0,0 @@
-import type { DrizzleDB, Journal, JournalEntry } from '../types';
-export declare class JournalStorage {
-    private db;
-    constructor(db: DrizzleDB);
-    loadJournal(pluginName: string): Promise<Journal | null>;
-    saveJournal(pluginName: string, journal: Journal): Promise<void>;
-    addEntry(pluginName: string, entry: JournalEntry): Promise<void>;
-    getNextIdx(pluginName: string): Promise<number>;
-    updateJournal(pluginName: string, idx: number, tag: string, breakpoints?: boolean): Promise<void>;
-}

package/dist/browser/runtime-migrator/storage/migration-tracker.d.ts

@@ -1,13 +0,0 @@
-import type { DrizzleDB } from '../types';
-export declare class MigrationTracker {
-    private db;
-    constructor(db: DrizzleDB);
-    ensureSchema(): Promise<void>;
-    ensureTables(): Promise<void>;
-    getLastMigration(pluginName: string): Promise<{
-        id: number;
-        hash: string;
-        created_at: string;
-    } | null>;
-    recordMigration(pluginName: string, hash: string, createdAt: number): Promise<void>;
-}

package/dist/browser/runtime-migrator/storage/snapshot-storage.d.ts

@@ -1,9 +0,0 @@
-import type { DrizzleDB, SchemaSnapshot } from '../types';
-export declare class SnapshotStorage {
-    private db;
-    constructor(db: DrizzleDB);
-    saveSnapshot(pluginName: string, idx: number, snapshot: SchemaSnapshot): Promise<void>;
-    loadSnapshot(pluginName: string, idx: number): Promise<SchemaSnapshot | null>;
-    getLatestSnapshot(pluginName: string): Promise<SchemaSnapshot | null>;
-    getAllSnapshots(pluginName: string): Promise<SchemaSnapshot[]>;
-}

package/dist/browser/runtime-migrator/types.d.ts

@@ -1,48 +0,0 @@
-import type { NodePgDatabase } from 'drizzle-orm/node-postgres';
-import type { PgliteDatabase } from 'drizzle-orm/pglite';
-export type DrizzleDB = NodePgDatabase | PgliteDatabase;
-export interface Journal {
-    version: string;
-    dialect: string;
-    entries: JournalEntry[];
-}
-export interface JournalEntry {
-    idx: number;
-    version: string;
-    when: number;
-    tag: string;
-    breakpoints: boolean;
-}
-export interface MigrationMeta {
-    sql: string[];
-    folderMillis: number;
-    hash: string;
-    bps: boolean;
-}
-export interface SchemaSnapshot {
-    version: string;
-    dialect: string;
-    tables: any;
-    schemas: any;
-    enums?: any;
-    _meta: {
-        schemas: any;
-        tables: any;
-        columns: any;
-    };
-    internal?: any;
-}
-export interface MigrationOptions {
-    migrationsTable?: string;
-    migrationsSchema?: string;
-}
-export interface RuntimeMigrationOptions {
-    /** Run without executing SQL statements */
-    dryRun?: boolean;
-    /** Log detailed information about the migration */
-    verbose?: boolean;
-    /** Force migration even in production with destructive changes */
-    force?: boolean;
-    /** Allow operations that will cause data loss (tables/columns being dropped) */
-    allowDataLoss?: boolean;
-}