@geekmidas/audit 0.0.4 → 0.0.5

package/dist/{Auditor-CZ8lkASv.d.cts → Auditor-D3me-qKX.d.mts}

@@ -1,8 +1,125 @@
 import { InferStandardSchema } from "@geekmidas/schema";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
+//#region src/storage.d.ts
+/**
+ * Options for querying audit records.
+ */
+interface AuditQueryOptions {
+  /** Filter by audit type */
+  type?: string | string[];
+  /** Filter by entity ID */
+  entityId?: string | Record<string, unknown>;
+  /** Filter by table name */
+  table?: string;
+  /** Filter by actor ID */
+  actorId?: string;
+  /** Filter by date range (start) */
+  from?: Date;
+  /** Filter by date range (end) */
+  to?: Date;
+  /** Limit number of results */
+  limit?: number;
+  /** Offset for pagination */
+  offset?: number;
+  /** Sort order */
+  orderBy?: 'timestamp' | 'type';
+  /** Sort direction */
+  orderDirection?: 'asc' | 'desc';
+}
+/**
+ * Interface for audit storage backends.
+ * Implement this to store audits in your preferred location.
+ *
+ * @example
+ * ```typescript
+ * // Same database storage (recommended for transactions)
+ * const auditStorage: AuditStorage = {
+ *   async write(records, trx) {
+ *     const db = trx ?? getDatabase();
+ *     await db.insertInto('audit_logs').values(records).execute();
+ *   },
+ * };
+ *
+ * // External audit service
+ * const externalAuditStorage: AuditStorage = {
+ *   async write(records) {
+ *     await fetch('https://audit.example.com/api/audits', {
+ *       method: 'POST',
+ *       body: JSON.stringify({ records }),
+ *     });
+ *   },
+ * };
+ * ```
+ *
+ * @template TAuditAction - Optional type parameter for type-safe audit actions.
+ *   When provided, this type is preserved in the Service definition and can be
+ *   extracted by EndpointBuilder to provide type inference for `.audit([...])`.
+ */
+interface AuditStorage<TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> {
+  /** @internal Type marker for extracting audit action type */
+  readonly __auditActionType?: TAuditAction;
+  /**
+   * Write audit records to storage.
+   * Called by Auditor.flush() to persist collected audits.
+   *
+   * @param records - The audit records to write
+   * @param trx - Optional transaction context (for same-DB storage)
+   */
+  write(records: AuditRecord[], trx?: unknown): Promise<void>;
+  /**
+   * Optional: Query audit records for retrieval.
+   * Implement this for audit log viewing/searching.
+   *
+   * @param options - Query filters and pagination
+   * @returns Matching audit records
+   */
+  query?(options: AuditQueryOptions): Promise<AuditRecord[]>;
+  /**
+   * Optional: Count audit records matching filters.
+   * Useful for pagination.
+   *
+   * @param options - Query filters (limit/offset ignored)
+   * @returns Count of matching records
+   */
+  count?(options: Omit<AuditQueryOptions, 'limit' | 'offset'>): Promise<number>;
+  /**
+   * Optional: Get the database connection for transactional audit writes.
+   * When implemented, the endpoint adaptor can automatically wrap handlers
+   * in a transaction, ensuring audits are atomic with other database operations.
+   *
+   * @returns Database connection (e.g., Kysely instance)
+   *
+   * @example
+   * ```typescript
+   * class KyselyAuditStorage implements AuditStorage {
+   *   constructor(private db: Kysely<DB>) {}
+   *
+   *   getDatabase() {
+   *     return this.db;
+   *   }
+   * }
+   * ```
+   */
+  getDatabase?(): unknown;
+  /**
+   * Optional: The service name of the database service used by this storage.
+   * When set, endpoint adaptors will automatically use the audit transaction as `db`
+   * in the handler context if the endpoint's database service has the same name.
+   *
+   * @example
+   * ```typescript
+   * const storage = new KyselyAuditStorage({
+   *   db,
+   *   tableName: 'audit_logs',
+   *   databaseServiceName: 'database', // Matches databaseService.serviceName
+   * });
+   * ```
+   */
+  databaseServiceName?: string;
+}
+//#endregion
 //#region src/types.d.ts
-
 /**
  * Represents an auditable action with a type and payload.
  * Similar to PublishableMessage in @geekmidas/events.
@@ -124,6 +241,10 @@ interface MappedAudit<TAuditAction extends AuditableAction<string, unknown>, TOu
  * Extract the AuditableAction type from an Auditor.
  */
 type ExtractAuditorAction<T> = T extends Auditor<infer A> ? A : never;
