alepha 0.14.4 → 0.15.0

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

@@ -1,7 +1,6 @@
 import * as alepha160 from "alepha";
 import { Alepha, FileLike, Static, TNull, TObject, TOptional, TSchema, TUnion } from "alepha";
 import { BucketPrimitive } from "alepha/bucket";
-import "alepha/server/security";
 import * as alepha_server0 from "alepha/server";
 import { Ok } from "alepha/server";
 import { DateTime, DateTimeProvider, DurationLike } from "alepha/datetime";
@@ -15,9 +14,6 @@ import { BuildExtraConfigColumns, SQL } from "drizzle-orm";
 import { PgColumnBuilderBase, PgSequenceOptions, PgTableExtraConfigValue, UpdateDeleteAction } from "drizzle-orm/pg-core";
 import "alepha/retry";
 import "drizzle-orm/sqlite-core";
-import "alepha/lock";
-import "drizzle-orm/postgres-js";
-import "postgres";
 
 //#region ../../src/api/files/entities/files.d.ts
 declare const files: alepha_orm16.EntityPrimitive<alepha160.TObject<{
@@ -84,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> {
@@ -239,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;
@@ -270,115 +266,6 @@ interface PgRefOptions {
  */
 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>;
@@ -452,57 +339,57 @@ declare class FileService {
   protected onUploadFile: alepha160.HookPrimitive<"bucket:file:uploaded">;
   protected onDeleteBucketFile: alepha160.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;
@@ -510,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
@@ -580,10 +467,10 @@ 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;
@@ -611,9 +498,9 @@ 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>;
@@ -646,9 +533,9 @@ declare class FileController {
     }>>;
   }>;
   /**
-   * 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;
@@ -660,10 +547,10 @@ declare class FileController {
     }>;
   }>;
   /**
-   * 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;
@@ -691,9 +578,9 @@ declare class FileController {
     }>;
   }>;
   /**
-   * 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;
@@ -722,10 +609,10 @@ declare class FileController {
     }>;
   }>;
   /**
-   * 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;
@@ -744,22 +631,22 @@ 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;
   }
 }