alepha 0.15.0 → 0.15.1

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

@@ -42,114 +42,114 @@ type TObjectUpdate<T extends TObject> = TObject<{ [K in keyof T["properties"]]:
 //#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.
-       */
+   * 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.
-       */
+   * TypeBox schema defining the table structure and column types.
+   */
   schema: T;
   /**
-       * Database indexes to create for query optimization.
-       */
+   * Database indexes to create for query optimization.
+   */
   indexes?: (Keys | {
     /**
-             * Single column to index.
-             */
+     * Single column to index.
+     */
     column: Keys;
     /**
-             * Whether this should be a unique index (enforces uniqueness constraint).
-             */
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
     unique?: boolean;
     /**
-             * Custom name for the index. If not provided, generates name automatically.
-             */
+     * Custom name for the index. If not provided, generates name automatically.
+     */
     name?: string;
   } | {
     /**
-             * Multiple columns for composite index (order matters for query optimization).
-             */
+     * Multiple columns for composite index (order matters for query optimization).
+     */
     columns: Keys[];
     /**
-             * Whether this should be a unique index (enforces uniqueness constraint).
-             */
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
     unique?: boolean;
     /**
-             * Custom name for the index. If not provided, generates name automatically.
-             */
+     * Custom name for the index. If not provided, generates name automatically.
+     */
     name?: string;
   })[];
   /**
-       * Foreign key constraints to maintain referential integrity.
-       */
+   * Foreign key constraints to maintain referential integrity.
+   */
   foreignKeys?: Array<{
     /**
-             * Optional name for the foreign key constraint.
-             */
+     * Optional name for the foreign key constraint.
+     */
     name?: string;
     /**
-             * Local columns that reference the foreign table.
-             */
+     * 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.
-             */
+     * 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
-       *   }
-       * ]
-       * ```
-       */
+   * 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 involved in this constraint.
+     */
     columns: Array<keyof Static<T>>;
     /**
-             * Optional name for the constraint.
-             */
+     * Optional name for the constraint.
+     */
     name?: string;
     /**
-             * Whether this is a unique constraint.
-             */
+     * Whether this is a unique constraint.
+     */
     unique?: boolean | {};
     /**
-             * SQL expression for check constraint validation.
-             */
+     * SQL expression for check constraint validation.
+     */
     check?: SQL;
   }>;
   /**
-       * Advanced Drizzle ORM configuration for complex table setups.
-       */
+   * Advanced Drizzle ORM configuration for complex table setups.
+   */
   config?: (self: BuildExtraConfigColumns<string, FromSchema<T>, "pg">) => PgTableExtraConfigValue[];
 }
 declare class EntityPrimitive<T extends TObject = TObject> {
@@ -197,8 +197,8 @@ type PgSymbols = {
   [PG_REF]: PgRefOptions;
   [PG_ENUM]: PgEnumOptions;
   /**
-       * @deprecated Use `PG_IDENTITY` instead.
-       */
+   * @deprecated Use `PG_IDENTITY` instead.
+   */
   [PG_SERIAL]: {};
 };
 type PgSymbolKeys = keyof PgSymbols;
@@ -247,207 +247,207 @@ declare const audits: alepha_orm12.EntityPrimitive<alepha381.TObject<{
   id: alepha_orm12.PgAttr<alepha_orm12.PgAttr<alepha381.TString, typeof alepha_orm12.PG_PRIMARY_KEY>, typeof alepha_orm12.PG_DEFAULT>;
   createdAt: alepha_orm12.PgAttr<alepha_orm12.PgAttr<alepha381.TString, typeof alepha_orm12.PG_CREATED_AT>, typeof alepha_orm12.PG_DEFAULT>;
   /**
-       * Audit event type (e.g., "auth", "user", "payment", "system").
-       * Used for categorizing and filtering audit events.
-       */
+   * Audit event type (e.g., "auth", "user", "payment", "system").
+   * Used for categorizing and filtering audit events.
+   */
   type: alepha381.TString;
   /**
-       * Specific action performed (e.g., "login", "logout", "create", "update", "delete").
-       */
+   * Specific action performed (e.g., "login", "logout", "create", "update", "delete").
+   */
   action: alepha381.TString;
   /**
-       * Severity level of the event.
-       */
+   * Severity level of the event.
+   */
   severity: alepha_orm12.PgAttr<alepha381.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm12.PG_DEFAULT>;
   /**
-       * User ID who performed the action (null for system events).
-       */
+   * User ID who performed the action (null for system events).
+   */
   userId: alepha381.TOptional<alepha381.TString>;
   /**
-       * User realm for multi-tenant support.
-       */
+   * User realm for multi-tenant support.
+   */
   userRealm: alepha381.TOptional<alepha381.TString>;
   /**
-       * User email at the time of the event (denormalized for history).
-       */
+   * User email at the time of the event (denormalized for history).
+   */
   userEmail: alepha381.TOptional<alepha381.TString>;
   /**
-       * Resource type affected (e.g., "user", "order", "file").
-       */
+   * Resource type affected (e.g., "user", "order", "file").
+   */
   resourceType: alepha381.TOptional<alepha381.TString>;
   /**
-       * Resource ID affected.
-       */
+   * Resource ID affected.
+   */
   resourceId: alepha381.TOptional<alepha381.TString>;
   /**
-       * Human-readable description of the event.
-       */
+   * Human-readable description of the event.
+   */
   description: alepha381.TOptional<alepha381.TString>;
   /**
-       * Additional metadata/context as JSON.
-       */
+   * Additional metadata/context as JSON.
+   */
   metadata: alepha381.TOptional<alepha381.TRecord<string, alepha381.TAny>>;
   /**
-       * Client IP address.
-       */
+   * Client IP address.
+   */
   ipAddress: alepha381.TOptional<alepha381.TString>;
   /**
-       * Client user agent.
-       */
+   * Client user agent.
+   */
   userAgent: alepha381.TOptional<alepha381.TString>;
   /**
-       * Session ID if applicable.
-       */
+   * Session ID if applicable.
+   */
   sessionId: alepha381.TOptional<alepha381.TString>;
   /**
-       * Request ID for correlation.
-       */
+   * Request ID for correlation.
+   */
   requestId: alepha381.TOptional<alepha381.TString>;
   /**
-       * Whether the action was successful.
-       */
+   * Whether the action was successful.
+   */
   success: alepha_orm12.PgAttr<alepha381.TBoolean, typeof alepha_orm12.PG_DEFAULT>;
   /**
-       * Error message if the action failed.
-       */
+   * Error message if the action failed.
+   */
   errorMessage: alepha381.TOptional<alepha381.TString>;
 }>>;
 declare const auditEntitySchema: alepha381.TObject<{
   id: alepha_orm12.PgAttr<alepha_orm12.PgAttr<alepha381.TString, typeof alepha_orm12.PG_PRIMARY_KEY>, typeof alepha_orm12.PG_DEFAULT>;
   createdAt: alepha_orm12.PgAttr<alepha_orm12.PgAttr<alepha381.TString, typeof alepha_orm12.PG_CREATED_AT>, typeof alepha_orm12.PG_DEFAULT>;
   /**
-       * Audit event type (e.g., "auth", "user", "payment", "system").
-       * Used for categorizing and filtering audit events.
-       */
+   * Audit event type (e.g., "auth", "user", "payment", "system").
+   * Used for categorizing and filtering audit events.
+   */
   type: alepha381.TString;
   /**
-       * Specific action performed (e.g., "login", "logout", "create", "update", "delete").
-       */
+   * Specific action performed (e.g., "login", "logout", "create", "update", "delete").
+   */
   action: alepha381.TString;
   /**
-       * Severity level of the event.
-       */
+   * Severity level of the event.
+   */
   severity: alepha_orm12.PgAttr<alepha381.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm12.PG_DEFAULT>;
   /**
-       * User ID who performed the action (null for system events).
-       */
+   * User ID who performed the action (null for system events).
+   */
   userId: alepha381.TOptional<alepha381.TString>;
   /**
-       * User realm for multi-tenant support.
-       */
+   * User realm for multi-tenant support.
+   */
   userRealm: alepha381.TOptional<alepha381.TString>;
   /**
-       * User email at the time of the event (denormalized for history).
-       */
+   * User email at the time of the event (denormalized for history).
+   */
   userEmail: alepha381.TOptional<alepha381.TString>;
   /**
-       * Resource type affected (e.g., "user", "order", "file").
-       */
+   * Resource type affected (e.g., "user", "order", "file").
+   */
   resourceType: alepha381.TOptional<alepha381.TString>;
   /**
-       * Resource ID affected.
-       */
+   * Resource ID affected.
+   */
   resourceId: alepha381.TOptional<alepha381.TString>;
   /**
-       * Human-readable description of the event.
-       */
+   * Human-readable description of the event.
+   */
   description: alepha381.TOptional<alepha381.TString>;
   /**
-       * Additional metadata/context as JSON.
-       */
+   * Additional metadata/context as JSON.
+   */
   metadata: alepha381.TOptional<alepha381.TRecord<string, alepha381.TAny>>;
   /**
-       * Client IP address.
-       */
+   * Client IP address.
+   */
   ipAddress: alepha381.TOptional<alepha381.TString>;
   /**
-       * Client user agent.
-       */
+   * Client user agent.
+   */
   userAgent: alepha381.TOptional<alepha381.TString>;
   /**
-       * Session ID if applicable.
-       */
+   * Session ID if applicable.
+   */
   sessionId: alepha381.TOptional<alepha381.TString>;
   /**
-       * Request ID for correlation.
-       */
+   * Request ID for correlation.
+   */
   requestId: alepha381.TOptional<alepha381.TString>;
   /**
-       * Whether the action was successful.
-       */
+   * Whether the action was successful.
+   */
   success: alepha_orm12.PgAttr<alepha381.TBoolean, typeof alepha_orm12.PG_DEFAULT>;
   /**
-       * Error message if the action failed.
-       */
+   * Error message if the action failed.
+   */
   errorMessage: alepha381.TOptional<alepha381.TString>;
 }>;
 declare const auditEntityInsertSchema: alepha_orm12.TObjectInsert<alepha381.TObject<{
   id: alepha_orm12.PgAttr<alepha_orm12.PgAttr<alepha381.TString, typeof alepha_orm12.PG_PRIMARY_KEY>, typeof alepha_orm12.PG_DEFAULT>;
   createdAt: alepha_orm12.PgAttr<alepha_orm12.PgAttr<alepha381.TString, typeof alepha_orm12.PG_CREATED_AT>, typeof alepha_orm12.PG_DEFAULT>;
   /**
-       * Audit event type (e.g., "auth", "user", "payment", "system").
-       * Used for categorizing and filtering audit events.
-       */
+   * Audit event type (e.g., "auth", "user", "payment", "system").
+   * Used for categorizing and filtering audit events.
+   */
   type: alepha381.TString;
   /**
-       * Specific action performed (e.g., "login", "logout", "create", "update", "delete").
-       */
+   * Specific action performed (e.g., "login", "logout", "create", "update", "delete").
+   */
   action: alepha381.TString;
   /**
-       * Severity level of the event.
-       */
+   * Severity level of the event.
+   */
   severity: alepha_orm12.PgAttr<alepha381.TUnsafe<"info" | "warning" | "critical">, typeof alepha_orm12.PG_DEFAULT>;
   /**
-       * User ID who performed the action (null for system events).
-       */
+   * User ID who performed the action (null for system events).
+   */
   userId: alepha381.TOptional<alepha381.TString>;
   /**
-       * User realm for multi-tenant support.
-       */
+   * User realm for multi-tenant support.
+   */
   userRealm: alepha381.TOptional<alepha381.TString>;
   /**
-       * User email at the time of the event (denormalized for history).
-       */
+   * User email at the time of the event (denormalized for history).
+   */
   userEmail: alepha381.TOptional<alepha381.TString>;
   /**
-       * Resource type affected (e.g., "user", "order", "file").
-       */
+   * Resource type affected (e.g., "user", "order", "file").
+   */
   resourceType: alepha381.TOptional<alepha381.TString>;
   /**
-       * Resource ID affected.
-       */
+   * Resource ID affected.
+   */
   resourceId: alepha381.TOptional<alepha381.TString>;
   /**
-       * Human-readable description of the event.
-       */
+   * Human-readable description of the event.
+   */
   description: alepha381.TOptional<alepha381.TString>;
   /**
-       * Additional metadata/context as JSON.
-       */
+   * Additional metadata/context as JSON.
+   */
   metadata: alepha381.TOptional<alepha381.TRecord<string, alepha381.TAny>>;
   /**
-       * Client IP address.
-       */
+   * Client IP address.
+   */
   ipAddress: alepha381.TOptional<alepha381.TString>;
   /**
-       * Client user agent.
-       */
+   * Client user agent.
+   */
   userAgent: alepha381.TOptional<alepha381.TString>;
   /**
-       * Session ID if applicable.
-       */
+   * Session ID if applicable.
+   */
   sessionId: alepha381.TOptional<alepha381.TString>;
   /**
-       * Request ID for correlation.
-       */
+   * Request ID for correlation.
+   */
   requestId: alepha381.TOptional<alepha381.TString>;
   /**
-       * Whether the action was successful.
-       */
+   * Whether the action was successful.
+   */
   success: alepha_orm12.PgAttr<alepha381.TBoolean, typeof alepha_orm12.PG_DEFAULT>;
   /**
-       * Error message if the action failed.
-       */
+   * Error message if the action failed.
+   */
   errorMessage: alepha381.TOptional<alepha381.TString>;
 }>>;
 type AuditEntity = Static<typeof audits.schema>;
@@ -540,77 +540,77 @@ declare class AuditService {
     errorMessage: alepha381.TOptional<alepha381.TString>;
   }>>;
   /**
-       * Registry of audit types and their allowed actions.
-       */
+   * Registry of audit types and their allowed actions.
+   */
   protected readonly auditTypes: Map<string, AuditTypeDefinition>;
   /**
-       * Register an audit type with its allowed actions.
-       */
+   * Register an audit type with its allowed actions.
+   */
   registerType(definition: AuditTypeDefinition): void;
   /**
-       * Get all registered audit types.
-       */
+   * Get all registered audit types.
+   */
   getRegisteredTypes(): AuditTypeDefinition[];
   /**
-       * Get current request context if available.
-       */
+   * 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 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 an audit event (convenience method).
+   */
   record(type: string, action: string, options?: Omit<CreateAudit, "type" | "action">): Promise<AuditEntity>;
   /**
-       * Record an authentication event.
-       */
+   * 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.
-       */
+   * 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.
-       */
+   * Record a data access event.
+   */
   recordAccess(action: "view" | "export" | "download", options?: Omit<CreateAudit, "type" | "action">): Promise<AuditEntity>;
   /**
-       * Record a security event.
-       */
+   * Record a security event.
+   */
   recordSecurity(action: "permission_denied" | "suspicious_activity" | "rate_limited" | "blocked", options?: Omit<CreateAudit, "type" | "action">): Promise<AuditEntity>;
   /**
-       * Record a system event.
-       */
+   * 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 audit entries with filtering and pagination.
+   */
   find(query?: AuditQuery): Promise<Page<AuditEntity>>;
   /**
-       * Get audit entry by ID.
-       */
+   * Get audit entry by ID.
+   */
   getById(id: string): Promise<AuditEntity>;
   /**
-       * Get audit entries for a specific user.
-       */
+   * Get audit entries for a specific user.
+   */
   findByUser(userId: string, query?: Omit<AuditQuery, "userId">): Promise<Page<AuditEntity>>;
   /**
-       * Get audit entries for a specific resource.
-       */
+   * 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.
-       */
+   * Get audit statistics for a time period.
+   */
   getStats(options?: {
     from?: Date;
     to?: Date;
     userRealm?: string;
   }): Promise<AuditStats>;
   /**
-       * Delete old audit entries (for retention policy).
-       */
+   * Delete old audit entries (for retention policy).
+   */
   deleteOlderThan(date: Date): Promise<number>;
 }
 /**
@@ -639,8 +639,8 @@ declare class AdminAuditController {
   protected readonly group = "admin:audits";
   protected readonly auditService: AuditService;
   /**
-       * Find audit entries with filtering and pagination.
-       */
+   * Find audit entries with filtering and pagination.
+   */
   readonly findAudits: alepha_server0.ActionPrimitiveFn<{
     query: alepha381.TObject<{
       page: alepha381.TOptional<alepha381.TInteger>;
@@ -680,8 +680,8 @@ declare class AdminAuditController {
     }>>;
   }>;
   /**
-       * Get a single audit entry by ID.
-       */
+   * Get a single audit entry by ID.
+   */
   readonly getAudit: alepha_server0.ActionPrimitiveFn<{
     params: alepha381.TObject<{
       id: alepha381.TString;
@@ -708,8 +708,8 @@ declare class AdminAuditController {
     }>;
   }>;
   /**
-       * Create a new audit entry.
-       */
+   * Create a new audit entry.
+   */
   readonly createAudit: alepha_server0.ActionPrimitiveFn<{
     body: alepha381.TObject<{
       type: alepha381.TString;
@@ -751,8 +751,8 @@ declare class AdminAuditController {
     }>;
   }>;
   /**
-       * Get audit entries for a specific user.
-       */
+   * Get audit entries for a specific user.
+   */
   readonly findByUser: alepha_server0.ActionPrimitiveFn<{
     params: alepha381.TObject<{
       userId: alepha381.TString;
@@ -794,8 +794,8 @@ declare class AdminAuditController {
     }>>;
   }>;
   /**
-       * Get audit entries for a specific resource.
-       */
+   * Get audit entries for a specific resource.
+   */
   readonly findByResource: alepha_server0.ActionPrimitiveFn<{
     params: alepha381.TObject<{
       resourceType: alepha381.TString;
@@ -837,8 +837,8 @@ declare class AdminAuditController {
     }>>;
   }>;
   /**
-       * Get audit statistics.
-       */
+   * Get audit statistics.
+   */
   readonly getStats: alepha_server0.ActionPrimitiveFn<{
     query: alepha381.TObject<{
       from: alepha381.TOptional<alepha381.TString>;
@@ -877,8 +877,8 @@ declare class AdminAuditController {
     }>;
   }>;
   /**
-       * Get registered audit types.
-       */
+   * Get registered audit types.
+   */
   readonly getTypes: alepha_server0.ActionPrimitiveFn<{
     response: alepha381.TArray<alepha381.TObject<{
       type: alepha381.TString;
@@ -887,8 +887,8 @@ declare class AdminAuditController {
     }>>;
   }>;
   /**
-       * Get distinct values for filters.
-       */
+   * Get distinct values for filters.
+   */
   readonly getFilterOptions: alepha_server0.ActionPrimitiveFn<{
     response: alepha381.TObject<{
       types: alepha381.TArray<alepha381.TString>;
@@ -905,16 +905,16 @@ declare class AdminAuditController {
  */
 interface AuditPrimitiveOptions {
   /**
-       * Unique audit type identifier (e.g., "auth", "payment", "order").
-       */
+   * Unique audit type identifier (e.g., "auth", "payment", "order").
+   */
   type: string;
   /**
-       * Human-readable description of this audit type.
-       */
+   * Human-readable description of this audit type.
+   */
   description?: string;
   /**
-       * List of allowed actions for this audit type.
-       */
+   * List of allowed actions for this audit type.
+   */
   actions: string[];
 }
 /**
@@ -946,32 +946,32 @@ interface AuditPrimitiveOptions {
 declare class AuditPrimitive extends Primitive<AuditPrimitiveOptions> {
   protected readonly auditService: AuditService;
   /**
-       * The audit type identifier.
-       */
+   * The audit type identifier.
+   */
   get type(): string;
   /**
-       * The audit type description.
-       */
+   * The audit type description.
+   */
   get description(): string | undefined;
   /**
-       * The allowed actions for this audit type.
-       */
+   * The allowed actions for this audit type.
+   */
   get actions(): string[];
   /**
-       * Log an audit event for this type.
-       */
+   * Log an audit event for this type.
+   */
   log(action: string, options?: AuditLogOptions): Promise<void>;
   /**
-       * Log a successful audit event.
-       */
+   * Log a successful audit event.
+   */
   logSuccess(action: string, options?: Omit<AuditLogOptions, "success">): Promise<void>;
   /**
-       * Log a failed audit event.
-       */
+   * 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.
-       */
+   * Called during initialization to register this audit type.
+   */
   protected onInit(): void;
 }
 /**