@freshguard/freshguard-core 0.13.2 → 0.15.0

package/dist/connectors/synapse.js

@@ -0,0 +1,495 @@
+/**
+ * Secure Azure Synapse Analytics connector for FreshGuard Core
+ * Extends BaseConnector with security built-in
+ * Uses mssql driver with Synapse-specific configuration
+ *
+ * @module @freshguard/freshguard-core/connectors/synapse
+ */
+import * as mssql from 'mssql';
+import { BaseConnector } from './base-connector.js';
+import { rowString } from '../types/driver-results.js';
+import { ConnectionError, TimeoutError, QueryError, ErrorHandler } from '../errors/index.js';
+import { validateConnectorConfig } from '../validators/index.js';
+/**
+ * Secure Azure Synapse Analytics connector
+ *
+ * SSL is always enforced (Azure requirement). Includes Synapse-specific DMV
+ * support for `dm_pdw_exec_requests`.
+ *
+ * Features:
+ * - SQL injection prevention
+ * - Connection timeouts
+ * - SSL always enforced (Azure requirement)
+ * - Read-only query patterns
+ * - Secure error handling
+ * - Synapse-specific DMV support (dm_pdw_exec_requests)
+ *
+ * @example
+ * ```typescript
+ * import { SynapseConnector } from '@freshguard/freshguard-core';
+ *
+ * const connector = new SynapseConnector({
+ *   host: 'myworkspace.sql.azuresynapse.net', port: 1433,
+ *   database: 'analytics_pool',
+ *   username: 'readonly',
+ *   password: process.env.SYNAPSE_PASSWORD!,
+ * });
+ * ```
+ */
+export class SynapseConnector extends BaseConnector {
+    pool = null;
+    connected = false;
+    /**
+     * @param config - Database connection settings (host, port, database, credentials)
+     * @param securityConfig - Optional overrides for query timeouts, max rows, and blocked keywords
+     */
+    constructor(config, securityConfig) {
+        // Validate configuration before proceeding
+        validateConnectorConfig(config);
+        super(config, securityConfig);
+    }
+    /**
+     * Connect to Azure Synapse Analytics with security validation
+     */
+    async connect() {
+        if (this.connected && this.pool) {
+            return; // Already connected
+        }
+        try {
+            const poolConfig = {
+                server: this.config.host,
+                port: this.config.port ?? 1433,
+                database: this.config.database,
+                user: this.config.username,
+                password: this.config.password,
+                options: {
+                    // Azure Synapse always requires encryption
+                    encrypt: true,
+                    trustServerCertificate: false,
+                    connectTimeout: this.connectionTimeout,
+                    requestTimeout: this.queryTimeout,
+                    appName: this.config.applicationName ?? 'freshguard-core'
+                },
+                pool: {
+                    max: 1, // Single connection for monitoring
+                    min: 0,
+                    idleTimeoutMillis: 30000
+                }
+            };
+            this.pool = new mssql.ConnectionPool(poolConfig);
+            await this.pool.connect();
+            this.connected = true;
+        }
+        catch (error) {
+            throw new ConnectionError('Failed to connect to Azure Synapse Analytics', this.config.host, this.config.port, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Execute a validated SQL query with security measures
+     */
+    async executeQuery(sql) {
+        return this.executeParameterizedQuery(sql, []);
+    }
+    /**
+     * Execute a parameterized SQL query using prepared statements
+     */
+    async executeParameterizedQuery(sql, parameters = []) {
+        await this.connect();
+        if (!this.pool) {
+            throw new ConnectionError('Database connection not available');
+        }
+        try {
+            const result = await this.executeWithTimeout(async () => {
+                if (!this.pool)
+                    throw new ConnectionError('Database connection not available');
+                const request = this.pool.request();
+                // Bind positional parameters as @p1, @p2, etc.
+                for (let i = 0; i < parameters.length; i++) {
+                    request.input(`p${i + 1}`, parameters[i]);
+                }
+                // Replace $N placeholders with @pN for MSSQL
+                let mssqlSql = sql;
+                for (let i = parameters.length; i >= 1; i--) {
+                    mssqlSql = mssqlSql.replace(new RegExp(`\\$${i}`, 'g'), `@p${i}`);
+                }
+                // Also replace ? placeholders with @pN
+                let paramIndex = 0;
+                mssqlSql = mssqlSql.replace(/\?/g, () => `@p${++paramIndex}`);
+                const res = await request.query(mssqlSql);
+                return (res.recordset ?? []);
+            }, this.queryTimeout);
+            // Validate result size for security
+            this.validateResultSize(result);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof TimeoutError) {
+                throw error;
+            }
+            // Sanitize and re-throw as QueryError
+            throw new QueryError(ErrorHandler.getUserMessage(error), 'query_execution', undefined, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Test database connection with security validation
+     */
+    async testConnection(debugConfig) {
+        const mergedDebugConfig = this.mergeDebugConfig(debugConfig);
+        const debugId = `synapse-test-${Date.now().toString(36)}-${Math.random().toString(36).substr(2, 5)}`;
+        const startTime = performance.now();
+        try {
+            this.logDebugInfo(mergedDebugConfig, debugId, 'Starting connection test', {
+                host: this.config.host,
+                port: this.config.port,
+                database: this.config.database,
+                ssl: this.config.ssl
+            });
+            await this.connect();
+            if (!this.pool) {
+                this.logDebugError(mergedDebugConfig, debugId, 'Connection test', {
+                    error: 'Connection not available after connect',
+                    duration: performance.now() - startTime
+                });
+                return false;
+            }
+            // Test with a simple, safe query (skip validation for connection test)
+            const sql = 'SELECT 1 AS test';
+            await this.executeWithTimeout(async () => {
+                if (!this.pool)
+                    throw new ConnectionError('Database connection not available');
+                const request = this.pool.request();
+                return request.query(sql);
+            }, this.connectionTimeout);
+            const duration = performance.now() - startTime;
+            if (mergedDebugConfig?.enabled) {
+                console.log(`[DEBUG-${debugId}] Connection test completed:`, {
+                    success: true,
+                    duration,
+                    host: this.config.host,
+                    database: this.config.database
+                });
+            }
+            return true;
+        }
+        catch (error) {
+            const duration = performance.now() - startTime;
+            this.logDebugError(mergedDebugConfig, debugId, 'Connection test', {
+                host: this.config.host,
+                port: this.config.port,
+                database: this.config.database,
+                error: mergedDebugConfig?.exposeRawErrors && error instanceof Error ? error.message : 'Connection failed',
+                duration,
+                suggestion: this.generateConnectionSuggestion(error)
+            });
+            // Don't throw - this method should return boolean
+            return false;
+        }
+    }
+    /**
+     * Helper method to merge debug configuration
+     */
+    mergeDebugConfig(debugConfig) {
+        return {
+            enabled: debugConfig?.enabled ?? (process.env.NODE_ENV === 'development'),
+            exposeQueries: debugConfig?.exposeQueries ?? true,
+            exposeRawErrors: debugConfig?.exposeRawErrors ?? true,
+            logLevel: debugConfig?.logLevel ?? 'debug'
+        };
+    }
+    /**
+     * Generate connection suggestions based on error (Synapse-specific)
+     */
+    generateConnectionSuggestion(error) {
+        if (!(error instanceof Error)) {
+            return 'Check database connection configuration';
+        }
+        const message = error.message.toLowerCase();
+        if (message.includes('connect econnrefused') || message.includes('connection refused')) {
+            return `Azure Synapse at ${this.config.host}:${this.config.port} is not accepting connections. Verify the SQL pool is running and check firewall rules.`;
+        }
+        if (message.includes('timeout') || message.includes('connect timeout')) {
+            return `Connection timeout to ${this.config.host}:${this.config.port}. The SQL pool may be paused or scaling. Check pool status and firewall rules.`;
+        }
+        if (message.includes('login failed') || message.includes('authentication failed')) {
+            return `Authentication failed for database '${this.config.database}'. Verify username, password, and Azure AD configuration if using AAD auth.`;
+        }
+        if (message.includes('cannot open database') || (message.includes('database') && message.includes('not exist'))) {
+            return `Database '${this.config.database}' not found. Check database name on your Azure Synapse workspace.`;
+        }
+        if (message.includes('ssl') || message.includes('tls') || message.includes('encrypt')) {
+            return `SSL/TLS connection issue. Azure Synapse requires encryption - check SSL certificate configuration.`;
+        }
+        if (message.includes('firewall')) {
+            return `Connection blocked by firewall. Add your client IP address to the Synapse workspace firewall rules.`;
+        }
+        if (message.includes('paused') || message.includes('suspended') || message.includes('resuming')) {
+            return `SQL pool appears to be paused or resuming. Resume the dedicated SQL pool in the Azure portal and wait for it to become available.`;
+        }
+        if (message.includes('dwu') || message.includes('capacity')) {
+            return `SQL pool capacity issue. Check DWU settings and consider scaling up your dedicated SQL pool.`;
+        }
+        return `Connection failed to ${this.config.host}:${this.config.port}. Check host, port, credentials, SQL pool status, and network connectivity.`;
+    }
+    /**
+     * List all tables in the database (including external tables)
+     */
+    async listTables() {
+        const sql = `
+      SELECT TABLE_NAME as table_name
+      FROM INFORMATION_SCHEMA.TABLES
+      WHERE TABLE_TYPE = 'BASE TABLE'
+        AND TABLE_SCHEMA = 'dbo'
+      ORDER BY TABLE_NAME
+    `;
+        await this.validateQuery(sql);
+        try {
+            const result = await this.executeQuery(sql);
+            return result
+                .slice(0, this.maxRows)
+                .map((row) => rowString(row.table_name ?? row.TABLE_NAME ?? row.tablename))
+                .filter(Boolean);
+        }
+        catch (error) {
+            throw new QueryError('Failed to list tables', 'table_listing', undefined, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get table schema information securely
+     */
+    async getTableSchema(table) {
+        // Validate table name (identifiers cannot be parameterized)
+        this.escapeIdentifier(table);
+        const sql = `
+      SELECT
+        COLUMN_NAME as column_name,
+        DATA_TYPE as data_type,
+        IS_NULLABLE as is_nullable
+      FROM INFORMATION_SCHEMA.COLUMNS
+      WHERE TABLE_SCHEMA = 'dbo'
+        AND TABLE_NAME = '${table}'
+      ORDER BY ORDINAL_POSITION
+    `;
+        await this.validateQuery(sql);
+        try {
+            const result = await this.executeQuery(sql);
+            const limited = result.slice(0, this.maxRows);
+            if (limited.length === 0) {
+                throw QueryError.tableNotFound(table);
+            }
+            return {
+                table,
+                columns: limited.map(row => ({
+                    name: rowString(row.column_name ?? row.COLUMN_NAME),
+                    type: this.mapSynapseType(rowString(row.data_type ?? row.DATA_TYPE)),
+                    nullable: (row.is_nullable ?? row.IS_NULLABLE) === 'YES'
+                }))
+            };
+        }
+        catch (error) {
+            if (error instanceof QueryError) {
+                throw error;
+            }
+            throw new QueryError('Failed to get table schema', 'schema_query', table, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get last modified timestamp using Synapse-specific methods
+     */
+    async getLastModified(table) {
+        // Try common timestamp columns
+        const timestampColumns = ['updated_at', 'modified_at', 'last_modified', 'timestamp'];
+        for (const column of timestampColumns) {
+            try {
+                const result = await this.getMaxTimestamp(table, column);
+                if (result) {
+                    return result;
+                }
+            }
+            catch {
+                // Column doesn't exist, try next one
+                continue;
+            }
+        }
+        // Fallback: use Synapse DMV for recent requests against this table
+        try {
+            const sql = `
+        SELECT MAX(end_time) as last_modified
+        FROM sys.dm_pdw_exec_requests
+        WHERE command LIKE '%${this.escapeIdentifier(table).replace(/\[|\]/g, '')}%'
+          AND status = 'Completed'
+          AND resource_class IS NOT NULL
+      `;
+            await this.validateQuery(sql);
+            const result = await this.executeQuery(sql);
+            if (result.length > 0 && result[0]?.last_modified) {
+                return new Date(rowString(result[0].last_modified));
+            }
+        }
+        catch {
+            // DMV query failed, return null
+        }
+        return null;
+    }
+    /**
+     * Close the database connection
+     */
+    async close() {
+        if (this.pool) {
+            try {
+                await this.pool.close();
+            }
+            catch (error) {
+                // Log error but don't throw - closing should be safe
+                console.warn('Warning: Error closing Synapse connection:', ErrorHandler.getUserMessage(error));
+            }
+            finally {
+                this.pool = null;
+                this.connected = false;
+            }
+        }
+    }
+    /**
+     * Map Synapse data types to standard types
+     * Includes Synapse-specific types alongside standard SQL Server types
+     */
+    mapSynapseType(synapseType) {
+        const typeMap = {
+            // Numeric types
+            'tinyint': 'integer',
+            'smallint': 'integer',
+            'int': 'integer',
+            'integer': 'integer',
+            'bigint': 'bigint',
+            'decimal': 'decimal',
+            'numeric': 'decimal',
+            'money': 'decimal',
+            'smallmoney': 'decimal',
+            'float': 'float',
+            'real': 'float',
+            'bit': 'boolean',
+            // String types
+            'char': 'text',
+            'varchar': 'text',
+            'text': 'text',
+            'nchar': 'text',
+            'nvarchar': 'text',
+            'ntext': 'text',
+            // Date/time types
+            'date': 'date',
+            'time': 'time',
+            'datetime': 'timestamp',
+            'datetime2': 'timestamp',
+            'smalldatetime': 'timestamp',
+            'datetimeoffset': 'timestamptz',
+            // Binary types
+            'binary': 'text',
+            'varbinary': 'text',
+            'image': 'text',
+            // Special types
+            'uniqueidentifier': 'text',
+            'xml': 'text',
+            'sql_variant': 'text',
+            'hierarchyid': 'text',
+            'geometry': 'text',
+            'geography': 'text',
+            'timestamp': 'text',
+            'rowversion': 'text'
+        };
+        return typeMap[synapseType.toLowerCase()] ?? 'unknown';
+    }
+    /**
+     * Override escapeIdentifier for SQL Server bracket notation
+     */
+    escapeIdentifier(identifier) {
+        // Only allow alphanumeric, underscore, and dot (for schema.table)
+        if (!/^[a-zA-Z0-9_.]+$/.test(identifier)) {
+            throw new Error(`Invalid identifier: ${identifier}`);
+        }
+        // Additional length check
+        if (identifier.length > 256) {
+            throw new Error('Identifier too long');
+        }
+        // Return with brackets for SQL Server
+        return `[${identifier}]`;
+    }
+    // ==============================================
+    // Legacy API compatibility methods
+    // ==============================================
+    /**
+     * Legacy connect method for backward compatibility
+     * @deprecated Use constructor with ConnectorConfig instead
+     */
+    async connectLegacy(credentials) {
+        console.warn('Warning: connectLegacy is deprecated. Use constructor with ConnectorConfig instead.');
+        // Convert legacy credentials to new format
+        const config = {
+            host: credentials.host ?? '',
+            port: credentials.port ?? 1433,
+            database: credentials.database ?? '',
+            username: credentials.username ?? '',
+            password: credentials.password ?? '',
+            ssl: credentials.sslMode !== 'disable'
+        };
+        // Validate and reconnect
+        validateConnectorConfig(config);
+        this.config = { ...this.config, ...config };
+        await this.connect();
+    }
+    /**
+     * Legacy test connection method for backward compatibility
+     * @deprecated Use testConnection() instead
+     */
+    async testConnectionLegacy() {
+        console.warn('Warning: testConnectionLegacy is deprecated. Use testConnection() instead.');
+        try {
+            const success = await this.testConnection();
+            if (success) {
+                // Get table count for legacy compatibility
+                const tables = await this.listTables();
+                return {
+                    success: true,
+                    tableCount: tables.length
+                };
+            }
+            else {
+                return {
+                    success: false,
+                    error: 'Connection test failed'
+                };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: ErrorHandler.getUserMessage(error)
+            };
+        }
+    }
+    /**
+     * Legacy get table metadata method for backward compatibility
+     * @deprecated Use getRowCount() and getMaxTimestamp() instead
+     */
+    async getTableMetadata(tableName, timestampColumn = 'updated_at') {
+        console.warn('Warning: getTableMetadata is deprecated. Use getRowCount() and getMaxTimestamp() instead.');
+        try {
+            const rowCount = await this.getRowCount(tableName);
+            const lastUpdate = await this.getMaxTimestamp(tableName, timestampColumn);
+            return {
+                rowCount,
+                lastUpdate: lastUpdate ?? undefined
+            };
+        }
+        catch (error) {
+            throw new QueryError('Failed to get table metadata', 'metadata_query', tableName, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Legacy query method for backward compatibility
+     * @deprecated Direct SQL queries are not allowed for security reasons
+     */
+    // eslint-disable-next-line @typescript-eslint/require-await -- deprecated stub that always throws
+    async query(_sql) {
+        throw new Error('Direct SQL queries are not allowed for security reasons. Use specific methods like getRowCount(), getMaxTimestamp(), etc.');
+    }
+}
+//# sourceMappingURL=synapse.js.map

package/dist/connectors/synapse.js.map

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

package/dist/db/index.d.ts

@@ -1,7 +1,32 @@
+/**
+ * Database connection and schema exports
+ *
+ * Creates a Drizzle ORM connection to the FreshGuard metadata database
+ * (PostgreSQL). Used internally for storing check executions, alert logs,
+ * and monitoring rules.
+ *
+ * @module @freshguard/freshguard-core/db
+ */
 import { drizzle } from 'drizzle-orm/postgres-js';
 import * as schema from './schema.js';
 export { schema };
+/**
+ * Create a Drizzle ORM database connection to a PostgreSQL instance.
+ *
+ * @param connectionString - PostgreSQL connection string (e.g. `postgresql://user:pass@host:5432/db`)
+ * @returns Drizzle database instance with the FreshGuard schema loaded
+ *
+ * @example
+ * ```typescript
+ * import { createDatabase } from '@freshguard/freshguard-core';
+ *
+ * const db = createDatabase(process.env.DATABASE_URL!);
+ * ```
+ */
 export declare function createDatabase(connectionString: string): ReturnType<typeof drizzle>;
+/**
+ * Type-safe database instance
+ */
 export type Database = ReturnType<typeof createDatabase>;
 export { runMigrations, getCurrentVersion, needsMigrations, initializeDatabase, getMigrationStatus } from './migrate.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,CAAC;AAOlB,wBAAgB,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAGnF;AAKD,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAGzD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAGnF;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAGzD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,cAAc,CAAC"}

package/dist/db/index.js

@@ -1,10 +1,33 @@
+/**
+ * Database connection and schema exports
+ *
+ * Creates a Drizzle ORM connection to the FreshGuard metadata database
+ * (PostgreSQL). Used internally for storing check executions, alert logs,
+ * and monitoring rules.
+ *
+ * @module @freshguard/freshguard-core/db
+ */
 import { drizzle } from 'drizzle-orm/postgres-js';
 import postgres from 'postgres';
 import * as schema from './schema.js';
 export { schema };
+/**
+ * Create a Drizzle ORM database connection to a PostgreSQL instance.
+ *
+ * @param connectionString - PostgreSQL connection string (e.g. `postgresql://user:pass@host:5432/db`)
+ * @returns Drizzle database instance with the FreshGuard schema loaded
+ *
+ * @example
+ * ```typescript
+ * import { createDatabase } from '@freshguard/freshguard-core';
+ *
+ * const db = createDatabase(process.env.DATABASE_URL!);
+ * ```
+ */
 export function createDatabase(connectionString) {
     const client = postgres(connectionString);
     return drizzle(client, { schema });
 }
+// Export migration utilities
 export { runMigrations, getCurrentVersion, needsMigrations, initializeDatabase, getMigrationStatus } from './migrate.js';
 //# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,CAAC;AAOlB,MAAM,UAAU,cAAc,CAAC,gBAAwB;IACrD,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACrC,CAAC;AAQD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,gBAAwB;IACrD,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACrC,CAAC;AAOD,6BAA6B;AAC7B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,cAAc,CAAC"}

package/dist/db/migrate.d.ts

@@ -1,8 +1,31 @@
+/**
+ * Database migration utilities for FreshGuard Core
+ * @module @freshguard/freshguard-core/db/migrate
+ */
 import type { Database } from './index.js';
+/**
+ * Run all pending migrations
+ *
+ * @param db - Database connection
+ * @param targetVersion - Optional target version to migrate to
+ */
 export declare function runMigrations(db: Database, targetVersion?: number): Promise<void>;
+/**
+ * Get current schema version
+ */
 export declare function getCurrentVersion(db: Database): Promise<number>;
+/**
+ * Check if database needs migrations
+ */
 export declare function needsMigrations(db: Database): Promise<boolean>;
+/**
+ * Initialize a fresh database
+ * This is equivalent to running all migrations
+ */
 export declare function initializeDatabase(db: Database): Promise<void>;
+/**
+ * Get migration status
+ */
 export declare function getMigrationStatus(db: Database): Promise<{
     current: number;
     latest: number;

package/dist/db/migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/db/migrate.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAyF3C,wBAAsB,aAAa,CACjC,EAAE,EAAE,QAAQ,EACZ,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAKD,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAWrE;AAKD,wBAAsB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAQpE;AAMD,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE;AAKD,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC,CAYD"}
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/db/migrate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmF3C;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,QAAQ,EACZ,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAWrE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAQpE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC,CAYD"}