@lssm/module.audit-trail 0.0.0-canary-20251217054315 → 0.0.0-canary-20251217060433

package/dist/audit-trail.feature.d.ts

@@ -0,0 +1,11 @@
+import { FeatureModuleSpec } from "@lssm/lib.contracts";
+
+//#region src/audit-trail.feature.d.ts
+
+/**
+ * Audit Trail feature module that bundles audit log querying,
+ * export, and statistics capabilities.
+ */
+declare const AuditTrailFeature: FeatureModuleSpec;
+//#endregion
+export { AuditTrailFeature };

package/dist/contracts/index.d.ts

@@ -0,0 +1,582 @@
+import * as _lssm_lib_schema0 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
+
+//#region src/contracts/index.d.ts
+declare const AuditLogModel: _lssm_lib_schema0.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  eventName: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  eventVersion: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+  payload: {
+    type: _lssm_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: false;
+  };
+  actorId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  actorType: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  actorEmail: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  targetId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  targetType: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  orgId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  traceId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  clientIp: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  occurredAt: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+  recordedAt: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>;
+declare const AuditQueryInputModel: _lssm_lib_schema0.SchemaModel<{
+  eventName: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  actorId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  targetId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  targetType: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  orgId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  traceId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  from: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  to: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  limit: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+  offset: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+}>;
+declare const AuditQueryOutputModel: _lssm_lib_schema0.SchemaModel<{
+  logs: {
+    type: _lssm_lib_schema0.SchemaModel<{
+      id: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      eventName: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      eventVersion: {
+        type: _lssm_lib_schema0.FieldType<number, number>;
+        isOptional: false;
+      };
+      payload: {
+        type: _lssm_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: false;
+      };
+      actorId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      actorType: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      actorEmail: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      targetId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      targetType: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      orgId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      traceId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      clientIp: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      occurredAt: {
+        type: _lssm_lib_schema0.FieldType<Date, string>;
+        isOptional: false;
+      };
+      recordedAt: {
+        type: _lssm_lib_schema0.FieldType<Date, string>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  total: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+  hasMore: {
+    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+}>;
+declare const ExportFormatEnum: _lssm_lib_schema0.EnumType<[string, string, string]>;
+declare const AuditExportInputModel: _lssm_lib_schema0.SchemaModel<{
+  orgId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  from: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+  to: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+  format: {
+    type: _lssm_lib_schema0.EnumType<[string, string, string]>;
+    isOptional: true;
+    defaultValue: string;
+  };
+  eventNames: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isArray: true;
+    isOptional: true;
+  };
+}>;
+declare const ExportStatusEnum: _lssm_lib_schema0.EnumType<[string, string, string, string]>;
+declare const AuditExportOutputModel: _lssm_lib_schema0.SchemaModel<{
+  exportId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _lssm_lib_schema0.EnumType<[string, string, string, string]>;
+    isOptional: false;
+  };
+  downloadUrl: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+}>;
+declare const AuditStatsInputModel: _lssm_lib_schema0.SchemaModel<{
+  orgId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  from: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  to: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+}>;
+declare const AuditStatsOutputModel: _lssm_lib_schema0.SchemaModel<{
+  totalLogs: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+  uniqueActors: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+  uniqueTargets: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+  eventCounts: {
+    type: _lssm_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: false;
+  };
+}>;
+/**
+ * Query audit logs.
+ */
+declare const QueryAuditLogsContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+  eventName: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  actorId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  targetId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  targetType: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  orgId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  traceId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  from: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  to: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  limit: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+  offset: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+    defaultValue: number;
+  };
+}>, _lssm_lib_schema0.SchemaModel<{
+  logs: {
+    type: _lssm_lib_schema0.SchemaModel<{
+      id: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      eventName: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      eventVersion: {
+        type: _lssm_lib_schema0.FieldType<number, number>;
+        isOptional: false;
+      };
+      payload: {
+        type: _lssm_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: false;
+      };
+      actorId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      actorType: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      actorEmail: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      targetId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      targetType: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      orgId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      traceId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      clientIp: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      occurredAt: {
+        type: _lssm_lib_schema0.FieldType<Date, string>;
+        isOptional: false;
+      };
+      recordedAt: {
+        type: _lssm_lib_schema0.FieldType<Date, string>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+  total: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+  hasMore: {
+    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+}>, undefined>;
+/**
+ * Get audit log by ID.
+ */
+declare const GetAuditLogContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+  logId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _lssm_lib_schema0.SchemaModel<{
+  id: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  eventName: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  eventVersion: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+  payload: {
+    type: _lssm_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: false;
+  };
+  actorId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  actorType: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  actorEmail: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  targetId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  targetType: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  orgId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  traceId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  clientIp: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  occurredAt: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+  recordedAt: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>, undefined>;
+/**
+ * Get audit logs by trace ID.
+ */
+declare const GetAuditTraceContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+  traceId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _lssm_lib_schema0.SchemaModel<{
+  logs: {
+    type: _lssm_lib_schema0.SchemaModel<{
+      id: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      eventName: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      eventVersion: {
+        type: _lssm_lib_schema0.FieldType<number, number>;
+        isOptional: false;
+      };
+      payload: {
+        type: _lssm_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: false;
+      };
+      actorId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      actorType: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      actorEmail: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      targetId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      targetType: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      orgId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      traceId: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      clientIp: {
+        type: _lssm_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      occurredAt: {
+        type: _lssm_lib_schema0.FieldType<Date, string>;
+        isOptional: false;
+      };
+      recordedAt: {
+        type: _lssm_lib_schema0.FieldType<Date, string>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+}>, undefined>;
+/**
+ * Export audit logs.
+ */
+declare const ExportAuditLogsContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+  orgId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  from: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+  to: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+  format: {
+    type: _lssm_lib_schema0.EnumType<[string, string, string]>;
+    isOptional: true;
+    defaultValue: string;
+  };
+  eventNames: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isArray: true;
+    isOptional: true;
+  };
+}>, _lssm_lib_schema0.SchemaModel<{
+  exportId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _lssm_lib_schema0.EnumType<[string, string, string, string]>;
+    isOptional: false;
+  };
+  downloadUrl: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+/**
+ * Get audit statistics.
+ */
+declare const GetAuditStatsContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+  orgId: {
+    type: _lssm_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  from: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  to: {
+    type: _lssm_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+}>, _lssm_lib_schema0.SchemaModel<{
+  totalLogs: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+  uniqueActors: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+  uniqueTargets: {
+    type: _lssm_lib_schema0.FieldType<number, number>;
+    isOptional: false;
+  };
+  eventCounts: {
+    type: _lssm_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: false;
+  };
+}>, undefined>;
+//#endregion
+export { AuditExportInputModel, AuditExportOutputModel, AuditLogModel, AuditQueryInputModel, AuditQueryOutputModel, AuditStatsInputModel, AuditStatsOutputModel, ExportAuditLogsContract, ExportFormatEnum, ExportStatusEnum, GetAuditLogContract, GetAuditStatsContract, GetAuditTraceContract, QueryAuditLogsContract };

package/dist/entities/index.d.ts

@@ -0,0 +1,90 @@
+import * as _lssm_lib_schema147 from "@lssm/lib.schema";
+import { ModuleSchemaContribution } from "@lssm/lib.schema";
+
+//#region src/entities/index.d.ts
+/**
+ * AuditLog entity - main audit log entry.
+ */
+declare const AuditLogEntity: _lssm_lib_schema147.EntitySpec<{
+  id: _lssm_lib_schema147.EntityScalarField;
+  eventName: _lssm_lib_schema147.EntityScalarField;
+  eventVersion: _lssm_lib_schema147.EntityScalarField;
+  payload: _lssm_lib_schema147.EntityScalarField;
+  actorId: _lssm_lib_schema147.EntityScalarField;
+  actorType: _lssm_lib_schema147.EntityScalarField;
+  actorEmail: _lssm_lib_schema147.EntityScalarField;
+  targetId: _lssm_lib_schema147.EntityScalarField;
+  targetType: _lssm_lib_schema147.EntityScalarField;
+  orgId: _lssm_lib_schema147.EntityScalarField;
+  tenantId: _lssm_lib_schema147.EntityScalarField;
+  traceId: _lssm_lib_schema147.EntityScalarField;
+  spanId: _lssm_lib_schema147.EntityScalarField;
+  requestId: _lssm_lib_schema147.EntityScalarField;
+  sessionId: _lssm_lib_schema147.EntityScalarField;
+  clientIp: _lssm_lib_schema147.EntityScalarField;
+  userAgent: _lssm_lib_schema147.EntityScalarField;
+  tags: _lssm_lib_schema147.EntityScalarField;
+  metadata: _lssm_lib_schema147.EntityScalarField;
+  occurredAt: _lssm_lib_schema147.EntityScalarField;
+  recordedAt: _lssm_lib_schema147.EntityScalarField;
+}>;
+/**
+ * AuditLogArchive entity - archived logs for long-term retention.
+ */
+declare const AuditLogArchiveEntity: _lssm_lib_schema147.EntitySpec<{
+  id: _lssm_lib_schema147.EntityScalarField;
+  batchId: _lssm_lib_schema147.EntityScalarField;
+  logCount: _lssm_lib_schema147.EntityScalarField;
+  fromDate: _lssm_lib_schema147.EntityScalarField;
+  toDate: _lssm_lib_schema147.EntityScalarField;
+  storagePath: _lssm_lib_schema147.EntityScalarField;
+  storageType: _lssm_lib_schema147.EntityScalarField;
+  compressedSize: _lssm_lib_schema147.EntityScalarField;
+  checksum: _lssm_lib_schema147.EntityScalarField;
+  retainUntil: _lssm_lib_schema147.EntityScalarField;
+  createdAt: _lssm_lib_schema147.EntityScalarField;
+}>;
+/**
+ * All audit trail entities for schema composition.
+ */
+declare const auditTrailEntities: (_lssm_lib_schema147.EntitySpec<{
+  id: _lssm_lib_schema147.EntityScalarField;
+  eventName: _lssm_lib_schema147.EntityScalarField;
+  eventVersion: _lssm_lib_schema147.EntityScalarField;
+  payload: _lssm_lib_schema147.EntityScalarField;
+  actorId: _lssm_lib_schema147.EntityScalarField;
+  actorType: _lssm_lib_schema147.EntityScalarField;
+  actorEmail: _lssm_lib_schema147.EntityScalarField;
+  targetId: _lssm_lib_schema147.EntityScalarField;
+  targetType: _lssm_lib_schema147.EntityScalarField;
+  orgId: _lssm_lib_schema147.EntityScalarField;
+  tenantId: _lssm_lib_schema147.EntityScalarField;
+  traceId: _lssm_lib_schema147.EntityScalarField;
+  spanId: _lssm_lib_schema147.EntityScalarField;
+  requestId: _lssm_lib_schema147.EntityScalarField;
+  sessionId: _lssm_lib_schema147.EntityScalarField;
+  clientIp: _lssm_lib_schema147.EntityScalarField;
+  userAgent: _lssm_lib_schema147.EntityScalarField;
+  tags: _lssm_lib_schema147.EntityScalarField;
+  metadata: _lssm_lib_schema147.EntityScalarField;
+  occurredAt: _lssm_lib_schema147.EntityScalarField;
+  recordedAt: _lssm_lib_schema147.EntityScalarField;
+}> | _lssm_lib_schema147.EntitySpec<{
+  id: _lssm_lib_schema147.EntityScalarField;
+  batchId: _lssm_lib_schema147.EntityScalarField;
+  logCount: _lssm_lib_schema147.EntityScalarField;
+  fromDate: _lssm_lib_schema147.EntityScalarField;
+  toDate: _lssm_lib_schema147.EntityScalarField;
+  storagePath: _lssm_lib_schema147.EntityScalarField;
+  storageType: _lssm_lib_schema147.EntityScalarField;
+  compressedSize: _lssm_lib_schema147.EntityScalarField;
+  checksum: _lssm_lib_schema147.EntityScalarField;
+  retainUntil: _lssm_lib_schema147.EntityScalarField;
+  createdAt: _lssm_lib_schema147.EntityScalarField;
+}>)[];
+/**
+ * Module schema contribution for audit trail.
+ */
+declare const auditTrailSchemaContribution: ModuleSchemaContribution;
+//#endregion
+export { AuditLogArchiveEntity, AuditLogEntity, auditTrailEntities, auditTrailSchemaContribution };

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { AuditTrailFeature } from "./audit-trail.feature.js";
+import { AuditExportInputModel, AuditExportOutputModel, AuditLogModel, AuditQueryInputModel, AuditQueryOutputModel, AuditStatsInputModel, AuditStatsOutputModel, ExportAuditLogsContract, ExportFormatEnum, ExportStatusEnum, GetAuditLogContract, GetAuditStatsContract, GetAuditTraceContract, QueryAuditLogsContract } from "./contracts/index.js";
+import { AuditLogArchiveEntity, AuditLogEntity, auditTrailEntities, auditTrailSchemaContribution } from "./entities/index.js";
+import { AuditStorageAdapter, ExtendedAuditQueryOptions, InMemoryAuditStorage, RetentionPolicy, RetentionPolicyConfig, createInMemoryAuditStorage } from "./storage/index.js";
+import { AuditQueryOptions, AuditRecord, AuditStorage } from "@lssm/lib.bus";
+export { AuditExportInputModel, AuditExportOutputModel, AuditLogArchiveEntity, AuditLogEntity, AuditLogModel, AuditQueryInputModel, type AuditQueryOptions, AuditQueryOutputModel, type AuditRecord, AuditStatsInputModel, AuditStatsOutputModel, type AuditStorage, AuditStorageAdapter, AuditTrailFeature, ExportAuditLogsContract, ExportFormatEnum, ExportStatusEnum, ExtendedAuditQueryOptions, GetAuditLogContract, GetAuditStatsContract, GetAuditTraceContract, InMemoryAuditStorage, QueryAuditLogsContract, RetentionPolicy, RetentionPolicyConfig, auditTrailEntities, auditTrailSchemaContribution, createInMemoryAuditStorage };

package/dist/storage/index.d.ts

@@ -0,0 +1,87 @@
+import { AuditQueryOptions, AuditRecord, AuditStorage } from "@lssm/lib.bus";
+
+//#region src/storage/index.d.ts
+
+/**
+ * Extended query options for audit storage.
+ */
+interface ExtendedAuditQueryOptions extends AuditQueryOptions {
+  targetType?: string;
+  clientIp?: string;
+  sessionId?: string;
+  orderBy?: 'occurredAt' | 'recordedAt';
+  orderDir?: 'asc' | 'desc';
+}
+/**
+ * Audit storage adapter interface with extended capabilities.
+ */
+interface AuditStorageAdapter extends AuditStorage {
+  /** Query audit records with extended options */
+  query(options: ExtendedAuditQueryOptions): Promise<AuditRecord[]>;
+  /** Count matching records */
+  count(options: Omit<ExtendedAuditQueryOptions, 'limit' | 'offset'>): Promise<number>;
+  /** Get a single record by ID */
+  getById(id: string): Promise<AuditRecord | null>;
+  /** Get all records for a trace */
+  getByTraceId(traceId: string): Promise<AuditRecord[]>;
+  /** Delete old records (for retention) */
+  deleteOlderThan(date: Date): Promise<number>;
+}
+/**
+ * In-memory audit storage for development/testing.
+ */
+declare class InMemoryAuditStorage implements AuditStorageAdapter {
+  private records;
+  store(record: AuditRecord): Promise<void>;
+  query(options: ExtendedAuditQueryOptions): Promise<AuditRecord[]>;
+  count(options: Omit<ExtendedAuditQueryOptions, 'limit' | 'offset'>): Promise<number>;
+  getById(id: string): Promise<AuditRecord | null>;
+  getByTraceId(traceId: string): Promise<AuditRecord[]>;
+  deleteOlderThan(date: Date): Promise<number>;
+  /**
+   * Get all records (for testing).
+   */
+  getAll(): AuditRecord[];
+  /**
+   * Clear all records (for testing).
+   */
+  clear(): void;
+}
+/**
+ * Retention policy configuration.
+ */
+interface RetentionPolicyConfig {
+  /** Days to keep detailed logs */
+  hotRetentionDays: number;
+  /** Days to keep archived logs (for compliance) */
+  archiveRetentionDays?: number;
+  /** Cron expression for cleanup schedule */
+  cleanupSchedule?: string;
+}
+/**
+ * Retention policy manager.
+ */
+declare class RetentionPolicy {
+  private readonly config;
+  constructor(config: RetentionPolicyConfig);
+  /**
+   * Get the cutoff date for hot storage.
+   */
+  getHotCutoff(): Date;
+  /**
+   * Get the cutoff date for archive storage.
+   */
+  getArchiveCutoff(): Date | null;
+  /**
+   * Apply retention policy to storage.
+   */
+  apply(storage: AuditStorageAdapter): Promise<{
+    deletedCount: number;
+  }>;
+}
+/**
+ * Create an in-memory audit storage.
+ */
+declare function createInMemoryAuditStorage(): InMemoryAuditStorage;
+//#endregion
+export { AuditStorageAdapter, ExtendedAuditQueryOptions, InMemoryAuditStorage, RetentionPolicy, RetentionPolicyConfig, createInMemoryAuditStorage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/module.audit-trail",
-  "version": "0.0.0-canary-20251217054315",
+  "version": "0.0.0-canary-20251217060433",
   "description": "Audit trail module for tracking and querying system events",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,22 +18,22 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@lssm/lib.schema": "0.0.0-canary-20251217054315",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217054315",
-    "@lssm/lib.bus": "0.0.0-canary-20251217054315",
+    "@lssm/lib.schema": "0.0.0-canary-20251217060433",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217060433",
+    "@lssm/lib.bus": "0.0.0-canary-20251217060433",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.typescript": "0.0.0-canary-20251217054315",
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217054315",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217060433",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217060433",
     "typescript": "^5.9.3"
   },
   "exports": {
-    ".": "./src/index.ts",
-    "./audit-trail.feature": "./src/audit-trail.feature.ts",
-    "./contracts": "./src/contracts/index.ts",
-    "./entities": "./src/entities/index.ts",
-    "./storage": "./src/storage/index.ts",
+    ".": "./dist/index.js",
+    "./audit-trail.feature": "./dist/audit-trail.feature.js",
+    "./contracts": "./dist/contracts/index.js",
+    "./entities": "./dist/entities/index.js",
+    "./storage": "./dist/storage/index.js",
     "./*": "./*"
   },
   "module": "./dist/index.js",