alepha 0.15.1 → 0.15.3

package/README.md

@@ -1,116 +1,104 @@
 <div align="center">
-<h1 >
+<h1>
 <img
-	src="https://raw.githubusercontent.com/feunard/alepha/main/apps/docs/public/icon-512.png"
-	width="128"
-	height="128"
-	alt="Logo"
+  src="https://raw.githubusercontent.com/feunard/alepha/main/apps/docs/public/icon-512.png"
+  width="128"
+  height="128"
+  alt="Alepha logo"
   valign="middle"
 />
 Alepha
 </h1>
-<p style="max-width: 512px">
-Easy mode for building TypeScript applications.
-</p>
-<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/v/alepha.svg" alt="npm"/></a>
-<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/l/alepha.svg" alt="npm"/></a>
-<a href="https://codecov.io/gh/feunard/alepha"><img src="https://codecov.io/gh/feunard/alepha/graph/badge.svg?token=ZDLWI514CP" alt="npm"/></a>
-<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/dt/alepha.svg" alt="npm"/></a>
-<a href="https://github.com/feunard/alepha"><img src="https://img.shields.io/github/stars/feunard/alepha.svg?style=social" alt="GitHub stars"/></a>
+<p>TypeScript Framework Made Easy</p>
+<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/v/alepha.svg" alt="npm version"/></a>
+<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/l/alepha.svg" alt="license"/></a>
+<a href="https://codecov.io/gh/feunard/alepha"><img src="https://codecov.io/gh/feunard/alepha/graph/badge.svg?token=ZDLWI514CP" alt="coverage"/></a>
+<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/dt/alepha.svg" alt="downloads"/></a>
 </div>
 
 ## What is this?
 
-A full-stack TypeScript framework for building APIs, React apps with SSR, CLI tools, and more.
+Full-stack TypeScript framework. Node.js and Bun, same code.
 
-- **Runs on Node.js and Bun** — switch runtimes without changing code
-- **Zero config** — sensible defaults, override when needed
-- **Type-safe everything** — schemas validate at runtime, TypeScript catches the rest
-- **Single bundle deploy** — no `node_modules` in production
+You define your API with `$action`, your DB with `$entity`, jobs with `$queue`.
+One schema handles database, validation, and TypeScript types.
+The client gets full autocomplete without codegen.
+Testing? Swap services with `.with()`, no mocking.
+Deploy anywhere — Cloudflare, Vercel, Docker, bare metal.
 
