alepha 0.13.0 → 0.13.2

package/README.md

@@ -60,7 +60,7 @@ import { $swagger } from "alepha/server/swagger";
 
 class Api {
 
-  // Functions starting with $ are "descriptors".
+  // Functions starting with $ are "primitives".
   // Like React hooks, they must be called inside Alepha context.
   docs = $swagger();
 

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

@@ -1,13 +1,14 @@
 import * as alepha160 from "alepha";
-import { Alepha, Descriptor, FileLike, KIND, Static, TNull, TObject, TOptional, TSchema, TUnion } from "alepha";
-import { BucketDescriptor } from "alepha/bucket";
-import { DateTime, DateTimeProvider, DurationLike } from "alepha/datetime";
-import * as alepha_logger0 from "alepha/logger";
-import * as alepha_server0 from "alepha/server";
-import { FetchOptions, Ok, ServerRouterProvider } from "alepha/server";
+import { Alepha, FileLike, Static, TNull, TObject, TOptional, TSchema, TUnion } from "alepha";
+import { BucketPrimitive } from "alepha/bucket";
 import * as alepha_orm64 from "alepha/orm";
 import { Page } from "alepha/orm";
-import { JwtProvider, SecurityProvider, UserAccount, UserAccountToken } from "alepha/security";
+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 "alepha/server/security";
+import { UserAccountToken } from "alepha/security";
 import { BuildExtraConfigColumns, SQL } from "drizzle-orm";
 import { PgColumnBuilderBase, PgSequenceOptions, PgTableExtraConfigValue, UpdateDeleteAction } from "drizzle-orm/pg-core";
 import "alepha/retry";
@@ -17,7 +18,7 @@ import "postgres";
 import "drizzle-orm/sqlite-core";
 
 //#region src/api-files/entities/files.d.ts
-declare const files: alepha_orm64.EntityDescriptor<alepha160.TObject<{
+declare const files: alepha_orm64.EntityPrimitive<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>;
@@ -78,8 +79,8 @@ type TObjectInsert<T extends TObject> = TObject<{ [K in keyof T["properties"]]:
  */
 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>> {
+//#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.
@@ -191,9 +192,9 @@ interface EntityDescriptorOptions<T extends TObject, Keys = keyof Static<T>> {
    */
   config?: (self: BuildExtraConfigColumns<string, FromSchema<T>, "pg">) => PgTableExtraConfigValue[];
 }
-declare class EntityDescriptor<T extends TObject = TObject> {
-  readonly options: EntityDescriptorOptions<T>;
-  constructor(options: EntityDescriptorOptions<T>);
+declare class EntityPrimitive<T extends TObject = TObject> {
+  readonly options: EntityPrimitiveOptions<T>;
+  constructor(options: EntityPrimitiveOptions<T>);
   alias(alias: string): this;
   get cols(): EntityColumns<T>;
   get name(): string;
@@ -207,7 +208,7 @@ declare class EntityDescriptor<T extends TObject = TObject> {
 type FromSchema<T extends TObject> = { [key in keyof T["properties"]]: PgColumnBuilderBase };
 type EntityColumn<T extends TObject> = {
   name: string;
-  entity: EntityDescriptor<T>;
+  entity: EntityPrimitive<T>;
 };
 type EntityColumns<T extends TObject> = { [key in keyof T["properties"]]: EntityColumn<T> };
 //#endregion
@@ -253,7 +254,7 @@ interface PgEnumOptions {
 interface PgRefOptions {
   ref: () => {
     name: string;
-    entity: EntityDescriptor;
+    entity: EntityPrimitive;
   };
   actions?: {
     onUpdate?: UpdateDeleteAction;
@@ -445,9 +446,9 @@ declare class FileService {
     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">;
+  protected readonly defaultBucket: BucketPrimitive;
+  protected onUploadFile: alepha160.HookPrimitive<"bucket:file:uploaded">;
+  protected onDeleteBucketFile: alepha160.HookPrimitive<"bucket:file:deleted">;
   /**
    * Calculates SHA-256 checksum of a file.
    *
@@ -457,13 +458,13 @@ declare class FileService {
    */
   protected calculateChecksum(file: FileLike): Promise<string>;
   /**
-   * Gets a bucket descriptor by name.
+   * Gets a bucket primitive by name.
    *
    * @param bucketName - The name of the bucket to retrieve (defaults to "default")
-   * @returns The bucket descriptor
+   * @returns The bucket primitive
    * @throws {NotFoundError} If the bucket is not found
    */
-  bucket(bucketName?: string): BucketDescriptor;
+  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.
@@ -580,7 +581,7 @@ declare class FileController {
    * GET /files - Lists files with optional filtering and pagination.
    * Supports filtering by bucket and tags.
    */
-  readonly findFiles: alepha_server0.ActionDescriptorFn<{
+  readonly findFiles: alepha_server0.ActionPrimitiveFn<{
     query: alepha160.TObject<{
       page: alepha160.TOptional<alepha160.TInteger>;
       size: alepha160.TOptional<alepha160.TInteger>;
@@ -615,7 +616,7 @@ 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.
    */
-  readonly deleteFile: alepha_server0.ActionDescriptorFn<{
+  readonly deleteFile: alepha_server0.ActionPrimitiveFn<{
     params: alepha160.TObject<{
       id: alepha160.TString;
     }>;
@@ -630,7 +631,7 @@ declare class FileController {
    * Creates a database record with metadata and calculates checksum.
    * Optionally specify bucket and expiration date.
    */
-  readonly uploadFile: alepha_server0.ActionDescriptorFn<{
+  readonly uploadFile: alepha_server0.ActionPrimitiveFn<{
     body: alepha160.TObject<{
       file: alepha160.TFile;
     }>;
@@ -660,7 +661,7 @@ declare class FileController {
    * PATCH /files/:id - Updates file metadata.
    * Allows updating name, tags, and expiration date without modifying file content.
    */
-  readonly updateFile: alepha_server0.ActionDescriptorFn<{
+  readonly updateFile: alepha_server0.ActionPrimitiveFn<{
     params: alepha160.TObject<{
       id: alepha160.TString;
     }>;
@@ -692,7 +693,7 @@ declare class FileController {
    * Returns the file content with appropriate Content-Type header.
    * Cached with ETag support for 1 year (immutable).
    */
-  readonly streamFile: alepha_server0.ActionDescriptorFn<{
+  readonly streamFile: alepha_server0.ActionPrimitiveFn<{
     params: alepha160.TObject<{
       id: alepha160.TString;
     }>;
@@ -700,70 +701,6 @@ declare class FileController {
   }>;
 }
 //#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.
@@ -778,7 +715,7 @@ declare class StorageStatsController {
    * Returns aggregated data including total size, file count,
    * and breakdowns by bucket and MIME type.
    */
-  readonly getStats: alepha_server0.ActionDescriptorFn<{
+  readonly getStats: alepha_server0.ActionPrimitiveFn<{
     response: alepha160.TObject<{
       totalSize: alepha160.TNumber;
       totalFiles: alepha160.TNumber;