@vorionsys/security 1.0.0

package/dist/common/provenance/query.js

@@ -0,0 +1,310 @@
+/**
+ * Provenance Query Builder
+ *
+ * Fluent query builder for provenance records with pagination and export support.
+ *
+ * @packageDocumentation
+ */
+import { trace, SpanStatusCode } from '@opentelemetry/api';
+import { createLogger } from '../logger.js';
+const logger = createLogger({ component: 'provenance-query' });
+const tracer = trace.getTracer('provenance-query');
+/**
+ * Query builder for provenance records
+ */
+export class ProvenanceQueryBuilder {
+    storage;
+    filters = {};
+    pagination = { limit: 100, offset: 0 };
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Filter by entity ID
+     */
+    forEntity(entityId) {
+        this.filters.entityId = entityId;
+        return this;
+    }
+    /**
+     * Filter by entity type
+     */
+    ofType(entityType) {
+        this.filters.entityType = entityType;
+        return this;
+    }
+    /**
+     * Filter by actor ID
+     */
+    byActor(actorId) {
+        this.filters.actorId = actorId;
+        return this;
+    }
+    /**
+     * Filter by actor type
+     */
+    byActorType(actorType) {
+        this.filters.actorType = actorType;
+        return this;
+    }
+    /**
+     * Filter by action
+     */
+    withAction(action) {
+        this.filters.action = action;
+        return this;
+    }
+    /**
+     * Filter by tenant
+     */
+    inTenant(tenantId) {
+        this.filters.tenantId = tenantId;
+        return this;
+    }
+    /**
+     * Filter by time range
+     */
+    inTimeRange(from, to) {
+        if (from) {
+            this.filters.from = from;
+        }
+        if (to) {
+            this.filters.to = to;
+        }
+        return this;
+    }
+    /**
+     * Filter from a specific date
+     */
+    since(from) {
+        this.filters.from = from;
+        return this;
+    }
+    /**
+     * Filter until a specific date
+     */
+    until(to) {
+        this.filters.to = to;
+        return this;
+    }
+    /**
+     * Set pagination limit
+     */
+    limit(limit) {
+        this.pagination.limit = Math.min(limit, 1000);
+        return this;
+    }
+    /**
+     * Set pagination offset
+     */
+    offset(offset) {
+        this.pagination.offset = offset;
+        return this;
+    }
+    /**
+     * Set page number (1-indexed)
+     */
+    page(pageNumber, pageSize = 100) {
+        this.pagination.limit = Math.min(pageSize, 1000);
+        this.pagination.offset = (pageNumber - 1) * this.pagination.limit;
+        return this;
+    }
+    /**
+     * Execute the query and return paginated results
+     */
+    async execute() {
+        return tracer.startActiveSpan('provenance.query.execute', async (span) => {
+            try {
+                span.setAttribute('filters', JSON.stringify(this.filters));
+                span.setAttribute('pagination', JSON.stringify(this.pagination));
+                const result = await this.storage.query(this.filters, this.pagination);
+                logger.debug({
+                    filters: this.filters,
+                    pagination: this.pagination,
+                    resultCount: result.items.length,
+                    total: result.total,
+                }, 'Query executed');
+                span.setStatus({ code: SpanStatusCode.OK });
+                return result;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                span.setStatus({ code: SpanStatusCode.ERROR, message: errorMessage });
+                logger.error({ error }, 'Query execution failed');
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    /**
+     * Execute query and return all matching records (with pagination handling)
+     */
+    async all() {
+        return tracer.startActiveSpan('provenance.query.all', async (span) => {
+            try {
+                const allRecords = [];
+                let offset = 0;
+                const batchSize = 1000;
+                while (true) {
+                    this.pagination.offset = offset;
+                    this.pagination.limit = batchSize;
+                    const result = await this.storage.query(this.filters, this.pagination);
+                    allRecords.push(...result.items);
+                    if (!result.hasMore) {
+                        break;
+                    }
+                    offset += batchSize;
+                }
+                span.setAttribute('total.records', allRecords.length);
+                span.setStatus({ code: SpanStatusCode.OK });
+                return allRecords;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                span.setStatus({ code: SpanStatusCode.ERROR, message: errorMessage });
+                logger.error({ error }, 'Failed to get all records');
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    /**
+     * Execute query and return first matching record
+     */
+    async first() {
+        this.pagination.limit = 1;
+        const result = await this.execute();
+        return result.items[0] ?? null;
+    }
+    /**
+     * Execute query and return count of matching records
+     */
+    async count() {
+        this.pagination.limit = 1;
+        const result = await this.execute();
+        return result.total;
+    }
+    /**
+     * Export query results to specified format
+     */
+    async export(format) {
+        return tracer.startActiveSpan('provenance.query.export', async (span) => {
+            try {
+                span.setAttribute('format', format);
+                const records = await this.all();
+                let output;
+                switch (format) {
+                    case 'json':
+                        output = this.exportToJson(records);
+                        break;
+                    case 'csv':
+                        output = this.exportToCsv(records);
+                        break;
+                    default:
+                        throw new Error(`Unsupported export format: ${format}`);
+                }
+                logger.debug({ format, recordCount: records.length }, 'Export complete');
+                span.setStatus({ code: SpanStatusCode.OK });
+                return output;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                span.setStatus({ code: SpanStatusCode.ERROR, message: errorMessage });
+                logger.error({ error }, 'Export failed');
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    /**
+     * Export records to JSON format
+     */
+    exportToJson(records) {
+        return JSON.stringify({
+            exportedAt: new Date().toISOString(),
+            filters: this.filters,
+            recordCount: records.length,
+            records,
+        }, null, 2);
+    }
+    /**
+     * Export records to CSV format
+     */
+    exportToCsv(records) {
+        if (records.length === 0) {
+            return 'id,entityId,entityType,action,actorId,actorType,hash,chainPosition,tenantId,createdAt\n';
+        }
+        const headers = [
+            'id',
+            'entityId',
+            'entityType',
+            'action',
+            'actorId',
+            'actorType',
+            'hash',
+            'previousHash',
+            'chainPosition',
+            'tenantId',
+            'createdAt',
+            'data',
+            'metadata',
+        ];
+        const rows = records.map((record) => {
+            return [
+                this.escapeCsvField(record.id),
+                this.escapeCsvField(record.entityId),
+                this.escapeCsvField(record.entityType),
+                this.escapeCsvField(record.action),
+                this.escapeCsvField(record.actor.id),
+                this.escapeCsvField(record.actor.type),
+                this.escapeCsvField(record.hash),
+                this.escapeCsvField(record.previousHash),
+                record.chainPosition.toString(),
+                this.escapeCsvField(record.tenantId),
+                this.escapeCsvField(record.createdAt),
+                this.escapeCsvField(JSON.stringify(record.data)),
+                this.escapeCsvField(JSON.stringify(record.metadata ?? {})),
+            ].join(',');
+        });
+        return [headers.join(','), ...rows].join('\n');
+    }
+    /**
+     * Escape a field for CSV output
+     */
+    escapeCsvField(value) {
+        if (value.includes(',') || value.includes('"') || value.includes('\n')) {
+            return `"${value.replace(/"/g, '""')}"`;
+        }
+        return value;
+    }
+    /**
+     * Clone the query builder with current state
+     */
+    clone() {
+        const cloned = new ProvenanceQueryBuilder(this.storage);
+        cloned.filters = { ...this.filters };
+        cloned.pagination = { ...this.pagination };
+        return cloned;
+    }
+    /**
+     * Reset all filters and pagination
+     */
+    reset() {
+        this.filters = {};
+        this.pagination = { limit: 100, offset: 0 };
+        return this;
+    }
+}
+/**
+ * Create a new query builder
+ */
+export function createQueryBuilder(storage) {
+    return new ProvenanceQueryBuilder(storage);
+}
+//# sourceMappingURL=query.js.map

package/dist/common/provenance/query.js.map

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

package/dist/common/provenance/storage.d.ts

@@ -0,0 +1,297 @@
+/**
+ * Provenance Storage
+ *
+ * Storage interface and implementations for provenance records.
+ * Includes in-memory storage for testing and PostgreSQL for production.
+ *
+ * @packageDocumentation
+ */
+import type { ProvenanceRecord, ProvenanceQueryFilters, PaginationOptions, PaginatedResult, Actor } from './types.js';
+/**
+ * Provenance records table schema
+ */
+export declare const provenanceRecords: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "provenance_records";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "provenance_records";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        entityId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "entity_id";
+            tableName: "provenance_records";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        entityType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "entity_type";
+            tableName: "provenance_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        action: import("drizzle-orm/pg-core").PgColumn<{
+            name: "action";
+            tableName: "provenance_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        data: import("drizzle-orm/pg-core").PgColumn<{
+            name: "data";
+            tableName: "provenance_records";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, unknown>;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, unknown>;
+        }>;
+        actor: import("drizzle-orm/pg-core").PgColumn<{
+            name: "actor";
+            tableName: "provenance_records";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Actor;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Actor;
+        }>;
+        hash: import("drizzle-orm/pg-core").PgColumn<{
+            name: "hash";
+            tableName: "provenance_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        previousHash: import("drizzle-orm/pg-core").PgColumn<{
+            name: "previous_hash";
+            tableName: "provenance_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        chainPosition: import("drizzle-orm/pg-core").PgColumn<{
+            name: "chain_position";
+            tableName: "provenance_records";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        tenantId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "tenant_id";
+            tableName: "provenance_records";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        metadata: import("drizzle-orm/pg-core").PgColumn<{
+            name: "metadata";
+            tableName: "provenance_records";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, unknown>;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, unknown>;
+        }>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "provenance_records";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+/**
+ * Storage interface for provenance records
+ */
+export interface ProvenanceStorage {
+    /**
+     * Save a provenance record
+     */
+    save(record: ProvenanceRecord): Promise<ProvenanceRecord>;
+    /**
+     * Save multiple provenance records in batch
+     */
+    saveBatch(records: ProvenanceRecord[]): Promise<ProvenanceRecord[]>;
+    /**
+     * Get a provenance record by ID
+     */
+    getById(id: string, tenantId: string): Promise<ProvenanceRecord | null>;
+    /**
+     * Get provenance records by entity ID
+     */
+    getByEntityId(entityId: string, tenantId: string, options?: PaginationOptions): Promise<PaginatedResult<ProvenanceRecord>>;
+    /**
+     * Query provenance records with filters
+     */
+    query(filters: ProvenanceQueryFilters, options?: PaginationOptions): Promise<PaginatedResult<ProvenanceRecord>>;
+    /**
+     * Delete provenance records for an entity (for testing)
+     */
+    deleteByEntityId(entityId: string, tenantId: string): Promise<number>;
+    /**
+     * Clear all records (for testing)
+     */
+    clear(): Promise<void>;
+}
+/**
+ * In-memory storage implementation for testing
+ */
+export declare class InMemoryProvenanceStorage implements ProvenanceStorage {
+    private records;
+    save(record: ProvenanceRecord): Promise<ProvenanceRecord>;
+    saveBatch(records: ProvenanceRecord[]): Promise<ProvenanceRecord[]>;
+    getById(id: string, tenantId: string): Promise<ProvenanceRecord | null>;
+    getByEntityId(entityId: string, tenantId: string, options?: PaginationOptions): Promise<PaginatedResult<ProvenanceRecord>>;
+    query(filters: ProvenanceQueryFilters, options?: PaginationOptions): Promise<PaginatedResult<ProvenanceRecord>>;
+    deleteByEntityId(entityId: string, tenantId: string): Promise<number>;
+    clear(): Promise<void>;
+}
+/**
+ * PostgreSQL storage implementation for production
+ */
+export declare class PostgresProvenanceStorage implements ProvenanceStorage {
+    save(record: ProvenanceRecord): Promise<ProvenanceRecord>;
+    saveBatch(records: ProvenanceRecord[]): Promise<ProvenanceRecord[]>;
+    getById(id: string, tenantId: string): Promise<ProvenanceRecord | null>;
+    getByEntityId(entityId: string, tenantId: string, options?: PaginationOptions): Promise<PaginatedResult<ProvenanceRecord>>;
+    query(filters: ProvenanceQueryFilters, options?: PaginationOptions): Promise<PaginatedResult<ProvenanceRecord>>;
+    deleteByEntityId(entityId: string, tenantId: string): Promise<number>;
+    clear(): Promise<void>;
+    private rowToRecord;
+}
+/**
+ * Create an in-memory storage instance (for testing)
+ */
+export declare function createInMemoryStorage(): InMemoryProvenanceStorage;
+/**
+ * Create a PostgreSQL storage instance (for production)
+ */
+export declare function createPostgresStorage(): PostgresProvenanceStorage;
+//# sourceMappingURL=storage.d.ts.map

package/dist/common/provenance/storage.d.ts.map

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