+/**
+ * Extract the AuditableAction type from an AuditStorage.
+ */
+type ExtractStorageAuditAction<T> = T extends AuditStorage<infer A> ? A : AuditableAction<string, unknown>;
 //#endregion
 //#region src/Auditor.d.ts
 /**
@@ -256,5 +377,5 @@ interface Auditor<TAuditAction extends AuditableAction<string, unknown> = Audita
   getTransaction(): TTransaction | undefined;
 }
 //#endregion
-export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, MappedAudit };
-//# sourceMappingURL=Auditor-CZ8lkASv.d.cts.map
+export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit };
+//# sourceMappingURL=Auditor-D3me-qKX.d.mts.map

package/dist/{Auditor-ii62d_pF.d.mts → Auditor-QYUMGJCH.d.cts}

@@ -1,8 +1,125 @@
 import { InferStandardSchema } from "@geekmidas/schema";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
+//#region src/storage.d.ts
+/**
+ * Options for querying audit records.
+ */
+interface AuditQueryOptions {
+  /** Filter by audit type */
+  type?: string | string[];
+  /** Filter by entity ID */
+  entityId?: string | Record<string, unknown>;
+  /** Filter by table name */
+  table?: string;
+  /** Filter by actor ID */
+  actorId?: string;
+  /** Filter by date range (start) */
+  from?: Date;
+  /** Filter by date range (end) */
+  to?: Date;
+  /** Limit number of results */
+  limit?: number;
+  /** Offset for pagination */
+  offset?: number;
+  /** Sort order */
+  orderBy?: 'timestamp' | 'type';
+  /** Sort direction */
+  orderDirection?: 'asc' | 'desc';
+}
+/**
+ * Interface for audit storage backends.
+ * Implement this to store audits in your preferred location.
+ *
+ * @example
+ * ```typescript
+ * // Same database storage (recommended for transactions)
+ * const auditStorage: AuditStorage = {
+ *   async write(records, trx) {
+ *     const db = trx ?? getDatabase();
+ *     await db.insertInto('audit_logs').values(records).execute();
+ *   },
+ * };
+ *
+ * // External audit service
+ * const externalAuditStorage: AuditStorage = {
+ *   async write(records) {
+ *     await fetch('https://audit.example.com/api/audits', {
+ *       method: 'POST',
+ *       body: JSON.stringify({ records }),
+ *     });
+ *   },
+ * };
+ * ```
+ *
+ * @template TAuditAction - Optional type parameter for type-safe audit actions.
+ *   When provided, this type is preserved in the Service definition and can be
+ *   extracted by EndpointBuilder to provide type inference for `.audit([...])`.
+ */
+interface AuditStorage<TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> {
+  /** @internal Type marker for extracting audit action type */
+  readonly __auditActionType?: TAuditAction;
+  /**
+   * Write audit records to storage.
+   * Called by Auditor.flush() to persist collected audits.
+   *
+   * @param records - The audit records to write
+   * @param trx - Optional transaction context (for same-DB storage)
+   */
+  write(records: AuditRecord[], trx?: unknown): Promise<void>;
+  /**
+   * Optional: Query audit records for retrieval.
+   * Implement this for audit log viewing/searching.
+   *
+   * @param options - Query filters and pagination
+   * @returns Matching audit records
+   */
+  query?(options: AuditQueryOptions): Promise<AuditRecord[]>;
+  /**
+   * Optional: Count audit records matching filters.
+   * Useful for pagination.
+   *
+   * @param options - Query filters (limit/offset ignored)
+   * @returns Count of matching records
+   */
+  count?(options: Omit<AuditQueryOptions, 'limit' | 'offset'>): Promise<number>;
+  /**
+   * Optional: Get the database connection for transactional audit writes.
+   * When implemented, the endpoint adaptor can automatically wrap handlers
+   * in a transaction, ensuring audits are atomic with other database operations.
+   *
+   * @returns Database connection (e.g., Kysely instance)
+   *
+   * @example
+   * ```typescript
+   * class KyselyAuditStorage implements AuditStorage {
+   *   constructor(private db: Kysely<DB>) {}
+   *
+   *   getDatabase() {
+   *     return this.db;
+   *   }
+   * }
+   * ```
+   */
+  getDatabase?(): unknown;
+  /**
+   * Optional: The service name of the database service used by this storage.
+   * When set, endpoint adaptors will automatically use the audit transaction as `db`
+   * in the handler context if the endpoint's database service has the same name.
+   *
+   * @example
+   * ```typescript
+   * const storage = new KyselyAuditStorage({
+   *   db,
+   *   tableName: 'audit_logs',
+   *   databaseServiceName: 'database', // Matches databaseService.serviceName
+   * });
+   * ```
+   */
+  databaseServiceName?: string;
+}
+//#endregion
 //#region src/types.d.ts
