alepha 0.13.6 → 0.13.7

package/dist/api-audits/index.d.ts

@@ -0,0 +1,1194 @@
+import * as alepha349 from "alepha";
+import { Alepha, KIND, Primitive, Static, TNull, TObject, TOptional, TSchema, TUnion } from "alepha";
+import * as alepha_orm71 from "alepha/orm";
+import { Page } from "alepha/orm";
+import * as alepha_server0 from "alepha/server";
+import { ServerRequest } from "alepha/server";
+import * as alepha_logger0 from "alepha/logger";
+import { BuildExtraConfigColumns, SQL } from "drizzle-orm";
+import { PgColumnBuilderBase, PgSequenceOptions, PgTableExtraConfigValue, UpdateDeleteAction } from "drizzle-orm/pg-core";
+import "alepha/datetime";
+import "alepha/retry";
+import "alepha/lock";
+import "drizzle-orm/postgres-js";
+import "postgres";
+import "drizzle-orm/sqlite-core";
+
+//#region ../../src/api-audits/entities/audits.d.ts
+/**
+ * Audit severity levels for categorizing events.
+ */
+declare const auditSeveritySchema: alepha349.TUnsafe<"info" | "warning" | "critical">;
+type AuditSeverity = Static<typeof auditSeveritySchema>;
+/**
+ * Audit log entity for tracking important system events.
+ *
+ * Stores comprehensive audit information including:
+ * - Who performed the action (userId, userRealm)
+ * - What happened (type, action, resource)
+ * - When it happened (createdAt)
+ * - Context and details (metadata, ipAddress, userAgent)
+ */
+declare const audits: alepha_orm71.EntityPrimitive<alepha349.TObject<{
+  id: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_PRIMARY_KEY>, typeof alepha_orm71.PG_DEFAULT>;
+  createdAt: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_CREATED_AT>, typeof alepha_orm71.PG_DEFAULT>;
+  /**
+   * Audit event type (e.g., "auth", "user", "payment", "system").
+   * Used for categorizing and filtering audit events.
+   */
+  type: alepha349.TString;
+  /**
+   * Specific action performed (e.g., "login", "logout", "create", "update", "delete").
+   */
+  action: alepha349.TString;
+  /**
+   * Severity level of the event.
+   */
+  severity: alepha_orm71.PgAttr<alepha349.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm71.PG_DEFAULT>;
+  /**
+   * User ID who performed the action (null for system events).
+   */
+  userId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * User realm for multi-tenant support.
+   */
+  userRealm: alepha349.TOptional<alepha349.TString>;
+  /**
+   * User email at the time of the event (denormalized for history).
+   */
+  userEmail: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Resource type affected (e.g., "user", "order", "file").
+   */
+  resourceType: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Resource ID affected.
+   */
+  resourceId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Human-readable description of the event.
+   */
+  description: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Additional metadata/context as JSON.
+   */
+  metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+  /**
+   * Client IP address.
+   */
+  ipAddress: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Client user agent.
+   */
+  userAgent: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Session ID if applicable.
+   */
+  sessionId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Request ID for correlation.
+   */
+  requestId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Whether the action was successful.
+   */
+  success: alepha_orm71.PgAttr<alepha349.TBoolean, typeof alepha_orm71.PG_DEFAULT>;
+  /**
+   * Error message if the action failed.
+   */
+  errorMessage: alepha349.TOptional<alepha349.TString>;
+}>>;
+declare const auditEntitySchema: alepha349.TObject<{
+  id: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_PRIMARY_KEY>, typeof alepha_orm71.PG_DEFAULT>;
+  createdAt: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_CREATED_AT>, typeof alepha_orm71.PG_DEFAULT>;
+  /**
+   * Audit event type (e.g., "auth", "user", "payment", "system").
+   * Used for categorizing and filtering audit events.
+   */
+  type: alepha349.TString;
+  /**
+   * Specific action performed (e.g., "login", "logout", "create", "update", "delete").
+   */
+  action: alepha349.TString;
+  /**
+   * Severity level of the event.
+   */
+  severity: alepha_orm71.PgAttr<alepha349.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm71.PG_DEFAULT>;
+  /**
+   * User ID who performed the action (null for system events).
+   */
+  userId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * User realm for multi-tenant support.
+   */
+  userRealm: alepha349.TOptional<alepha349.TString>;
+  /**
+   * User email at the time of the event (denormalized for history).
+   */
+  userEmail: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Resource type affected (e.g., "user", "order", "file").
+   */
+  resourceType: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Resource ID affected.
+   */
+  resourceId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Human-readable description of the event.
+   */
+  description: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Additional metadata/context as JSON.
+   */
+  metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+  /**
+   * Client IP address.
+   */
+  ipAddress: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Client user agent.
+   */
+  userAgent: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Session ID if applicable.
+   */
+  sessionId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Request ID for correlation.
+   */
+  requestId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Whether the action was successful.
+   */
+  success: alepha_orm71.PgAttr<alepha349.TBoolean, typeof alepha_orm71.PG_DEFAULT>;
+  /**
+   * Error message if the action failed.
+   */
+  errorMessage: alepha349.TOptional<alepha349.TString>;
+}>;
+declare const auditEntityInsertSchema: alepha_orm71.TObjectInsert<alepha349.TObject<{
+  id: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_PRIMARY_KEY>, typeof alepha_orm71.PG_DEFAULT>;
+  createdAt: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_CREATED_AT>, typeof alepha_orm71.PG_DEFAULT>;
+  /**
+   * Audit event type (e.g., "auth", "user", "payment", "system").
+   * Used for categorizing and filtering audit events.
+   */
+  type: alepha349.TString;
+  /**
+   * Specific action performed (e.g., "login", "logout", "create", "update", "delete").
+   */
+  action: alepha349.TString;
+  /**
+   * Severity level of the event.
+   */
+  severity: alepha_orm71.PgAttr<alepha349.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm71.PG_DEFAULT>;
+  /**
+   * User ID who performed the action (null for system events).
+   */
+  userId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * User realm for multi-tenant support.
+   */
+  userRealm: alepha349.TOptional<alepha349.TString>;
+  /**
+   * User email at the time of the event (denormalized for history).
+   */
+  userEmail: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Resource type affected (e.g., "user", "order", "file").
+   */
+  resourceType: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Resource ID affected.
+   */
+  resourceId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Human-readable description of the event.
+   */
+  description: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Additional metadata/context as JSON.
+   */
+  metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+  /**
+   * Client IP address.
+   */
+  ipAddress: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Client user agent.
+   */
+  userAgent: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Session ID if applicable.
+   */
+  sessionId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Request ID for correlation.
+   */
+  requestId: alepha349.TOptional<alepha349.TString>;
+  /**
+   * Whether the action was successful.
+   */
+  success: alepha_orm71.PgAttr<alepha349.TBoolean, typeof alepha_orm71.PG_DEFAULT>;
+  /**
+   * Error message if the action failed.
+   */
+  errorMessage: alepha349.TOptional<alepha349.TString>;
+}>>;
+type AuditEntity = Static<typeof audits.schema>;
+//#endregion
+//#region ../../src/api-audits/schemas/auditQuerySchema.d.ts
+/**
+ * Query schema for searching and filtering audit logs.
+ */
+declare const auditQuerySchema: alepha349.TObject<{
+  page: alepha349.TOptional<alepha349.TInteger>;
+  size: alepha349.TOptional<alepha349.TInteger>;
+  sort: alepha349.TOptional<alepha349.TString>;
+  type: alepha349.TOptional<alepha349.TString>;
+  action: alepha349.TOptional<alepha349.TString>;
+  severity: alepha349.TOptional<alepha349.TUnsafe<"info" | "warning" | "critical">>;
+  userId: alepha349.TOptional<alepha349.TString>;
+  userRealm: alepha349.TOptional<alepha349.TString>;
+  resourceType: alepha349.TOptional<alepha349.TString>;
+  resourceId: alepha349.TOptional<alepha349.TString>;
+  success: alepha349.TOptional<alepha349.TBoolean>;
+  from: alepha349.TOptional<alepha349.TString>;
+  to: alepha349.TOptional<alepha349.TString>;
+  search: alepha349.TOptional<alepha349.TString>;
+}>;
+type AuditQuery = Static<typeof auditQuerySchema>;
+//#endregion
+//#region ../../src/api-audits/schemas/createAuditSchema.d.ts
+/**
+ * Schema for creating a new audit log entry.
+ */
+declare const createAuditSchema: alepha349.TObject<{
+  type: alepha349.TString;
+  action: alepha349.TString;
+  severity: alepha349.TOptional<alepha349.TUnsafe<"info" | "warning" | "critical">>;
+  userId: alepha349.TOptional<alepha349.TString>;
+  userRealm: alepha349.TOptional<alepha349.TString>;
+  userEmail: alepha349.TOptional<alepha349.TString>;
+  resourceType: alepha349.TOptional<alepha349.TString>;
+  resourceId: alepha349.TOptional<alepha349.TString>;
+  description: alepha349.TOptional<alepha349.TString>;
+  metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+  ipAddress: alepha349.TOptional<alepha349.TString>;
+  userAgent: alepha349.TOptional<alepha349.TString>;
+  sessionId: alepha349.TOptional<alepha349.TString>;
+  requestId: alepha349.TOptional<alepha349.TString>;
+  success: alepha349.TOptional<alepha349.TBoolean>;
+  errorMessage: alepha349.TOptional<alepha349.TString>;
+}>;
+type CreateAudit = Static<typeof createAuditSchema>;
+//#endregion
+//#region ../../src/api-audits/services/AuditService.d.ts
+/**
+ * Registered audit type definition.
+ */
+interface AuditTypeDefinition {
+  type: string;
+  description?: string;
+  actions: string[];
+}
+/**
+ * Service for managing audit logs.
+ *
+ * Provides methods for:
+ * - Creating audit entries
+ * - Querying audit history
+ * - Aggregating audit statistics
+ * - Managing registered audit types
+ */
+declare class AuditService {
+  protected readonly alepha: Alepha;
+  protected readonly log: alepha_logger0.Logger;
+  protected readonly repo: alepha_orm71.Repository<alepha349.TObject<{
+    id: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_PRIMARY_KEY>, typeof alepha_orm71.PG_DEFAULT>;
+    createdAt: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_CREATED_AT>, typeof alepha_orm71.PG_DEFAULT>;
+    type: alepha349.TString;
+    action: alepha349.TString;
+    severity: alepha_orm71.PgAttr<alepha349.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm71.PG_DEFAULT>;
+    userId: alepha349.TOptional<alepha349.TString>;
+    userRealm: alepha349.TOptional<alepha349.TString>;
+    userEmail: alepha349.TOptional<alepha349.TString>;
+    resourceType: alepha349.TOptional<alepha349.TString>;
+    resourceId: alepha349.TOptional<alepha349.TString>;
+    description: alepha349.TOptional<alepha349.TString>;
+    metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+    ipAddress: alepha349.TOptional<alepha349.TString>;
+    userAgent: alepha349.TOptional<alepha349.TString>;
+    sessionId: alepha349.TOptional<alepha349.TString>;
+    requestId: alepha349.TOptional<alepha349.TString>;
+    success: alepha_orm71.PgAttr<alepha349.TBoolean, typeof alepha_orm71.PG_DEFAULT>;
+    errorMessage: alepha349.TOptional<alepha349.TString>;
+  }>>;
+  /**
+   * Registry of audit types and their allowed actions.
+   */
+  protected readonly auditTypes: Map<string, AuditTypeDefinition>;
+  /**
+   * Register an audit type with its allowed actions.
+   */
+  registerType(definition: AuditTypeDefinition): void;
+  /**
+   * Get all registered audit types.
+   */
+  getRegisteredTypes(): AuditTypeDefinition[];
+  /**
+   * Get current request context if available.
+   */
+  protected getRequestContext(): ServerRequest | undefined;
+  /**
+   * Create a new audit log entry.
+   * Automatically populates ipAddress, userAgent, and requestId from the current request context.
+   */
+  create(data: CreateAudit): Promise<AuditEntity>;
+  /**
+   * Record an audit event (convenience method).
+   */
+  record(type: string, action: string, options?: Omit<CreateAudit, "type" | "action">): Promise<AuditEntity>;
+  /**
+   * Record an authentication event.
+   */
+  recordAuth(action: "login" | "logout" | "login_failed" | "token_refresh" | "mfa_setup" | "mfa_verify", options?: Omit<CreateAudit, "type" | "action">): Promise<AuditEntity>;
+  /**
+   * Record a user management event.
+   */
+  recordUser(action: "create" | "update" | "delete" | "enable" | "disable" | "role_change", options?: Omit<CreateAudit, "type" | "action">): Promise<AuditEntity>;
+  /**
+   * Record a data access event.
+   */
+  recordAccess(action: "view" | "export" | "download", options?: Omit<CreateAudit, "type" | "action">): Promise<AuditEntity>;
+  /**
+   * Record a security event.
+   */
+  recordSecurity(action: "permission_denied" | "suspicious_activity" | "rate_limited" | "blocked", options?: Omit<CreateAudit, "type" | "action">): Promise<AuditEntity>;
+  /**
+   * Record a system event.
+   */
+  recordSystem(action: "startup" | "shutdown" | "config_change" | "maintenance" | "error", options?: Omit<CreateAudit, "type" | "action">): Promise<AuditEntity>;
+  /**
+   * Find audit entries with filtering and pagination.
+   */
+  find(query?: AuditQuery): Promise<Page<AuditEntity>>;
+  /**
+   * Get audit entry by ID.
+   */
+  getById(id: string): Promise<AuditEntity>;
+  /**
+   * Get audit entries for a specific user.
+   */
+  findByUser(userId: string, query?: Omit<AuditQuery, "userId">): Promise<Page<AuditEntity>>;
+  /**
+   * Get audit entries for a specific resource.
+   */
+  findByResource(resourceType: string, resourceId: string, query?: Omit<AuditQuery, "resourceType" | "resourceId">): Promise<Page<AuditEntity>>;
+  /**
+   * Get audit statistics for a time period.
+   */
+  getStats(options?: {
+    from?: Date;
+    to?: Date;
+    userRealm?: string;
+  }): Promise<AuditStats>;
+  /**
+   * Delete old audit entries (for retention policy).
+   */
+  deleteOlderThan(date: Date): Promise<number>;
+}
+/**
+ * Audit statistics summary.
+ */
+interface AuditStats {
+  total: number;
+  byType: Record<string, number>;
+  bySeverity: Record<AuditSeverity, number>;
+  successRate: number;
+  recentFailures: AuditEntity[];
+}
+//#endregion
+//#region ../../src/api-audits/controllers/AuditController.d.ts
+/**
+ * REST API controller for audit log management.
+ *
+ * Provides endpoints for:
+ * - Querying audit logs with filtering
+ * - Creating audit entries
+ * - Getting audit statistics
+ * - Viewing registered audit types
+ */
+declare class AuditController {
+  protected readonly url = "/audits";
+  protected readonly group = "audits";
+  protected readonly auditService: AuditService;
+  /**
+   * Find audit entries with filtering and pagination.
+   */
+  readonly findAudits: alepha_server0.ActionPrimitiveFn<{
+    query: alepha349.TObject<{
+      page: alepha349.TOptional<alepha349.TInteger>;
+      size: alepha349.TOptional<alepha349.TInteger>;
+      sort: alepha349.TOptional<alepha349.TString>;
+      type: alepha349.TOptional<alepha349.TString>;
+      action: alepha349.TOptional<alepha349.TString>;
+      severity: alepha349.TOptional<alepha349.TUnsafe<"info" | "warning" | "critical">>;
+      userId: alepha349.TOptional<alepha349.TString>;
+      userRealm: alepha349.TOptional<alepha349.TString>;
+      resourceType: alepha349.TOptional<alepha349.TString>;
+      resourceId: alepha349.TOptional<alepha349.TString>;
+      success: alepha349.TOptional<alepha349.TBoolean>;
+      from: alepha349.TOptional<alepha349.TString>;
+      to: alepha349.TOptional<alepha349.TString>;
+      search: alepha349.TOptional<alepha349.TString>;
+    }>;
+    response: alepha349.TPage<alepha349.TObject<{
+      id: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_PRIMARY_KEY>, typeof alepha_orm71.PG_DEFAULT>;
+      createdAt: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_CREATED_AT>, typeof alepha_orm71.PG_DEFAULT>;
+      type: alepha349.TString;
+      action: alepha349.TString;
+      severity: alepha_orm71.PgAttr<alepha349.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm71.PG_DEFAULT>;
+      userId: alepha349.TOptional<alepha349.TString>;
+      userRealm: alepha349.TOptional<alepha349.TString>;
+      userEmail: alepha349.TOptional<alepha349.TString>;
+      resourceType: alepha349.TOptional<alepha349.TString>;
+      resourceId: alepha349.TOptional<alepha349.TString>;
+      description: alepha349.TOptional<alepha349.TString>;
+      metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+      ipAddress: alepha349.TOptional<alepha349.TString>;
+      userAgent: alepha349.TOptional<alepha349.TString>;
+      sessionId: alepha349.TOptional<alepha349.TString>;
+      requestId: alepha349.TOptional<alepha349.TString>;
+      success: alepha_orm71.PgAttr<alepha349.TBoolean, typeof alepha_orm71.PG_DEFAULT>;
+      errorMessage: alepha349.TOptional<alepha349.TString>;
+    }>>;
+  }>;
+  /**
+   * Get a single audit entry by ID.
+   */
+  readonly getAudit: alepha_server0.ActionPrimitiveFn<{
+    params: alepha349.TObject<{
+      id: alepha349.TString;
+    }>;
+    response: alepha349.TObject<{
+      id: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_PRIMARY_KEY>, typeof alepha_orm71.PG_DEFAULT>;
+      createdAt: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_CREATED_AT>, typeof alepha_orm71.PG_DEFAULT>;
+      type: alepha349.TString;
+      action: alepha349.TString;
+      severity: alepha_orm71.PgAttr<alepha349.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm71.PG_DEFAULT>;
+      userId: alepha349.TOptional<alepha349.TString>;
+      userRealm: alepha349.TOptional<alepha349.TString>;
+      userEmail: alepha349.TOptional<alepha349.TString>;
+      resourceType: alepha349.TOptional<alepha349.TString>;
+      resourceId: alepha349.TOptional<alepha349.TString>;
+      description: alepha349.TOptional<alepha349.TString>;
+      metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+      ipAddress: alepha349.TOptional<alepha349.TString>;
+      userAgent: alepha349.TOptional<alepha349.TString>;
+      sessionId: alepha349.TOptional<alepha349.TString>;
+      requestId: alepha349.TOptional<alepha349.TString>;
+      success: alepha_orm71.PgAttr<alepha349.TBoolean, typeof alepha_orm71.PG_DEFAULT>;
+      errorMessage: alepha349.TOptional<alepha349.TString>;
+    }>;
+  }>;
+  /**
+   * Create a new audit entry.
+   */
+  readonly createAudit: alepha_server0.ActionPrimitiveFn<{
+    body: alepha349.TObject<{
+      type: alepha349.TString;
+      action: alepha349.TString;
+      severity: alepha349.TOptional<alepha349.TUnsafe<"info" | "warning" | "critical">>;
+      userId: alepha349.TOptional<alepha349.TString>;
+      userRealm: alepha349.TOptional<alepha349.TString>;
+      userEmail: alepha349.TOptional<alepha349.TString>;
+      resourceType: alepha349.TOptional<alepha349.TString>;
+      resourceId: alepha349.TOptional<alepha349.TString>;
+      description: alepha349.TOptional<alepha349.TString>;
+      metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+      ipAddress: alepha349.TOptional<alepha349.TString>;
+      userAgent: alepha349.TOptional<alepha349.TString>;
+      sessionId: alepha349.TOptional<alepha349.TString>;
+      requestId: alepha349.TOptional<alepha349.TString>;
+      success: alepha349.TOptional<alepha349.TBoolean>;
+      errorMessage: alepha349.TOptional<alepha349.TString>;
+    }>;
+    response: alepha349.TObject<{
+      id: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_PRIMARY_KEY>, typeof alepha_orm71.PG_DEFAULT>;
+      createdAt: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_CREATED_AT>, typeof alepha_orm71.PG_DEFAULT>;
+      type: alepha349.TString;
+      action: alepha349.TString;
+      severity: alepha_orm71.PgAttr<alepha349.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm71.PG_DEFAULT>;
+      userId: alepha349.TOptional<alepha349.TString>;
+      userRealm: alepha349.TOptional<alepha349.TString>;
+      userEmail: alepha349.TOptional<alepha349.TString>;
+      resourceType: alepha349.TOptional<alepha349.TString>;
+      resourceId: alepha349.TOptional<alepha349.TString>;
+      description: alepha349.TOptional<alepha349.TString>;
+      metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+      ipAddress: alepha349.TOptional<alepha349.TString>;
+      userAgent: alepha349.TOptional<alepha349.TString>;
+      sessionId: alepha349.TOptional<alepha349.TString>;
+      requestId: alepha349.TOptional<alepha349.TString>;
+      success: alepha_orm71.PgAttr<alepha349.TBoolean, typeof alepha_orm71.PG_DEFAULT>;
+      errorMessage: alepha349.TOptional<alepha349.TString>;
+    }>;
+  }>;
+  /**
+   * Get audit entries for a specific user.
+   */
+  readonly findByUser: alepha_server0.ActionPrimitiveFn<{
+    params: alepha349.TObject<{
+      userId: alepha349.TString;
+    }>;
+    query: alepha349.TObject<{
+      page: alepha349.TOptional<alepha349.TInteger>;
+      type: alepha349.TOptional<alepha349.TString>;
+      size: alepha349.TOptional<alepha349.TInteger>;
+      sort: alepha349.TOptional<alepha349.TString>;
+      action: alepha349.TOptional<alepha349.TString>;
+      severity: alepha349.TOptional<alepha349.TUnsafe<"info" | "warning" | "critical">>;
+      userRealm: alepha349.TOptional<alepha349.TString>;
+      resourceType: alepha349.TOptional<alepha349.TString>;
+      resourceId: alepha349.TOptional<alepha349.TString>;
+      success: alepha349.TOptional<alepha349.TBoolean>;
+      from: alepha349.TOptional<alepha349.TString>;
+      to: alepha349.TOptional<alepha349.TString>;
+      search: alepha349.TOptional<alepha349.TString>;
+    }>;
+    response: alepha349.TPage<alepha349.TObject<{
+      id: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_PRIMARY_KEY>, typeof alepha_orm71.PG_DEFAULT>;
+      createdAt: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_CREATED_AT>, typeof alepha_orm71.PG_DEFAULT>;
+      type: alepha349.TString;
+      action: alepha349.TString;
+      severity: alepha_orm71.PgAttr<alepha349.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm71.PG_DEFAULT>;
+      userId: alepha349.TOptional<alepha349.TString>;
+      userRealm: alepha349.TOptional<alepha349.TString>;
+      userEmail: alepha349.TOptional<alepha349.TString>;
+      resourceType: alepha349.TOptional<alepha349.TString>;
+      resourceId: alepha349.TOptional<alepha349.TString>;
+      description: alepha349.TOptional<alepha349.TString>;
+      metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+      ipAddress: alepha349.TOptional<alepha349.TString>;
+      userAgent: alepha349.TOptional<alepha349.TString>;
+      sessionId: alepha349.TOptional<alepha349.TString>;
+      requestId: alepha349.TOptional<alepha349.TString>;
+      success: alepha_orm71.PgAttr<alepha349.TBoolean, typeof alepha_orm71.PG_DEFAULT>;
+      errorMessage: alepha349.TOptional<alepha349.TString>;
+    }>>;
+  }>;
+  /**
+   * Get audit entries for a specific resource.
+   */
+  readonly findByResource: alepha_server0.ActionPrimitiveFn<{
+    params: alepha349.TObject<{
+      resourceType: alepha349.TString;
+      resourceId: alepha349.TString;
+    }>;
+    query: alepha349.TObject<{
+      page: alepha349.TOptional<alepha349.TInteger>;
+      type: alepha349.TOptional<alepha349.TString>;
+      size: alepha349.TOptional<alepha349.TInteger>;
+      sort: alepha349.TOptional<alepha349.TString>;
+      action: alepha349.TOptional<alepha349.TString>;
+      severity: alepha349.TOptional<alepha349.TUnsafe<"info" | "warning" | "critical">>;
+      userId: alepha349.TOptional<alepha349.TString>;
+      userRealm: alepha349.TOptional<alepha349.TString>;
+      success: alepha349.TOptional<alepha349.TBoolean>;
+      from: alepha349.TOptional<alepha349.TString>;
+      to: alepha349.TOptional<alepha349.TString>;
+      search: alepha349.TOptional<alepha349.TString>;
+    }>;
+    response: alepha349.TPage<alepha349.TObject<{
+      id: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_PRIMARY_KEY>, typeof alepha_orm71.PG_DEFAULT>;
+      createdAt: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_CREATED_AT>, typeof alepha_orm71.PG_DEFAULT>;
+      type: alepha349.TString;
+      action: alepha349.TString;
+      severity: alepha_orm71.PgAttr<alepha349.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm71.PG_DEFAULT>;
+      userId: alepha349.TOptional<alepha349.TString>;
+      userRealm: alepha349.TOptional<alepha349.TString>;
+      userEmail: alepha349.TOptional<alepha349.TString>;
+      resourceType: alepha349.TOptional<alepha349.TString>;
+      resourceId: alepha349.TOptional<alepha349.TString>;
+      description: alepha349.TOptional<alepha349.TString>;
+      metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+      ipAddress: alepha349.TOptional<alepha349.TString>;
+      userAgent: alepha349.TOptional<alepha349.TString>;
+      sessionId: alepha349.TOptional<alepha349.TString>;
+      requestId: alepha349.TOptional<alepha349.TString>;
+      success: alepha_orm71.PgAttr<alepha349.TBoolean, typeof alepha_orm71.PG_DEFAULT>;
+      errorMessage: alepha349.TOptional<alepha349.TString>;
+    }>>;
+  }>;
+  /**
+   * Get audit statistics.
+   */
+  readonly getStats: alepha_server0.ActionPrimitiveFn<{
+    query: alepha349.TObject<{
+      from: alepha349.TOptional<alepha349.TString>;
+      to: alepha349.TOptional<alepha349.TString>;
+      userRealm: alepha349.TOptional<alepha349.TString>;
+    }>;
+    response: alepha349.TObject<{
+      total: alepha349.TInteger;
+      byType: alepha349.TRecord<"^.*$", alepha349.TInteger>;
+      bySeverity: alepha349.TObject<{
+        info: alepha349.TInteger;
+        warning: alepha349.TInteger;
+        critical: alepha349.TInteger;
+      }>;
+      successRate: alepha349.TNumber;
+      recentFailures: alepha349.TArray<alepha349.TObject<{
+        id: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_PRIMARY_KEY>, typeof alepha_orm71.PG_DEFAULT>;
+        createdAt: alepha_orm71.PgAttr<alepha_orm71.PgAttr<alepha349.TString, typeof alepha_orm71.PG_CREATED_AT>, typeof alepha_orm71.PG_DEFAULT>;
+        type: alepha349.TString;
+        action: alepha349.TString;
+        severity: alepha_orm71.PgAttr<alepha349.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm71.PG_DEFAULT>;
+        userId: alepha349.TOptional<alepha349.TString>;
+        userRealm: alepha349.TOptional<alepha349.TString>;
+        userEmail: alepha349.TOptional<alepha349.TString>;
+        resourceType: alepha349.TOptional<alepha349.TString>;
+        resourceId: alepha349.TOptional<alepha349.TString>;
+        description: alepha349.TOptional<alepha349.TString>;
+        metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+        ipAddress: alepha349.TOptional<alepha349.TString>;
+        userAgent: alepha349.TOptional<alepha349.TString>;
+        sessionId: alepha349.TOptional<alepha349.TString>;
+        requestId: alepha349.TOptional<alepha349.TString>;
+        success: alepha_orm71.PgAttr<alepha349.TBoolean, typeof alepha_orm71.PG_DEFAULT>;
+        errorMessage: alepha349.TOptional<alepha349.TString>;
+      }>>;
+    }>;
+  }>;
+  /**
+   * Get registered audit types.
+   */
+  readonly getTypes: alepha_server0.ActionPrimitiveFn<{
+    response: alepha349.TArray<alepha349.TObject<{
+      type: alepha349.TString;
+      description: alepha349.TOptional<alepha349.TString>;
+      actions: alepha349.TArray<alepha349.TString>;
+    }>>;
+  }>;
+  /**
+   * Get distinct values for filters.
+   */
+  readonly getFilterOptions: alepha_server0.ActionPrimitiveFn<{
+    response: alepha349.TObject<{
+      types: alepha349.TArray<alepha349.TString>;
+      actions: alepha349.TArray<alepha349.TString>;
+      resourceTypes: alepha349.TArray<alepha349.TString>;
+      userRealms: alepha349.TArray<alepha349.TString>;
+    }>;
+  }>;
+}
+//#endregion
+//#region ../../src/api-audits/primitives/$audit.d.ts
+/**
+ * Options for creating an audit type primitive.
+ */
+interface AuditPrimitiveOptions {
+  /**
+   * Unique audit type identifier (e.g., "auth", "payment", "order").
+   */
+  type: string;
+  /**
+   * Human-readable description of this audit type.
+   */
+  description?: string;
+  /**
+   * List of allowed actions for this audit type.
+   */
+  actions: string[];
+}
+/**
+ * Audit type primitive for registering domain-specific audit events.
+ *
+ * Provides a type-safe way to define and log audit events within a specific domain.
+ *
+ * @example
+ * ```ts
+ * class PaymentAudits {
+ *   audit = $audit({
+ *     type: "payment",
+ *     description: "Payment-related audit events",
+ *     actions: ["create", "refund", "cancel", "dispute"],
+ *   });
+ *
+ *   async logPaymentCreated(paymentId: string, userId: string, amount: number) {
+ *     await this.audit.log("create", {
+ *       userId,
+ *       resourceType: "payment",
+ *       resourceId: paymentId,
+ *       description: `Payment of ${amount} created`,
+ *       metadata: { amount },
+ *     });
+ *   }
+ * }
+ * ```
+ */
+declare class AuditPrimitive extends Primitive<AuditPrimitiveOptions> {
+  protected readonly auditService: AuditService;
+  /**
+   * The audit type identifier.
+   */
+  get type(): string;
+  /**
+   * The audit type description.
+   */
+  get description(): string | undefined;
+  /**
+   * The allowed actions for this audit type.
+   */
+  get actions(): string[];
+  /**
+   * Log an audit event for this type.
+   */
+  log(action: string, options?: AuditLogOptions): Promise<void>;
+  /**
+   * Log a successful audit event.
+   */
+  logSuccess(action: string, options?: Omit<AuditLogOptions, "success">): Promise<void>;
+  /**
+   * Log a failed audit event.
+   */
+  logFailure(action: string, errorMessage: string, options?: Omit<AuditLogOptions, "success" | "errorMessage">): Promise<void>;
+  /**
+   * Called during initialization to register this audit type.
+   */
+  protected onInit(): void;
+}
+/**
+ * Options for logging an audit event.
+ */
+interface AuditLogOptions {
+  severity?: "info" | "warning" | "critical";
+  userId?: string;
+  userRealm?: string;
+  userEmail?: string;
+  resourceType?: string;
+  resourceId?: string;
+  description?: string;
+  metadata?: Record<string, unknown>;
+  ipAddress?: string;
+  userAgent?: string;
+  sessionId?: string;
+  requestId?: string;
+  success?: boolean;
+  errorMessage?: string;
+}
+/**
+ * Create an audit type primitive.
+ *
+ * @example
+ * ```ts
+ * class OrderAudits {
+ *   audit = $audit({
+ *     type: "order",
+ *     description: "Order management events",
+ *     actions: ["create", "update", "cancel", "fulfill", "ship"],
+ *   });
+ * }
+ * ```
+ */
+declare const $audit: {
+  (options: AuditPrimitiveOptions): AuditPrimitive;
+  [KIND]: typeof AuditPrimitive;
+};
+//#endregion
+//#region ../../src/orm/schemas/insertSchema.d.ts
+/**
+ * Transforms a TObject schema for insert operations.
+ * All default properties at the root level are made optional.
+ *
+ * @example
+ * Before: { name: string; age: number(default=0); }
+ * After:  { name: string; age?: number; }
+ */
+type TObjectInsert<T extends TObject> = TObject<{ [K in keyof T["properties"]]: T["properties"][K] extends {
+  [PG_DEFAULT]: any;
+} | {
+  "~optional": true;
+} ? TOptional<T["properties"][K]> : T["properties"][K] }>;
+//#endregion
+//#region ../../src/orm/schemas/updateSchema.d.ts
+/**
+ * Transforms a TObject schema for update operations.
+ * All optional properties at the root level are made nullable (i.e., `T | null`).
+ * This allows an API endpoint to explicitly accept `null` to clear an optional field in the database.
+ *
+ * @example
+ * Before: { name?: string; age: number; }
+ * After:  { name?: string | null; age: number; }
+ */
+type TObjectUpdate<T extends TObject> = TObject<{ [K in keyof T["properties"]]: T["properties"][K] extends TOptional<infer U> ? TOptional<TUnion<[U, TNull]>> : T["properties"][K] }>;
+//#endregion
+//#region ../../src/orm/primitives/$entity.d.ts
+interface EntityPrimitiveOptions<T extends TObject, Keys = keyof Static<T>> {
+  /**
+   * The database table name that will be created for this entity.
+   * If not provided, name will be inferred from the $repository variable name.
+   */
+  name: string;
+  /**
+   * TypeBox schema defining the table structure and column types.
+   */
+  schema: T;
+  /**
+   * Database indexes to create for query optimization.
+   */
+  indexes?: (Keys | {
+    /**
+     * Single column to index.
+     */
+    column: Keys;
+    /**
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
+    unique?: boolean;
+    /**
+     * Custom name for the index. If not provided, generates name automatically.
+     */
+    name?: string;
+  } | {
+    /**
+     * Multiple columns for composite index (order matters for query optimization).
+     */
+    columns: Keys[];
+    /**
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
+    unique?: boolean;
+    /**
+     * Custom name for the index. If not provided, generates name automatically.
+     */
+    name?: string;
+  })[];
+  /**
+   * Foreign key constraints to maintain referential integrity.
+   */
+  foreignKeys?: Array<{
+    /**
+     * Optional name for the foreign key constraint.
+     */
+    name?: string;
+    /**
+     * Local columns that reference the foreign table.
+     */
+    columns: Array<keyof Static<T>>;
+    /**
+     * Referenced columns in the foreign table.
+     * Must be EntityColumn references from other entities.
+     */
+    foreignColumns: Array<() => EntityColumn<any>>;
+  }>;
+  /**
+   * Additional table constraints for data validation.
+   *
+   * Constraints enforce business rules at the database level, providing
+   * an additional layer of data integrity beyond application validation.
+   *
+   * **Constraint Types**:
+   * - **Unique constraints**: Prevent duplicate values across columns
+   * - **Check constraints**: Enforce custom validation rules with SQL expressions
+   *
+   * @example
+   * ```ts
+   * constraints: [
+   *   {
+   *     name: "unique_user_email",
+   *     columns: ["email"],
+   *     unique: true
+   *   },
+   *   {
+   *     name: "valid_age_range",
+   *     columns: ["age"],
+   *     check: sql`age >= 0 AND age <= 150`
+   *   },
+   *   {
+   *     name: "unique_user_username_per_tenant",
+   *     columns: ["tenantId", "username"],
+   *     unique: true
+   *   }
+   * ]
+   * ```
+   */
+  constraints?: Array<{
+    /**
+     * Columns involved in this constraint.
+     */
+    columns: Array<keyof Static<T>>;
+    /**
+     * Optional name for the constraint.
+     */
+    name?: string;
+    /**
+     * Whether this is a unique constraint.
+     */
+    unique?: boolean | {};
+    /**
+     * SQL expression for check constraint validation.
+     */
+    check?: SQL;
+  }>;
+  /**
+   * Advanced Drizzle ORM configuration for complex table setups.
+   */
+  config?: (self: BuildExtraConfigColumns<string, FromSchema<T>, "pg">) => PgTableExtraConfigValue[];
+}
+declare class EntityPrimitive<T extends TObject = TObject> {
+  readonly options: EntityPrimitiveOptions<T>;
+  constructor(options: EntityPrimitiveOptions<T>);
+  alias(alias: string): this;
+  get cols(): EntityColumns<T>;
+  get name(): string;
+  get schema(): T;
+  get insertSchema(): TObjectInsert<T>;
+  get updateSchema(): TObjectUpdate<T>;
+}
+/**
+ * Convert a schema to columns.
+ */
+type FromSchema<T extends TObject> = { [key in keyof T["properties"]]: PgColumnBuilderBase };
+type EntityColumn<T extends TObject> = {
+  name: string;
+  entity: EntityPrimitive<T>;
+};
+type EntityColumns<T extends TObject> = { [key in keyof T["properties"]]: EntityColumn<T> };
+//#endregion
+//#region ../../src/orm/constants/PG_SYMBOLS.d.ts
+declare const PG_DEFAULT: unique symbol;
+declare const PG_PRIMARY_KEY: unique symbol;
+declare const PG_CREATED_AT: unique symbol;
+declare const PG_UPDATED_AT: unique symbol;
+declare const PG_DELETED_AT: unique symbol;
+declare const PG_VERSION: unique symbol;
+declare const PG_IDENTITY: unique symbol;
+declare const PG_ENUM: unique symbol;
+declare const PG_REF: unique symbol;
+/**
+ * @deprecated Use `PG_IDENTITY` instead.
+ */
+declare const PG_SERIAL: unique symbol;
+type PgSymbols = {
+  [PG_DEFAULT]: {};
+  [PG_PRIMARY_KEY]: {};
+  [PG_CREATED_AT]: {};
+  [PG_UPDATED_AT]: {};
+  [PG_DELETED_AT]: {};
+  [PG_VERSION]: {};
+  [PG_IDENTITY]: PgIdentityOptions;
+  [PG_REF]: PgRefOptions;
+  [PG_ENUM]: PgEnumOptions;
+  /**
+   * @deprecated Use `PG_IDENTITY` instead.
+   */
+  [PG_SERIAL]: {};
+};
+type PgSymbolKeys = keyof PgSymbols;
+type PgIdentityOptions = {
+  mode: "always" | "byDefault";
+} & PgSequenceOptions & {
+  name?: string;
+};
+interface PgEnumOptions {
+  name?: string;
+  description?: string;
+}
+interface PgRefOptions {
+  ref: () => {
+    name: string;
+    entity: EntityPrimitive;
+  };
+  actions?: {
+    onUpdate?: UpdateDeleteAction;
+    onDelete?: UpdateDeleteAction;
+  };
+}
+//#endregion
+//#region ../../src/orm/helpers/pgAttr.d.ts
+/**
+ * Type representation.
+ */
+type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & { [K in TAttr]: PgSymbols[K] };
+//#endregion
+//#region ../../src/orm/providers/drivers/NodePostgresProvider.d.ts
+declare module "alepha" {
+  interface Env extends Partial<Static<typeof envSchema>> {}
+}
+declare const envSchema: alepha349.TObject<{
+  /**
+   * Main configuration for database connection.
+   * Accept a string in the format of a Postgres connection URL.
+   * Example: postgres://user:password@localhost:5432/database
+   * or
+   * Example: postgres://user:password@localhost:5432/database?sslmode=require
+   */
+  DATABASE_URL: alepha349.TOptional<alepha349.TString>;
+  /**
+   * In addition to the DATABASE_URL, you can specify the postgres schema name.
+   *
+   * It will monkey patch drizzle tables.
+   */
+  POSTGRES_SCHEMA: alepha349.TOptional<alepha349.TString>;
+}>;
+//#endregion
+//#region ../../src/orm/providers/drivers/NodeSqliteProvider.d.ts
+/**
+ * Configuration options for the Node.js SQLite database provider.
+ */
+declare const nodeSqliteOptions: alepha349.Atom<alepha349.TObject<{
+  path: alepha349.TOptional<alepha349.TString>;
+}>, "alepha.postgres.node-sqlite.options">;
+type NodeSqliteProviderOptions = Static<typeof nodeSqliteOptions.schema>;
+declare module "alepha" {
+  interface State {
+    [nodeSqliteOptions.key]: NodeSqliteProviderOptions;
+  }
+}
+/**
+ * Add a fake support for SQLite in Node.js based on Postgres interfaces.
+ *
+ * This is NOT a real SQLite provider, it's a workaround to use SQLite with Drizzle ORM.
+ * This is NOT recommended for production use.
+ */
+//#endregion
+//#region ../../src/orm/index.d.ts
+declare module "alepha" {
+  interface Hooks {
+    /**
+     * Fires before creating an entity in the repository.
+     */
+    "repository:create:before": {
+      tableName: string;
+      data: any;
+    };
+    /**
+     * Fires after creating an entity in the repository.
+     */
+    "repository:create:after": {
+      tableName: string;
+      data: any;
+      entity: any;
+    };
+    /**
+     * Fires before updating entities in the repository.
+     */
+    "repository:update:before": {
+      tableName: string;
+      where: any;
+      data: any;
+    };
+    /**
+     * Fires after updating entities in the repository.
+     */
+    "repository:update:after": {
+      tableName: string;
+      where: any;
+      data: any;
+      entities: any[];
+    };
+    /**
+     * Fires before deleting entities from the repository.
+     */
+    "repository:delete:before": {
+      tableName: string;
+      where: any;
+    };
+    /**
+     * Fires after deleting entities from the repository.
+     */
+    "repository:delete:after": {
+      tableName: string;
+      where: any;
+      ids: Array<string | number>;
+    };
+    /**
+     * Fires before reading entities from the repository.
+     */
+    "repository:read:before": {
+      tableName: string;
+      query: any;
+    };
+    /**
+     * Fires after reading entities from the repository.
+     */
+    "repository:read:after": {
+      tableName: string;
+      query: any;
+      entities: any[];
+    };
+  }
+}
+//#endregion
+//#region ../../src/api-audits/schemas/auditResourceSchema.d.ts
+/**
+ * Resource schema for audit log responses.
+ */
+declare const auditResourceSchema: alepha349.TObject<{
+  id: PgAttr<PgAttr<alepha349.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+  createdAt: PgAttr<PgAttr<alepha349.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+  type: alepha349.TString;
+  action: alepha349.TString;
+  severity: PgAttr<alepha349.TUnsafe<"info" | "warning" | "critical">, typeof PG_DEFAULT>;
+  userId: alepha349.TOptional<alepha349.TString>;
+  userRealm: alepha349.TOptional<alepha349.TString>;
+  userEmail: alepha349.TOptional<alepha349.TString>;
+  resourceType: alepha349.TOptional<alepha349.TString>;
+  resourceId: alepha349.TOptional<alepha349.TString>;
+  description: alepha349.TOptional<alepha349.TString>;
+  metadata: alepha349.TOptional<alepha349.TRecord<string, alepha349.TAny>>;
+  ipAddress: alepha349.TOptional<alepha349.TString>;
+  userAgent: alepha349.TOptional<alepha349.TString>;
+  sessionId: alepha349.TOptional<alepha349.TString>;
+  requestId: alepha349.TOptional<alepha349.TString>;
+  success: PgAttr<alepha349.TBoolean, typeof PG_DEFAULT>;
+  errorMessage: alepha349.TOptional<alepha349.TString>;
+}>;
+type AuditResource = Static<typeof auditResourceSchema>;
+//#endregion
+//#region ../../src/api-audits/index.d.ts
+/**
+ * Provides audit logging API endpoints for Alepha applications.
+ *
+ * This module includes:
+ * - Audit log CRUD operations
+ * - Filtering and searching audit events
+ * - Audit statistics and analytics
+ * - `$audit` primitive for domain-specific audit types
+ *
+ * @module alepha.api.audits
+ *
+ * @example
+ * ```ts
+ * // In your app module
+ * import { AlephaApiAudits } from "alepha/api/audits";
+ *
+ * const App = $module({
+ *   name: "app",
+ *   services: [AlephaApiAudits, ...],
+ * });
+ *
+ * // Create domain-specific audit types
+ * class PaymentAudits {
+ *   audit = $audit({
+ *     type: "payment",
+ *     actions: ["create", "refund", "cancel"],
+ *   });
+ *
+ *   async onPaymentCreated(paymentId: string, userId: string) {
+ *     await this.audit.log("create", {
+ *       userId,
+ *       resourceType: "payment",
+ *       resourceId: paymentId,
+ *     });
+ *   }
+ * }
+ * ```
+ */
+declare const AlephaApiAudits: alepha349.Service<alepha349.Module>;
+//#endregion
+export { $audit, AlephaApiAudits, AuditController, AuditEntity, AuditLogOptions, AuditPrimitive, AuditPrimitiveOptions, AuditQuery, AuditResource, AuditService, AuditSeverity, AuditStats, AuditTypeDefinition, CreateAudit, auditEntityInsertSchema, auditEntitySchema, auditQuerySchema, auditResourceSchema, auditSeveritySchema, audits, createAuditSchema };
+//# sourceMappingURL=index.d.ts.map