@geekmidas/audit 0.0.8 → 0.2.0

package/dist/DefaultAuditor.d.mts

@@ -1,3 +1,3 @@
-import "./Auditor-D3me-qKX.mjs";
-import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-C1FWrJg6.mjs";
+import "./Auditor-_Dn2dp8d.mjs";
+import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-CYE-uAry.mjs";
 export { DefaultAuditor, DefaultAuditorConfig };

package/dist/cache-2VI80Vao.d.mts

@@ -0,0 +1,96 @@
+import { AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction } from "./Auditor-_Dn2dp8d.mjs";
+import { Cache } from "@geekmidas/cache";
+
+//#region src/cache.d.ts
+
+/**
+ * Configuration for CacheAuditStorage.
+ */
+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-based audit storage implementation.
+ * Uses any @geekmidas/cache implementation for storage.
+ *
+ * Best suited for:
+ * - Development and testing
+ * - Temporary audit logs that don't need persistence
+ * - Applications with existing cache infrastructure
+ * - Distributed systems needing shared audit state (with Redis/Upstash)
+ *
+ * Note: Query performance may degrade with large numbers of records
+ * since filtering happens in memory after fetching all records.
+ *
+ * @template TAuditAction - Optional type parameter for type-safe audit actions.
+ *
+ * @example
+ * ```typescript
+ * import { CacheAuditStorage } from '@geekmidas/audit/cache';
+ * import { InMemoryCache } from '@geekmidas/cache/memory';
+ * import { UpstashCache } from '@geekmidas/cache/upstash';
+ *
+ * // With in-memory cache (development/testing)
+ * const storage = new CacheAuditStorage({
+ *   cache: new InMemoryCache(),
+ *   ttl: 86400, // 24 hours
+ * });
+ *
+ * // With Upstash Redis (production)
+ * const storage = new CacheAuditStorage({
+ *   cache: new UpstashCache({
+ *     url: process.env.UPSTASH_REDIS_URL,
+ *     token: process.env.UPSTASH_REDIS_TOKEN,
+ *   }),
+ *   ttl: 604800, // 7 days
+ * });
+ * ```
+ */
+declare class CacheAuditStorage<TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> implements AuditStorage<TAuditAction> {
+  private readonly cache;
+  private readonly prefix;
+  private readonly ttl?;
+  private readonly indexKey;
+  constructor(config: CacheAuditStorageConfig);
+  /**
+   * Write audit records to cache.
+   */
+  write(records: AuditRecord[]): Promise<void>;
+  /**
+   * Query audit records from cache.
+   */
+  query(options: AuditQueryOptions): Promise<AuditRecord[]>;
+  /**
+   * Count audit records matching filters.
+   */
+  count(options: Omit<AuditQueryOptions, 'limit' | 'offset'>): Promise<number>;
+  /**
+   * Get all stored records (for testing/debugging).
+   */
+  getRecords(): Promise<AuditRecord[]>;
+  /**
+   * Clear all stored records.
+   */
+  clear(): Promise<void>;
+  private getRecordKey;
+  private getAllRecords;
+  private serializeRecord;
+  private deserializeRecord;
+  private applyFilters;
+}
+//# sourceMappingURL=cache.d.ts.map
+//#endregion
+export { CacheAuditStorage, CacheAuditStorageConfig };
+//# sourceMappingURL=cache-2VI80Vao.d.mts.map

package/dist/cache-2VI80Vao.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-2VI80Vao.d.mts","names":[],"sources":["../src/cache.ts"],"sourcesContent":[],"mappings":";;;;;;AAOA;AAqDA;AAA8B,UArDb,uBAAA,CAqDa;EAAA;EACO,KAAoB,EApDjD,KAoDiD;EAAe;;;;;EA+CjC,MAAW,CAAA,EAAA,MAAA;EAAW;;;;EA+BlD,GAQkB,CAAA,EAAA,MAAA;;;;AAlFJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cALZ,uCACS,mCAAmC,6CAI5C,aAAa;;;;;sBAOL;;;;iBAUC,gBAAgB;;;;iBA0BhB,oBAAoB,QAAQ;;;;iBA8BvC,KAAK,yCACZ;;;;gBAQiB,QAAQ;;;;WAOb"}

package/dist/cache-BbIl31RL.mjs

