alepha 0.13.0 → 0.13.1

package/dist/api-files/index.d.cts

@@ -1,829 +0,0 @@
-import * as alepha160 from "alepha";
-import { Alepha, FileLike, Static, TNull, TObject, TOptional, TSchema, TUnion } from "alepha";
-import { DateTime, DateTimeProvider, DurationLike } from "alepha/datetime";
-import { UserAccount, UserAccountToken } from "alepha/security";
-import * as alepha_orm64 from "alepha/orm";
-import { Page } from "alepha/orm";
-import * as alepha_server0 from "alepha/server";
-import { FetchOptions, Ok } from "alepha/server";
-import * as alepha_logger0 from "alepha/logger";
-import { BucketDescriptor } from "alepha/bucket";
-import { BuildExtraConfigColumns, SQL } from "drizzle-orm";
-import { PgColumnBuilderBase, PgSequenceOptions, PgTableExtraConfigValue, UpdateDeleteAction } from "drizzle-orm/pg-core";
-import "alepha/retry";
-import "alepha/lock";
-
-//#region src/api-files/entities/files.d.ts
-declare const files: alepha_orm64.EntityDescriptor<alepha160.TObject<{
-  id: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_PRIMARY_KEY>, typeof alepha_orm64.PG_DEFAULT>;
-  version: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TInteger, typeof alepha_orm64.PG_VERSION>, typeof alepha_orm64.PG_DEFAULT>;
-  createdAt: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_CREATED_AT>, typeof alepha_orm64.PG_DEFAULT>;
-  updatedAt: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_UPDATED_AT>, typeof alepha_orm64.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>;
-}>>;
-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>;
-}>;
-type FileQuery = Static<typeof fileQuerySchema>;
-//#endregion
-//#region src/orm/schemas/insertSchema.d.ts
-/**
- * Transforms a TObject schema for insert operations.
- * All default properties at the root level are made optional.
- *
- * @example
- * Before: { name: string; age: number(default=0); }
- * After:  { name: string; age?: number; }
- */
-type TObjectInsert<T extends TObject> = TObject<{ [K in keyof T["properties"]]: T["properties"][K] extends {
-  [PG_DEFAULT]: any;
-} | {
-  "~optional": true;
-} ? TOptional<T["properties"][K]> : T["properties"][K] }>;
-//#endregion
-//#region src/orm/schemas/updateSchema.d.ts
-/**
- * Transforms a TObject schema for update operations.
- * All optional properties at the root level are made nullable (i.e., `T | null`).
- * This allows an API endpoint to explicitly accept `null` to clear an optional field in the database.
- *
- * @example
- * Before: { name?: string; age: number; }
- * After:  { name?: string | null; age: number; }
- */
-type TObjectUpdate<T extends TObject> = TObject<{ [K in keyof T["properties"]]: T["properties"][K] extends TOptional<infer U> ? TOptional<TUnion<[U, TNull]>> : T["properties"][K] }>;
-//#endregion
-//#region src/orm/descriptors/$entity.d.ts
-interface EntityDescriptorOptions<T extends TObject, Keys = keyof Static<T>> {
-  /**
-   * The database table name that will be created for this entity.
-   * If not provided, name will be inferred from the $repository variable name.
-   */
-  name: string;
-  /**
-   * TypeBox schema defining the table structure and column types.
-   */
-  schema: T;
-  /**
-   * Database indexes to create for query optimization.
-   */
-  indexes?: (Keys | {
-    /**
-     * Single column to index.
-     */
-    column: Keys;
-    /**
-     * Whether this should be a unique index (enforces uniqueness constraint).
-     */
-    unique?: boolean;
-    /**
-     * Custom name for the index. If not provided, generates name automatically.
-     */
-    name?: string;
-  } | {
-    /**
-     * Multiple columns for composite index (order matters for query optimization).
-     */
-    columns: Keys[];
-    /**
-     * Whether this should be a unique index (enforces uniqueness constraint).
-     */
-    unique?: boolean;
-    /**
-     * Custom name for the index. If not provided, generates name automatically.
-     */
-    name?: string;
-  })[];
-  /**
-   * Foreign key constraints to maintain referential integrity.
-   */
-  foreignKeys?: Array<{
-    /**
-     * Optional name for the foreign key constraint.
-     */
-    name?: string;
-    /**
-     * Local columns that reference the foreign table.
-     */
-    columns: Array<keyof Static<T>>;
-    /**
-     * Referenced columns in the foreign table.
-     * Must be EntityColumn references from other entities.
-     */
-    foreignColumns: Array<() => EntityColumn<any>>;
-  }>;
-  /**
-   * Additional table constraints for data validation.
-   *
-   * Constraints enforce business rules at the database level, providing
-   * an additional layer of data integrity beyond application validation.
-   *
-   * **Constraint Types**:
-   * - **Unique constraints**: Prevent duplicate values across columns
-   * - **Check constraints**: Enforce custom validation rules with SQL expressions
-   *
-   * @example
-   * ```ts
-   * constraints: [
-   *   {
-   *     name: "unique_user_email",
-   *     columns: ["email"],
-   *     unique: true
-   *   },
-   *   {
-   *     name: "valid_age_range",
-   *     columns: ["age"],
-   *     check: sql`age >= 0 AND age <= 150`
-   *   },
-   *   {
-   *     name: "unique_user_username_per_tenant",
-   *     columns: ["tenantId", "username"],
-   *     unique: true
-   *   }
-   * ]
-   * ```
-   */
-  constraints?: Array<{
-    /**
-     * Columns involved in this constraint.
-     */
-    columns: Array<keyof Static<T>>;
-    /**
-     * Optional name for the constraint.
-     */
-    name?: string;
-    /**
-     * Whether this is a unique constraint.
-     */
-    unique?: boolean | {};
-    /**
-     * SQL expression for check constraint validation.
-     */
-    check?: SQL;
-  }>;
-  /**
-   * Advanced Drizzle ORM configuration for complex table setups.
-   */
-  config?: (self: BuildExtraConfigColumns<string, FromSchema<T>, "pg">) => PgTableExtraConfigValue[];
-}
-declare class EntityDescriptor<T extends TObject = TObject> {
-  readonly options: EntityDescriptorOptions<T>;
-  constructor(options: EntityDescriptorOptions<T>);
-  alias(alias: string): this;
-  get cols(): EntityColumns<T>;
-  get name(): string;
-  get schema(): T;
-  get insertSchema(): TObjectInsert<T>;
-  get updateSchema(): TObjectUpdate<T>;
-}
-/**
- * Convert a schema to columns.
- */
-type FromSchema<T extends TObject> = { [key in keyof T["properties"]]: PgColumnBuilderBase };
-type EntityColumn<T extends TObject> = {
-  name: string;
-  entity: EntityDescriptor<T>;
-};
-type EntityColumns<T extends TObject> = { [key in keyof T["properties"]]: EntityColumn<T> };
-//#endregion
-//#region src/orm/constants/PG_SYMBOLS.d.ts
-declare const PG_DEFAULT: unique symbol;
-declare const PG_PRIMARY_KEY: unique symbol;
-declare const PG_CREATED_AT: unique symbol;
-declare const PG_UPDATED_AT: unique symbol;
-declare const PG_DELETED_AT: unique symbol;
-declare const PG_VERSION: unique symbol;
-declare const PG_IDENTITY: unique symbol;
-declare const PG_ENUM: unique symbol;
-declare const PG_REF: unique symbol;
-/**
- * @deprecated Use `PG_IDENTITY` instead.
- */
-declare const PG_SERIAL: unique symbol;
-type PgSymbols = {
-  [PG_DEFAULT]: {};
-  [PG_PRIMARY_KEY]: {};
-  [PG_CREATED_AT]: {};
-  [PG_UPDATED_AT]: {};
-  [PG_DELETED_AT]: {};
-  [PG_VERSION]: {};
-  [PG_IDENTITY]: PgIdentityOptions;
-  [PG_REF]: PgRefOptions;
-  [PG_ENUM]: PgEnumOptions;
-  /**
-   * @deprecated Use `PG_IDENTITY` instead.
-   */
-  [PG_SERIAL]: {};
-};
-type PgSymbolKeys = keyof PgSymbols;
-type PgIdentityOptions = {
-  mode: "always" | "byDefault";
-} & PgSequenceOptions & {
-  name?: string;
-};
-interface PgEnumOptions {
-  name?: string;
-  description?: string;
-}
-interface PgRefOptions {
-  ref: () => {
-    name: string;
-    entity: EntityDescriptor;
-  };
-  actions?: {
-    onUpdate?: UpdateDeleteAction;
-    onDelete?: UpdateDeleteAction;
-  };
-}
-//#endregion
-//#region src/orm/helpers/pgAttr.d.ts
-/**
- * Type representation.
- */
-type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & { [K in TAttr]: PgSymbols[K] };
-//#endregion
-//#region src/orm/providers/drivers/NodePostgresProvider.d.ts
-declare module "alepha" {
-  interface Env extends Partial<Static<typeof envSchema>> {}
-}
-declare const envSchema: alepha160.TObject<{
-  /**
-   * Main configuration for database connection.
-   * Accept a string in the format of a Postgres connection URL.
-   * Example: postgres://user:password@localhost:5432/database
-   * or
-   * Example: postgres://user:password@localhost:5432/database?sslmode=require
-   */
-  DATABASE_URL: alepha160.TOptional<alepha160.TString>;
-  /**
-   * In addition to the DATABASE_URL, you can specify the postgres schema name.
-   *
-   * It will monkey patch drizzle tables.
-   */
-  POSTGRES_SCHEMA: alepha160.TOptional<alepha160.TString>;
-}>;
-//#endregion
-//#region src/orm/providers/drivers/NodeSqliteProvider.d.ts
-/**
- * Configuration options for the Node.js SQLite database provider.
- */
-declare const nodeSqliteOptions: alepha160.Atom<alepha160.TObject<{
-  path: alepha160.TOptional<alepha160.TString>;
-}>, "alepha.postgres.node-sqlite.options">;
-type NodeSqliteProviderOptions = Static<typeof nodeSqliteOptions.schema>;
-declare module "alepha" {
-  interface State {
-    [nodeSqliteOptions.key]: NodeSqliteProviderOptions;
-  }
-}
-/**
- * Add a fake support for SQLite in Node.js based on Postgres interfaces.
- *
- * This is NOT a real SQLite provider, it's a workaround to use SQLite with Drizzle ORM.
- * This is NOT recommended for production use.
- */
-//#endregion
-//#region src/orm/index.d.ts
-declare module "alepha" {
-  interface Hooks {
-    /**
-     * Fires before creating an entity in the repository.
-     */
-    "repository:create:before": {
-      tableName: string;
-      data: any;
-    };
-    /**
-     * Fires after creating an entity in the repository.
-     */
-    "repository:create:after": {
-      tableName: string;
-      data: any;
-      entity: any;
-    };
-    /**
-     * Fires before updating entities in the repository.
-     */
-    "repository:update:before": {
-      tableName: string;
-      where: any;
-      data: any;
-    };
-    /**
-     * Fires after updating entities in the repository.
-     */
-    "repository:update:after": {
-      tableName: string;
-      where: any;
-      data: any;
-      entities: any[];
-    };
-    /**
-     * Fires before deleting entities from the repository.
-     */
-    "repository:delete:before": {
-      tableName: string;
-      where: any;
-    };
-    /**
-     * Fires after deleting entities from the repository.
-     */
-    "repository:delete:after": {
-      tableName: string;
-      where: any;
-      ids: Array<string | number>;
-    };
-    /**
-     * Fires before reading entities from the repository.
-     */
-    "repository:read:before": {
-      tableName: string;
-      query: any;
-    };
-    /**
-     * Fires after reading entities from the repository.
-     */
-    "repository:read:after": {
-      tableName: string;
-      query: any;
-      entities: any[];
-    };
-  }
-}
-//#endregion
-//#region src/api-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>;
-}>;
-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 mimeTypeStatsSchema: alepha160.TObject<{
-  mimeType: alepha160.TString;
-  fileCount: alepha160.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;
-  }>>;
-  byMimeType: alepha160.TArray<alepha160.TObject<{
-    mimeType: alepha160.TString;
-    fileCount: alepha160.TNumber;
-  }>>;
-}>;
-type BucketStats = Static<typeof bucketStatsSchema>;
-type MimeTypeStats = Static<typeof mimeTypeStatsSchema>;
-type StorageStats = Static<typeof storageStatsSchema>;
-//#endregion
-//#region src/api-files/services/FileService.d.ts
-declare class FileService {
-  protected readonly alepha: Alepha;
-  protected readonly log: alepha_logger0.Logger;
-  protected readonly fileRepository: alepha_orm64.Repository<alepha160.TObject<{
-    id: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_PRIMARY_KEY>, typeof alepha_orm64.PG_DEFAULT>;
-    version: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TInteger, typeof alepha_orm64.PG_VERSION>, typeof alepha_orm64.PG_DEFAULT>;
-    createdAt: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_CREATED_AT>, typeof alepha_orm64.PG_DEFAULT>;
-    updatedAt: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_UPDATED_AT>, typeof alepha_orm64.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 dateTimeProvider: DateTimeProvider;
-  protected readonly defaultBucket: BucketDescriptor;
-  protected onUploadFile: alepha160.HookDescriptor<"bucket:file:uploaded">;
-  protected onDeleteBucketFile: alepha160.HookDescriptor<"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
-   */
-  protected calculateChecksum(file: FileLike): Promise<string>;
-  /**
-   * Gets a bucket descriptor by name.
-   *
-   * @param bucketName - The name of the bucket to retrieve (defaults to "default")
-   * @returns The bucket descriptor
-   * @throws {NotFoundError} If the bucket is not found
-   */
-  bucket(bucketName?: string): BucketDescriptor;
-  /**
-   * 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
-   */
-  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
-   */
-  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
-   */
-  uploadFile(file: FileLike, options?: {
-    expirationDate?: string | DateTime;
-    bucket?: string;
-    user?: UserAccountToken;
-    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
-   */
-  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
-   */
-  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
-   */
-  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
-   */
-  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
-   */
-  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
-   */
-  entityToResource(entity: FileEntity): FileResource;
-}
-//#endregion
-//#region src/api-files/controllers/FileController.d.ts
-/**
- * REST API controller for file management operations.
- * Provides endpoints for uploading, downloading, listing, and deleting files.
- */
-declare class FileController {
-  protected readonly url = "/files";
-  protected readonly group = "files";
-  protected readonly fileService: FileService;
-  /**
-   * GET /files - Lists files with optional filtering and pagination.
-   * Supports filtering by bucket and tags.
-   */
-  readonly findFiles: alepha_server0.ActionDescriptorFn<{
-    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>;
-    }>;
-    response: alepha160.TPage<alepha160.TObject<{
-      id: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_PRIMARY_KEY>, typeof alepha_orm64.PG_DEFAULT>;
-      version: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TInteger, typeof alepha_orm64.PG_VERSION>, typeof alepha_orm64.PG_DEFAULT>;
-      createdAt: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_CREATED_AT>, typeof alepha_orm64.PG_DEFAULT>;
-      updatedAt: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_UPDATED_AT>, typeof alepha_orm64.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>;
-    }>>;
-  }>;
-  /**
-   * 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.ActionDescriptorFn<{
-    params: alepha160.TObject<{
-      id: alepha160.TString;
-    }>;
-    response: alepha160.TObject<{
-      ok: alepha160.TBoolean;
-      id: alepha160.TOptional<alepha160.TUnion<[alepha160.TString, alepha160.TInteger]>>;
-      count: alepha160.TOptional<alepha160.TNumber>;
-    }>;
-  }>;
-  /**
-   * 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.ActionDescriptorFn<{
-    body: alepha160.TObject<{
-      file: alepha160.TFile;
-    }>;
-    query: alepha160.TObject<{
-      expirationDate: alepha160.TOptional<alepha160.TString>;
-      bucket: alepha160.TOptional<alepha160.TString>;
-    }>;
-    response: alepha160.TObject<{
-      id: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_PRIMARY_KEY>, typeof alepha_orm64.PG_DEFAULT>;
-      version: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TInteger, typeof alepha_orm64.PG_VERSION>, typeof alepha_orm64.PG_DEFAULT>;
-      createdAt: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_CREATED_AT>, typeof alepha_orm64.PG_DEFAULT>;
-      updatedAt: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_UPDATED_AT>, typeof alepha_orm64.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>;
-    }>;
-  }>;
-  /**
-   * PATCH /files/:id - Updates file metadata.
-   * Allows updating name, tags, and expiration date without modifying file content.
-   */
-  readonly updateFile: alepha_server0.ActionDescriptorFn<{
-    params: alepha160.TObject<{
-      id: alepha160.TString;
-    }>;
-    body: alepha160.TObject<{
-      name: alepha160.TOptional<alepha160.TString>;
-      tags: alepha160.TOptional<alepha160.TArray<alepha160.TString>>;
-      expirationDate: alepha160.TOptional<alepha160.TString>;
-    }>;
-    response: alepha160.TObject<{
-      id: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_PRIMARY_KEY>, typeof alepha_orm64.PG_DEFAULT>;
-      version: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TInteger, typeof alepha_orm64.PG_VERSION>, typeof alepha_orm64.PG_DEFAULT>;
-      createdAt: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_CREATED_AT>, typeof alepha_orm64.PG_DEFAULT>;
-      updatedAt: alepha_orm64.PgAttr<alepha_orm64.PgAttr<alepha160.TString, typeof alepha_orm64.PG_UPDATED_AT>, typeof alepha_orm64.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>;
-    }>;
-  }>;
-  /**
-   * 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.ActionDescriptorFn<{
-    params: alepha160.TObject<{
-      id: alepha160.TString;
-    }>;
-    response: alepha160.TFile;
-  }>;
-}
-//#endregion
-//#region src/server-security/providers/ServerBasicAuthProvider.d.ts
-interface BasicAuthOptions {
-  username: string;
-  password: string;
-}
-//#endregion
-//#region src/server-security/providers/ServerSecurityProvider.d.ts
-type ServerRouteSecure = {
-  realm?: string;
-  basic?: BasicAuthOptions;
-};
-//#endregion
-//#region src/server-security/index.d.ts
-declare module "alepha" {
-  interface State {
-    /**
-     * Real (or fake) user account, used for internal actions.
-     *
-     * If you define this, you assume that all actions are executed by this user by default.
-     * > To force a different user, you need to pass it explicitly in the options.
-     */
-    "alepha.server.security.system.user"?: UserAccountToken;
-    /**
-     * The authenticated user account attached to the server request state.
-     *
-     * @internal
-     */
-    "alepha.server.request.user"?: UserAccount;
-  }
-}
-declare module "alepha/server" {
-  interface ServerRequest<TConfig> {
-    user?: UserAccountToken;
-  }
-  interface ServerActionRequest<TConfig> {
-    user: UserAccountToken;
-  }
-  interface ServerRoute {
-    /**
-     * If true, the route will be protected by the security provider.
-     * All actions are secure by default, but you can disable it for specific actions.
-     */
-    secure?: boolean | ServerRouteSecure;
-  }
-  interface ClientRequestOptions extends FetchOptions {
-    /**
-     * Forward user from the previous request.
-     * If "system", use system user. @see {ServerSecurityProvider.localSystemUser}
-     * If "context", use the user from the current context (e.g. request).
-     *
-     * @default "system" if provided, else "context" if available.
-     */
-    user?: UserAccountToken | "system" | "context";
-  }
-}
-/**
- * Plugin for Alepha Server that provides security features. Based on the Alepha Security module.
- *
- * By default, all $action will be guarded by a permission check.
- *
- * @see {@link ServerSecurityProvider}
- * @module alepha.server.security
- */
-//#endregion
-//#region src/api-files/controllers/StorageStatsController.d.ts
-/**
- * REST API controller for storage analytics and statistics.
- * Provides endpoints for viewing storage usage metrics.
- */
-declare class StorageStatsController {
-  protected readonly url = "/files/stats";
-  protected readonly group = "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.
-   */
-  readonly getStats: alepha_server0.ActionDescriptorFn<{
-    response: alepha160.TObject<{
-      totalSize: alepha160.TNumber;
-      totalFiles: alepha160.TNumber;
-      byBucket: alepha160.TArray<alepha160.TObject<{
-        bucket: alepha160.TString;
-        totalSize: alepha160.TNumber;
-        fileCount: alepha160.TNumber;
-      }>>;
-      byMimeType: alepha160.TArray<alepha160.TObject<{
-        mimeType: alepha160.TString;
-        fileCount: alepha160.TNumber;
-      }>>;
-    }>;
-  }>;
-}
-//#endregion
-//#region src/api-files/index.d.ts
-declare module "alepha/bucket" {
-  interface BucketFileOptions {
-    /**
-     * Time to live for the files in the bucket.
-     */
-    ttl?: DurationLike;
-    /**
-     * Tags for the bucket.
-     */
-    tags?: string[];
-    /**
-     * User performing the operation.
-     */
-    user?: UserAccountToken;
-    /**
-     * Whether to persist the file metadata in the database.
-     *
-     * @default true
-     */
-    persist?: boolean;
-  }
-}
-/**
- * Provides file management API endpoints for Alepha applications.
- *
- * This module includes file upload, download, storage management,
- * and file metadata operations.
- *
- * @module alepha.api.files
- */
-declare const AlephaApiFiles: alepha160.Service<alepha160.Module>;
-//#endregion
-export { AlephaApiFiles, BucketStats, FileController, FileEntity, FileService, MimeTypeStats, StorageStats, StorageStatsController, bucketStatsSchema, files, mimeTypeStatsSchema, storageStatsSchema };
-//# sourceMappingURL=index.d.cts.map