-
 /**
  * Represents an auditable action with a type and payload.
  * Similar to PublishableMessage in @geekmidas/events.
@@ -124,6 +241,10 @@ interface MappedAudit<TAuditAction extends AuditableAction<string, unknown>, TOu
  * Extract the AuditableAction type from an Auditor.
  */
 type ExtractAuditorAction<T> = T extends Auditor<infer A> ? A : never;
+/**
+ * Extract the AuditableAction type from an AuditStorage.
+ */
+type ExtractStorageAuditAction<T> = T extends AuditStorage<infer A> ? A : AuditableAction<string, unknown>;
 //#endregion
 //#region src/Auditor.d.ts
 /**
@@ -256,5 +377,5 @@ interface Auditor<TAuditAction extends AuditableAction<string, unknown> = Audita
   getTransaction(): TTransaction | undefined;
 }
 //#endregion
-export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, MappedAudit };
-//# sourceMappingURL=Auditor-ii62d_pF.d.mts.map
+export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit };
+//# sourceMappingURL=Auditor-QYUMGJCH.d.cts.map

package/dist/Auditor.d.cts

@@ -1,2 +1,2 @@
-import { Auditor } from "./Auditor-CZ8lkASv.cjs";
+import { Auditor } from "./Auditor-QYUMGJCH.cjs";
 export { Auditor };

package/dist/Auditor.d.mts

@@ -1,2 +1,2 @@
-import { Auditor } from "./Auditor-ii62d_pF.mjs";
+import { Auditor } from "./Auditor-D3me-qKX.mjs";
 export { Auditor };

package/dist/{DefaultAuditor-B-YEyT3q.d.mts → DefaultAuditor-BTuMMiWh.d.cts}

@@ -1,5 +1,4 @@
-import { AuditActor, AuditMetadata, AuditOptions, AuditRecord, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType } from "./Auditor-ii62d_pF.mjs";
-import { AuditStorage } from "./storage-BmA3SESr.mjs";
+import { AuditActor, AuditMetadata, AuditOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType } from "./Auditor-QYUMGJCH.cjs";
 
 //#region src/DefaultAuditor.d.ts
 
@@ -56,4 +55,4 @@ declare class DefaultAuditor<TAuditAction extends AuditableAction<string, unknow
 }
 //#endregion
 export { DefaultAuditor, DefaultAuditorConfig };
-//# sourceMappingURL=DefaultAuditor-B-YEyT3q.d.mts.map
+//# sourceMappingURL=DefaultAuditor-BTuMMiWh.d.cts.map

package/dist/{DefaultAuditor-RC-F_fTc.d.cts → DefaultAuditor-C1FWrJg6.d.mts}

@@ -1,5 +1,4 @@
-import { AuditActor, AuditMetadata, AuditOptions, AuditRecord, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType } from "./Auditor-CZ8lkASv.cjs";
-import { AuditStorage } from "./storage-ndQzIcWK.cjs";
+import { AuditActor, AuditMetadata, AuditOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType } from "./Auditor-D3me-qKX.mjs";
 
 //#region src/DefaultAuditor.d.ts
 
@@ -56,4 +55,4 @@ declare class DefaultAuditor<TAuditAction extends AuditableAction<string, unknow
 }
 //#endregion
 export { DefaultAuditor, DefaultAuditorConfig };
-//# sourceMappingURL=DefaultAuditor-RC-F_fTc.d.cts.map
+//# sourceMappingURL=DefaultAuditor-C1FWrJg6.d.mts.map

package/dist/DefaultAuditor.d.cts

@@ -1,4 +1,3 @@
-import "./Auditor-CZ8lkASv.cjs";
-import "./storage-ndQzIcWK.cjs";
-import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-RC-F_fTc.cjs";
+import "./Auditor-QYUMGJCH.cjs";
+import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-BTuMMiWh.cjs";
 export { DefaultAuditor, DefaultAuditorConfig };

package/dist/DefaultAuditor.d.mts

@@ -1,4 +1,3 @@
-import "./Auditor-ii62d_pF.mjs";
-import "./storage-BmA3SESr.mjs";
-import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-B-YEyT3q.mjs";
+import "./Auditor-D3me-qKX.mjs";
+import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-C1FWrJg6.mjs";
 export { DefaultAuditor, DefaultAuditorConfig };

package/dist/index.d.cts

@@ -1,4 +1,3 @@
-import { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, MappedAudit } from "./Auditor-CZ8lkASv.cjs";
-import { AuditQueryOptions, AuditStorage } from "./storage-ndQzIcWK.cjs";
-import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-RC-F_fTc.cjs";
-export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, DefaultAuditor, DefaultAuditorConfig, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, MappedAudit };
+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";
+export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, DefaultAuditor, DefaultAuditorConfig, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit };

package/dist/index.d.mts

@@ -1,4 +1,3 @@
-import { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, Auditor, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, MappedAudit } from "./Auditor-ii62d_pF.mjs";
-import { AuditQueryOptions, AuditStorage } from "./storage-BmA3SESr.mjs";
-import { DefaultAuditor, DefaultAuditorConfig } from "./DefaultAuditor-B-YEyT3q.mjs";
-export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, DefaultAuditor, DefaultAuditorConfig, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, MappedAudit };
+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";
+export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditQueryOptions, AuditRecord, AuditStorage, AuditableAction, Auditor, DefaultAuditor, DefaultAuditorConfig, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit };

package/dist/kysely.d.cts

@@ -1,5 +1,4 @@
-import { AuditRecord } from "./Auditor-CZ8lkASv.cjs";
-import { AuditQueryOptions, AuditStorage } from "./storage-ndQzIcWK.cjs";
+import { AuditQueryOptions, AuditRecord, AuditStorage } from "./Auditor-QYUMGJCH.cjs";
 import { ControlledTransaction, IsolationLevel, Kysely, Transaction } from "kysely";
 
 //#region src/kysely.d.ts

package/dist/kysely.d.mts

@@ -1,5 +1,4 @@
-import { AuditRecord } from "./Auditor-ii62d_pF.mjs";
-import { AuditQueryOptions, AuditStorage } from "./storage-BmA3SESr.mjs";
+import { AuditQueryOptions, AuditRecord, AuditStorage } from "./Auditor-D3me-qKX.mjs";
 import { ControlledTransaction, IsolationLevel, Kysely, Transaction } from "kysely";
 
 //#region src/kysely.d.ts

package/dist/storage.d.cts

@@ -1,3 +1,2 @@
-import "./Auditor-CZ8lkASv.cjs";
-import { AuditQueryOptions, AuditStorage } from "./storage-ndQzIcWK.cjs";
+import { AuditQueryOptions, AuditStorage } from "./Auditor-QYUMGJCH.cjs";
 export { AuditQueryOptions, AuditStorage };

package/dist/storage.d.mts

@@ -1,3 +1,2 @@
-import "./Auditor-ii62d_pF.mjs";
-import { AuditQueryOptions, AuditStorage } from "./storage-BmA3SESr.mjs";
+import { AuditQueryOptions, AuditStorage } from "./Auditor-D3me-qKX.mjs";
 export { AuditQueryOptions, AuditStorage };

package/dist/types.d.cts

@@ -1,2 +1,2 @@
-import { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, MappedAudit } from "./Auditor-CZ8lkASv.cjs";
-export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, MappedAudit };
+import { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit } from "./Auditor-QYUMGJCH.cjs";
+export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit };

package/dist/types.d.mts

@@ -1,2 +1,2 @@
-import { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, MappedAudit } from "./Auditor-ii62d_pF.mjs";
-export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, MappedAudit };
+import { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit } from "./Auditor-D3me-qKX.mjs";
+export { AuditActor, AuditMetadata, AuditOperation, AuditOptions, AuditRecord, AuditableAction, ExtractAuditPayload, ExtractAuditType, ExtractAuditorAction, ExtractStorageAuditAction, MappedAudit };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/audit",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "type": "module",
   "exports": {
     ".": {

package/src/index.ts

@@ -9,6 +9,7 @@ export type {
   ExtractAuditPayload,
   ExtractAuditType,
   ExtractAuditorAction,
+  ExtractStorageAuditAction,
   MappedAudit,
 } from './types';
 

package/src/storage.ts

@@ -1,4 +1,4 @@
-import type { AuditRecord } from './types';
+import type { AuditableAction, AuditRecord } from './types';
 
 /**
  * Options for querying audit records.
@@ -50,8 +50,19 @@ export interface AuditQueryOptions {
  *   },
  * };
  * ```
+ *
+ * @template TAuditAction - Optional type parameter for type-safe audit actions.
+ *   When provided, this type is preserved in the Service definition and can be
+ *   extracted by EndpointBuilder to provide type inference for `.audit([...])`.
  */