@@ -0,0 +1,167 @@
+//#region src/cache.ts
+/**
+* Cache-based audit storage implementation.
+* Uses any @geekmidas/cache implementation for storage.
+*
+* Best suited for:
+* - Development and testing
+* - Temporary audit logs that don't need persistence
+* - Applications with existing cache infrastructure
+* - Distributed systems needing shared audit state (with Redis/Upstash)
+*
+* Note: Query performance may degrade with large numbers of records
+* since filtering happens in memory after fetching all records.
+*
+* @template TAuditAction - Optional type parameter for type-safe audit actions.
+*
+* @example
+* ```typescript
+* import { CacheAuditStorage } from '@geekmidas/audit/cache';
+* import { InMemoryCache } from '@geekmidas/cache/memory';
+* import { UpstashCache } from '@geekmidas/cache/upstash';
+*
+* // With in-memory cache (development/testing)
+* const storage = new CacheAuditStorage({
+*   cache: new InMemoryCache(),
+*   ttl: 86400, // 24 hours
+* });
+*
+* // With Upstash Redis (production)
+* const storage = new CacheAuditStorage({
+*   cache: new UpstashCache({
+*     url: process.env.UPSTASH_REDIS_URL,
+*     token: process.env.UPSTASH_REDIS_TOKEN,
+*   }),
+*   ttl: 604800, // 7 days
+* });
+* ```
+*/
+var CacheAuditStorage = class {
+	cache;
+	prefix;
+	ttl;
+	indexKey;
+	constructor(config) {
+		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) {
+		if (records.length === 0) return;
+		const existingIds = await this.cache.get(this.indexKey) ?? [];
+		const newIds = [];
+		for (const record of records) {
+			const key = this.getRecordKey(record.id);
+			const serialized = this.serializeRecord(record);
+			await this.cache.set(key, serialized, this.ttl);
+			newIds.push(record.id);
+		}
+		const updatedIds = [...existingIds, ...newIds];
+		await this.cache.set(this.indexKey, updatedIds, this.ttl);
+	}
+	/**
+	* Query audit records from cache.
+	*/
+	async query(options) {
+		const allRecords = await this.getAllRecords();
+		let results = this.applyFilters(allRecords, options);
+		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;
+		});
+		if (options.offset !== void 0) results = results.slice(options.offset);
+		if (options.limit !== void 0) results = results.slice(0, options.limit);
+		return results;
+	}
+	/**
+	* Count audit records matching filters.
+	*/
+	async count(options) {
+		const allRecords = await this.getAllRecords();
+		return this.applyFilters(allRecords, options).length;
+	}
+	/**
+	* Get all stored records (for testing/debugging).
+	*/
+	async getRecords() {
+		return this.getAllRecords();
+	}
+	/**
+	* Clear all stored records.
+	*/
+	async clear() {
+		const ids = await this.cache.get(this.indexKey) ?? [];
+		for (const id of ids) await this.cache.delete(this.getRecordKey(id));
+		await this.cache.delete(this.indexKey);
+	}
+	getRecordKey(id) {
+		return `${this.prefix}:${id}`;
+	}
+	async getAllRecords() {
+		const ids = await this.cache.get(this.indexKey) ?? [];
+		const records = [];
+		const validIds = [];
+		for (const id of ids) {
+			const key = this.getRecordKey(id);
+			const serialized = await this.cache.get(key);
+			if (serialized) {
+				records.push(this.deserializeRecord(serialized));
+				validIds.push(id);
+			}
+		}
+		if (validIds.length !== ids.length) await this.cache.set(this.indexKey, validIds, this.ttl);
+		return records;
+	}
+	serializeRecord(record) {
+		return {
+			...record,
+			timestamp: record.timestamp.toISOString()
+		};
+	}
+	deserializeRecord(serialized) {
+		return {
+			...serialized,
+			timestamp: new Date(serialized.timestamp)
+		};
+	}
+	applyFilters(records, options) {
+		return records.filter((record) => {
+			if (options.type !== void 0) {
+				if (Array.isArray(options.type)) {
+					if (!options.type.includes(record.type)) return false;
+				} else if (record.type !== options.type) return false;
+			}
+			if (options.entityId !== void 0) {
+				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;
+			}
+			if (options.table !== void 0) {
+				if (record.table !== options.table) return false;
+			}
+			if (options.actorId !== void 0) {
+				if (record.actor?.id !== options.actorId) return false;
+			}
+			if (options.from !== void 0) {
+				if (record.timestamp < options.from) return false;
+			}
+			if (options.to !== void 0) {
+				if (record.timestamp > options.to) return false;
+			}
+			return true;
+		});
+	}
+};
+
+//#endregion
+export { CacheAuditStorage };
+//# sourceMappingURL=cache-BbIl31RL.mjs.map

