sandstream-kit 1.0.0

package/dist/database.d.ts

@@ -0,0 +1,123 @@
+export interface DatabaseConfig {
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+    ssl?: boolean;
+    poolSize?: number;
+    maxConnections?: number;
+    idleTimeout?: number;
+    connectionTimeout?: number;
+}
+export interface QueryResult<T = Record<string, unknown>> {
+    rows: T[];
+    rowCount: number;
+    executionTime: number;
+}
+export interface Migration {
+    id: string;
+    name: string;
+    version: string;
+    sql: string;
+    executedAt?: string;
+    executedBy?: string;
+}
+export interface DatabaseHealth {
+    status: "healthy" | "degraded" | "unhealthy";
+    poolSize: number;
+    activeConnections: number;
+    idleConnections: number;
+    waitingRequests: number;
+    lastHealthCheck: string;
+}
+export declare class DatabaseManager {
+    private config;
+    private pool;
+    private migrations;
+    private isInitialized;
+    private queryLog;
+    constructor(config: DatabaseConfig);
+    /**
+     * Initialize database connection pool.
+     */
+    connect(): Promise<void>;
+    /**
+     * Close all connections.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if database is connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Execute a query.
+     */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
+    /**
+     * Execute a query with transaction.
+     */
+    transaction<T>(callback: (db: DatabaseManager) => Promise<T>): Promise<T>;
+    /**
+     * Execute multiple queries in batch.
+     */
+    batch(queries: Array<{
+        sql: string;
+        params: unknown[];
+    }>): Promise<QueryResult[]>;
+    /**
+     * Register a migration.
+     */
+    registerMigration(migration: Migration): void;
+    /**
+     * Run pending migrations.
+     */
+    runMigrations(): Promise<Migration[]>;
+    /**
+     * Get executed migrations.
+     */
+    getExecutedMigrations(): Promise<Migration[]>;
+    /**
+     * Create a database backup.
+     */
+    createBackup(filename: string): Promise<{
+        success: boolean;
+        backupFile: string;
+    }>;
+    /**
+     * Restore from backup.
+     */
+    restoreBackup(backupFile: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Check database health.
+     */
+    getHealth(): Promise<DatabaseHealth>;
+    /**
+     * Get query statistics.
+     */
+    getQueryStats(): {
+        totalQueries: number;
+        averageExecutionTime: number;
+        slowestQuery: {
+            sql: string;
+            duration: number;
+        } | null;
+    };
+    /**
+     * Clear query log (for testing).
+     */
+    clearQueryLog(): void;
+    private logQuery;
+    /**
+     * Get connection pool info.
+     */
+    getPoolInfo(): {
+        size: number;
+        activeConnections: number;
+        idleConnections: number;
+        maxConnections: number;
+    };
+}

package/dist/database.js

@@ -0,0 +1,354 @@
+// ─── Types ────────────────────────────────────────────────────────────────────
+// ─── Database Manager ────────────────────────────────────────────────────────
+export class DatabaseManager {
+    config;
+    pool;
+    migrations = new Map();
+    isInitialized = false;
+    queryLog = [];
+    constructor(config) {
+        this.config = {
+            poolSize: 10,
+            maxConnections: 20,
+            idleTimeout: 30000,
+            connectionTimeout: 5000,
+            ...config,
+        };
+        this.pool = new ConnectionPool(this.config);
+    }
+    // ─── Connection Management ──────────────────────────────────────────────
+    /**
+     * Initialize database connection pool.
+     */
+    async connect() {
+        if (this.isInitialized)
+            return;
+        try {
+            await this.pool.initialize();
+            this.isInitialized = true;
+            // Test connection
+            const result = await this.query("SELECT 1 as test");
+            if (result.rowCount === 0) {
+                throw new Error("Database connection test failed");
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to connect to database: ${error}`);
+        }
+    }
+    /**
+     * Close all connections.
+     */
+    async disconnect() {
+        if (!this.isInitialized)
+            return;
+        await this.pool.drain();
+        this.isInitialized = false;
+    }
+    /**
+     * Check if database is connected.
+     */
+    isConnected() {
+        return this.isInitialized;
+    }
+    // ─── Query Execution ──────────────────────────────────────────────────
+    /**
+     * Execute a query.
+     */
+    async query(sql, params = []) {
+        if (!this.isInitialized) {
+            throw new Error("Database not initialized");
+        }
+        const startTime = Date.now();
+        try {
+            const connection = await this.pool.getConnection();
+            const result = await connection.query(sql, params);
+            this.pool.releaseConnection(connection);
+            const executionTime = Date.now() - startTime;
+            this.logQuery(sql, executionTime);
+            return {
+                rows: result.rows,
+                rowCount: result.rowCount,
+                executionTime,
+            };
+        }
+        catch (error) {
+            throw new Error(`Query failed: ${error}`);
+        }
+    }
+    /**
+     * Execute a query with transaction.
+     */
+    async transaction(callback) {
+        if (!this.isInitialized) {
+            throw new Error("Database not initialized");
+        }
+        const connection = await this.pool.getConnection();
+        try {
+            await connection.query("BEGIN");
+            const result = await callback(this);
+            await connection.query("COMMIT");
+            this.pool.releaseConnection(connection);
+            return result;
+        }
+        catch (error) {
+            await connection.query("ROLLBACK");
+            this.pool.releaseConnection(connection);
+            throw new Error(`Transaction failed: ${error}`);
+        }
+    }
+    /**
+     * Execute multiple queries in batch.
+     */
+    async batch(queries) {
+        if (!this.isInitialized) {
+            throw new Error("Database not initialized");
+        }
+        const results = [];
+        for (const { sql, params } of queries) {
+            const result = await this.query(sql, params);
+            results.push(result);
+        }
+        return results;
+    }
+    // ─── Migrations ──────────────────────────────────────────────────────
+    /**
+     * Register a migration.
+     */
+    registerMigration(migration) {
+        this.migrations.set(migration.id, migration);
+    }
+    /**
+     * Run pending migrations.
+     */
+    async runMigrations() {
+        if (!this.isInitialized) {
+            await this.connect();
+        }
+        const executedMigrations = [];
+        // Create migrations table if it doesn't exist
+        await this.query(`
+      CREATE TABLE IF NOT EXISTS migrations (
+        id VARCHAR(255) PRIMARY KEY,
+        name VARCHAR(255) NOT NULL,
+        version VARCHAR(20) NOT NULL,
+        executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        executed_by VARCHAR(255)
+      )
+    `);
+        // Execute pending migrations
+        for (const [id, migration] of this.migrations) {
+            const executed = await this.query("SELECT 1 FROM migrations WHERE id = $1", [id]);
+            if (executed.rowCount === 0) {
+                try {
+                    await this.query(migration.sql);
+                    await this.query("INSERT INTO migrations (id, name, version, executed_by) VALUES ($1, $2, $3, $4)", [id, migration.name, migration.version, "system"]);
+                    migration.executedAt = new Date().toISOString();
+                    executedMigrations.push(migration);
+                }
+                catch (error) {
+                    throw new Error(`Migration ${migration.name} failed: ${error}`);
+                }
+            }
+        }
+        return executedMigrations;
+    }
+    /**
+     * Get executed migrations.
+     */
+    async getExecutedMigrations() {
+        const result = await this.query("SELECT * FROM migrations ORDER BY executed_at");
+        return result.rows.map((row) => ({
+            id: row.id,
+            name: row.name,
+            version: row.version,
+            executedAt: row.executed_at,
+            executedBy: row.executed_by,
+            sql: "",
+        }));
+    }
+    // ─── Backup & Restore ────────────────────────────────────────────────
+    /**
+     * Create a database backup.
+     */
+    async createBackup(filename) {
+        // In real implementation, would use pg_dump
+        // For now, return mock response
+        return {
+            success: true,
+            backupFile: `backups/${filename}-${Date.now()}.sql`,
+        };
+    }
+    /**
+     * Restore from backup.
+     */
+    async restoreBackup(backupFile) {
+        // In real implementation, would use psql restore
+        // For now, return mock response
+        return {
+            success: true,
+            message: `Restored from ${backupFile}`,
+        };
+    }
+    // ─── Health & Monitoring ──────────────────────────────────────────────
+    /**
+     * Check database health.
+     */
+    async getHealth() {
+        try {
+            const start = Date.now();
+            await this.query("SELECT 1");
+            const responseTime = Date.now() - start;
+            const status = responseTime < 100 ? "healthy" : "degraded";
+            return {
+                status,
+                poolSize: this.config.poolSize || 10,
+                activeConnections: this.pool.getActiveCount(),
+                idleConnections: this.pool.getIdleCount(),
+                waitingRequests: this.pool.getWaitingCount(),
+                lastHealthCheck: new Date().toISOString(),
+            };
+        }
+        catch {
+            return {
+                status: "unhealthy",
+                poolSize: this.config.poolSize || 10,
+                activeConnections: 0,
+                idleConnections: 0,
+                waitingRequests: 0,
+                lastHealthCheck: new Date().toISOString(),
+            };
+        }
+    }
+    /**
+     * Get query statistics.
+     */
+    getQueryStats() {
+        if (this.queryLog.length === 0) {
+            return {
+                totalQueries: 0,
+                averageExecutionTime: 0,
+                slowestQuery: null,
+            };
+        }
+        const totalTime = this.queryLog.reduce((sum, q) => sum + q.duration, 0);
+        const averageTime = totalTime / this.queryLog.length;
+        const slowestQuery = this.queryLog.reduce((max, q) => q.duration > max.duration ? q : max);
+        return {
+            totalQueries: this.queryLog.length,
+            averageExecutionTime: Math.round(averageTime),
+            slowestQuery,
+        };
+    }
+    /**
+     * Clear query log (for testing).
+     */
+    clearQueryLog() {
+        this.queryLog = [];
+    }
+    // ─── Utilities ────────────────────────────────────────────────────────
+    logQuery(sql, duration) {
+        this.queryLog.push({
+            sql,
+            duration,
+            timestamp: new Date().toISOString(),
+        });
+        // Keep only last 1000 queries
+        if (this.queryLog.length > 1000) {
+            this.queryLog = this.queryLog.slice(-1000);
+        }
+    }
+    /**
+     * Get connection pool info.
+     */
+    getPoolInfo() {
+        return {
+            size: this.config.poolSize || 10,
+            activeConnections: this.pool.getActiveCount(),
+            idleConnections: this.pool.getIdleCount(),
+            maxConnections: this.config.maxConnections || 20,
+        };
+    }
+}
+// ─── Connection Pool ────────────────────────────────────────────────────────
+class ConnectionPool {
+    config;
+    available = [];
+    active = new Set();
+    waiting = [];
+    constructor(config) {
+        this.config = config;
+    }
+    async initialize() {
+        const poolSize = this.config.poolSize || 10;
+        for (let i = 0; i < poolSize; i++) {
+            this.available.push(new MockConnection(this.config));
+        }
+    }
+    async getConnection() {
+        if (this.available.length > 0) {
+            const conn = this.available.pop();
+            this.active.add(conn);
+            return conn;
+        }
+        // Wait for a connection to become available
+        return new Promise((resolve) => {
+            this.waiting.push((conn) => {
+                this.active.add(conn);
+                resolve(conn);
+            });
+        });
+    }
+    releaseConnection(conn) {
+        this.active.delete(conn);
+        if (this.waiting.length > 0) {
+            const callback = this.waiting.shift();
+            callback(conn);
+        }
+        else {
+            this.available.push(conn);
+        }
+    }
+    getActiveCount() {
+        return this.active.size;
+    }
+    getIdleCount() {
+        return this.available.length;
+    }
+    getWaitingCount() {
+        return this.waiting.length;
+    }
+    async drain() {
+        this.available = [];
+        this.active.clear();
+        this.waiting = [];
+    }
+}
+// ─── Mock Connection for Testing ────────────────────────────────────────
+class MockConnection {
+    constructor(config) {
+        void config;
+    }
+    async query(sql, params = []) {
+        // Simulate query execution
+        await new Promise((resolve) => setTimeout(resolve, Math.random() * 10));
+        // Handle special test queries
+        if (sql.includes("SELECT 1")) {
+            return {
+                rows: [{ test: 1 }],
+                rowCount: 1,
+            };
+        }
+        if (sql.includes("CREATE TABLE")) {
+            return {
+                rows: [],
+                rowCount: 0,
+            };
+        }
+        return {
+            rows: [],
+            rowCount: 0,
+        };
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

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

package/dist/datadog-adapter.d.ts

@@ -0,0 +1,60 @@
+import { AbstractServiceAdapter, type ServiceConfig, type ServiceEvent, type ServiceHealth } from "./service-adapter.js";
+/**
+ * Datadog adapter for APM, metrics, and analytics.
+ */
+export declare class DatadogAdapter extends AbstractServiceAdapter {
+    private lastHealthCheck;
+    private healthCheckErrors;
+    private metrics;
+    private traces;
+    constructor(config?: ServiceConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    getHealth(): Promise<ServiceHealth>;
+    protected sendEvent(event: ServiceEvent): Promise<void>;
+    /**
+     * Record a metric value.
+     */
+    recordMetric(name: string, value: number, tags?: Record<string, string>): Promise<boolean>;
+    /**
+     * Increment a metric counter.
+     */
+    incrementMetric(name: string, increment?: number): Promise<boolean>;
+    /**
+     * Get current metric value.
+     */
+    getMetric(name: string): number | undefined;
+    /**
+     * Start a trace span.
+     */
+    startSpan(traceId: string, spanName: string, parentSpanId?: string): Promise<string>;
+    /**
+     * End a trace span.
+     */
+    endSpan(spanId: string, status?: "ok" | "error"): Promise<void>;
+    /**
+     * Record a log event.
+     */
+    logEvent(message: string, level?: "debug" | "info" | "warning" | "error", metadata?: Record<string, unknown>): Promise<boolean>;
+    /**
+     * Record a custom event/incident.
+     */
+    recordEvent(title: string, text: string, tags?: Record<string, string>, severity?: "low" | "medium" | "high" | "critical"): Promise<boolean>;
+    /**
+     * Flush all queued events.
+     */
+    private flushQueue;
+    /**
+     * Get Datadog site configuration.
+     */
+    getSiteInfo(): {
+        apiKey: string;
+        site?: string;
+        metricsCount: number;
+        tracesCount: number;
+    };
+}
+/**
+ * Create a Datadog adapter from environment variables.
+ */
+export declare function createDatadogAdapter(enabled?: boolean): DatadogAdapter;