@freshguard/freshguard-core 0.13.2 → 0.15.0

package/dist/metadata/duckdb-storage.js

@@ -1,3 +1,6 @@
+/**
+ * DuckDB implementation of metadata storage for self-hosting
+ */
 import { DuckDBInstance } from '@duckdb/node-api';
 export class DuckDBMetadataStorage {
     dbPath;
@@ -11,6 +14,7 @@ export class DuckDBMetadataStorage {
             return;
         this.instance = await DuckDBInstance.create(this.dbPath);
         this.connection = await this.instance.connect();
+        // Create tables if they don't exist
         await this.connection.run(`
       CREATE TABLE IF NOT EXISTS check_executions (
         rule_id TEXT NOT NULL,
@@ -131,6 +135,7 @@ export class DuckDBMetadataStorage {
     async saveRule(rule) {
         if (!this.connection)
             throw new Error('DuckDB storage not initialized');
+        // For now, just store minimal fields to satisfy the interface
         await this.connection.run(`
       INSERT OR REPLACE INTO monitoring_rules (
         id, source_id, name, table_name, rule_type, check_interval_minutes,
@@ -176,6 +181,7 @@ export class DuckDBMetadataStorage {
     async storeSchemaBaseline(baseline, adaptationReason) {
         if (!this.connection)
             throw new Error('DuckDB storage not initialized');
+        // Use INSERT OR REPLACE to handle updates
         await this.connection.run(`
       INSERT OR REPLACE INTO schema_baselines (
         rule_id,

package/dist/metadata/duckdb-storage.js.map

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

package/dist/metadata/factory.d.ts

@@ -1,4 +1,34 @@
+/**
+ * Factory for creating metadata storage instances
+ */
 import type { MetadataStorage } from './interface.js';
 import type { MetadataStorageConfig } from './types.js';
+/**
+ * Create and initialize a metadata storage instance.
+ *
+ * Defaults to embedded DuckDB when called without arguments (zero-setup).
+ * Pass a config object to use PostgreSQL or customize the DuckDB path.
+ *
+ * @param config - Optional storage configuration. Omit for default DuckDB storage.
+ * @returns Initialized MetadataStorage ready for use
+ * @throws {Error} If `type` is `'postgresql'` and `url` is not provided
+ *
+ * @example
+ * ```typescript
+ * // Zero-setup DuckDB (default)
+ * const storage = await createMetadataStorage();
+ *
+ * // Custom DuckDB path
+ * const storage = await createMetadataStorage({ type: 'duckdb', path: './data/meta.db' });
+ *
+ * // PostgreSQL
+ * const storage = await createMetadataStorage({
+ *   type: 'postgresql',
+ *   url: 'postgresql://user:pass@host:5432/freshguard_metadata',
+ * });
+ * ```
+ *
+ * @since 0.6.0
+ */
 export declare function createMetadataStorage(config?: MetadataStorageConfig): Promise<MetadataStorage>;
 //# sourceMappingURL=factory.d.ts.map

package/dist/metadata/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/metadata/factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA+BxD,wBAAsB,qBAAqB,CACzC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAoB1B"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/metadata/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAIxD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAoB1B"}

package/dist/metadata/factory.js

@@ -1,8 +1,39 @@
+/**
+ * Factory for creating metadata storage instances
+ */
 import { DuckDBMetadataStorage } from './duckdb-storage.js';
 import { PostgreSQLMetadataStorage } from './postgresql-storage.js';
+/**
+ * Create and initialize a metadata storage instance.
+ *
+ * Defaults to embedded DuckDB when called without arguments (zero-setup).
+ * Pass a config object to use PostgreSQL or customize the DuckDB path.
+ *
+ * @param config - Optional storage configuration. Omit for default DuckDB storage.
+ * @returns Initialized MetadataStorage ready for use
+ * @throws {Error} If `type` is `'postgresql'` and `url` is not provided
+ *
+ * @example
+ * ```typescript
+ * // Zero-setup DuckDB (default)
+ * const storage = await createMetadataStorage();
+ *
+ * // Custom DuckDB path
+ * const storage = await createMetadataStorage({ type: 'duckdb', path: './data/meta.db' });
+ *
+ * // PostgreSQL
+ * const storage = await createMetadataStorage({
+ *   type: 'postgresql',
+ *   url: 'postgresql://user:pass@host:5432/freshguard_metadata',
+ * });
+ * ```
+ *
+ * @since 0.6.0
+ */
 export async function createMetadataStorage(config) {
     let storage;
     if (!config) {
+        // Default to DuckDB for simplicity
         storage = new DuckDBMetadataStorage();
     }
     else if (config.type === 'duckdb') {

package/dist/metadata/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/metadata/factory.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AA6BpE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAA8B;IAE9B,IAAI,OAAwB,CAAC;IAE7B,IAAI,CAAC,MAAM,EAAE,CAAC;QAEZ,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IACxC,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,GAAG,IAAI,yBAAyB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,MAAM,gBAAgB,GAAU,MAAM,CAAC,IAAI,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,yBAAyB,gBAA0B,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/metadata/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAA8B;IAE9B,IAAI,OAAwB,CAAC;IAE7B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,mCAAmC;QACnC,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IACxC,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,GAAG,IAAI,yBAAyB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,MAAM,gBAAgB,GAAU,MAAM,CAAC,IAAI,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,yBAAyB,gBAA0B,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/metadata/index.d.ts

@@ -1,3 +1,29 @@
+/**
+ * Metadata storage for persisting check execution history
+ *
+ * FreshGuard uses a metadata store to record every check execution so that
+ * volume-anomaly baselines and historical trends are available across runs.
+ *
+ * Use the {@link createMetadataStorage} factory to create an instance:
+ * - **DuckDB** (default, zero-setup) — embedded file or `:memory:`
+ * - **PostgreSQL** — shared metadata across multiple workers
+ *
+ * @example
+ * ```typescript
+ * import { createMetadataStorage } from '@freshguard/freshguard-core';
+ *
+ * // Zero-setup embedded DuckDB (default)
+ * const storage = await createMetadataStorage();
+ *
+ * // PostgreSQL for shared deployments
+ * const pgStorage = await createMetadataStorage({
+ *   type: 'postgresql',
+ *   url: process.env.METADATA_DATABASE_URL!,
+ * });
+ * ```
+ *
+ * @module @freshguard/freshguard-core/metadata
+ */
 export type { MetadataStorage } from './interface.js';
 export type { MetadataCheckExecution, MetadataMonitoringRule, MetadataStorageConfig } from './types.js';
 export { createMetadataStorage } from './factory.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxG,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxG,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/metadata/index.js

@@ -1,3 +1,29 @@
+/**
+ * Metadata storage for persisting check execution history
+ *
+ * FreshGuard uses a metadata store to record every check execution so that
+ * volume-anomaly baselines and historical trends are available across runs.
+ *
+ * Use the {@link createMetadataStorage} factory to create an instance:
+ * - **DuckDB** (default, zero-setup) — embedded file or `:memory:`
+ * - **PostgreSQL** — shared metadata across multiple workers
+ *
+ * @example
+ * ```typescript
+ * import { createMetadataStorage } from '@freshguard/freshguard-core';
+ *
+ * // Zero-setup embedded DuckDB (default)
+ * const storage = await createMetadataStorage();
+ *
+ * // PostgreSQL for shared deployments
+ * const pgStorage = await createMetadataStorage({
+ *   type: 'postgresql',
+ *   url: process.env.METADATA_DATABASE_URL!,
+ * });
+ * ```
+ *
+ * @module @freshguard/freshguard-core/metadata
+ */
 export { createMetadataStorage } from './factory.js';
 export { DuckDBMetadataStorage } from './duckdb-storage.js';
 export { PostgreSQLMetadataStorage } from './postgresql-storage.js';

package/dist/metadata/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/metadata/interface.d.ts

@@ -1,4 +1,10 @@
+/**
+ * Core metadata storage abstraction interface
+ */
 import type { MonitoringRule, SchemaBaseline } from '../types.js';
+/**
+ * Simplified execution record for metadata storage
+ */
 interface MetadataExecution {
     ruleId: string;
     status: 'ok' | 'alert' | 'failed' | 'pending';
@@ -13,13 +19,40 @@ interface MetadataExecution {
     error?: string;
 }
 export interface MetadataStorage {
+    /**
+     * Save execution result for historical analysis
+     */
     saveExecution(execution: MetadataExecution): Promise<void>;
+    /**
+     * Get historical execution data for anomaly detection baseline
+     * @param ruleId The monitoring rule ID
+     * @param days Number of days to look back
+     * @returns Array of execution records
+     */
     getHistoricalData(ruleId: string, days: number): Promise<MetadataExecution[]>;
+    /**
+     * Save monitoring rule configuration
+     */
     saveRule(rule: MonitoringRule): Promise<void>;
+    /**
+     * Get monitoring rule by ID
+     */
     getRule(ruleId: string): Promise<MonitoringRule | null>;
+    /**
+     * Store schema baseline for comparison
+     */
     storeSchemaBaseline(baseline: SchemaBaseline, adaptationReason?: string): Promise<void>;
+    /**
+     * Get schema baseline for a rule
+     */
     getSchemaBaseline(ruleId: string): Promise<SchemaBaseline | null>;
+    /**
+     * Initialize storage (create tables, etc.)
+     */
     initialize(): Promise<void>;
+    /**
+     * Close storage connections
+     */
     close(): Promise<void>;
 }
 export {};

package/dist/metadata/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/metadata/interface.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlE,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAI9B,aAAa,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAQ3D,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAK9E,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAK9C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAKxD,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAKxF,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAKlE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAK5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/metadata/interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElE;;GAEG;AACH,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAE9E;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAExD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExF;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAElE;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/metadata/interface.js

@@ -1,2 +1,5 @@
+/**
+ * Core metadata storage abstraction interface
+ */
 export {};
 //# sourceMappingURL=interface.js.map

package/dist/metadata/interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/metadata/interface.ts"],"names":[],"mappings":""}
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/metadata/interface.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/metadata/postgresql-storage.d.ts

@@ -1,3 +1,6 @@
+/**
+ * PostgreSQL implementation of metadata storage using existing Drizzle schema
+ */
 import type { MetadataStorage } from './interface.js';
 import type { MetadataStorageConfig } from './types.js';
 import type { SchemaBaseline, MonitoringRule } from '../types.js';

package/dist/metadata/postgresql-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postgresql-storage.d.ts","sourceRoot":"","sources":["../../src/metadata/postgresql-storage.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlE,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,qBAAa,yBAA0B,YAAW,eAAe;IAO7D,OAAO,CAAC,QAAQ,CAAC,aAAa;IANhC,OAAO,CAAC,MAAM,CAAC,CAAe;IAC9B,OAAO,CAAC,EAAE,CAAC,CAA6B;gBAKrB,aAAa,EAAE,MAAM,EACtC,cAAc,CAAC,EAAE,qBAAqB;IAUlC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,aAAa,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB1D,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAiD7E,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC7C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA4CvD,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCvF,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAyCjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}
+{"version":3,"file":"postgresql-storage.d.ts","sourceRoot":"","sources":["../../src/metadata/postgresql-storage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlE,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,qBAAa,yBAA0B,YAAW,eAAe;IAO7D,OAAO,CAAC,QAAQ,CAAC,aAAa;IANhC,OAAO,CAAC,MAAM,CAAC,CAAe;IAC9B,OAAO,CAAC,EAAE,CAAC,CAA6B;gBAKrB,aAAa,EAAE,MAAM,EACtC,cAAc,CAAC,EAAE,qBAAqB;IAUlC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,aAAa,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB1D,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAiD7E,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC7C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA4CvD,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCvF,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAyCjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/dist/metadata/postgresql-storage.js

@@ -1,3 +1,6 @@
+/**
+ * PostgreSQL implementation of metadata storage using existing Drizzle schema
+ */
 import { drizzle } from 'drizzle-orm/postgres-js';
 import { sql, and, desc, gt } from 'drizzle-orm';
 import postgres from 'postgres';
@@ -8,8 +11,13 @@ export class PostgreSQLMetadataStorage {
     connectionUrl;
     client;
     db;
+    // Schema configuration for future use with custom table names
+    // private _schemaConfig: ResolvedSchemaConfig;
     constructor(connectionUrl, metadataConfig) {
         this.connectionUrl = connectionUrl;
+        // Resolve schema configuration with defaults (for validation)
+        // Schema configuration validation happens in constructor but isn't used yet
+        // TODO: Implement custom table names using resolved configuration
         if (metadataConfig?.schema) {
             new SchemaConfigResolver(metadataConfig);
         }
@@ -20,6 +28,7 @@ export class PostgreSQLMetadataStorage {
         try {
             this.client = postgres(this.connectionUrl);
             this.db = drizzle(this.client);
+            // Test connection by attempting a simple query
             await this.db.execute(sql `SELECT 1`);
         }
         catch (error) {
@@ -34,7 +43,7 @@ export class PostgreSQLMetadataStorage {
         try {
             await this.db.insert(checkExecutions).values({
                 ruleId: execution.ruleId,
-                sourceId: execution.ruleId,
+                sourceId: execution.ruleId, // Use ruleId as sourceId for simplicity
                 status: execution.status,
                 rowCount: execution.rowCount,
                 lagMinutes: execution.lagMinutes,
@@ -169,6 +178,7 @@ export class PostgreSQLMetadataStorage {
             throw MetadataStorageError.initializationFailed('Database not initialized');
         }
         try {
+            // Use Drizzle with ON CONFLICT to handle updates
             await this.db
                 .insert(schemaBaselines)
                 .values({
@@ -221,7 +231,7 @@ export class PostgreSQLMetadataStorage {
             return {
                 ruleId: row.ruleId,
                 tableName: row.tableName,
-                schema: row.schema,
+                schema: row.schema, // JSONB column
                 schemaHash: row.schemaHash,
                 capturedAt: row.capturedAt,
             };

package/dist/metadata/postgresql-storage.js.map

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

package/dist/metadata/schema-config.d.ts

@@ -1,4 +1,15 @@
+/**
+ * Schema configuration resolver for PostgreSQL metadata storage
+ *
+ * Provides configuration resolution with sensible defaults,
+ * table prefix application, and qualified table name generation.
+ *
+ * @license MIT
+ */
 import type { MetadataStorageConfig } from './types.js';
+/**
+ * Resolved schema configuration with applied defaults
+ */
 export interface ResolvedSchemaConfig {
     schemaName: string;
     tablePrefix: string;
@@ -11,20 +22,62 @@ export interface ResolvedSchemaConfig {
         monitoringRules: string;
     };
 }
+/**
+ * Schema configuration resolver
+ *
+ * Resolves metadata storage configuration with defaults and validates parameters.
+ * Provides qualified table names for PostgreSQL operations.
+ */
 export declare class SchemaConfigResolver {
     private readonly config;
     constructor(metadataConfig: MetadataStorageConfig);
+    /**
+     * Get resolved configuration
+     */
     getConfig(): ResolvedSchemaConfig;
+    /**
+     * Get qualified table name (schema.prefix_tableName)
+     */
     getQualifiedTableName(baseTableName: keyof ResolvedSchemaConfig['tables']): string;
+    /**
+     * Get schema name
+     */
     getSchemaName(): string;
+    /**
+     * Get table prefix
+     */
     getTablePrefix(): string;
+    /**
+     * Get table name with prefix applied
+     */
     getTableName(baseTableName: keyof ResolvedSchemaConfig['tables']): string;
+    /**
+     * Resolve configuration with defaults
+     */
     private resolveConfiguration;
+    /**
+     * Apply table prefix to table name
+     */
     private applyTablePrefix;
+    /**
+     * Create qualified table name (schema.table)
+     */
     private createQualifiedName;
+    /**
+     * Validate configuration parameters
+     */
     private validateConfiguration;
+    /**
+     * Check if identifier is valid for PostgreSQL
+     */
     private isValidIdentifier;
+    /**
+     * Check if table prefix is valid
+     */
     private isValidTablePrefix;
+    /**
+     * Check if identifier is a PostgreSQL reserved keyword
+     */
     private isReservedKeyword;
 }
 //# sourceMappingURL=schema-config.d.ts.map

package/dist/metadata/schema-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-config.d.ts","sourceRoot":"","sources":["../../src/metadata/schema-config.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAMxD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,cAAc,EAAE;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAQD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,cAAc,EAAE,qBAAqB;IAQjD,SAAS,IAAI,oBAAoB;IAOjC,qBAAqB,CAAC,aAAa,EAAE,MAAM,oBAAoB,CAAC,QAAQ,CAAC,GAAG,MAAM;IAOlF,aAAa,IAAI,MAAM;IAOvB,cAAc,IAAI,MAAM;IAOxB,YAAY,CAAC,aAAa,EAAE,MAAM,oBAAoB,CAAC,QAAQ,CAAC,GAAG,MAAM;IAOzE,OAAO,CAAC,oBAAoB;IAoC5B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,qBAAqB;IAkC7B,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,iBAAiB;CAY1B"}
+{"version":3,"file":"schema-config.d.ts","sourceRoot":"","sources":["../../src/metadata/schema-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,cAAc,EAAE;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,cAAc,EAAE,qBAAqB;IAKjD;;OAEG;IACH,SAAS,IAAI,oBAAoB;IAIjC;;OAEG;IACH,qBAAqB,CAAC,aAAa,EAAE,MAAM,oBAAoB,CAAC,QAAQ,CAAC,GAAG,MAAM;IAIlF;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,oBAAoB,CAAC,QAAQ,CAAC,GAAG,MAAM;IAIzE;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAY1B"}

package/dist/metadata/schema-config.js

@@ -1,33 +1,68 @@
+/**
+ * Schema configuration resolver for PostgreSQL metadata storage
+ *
+ * Provides configuration resolution with sensible defaults,
+ * table prefix application, and qualified table name generation.
+ *
+ * @license MIT
+ */
 import { ConfigurationError } from '../errors/index.js';
+/**
+ * Schema configuration resolver
+ *
+ * Resolves metadata storage configuration with defaults and validates parameters.
+ * Provides qualified table names for PostgreSQL operations.
+ */
 export class SchemaConfigResolver {
     config;
     constructor(metadataConfig) {
         this.config = this.resolveConfiguration(metadataConfig);
         this.validateConfiguration();
     }
+    /**
+     * Get resolved configuration
+     */
     getConfig() {
         return this.config;
     }
+    /**
+     * Get qualified table name (schema.prefix_tableName)
+     */
     getQualifiedTableName(baseTableName) {
         return this.config.qualifiedNames[baseTableName];
     }
+    /**
+     * Get schema name
+     */
     getSchemaName() {
         return this.config.schemaName;
     }
+    /**
+     * Get table prefix
+     */
     getTablePrefix() {
         return this.config.tablePrefix;
     }
+    /**
+     * Get table name with prefix applied
+     */
     getTableName(baseTableName) {
         return this.config.tables[baseTableName];
     }
+    /**
+     * Resolve configuration with defaults
+     */
     resolveConfiguration(metadataConfig) {
         const schemaConfig = metadataConfig.schema ?? {};
+        // Apply defaults
         const schemaName = schemaConfig.name ?? 'public';
         const tablePrefix = schemaConfig.tablePrefix ?? '';
+        // Apply table prefix to base table names
         const tables = {
             checkExecutions: this.applyTablePrefix(schemaConfig.tables?.checkExecutions ?? 'checkExecutions', tablePrefix),
             monitoringRules: this.applyTablePrefix(schemaConfig.tables?.monitoringRules ?? 'monitoringRules', tablePrefix),
         };
+        // Create qualified names (schema.tableName)
         const qualifiedNames = {
             checkExecutions: this.createQualifiedName(schemaName, tables.checkExecutions),
             monitoringRules: this.createQualifiedName(schemaName, tables.monitoringRules),
@@ -39,48 +74,77 @@ export class SchemaConfigResolver {
             qualifiedNames,
         };
     }
+    /**
+     * Apply table prefix to table name
+     */
     applyTablePrefix(tableName, prefix) {
         if (!prefix)
             return tableName;
+        // Only add prefix if not already present
         if (tableName.startsWith(prefix)) {
             return tableName;
         }
         return `${prefix}${tableName}`;
     }
+    /**
+     * Create qualified table name (schema.table)
+     */
     createQualifiedName(schemaName, tableName) {
+        // For public schema, we can omit it in many contexts, but always include for consistency
         return `${schemaName}.${tableName}`;
     }
+    /**
+     * Validate configuration parameters
+     */
     validateConfiguration() {
+        // Validate schema name
         if (!this.isValidIdentifier(this.config.schemaName)) {
             throw ConfigurationError.invalidValue('schema.name', this.config.schemaName, 'valid PostgreSQL schema name');
         }
+        // Validate table prefix
         if (this.config.tablePrefix && !this.isValidTablePrefix(this.config.tablePrefix)) {
             throw ConfigurationError.invalidValue('schema.tablePrefix', this.config.tablePrefix, 'valid PostgreSQL table prefix');
         }
+        // Validate table names
         Object.entries(this.config.tables).forEach(([key, tableName]) => {
             if (!this.isValidIdentifier(tableName)) {
                 throw ConfigurationError.invalidValue(`schema.tables.${key}`, tableName, 'valid PostgreSQL table name');
             }
         });
     }
+    /**
+     * Check if identifier is valid for PostgreSQL
+     */
     isValidIdentifier(identifier) {
         if (!identifier || typeof identifier !== 'string') {
             return false;
         }
+        // PostgreSQL identifier rules:
+        // - Start with letter or underscore
+        // - Contain only letters, digits, underscores
+        // - Max 63 characters
         const identifierPattern = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
         return (identifier.length <= 63 &&
             identifierPattern.test(identifier) &&
             !this.isReservedKeyword(identifier.toLowerCase()));
     }
+    /**
+     * Check if table prefix is valid
+     */
     isValidTablePrefix(prefix) {
         if (!prefix || typeof prefix !== 'string') {
             return false;
         }
+        // Table prefix should be alphanumeric with underscores, max 20 chars
         const prefixPattern = /^[a-zA-Z0-9_]*$/;
         return (prefix.length <= 20 &&
             prefixPattern.test(prefix));
     }
+    /**
+     * Check if identifier is a PostgreSQL reserved keyword
+     */
     isReservedKeyword(identifier) {
+        // Common PostgreSQL reserved keywords that would cause issues
         const reservedKeywords = new Set([
             'select', 'from', 'where', 'insert', 'update', 'delete', 'create', 'drop',
             'table', 'index', 'view', 'user', 'group', 'order', 'by', 'limit',