package/dist/cache-BbIl31RL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-BbIl31RL.mjs","names":["config: CacheAuditStorageConfig","records: AuditRecord[]","newIds: string[]","options: AuditQueryOptions","options: Omit<AuditQueryOptions, 'limit' | 'offset'>","id: string","validIds: string[]","record: AuditRecord","serialized: SerializedAuditRecord"],"sources":["../src/cache.ts"],"sourcesContent":["import type { Cache } from '@geekmidas/cache';\nimport type { AuditQueryOptions, AuditStorage } from './storage';\nimport type { AuditableAction, AuditRecord } from './types';\n\n/**\n * Configuration for CacheAuditStorage.\n */\nexport interface CacheAuditStorageConfig {\n\t/** Cache instance to use for storage */\n\tcache: Cache;\n\t/**\n\t * Key prefix for audit records.\n\t * Records are stored as `${prefix}:${id}`.\n\t * @default 'audit'\n\t */\n\tprefix?: string;\n\t/**\n\t * TTL (time-to-live) in seconds for audit records.\n\t * If not set, records use the cache's default TTL.\n\t */\n\tttl?: number;\n}\n\n/**\n * Cache-based audit storage implementation.\n * Uses any @geekmidas/cache implementation for storage.\n *\n * Best suited for:\n * - Development and testing\n * - Temporary audit logs that don't need persistence\n * - Applications with existing cache infrastructure\n * - Distributed systems needing shared audit state (with Redis/Upstash)\n *\n * Note: Query performance may degrade with large numbers of records\n * since filtering happens in memory after fetching all records.\n *\n * @template TAuditAction - Optional type parameter for type-safe audit actions.\n *\n * @example\n * ```typescript\n * import { CacheAuditStorage } from '@geekmidas/audit/cache';\n * import { InMemoryCache } from '@geekmidas/cache/memory';\n * import { UpstashCache } from '@geekmidas/cache/upstash';\n *\n * // With in-memory cache (development/testing)\n * const storage = new CacheAuditStorage({\n *   cache: new InMemoryCache(),\n *   ttl: 86400, // 24 hours\n * });\n *\n * // With Upstash Redis (production)\n * const storage = new CacheAuditStorage({\n *   cache: new UpstashCache({\n *     url: process.env.UPSTASH_REDIS_URL,\n *     token: process.env.UPSTASH_REDIS_TOKEN,\n *   }),\n *   ttl: 604800, // 7 days\n * });\n * ```\n */\nexport class CacheAuditStorage<\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n> implements AuditStorage<TAuditAction>\n{\n\tprivate readonly cache: Cache;\n\tprivate readonly prefix: string;\n\tprivate readonly ttl?: number;\n\tprivate readonly indexKey: string;\n\n\tconstructor(config: CacheAuditStorageConfig) {\n\t\tthis.cache = config.cache;\n\t\tthis.prefix = config.prefix ?? 'audit';\n\t\tthis.ttl = config.ttl;\n\t\tthis.indexKey = `${this.prefix}:__index__`;\n\t}\n\n\t/**\n\t * Write audit records to cache.\n\t */\n\tasync write(records: AuditRecord[]): Promise<void> {\n\t\tif (records.length === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Get existing index\n\t\tconst existingIds = (await this.cache.get<string[]>(this.indexKey)) ?? [];\n\t\tconst newIds: string[] = [];\n\n\t\t// Write each record\n\t\tfor (const record of records) {\n\t\t\tconst key = this.getRecordKey(record.id);\n\t\t\t// Serialize Date to ISO string for cache storage\n\t\t\tconst serialized = this.serializeRecord(record);\n\t\t\tawait this.cache.set(key, serialized, this.ttl);\n\t\t\tnewIds.push(record.id);\n\t\t}\n\n\t\t// Update index with new IDs\n\t\tconst updatedIds = [...existingIds, ...newIds];\n\t\tawait this.cache.set(this.indexKey, updatedIds, this.ttl);\n\t}\n\n\t/**\n\t * Query audit records from cache.\n\t */\n\tasync query(options: AuditQueryOptions): Promise<AuditRecord[]> {\n\t\tconst allRecords = await this.getAllRecords();\n\t\tlet results = this.applyFilters(allRecords, options);\n\n\t\t// Ordering\n\t\tconst orderBy = options.orderBy ?? 'timestamp';\n\t\tconst orderDirection = options.orderDirection ?? 'desc';\n\t\tresults.sort((a, b) => {\n\t\t\tconst aValue = orderBy === 'timestamp' ? a.timestamp.getTime() : a.type;\n\t\t\tconst bValue = orderBy === 'timestamp' ? b.timestamp.getTime() : b.type;\n\t\t\tif (aValue < bValue) return orderDirection === 'asc' ? -1 : 1;\n\t\t\tif (aValue > bValue) return orderDirection === 'asc' ? 1 : -1;\n\t\t\treturn 0;\n\t\t});\n\n\t\t// Pagination\n\t\tif (options.offset !== undefined) {\n\t\t\tresults = results.slice(options.offset);\n\t\t}\n\t\tif (options.limit !== undefined) {\n\t\t\tresults = results.slice(0, options.limit);\n\t\t}\n\n\t\treturn results;\n\t}\n\n\t/**\n\t * Count audit records matching filters.\n\t */\n\tasync count(\n\t\toptions: Omit<AuditQueryOptions, 'limit' | 'offset'>,\n\t): Promise<number> {\n\t\tconst allRecords = await this.getAllRecords();\n\t\treturn this.applyFilters(allRecords, options).length;\n\t}\n\n\t/**\n\t * Get all stored records (for testing/debugging).\n\t */\n\tasync getRecords(): Promise<AuditRecord[]> {\n\t\treturn this.getAllRecords();\n\t}\n\n\t/**\n\t * Clear all stored records.\n\t */\n\tasync clear(): Promise<void> {\n\t\tconst ids = (await this.cache.get<string[]>(this.indexKey)) ?? [];\n\n\t\t// Delete all records\n\t\tfor (const id of ids) {\n\t\t\tawait this.cache.delete(this.getRecordKey(id));\n\t\t}\n\n\t\t// Delete index\n\t\tawait this.cache.delete(this.indexKey);\n\t}\n\n\tprivate getRecordKey(id: string): string {\n\t\treturn `${this.prefix}:${id}`;\n\t}\n\n\tprivate async getAllRecords(): Promise<AuditRecord[]> {\n\t\tconst ids = (await this.cache.get<string[]>(this.indexKey)) ?? [];\n\t\tconst records: AuditRecord[] = [];\n\t\tconst validIds: string[] = [];\n\n\t\tfor (const id of ids) {\n\t\t\tconst key = this.getRecordKey(id);\n\t\t\tconst serialized = await this.cache.get<SerializedAuditRecord>(key);\n\t\t\tif (serialized) {\n\t\t\t\trecords.push(this.deserializeRecord(serialized));\n\t\t\t\tvalidIds.push(id);\n\t\t\t}\n\t\t}\n\n\t\t// Clean up index if some records expired\n\t\tif (validIds.length !== ids.length) {\n\t\t\tawait this.cache.set(this.indexKey, validIds, this.ttl);\n\t\t}\n\n\t\treturn records;\n\t}\n\n\tprivate serializeRecord(record: AuditRecord): SerializedAuditRecord {\n\t\treturn {\n\t\t\t...record,\n\t\t\ttimestamp: record.timestamp.toISOString(),\n\t\t};\n\t}\n\n\tprivate deserializeRecord(serialized: SerializedAuditRecord): AuditRecord {\n\t\treturn {\n\t\t\t...serialized,\n\t\t\ttimestamp: new Date(serialized.timestamp),\n\t\t};\n\t}\n\n\tprivate applyFilters(\n\t\trecords: AuditRecord[],\n\t\toptions: AuditQueryOptions,\n\t): AuditRecord[] {\n\t\treturn records.filter((record) => {\n\t\t\t// Type filter\n\t\t\tif (options.type !== undefined) {\n\t\t\t\tif (Array.isArray(options.type)) {\n\t\t\t\t\tif (!options.type.includes(record.type)) return false;\n\t\t\t\t} else {\n\t\t\t\t\tif (record.type !== options.type) return false;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Entity ID filter\n\t\t\tif (options.entityId !== undefined) {\n\t\t\t\tconst entityId =\n\t\t\t\t\ttypeof options.entityId === 'string'\n\t\t\t\t\t\t? options.entityId\n\t\t\t\t\t\t: JSON.stringify(options.entityId);\n\t\t\t\tconst recordEntityId =\n\t\t\t\t\ttypeof record.entityId === 'string'\n\t\t\t\t\t\t? record.entityId\n\t\t\t\t\t\t: JSON.stringify(record.entityId);\n\t\t\t\tif (recordEntityId !== entityId) return false;\n\t\t\t}\n\n\t\t\t// Table filter\n\t\t\tif (options.table !== undefined) {\n\t\t\t\tif (record.table !== options.table) return false;\n\t\t\t}\n\n\t\t\t// Actor ID filter\n\t\t\tif (options.actorId !== undefined) {\n\t\t\t\tif (record.actor?.id !== options.actorId) return false;\n\t\t\t}\n\n\t\t\t// Date range filters\n\t\t\tif (options.from !== undefined) {\n\t\t\t\tif (record.timestamp < options.from) return false;\n\t\t\t}\n\t\t\tif (options.to !== undefined) {\n\t\t\t\tif (record.timestamp > options.to) return false;\n\t\t\t}\n\n\t\t\treturn true;\n\t\t});\n\t}\n}\n\n/**\n * Serialized version of AuditRecord for cache storage.\n * Dates are stored as ISO strings.\n */\ntype SerializedAuditRecord = Omit<AuditRecord, 'timestamp'> & {\n\ttimestamp: string;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,IAAa,oBAAb,MAMA;CACC,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAYA,QAAiC;AAC5C,OAAK,QAAQ,OAAO;AACpB,OAAK,SAAS,OAAO,UAAU;AAC/B,OAAK,MAAM,OAAO;AAClB,OAAK,YAAY,EAAE,KAAK,OAAO;CAC/B;;;;CAKD,MAAM,MAAMC,SAAuC;AAClD,MAAI,QAAQ,WAAW,EACtB;EAID,MAAM,cAAe,MAAM,KAAK,MAAM,IAAc,KAAK,SAAS,IAAK,CAAE;EACzE,MAAMC,SAAmB,CAAE;AAG3B,OAAK,MAAM,UAAU,SAAS;GAC7B,MAAM,MAAM,KAAK,aAAa,OAAO,GAAG;GAExC,MAAM,aAAa,KAAK,gBAAgB,OAAO;AAC/C,SAAM,KAAK,MAAM,IAAI,KAAK,YAAY,KAAK,IAAI;AAC/C,UAAO,KAAK,OAAO,GAAG;EACtB;EAGD,MAAM,aAAa,CAAC,GAAG,aAAa,GAAG,MAAO;AAC9C,QAAM,KAAK,MAAM,IAAI,KAAK,UAAU,YAAY,KAAK,IAAI;CACzD;;;;CAKD,MAAM,MAAMC,SAAoD;EAC/D,MAAM,aAAa,MAAM,KAAK,eAAe;EAC7C,IAAI,UAAU,KAAK,aAAa,YAAY,QAAQ;EAGpD,MAAM,UAAU,QAAQ,WAAW;EACnC,MAAM,iBAAiB,QAAQ,kBAAkB;AACjD,UAAQ,KAAK,CAAC,GAAG,MAAM;GACtB,MAAM,SAAS,YAAY,cAAc,EAAE,UAAU,SAAS,GAAG,EAAE;GACnE,MAAM,SAAS,YAAY,cAAc,EAAE,UAAU,SAAS,GAAG,EAAE;AACnE,OAAI,SAAS,OAAQ,QAAO,mBAAmB,QAAQ,KAAK;AAC5D,OAAI,SAAS,OAAQ,QAAO,mBAAmB,QAAQ,IAAI;AAC3D,UAAO;EACP,EAAC;AAGF,MAAI,QAAQ,kBACX,WAAU,QAAQ,MAAM,QAAQ,OAAO;AAExC,MAAI,QAAQ,iBACX,WAAU,QAAQ,MAAM,GAAG,QAAQ,MAAM;AAG1C,SAAO;CACP;;;;CAKD,MAAM,MACLC,SACkB;EAClB,MAAM,aAAa,MAAM,KAAK,eAAe;AAC7C,SAAO,KAAK,aAAa,YAAY,QAAQ,CAAC;CAC9C;;;;CAKD,MAAM,aAAqC;AAC1C,SAAO,KAAK,eAAe;CAC3B;;;;CAKD,MAAM,QAAuB;EAC5B,MAAM,MAAO,MAAM,KAAK,MAAM,IAAc,KAAK,SAAS,IAAK,CAAE;AAGjE,OAAK,MAAM,MAAM,IAChB,OAAM,KAAK,MAAM,OAAO,KAAK,aAAa,GAAG,CAAC;AAI/C,QAAM,KAAK,MAAM,OAAO,KAAK,SAAS;CACtC;CAED,AAAQ,aAAaC,IAAoB;AACxC,UAAQ,EAAE,KAAK,OAAO,GAAG,GAAG;CAC5B;CAED,MAAc,gBAAwC;EACrD,MAAM,MAAO,MAAM,KAAK,MAAM,IAAc,KAAK,SAAS,IAAK,CAAE;EACjE,MAAMJ,UAAyB,CAAE;EACjC,MAAMK,WAAqB,CAAE;AAE7B,OAAK,MAAM,MAAM,KAAK;GACrB,MAAM,MAAM,KAAK,aAAa,GAAG;GACjC,MAAM,aAAa,MAAM,KAAK,MAAM,IAA2B,IAAI;AACnE,OAAI,YAAY;AACf,YAAQ,KAAK,KAAK,kBAAkB,WAAW,CAAC;AAChD,aAAS,KAAK,GAAG;GACjB;EACD;AAGD,MAAI,SAAS,WAAW,IAAI,OAC3B,OAAM,KAAK,MAAM,IAAI,KAAK,UAAU,UAAU,KAAK,IAAI;AAGxD,SAAO;CACP;CAED,AAAQ,gBAAgBC,QAA4C;AACnE,SAAO;GACN,GAAG;GACH,WAAW,OAAO,UAAU,aAAa;EACzC;CACD;CAED,AAAQ,kBAAkBC,YAAgD;AACzE,SAAO;GACN,GAAG;GACH,WAAW,IAAI,KAAK,WAAW;EAC/B;CACD;CAED,AAAQ,aACPP,SACAE,SACgB;AAChB,SAAO,QAAQ,OAAO,CAAC,WAAW;AAEjC,OAAI,QAAQ,iBACX;QAAI,MAAM,QAAQ,QAAQ,KAAK,EAC9B;UAAK,QAAQ,KAAK,SAAS,OAAO,KAAK,CAAE,QAAO;IAAM,WAElD,OAAO,SAAS,QAAQ,KAAM,QAAO;GACzC;AAIF,OAAI,QAAQ,qBAAwB;IACnC,MAAM,kBACE,QAAQ,aAAa,WACzB,QAAQ,WACR,KAAK,UAAU,QAAQ,SAAS;IACpC,MAAM,wBACE,OAAO,aAAa,WACxB,OAAO,WACP,KAAK,UAAU,OAAO,SAAS;AACnC,QAAI,mBAAmB,SAAU,QAAO;GACxC;AAGD,OAAI,QAAQ,kBACX;QAAI,OAAO,UAAU,QAAQ,MAAO,QAAO;GAAM;AAIlD,OAAI,QAAQ,oBACX;QAAI,OAAO,OAAO,OAAO,QAAQ,QAAS,QAAO;GAAM;AAIxD,OAAI,QAAQ,iBACX;QAAI,OAAO,YAAY,QAAQ,KAAM,QAAO;GAAM;AAEnD,OAAI,QAAQ,eACX;QAAI,OAAO,YAAY,QAAQ,GAAI,QAAO;GAAM;AAGjD,UAAO;EACP,EAAC;CACF;AACD"}

package/dist/cache-CDHqXqcl.d.cts

@@ -0,0 +1,96 @@
+import { AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction } from "./Auditor-sW7YAJIA.cjs";
+import { Cache } from "@geekmidas/cache";
+
+//#region src/cache.d.ts
+
+/**
+ * Configuration for CacheAuditStorage.
+ */
+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-based audit storage implementation.
+ * Uses any @geekmidas/cache implementation for storage.
+ *
+ * Best suited for:
+ * - Development and testing
+ * - Temporary audit logs that don't need persistence
+ * - Applications with existing cache infrastructure
+ * - Distributed systems needing shared audit state (with Redis/Upstash)
+ *
+ * Note: Query performance may degrade with large numbers of records
+ * since filtering happens in memory after fetching all records.
+ *
+ * @template TAuditAction - Optional type parameter for type-safe audit actions.
+ *
+ * @example
+ * ```typescript
+ * import { CacheAuditStorage } from '@geekmidas/audit/cache';
+ * import { InMemoryCache } from '@geekmidas/cache/memory';
+ * import { UpstashCache } from '@geekmidas/cache/upstash';
+ *
+ * // With in-memory cache (development/testing)
+ * const storage = new CacheAuditStorage({
+ *   cache: new InMemoryCache(),
+ *   ttl: 86400, // 24 hours
+ * });
+ *
+ * // With Upstash Redis (production)
+ * const storage = new CacheAuditStorage({
+ *   cache: new UpstashCache({
+ *     url: process.env.UPSTASH_REDIS_URL,
+ *     token: process.env.UPSTASH_REDIS_TOKEN,
+ *   }),
+ *   ttl: 604800, // 7 days
+ * });
+ * ```
+ */
+declare class CacheAuditStorage<TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> implements AuditStorage<TAuditAction> {
+  private readonly cache;
+  private readonly prefix;
+  private readonly ttl?;
+  private readonly indexKey;
+  constructor(config: CacheAuditStorageConfig);
+  /**
+   * Write audit records to cache.
+   */
+  write(records: AuditRecord[]): Promise<void>;
+  /**
+   * Query audit records from cache.
+   */
+  query(options: AuditQueryOptions): Promise<AuditRecord[]>;
+  /**
+   * Count audit records matching filters.
+   */
+  count(options: Omit<AuditQueryOptions, 'limit' | 'offset'>): Promise<number>;
+  /**
+   * Get all stored records (for testing/debugging).
+   */
+  getRecords(): Promise<AuditRecord[]>;
+  /**
+   * Clear all stored records.
+   */
+  clear(): Promise<void>;
+  private getRecordKey;
+  private getAllRecords;
+  private serializeRecord;
+  private deserializeRecord;
+  private applyFilters;
+}
+//# sourceMappingURL=cache.d.ts.map
+//#endregion
+export { CacheAuditStorage, CacheAuditStorageConfig };
+//# sourceMappingURL=cache-CDHqXqcl.d.cts.map

package/dist/cache-CDHqXqcl.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-CDHqXqcl.d.cts","names":[],"sources":["../src/cache.ts"],"sourcesContent":[],"mappings":";;;;;;AAOA;AAqDA;AAA8B,UArDb,uBAAA,CAqDa;EAAA;EACO,KAAoB,EApDjD,KAoDiD;EAAe;;;;;EA+CjC,MAAW,CAAA,EAAA,MAAA;EAAW;;;;EA+BlD,GAQkB,CAAA,EAAA,MAAA;;;;AAlFJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cALZ,uCACS,mCAAmC,6CAI5C,aAAa;;;;;sBAOL;;;;iBAUC,gBAAgB;;;;iBA0BhB,oBAAoB,QAAQ;;;;iBA8BvC,KAAK,yCACZ;;;;gBAQiB,QAAQ;;;;WAOb"}

package/dist/cache-l7jAptBl.cjs

@@ -0,0 +1,173 @@
+
+//#region src/cache.ts
+/**
+* Cache-based audit storage implementation.
+* Uses any @geekmidas/cache implementation for storage.
+*
+* Best suited for:
+* - Development and testing
+* - Temporary audit logs that don't need persistence
+* - Applications with existing cache infrastructure
+* - Distributed systems needing shared audit state (with Redis/Upstash)
+*
+* Note: Query performance may degrade with large numbers of records
+* since filtering happens in memory after fetching all records.
+*
+* @template TAuditAction - Optional type parameter for type-safe audit actions.
+*
+* @example
+* ```typescript
+* import { CacheAuditStorage } from '@geekmidas/audit/cache';
+* import { InMemoryCache } from '@geekmidas/cache/memory';
+* import { UpstashCache } from '@geekmidas/cache/upstash';
+*
+* // With in-memory cache (development/testing)
+* const storage = new CacheAuditStorage({
+*   cache: new InMemoryCache(),
+*   ttl: 86400, // 24 hours
+* });
+*
+* // With Upstash Redis (production)
+* const storage = new CacheAuditStorage({
+*   cache: new UpstashCache({
+*     url: process.env.UPSTASH_REDIS_URL,
+*     token: process.env.UPSTASH_REDIS_TOKEN,
+*   }),
+*   ttl: 604800, // 7 days
+* });
+* ```
+*/
+var CacheAuditStorage = class {
+	cache;
+	prefix;
+	ttl;
+	indexKey;
+	constructor(config) {
+		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) {
+		if (records.length === 0) return;
+		const existingIds = await this.cache.get(this.indexKey) ?? [];
+		const newIds = [];
+		for (const record of records) {
+			const key = this.getRecordKey(record.id);
+			const serialized = this.serializeRecord(record);
+			await this.cache.set(key, serialized, this.ttl);
+			newIds.push(record.id);
+		}
+		const updatedIds = [...existingIds, ...newIds];
+		await this.cache.set(this.indexKey, updatedIds, this.ttl);
+	}
+	/**
+	* Query audit records from cache.
+	*/
+	async query(options) {
+		const allRecords = await this.getAllRecords();
+		let results = this.applyFilters(allRecords, options);
+		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;
+		});
+		if (options.offset !== void 0) results = results.slice(options.offset);
+		if (options.limit !== void 0) results = results.slice(0, options.limit);
+		return results;
+	}
+	/**
+	* Count audit records matching filters.
+	*/
+	async count(options) {
+		const allRecords = await this.getAllRecords();
+		return this.applyFilters(allRecords, options).length;
+	}
+	/**
+	* Get all stored records (for testing/debugging).
+	*/
+	async getRecords() {
+		return this.getAllRecords();
+	}
+	/**
+	* Clear all stored records.
+	*/
+	async clear() {
+		const ids = await this.cache.get(this.indexKey) ?? [];
+		for (const id of ids) await this.cache.delete(this.getRecordKey(id));
+		await this.cache.delete(this.indexKey);
+	}
+	getRecordKey(id) {
+		return `${this.prefix}:${id}`;
+	}
+	async getAllRecords() {
+		const ids = await this.cache.get(this.indexKey) ?? [];
+		const records = [];
+		const validIds = [];
+		for (const id of ids) {
+			const key = this.getRecordKey(id);
+			const serialized = await this.cache.get(key);
+			if (serialized) {
+				records.push(this.deserializeRecord(serialized));
+				validIds.push(id);
+			}
+		}
+		if (validIds.length !== ids.length) await this.cache.set(this.indexKey, validIds, this.ttl);
+		return records;
+	}
+	serializeRecord(record) {
+		return {
+			...record,
+			timestamp: record.timestamp.toISOString()
+		};
+	}
+	deserializeRecord(serialized) {
+		return {
+			...serialized,
+			timestamp: new Date(serialized.timestamp)
+		};
+	}
+	applyFilters(records, options) {
+		return records.filter((record) => {
+			if (options.type !== void 0) {
+				if (Array.isArray(options.type)) {
+					if (!options.type.includes(record.type)) return false;
+				} else if (record.type !== options.type) return false;
+			}
+			if (options.entityId !== void 0) {
+				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;
+			}
+			if (options.table !== void 0) {
+				if (record.table !== options.table) return false;
+			}
+			if (options.actorId !== void 0) {
+				if (record.actor?.id !== options.actorId) return false;
+			}
+			if (options.from !== void 0) {
+				if (record.timestamp < options.from) return false;
+			}
+			if (options.to !== void 0) {
+				if (record.timestamp > options.to) return false;
+			}
+			return true;
+		});
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'CacheAuditStorage', {
+  enumerable: true,
+  get: function () {
+    return CacheAuditStorage;
+  }
+});
+//# sourceMappingURL=cache-l7jAptBl.cjs.map

package/dist/cache-l7jAptBl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-l7jAptBl.cjs","names":["config: CacheAuditStorageConfig","records: AuditRecord[]","newIds: string[]","options: AuditQueryOptions","options: Omit<AuditQueryOptions, 'limit' | 'offset'>","id: string","validIds: string[]","record: AuditRecord","serialized: SerializedAuditRecord"],"sources":["../src/cache.ts"],"sourcesContent":["import type { Cache } from '@geekmidas/cache';\nimport type { AuditQueryOptions, AuditStorage } from './storage';\nimport type { AuditableAction, AuditRecord } from './types';\n\n/**\n * Configuration for CacheAuditStorage.\n */\nexport interface CacheAuditStorageConfig {\n\t/** Cache instance to use for storage */\n\tcache: Cache;\n\t/**\n\t * Key prefix for audit records.\n\t * Records are stored as `${prefix}:${id}`.\n\t * @default 'audit'\n\t */\n\tprefix?: string;\n\t/**\n\t * TTL (time-to-live) in seconds for audit records.\n\t * If not set, records use the cache's default TTL.\n\t */\n\tttl?: number;\n}\n\n/**\n * Cache-based audit storage implementation.\n * Uses any @geekmidas/cache implementation for storage.\n *\n * Best suited for:\n * - Development and testing\n * - Temporary audit logs that don't need persistence\n * - Applications with existing cache infrastructure\n * - Distributed systems needing shared audit state (with Redis/Upstash)\n *\n * Note: Query performance may degrade with large numbers of records\n * since filtering happens in memory after fetching all records.\n *\n * @template TAuditAction - Optional type parameter for type-safe audit actions.\n *\n * @example\n * ```typescript\n * import { CacheAuditStorage } from '@geekmidas/audit/cache';\n * import { InMemoryCache } from '@geekmidas/cache/memory';\n * import { UpstashCache } from '@geekmidas/cache/upstash';\n *\n * // With in-memory cache (development/testing)\n * const storage = new CacheAuditStorage({\n *   cache: new InMemoryCache(),\n *   ttl: 86400, // 24 hours\n * });\n *\n * // With Upstash Redis (production)\n * const storage = new CacheAuditStorage({\n *   cache: new UpstashCache({\n *     url: process.env.UPSTASH_REDIS_URL,\n *     token: process.env.UPSTASH_REDIS_TOKEN,\n *   }),\n *   ttl: 604800, // 7 days\n * });\n * ```\n */\nexport class CacheAuditStorage<\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n> implements AuditStorage<TAuditAction>\n{\n\tprivate readonly cache: Cache;\n\tprivate readonly prefix: string;\n\tprivate readonly ttl?: number;\n\tprivate readonly indexKey: string;\n\n\tconstructor(config: CacheAuditStorageConfig) {\n\t\tthis.cache = config.cache;\n\t\tthis.prefix = config.prefix ?? 'audit';\n\t\tthis.ttl = config.ttl;\n\t\tthis.indexKey = `${this.prefix}:__index__`;\n\t}\n\n\t/**\n\t * Write audit records to cache.\n\t */\n\tasync write(records: AuditRecord[]): Promise<void> {\n\t\tif (records.length === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Get existing index\n\t\tconst existingIds = (await this.cache.get<string[]>(this.indexKey)) ?? [];\n\t\tconst newIds: string[] = [];\n\n\t\t// Write each record\n\t\tfor (const record of records) {\n\t\t\tconst key = this.getRecordKey(record.id);\n\t\t\t// Serialize Date to ISO string for cache storage\n\t\t\tconst serialized = this.serializeRecord(record);\n\t\t\tawait this.cache.set(key, serialized, this.ttl);\n\t\t\tnewIds.push(record.id);\n\t\t}\n\n\t\t// Update index with new IDs\n\t\tconst updatedIds = [...existingIds, ...newIds];\n\t\tawait this.cache.set(this.indexKey, updatedIds, this.ttl);\n\t}\n\n\t/**\n\t * Query audit records from cache.\n\t */\n\tasync query(options: AuditQueryOptions): Promise<AuditRecord[]> {\n\t\tconst allRecords = await this.getAllRecords();\n\t\tlet results = this.applyFilters(allRecords, options);\n\n\t\t// Ordering\n\t\tconst orderBy = options.orderBy ?? 'timestamp';\n\t\tconst orderDirection = options.orderDirection ?? 'desc';\n\t\tresults.sort((a, b) => {\n\t\t\tconst aValue = orderBy === 'timestamp' ? a.timestamp.getTime() : a.type;\n\t\t\tconst bValue = orderBy === 'timestamp' ? b.timestamp.getTime() : b.type;\n\t\t\tif (aValue < bValue) return orderDirection === 'asc' ? -1 : 1;\n\t\t\tif (aValue > bValue) return orderDirection === 'asc' ? 1 : -1;\n\t\t\treturn 0;\n\t\t});\n\n\t\t// Pagination\n\t\tif (options.offset !== undefined) {\n\t\t\tresults = results.slice(options.offset);\n\t\t}\n\t\tif (options.limit !== undefined) {\n\t\t\tresults = results.slice(0, options.limit);\n\t\t}\n\n\t\treturn results;\n\t}\n\n\t/**\n\t * Count audit records matching filters.\n\t */\n\tasync count(\n\t\toptions: Omit<AuditQueryOptions, 'limit' | 'offset'>,\n\t): Promise<number> {\n\t\tconst allRecords = await this.getAllRecords();\n\t\treturn this.applyFilters(allRecords, options).length;\n\t}\n\n\t/**\n\t * Get all stored records (for testing/debugging).\n\t */\n\tasync getRecords(): Promise<AuditRecord[]> {\n\t\treturn this.getAllRecords();\n\t}\n\n\t/**\n\t * Clear all stored records.\n\t */\n\tasync clear(): Promise<void> {\n\t\tconst ids = (await this.cache.get<string[]>(this.indexKey)) ?? [];\n\n\t\t// Delete all records\n\t\tfor (const id of ids) {\n\t\t\tawait this.cache.delete(this.getRecordKey(id));\n\t\t}\n\n\t\t// Delete index\n\t\tawait this.cache.delete(this.indexKey);\n\t}\n\n\tprivate getRecordKey(id: string): string {\n\t\treturn `${this.prefix}:${id}`;\n\t}\n\n\tprivate async getAllRecords(): Promise<AuditRecord[]> {\n\t\tconst ids = (await this.cache.get<string[]>(this.indexKey)) ?? [];\n\t\tconst records: AuditRecord[] = [];\n\t\tconst validIds: string[] = [];\n\n\t\tfor (const id of ids) {\n\t\t\tconst key = this.getRecordKey(id);\n\t\t\tconst serialized = await this.cache.get<SerializedAuditRecord>(key);\n\t\t\tif (serialized) {\n\t\t\t\trecords.push(this.deserializeRecord(serialized));\n\t\t\t\tvalidIds.push(id);\n\t\t\t}\n\t\t}\n\n\t\t// Clean up index if some records expired\n\t\tif (validIds.length !== ids.length) {\n\t\t\tawait this.cache.set(this.indexKey, validIds, this.ttl);\n\t\t}\n\n\t\treturn records;\n\t}\n\n\tprivate serializeRecord(record: AuditRecord): SerializedAuditRecord {\n\t\treturn {\n\t\t\t...record,\n\t\t\ttimestamp: record.timestamp.toISOString(),\n\t\t};\n\t}\n\n\tprivate deserializeRecord(serialized: SerializedAuditRecord): AuditRecord {\n\t\treturn {\n\t\t\t...serialized,\n\t\t\ttimestamp: new Date(serialized.timestamp),\n\t\t};\n\t}\n\n\tprivate applyFilters(\n\t\trecords: AuditRecord[],\n\t\toptions: AuditQueryOptions,\n\t): AuditRecord[] {\n\t\treturn records.filter((record) => {\n\t\t\t// Type filter\n\t\t\tif (options.type !== undefined) {\n\t\t\t\tif (Array.isArray(options.type)) {\n\t\t\t\t\tif (!options.type.includes(record.type)) return false;\n\t\t\t\t} else {\n\t\t\t\t\tif (record.type !== options.type) return false;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Entity ID filter\n\t\t\tif (options.entityId !== undefined) {\n\t\t\t\tconst entityId =\n\t\t\t\t\ttypeof options.entityId === 'string'\n\t\t\t\t\t\t? options.entityId\n\t\t\t\t\t\t: JSON.stringify(options.entityId);\n\t\t\t\tconst recordEntityId =\n\t\t\t\t\ttypeof record.entityId === 'string'\n\t\t\t\t\t\t? record.entityId\n\t\t\t\t\t\t: JSON.stringify(record.entityId);\n\t\t\t\tif (recordEntityId !== entityId) return false;\n\t\t\t}\n\n\t\t\t// Table filter\n\t\t\tif (options.table !== undefined) {\n\t\t\t\tif (record.table !== options.table) return false;\n\t\t\t}\n\n\t\t\t// Actor ID filter\n\t\t\tif (options.actorId !== undefined) {\n\t\t\t\tif (record.actor?.id !== options.actorId) return false;\n\t\t\t}\n\n\t\t\t// Date range filters\n\t\t\tif (options.from !== undefined) {\n\t\t\t\tif (record.timestamp < options.from) return false;\n\t\t\t}\n\t\t\tif (options.to !== undefined) {\n\t\t\t\tif (record.timestamp > options.to) return false;\n\t\t\t}\n\n\t\t\treturn true;\n\t\t});\n\t}\n}\n\n/**\n * Serialized version of AuditRecord for cache storage.\n * Dates are stored as ISO strings.\n */\ntype SerializedAuditRecord = Omit<AuditRecord, 'timestamp'> & {\n\ttimestamp: string;\n};\n"],"mappings":"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"}

package/dist/cache.cjs

@@ -0,0 +1,3 @@
+const require_cache = require('./cache-l7jAptBl.cjs');
+
+exports.CacheAuditStorage = require_cache.CacheAuditStorage;

package/dist/cache.d.cts

@@ -0,0 +1,3 @@
+import "./Auditor-sW7YAJIA.cjs";
+import { CacheAuditStorage, CacheAuditStorageConfig } from "./cache-CDHqXqcl.cjs";
+export { CacheAuditStorage, CacheAuditStorageConfig };

package/dist/cache.d.mts

@@ -0,0 +1,3 @@
+import "./Auditor-_Dn2dp8d.mjs";
+import { CacheAuditStorage, CacheAuditStorageConfig } from "./cache-2VI80Vao.mjs";
+export { CacheAuditStorage, CacheAuditStorageConfig };

package/dist/cache.mjs

@@ -0,0 +1,3 @@
+import { CacheAuditStorage } from "./cache-BbIl31RL.mjs";
+
+export { CacheAuditStorage };

package/dist/index.d.cts

@@ -1,3 +1,3 @@
-import { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit } from "./Auditor-QYUMGJCH.cjs";
-import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-BTuMMiWh.cjs";
+import { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit } from "./Auditor-sW7YAJIA.cjs";
+import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-BSYMwojG.cjs";
 export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, DefaultAuditor, DefaultAuditorConfig, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit };

package/dist/index.d.mts

@@ -1,3 +1,3 @@
-import { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit } from "./Auditor-D3me-qKX.mjs";
-import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-C1FWrJg6.mjs";
+import { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit } from "./Auditor-_Dn2dp8d.mjs";
+import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-CYE-uAry.mjs";
 export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, DefaultAuditor, DefaultAuditorConfig, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit };

package/dist/kysely.cjs

@@ -121,6 +121,30 @@ var KyselyAuditStorage = class {
 	getDatabase() {
 		return this.db;
 	}
+	/**
+	* Execute a callback within a Kysely transaction with automatic audit handling.
+	* The auditor is registered with the transaction and audits are flushed
+	* before the transaction commits.
+	*
+	* If the provided db connection is already a transaction, it will be reused
+	* instead of creating a nested transaction.
+	*/
+	async withTransaction(auditor, callback, db) {
+		const connection = db ?? this.db;
+		if (connection.isTransaction) {
+			const trx = connection;
+			auditor.setTransaction(trx);
+			const result = await callback();
+			await auditor.flush(trx);
+			return result;
+		}
+		return connection.transaction().execute(async (trx) => {
+			auditor.setTransaction(trx);
+			const result = await callback();
+			await auditor.flush(trx);
+			return result;
+		});
+	}
 	applyFilters(query, options) {
 		if (options.type !== void 0) if (Array.isArray(options.type)) query = query.where("type", "in", options.type);
 		else query = query.where("type", "=", options.type);