alepha 0.15.0 → 0.15.2

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

@@ -1,11 +1,11 @@
-import * as alepha160 from "alepha";
+import * as alepha135 from "alepha";
 import { Alepha, FileLike, Static, TNull, TObject, TOptional, TSchema, TUnion } from "alepha";
 import { BucketPrimitive } from "alepha/bucket";
 import * as alepha_server0 from "alepha/server";
 import { Ok } from "alepha/server";
 import { DateTime, DateTimeProvider, DurationLike } from "alepha/datetime";
 import * as alepha_logger0 from "alepha/logger";
-import * as alepha_orm16 from "alepha/orm";
+import * as alepha_orm0 from "alepha/orm";
 import { Page } from "alepha/orm";
 import * as alepha_scheduler0 from "alepha/scheduler";
 import "drizzle-orm/d1";
@@ -16,37 +16,37 @@ import "alepha/retry";
 import "drizzle-orm/sqlite-core";
 
 //#region ../../src/api/files/entities/files.d.ts
-declare const files: alepha_orm16.EntityPrimitive<alepha160.TObject<{
-  id: alepha_orm16.PgAttr<alepha_orm16.PgAttr<alepha160.TString, typeof alepha_orm16.PG_PRIMARY_KEY>, typeof alepha_orm16.PG_DEFAULT>;
-  version: alepha_orm16.PgAttr<alepha_orm16.PgAttr<alepha160.TInteger, typeof alepha_orm16.PG_VERSION>, typeof alepha_orm16.PG_DEFAULT>;
-  createdAt: alepha_orm16.PgAttr<alepha_orm16.PgAttr<alepha160.TString, typeof alepha_orm16.PG_CREATED_AT>, typeof alepha_orm16.PG_DEFAULT>;
-  updatedAt: alepha_orm16.PgAttr<alepha_orm16.PgAttr<alepha160.TString, typeof alepha_orm16.PG_UPDATED_AT>, typeof alepha_orm16.PG_DEFAULT>;
-  blobId: alepha160.TString;
-  creator: alepha160.TOptional<alepha160.TString>;
-  creatorRealm: alepha160.TOptional<alepha160.TString>;
-  creatorName: alepha160.TOptional<alepha160.TString>;
-  bucket: alepha160.TString;
-  expirationDate: alepha160.TOptional<alepha160.TString>;
-  name: alepha160.TString;
-  size: alepha160.TNumber;
-  mimeType: alepha160.TString;
-  tags: alepha160.TOptional<alepha160.TArray<alepha160.TString>>;
-  checksum: alepha160.TOptional<alepha160.TString>;
+declare const files: alepha_orm0.EntityPrimitive<alepha135.TObject<{
+  id: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha135.TString, typeof alepha_orm0.PG_PRIMARY_KEY>, typeof alepha_orm0.PG_DEFAULT>;
+  version: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha135.TInteger, typeof alepha_orm0.PG_VERSION>, typeof alepha_orm0.PG_DEFAULT>;
+  createdAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha135.TString, typeof alepha_orm0.PG_CREATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+  updatedAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha135.TString, typeof alepha_orm0.PG_UPDATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+  blobId: alepha135.TString;
+  creator: alepha135.TOptional<alepha135.TString>;
+  creatorRealm: alepha135.TOptional<alepha135.TString>;
+  creatorName: alepha135.TOptional<alepha135.TString>;
+  bucket: alepha135.TString;
+  expirationDate: alepha135.TOptional<alepha135.TString>;
+  name: alepha135.TString;
+  size: alepha135.TNumber;
+  mimeType: alepha135.TString;
+  tags: alepha135.TOptional<alepha135.TArray<alepha135.TString>>;
+  checksum: alepha135.TOptional<alepha135.TString>;
 }>>;
 type FileEntity = Static<typeof files.schema>;
 //#endregion
 //#region ../../src/api/files/schemas/fileQuerySchema.d.ts
-declare const fileQuerySchema: alepha160.TObject<{
-  page: alepha160.TOptional<alepha160.TInteger>;
-  size: alepha160.TOptional<alepha160.TInteger>;
-  sort: alepha160.TOptional<alepha160.TString>;
-  bucket: alepha160.TOptional<alepha160.TString>;
-  tags: alepha160.TOptional<alepha160.TArray<alepha160.TString>>;
-  name: alepha160.TOptional<alepha160.TString>;
-  mimeType: alepha160.TOptional<alepha160.TString>;
-  creator: alepha160.TOptional<alepha160.TString>;
-  createdAfter: alepha160.TOptional<alepha160.TString>;
-  createdBefore: alepha160.TOptional<alepha160.TString>;
+declare const fileQuerySchema: alepha135.TObject<{
+  page: alepha135.TOptional<alepha135.TInteger>;
+  size: alepha135.TOptional<alepha135.TInteger>;
+  sort: alepha135.TOptional<alepha135.TString>;
+  bucket: alepha135.TOptional<alepha135.TString>;
+  tags: alepha135.TOptional<alepha135.TArray<alepha135.TString>>;
+  name: alepha135.TOptional<alepha135.TString>;
+  mimeType: alepha135.TOptional<alepha135.TString>;
+  creator: alepha135.TOptional<alepha135.TString>;
+  createdAfter: alepha135.TOptional<alepha135.TString>;
+  createdBefore: alepha135.TOptional<alepha135.TString>;
 }>;
 type FileQuery = Static<typeof fileQuerySchema>;
 //#endregion
@@ -80,114 +80,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> {
@@ -235,8 +235,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;
@@ -267,46 +267,46 @@ interface PgRefOptions {
 type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & { [K in TAttr]: PgSymbols[K] };
 //#endregion
 //#region ../../src/api/files/schemas/fileResourceSchema.d.ts
-declare const fileResourceSchema: alepha160.TObject<{
-  id: PgAttr<PgAttr<alepha160.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-  version: PgAttr<PgAttr<alepha160.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
-  createdAt: PgAttr<PgAttr<alepha160.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-  updatedAt: PgAttr<PgAttr<alepha160.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-  blobId: alepha160.TString;
-  creator: alepha160.TOptional<alepha160.TString>;
-  creatorRealm: alepha160.TOptional<alepha160.TString>;
-  creatorName: alepha160.TOptional<alepha160.TString>;
-  bucket: alepha160.TString;
-  expirationDate: alepha160.TOptional<alepha160.TString>;
-  name: alepha160.TString;
-  size: alepha160.TNumber;
-  mimeType: alepha160.TString;
-  tags: alepha160.TOptional<alepha160.TArray<alepha160.TString>>;
-  checksum: alepha160.TOptional<alepha160.TString>;
+declare const fileResourceSchema: alepha135.TObject<{
+  id: PgAttr<PgAttr<alepha135.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+  version: PgAttr<PgAttr<alepha135.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+  createdAt: PgAttr<PgAttr<alepha135.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+  updatedAt: PgAttr<PgAttr<alepha135.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+  blobId: alepha135.TString;
+  creator: alepha135.TOptional<alepha135.TString>;
+  creatorRealm: alepha135.TOptional<alepha135.TString>;
+  creatorName: alepha135.TOptional<alepha135.TString>;
+  bucket: alepha135.TString;
+  expirationDate: alepha135.TOptional<alepha135.TString>;
+  name: alepha135.TString;
+  size: alepha135.TNumber;
+  mimeType: alepha135.TString;
+  tags: alepha135.TOptional<alepha135.TArray<alepha135.TString>>;
+  checksum: alepha135.TOptional<alepha135.TString>;
 }>;
 type FileResource = Static<typeof fileResourceSchema>;
 //#endregion
 //#region ../../src/api/files/schemas/storageStatsSchema.d.ts
-declare const bucketStatsSchema: alepha160.TObject<{
-  bucket: alepha160.TString;
-  totalSize: alepha160.TNumber;
-  fileCount: alepha160.TNumber;
+declare const bucketStatsSchema: alepha135.TObject<{
+  bucket: alepha135.TString;
+  totalSize: alepha135.TNumber;
+  fileCount: alepha135.TNumber;
 }>;
-declare const mimeTypeStatsSchema: alepha160.TObject<{
-  mimeType: alepha160.TString;
-  fileCount: alepha160.TNumber;
+declare const mimeTypeStatsSchema: alepha135.TObject<{
+  mimeType: alepha135.TString;
+  fileCount: alepha135.TNumber;
 }>;
-declare const storageStatsSchema: alepha160.TObject<{
-  totalSize: alepha160.TNumber;
-  totalFiles: alepha160.TNumber;
-  byBucket: alepha160.TArray<alepha160.TObject<{
-    bucket: alepha160.TString;
-    totalSize: alepha160.TNumber;
-    fileCount: alepha160.TNumber;
+declare const storageStatsSchema: alepha135.TObject<{
+  totalSize: alepha135.TNumber;
+  totalFiles: alepha135.TNumber;
+  byBucket: alepha135.TArray<alepha135.TObject<{
+    bucket: alepha135.TString;
+    totalSize: alepha135.TNumber;
+    fileCount: alepha135.TNumber;
   }>>;
-  byMimeType: alepha160.TArray<alepha160.TObject<{
-    mimeType: alepha160.TString;
-    fileCount: alepha160.TNumber;
+  byMimeType: alepha135.TArray<alepha135.TObject<{
+    mimeType: alepha135.TString;
+    fileCount: alepha135.TNumber;
   }>>;
 }>;
 type BucketStats = Static<typeof bucketStatsSchema>;
@@ -317,79 +317,79 @@ type StorageStats = Static<typeof storageStatsSchema>;
 declare class FileService {
   protected readonly alepha: Alepha;
   protected readonly log: alepha_logger0.Logger;
-  protected readonly fileRepository: alepha_orm16.Repository<alepha160.TObject<{
-    id: alepha_orm16.PgAttr<alepha_orm16.PgAttr<alepha160.TString, typeof alepha_orm16.PG_PRIMARY_KEY>, typeof alepha_orm16.PG_DEFAULT>;
-    version: alepha_orm16.PgAttr<alepha_orm16.PgAttr<alepha160.TInteger, typeof alepha_orm16.PG_VERSION>, typeof alepha_orm16.PG_DEFAULT>;
-    createdAt: alepha_orm16.PgAttr<alepha_orm16.PgAttr<alepha160.TString, typeof alepha_orm16.PG_CREATED_AT>, typeof alepha_orm16.PG_DEFAULT>;
-    updatedAt: alepha_orm16.PgAttr<alepha_orm16.PgAttr<alepha160.TString, typeof alepha_orm16.PG_UPDATED_AT>, typeof alepha_orm16.PG_DEFAULT>;
-    blobId: alepha160.TString;
-    creator: alepha160.TOptional<alepha160.TString>;
-    creatorRealm: alepha160.TOptional<alepha160.TString>;
-    creatorName: alepha160.TOptional<alepha160.TString>;
-    bucket: alepha160.TString;
-    expirationDate: alepha160.TOptional<alepha160.TString>;
-    name: alepha160.TString;
-    size: alepha160.TNumber;
-    mimeType: alepha160.TString;
-    tags: alepha160.TOptional<alepha160.TArray<alepha160.TString>>;
-    checksum: alepha160.TOptional<alepha160.TString>;
+  protected readonly fileRepository: alepha_orm0.Repository<alepha135.TObject<{
+    id: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha135.TString, typeof alepha_orm0.PG_PRIMARY_KEY>, typeof alepha_orm0.PG_DEFAULT>;
+    version: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha135.TInteger, typeof alepha_orm0.PG_VERSION>, typeof alepha_orm0.PG_DEFAULT>;
+    createdAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha135.TString, typeof alepha_orm0.PG_CREATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    updatedAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha135.TString, typeof alepha_orm0.PG_UPDATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    blobId: alepha135.TString;
+    creator: alepha135.TOptional<alepha135.TString>;
+    creatorRealm: alepha135.TOptional<alepha135.TString>;
+    creatorName: alepha135.TOptional<alepha135.TString>;
+    bucket: alepha135.TString;
+    expirationDate: alepha135.TOptional<alepha135.TString>;
+    name: alepha135.TString;
+    size: alepha135.TNumber;
+    mimeType: alepha135.TString;
+    tags: alepha135.TOptional<alepha135.TArray<alepha135.TString>>;
+    checksum: alepha135.TOptional<alepha135.TString>;
   }>>;
   protected readonly dateTimeProvider: DateTimeProvider;
   protected readonly defaultBucket: BucketPrimitive;
-  protected onUploadFile: alepha160.HookPrimitive<"bucket:file:uploaded">;
-  protected onDeleteBucketFile: alepha160.HookPrimitive<"bucket:file:deleted">;
+  protected onUploadFile: alepha135.HookPrimitive<"bucket:file:uploaded">;
+  protected onDeleteBucketFile: alepha135.HookPrimitive<"bucket:file:deleted">;
   /**
-       * Calculates SHA-256 checksum of a file.
-       *
-       * @param file - The file to calculate checksum for
-       * @returns Hexadecimal string representation of the SHA-256 hash
-       * @protected
-       */
+   * Calculates SHA-256 checksum of a file.
+   *
+   * @param file - The file to calculate checksum for
+   * @returns Hexadecimal string representation of the SHA-256 hash
+   * @protected
+   */
   protected calculateChecksum(file: FileLike): Promise<string>;
   /**
-       * Gets a bucket primitive by name.
-       *
-       * @param bucketName - The name of the bucket to retrieve (defaults to "default")
-       * @returns The bucket primitive
-       * @throws {NotFoundError} If the bucket is not found
-       */
+   * Gets a bucket primitive by name.
+   *
+   * @param bucketName - The name of the bucket to retrieve (defaults to "default")
+   * @returns The bucket primitive
+   * @throws {NotFoundError} If the bucket is not found
+   */
   bucket(bucketName?: string): BucketPrimitive;
   /**
-       * Finds files matching the given query criteria with pagination support.
-       * Supports filtering by bucket, tags, name, mimeType, creator, and date range.
-       *
-       * @param q - Query parameters including bucket, tags, name, mimeType, creator, date range, pagination, and sorting
-       * @returns Paginated list of file entities
-       */
+   * Finds files matching the given query criteria with pagination support.
+   * Supports filtering by bucket, tags, name, mimeType, creator, and date range.
+   *
+   * @param q - Query parameters including bucket, tags, name, mimeType, creator, date range, pagination, and sorting
+   * @returns Paginated list of file entities
+   */
   findFiles(q?: FileQuery): Promise<Page<FileEntity>>;
   /**
-       * Finds files that have expired based on their expiration date.
-       * Limited to 1000 files per call to prevent memory issues.
-       *
-       * @returns Array of expired file entities
-       */
+   * Finds files that have expired based on their expiration date.
+   * Limited to 1000 files per call to prevent memory issues.
+   *
+   * @returns Array of expired file entities
+   */
   findExpiredFiles(): Promise<FileEntity[]>;
   /**
-       * Calculates an expiration date based on a TTL (time to live) duration.
-       *
-       * @param ttl - Duration like "1 day", "2 hours", etc.
-       * @returns DateTime representation of the expiration date, or undefined if no TTL provided
-       * @protected
-       */
+   * Calculates an expiration date based on a TTL (time to live) duration.
+   *
+   * @param ttl - Duration like "1 day", "2 hours", etc.
+   * @returns DateTime representation of the expiration date, or undefined if no TTL provided
+   * @protected
+   */
   protected getExpirationDate(ttl?: DurationLike): string | undefined;
   /**
-       * Uploads a file to a bucket and creates a database record with metadata.
-       * Automatically calculates and stores the file checksum (SHA-256).
-       *
-       * @param file - The file to upload
-       * @param options - Upload options including bucket, expiration, user, and tags
-       * @param options.bucket - Target bucket name (defaults to "default")
-       * @param options.expirationDate - When the file should expire
-       * @param options.user - User performing the upload (for audit trail)
-       * @param options.tags - Tags to associate with the file
-       * @returns The created file entity with all metadata
-       * @throws {NotFoundError} If the specified bucket doesn't exist
-       */
+   * Uploads a file to a bucket and creates a database record with metadata.
+   * Automatically calculates and stores the file checksum (SHA-256).
+   *
+   * @param file - The file to upload
+   * @param options - Upload options including bucket, expiration, user, and tags
+   * @param options.bucket - Target bucket name (defaults to "default")
+   * @param options.expirationDate - When the file should expire
+   * @param options.user - User performing the upload (for audit trail)
+   * @param options.tags - Tags to associate with the file
+   * @returns The created file entity with all metadata
+   * @throws {NotFoundError} If the specified bucket doesn't exist
+   */
   uploadFile(file: FileLike, options?: {
     expirationDate?: string | DateTime;
     bucket?: string;
@@ -397,63 +397,63 @@ declare class FileService {
     tags?: string[];
   }): Promise<FileEntity>;
   /**
-       * Streams a file from storage by its database ID.
-       *
-       * @param id - The database ID (UUID) of the file to stream
-       * @returns The file object ready for streaming/downloading
-       * @throws {NotFoundError} If the file doesn't exist in the database
-       * @throws {FileNotFoundError} If the file exists in database but not in storage
-       */
+   * Streams a file from storage by its database ID.
+   *
+   * @param id - The database ID (UUID) of the file to stream
+   * @returns The file object ready for streaming/downloading
+   * @throws {NotFoundError} If the file doesn't exist in the database
+   * @throws {FileNotFoundError} If the file exists in database but not in storage
+   */
   streamFile(id: string): Promise<FileLike>;
   /**
-       * Updates file metadata (name, tags, expiration date).
-       * Does not modify the actual file content in storage.
-       *
-       * @param id - The database ID (UUID) of the file to update
-       * @param data - Partial file data to update
-       * @param data.name - New file name
-       * @param data.tags - New tags array
-       * @param data.expirationDate - New expiration date
-       * @returns The updated file entity
-       * @throws {NotFoundError} If the file doesn't exist in the database
-       */
+   * Updates file metadata (name, tags, expiration date).
+   * Does not modify the actual file content in storage.
+   *
+   * @param id - The database ID (UUID) of the file to update
+   * @param data - Partial file data to update
+   * @param data.name - New file name
+   * @param data.tags - New tags array
+   * @param data.expirationDate - New expiration date
+   * @returns The updated file entity
+   * @throws {NotFoundError} If the file doesn't exist in the database
+   */
   updateFile(id: string, data: {
     name?: string;
     tags?: string[];
     expirationDate?: DateTime | string;
   }): Promise<FileEntity>;
   /**
-       * Deletes a file from both storage and database.
-       * Handles cases where file is already deleted from storage gracefully.
-       * Always ensures database record is removed even if storage deletion fails.
-       *
-       * @param id - The database ID (UUID) of the file to delete
-       * @returns Success response with the deleted file ID
-       * @throws {NotFoundError} If the file doesn't exist in the database
-       */
+   * Deletes a file from both storage and database.
+   * Handles cases where file is already deleted from storage gracefully.
+   * Always ensures database record is removed even if storage deletion fails.
+   *
+   * @param id - The database ID (UUID) of the file to delete
+   * @returns Success response with the deleted file ID
+   * @throws {NotFoundError} If the file doesn't exist in the database
+   */
   deleteFile(id: string): Promise<Ok>;
   /**
-       * Retrieves a file entity by its ID.
-       * If already an entity object, returns it as-is (convenience method).
-       *
-       * @param id - Either a UUID string or an existing FileEntity object
-       * @returns The file entity
-       * @throws {NotFoundError} If the file doesn't exist in the database
-       */
+   * Retrieves a file entity by its ID.
+   * If already an entity object, returns it as-is (convenience method).
+   *
+   * @param id - Either a UUID string or an existing FileEntity object
+   * @returns The file entity
+   * @throws {NotFoundError} If the file doesn't exist in the database
+   */
   getFileById(id: string | FileEntity): Promise<FileEntity>;
   /**
-       * Gets storage statistics including total size, file count, and breakdowns by bucket and MIME type.
-       *
-       * @returns Storage statistics with aggregated data
-       */
+   * Gets storage statistics including total size, file count, and breakdowns by bucket and MIME type.
+   *
+   * @returns Storage statistics with aggregated data
+   */
   getStorageStats(): Promise<StorageStats>;
   /**
-       * Converts a file entity to a file resource (API response format).
-       * Currently a pass-through, but allows for future transformation logic.
-       *
-       * @param entity - The file entity to convert
-       * @returns The file resource for API responses
-       */
+   * Converts a file entity to a file resource (API response format).
+   * Currently a pass-through, but allows for future transformation logic.
+   *
+   * @param entity - The file entity to convert
+   * @returns The file resource for API responses
+   */
   entityToResource(entity: FileEntity): FileResource;
 }
 //#endregion
@@ -467,22 +467,22 @@ declare class AdminFileStatsController {
   protected readonly group = "admin:files";
   protected readonly fileService: FileService;
   /**
-       * GET /files/stats - Gets storage statistics.
-       * Returns aggregated data including total size, file count,
-       * and breakdowns by bucket and MIME type.
-       */
+   * GET /files/stats - Gets storage statistics.
+   * Returns aggregated data including total size, file count,
+   * and breakdowns by bucket and MIME type.
+   */
   readonly getStats: alepha_server0.ActionPrimitiveFn<{
-    response: alepha160.TObject<{
-      totalSize: alepha160.TNumber;
-      totalFiles: alepha160.TNumber;
-      byBucket: alepha160.TArray<alepha160.TObject<{
-        bucket: alepha160.TString;
-        totalSize: alepha160.TNumber;
-        fileCount: alepha160.TNumber;
+    response: alepha135.TObject<{
+      totalSize: alepha135.TNumber;
+      totalFiles: alepha135.TNumber;
+      byBucket: alepha135.TArray<alepha135.TObject<{
+        bucket: alepha135.TString;
+        totalSize: alepha135.TNumber;
+        fileCount: alepha135.TNumber;
       }>>;
-      byMimeType: alepha160.TArray<alepha160.TObject<{
-        mimeType: alepha160.TString;
-        fileCount: alepha160.TNumber;
+      byMimeType: alepha135.TArray<alepha135.TObject<{
+        mimeType: alepha135.TString;
+        fileCount: alepha135.TNumber;
       }>>;
     }>;
   }>;
@@ -498,126 +498,126 @@ declare class FileController {
   protected readonly group = "files";
   protected readonly fileService: FileService;
   /**
-       * GET /files - Lists files with optional filtering and pagination.
-       * Supports filtering by bucket and tags.
-       */
+   * GET /files - Lists files with optional filtering and pagination.
+   * Supports filtering by bucket and tags.
+   */
   readonly findFiles: alepha_server0.ActionPrimitiveFn<{
-    query: alepha160.TObject<{
-      page: alepha160.TOptional<alepha160.TInteger>;
-      size: alepha160.TOptional<alepha160.TInteger>;
-      sort: alepha160.TOptional<alepha160.TString>;
-      bucket: alepha160.TOptional<alepha160.TString>;
-      tags: alepha160.TOptional<alepha160.TArray<alepha160.TString>>;
-      name: alepha160.TOptional<alepha160.TString>;
-      mimeType: alepha160.TOptional<alepha160.TString>;
-      creator: alepha160.TOptional<alepha160.TString>;
-      createdAfter: alepha160.TOptional<alepha160.TString>;
-      createdBefore: alepha160.TOptional<alepha160.TString>;
+    query: alepha135.TObject<{
+      page: alepha135.TOptional<alepha135.TInteger>;
+      size: alepha135.TOptional<alepha135.TInteger>;
+      sort: alepha135.TOptional<alepha135.TString>;
+      bucket: alepha135.TOptional<alepha135.TString>;
+      tags: alepha135.TOptional<alepha135.TArray<alepha135.TString>>;
+      name: alepha135.TOptional<alepha135.TString>;
+      mimeType: alepha135.TOptional<alepha135.TString>;
+      creator: alepha135.TOptional<alepha135.TString>;
+      createdAfter: alepha135.TOptional<alepha135.TString>;
+      createdBefore: alepha135.TOptional<alepha135.TString>;
     }>;
-    response: alepha160.TPage<alepha160.TObject<{
-      id: PgAttr<PgAttr<alepha160.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-      version: PgAttr<PgAttr<alepha160.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
-      createdAt: PgAttr<PgAttr<alepha160.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-      updatedAt: PgAttr<PgAttr<alepha160.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-      blobId: alepha160.TString;
-      creator: alepha160.TOptional<alepha160.TString>;
-      creatorRealm: alepha160.TOptional<alepha160.TString>;
-      creatorName: alepha160.TOptional<alepha160.TString>;
-      bucket: alepha160.TString;
-      expirationDate: alepha160.TOptional<alepha160.TString>;
-      name: alepha160.TString;
-      size: alepha160.TNumber;
-      mimeType: alepha160.TString;
-      tags: alepha160.TOptional<alepha160.TArray<alepha160.TString>>;
-      checksum: alepha160.TOptional<alepha160.TString>;
+    response: alepha135.TPage<alepha135.TObject<{
+      id: PgAttr<PgAttr<alepha135.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<alepha135.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<alepha135.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<alepha135.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      blobId: alepha135.TString;
+      creator: alepha135.TOptional<alepha135.TString>;
+      creatorRealm: alepha135.TOptional<alepha135.TString>;
+      creatorName: alepha135.TOptional<alepha135.TString>;
+      bucket: alepha135.TString;
+      expirationDate: alepha135.TOptional<alepha135.TString>;
+      name: alepha135.TString;
+      size: alepha135.TNumber;
+      mimeType: alepha135.TString;
+      tags: alepha135.TOptional<alepha135.TArray<alepha135.TString>>;
+      checksum: alepha135.TOptional<alepha135.TString>;
     }>>;
   }>;
   /**
-       * DELETE /files/:id - Deletes a file from both storage and database.
-       * Removes the file from the bucket and cleans up the database record.
-       */
+   * DELETE /files/:id - Deletes a file from both storage and database.
+   * Removes the file from the bucket and cleans up the database record.
+   */
   readonly deleteFile: alepha_server0.ActionPrimitiveFn<{
-    params: alepha160.TObject<{
-      id: alepha160.TString;
+    params: alepha135.TObject<{
+      id: alepha135.TString;
     }>;
-    response: alepha160.TObject<{
-      ok: alepha160.TBoolean;
-      id: alepha160.TOptional<alepha160.TUnion<[alepha160.TString, alepha160.TInteger]>>;
-      count: alepha160.TOptional<alepha160.TNumber>;
+    response: alepha135.TObject<{
+      ok: alepha135.TBoolean;
+      id: alepha135.TOptional<alepha135.TUnion<[alepha135.TString, alepha135.TInteger]>>;
+      count: alepha135.TOptional<alepha135.TNumber>;
     }>;
   }>;
   /**
-       * POST /files - Uploads a new file to storage.
-       * Creates a database record with metadata and calculates checksum.
-       * Optionally specify bucket and expiration date.
-       */
+   * POST /files - Uploads a new file to storage.
+   * Creates a database record with metadata and calculates checksum.
+   * Optionally specify bucket and expiration date.
+   */
   readonly uploadFile: alepha_server0.ActionPrimitiveFn<{
-    body: alepha160.TObject<{
-      file: alepha160.TFile;
+    body: alepha135.TObject<{
+      file: alepha135.TFile;
     }>;
-    query: alepha160.TObject<{
-      expirationDate: alepha160.TOptional<alepha160.TString>;
-      bucket: alepha160.TOptional<alepha160.TString>;
+    query: alepha135.TObject<{
+      expirationDate: alepha135.TOptional<alepha135.TString>;
+      bucket: alepha135.TOptional<alepha135.TString>;
     }>;
-    response: alepha160.TObject<{
-      id: PgAttr<PgAttr<alepha160.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-      version: PgAttr<PgAttr<alepha160.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
-      createdAt: PgAttr<PgAttr<alepha160.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-      updatedAt: PgAttr<PgAttr<alepha160.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-      blobId: alepha160.TString;
-      creator: alepha160.TOptional<alepha160.TString>;
-      creatorRealm: alepha160.TOptional<alepha160.TString>;
-      creatorName: alepha160.TOptional<alepha160.TString>;
-      bucket: alepha160.TString;
-      expirationDate: alepha160.TOptional<alepha160.TString>;
-      name: alepha160.TString;
-      size: alepha160.TNumber;
-      mimeType: alepha160.TString;
-      tags: alepha160.TOptional<alepha160.TArray<alepha160.TString>>;
-      checksum: alepha160.TOptional<alepha160.TString>;
+    response: alepha135.TObject<{
+      id: PgAttr<PgAttr<alepha135.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<alepha135.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<alepha135.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<alepha135.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      blobId: alepha135.TString;
+      creator: alepha135.TOptional<alepha135.TString>;
+      creatorRealm: alepha135.TOptional<alepha135.TString>;
+      creatorName: alepha135.TOptional<alepha135.TString>;
+      bucket: alepha135.TString;
+      expirationDate: alepha135.TOptional<alepha135.TString>;
+      name: alepha135.TString;
+      size: alepha135.TNumber;
+      mimeType: alepha135.TString;
+      tags: alepha135.TOptional<alepha135.TArray<alepha135.TString>>;
+      checksum: alepha135.TOptional<alepha135.TString>;
     }>;
   }>;
   /**
-       * PATCH /files/:id - Updates file metadata.
-       * Allows updating name, tags, and expiration date without modifying file content.
-       */
+   * PATCH /files/:id - Updates file metadata.
+   * Allows updating name, tags, and expiration date without modifying file content.
+   */
   readonly updateFile: alepha_server0.ActionPrimitiveFn<{
-    params: alepha160.TObject<{
-      id: alepha160.TString;
+    params: alepha135.TObject<{
+      id: alepha135.TString;
     }>;
-    body: alepha160.TObject<{
-      name: alepha160.TOptional<alepha160.TString>;
-      tags: alepha160.TOptional<alepha160.TArray<alepha160.TString>>;
-      expirationDate: alepha160.TOptional<alepha160.TString>;
+    body: alepha135.TObject<{
+      name: alepha135.TOptional<alepha135.TString>;
+      tags: alepha135.TOptional<alepha135.TArray<alepha135.TString>>;
+      expirationDate: alepha135.TOptional<alepha135.TString>;
     }>;
-    response: alepha160.TObject<{
-      id: PgAttr<PgAttr<alepha160.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-      version: PgAttr<PgAttr<alepha160.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
-      createdAt: PgAttr<PgAttr<alepha160.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-      updatedAt: PgAttr<PgAttr<alepha160.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-      blobId: alepha160.TString;
-      creator: alepha160.TOptional<alepha160.TString>;
-      creatorRealm: alepha160.TOptional<alepha160.TString>;
-      creatorName: alepha160.TOptional<alepha160.TString>;
-      bucket: alepha160.TString;
-      expirationDate: alepha160.TOptional<alepha160.TString>;
-      name: alepha160.TString;
-      size: alepha160.TNumber;
-      mimeType: alepha160.TString;
-      tags: alepha160.TOptional<alepha160.TArray<alepha160.TString>>;
-      checksum: alepha160.TOptional<alepha160.TString>;
+    response: alepha135.TObject<{
+      id: PgAttr<PgAttr<alepha135.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<alepha135.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<alepha135.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<alepha135.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      blobId: alepha135.TString;
+      creator: alepha135.TOptional<alepha135.TString>;
+      creatorRealm: alepha135.TOptional<alepha135.TString>;
+      creatorName: alepha135.TOptional<alepha135.TString>;
+      bucket: alepha135.TString;
+      expirationDate: alepha135.TOptional<alepha135.TString>;
+      name: alepha135.TString;
+      size: alepha135.TNumber;
+      mimeType: alepha135.TString;
+      tags: alepha135.TOptional<alepha135.TArray<alepha135.TString>>;
+      checksum: alepha135.TOptional<alepha135.TString>;
     }>;
   }>;
   /**
-       * GET /files/:id - Streams/downloads a file by its ID.
-       * Returns the file content with appropriate Content-Type header.
-       * Cached with ETag support for 1 year (immutable).
-       */
+   * GET /files/:id - Streams/downloads a file by its ID.
+   * Returns the file content with appropriate Content-Type header.
+   * Cached with ETag support for 1 year (immutable).
+   */
   readonly streamFile: alepha_server0.ActionPrimitiveFn<{
-    params: alepha160.TObject<{
-      id: alepha160.TString;
+    params: alepha135.TObject<{
+      id: alepha135.TString;
     }>;
-    response: alepha160.TFile;
+    response: alepha135.TFile;
   }>;
 }
 //#endregion
@@ -631,34 +631,41 @@ declare class FileJobs {
 declare module "alepha/bucket" {
   interface BucketFileOptions {
     /**
-             * Time to live for the files in the bucket.
-             */
+     * Time to live for the files in the bucket.
+     */
     ttl?: DurationLike;
     /**
-             * Tags for the bucket.
-             */
+     * Tags for the bucket.
+     */
     tags?: string[];
     /**
-             * User performing the operation.
-             */
+     * User performing the operation.
+     */
     user?: UserAccountToken;
     /**
-             * Whether to persist the file metadata in the database.
-             *
-             * @default true
-             */
+     * Whether to persist the file metadata in the database.
+     *
+     * @default true
+     */
     persist?: boolean;
   }
 }
 /**
- * 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
  */
-declare const AlephaApiFiles: alepha160.Service<alepha160.Module>;
+declare const AlephaApiFiles: alepha135.Service<alepha135.Module>;
 //#endregion
 export { AdminFileStatsController, AlephaApiFiles, BucketStats, FileController, FileEntity, FileJobs, FileService, MimeTypeStats, StorageStats, bucketStatsSchema, files, mimeTypeStatsSchema, storageStatsSchema };
 //# sourceMappingURL=index.d.ts.map