@geekmidas/audit 0.1.0 → 0.2.0

package/src/cache.ts

@@ -1,24 +1,24 @@
 import type { Cache } from '@geekmidas/cache';
 import type { AuditQueryOptions, AuditStorage } from './storage';
-import type { AuditRecord, AuditableAction } from './types';
+import type { AuditableAction, AuditRecord } from './types';
 
 /**
  * Configuration for CacheAuditStorage.
  */
 export interface CacheAuditStorageConfig {
-  /** Cache instance to use for storage */
-  cache: Cache;
-  /**
-   * Key prefix for audit records.
-   * Records are stored as `${prefix}:${id}`.
-   * @default 'audit'
-   */
-  prefix?: string;
-  /**
-   * TTL (time-to-live) in seconds for audit records.
-   * If not set, records use the cache's default TTL.
-   */
-  ttl?: number;
+	/** Cache instance to use for storage */
+	cache: Cache;
+	/**
+	 * Key prefix for audit records.
+	 * Records are stored as `${prefix}:${id}`.
+	 * @default 'audit'
+	 */
+	prefix?: string;
+	/**
+	 * TTL (time-to-live) in seconds for audit records.
+	 * If not set, records use the cache's default TTL.
+	 */
+	ttl?: number;
 }
 
 /**
@@ -59,199 +59,199 @@ export interface CacheAuditStorageConfig {
  * ```
  */
 export class CacheAuditStorage<