-export interface AuditStorage {
+export interface AuditStorage<
+  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<
+    string,
+    unknown
+  >,
+> {
+  /** @internal Type marker for extracting audit action type */
+  readonly __auditActionType?: TAuditAction;
   /**
    * Write audit records to storage.
    * Called by Auditor.flush() to persist collected audits.

package/src/types.ts

@@ -143,5 +143,13 @@ export interface MappedAudit<
  */
 export type ExtractAuditorAction<T> = T extends Auditor<infer A> ? A : never;
 
+/**
+ * Extract the AuditableAction type from an AuditStorage.
+ */
+export type ExtractStorageAuditAction<T> = T extends AuditStorage<infer A>
+  ? A
+  : AuditableAction<string, unknown>;
+
 // Forward declaration for Auditor type extraction
 import type { Auditor } from './Auditor';
+import type { AuditStorage } from './storage';

package/dist/storage-BmA3SESr.d.mts

@@ -1,117 +0,0 @@
-import { AuditRecord } from "./Auditor-ii62d_pF.mjs";
-
-//#region src/storage.d.ts
-
-/**
- * Options for querying audit records.
- */
-interface AuditQueryOptions {
-  /** Filter by audit type */
-  type?: string | string[];
-  /** Filter by entity ID */
-  entityId?: string | Record<string, unknown>;
-  /** Filter by table name */
-  table?: string;
-  /** Filter by actor ID */
-  actorId?: string;
-  /** Filter by date range (start) */
-  from?: Date;
-  /** Filter by date range (end) */
-  to?: Date;
-  /** Limit number of results */
-  limit?: number;
-  /** Offset for pagination */
-  offset?: number;
-  /** Sort order */
-  orderBy?: 'timestamp' | 'type';
-  /** Sort direction */
-  orderDirection?: 'asc' | 'desc';
-}
-/**
- * Interface for audit storage backends.
- * Implement this to store audits in your preferred location.
- *
- * @example
- * ```typescript
- * // Same database storage (recommended for transactions)
- * const auditStorage: AuditStorage = {
- *   async write(records, trx) {
- *     const db = trx ?? getDatabase();
- *     await db.insertInto('audit_logs').values(records).execute();
- *   },
- * };
- *
- * // External audit service
- * const externalAuditStorage: AuditStorage = {
- *   async write(records) {
- *     await fetch('https://audit.example.com/api/audits', {
- *       method: 'POST',
- *       body: JSON.stringify({ records }),
- *     });
- *   },
- * };
- * ```
- */
-interface AuditStorage {
-  /**
-   * Write audit records to storage.
-   * Called by Auditor.flush() to persist collected audits.
-   *
-   * @param records - The audit records to write
-   * @param trx - Optional transaction context (for same-DB storage)
-   */
-  write(records: AuditRecord[], trx?: unknown): Promise<void>;
-  /**
-   * Optional: Query audit records for retrieval.
-   * Implement this for audit log viewing/searching.
-   *
-   * @param options - Query filters and pagination
-   * @returns Matching audit records
-   */
-  query?(options: AuditQueryOptions): Promise<AuditRecord[]>;
-  /**
-   * Optional: Count audit records matching filters.
-   * Useful for pagination.
-   *
-   * @param options - Query filters (limit/offset ignored)
-   * @returns Count of matching records
-   */
-  count?(options: Omit<AuditQueryOptions, 'limit' | 'offset'>): Promise<number>;
-  /**
-   * Optional: Get the database connection for transactional audit writes.
-   * When implemented, the endpoint adaptor can automatically wrap handlers
-   * in a transaction, ensuring audits are atomic with other database operations.
-   *
-   * @returns Database connection (e.g., Kysely instance)
-   *
-   * @example
-   * ```typescript
-   * class KyselyAuditStorage implements AuditStorage {
-   *   constructor(private db: Kysely<DB>) {}
-   *
-   *   getDatabase() {
-   *     return this.db;
-   *   }
-   * }
-   * ```
-   */
-  getDatabase?(): unknown;
-  /**
-   * Optional: The service name of the database service used by this storage.
-   * When set, endpoint adaptors will automatically use the audit transaction as `db`
-   * in the handler context if the endpoint's database service has the same name.
-   *
-   * @example
-   * ```typescript
-   * const storage = new KyselyAuditStorage({
-   *   db,
-   *   tableName: 'audit_logs',
-   *   databaseServiceName: 'database', // Matches databaseService.serviceName
-   * });
-   * ```
-   */
-  databaseServiceName?: string;
-}
-//#endregion
-export { AuditQueryOptions, AuditStorage };
-//# sourceMappingURL=storage-BmA3SESr.d.mts.map

package/dist/storage-ndQzIcWK.d.cts

@@ -1,117 +0,0 @@
-import { AuditRecord } from "./Auditor-CZ8lkASv.cjs";
-
-//#region src/storage.d.ts
-
-/**
- * Options for querying audit records.
- */
-interface AuditQueryOptions {
-  /** Filter by audit type */
-  type?: string | string[];
-  /** Filter by entity ID */
-  entityId?: string | Record<string, unknown>;
-  /** Filter by table name */
-  table?: string;
-  /** Filter by actor ID */
-  actorId?: string;
-  /** Filter by date range (start) */
-  from?: Date;
-  /** Filter by date range (end) */
-  to?: Date;
-  /** Limit number of results */
-  limit?: number;
-  /** Offset for pagination */
-  offset?: number;
-  /** Sort order */
-  orderBy?: 'timestamp' | 'type';
-  /** Sort direction */
-  orderDirection?: 'asc' | 'desc';
-}
-/**
- * Interface for audit storage backends.
- * Implement this to store audits in your preferred location.
- *
- * @example
- * ```typescript
- * // Same database storage (recommended for transactions)
- * const auditStorage: AuditStorage = {
- *   async write(records, trx) {
- *     const db = trx ?? getDatabase();
- *     await db.insertInto('audit_logs').values(records).execute();
- *   },
- * };
- *
- * // External audit service
- * const externalAuditStorage: AuditStorage = {
- *   async write(records) {
- *     await fetch('https://audit.example.com/api/audits', {
- *       method: 'POST',
- *       body: JSON.stringify({ records }),
- *     });
- *   },
- * };
- * ```
- */
-interface AuditStorage {
-  /**
-   * Write audit records to storage.
-   * Called by Auditor.flush() to persist collected audits.
-   *
-   * @param records - The audit records to write
-   * @param trx - Optional transaction context (for same-DB storage)
-   */
-  write(records: AuditRecord[], trx?: unknown): Promise<void>;
-  /**
-   * Optional: Query audit records for retrieval.
-   * Implement this for audit log viewing/searching.
-   *
-   * @param options - Query filters and pagination
-   * @returns Matching audit records
-   */
-  query?(options: AuditQueryOptions): Promise<AuditRecord[]>;
-  /**
-   * Optional: Count audit records matching filters.
-   * Useful for pagination.
-   *
-   * @param options - Query filters (limit/offset ignored)
-   * @returns Count of matching records
-   */
-  count?(options: Omit<AuditQueryOptions, 'limit' | 'offset'>): Promise<number>;
-  /**
-   * Optional: Get the database connection for transactional audit writes.
-   * When implemented, the endpoint adaptor can automatically wrap handlers
-   * in a transaction, ensuring audits are atomic with other database operations.
-   *
-   * @returns Database connection (e.g., Kysely instance)
-   *
-   * @example
-   * ```typescript
-   * class KyselyAuditStorage implements AuditStorage {
-   *   constructor(private db: Kysely<DB>) {}
-   *
-   *   getDatabase() {
-   *     return this.db;
-   *   }
-   * }
-   * ```
-   */
-  getDatabase?(): unknown;
-  /**
-   * Optional: The service name of the database service used by this storage.
-   * When set, endpoint adaptors will automatically use the audit transaction as `db`
-   * in the handler context if the endpoint's database service has the same name.
-   *
-   * @example
-   * ```typescript
-   * const storage = new KyselyAuditStorage({
-   *   db,
-   *   tableName: 'audit_logs',
-   *   databaseServiceName: 'database', // Matches databaseService.serviceName
-   * });
-   * ```
-   */
-  databaseServiceName?: string;
-}
-//#endregion
-export { AuditQueryOptions, AuditStorage };
-//# sourceMappingURL=storage-ndQzIcWK.d.cts.map