-Check out the [documentation](https://alepha.dev) for the full picture.
+## Example
 
-## Quick Start
-
-**Requirements:** [Node.js](https://nodejs.org/) v22+ or [Bun](https://bun.sh/)
-
-### API Server
-
-```bash
-npx alepha init my-api
-cd my-api
-```
-
-Edit `src/api/controllers/HelloController.ts`:
-
-```ts
+```tsx
+// src/Api.ts
 import { t } from "alepha";
 import { $action } from "alepha/server";
-import { $swagger } from "alepha/server/swagger";
-
-export class HelloController {
-  docs = $swagger();
-
-  hello = $action({
-    path: "/hello",
-    schema: {
-      query: t.object({
-        name: t.optional(t.text()),
-      }),
-      response: t.object({
-        message: t.text(),
-      }),
+import { $entity, $repository, db } from "alepha/orm";
+
+const viewEntity = $entity({
+  name: "views",
+  schema: t.object({
+    id: db.primaryKey(),
+    createdAt: db.createdAt(),
+  }),
+});
+
+export class Api {
+  views = $repository(viewEntity);
+
+  inc = $action({
+    schema: { response: t.object({ count: t.number() }) },  // ← validates + generates OpenAPI
+    handler: async () => {
+      await this.views.create({});
+      return { count: await this.views.count() };
     },
-    handler: ({ query }) => ({
-      message: `Hello, ${query.name || "World"}!`,
-    }),
   });
 }
 ```
 
-```bash
-npm run dev
-# Open http://localhost:3000/docs/ for auto-generated API docs
-```
+```tsx
+// src/AppRouter.tsx
+import { $client } from "alepha/server/links";
+import { $page } from "alepha/react/router";
+import type { Api } from "./Api.ts";
 
-Build and run in production:
+export class AppRouter {
+  api = $client<Api>();  // ← fully typed, zero codegen
 
-```bash
-npm run build
-node dist  # or: bun dist
+  home = $page({
+    loader: () => this.api.inc(),
+    component: (props) => <div>Counter: {props.count}</div>,
+  });
+}
 ```
 
-### Full-Stack React
+## Getting Started
 
-In same directory, re-initialize with React support:
+Requirements: [Node.js](https://nodejs.org/) 22+ or [Bun](https://bun.sh/) 1.3+
 
 ```bash
-npx alepha init --react
-```
-
-Your `src/main.server.ts` wires everything together:
-
-```ts
-import { Alepha, run } from "alepha";
-import { ApiModule } from "./api/index.ts";
-import { WebModule } from "./web/index.ts";
-
-const alepha = Alepha.create();
-
-alepha.with(ApiModule);  // API endpoints
-alepha.with(WebModule);  // React pages
+npx alepha init my-app --api         # API only
+npx alepha init my-app --react       # With React
+npx alepha init my-app --admin       # Full SaaS starter
+npx alepha init my-app --admin --ai  # + AI assistant context
 
-run(alepha);
+cd my-app && npm run dev
 ```
 
-Start development server:
+## CLI
 
 ```bash
-npm run dev
-# Open http://localhost:3000/
+alepha dev          # Dev server with HMR
+alepha lint         # Format & lint code
+alepha typecheck    # TypeScript check
+alepha test         # Run tests
+alepha build        # Production build
+alepha db generate  # Generate migrations
+alepha db migrate   # Apply migrations
+alepha db studio    # Visual database browser
 ```
 
 ## Learn More
 
-- [Documentation](https://alepha.dev) — guides, concepts, API reference
-- [GitHub](https://github.com/feunard/alepha) — source code and issues
+- [Documentation](https://alepha.dev)
+- [llms.txt](https://alepha.dev/llms.txt) — for AI assistants
+- [GitHub](https://github.com/feunard/alepha)

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

@@ -1040,42 +1040,19 @@ type AuditResource = Static<typeof auditResourceSchema>;
 //#endregion
 //#region ../../src/api/audits/index.d.ts
 /**
- * Provides audit logging API endpoints for Alepha applications.
+ * | type | quality | stability |
+ * |------|---------|-----------|
+ * | backend | standard | stable |
  *
- * This module includes:
- * - Audit log CRUD operations
- * - Filtering and searching audit events
- * - Audit statistics and analytics
- * - `$audit` primitive for domain-specific audit types
+ * Audit trail for compliance.
  *
- * @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"],
- *   });
+ * **Features:**
+ * - Domain-specific audit types
+ * - Audit event logging
+ * - Filtering and searching
+ * - User action tracking
  *
- *   async onPaymentCreated(paymentId: string, userId: string) {
- *     await this.audit.log("create", {
- *       userId,
- *       resourceType: "payment",
- *       resourceId: paymentId,
- *     });
- *   }
- * }
- * ```
+ * @module alepha.api.audits
  */
 declare const AlephaApiAudits: alepha381.Service<alepha381.Module>;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/orm/schemas/insertSchema.ts","../../../src/orm/schemas/updateSchema.ts","../../../src/orm/primitives/$entity.ts","../../../src/orm/constants/PG_SYMBOLS.ts","../../../src/orm/helpers/pgAttr.ts","../../../src/api/audits/entities/audits.ts","../../../src/api/audits/schemas/auditQuerySchema.ts","../../../src/api/audits/schemas/createAuditSchema.ts","../../../src/api/audits/services/AuditService.ts","../../../src/api/audits/controllers/AdminAuditController.ts","../../../src/api/audits/primitives/$audit.ts","../../../src/api/audits/schemas/auditResourceSchema.ts","../../../src/api/audits/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/orm/schemas/insertSchema.ts","../../../src/orm/schemas/updateSchema.ts","../../../src/orm/primitives/$entity.ts","../../../src/orm/constants/PG_SYMBOLS.ts","../../../src/orm/helpers/pgAttr.ts","../../../src/api/audits/entities/audits.ts","../../../src/api/audits/schemas/auditQuerySchema.ts","../../../src/api/audits/schemas/createAuditSchema.ts","../../../src/api/audits/services/AuditService.ts","../../../src/api/audits/controllers/AdminAuditController.ts","../../../src/api/audits/primitives/$audit.ts","../../../src/api/audits/schemas/auditResourceSchema.ts","../../../src/api/audits/index.ts"],"mappings":"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"}

package/dist/api/audits/index.js

@@ -627,42 +627,19 @@ $audit[KIND] = AuditPrimitive;
 //#endregion
 //#region ../../src/api/audits/index.ts
 /**
-* Provides audit logging API endpoints for Alepha applications.
+* | type | quality | stability |
+* |------|---------|-----------|
+* | backend | standard | stable |
 *
-* This module includes:
-* - Audit log CRUD operations
-* - Filtering and searching audit events
-* - Audit statistics and analytics
-* - `$audit` primitive for domain-specific audit types
+* Audit trail for compliance.
 *
-* @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"],
-*   });
+* **Features:**
+* - Domain-specific audit types
+* - Audit event logging
+* - Filtering and searching
+* - User action tracking
 *
-*   async onPaymentCreated(paymentId: string, userId: string) {
-*     await this.audit.log("create", {
-*       userId,
-*       resourceType: "payment",
-*       resourceId: paymentId,
-*     });
-*   }
-* }
-* ```
+* @module alepha.api.audits
 */
 const AlephaApiAudits = $module({
 	name: "alepha.api.audits",

package/dist/api/audits/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/api/audits/entities/audits.ts","../../../src/api/audits/schemas/auditQuerySchema.ts","../../../src/api/audits/schemas/auditResourceSchema.ts","../../../src/api/audits/schemas/createAuditSchema.ts","../../../src/api/audits/services/AuditService.ts","../../../src/api/audits/controllers/AdminAuditController.ts","../../../src/api/audits/primitives/$audit.ts","../../../src/api/audits/index.ts"],"sourcesContent":["import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { $entity, db } from \"alepha/orm\";\n\n/**\n * Audit severity levels for categorizing events.\n */\nexport const auditSeveritySchema = t.enum([\"info\", \"warning\", \"critical\"], {\n  default: \"info\",\n  description: \"Severity level of the audit event\",\n});\n\nexport type AuditSeverity = Static<typeof auditSeveritySchema>;\n\n/**\n * Audit log entity for tracking important system events.\n *\n * Stores comprehensive audit information including:\n * - Who performed the action (userId, userRealm)\n * - What happened (type, action, resource)\n * - When it happened (createdAt)\n * - Context and details (metadata, ipAddress, userAgent)\n */\nexport const audits = $entity({\n  name: \"audits\",\n  schema: t.object({\n    id: db.primaryKey(t.bigint()),\n    createdAt: db.createdAt(),\n\n    /**\n     * Audit event type (e.g., \"auth\", \"user\", \"payment\", \"system\").\n     * Used for categorizing and filtering audit events.\n     */\n    type: t.text({\n      description: \"Audit event type (e.g., auth, user, payment, system)\",\n    }),\n\n    /**\n     * Specific action performed (e.g., \"login\", \"logout\", \"create\", \"update\", \"delete\").\n     */\n    action: t.text({\n      description: \"Specific action performed (e.g., login, create, update)\",\n    }),\n\n    /**\n     * Severity level of the event.\n     */\n    severity: db.default(auditSeveritySchema, \"info\"),\n\n    /**\n     * User ID who performed the action (null for system events).\n     */\n    userId: t.optional(t.uuid()),\n\n    /**\n     * User realm for multi-tenant support.\n     */\n    userRealm: t.optional(t.text()),\n\n    /**\n     * User email at the time of the event (denormalized for history).\n     */\n    userEmail: t.optional(t.email()),\n\n    /**\n     * Resource type affected (e.g., \"user\", \"order\", \"file\").\n     */\n    resourceType: t.optional(t.text()),\n\n    /**\n     * Resource ID affected.\n     */\n    resourceId: t.optional(t.text()),\n\n    /**\n     * Human-readable description of the event.\n     */\n    description: t.optional(t.text()),\n\n    /**\n     * Additional metadata/context as JSON.\n     */\n    metadata: t.optional(t.json()),\n\n    /**\n     * Client IP address.\n     */\n    ipAddress: t.optional(t.text()),\n\n    /**\n     * Client user agent.\n     */\n    userAgent: t.optional(t.text()),\n\n    /**\n     * Session ID if applicable.\n     */\n    sessionId: t.optional(t.uuid()),\n\n    /**\n     * Request ID for correlation.\n     */\n    requestId: t.optional(t.text()),\n\n    /**\n     * Whether the action was successful.\n     */\n    success: db.default(t.boolean(), true),\n\n    /**\n     * Error message if the action failed.\n     */\n    errorMessage: t.optional(t.text()),\n  }),\n  indexes: [\n    \"createdAt\",\n    \"type\",\n    \"action\",\n    \"userId\",\n    \"userRealm\",\n    \"resourceType\",\n    \"resourceId\",\n    \"severity\",\n    { columns: [\"type\", \"action\"] },\n    { columns: [\"userId\", \"createdAt\"] },\n    { columns: [\"userRealm\", \"createdAt\"] },\n  ],\n});\n\nexport const auditEntitySchema = audits.schema;\nexport const auditEntityInsertSchema = audits.insertSchema;\nexport type AuditEntity = Static<typeof audits.schema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { pageQuerySchema } from \"alepha/orm\";\nimport { auditSeveritySchema } from \"../entities/audits.ts\";\n\n/**\n * Query schema for searching and filtering audit logs.\n */\nexport const auditQuerySchema = t.extend(pageQuerySchema, {\n  type: t.optional(t.text({ description: \"Filter by audit type\" })),\n  action: t.optional(t.text({ description: \"Filter by action\" })),\n  severity: t.optional(auditSeveritySchema),\n  userId: t.optional(t.uuid({ description: \"Filter by user ID\" })),\n  userRealm: t.optional(t.text({ description: \"Filter by user realm\" })),\n  resourceType: t.optional(t.text({ description: \"Filter by resource type\" })),\n  resourceId: t.optional(t.text({ description: \"Filter by resource ID\" })),\n  success: t.optional(t.boolean({ description: \"Filter by success status\" })),\n  from: t.optional(t.datetime({ description: \"Start date filter\" })),\n  to: t.optional(t.datetime({ description: \"End date filter\" })),\n  search: t.optional(t.text({ description: \"Search in description\" })),\n});\n\nexport type AuditQuery = Static<typeof auditQuerySchema>;\n","import type { Static } from \"alepha\";\nimport { audits } from \"../entities/audits.ts\";\n\n/**\n * Resource schema for audit log responses.\n */\nexport const auditResourceSchema = audits.schema;\n\nexport type AuditResource = Static<typeof auditResourceSchema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { auditSeveritySchema } from \"../entities/audits.ts\";\n\n/**\n * Schema for creating a new audit log entry.\n */\nexport const createAuditSchema = t.object({\n  type: t.text({ description: \"Audit event type\" }),\n  action: t.text({ description: \"Specific action performed\" }),\n  severity: t.optional(auditSeveritySchema),\n  userId: t.optional(t.uuid()),\n  userRealm: t.optional(t.text()),\n  userEmail: t.optional(t.email()),\n  resourceType: t.optional(t.text()),\n  resourceId: t.optional(t.text()),\n  description: t.optional(t.text()),\n  metadata: t.optional(t.json()),\n  ipAddress: t.optional(t.text()),\n  userAgent: t.optional(t.text()),\n  sessionId: t.optional(t.uuid()),\n  requestId: t.optional(t.text()),\n  success: t.optional(t.boolean()),\n  errorMessage: t.optional(t.text()),\n});\n\nexport type CreateAudit = Static<typeof createAuditSchema>;\n","import { $inject, Alepha } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { $repository, type Page } from \"alepha/orm\";\nimport type { ServerRequest } from \"alepha/server\";\nimport {\n  type AuditEntity,\n  type AuditSeverity,\n  audits,\n} from \"../entities/audits.ts\";\nimport type { AuditQuery } from \"../schemas/auditQuerySchema.ts\";\nimport type { CreateAudit } from \"../schemas/createAuditSchema.ts\";\n\n/**\n * Registered audit type definition.\n */\nexport interface AuditTypeDefinition {\n  type: string;\n  description?: string;\n  actions: string[];\n}\n\n/**\n * Service for managing audit logs.\n *\n * Provides methods for:\n * - Creating audit entries\n * - Querying audit history\n * - Aggregating audit statistics\n * - Managing registered audit types\n */\nexport class AuditService {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly repo = $repository(audits);\n\n  /**\n   * Registry of audit types and their allowed actions.\n   */\n  protected readonly auditTypes = new Map<string, AuditTypeDefinition>();\n\n  /**\n   * Register an audit type with its allowed actions.\n   */\n  public registerType(definition: AuditTypeDefinition): void {\n    this.auditTypes.set(definition.type, definition);\n    this.log.debug(\"Audit type registered\", {\n      type: definition.type,\n      actions: definition.actions,\n    });\n  }\n\n  /**\n   * Get all registered audit types.\n   */\n  public getRegisteredTypes(): AuditTypeDefinition[] {\n    return Array.from(this.auditTypes.values());\n  }\n\n  /**\n   * Get current request context if available.\n   */\n  protected getRequestContext(): ServerRequest | undefined {\n    return this.alepha.context.get<ServerRequest>(\"request\");\n  }\n\n  /**\n   * Create a new audit log entry.\n   * Automatically populates ipAddress, userAgent, and requestId from the current request context.\n   */\n  public async create(data: CreateAudit): Promise<AuditEntity> {\n    const request = this.getRequestContext();\n\n    // Auto-populate from request context if not provided\n    const contextData: Partial<CreateAudit> = {};\n\n    if (request) {\n      if (!data.ipAddress && request.ip) {\n        contextData.ipAddress = request.ip;\n      }\n      if (!data.userAgent && request.headers[\"user-agent\"]) {\n        contextData.userAgent = request.headers[\"user-agent\"];\n      }\n      if (!data.requestId && request.requestId) {\n        contextData.requestId = request.requestId;\n      }\n      // Check for session in metadata\n      if (!data.sessionId && request.metadata?.sessionId) {\n        contextData.sessionId = request.metadata.sessionId;\n      }\n      // Extract user from request.user (set by ServerSecurityProvider)\n      const user = request.user;\n      if (user) {\n        if (!data.userId && user.id) {\n          contextData.userId = user.id;\n        }\n        if (!data.userEmail && user.email) {\n          contextData.userEmail = user.email;\n        }\n        if (!data.userRealm && user.realm) {\n          contextData.userRealm = user.realm;\n        }\n      }\n    }\n\n    this.log.trace(\"Creating audit entry\", {\n      type: data.type,\n      action: data.action,\n      userId: data.userId ?? contextData.userId,\n    });\n\n    const entry = await this.repo.create({\n      ...contextData,\n      ...data,\n      severity: data.severity ?? \"info\",\n      success: data.success ?? true,\n    });\n\n    this.log.debug(\"Audit entry created\", {\n      id: entry.id,\n      type: data.type,\n      action: data.action,\n    });\n\n    return entry;\n  }\n\n  /**\n   * Record an audit event (convenience method).\n   */\n  public async record(\n    type: string,\n    action: string,\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({ type, action, ...options });\n  }\n\n  /**\n   * Record an authentication event.\n   */\n  public async recordAuth(\n    action:\n      | \"login\"\n      | \"logout\"\n      | \"login_failed\"\n      | \"token_refresh\"\n      | \"mfa_setup\"\n      | \"mfa_verify\",\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({\n      type: \"auth\",\n      action,\n      severity: action === \"login_failed\" ? \"warning\" : \"info\",\n      ...options,\n    });\n  }\n\n  /**\n   * Record a user management event.\n   */\n  public async recordUser(\n    action:\n      | \"create\"\n      | \"update\"\n      | \"delete\"\n      | \"enable\"\n      | \"disable\"\n      | \"role_change\",\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({\n      type: \"user\",\n      action,\n      resourceType: \"user\",\n      ...options,\n    });\n  }\n\n  /**\n   * Record a data access event.\n   */\n  public async recordAccess(\n    action: \"view\" | \"export\" | \"download\",\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({ type: \"access\", action, ...options });\n  }\n\n  /**\n   * Record a security event.\n   */\n  public async recordSecurity(\n    action:\n      | \"permission_denied\"\n      | \"suspicious_activity\"\n      | \"rate_limited\"\n      | \"blocked\",\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({\n      type: \"security\",\n      action,\n      severity: \"warning\",\n      ...options,\n    });\n  }\n\n  /**\n   * Record a system event.\n   */\n  public async recordSystem(\n    action: \"startup\" | \"shutdown\" | \"config_change\" | \"maintenance\" | \"error\",\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({\n      type: \"system\",\n      action,\n      severity: action === \"error\" ? \"critical\" : \"info\",\n      ...options,\n    });\n  }\n\n  /**\n   * Find audit entries with filtering and pagination.\n   */\n  public async find(query: AuditQuery = {}): Promise<Page<AuditEntity>> {\n    this.log.trace(\"Finding audit entries\", { query });\n\n    query.sort ??= \"-createdAt\";\n\n    const where = this.repo.createQueryWhere();\n\n    if (query.type) {\n      where.type = { eq: query.type };\n    }\n\n    if (query.action) {\n      where.action = { eq: query.action };\n    }\n\n    if (query.severity) {\n      where.severity = { eq: query.severity };\n    }\n\n    if (query.userId) {\n      where.userId = { eq: query.userId };\n    }\n\n    if (query.userRealm) {\n      where.userRealm = { eq: query.userRealm };\n    }\n\n    if (query.resourceType) {\n      where.resourceType = { eq: query.resourceType };\n    }\n\n    if (query.resourceId) {\n      where.resourceId = { eq: query.resourceId };\n    }\n\n    if (query.success !== undefined) {\n      where.success = { eq: query.success };\n    }\n\n    if (query.from) {\n      where.createdAt = { ...(where.createdAt as object), gte: query.from };\n    }\n\n    if (query.to) {\n      where.createdAt = { ...(where.createdAt as object), lte: query.to };\n    }\n\n    if (query.search) {\n      where.description = { like: `%${query.search}%` };\n    }\n\n    const result = await this.repo.paginate(query, { where }, { count: true });\n\n    this.log.debug(\"Audit entries found\", {\n      count: result.content.length,\n      total: result.page.totalElements,\n    });\n\n    return result;\n  }\n\n  /**\n   * Get audit entry by ID.\n   */\n  public async getById(id: string): Promise<AuditEntity> {\n    return this.repo.findById(id);\n  }\n\n  /**\n   * Get audit entries for a specific user.\n   */\n  public async findByUser(\n    userId: string,\n    query: Omit<AuditQuery, \"userId\"> = {},\n  ): Promise<Page<AuditEntity>> {\n    return this.find({ ...query, userId });\n  }\n\n  /**\n   * Get audit entries for a specific resource.\n   */\n  public async findByResource(\n    resourceType: string,\n    resourceId: string,\n    query: Omit<AuditQuery, \"resourceType\" | \"resourceId\"> = {},\n  ): Promise<Page<AuditEntity>> {\n    return this.find({ ...query, resourceType, resourceId });\n  }\n\n  /**\n   * Get audit statistics for a time period.\n   */\n  public async getStats(\n    options: { from?: Date; to?: Date; userRealm?: string } = {},\n  ): Promise<AuditStats> {\n    this.log.trace(\"Getting audit stats\", options);\n\n    const where = this.repo.createQueryWhere();\n\n    if (options.from) {\n      where.createdAt = { gte: options.from.toISOString() };\n    }\n\n    if (options.to) {\n      where.createdAt = {\n        ...(where.createdAt as object),\n        lte: options.to.toISOString(),\n      };\n    }\n\n    if (options.userRealm) {\n      where.userRealm = { eq: options.userRealm };\n    }\n\n    const all = await this.repo.findMany({ where });\n\n    const stats: AuditStats = {\n      total: all.length,\n      byType: {},\n      bySeverity: { info: 0, warning: 0, critical: 0 },\n      successRate: 0,\n      recentFailures: [],\n    };\n\n    let successCount = 0;\n\n    for (const entry of all) {\n      // Count by type\n      stats.byType[entry.type] = (stats.byType[entry.type] || 0) + 1;\n\n      // Count by severity\n      const severity = entry.severity as AuditSeverity;\n      stats.bySeverity[severity]++;\n\n      // Count successes\n      if (entry.success) {\n        successCount++;\n      }\n    }\n\n    stats.successRate = stats.total > 0 ? successCount / stats.total : 1;\n\n    // Get recent failures\n    const failures = all\n      .filter((e) => !e.success)\n      .sort(\n        (a, b) =>\n          new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime(),\n      )\n      .slice(0, 10);\n\n    stats.recentFailures = failures;\n\n    return stats;\n  }\n\n  /**\n   * Delete old audit entries (for retention policy).\n   */\n  public async deleteOlderThan(date: Date): Promise<number> {\n    this.log.info(\"Deleting old audit entries\", { olderThan: date });\n\n    const old = await this.repo.findMany({\n      where: { createdAt: { lt: date.toISOString() } },\n    });\n\n    for (const entry of old) {\n      await this.repo.deleteById(entry.id);\n    }\n\n    this.log.info(\"Old audit entries deleted\", { count: old.length });\n\n    return old.length;\n  }\n}\n\n/**\n * Audit statistics summary.\n */\nexport interface AuditStats {\n  total: number;\n  byType: Record<string, number>;\n  bySeverity: Record<AuditSeverity, number>;\n  successRate: number;\n  recentFailures: AuditEntity[];\n}\n","import { $inject, t } from \"alepha\";\nimport { $action } from \"alepha/server\";\nimport { auditQuerySchema } from \"../schemas/auditQuerySchema.ts\";\nimport { auditResourceSchema } from \"../schemas/auditResourceSchema.ts\";\nimport { createAuditSchema } from \"../schemas/createAuditSchema.ts\";\nimport { AuditService } from \"../services/AuditService.ts\";\n\n/**\n * REST API controller for audit log management.\n *\n * Provides endpoints for:\n * - Querying audit logs with filtering\n * - Creating audit entries\n * - Getting audit statistics\n * - Viewing registered audit types\n */\nexport class AdminAuditController {\n  protected readonly url = \"/audits\";\n  protected readonly group = \"admin:audits\";\n  protected readonly auditService = $inject(AuditService);\n\n  /**\n   * Find audit entries with filtering and pagination.\n   */\n  public readonly findAudits = $action({\n    path: this.url,\n    group: this.group,\n    description: \"Find audit entries with filtering and pagination\",\n    schema: {\n      query: auditQuerySchema,\n      response: t.page(auditResourceSchema),\n    },\n    handler: ({ query }) => this.auditService.find(query),\n  });\n\n  /**\n   * Get a single audit entry by ID.\n   */\n  public readonly getAudit = $action({\n    path: `${this.url}/:id`,\n    group: this.group,\n    description: \"Get a single audit entry by ID\",\n    schema: {\n      params: t.object({\n        id: t.text(),\n      }),\n      response: auditResourceSchema,\n    },\n    handler: ({ params }) => this.auditService.getById(params.id),\n  });\n\n  /**\n   * Create a new audit entry.\n   */\n  public readonly createAudit = $action({\n    method: \"POST\",\n    path: this.url,\n    group: this.group,\n    description: \"Create a new audit entry\",\n    schema: {\n      body: createAuditSchema,\n      response: auditResourceSchema,\n    },\n    handler: ({ body }) => this.auditService.create(body),\n  });\n\n  /**\n   * Get audit entries for a specific user.\n   */\n  public readonly findByUser = $action({\n    path: `${this.url}/user/:userId`,\n    group: this.group,\n    description: \"Get audit entries for a specific user\",\n    schema: {\n      params: t.object({\n        userId: t.uuid(),\n      }),\n      query: t.omit(auditQuerySchema, [\"userId\"]),\n      response: t.page(auditResourceSchema),\n    },\n    handler: ({ params, query }) =>\n      this.auditService.findByUser(params.userId, query),\n  });\n\n  /**\n   * Get audit entries for a specific resource.\n   */\n  public readonly findByResource = $action({\n    path: `${this.url}/resource/:resourceType/:resourceId`,\n    group: this.group,\n    description: \"Get audit entries for a specific resource\",\n    schema: {\n      params: t.object({\n        resourceType: t.text(),\n        resourceId: t.text(),\n      }),\n      query: t.omit(auditQuerySchema, [\"resourceType\", \"resourceId\"]),\n      response: t.page(auditResourceSchema),\n    },\n    handler: ({ params, query }) =>\n      this.auditService.findByResource(\n        params.resourceType,\n        params.resourceId,\n        query,\n      ),\n  });\n\n  /**\n   * Get audit statistics.\n   */\n  public readonly getStats = $action({\n    path: `${this.url}/stats`,\n    group: this.group,\n    description: \"Get audit statistics for a time period\",\n    schema: {\n      query: t.object({\n        from: t.optional(t.datetime()),\n        to: t.optional(t.datetime()),\n        userRealm: t.optional(t.text()),\n      }),\n      response: t.object({\n        total: t.integer(),\n        byType: t.record(t.text(), t.integer()),\n        bySeverity: t.object({\n          info: t.integer(),\n          warning: t.integer(),\n          critical: t.integer(),\n        }),\n        successRate: t.number(),\n        recentFailures: t.array(auditResourceSchema),\n      }),\n    },\n    handler: ({ query }) =>\n      this.auditService.getStats({\n        from: query.from ? new Date(query.from) : undefined,\n        to: query.to ? new Date(query.to) : undefined,\n        userRealm: query.userRealm,\n      }),\n  });\n\n  /**\n   * Get registered audit types.\n   */\n  public readonly getTypes = $action({\n    path: `${this.url}/types`,\n    group: this.group,\n    description: \"Get all registered audit types\",\n    schema: {\n      response: t.array(\n        t.object({\n          type: t.text(),\n          description: t.optional(t.text()),\n          actions: t.array(t.text()),\n        }),\n      ),\n    },\n    handler: () => this.auditService.getRegisteredTypes(),\n  });\n\n  /**\n   * Get distinct values for filters.\n   */\n  public readonly getFilterOptions = $action({\n    path: `${this.url}/filters`,\n    group: this.group,\n    description: \"Get distinct values for audit filters\",\n    schema: {\n      response: t.object({\n        types: t.array(t.text()),\n        actions: t.array(t.text()),\n        resourceTypes: t.array(t.text()),\n        userRealms: t.array(t.text()),\n      }),\n    },\n    handler: async () => {\n      const types = this.auditService.getRegisteredTypes();\n      return {\n        types: types.map((t) => t.type),\n        actions: types.flatMap((t) => t.actions),\n        resourceTypes: [\"user\", \"session\", \"file\", \"order\", \"payment\"],\n        userRealms: [\"default\"],\n      };\n    },\n  });\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport {\n  AuditService,\n  type AuditTypeDefinition,\n} from \"../services/AuditService.ts\";\n\n/**\n * Options for creating an audit type primitive.\n */\nexport interface AuditPrimitiveOptions {\n  /**\n   * Unique audit type identifier (e.g., \"auth\", \"payment\", \"order\").\n   */\n  type: string;\n\n  /**\n   * Human-readable description of this audit type.\n   */\n  description?: string;\n\n  /**\n   * List of allowed actions for this audit type.\n   */\n  actions: string[];\n}\n\n/**\n * Audit type primitive for registering domain-specific audit events.\n *\n * Provides a type-safe way to define and log audit events within a specific domain.\n *\n * @example\n * ```ts\n * class PaymentAudits {\n *   audit = $audit({\n *     type: \"payment\",\n *     description: \"Payment-related audit events\",\n *     actions: [\"create\", \"refund\", \"cancel\", \"dispute\"],\n *   });\n *\n *   async logPaymentCreated(paymentId: string, userId: string, amount: number) {\n *     await this.audit.log(\"create\", {\n *       userId,\n *       resourceType: \"payment\",\n *       resourceId: paymentId,\n *       description: `Payment of ${amount} created`,\n *       metadata: { amount },\n *     });\n *   }\n * }\n * ```\n */\nexport class AuditPrimitive extends Primitive<AuditPrimitiveOptions> {\n  protected readonly auditService = $inject(AuditService);\n\n  /**\n   * The audit type identifier.\n   */\n  public get type(): string {\n    return this.options.type;\n  }\n\n  /**\n   * The audit type description.\n   */\n  public get description(): string | undefined {\n    return this.options.description;\n  }\n\n  /**\n   * The allowed actions for this audit type.\n   */\n  public get actions(): string[] {\n    return this.options.actions;\n  }\n\n  /**\n   * Log an audit event for this type.\n   */\n  public async log(\n    action: string,\n    options: AuditLogOptions = {},\n  ): Promise<void> {\n    await this.auditService.record(this.options.type, action, options);\n  }\n\n  /**\n   * Log a successful audit event.\n   */\n  public async logSuccess(\n    action: string,\n    options: Omit<AuditLogOptions, \"success\"> = {},\n  ): Promise<void> {\n    await this.log(action, { ...options, success: true });\n  }\n\n  /**\n   * Log a failed audit event.\n   */\n  public async logFailure(\n    action: string,\n    errorMessage: string,\n    options: Omit<AuditLogOptions, \"success\" | \"errorMessage\"> = {},\n  ): Promise<void> {\n    await this.log(action, { ...options, success: false, errorMessage });\n  }\n\n  /**\n   * Called during initialization to register this audit type.\n   */\n  protected onInit(): void {\n    const definition: AuditTypeDefinition = {\n      type: this.options.type,\n      description: this.options.description,\n      actions: this.options.actions,\n    };\n    this.auditService.registerType(definition);\n  }\n}\n\n/**\n * Options for logging an audit event.\n */\nexport interface AuditLogOptions {\n  severity?: \"info\" | \"warning\" | \"critical\";\n  userId?: string;\n  userRealm?: string;\n  userEmail?: string;\n  resourceType?: string;\n  resourceId?: string;\n  description?: string;\n  metadata?: Record<string, unknown>;\n  ipAddress?: string;\n  userAgent?: string;\n  sessionId?: string;\n  requestId?: string;\n  success?: boolean;\n  errorMessage?: string;\n}\n\n/**\n * Create an audit type primitive.\n *\n * @example\n * ```ts\n * class OrderAudits {\n *   audit = $audit({\n *     type: \"order\",\n *     description: \"Order management events\",\n *     actions: [\"create\", \"update\", \"cancel\", \"fulfill\", \"ship\"],\n *   });\n * }\n * ```\n */\nexport const $audit = (options: AuditPrimitiveOptions) => {\n  return createPrimitive(AuditPrimitive, options);\n};\n\n$audit[KIND] = AuditPrimitive;\n","import { $module } from \"alepha\";\nimport { AdminAuditController } from \"./controllers/AdminAuditController.ts\";\nimport { AuditService } from \"./services/AuditService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/AdminAuditController.ts\";\nexport * from \"./entities/audits.ts\";\nexport * from \"./primitives/$audit.ts\";\nexport * from \"./schemas/auditQuerySchema.ts\";\nexport * from \"./schemas/auditResourceSchema.ts\";\nexport * from \"./schemas/createAuditSchema.ts\";\nexport * from \"./services/AuditService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides audit logging API endpoints for Alepha applications.\n *\n * This module includes:\n * - Audit log CRUD operations\n * - Filtering and searching audit events\n * - Audit statistics and analytics\n * - `$audit` primitive for domain-specific audit types\n *\n * @module alepha.api.audits\n *\n * @example\n * ```ts\n * // In your app module\n * import { AlephaApiAudits } from \"alepha/api/audits\";\n *\n * const App = $module({\n *   name: \"app\",\n *   services: [AlephaApiAudits, ...],\n * });\n *\n * // Create domain-specific audit types\n * class PaymentAudits {\n *   audit = $audit({\n *     type: \"payment\",\n *     actions: [\"create\", \"refund\", \"cancel\"],\n *   });\n *\n *   async onPaymentCreated(paymentId: string, userId: string) {\n *     await this.audit.log(\"create\", {\n *       userId,\n *       resourceType: \"payment\",\n *       resourceId: paymentId,\n *     });\n *   }\n * }\n * ```\n */\nexport const AlephaApiAudits = $module({\n  name: \"alepha.api.audits\",\n  services: [AuditService, AdminAuditController],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/api/audits/entities/audits.ts","../../../src/api/audits/schemas/auditQuerySchema.ts","../../../src/api/audits/schemas/auditResourceSchema.ts","../../../src/api/audits/schemas/createAuditSchema.ts","../../../src/api/audits/services/AuditService.ts","../../../src/api/audits/controllers/AdminAuditController.ts","../../../src/api/audits/primitives/$audit.ts","../../../src/api/audits/index.ts"],"sourcesContent":["import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { $entity, db } from \"alepha/orm\";\n\n/**\n * Audit severity levels for categorizing events.\n */\nexport const auditSeveritySchema = t.enum([\"info\", \"warning\", \"critical\"], {\n  default: \"info\",\n  description: \"Severity level of the audit event\",\n});\n\nexport type AuditSeverity = Static<typeof auditSeveritySchema>;\n\n/**\n * Audit log entity for tracking important system events.\n *\n * Stores comprehensive audit information including:\n * - Who performed the action (userId, userRealm)\n * - What happened (type, action, resource)\n * - When it happened (createdAt)\n * - Context and details (metadata, ipAddress, userAgent)\n */\nexport const audits = $entity({\n  name: \"audits\",\n  schema: t.object({\n    id: db.primaryKey(t.bigint()),\n    createdAt: db.createdAt(),\n\n    /**\n     * Audit event type (e.g., \"auth\", \"user\", \"payment\", \"system\").\n     * Used for categorizing and filtering audit events.\n     */\n    type: t.text({\n      description: \"Audit event type (e.g., auth, user, payment, system)\",\n    }),\n\n    /**\n     * Specific action performed (e.g., \"login\", \"logout\", \"create\", \"update\", \"delete\").\n     */\n    action: t.text({\n      description: \"Specific action performed (e.g., login, create, update)\",\n    }),\n\n    /**\n     * Severity level of the event.\n     */\n    severity: db.default(auditSeveritySchema, \"info\"),\n\n    /**\n     * User ID who performed the action (null for system events).\n     */\n    userId: t.optional(t.uuid()),\n\n    /**\n     * User realm for multi-tenant support.\n     */\n    userRealm: t.optional(t.text()),\n\n    /**\n     * User email at the time of the event (denormalized for history).\n     */\n    userEmail: t.optional(t.email()),\n\n    /**\n     * Resource type affected (e.g., \"user\", \"order\", \"file\").\n     */\n    resourceType: t.optional(t.text()),\n\n    /**\n     * Resource ID affected.\n     */\n    resourceId: t.optional(t.text()),\n\n    /**\n     * Human-readable description of the event.\n     */\n    description: t.optional(t.text()),\n\n    /**\n     * Additional metadata/context as JSON.\n     */\n    metadata: t.optional(t.json()),\n\n    /**\n     * Client IP address.\n     */\n    ipAddress: t.optional(t.text()),\n\n    /**\n     * Client user agent.\n     */\n    userAgent: t.optional(t.text()),\n\n    /**\n     * Session ID if applicable.\n     */\n    sessionId: t.optional(t.uuid()),\n\n    /**\n     * Request ID for correlation.\n     */\n    requestId: t.optional(t.text()),\n\n    /**\n     * Whether the action was successful.\n     */\n    success: db.default(t.boolean(), true),\n\n    /**\n     * Error message if the action failed.\n     */\n    errorMessage: t.optional(t.text()),\n  }),\n  indexes: [\n    \"createdAt\",\n    \"type\",\n    \"action\",\n    \"userId\",\n    \"userRealm\",\n    \"resourceType\",\n    \"resourceId\",\n    \"severity\",\n    { columns: [\"type\", \"action\"] },\n    { columns: [\"userId\", \"createdAt\"] },\n    { columns: [\"userRealm\", \"createdAt\"] },\n  ],\n});\n\nexport const auditEntitySchema = audits.schema;\nexport const auditEntityInsertSchema = audits.insertSchema;\nexport type AuditEntity = Static<typeof audits.schema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { pageQuerySchema } from \"alepha/orm\";\nimport { auditSeveritySchema } from \"../entities/audits.ts\";\n\n/**\n * Query schema for searching and filtering audit logs.\n */\nexport const auditQuerySchema = t.extend(pageQuerySchema, {\n  type: t.optional(t.text({ description: \"Filter by audit type\" })),\n  action: t.optional(t.text({ description: \"Filter by action\" })),\n  severity: t.optional(auditSeveritySchema),\n  userId: t.optional(t.uuid({ description: \"Filter by user ID\" })),\n  userRealm: t.optional(t.text({ description: \"Filter by user realm\" })),\n  resourceType: t.optional(t.text({ description: \"Filter by resource type\" })),\n  resourceId: t.optional(t.text({ description: \"Filter by resource ID\" })),\n  success: t.optional(t.boolean({ description: \"Filter by success status\" })),\n  from: t.optional(t.datetime({ description: \"Start date filter\" })),\n  to: t.optional(t.datetime({ description: \"End date filter\" })),\n  search: t.optional(t.text({ description: \"Search in description\" })),\n});\n\nexport type AuditQuery = Static<typeof auditQuerySchema>;\n","import type { Static } from \"alepha\";\nimport { audits } from \"../entities/audits.ts\";\n\n/**\n * Resource schema for audit log responses.\n */\nexport const auditResourceSchema = audits.schema;\n\nexport type AuditResource = Static<typeof auditResourceSchema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { auditSeveritySchema } from \"../entities/audits.ts\";\n\n/**\n * Schema for creating a new audit log entry.\n */\nexport const createAuditSchema = t.object({\n  type: t.text({ description: \"Audit event type\" }),\n  action: t.text({ description: \"Specific action performed\" }),\n  severity: t.optional(auditSeveritySchema),\n  userId: t.optional(t.uuid()),\n  userRealm: t.optional(t.text()),\n  userEmail: t.optional(t.email()),\n  resourceType: t.optional(t.text()),\n  resourceId: t.optional(t.text()),\n  description: t.optional(t.text()),\n  metadata: t.optional(t.json()),\n  ipAddress: t.optional(t.text()),\n  userAgent: t.optional(t.text()),\n  sessionId: t.optional(t.uuid()),\n  requestId: t.optional(t.text()),\n  success: t.optional(t.boolean()),\n  errorMessage: t.optional(t.text()),\n});\n\nexport type CreateAudit = Static<typeof createAuditSchema>;\n","import { $inject, Alepha } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { $repository, type Page } from \"alepha/orm\";\nimport type { ServerRequest } from \"alepha/server\";\nimport {\n  type AuditEntity,\n  type AuditSeverity,\n  audits,\n} from \"../entities/audits.ts\";\nimport type { AuditQuery } from \"../schemas/auditQuerySchema.ts\";\nimport type { CreateAudit } from \"../schemas/createAuditSchema.ts\";\n\n/**\n * Registered audit type definition.\n */\nexport interface AuditTypeDefinition {\n  type: string;\n  description?: string;\n  actions: string[];\n}\n\n/**\n * Service for managing audit logs.\n *\n * Provides methods for:\n * - Creating audit entries\n * - Querying audit history\n * - Aggregating audit statistics\n * - Managing registered audit types\n */\nexport class AuditService {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly repo = $repository(audits);\n\n  /**\n   * Registry of audit types and their allowed actions.\n   */\n  protected readonly auditTypes = new Map<string, AuditTypeDefinition>();\n\n  /**\n   * Register an audit type with its allowed actions.\n   */\n  public registerType(definition: AuditTypeDefinition): void {\n    this.auditTypes.set(definition.type, definition);\n    this.log.debug(\"Audit type registered\", {\n      type: definition.type,\n      actions: definition.actions,\n    });\n  }\n\n  /**\n   * Get all registered audit types.\n   */\n  public getRegisteredTypes(): AuditTypeDefinition[] {\n    return Array.from(this.auditTypes.values());\n  }\n\n  /**\n   * Get current request context if available.\n   */\n  protected getRequestContext(): ServerRequest | undefined {\n    return this.alepha.context.get<ServerRequest>(\"request\");\n  }\n\n  /**\n   * Create a new audit log entry.\n   * Automatically populates ipAddress, userAgent, and requestId from the current request context.\n   */\n  public async create(data: CreateAudit): Promise<AuditEntity> {\n    const request = this.getRequestContext();\n\n    // Auto-populate from request context if not provided\n    const contextData: Partial<CreateAudit> = {};\n\n    if (request) {\n      if (!data.ipAddress && request.ip) {\n        contextData.ipAddress = request.ip;\n      }\n      if (!data.userAgent && request.headers[\"user-agent\"]) {\n        contextData.userAgent = request.headers[\"user-agent\"];\n      }\n      if (!data.requestId && request.requestId) {\n        contextData.requestId = request.requestId;\n      }\n      // Check for session in metadata\n      if (!data.sessionId && request.metadata?.sessionId) {\n        contextData.sessionId = request.metadata.sessionId;\n      }\n      // Extract user from request.user (set by ServerSecurityProvider)\n      const user = request.user;\n      if (user) {\n        if (!data.userId && user.id) {\n          contextData.userId = user.id;\n        }\n        if (!data.userEmail && user.email) {\n          contextData.userEmail = user.email;\n        }\n        if (!data.userRealm && user.realm) {\n          contextData.userRealm = user.realm;\n        }\n      }\n    }\n\n    this.log.trace(\"Creating audit entry\", {\n      type: data.type,\n      action: data.action,\n      userId: data.userId ?? contextData.userId,\n    });\n\n    const entry = await this.repo.create({\n      ...contextData,\n      ...data,\n      severity: data.severity ?? \"info\",\n      success: data.success ?? true,\n    });\n\n    this.log.debug(\"Audit entry created\", {\n      id: entry.id,\n      type: data.type,\n      action: data.action,\n    });\n\n    return entry;\n  }\n\n  /**\n   * Record an audit event (convenience method).\n   */\n  public async record(\n    type: string,\n    action: string,\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({ type, action, ...options });\n  }\n\n  /**\n   * Record an authentication event.\n   */\n  public async recordAuth(\n    action:\n      | \"login\"\n      | \"logout\"\n      | \"login_failed\"\n      | \"token_refresh\"\n      | \"mfa_setup\"\n      | \"mfa_verify\",\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({\n      type: \"auth\",\n      action,\n      severity: action === \"login_failed\" ? \"warning\" : \"info\",\n      ...options,\n    });\n  }\n\n  /**\n   * Record a user management event.\n   */\n  public async recordUser(\n    action:\n      | \"create\"\n      | \"update\"\n      | \"delete\"\n      | \"enable\"\n      | \"disable\"\n      | \"role_change\",\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({\n      type: \"user\",\n      action,\n      resourceType: \"user\",\n      ...options,\n    });\n  }\n\n  /**\n   * Record a data access event.\n   */\n  public async recordAccess(\n    action: \"view\" | \"export\" | \"download\",\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({ type: \"access\", action, ...options });\n  }\n\n  /**\n   * Record a security event.\n   */\n  public async recordSecurity(\n    action:\n      | \"permission_denied\"\n      | \"suspicious_activity\"\n      | \"rate_limited\"\n      | \"blocked\",\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({\n      type: \"security\",\n      action,\n      severity: \"warning\",\n      ...options,\n    });\n  }\n\n  /**\n   * Record a system event.\n   */\n  public async recordSystem(\n    action: \"startup\" | \"shutdown\" | \"config_change\" | \"maintenance\" | \"error\",\n    options: Omit<CreateAudit, \"type\" | \"action\"> = {},\n  ): Promise<AuditEntity> {\n    return this.create({\n      type: \"system\",\n      action,\n      severity: action === \"error\" ? \"critical\" : \"info\",\n      ...options,\n    });\n  }\n\n  /**\n   * Find audit entries with filtering and pagination.\n   */\n  public async find(query: AuditQuery = {}): Promise<Page<AuditEntity>> {\n    this.log.trace(\"Finding audit entries\", { query });\n\n    query.sort ??= \"-createdAt\";\n\n    const where = this.repo.createQueryWhere();\n\n    if (query.type) {\n      where.type = { eq: query.type };\n    }\n\n    if (query.action) {\n      where.action = { eq: query.action };\n    }\n\n    if (query.severity) {\n      where.severity = { eq: query.severity };\n    }\n\n    if (query.userId) {\n      where.userId = { eq: query.userId };\n    }\n\n    if (query.userRealm) {\n      where.userRealm = { eq: query.userRealm };\n    }\n\n    if (query.resourceType) {\n      where.resourceType = { eq: query.resourceType };\n    }\n\n    if (query.resourceId) {\n      where.resourceId = { eq: query.resourceId };\n    }\n\n    if (query.success !== undefined) {\n      where.success = { eq: query.success };\n    }\n\n    if (query.from) {\n      where.createdAt = { ...(where.createdAt as object), gte: query.from };\n    }\n\n    if (query.to) {\n      where.createdAt = { ...(where.createdAt as object), lte: query.to };\n    }\n\n    if (query.search) {\n      where.description = { like: `%${query.search}%` };\n    }\n\n    const result = await this.repo.paginate(query, { where }, { count: true });\n\n    this.log.debug(\"Audit entries found\", {\n      count: result.content.length,\n      total: result.page.totalElements,\n    });\n\n    return result;\n  }\n\n  /**\n   * Get audit entry by ID.\n   */\n  public async getById(id: string): Promise<AuditEntity> {\n    return this.repo.findById(id);\n  }\n\n  /**\n   * Get audit entries for a specific user.\n   */\n  public async findByUser(\n    userId: string,\n    query: Omit<AuditQuery, \"userId\"> = {},\n  ): Promise<Page<AuditEntity>> {\n    return this.find({ ...query, userId });\n  }\n\n  /**\n   * Get audit entries for a specific resource.\n   */\n  public async findByResource(\n    resourceType: string,\n    resourceId: string,\n    query: Omit<AuditQuery, \"resourceType\" | \"resourceId\"> = {},\n  ): Promise<Page<AuditEntity>> {\n    return this.find({ ...query, resourceType, resourceId });\n  }\n\n  /**\n   * Get audit statistics for a time period.\n   */\n  public async getStats(\n    options: { from?: Date; to?: Date; userRealm?: string } = {},\n  ): Promise<AuditStats> {\n    this.log.trace(\"Getting audit stats\", options);\n\n    const where = this.repo.createQueryWhere();\n\n    if (options.from) {\n      where.createdAt = { gte: options.from.toISOString() };\n    }\n\n    if (options.to) {\n      where.createdAt = {\n        ...(where.createdAt as object),\n        lte: options.to.toISOString(),\n      };\n    }\n\n    if (options.userRealm) {\n      where.userRealm = { eq: options.userRealm };\n    }\n\n    const all = await this.repo.findMany({ where });\n\n    const stats: AuditStats = {\n      total: all.length,\n      byType: {},\n      bySeverity: { info: 0, warning: 0, critical: 0 },\n      successRate: 0,\n      recentFailures: [],\n    };\n\n    let successCount = 0;\n\n    for (const entry of all) {\n      // Count by type\n      stats.byType[entry.type] = (stats.byType[entry.type] || 0) + 1;\n\n      // Count by severity\n      const severity = entry.severity as AuditSeverity;\n      stats.bySeverity[severity]++;\n\n      // Count successes\n      if (entry.success) {\n        successCount++;\n      }\n    }\n\n    stats.successRate = stats.total > 0 ? successCount / stats.total : 1;\n\n    // Get recent failures\n    const failures = all\n      .filter((e) => !e.success)\n      .sort(\n        (a, b) =>\n          new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime(),\n      )\n      .slice(0, 10);\n\n    stats.recentFailures = failures;\n\n    return stats;\n  }\n\n  /**\n   * Delete old audit entries (for retention policy).\n   */\n  public async deleteOlderThan(date: Date): Promise<number> {\n    this.log.info(\"Deleting old audit entries\", { olderThan: date });\n\n    const old = await this.repo.findMany({\n      where: { createdAt: { lt: date.toISOString() } },\n    });\n\n    for (const entry of old) {\n      await this.repo.deleteById(entry.id);\n    }\n\n    this.log.info(\"Old audit entries deleted\", { count: old.length });\n\n    return old.length;\n  }\n}\n\n/**\n * Audit statistics summary.\n */\nexport interface AuditStats {\n  total: number;\n  byType: Record<string, number>;\n  bySeverity: Record<AuditSeverity, number>;\n  successRate: number;\n  recentFailures: AuditEntity[];\n}\n","import { $inject, t } from \"alepha\";\nimport { $action } from \"alepha/server\";\nimport { auditQuerySchema } from \"../schemas/auditQuerySchema.ts\";\nimport { auditResourceSchema } from \"../schemas/auditResourceSchema.ts\";\nimport { createAuditSchema } from \"../schemas/createAuditSchema.ts\";\nimport { AuditService } from \"../services/AuditService.ts\";\n\n/**\n * REST API controller for audit log management.\n *\n * Provides endpoints for:\n * - Querying audit logs with filtering\n * - Creating audit entries\n * - Getting audit statistics\n * - Viewing registered audit types\n */\nexport class AdminAuditController {\n  protected readonly url = \"/audits\";\n  protected readonly group = \"admin:audits\";\n  protected readonly auditService = $inject(AuditService);\n\n  /**\n   * Find audit entries with filtering and pagination.\n   */\n  public readonly findAudits = $action({\n    path: this.url,\n    group: this.group,\n    description: \"Find audit entries with filtering and pagination\",\n    schema: {\n      query: auditQuerySchema,\n      response: t.page(auditResourceSchema),\n    },\n    handler: ({ query }) => this.auditService.find(query),\n  });\n\n  /**\n   * Get a single audit entry by ID.\n   */\n  public readonly getAudit = $action({\n    path: `${this.url}/:id`,\n    group: this.group,\n    description: \"Get a single audit entry by ID\",\n    schema: {\n      params: t.object({\n        id: t.text(),\n      }),\n      response: auditResourceSchema,\n    },\n    handler: ({ params }) => this.auditService.getById(params.id),\n  });\n\n  /**\n   * Create a new audit entry.\n   */\n  public readonly createAudit = $action({\n    method: \"POST\",\n    path: this.url,\n    group: this.group,\n    description: \"Create a new audit entry\",\n    schema: {\n      body: createAuditSchema,\n      response: auditResourceSchema,\n    },\n    handler: ({ body }) => this.auditService.create(body),\n  });\n\n  /**\n   * Get audit entries for a specific user.\n   */\n  public readonly findByUser = $action({\n    path: `${this.url}/user/:userId`,\n    group: this.group,\n    description: \"Get audit entries for a specific user\",\n    schema: {\n      params: t.object({\n        userId: t.uuid(),\n      }),\n      query: t.omit(auditQuerySchema, [\"userId\"]),\n      response: t.page(auditResourceSchema),\n    },\n    handler: ({ params, query }) =>\n      this.auditService.findByUser(params.userId, query),\n  });\n\n  /**\n   * Get audit entries for a specific resource.\n   */\n  public readonly findByResource = $action({\n    path: `${this.url}/resource/:resourceType/:resourceId`,\n    group: this.group,\n    description: \"Get audit entries for a specific resource\",\n    schema: {\n      params: t.object({\n        resourceType: t.text(),\n        resourceId: t.text(),\n      }),\n      query: t.omit(auditQuerySchema, [\"resourceType\", \"resourceId\"]),\n      response: t.page(auditResourceSchema),\n    },\n    handler: ({ params, query }) =>\n      this.auditService.findByResource(\n        params.resourceType,\n        params.resourceId,\n        query,\n      ),\n  });\n\n  /**\n   * Get audit statistics.\n   */\n  public readonly getStats = $action({\n    path: `${this.url}/stats`,\n    group: this.group,\n    description: \"Get audit statistics for a time period\",\n    schema: {\n      query: t.object({\n        from: t.optional(t.datetime()),\n        to: t.optional(t.datetime()),\n        userRealm: t.optional(t.text()),\n      }),\n      response: t.object({\n        total: t.integer(),\n        byType: t.record(t.text(), t.integer()),\n        bySeverity: t.object({\n          info: t.integer(),\n          warning: t.integer(),\n          critical: t.integer(),\n        }),\n        successRate: t.number(),\n        recentFailures: t.array(auditResourceSchema),\n      }),\n    },\n    handler: ({ query }) =>\n      this.auditService.getStats({\n        from: query.from ? new Date(query.from) : undefined,\n        to: query.to ? new Date(query.to) : undefined,\n        userRealm: query.userRealm,\n      }),\n  });\n\n  /**\n   * Get registered audit types.\n   */\n  public readonly getTypes = $action({\n    path: `${this.url}/types`,\n    group: this.group,\n    description: \"Get all registered audit types\",\n    schema: {\n      response: t.array(\n        t.object({\n          type: t.text(),\n          description: t.optional(t.text()),\n          actions: t.array(t.text()),\n        }),\n      ),\n    },\n    handler: () => this.auditService.getRegisteredTypes(),\n  });\n\n  /**\n   * Get distinct values for filters.\n   */\n  public readonly getFilterOptions = $action({\n    path: `${this.url}/filters`,\n    group: this.group,\n    description: \"Get distinct values for audit filters\",\n    schema: {\n      response: t.object({\n        types: t.array(t.text()),\n        actions: t.array(t.text()),\n        resourceTypes: t.array(t.text()),\n        userRealms: t.array(t.text()),\n      }),\n    },\n    handler: async () => {\n      const types = this.auditService.getRegisteredTypes();\n      return {\n        types: types.map((t) => t.type),\n        actions: types.flatMap((t) => t.actions),\n        resourceTypes: [\"user\", \"session\", \"file\", \"order\", \"payment\"],\n        userRealms: [\"default\"],\n      };\n    },\n  });\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport {\n  AuditService,\n  type AuditTypeDefinition,\n} from \"../services/AuditService.ts\";\n\n/**\n * Options for creating an audit type primitive.\n */\nexport interface AuditPrimitiveOptions {\n  /**\n   * Unique audit type identifier (e.g., \"auth\", \"payment\", \"order\").\n   */\n  type: string;\n\n  /**\n   * Human-readable description of this audit type.\n   */\n  description?: string;\n\n  /**\n   * List of allowed actions for this audit type.\n   */\n  actions: string[];\n}\n\n/**\n * Audit type primitive for registering domain-specific audit events.\n *\n * Provides a type-safe way to define and log audit events within a specific domain.\n *\n * @example\n * ```ts\n * class PaymentAudits {\n *   audit = $audit({\n *     type: \"payment\",\n *     description: \"Payment-related audit events\",\n *     actions: [\"create\", \"refund\", \"cancel\", \"dispute\"],\n *   });\n *\n *   async logPaymentCreated(paymentId: string, userId: string, amount: number) {\n *     await this.audit.log(\"create\", {\n *       userId,\n *       resourceType: \"payment\",\n *       resourceId: paymentId,\n *       description: `Payment of ${amount} created`,\n *       metadata: { amount },\n *     });\n *   }\n * }\n * ```\n */\nexport class AuditPrimitive extends Primitive<AuditPrimitiveOptions> {\n  protected readonly auditService = $inject(AuditService);\n\n  /**\n   * The audit type identifier.\n   */\n  public get type(): string {\n    return this.options.type;\n  }\n\n  /**\n   * The audit type description.\n   */\n  public get description(): string | undefined {\n    return this.options.description;\n  }\n\n  /**\n   * The allowed actions for this audit type.\n   */\n  public get actions(): string[] {\n    return this.options.actions;\n  }\n\n  /**\n   * Log an audit event for this type.\n   */\n  public async log(\n    action: string,\n    options: AuditLogOptions = {},\n  ): Promise<void> {\n    await this.auditService.record(this.options.type, action, options);\n  }\n\n  /**\n   * Log a successful audit event.\n   */\n  public async logSuccess(\n    action: string,\n    options: Omit<AuditLogOptions, \"success\"> = {},\n  ): Promise<void> {\n    await this.log(action, { ...options, success: true });\n  }\n\n  /**\n   * Log a failed audit event.\n   */\n  public async logFailure(\n    action: string,\n    errorMessage: string,\n    options: Omit<AuditLogOptions, \"success\" | \"errorMessage\"> = {},\n  ): Promise<void> {\n    await this.log(action, { ...options, success: false, errorMessage });\n  }\n\n  /**\n   * Called during initialization to register this audit type.\n   */\n  protected onInit(): void {\n    const definition: AuditTypeDefinition = {\n      type: this.options.type,\n      description: this.options.description,\n      actions: this.options.actions,\n    };\n    this.auditService.registerType(definition);\n  }\n}\n\n/**\n * Options for logging an audit event.\n */\nexport interface AuditLogOptions {\n  severity?: \"info\" | \"warning\" | \"critical\";\n  userId?: string;\n  userRealm?: string;\n  userEmail?: string;\n  resourceType?: string;\n  resourceId?: string;\n  description?: string;\n  metadata?: Record<string, unknown>;\n  ipAddress?: string;\n  userAgent?: string;\n  sessionId?: string;\n  requestId?: string;\n  success?: boolean;\n  errorMessage?: string;\n}\n\n/**\n * Create an audit type primitive.\n *\n * @example\n * ```ts\n * class OrderAudits {\n *   audit = $audit({\n *     type: \"order\",\n *     description: \"Order management events\",\n *     actions: [\"create\", \"update\", \"cancel\", \"fulfill\", \"ship\"],\n *   });\n * }\n * ```\n */\nexport const $audit = (options: AuditPrimitiveOptions) => {\n  return createPrimitive(AuditPrimitive, options);\n};\n\n$audit[KIND] = AuditPrimitive;\n","import { $module } from \"alepha\";\nimport { AdminAuditController } from \"./controllers/AdminAuditController.ts\";\nimport { AuditService } from \"./services/AuditService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/AdminAuditController.ts\";\nexport * from \"./entities/audits.ts\";\nexport * from \"./primitives/$audit.ts\";\nexport * from \"./schemas/auditQuerySchema.ts\";\nexport * from \"./schemas/auditResourceSchema.ts\";\nexport * from \"./schemas/createAuditSchema.ts\";\nexport * from \"./services/AuditService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * | type | quality | stability |\n * |------|---------|-----------|\n * | backend | standard | stable |\n *\n * Audit trail for compliance.\n *\n * **Features:**\n * - Domain-specific audit types\n * - Audit event logging\n * - Filtering and searching\n * - User action tracking\n *\n * @module alepha.api.audits\n */\nexport const AlephaApiAudits = $module({\n  name: \"alepha.api.audits\",\n  services: [AuditService, AdminAuditController],\n});\n"],"mappings":"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"}

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

@@ -651,10 +651,17 @@ declare module "alepha/bucket" {
   }
 }
 /**
- * Provides file management API endpoints for Alepha applications.
+ * | type | quality | stability |
+ * |------|---------|-----------|
+ * | backend | standard | stable |
  *
- * This module includes file upload, download, storage management,
- * and file metadata operations.
+ * File management endpoints.
+ *
+ * **Features:**
+ * - Upload/download endpoints
+ * - File metadata storage
+ * - TTL-based expiration
+ * - Storage statistics
  *
  * @module alepha.api.files
  */

package/dist/api/files/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/api/files/entities/files.ts","../../../src/api/files/schemas/fileQuerySchema.ts","../../../src/orm/schemas/insertSchema.ts","../../../src/orm/schemas/updateSchema.ts","../../../src/orm/primitives/$entity.ts","../../../src/orm/constants/PG_SYMBOLS.ts","../../../src/orm/helpers/pgAttr.ts","../../../src/api/files/schemas/fileResourceSchema.ts","../../../src/api/files/schemas/storageStatsSchema.ts","../../../src/api/files/services/FileService.ts","../../../src/api/files/controllers/AdminFileStatsController.ts","../../../src/api/files/controllers/FileController.ts","../../../src/api/files/jobs/FileJobs.ts","../../../src/api/files/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;cAGa,KAAA,EAAK,YAAA,CAAA,eAAA,WAAA,OAAA;8CA6BhB,SAAA,CAAA,OAAA;;;;;;;;;;;;;;;;KAEU,UAAA,GAAa,MAAA,QAAc,KAAA,CAAM,MAAA;;;cC9BhC,eAAA,YAAe,OAAA;4BAQ1B,SAAA,CAAA,QAAA;;;;;;;;;;;KAEU,SAAA,GAAY,MAAA,QAAc,eAAA;;;;;;;;;;;KCD1B,aAAA,WAAwB,OAAA,IAAW,OAAA,eACjC,CAAA,iBAAkB,CAAA,eAAgB,CAAA;EAAA,CACvC,UAAA;AAAA;EACD,WAAA;AAAA,IACF,SAAA,CAAU,CAAA,eAAgB,CAAA,KAC1B,CAAA,eAAgB,CAAA;;;;;;;;;;;;KCDV,aAAA,WAAwB,OAAA,IAAW,OAAA,eACjC,CAAA,iBAAkB,CAAA,eAAgB,CAAA,UAAW,SAAA,YACrD,SAAA,CAAU,MAAA,EAAQ,CAAA,EAAG,KAAA,MACrB,CAAA,eAAgB,CAAA;;;UCgBL,sBAAA,WACL,OAAA,eACG,MAAA,CAAO,CAAA;;;;;EAMpB,IAAA;;;;EAKA,MAAA,EAAQ,CAAA;;;;EAKR,OAAA,IACI,IAAA;;;;IAKE,MAAA,EAAQ,IAAA;;;;IAIR,MAAA;;;;IAIA,IAAA;EAAA;;;;IAMA,OAAA,EAAS,IAAA;;;;IAIT,MAAA;IJ3EU;;;II+EV,IAAA;EAAA;;;;EAON,WAAA,GAAc,KAAA;;;;IAIZ,IAAA;;;;IAIA,OAAA,EAAS,KAAA,OAAY,MAAA,CAAO,CAAA;;;;;IAK5B,cAAA,EAAgB,KAAA,OAAY,YAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkC9B,WAAA,GAAc,KAAA;;;;IAIZ,OAAA,EAAS,KAAA,OAAY,MAAA,CAAO,CAAA;IJ1GV;;;II8GlB,IAAA;IJ9GmC;;;IIkHnC,MAAA;;;;IAIA,KAAA,GAAQ,GAAA;EAAA;;;;EAMV,MAAA,IACE,IAAA,EAAM,uBAAA,SAAgC,UAAA,CAAW,CAAA,aAC9C,uBAAA;AAAA;AAAA,cAKM,eAAA,WAA0B,OAAA,GAAU,OAAA;EAAA,SAC/B,OAAA,EAAS,sBAAA,CAAuB,CAAA;cAEpC,OAAA,EAAS,sBAAA,CAAuB,CAAA;EAI5C,KAAA,CAAM,KAAA;EAAA,IAYF,IAAA,CAAA,GAAQ,aAAA,CAAc,CAAA;EAAA,IActB,IAAA,CAAA;EAAA,IAIA,MAAA,CAAA,GAAU,CAAA;EAAA,IAIV,YAAA,CAAA,GAAgB,aAAA,CAAc,CAAA;EAAA,IAI9B,YAAA,CAAA,GAAgB,aAAA,CAAc,CAAA;AAAA;;;;KAYxB,UAAA,WAAqB,OAAA,oBACjB,CAAA,iBAAkB,mBAAA;AAAA,KAYtB,YAAA,WAAuB,OAAA;EACjC,IAAA;EACA,MAAA,EAAQ,eAAA,CAAgB,CAAA;AAAA;AAAA,KAGd,aAAA,WAAwB,OAAA,oBACpB,CAAA,iBAAkB,YAAA,CAAa,CAAA;;;cC3OlC,UAAA;AAAA,cACA,cAAA;AAAA,cACA,aAAA;AAAA,cACA,aAAA;AAAA,cACA,aAAA;AAAA,cACA,UAAA;AAAA,cACA,WAAA;AAAA,cACA,OAAA;AAAA,cACA,MAAA;;;;cAKA,SAAA;AAAA,KAMD,SAAA;EAAA,CACT,UAAA;EAAA,CACA,cAAA;EAAA,CACA,aAAA;EAAA,CACA,aAAA;EAAA,CACA,aAAA;EAAA,CACA,UAAA;EAAA,CACA,WAAA,GAAc,iBAAA;EAAA,CACd,MAAA,GAAS,YAAA;EAAA,CACT,OAAA,GAAU,aAAA;;;;GAKV,SAAA;AAAA;AAAA,KAGS,YAAA,SAAqB,SAAA;AAAA,KAErB,iBAAA;EACV,IAAA;AAAA,IACE,iBAAA;EACA,IAAA;AAAA;AAAA,UAGa,aAAA;EACf,IAAA;EACA,WAAA;AAAA;AAAA,UAGe,YAAA;EACf,GAAA;IACE,IAAA;IACA,MAAA,EAAQ,eAAA;EAAA;EAEV,OAAA;IACE,QAAA,GAAW,kBAAA;IACX,QAAA,GAAW,kBAAA;EAAA;AAAA;;;;;;KCTH,MAAA,WAAiB,OAAA,gBAAuB,YAAA,IAAgB,CAAA,WAC5D,KAAA,GAAQ,SAAA,CAAU,CAAA;;;cCnDb,kBAAA,YAAkB,OAAA;oBAO9B,SAAA,CAAA,OAAA;;;;;;;;;;;;;;;;KAEW,YAAA,GAAe,MAAA,QAAc,kBAAA;;;cCT5B,iBAAA,YAAiB,OAAA;UAI5B,SAAA,CAAA,OAAA;;;;cAEW,mBAAA,YAAmB,OAAA;YAG9B,SAAA,CAAA,OAAA;;;cAEW,kBAAA,YAAkB,OAAA;aAK7B,SAAA,CAAA,OAAA;;;;;;;;;;;;KAEU,WAAA,GAAc,MAAA,QAAc,iBAAA;AAAA,KAC5B,aAAA,GAAgB,MAAA,QAAc,mBAAA;AAAA,KAC9B,YAAA,GAAe,MAAA,QAAc,kBAAA;;;cCD5B,WAAA;EAAA,mBACQ,MAAA,EAAM,MAAA;EAAA,mBACN,GAAA,EADM,cAAA,CACH,MAAA;EAAA,mBACH,cAAA,EAAc,YAAA,CAAA,UAAA,WAAA,OAAA;gDADX,SAAA,CAAA,OAAA;;;;;;;;;;;;;;;;qBAEH,gBAAA,EAAgB,gBAAA;EAAA,mBAChB,aAAA,EAAa,eAAA;EAAA,UAEtB,YAAA,EAFsB,SAAA,CAEV,aAAA;EAAA,UAuBZ,kBAAA,EAvBY,SAAA,CAuBM,aAAA;;;;;;;;YAmBZ,iBAAA,CAAkB,IAAA,EAAM,QAAA,GAAW,OAAA;;;;;;;;EAc5C,MAAA,CAAO,UAAA,YAA+C,eAAA;;;;;;;;EAqBhD,SAAA,CAAU,CAAA,GAAG,SAAA,GAAiB,OAAA,CAAQ,IAAA,CAAK,UAAA;;;;;;;EAoD3C,gBAAA,CAAA,GAAoB,OAAA,CAAQ,UAAA;;;;;;;;YAgB/B,iBAAA,CAAkB,GAAA,GAAM,YAAA;;;;;;;;;;;;;;EAsBrB,UAAA,CACX,IAAA,EAAM,QAAA,EACN,OAAA;IACE,cAAA,YAA0B,QAAA;IAC1B,MAAA;IACA,IAAA,GAAO,gBAAA;IACP,IAAA;EAAA,IAED,OAAA,CAAQ,UAAA;;;;;;;;;EAsCE,UAAA,CAAW,EAAA,WAAa,OAAA,CAAQ,QAAA;;;;;;;;;;;;;EAmBhC,UAAA,CACX,EAAA,UACA,IAAA;IACE,IAAA;IACA,IAAA;IACA,cAAA,GAAiB,QAAA;EAAA,IAElB,OAAA,CAAQ,UAAA;;;AT1Ob;;;;;;;ESyQe,UAAA,CAAW,EAAA,WAAa,OAAA,CAAQ,EAAA;ETzQI;;;;AC9BnD;;;;EQ0Ue,WAAA,CAAY,EAAA,WAAa,UAAA,GAAa,OAAA,CAAQ,UAAA;;;;;;EAa9C,eAAA,CAAA,GAAmB,OAAA,CAAQ,YAAA;;;;;;;;EAoDjC,gBAAA,CAAiB,MAAA,EAAQ,UAAA,GAAa,YAAA;AAAA;;;;;;;cCtYlC,wBAAA;EAAA,mBACQ,GAAA;EAAA,mBACA,KAAA;EAAA,mBACA,WAAA,EAAW,WAAA;;;;;;WAOd,QAAA,iBAAQ,iBAAA;;iBAPM,SAAA,CAAA,OAAA;;;;;;;;;;;;;;;;;;;;cCFnB,cAAA;EAAA,mBACQ,GAAA;EAAA,mBACA,KAAA;EAAA,mBACA,WAAA,EAAW,WAAA;;;;;WAMd,SAAA,iBAAS,iBAAA;;gCANK,SAAA,CAAA,QAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAqBd,UAAA,iBAAU,iBAAA;;UAfD,SAAA,CAAA,OAAA;IAAA;;;;;;;;;;;;WAkCT,UAAA,iBAAU,iBAAA;;YAnBA,SAAA,CAAA,KAAA;IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;WA4CV,UAAA,iBAAU,iBAAA;;UAzBA,SAAA,CAAA,OAAA;IAAA;;;;;;;;;;;;;;;;;;;;;;;;EXnBhB;;;;;EAAA,SWoEM,UAAA,iBAAU,iBAAA;;UAxBA,SAAA,CAAA,OAAA;IAAA;;;;;;cC1Ef,QAAA;EAAA,mBACQ,WAAA,EAAW,WAAA;EAAA,SAEd,UAAA,EAFc,iBAAA,CAEJ,kBAAA;AAAA;;;;YCgBhB,iBAAA;;;;IAIR,GAAA,GAAM,YAAA;;;;IAKN,IAAA;Ib7BS;;;IakCT,IAAA,GAAO,gBAAA;;;;;;IAOP,OAAA;EAAA;AAAA;;;;;;;;;cAcS,cAAA,EAAc,SAAA,CAAA,OAAA,CAYzB,SAAA,CAZyB,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/api/files/entities/files.ts","../../../src/api/files/schemas/fileQuerySchema.ts","../../../src/orm/schemas/insertSchema.ts","../../../src/orm/schemas/updateSchema.ts","../../../src/orm/primitives/$entity.ts","../../../src/orm/constants/PG_SYMBOLS.ts","../../../src/orm/helpers/pgAttr.ts","../../../src/api/files/schemas/fileResourceSchema.ts","../../../src/api/files/schemas/storageStatsSchema.ts","../../../src/api/files/services/FileService.ts","../../../src/api/files/controllers/AdminFileStatsController.ts","../../../src/api/files/controllers/FileController.ts","../../../src/api/files/jobs/FileJobs.ts","../../../src/api/files/index.ts"],"mappings":"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"}

package/dist/api/files/index.js

@@ -487,10 +487,17 @@ var FileJobs = class {
 //#endregion
 //#region ../../src/api/files/index.ts
 /**
-* Provides file management API endpoints for Alepha applications.
+* | type | quality | stability |
+* |------|---------|-----------|
+* | backend | standard | stable |
 *
-* This module includes file upload, download, storage management,
-* and file metadata operations.
+* File management endpoints.
+*
+* **Features:**
+* - Upload/download endpoints
+* - File metadata storage
+* - TTL-based expiration
+* - Storage statistics
 *
 * @module alepha.api.files
 */