-  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<
-    string,
-    unknown
-  >,
+	TAuditAction extends AuditableAction<string, unknown> = AuditableAction<
+		string,
+		unknown
+	>,
 > implements AuditStorage<TAuditAction>
 {
-  private readonly cache: Cache;
-  private readonly prefix: string;
-  private readonly ttl?: number;
-  private readonly indexKey: string;
+	private readonly cache: Cache;
+	private readonly prefix: string;
+	private readonly ttl?: number;
+	private readonly indexKey: string;
 
-  constructor(config: CacheAuditStorageConfig) {
-    this.cache = config.cache;
-    this.prefix = config.prefix ?? 'audit';
-    this.ttl = config.ttl;
-    this.indexKey = `${this.prefix}:__index__`;
-  }
+	constructor(config: CacheAuditStorageConfig) {
+		this.cache = config.cache;
+		this.prefix = config.prefix ?? 'audit';
+		this.ttl = config.ttl;
+		this.indexKey = `${this.prefix}:__index__`;
+	}
 
-  /**
-   * Write audit records to cache.
-   */
-  async write(records: AuditRecord[]): Promise<void> {
-    if (records.length === 0) {
-      return;
-    }
+	/**
+	 * Write audit records to cache.
+	 */
+	async write(records: AuditRecord[]): Promise<void> {
+		if (records.length === 0) {
+			return;
+		}
 
-    // Get existing index
-    const existingIds = (await this.cache.get<string[]>(this.indexKey)) ?? [];
-    const newIds: string[] = [];
+		// Get existing index
+		const existingIds = (await this.cache.get<string[]>(this.indexKey)) ?? [];
+		const newIds: string[] = [];
 
-    // Write each record
-    for (const record of records) {
-      const key = this.getRecordKey(record.id);
-      // Serialize Date to ISO string for cache storage
-      const serialized = this.serializeRecord(record);
-      await this.cache.set(key, serialized, this.ttl);
-      newIds.push(record.id);
-    }
+		// Write each record
+		for (const record of records) {
+			const key = this.getRecordKey(record.id);
+			// Serialize Date to ISO string for cache storage
+			const serialized = this.serializeRecord(record);
+			await this.cache.set(key, serialized, this.ttl);
+			newIds.push(record.id);
+		}
 
-    // Update index with new IDs
-    const updatedIds = [...existingIds, ...newIds];
-    await this.cache.set(this.indexKey, updatedIds, this.ttl);
-  }
+		// Update index with new IDs
+		const updatedIds = [...existingIds, ...newIds];
+		await this.cache.set(this.indexKey, updatedIds, this.ttl);
+	}
 
-  /**
-   * Query audit records from cache.
-   */
-  async query(options: AuditQueryOptions): Promise<AuditRecord[]> {
-    const allRecords = await this.getAllRecords();
-    let results = this.applyFilters(allRecords, options);
+	/**
+	 * Query audit records from cache.
+	 */
+	async query(options: AuditQueryOptions): Promise<AuditRecord[]> {
+		const allRecords = await this.getAllRecords();
+		let results = this.applyFilters(allRecords, options);
 
-    // Ordering
-    const orderBy = options.orderBy ?? 'timestamp';
-    const orderDirection = options.orderDirection ?? 'desc';
-    results.sort((a, b) => {
-      const aValue = orderBy === 'timestamp' ? a.timestamp.getTime() : a.type;
-      const bValue = orderBy === 'timestamp' ? b.timestamp.getTime() : b.type;
-      if (aValue < bValue) return orderDirection === 'asc' ? -1 : 1;
-      if (aValue > bValue) return orderDirection === 'asc' ? 1 : -1;
-      return 0;
-    });
+		// Ordering
+		const orderBy = options.orderBy ?? 'timestamp';
+		const orderDirection = options.orderDirection ?? 'desc';
+		results.sort((a, b) => {
+			const aValue = orderBy === 'timestamp' ? a.timestamp.getTime() : a.type;
+			const bValue = orderBy === 'timestamp' ? b.timestamp.getTime() : b.type;
+			if (aValue < bValue) return orderDirection === 'asc' ? -1 : 1;
+			if (aValue > bValue) return orderDirection === 'asc' ? 1 : -1;
+			return 0;
+		});
 
-    // Pagination
-    if (options.offset !== undefined) {
-      results = results.slice(options.offset);
-    }
-    if (options.limit !== undefined) {
-      results = results.slice(0, options.limit);
-    }
+		// Pagination
+		if (options.offset !== undefined) {
+			results = results.slice(options.offset);
+		}
+		if (options.limit !== undefined) {
+			results = results.slice(0, options.limit);
+		}
 
-    return results;
-  }
+		return results;
+	}
 
-  /**
-   * Count audit records matching filters.
-   */
-  async count(
-    options: Omit<AuditQueryOptions, 'limit' | 'offset'>,
-  ): Promise<number> {
-    const allRecords = await this.getAllRecords();
-    return this.applyFilters(allRecords, options).length;
-  }
+	/**
+	 * Count audit records matching filters.
+	 */
+	async count(
+		options: Omit<AuditQueryOptions, 'limit' | 'offset'>,
+	): Promise<number> {
+		const allRecords = await this.getAllRecords();
+		return this.applyFilters(allRecords, options).length;
+	}
 
-  /**
-   * Get all stored records (for testing/debugging).
-   */
-  async getRecords(): Promise<AuditRecord[]> {
-    return this.getAllRecords();
-  }
+	/**
+	 * Get all stored records (for testing/debugging).
+	 */
+	async getRecords(): Promise<AuditRecord[]> {
+		return this.getAllRecords();
+	}
 
-  /**
-   * Clear all stored records.
-   */
-  async clear(): Promise<void> {
-    const ids = (await this.cache.get<string[]>(this.indexKey)) ?? [];
+	/**
+	 * Clear all stored records.
+	 */
+	async clear(): Promise<void> {
+		const ids = (await this.cache.get<string[]>(this.indexKey)) ?? [];
 
-    // Delete all records
-    for (const id of ids) {
-      await this.cache.delete(this.getRecordKey(id));
-    }
+		// Delete all records
+		for (const id of ids) {
+			await this.cache.delete(this.getRecordKey(id));
+		}
 
-    // Delete index
-    await this.cache.delete(this.indexKey);
-  }
+		// Delete index
+		await this.cache.delete(this.indexKey);
+	}
 
-  private getRecordKey(id: string): string {
-    return `${this.prefix}:${id}`;
-  }
+	private getRecordKey(id: string): string {
+		return `${this.prefix}:${id}`;
+	}
 
-  private async getAllRecords(): Promise<AuditRecord[]> {
-    const ids = (await this.cache.get<string[]>(this.indexKey)) ?? [];
-    const records: AuditRecord[] = [];
-    const validIds: string[] = [];
+	private async getAllRecords(): Promise<AuditRecord[]> {
+		const ids = (await this.cache.get<string[]>(this.indexKey)) ?? [];
+		const records: AuditRecord[] = [];
+		const validIds: string[] = [];
 
-    for (const id of ids) {
-      const key = this.getRecordKey(id);
-      const serialized = await this.cache.get<SerializedAuditRecord>(key);
-      if (serialized) {
-        records.push(this.deserializeRecord(serialized));
-        validIds.push(id);
-      }
-    }
+		for (const id of ids) {
+			const key = this.getRecordKey(id);
+			const serialized = await this.cache.get<SerializedAuditRecord>(key);
+			if (serialized) {
+				records.push(this.deserializeRecord(serialized));
+				validIds.push(id);
+			}
+		}
 
-    // Clean up index if some records expired
-    if (validIds.length !== ids.length) {
-      await this.cache.set(this.indexKey, validIds, this.ttl);
-    }
+		// Clean up index if some records expired
+		if (validIds.length !== ids.length) {
+			await this.cache.set(this.indexKey, validIds, this.ttl);
+		}
 
-    return records;
-  }
+		return records;
+	}
 
-  private serializeRecord(record: AuditRecord): SerializedAuditRecord {
-    return {
-      ...record,
-      timestamp: record.timestamp.toISOString(),
-    };
-  }
+	private serializeRecord(record: AuditRecord): SerializedAuditRecord {
+		return {
+			...record,
+			timestamp: record.timestamp.toISOString(),
+		};
+	}
 
-  private deserializeRecord(serialized: SerializedAuditRecord): AuditRecord {
-    return {
-      ...serialized,
-      timestamp: new Date(serialized.timestamp),
-    };
-  }
+	private deserializeRecord(serialized: SerializedAuditRecord): AuditRecord {
+		return {
+			...serialized,
+			timestamp: new Date(serialized.timestamp),
+		};
+	}
 
-  private applyFilters(
-    records: AuditRecord[],
-    options: AuditQueryOptions,
-  ): AuditRecord[] {
-    return records.filter((record) => {
-      // Type filter
-      if (options.type !== undefined) {
-        if (Array.isArray(options.type)) {
-          if (!options.type.includes(record.type)) return false;
-        } else {
-          if (record.type !== options.type) return false;
-        }
-      }
+	private applyFilters(
+		records: AuditRecord[],
+		options: AuditQueryOptions,
+	): AuditRecord[] {
+		return records.filter((record) => {
+			// Type filter
+			if (options.type !== undefined) {
+				if (Array.isArray(options.type)) {
+					if (!options.type.includes(record.type)) return false;
+				} else {
+					if (record.type !== options.type) return false;
+				}
+			}
 
-      // Entity ID filter
-      if (options.entityId !== undefined) {
-        const entityId =
-          typeof options.entityId === 'string'
-            ? options.entityId
-            : JSON.stringify(options.entityId);
-        const recordEntityId =
-          typeof record.entityId === 'string'
-            ? record.entityId
-            : JSON.stringify(record.entityId);
-        if (recordEntityId !== entityId) return false;
-      }
+			// Entity ID filter
+			if (options.entityId !== undefined) {
+				const entityId =
+					typeof options.entityId === 'string'
+						? options.entityId
+						: JSON.stringify(options.entityId);
+				const recordEntityId =
+					typeof record.entityId === 'string'
+						? record.entityId
+						: JSON.stringify(record.entityId);
+				if (recordEntityId !== entityId) return false;
+			}
 
-      // Table filter
-      if (options.table !== undefined) {
-        if (record.table !== options.table) return false;
-      }
+			// Table filter
+			if (options.table !== undefined) {
+				if (record.table !== options.table) return false;
+			}
 
-      // Actor ID filter
-      if (options.actorId !== undefined) {
-        if (record.actor?.id !== options.actorId) return false;
-      }
+			// Actor ID filter
+			if (options.actorId !== undefined) {
+				if (record.actor?.id !== options.actorId) return false;
+			}
 
-      // Date range filters
-      if (options.from !== undefined) {
-        if (record.timestamp < options.from) return false;
-      }
-      if (options.to !== undefined) {
-        if (record.timestamp > options.to) return false;
-      }
+			// Date range filters
+			if (options.from !== undefined) {
+				if (record.timestamp < options.from) return false;
+			}
+			if (options.to !== undefined) {
+				if (record.timestamp > options.to) return false;
+			}
 
-      return true;
-    });
-  }
+			return true;
+		});
+	}
 }
 
 /**
@@ -259,5 +259,5 @@ export class CacheAuditStorage<
  * Dates are stored as ISO strings.
  */
 type SerializedAuditRecord = Omit<AuditRecord, 'timestamp'> & {
-  timestamp: string;
+	timestamp: string;
 };

package/src/index.ts

@@ -1,24 +1,23 @@
 // Core types
-export type {
-  AuditableAction,
-  AuditActor,
-  AuditMetadata,
-  AuditOperation,
-  AuditOptions,
-  AuditRecord,
-  ExtractAuditPayload,
-  ExtractAuditType,
-  ExtractAuditorAction,
-  ExtractStorageAuditAction,
-  MappedAudit,
-} from './types';
 
 // Auditor interface
 export type { Auditor } from './Auditor';
+export type { DefaultAuditorConfig } from './DefaultAuditor';
 
 // Default implementation
 export { DefaultAuditor } from './DefaultAuditor';
-export type { DefaultAuditorConfig } from './DefaultAuditor';
-
 // Storage interface
 export type { AuditQueryOptions, AuditStorage } from './storage';
+export type {
+	AuditActor,
+	AuditableAction,
+	AuditMetadata,
+	AuditOperation,
+	AuditOptions,
+	AuditRecord,
+	ExtractAuditorAction,
+	ExtractAuditPayload,
+	ExtractAuditType,
+	ExtractStorageAuditAction,
+	MappedAudit,
+} from './types';