alepha 0.10.4 → 0.10.6

package/bucket.d.ts

@@ -561,11 +561,88 @@ declare class FileNotFoundError extends AlephaError {
   readonly status = 404;
 }
 //#endregion
+//#region src/services/FileMetadataService.d.ts
+interface FileMetadata {
+  name: string;
+  type: string;
+}
+/**
+ * Service for encoding/decoding file metadata in storage streams.
+ *
+ * The metadata is stored at the beginning of the file with the following structure:
+ * - 4-byte header: UInt32BE containing the metadata length
+ * - N-byte metadata: JSON object containing file metadata (name, type)
+ * - Remaining bytes: Actual file content
+ *
+ * @example
+ * ```typescript
+ * const service = new FileMetadataService();
+ *
+ * // Encode metadata and content for storage
+ * const { header, metadata } = service.encodeMetadata({
+ *   name: "document.pdf",
+ *   type: "application/pdf"
+ * });
+ *
+ * // Decode metadata from stored file
+ * const fileHandle = await open(filePath, 'r');
+ * const { metadata, contentStart } = await service.decodeMetadata(fileHandle);
+ * ```
+ */
+declare class FileMetadataService {
+  /**
+   * Length of the header containing metadata size (4 bytes for UInt32BE)
+   */
+  static readonly METADATA_HEADER_LENGTH = 4;
+  /**
+   * Encodes file metadata into header and metadata buffers.
+   *
+   * @param file - The file or metadata to encode
+   * @returns Object containing the header buffer and metadata buffer
+   */
+  encodeMetadata(file: FileLike | FileMetadata): {
+    header: Buffer;
+    metadata: Buffer;
+  };
+  /**
+   * Decodes file metadata from a file handle.
+   *
+   * @param fileHandle - File handle opened for reading
+   * @returns Object containing the decoded metadata and content start position
+   */
+  decodeMetadata(fileHandle: {
+    read: (buffer: Buffer, offset: number, length: number, position: number) => Promise<{
+      bytesRead: number;
+    }>;
+  }): Promise<{
+    metadata: FileMetadata;
+    contentStart: number;
+  }>;
+  /**
+   * Decodes file metadata from a buffer.
+   *
+   * @param buffer - Buffer containing the file with metadata
+   * @returns Object containing the decoded metadata and content start position
+   */
+  decodeMetadataFromBuffer(buffer: Buffer): {
+    metadata: FileMetadata;
+    contentStart: number;
+  };
+  /**
+   * Creates a complete buffer with metadata header, metadata, and content.
+   *
+   * @param file - The file to encode
+   * @param content - The file content as a buffer
+   * @returns Complete buffer ready for storage
+   */
+  createFileBuffer(file: FileLike | FileMetadata, content: Buffer): Buffer;
+}
+//#endregion
 //#region src/providers/LocalFileStorageProvider.d.ts
 declare class LocalFileStorageProvider implements FileStorageProvider {
-  static METADATA_HEADER_LENGTH: number;
   protected readonly alepha: Alepha;
   protected readonly log: _alepha_logger0.Logger;
+  protected readonly metadataService: FileMetadataService;
   options: {
     storagePath: string;
   };
@@ -574,9 +651,9 @@ declare class LocalFileStorageProvider implements FileStorageProvider {
   download(bucketName: string, fileId: string): Promise<FileLike>;
   exists(bucketName: string, fileId: string): Promise<boolean>;
   delete(bucketName: string, fileId: string): Promise<void>;
-  protected stat(container: string, fileId: string): Promise<fs.Stats>;
+  protected stat(bucket: string, fileId: string): Promise<fs.Stats>;
   protected createId(): string;
-  protected path(container: string, fileId?: string): string;
+  protected path(bucket: string, fileId?: string): string;
   protected isErrorNoEntry(error: unknown): boolean;
 }
 declare const fileMetadataSchema: typebox0.TObject<{
@@ -620,5 +697,5 @@ declare module "alepha" {
  */
 declare const AlephaBucket: _alepha_core1.Service<_alepha_core1.Module<{}>>;
 //#endregion
-export { $bucket, AlephaBucket, BucketDescriptor, BucketDescriptorOptions, BucketFileOptions, FileNotFoundError, FileStorageProvider, LocalFileStorageProvider, MemoryFileStorageProvider, fileMetadataSchema };
+export { $bucket, AlephaBucket, BucketDescriptor, BucketDescriptorOptions, BucketFileOptions, FileMetadata, FileMetadataService, FileNotFoundError, FileStorageProvider, LocalFileStorageProvider, MemoryFileStorageProvider, fileMetadataSchema };
 //# sourceMappingURL=index.d.ts.map

package/command.d.ts

@@ -151,7 +151,7 @@ declare class CommandDescriptor<T extends TObject = TObject, A extends TSchema =
 }
 interface CommandHandlerArgs<T extends TObject, A extends TSchema = TSchema> {
   flags: Static<T>;
-  args: A extends TSchema ? Static<A> : undefined;
+  args: A extends TSchema ? Static<A> : Array<string>;
   run: RunnerMethod;
   ask: AskMethod;
   glob: typeof glob;

package/email.d.ts

@@ -1,6 +1,6 @@
 import * as _alepha_core1 from "alepha";
 import { Descriptor, KIND, Service, Static, TSchema } from "alepha";
-import * as _alepha_logger1 from "alepha/logger";
+import * as _alepha_logger0 from "alepha/logger";
 import { Transporter } from "nodemailer";
 
 //#region src/providers/EmailProvider.d.ts
@@ -30,7 +30,7 @@ interface EmailRecord {
   sentAt: Date;
 }
 declare class MemoryEmailProvider implements EmailProvider {
-  protected readonly log: _alepha_logger1.Logger;
+  protected readonly log: _alepha_logger0.Logger;
   protected emails: EmailRecord[];
   send(to: string, subject: string, body: string): Promise<void>;
   /**
@@ -224,7 +224,7 @@ interface EmailDescriptorOptions<T extends TSchema> {
   provider?: Service<EmailProvider> | "memory";
 }
 declare class EmailDescriptor<T extends TSchema> extends Descriptor<EmailDescriptorOptions<T>> {
-  protected readonly log: _alepha_logger1.Logger;
+  protected readonly log: _alepha_logger0.Logger;
   protected readonly templateService: TemplateService;
   readonly provider: EmailProvider | MemoryEmailProvider;
   get name(): string;
@@ -252,7 +252,7 @@ interface LocalEmailProviderOptions {
   directory?: string;
 }
 declare class LocalEmailProvider implements EmailProvider {
-  protected readonly log: _alepha_logger1.Logger;
+  protected readonly log: _alepha_logger0.Logger;
   protected readonly directory: string;
   constructor(options?: LocalEmailProviderOptions);
   send(to: string, subject: string, body: string): Promise<void>;
@@ -292,7 +292,7 @@ declare class NodemailerEmailProvider implements EmailProvider {
     EMAIL_FROM: string;
     EMAIL_SECURE: boolean;
   };
-  protected readonly log: _alepha_logger1.Logger;
+  protected readonly log: _alepha_logger0.Logger;
   protected transporter: Transporter;
   protected fromAddress: string;
   readonly options: NodemailerEmailProviderOptions;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "alepha",
-	"version": "0.10.4",
+	"version": "0.10.6",
 	"type": "module",
 	"engines": {
 		"node": ">=22.0.0"
@@ -15,55 +15,55 @@
 	"main": "./core.js",
 	"types": "./core.d.ts",
 	"dependencies": {
-		"@alepha/api-files": "0.10.4",
-		"@alepha/api-jobs": "0.10.4",
-		"@alepha/api-users": "0.10.4",
-		"@alepha/batch": "0.10.4",
-		"@alepha/bucket": "0.10.4",
-		"@alepha/cache": "0.10.4",
-		"@alepha/cache-redis": "0.10.4",
-		"@alepha/command": "0.10.4",
-		"@alepha/core": "0.10.4",
-		"@alepha/datetime": "0.10.4",
-		"@alepha/devtools": "0.10.4",
-		"@alepha/email": "0.10.4",
-		"@alepha/file": "0.10.4",
-		"@alepha/lock": "0.10.4",
-		"@alepha/lock-redis": "0.10.4",
-		"@alepha/logger": "0.10.4",
-		"@alepha/postgres": "0.10.4",
-		"@alepha/queue": "0.10.4",
-		"@alepha/queue-redis": "0.10.4",
-		"@alepha/react": "0.10.4",
-		"@alepha/react-auth": "0.10.4",
-		"@alepha/react-form": "0.10.4",
-		"@alepha/react-head": "0.10.4",
-		"@alepha/react-i18n": "0.10.4",
-		"@alepha/redis": "0.10.4",
-		"@alepha/retry": "0.10.4",
-		"@alepha/router": "0.10.4",
-		"@alepha/scheduler": "0.10.4",
-		"@alepha/security": "0.10.4",
-		"@alepha/server": "0.10.4",
-		"@alepha/server-cache": "0.10.4",
-		"@alepha/server-compress": "0.10.4",
-		"@alepha/server-cookies": "0.10.4",
-		"@alepha/server-cors": "0.10.4",
-		"@alepha/server-health": "0.10.4",
-		"@alepha/server-helmet": "0.10.4",
-		"@alepha/server-links": "0.10.4",
-		"@alepha/server-metrics": "0.10.4",
-		"@alepha/server-multipart": "0.10.4",
-		"@alepha/server-proxy": "0.10.4",
-		"@alepha/server-security": "0.10.4",
-		"@alepha/server-static": "0.10.4",
-		"@alepha/server-swagger": "0.10.4",
-		"@alepha/topic": "0.10.4",
-		"@alepha/topic-redis": "0.10.4",
-		"@alepha/vite": "0.10.4"
+		"@alepha/api-files": "0.10.6",
+		"@alepha/api-jobs": "0.10.6",
+		"@alepha/api-users": "0.10.6",
+		"@alepha/batch": "0.10.6",
+		"@alepha/bucket": "0.10.6",
+		"@alepha/cache": "0.10.6",
+		"@alepha/cache-redis": "0.10.6",
+		"@alepha/command": "0.10.6",
+		"@alepha/core": "0.10.6",
+		"@alepha/datetime": "0.10.6",
+		"@alepha/devtools": "0.10.6",
+		"@alepha/email": "0.10.6",
+		"@alepha/file": "0.10.6",
+		"@alepha/lock": "0.10.6",
+		"@alepha/lock-redis": "0.10.6",
+		"@alepha/logger": "0.10.6",
+		"@alepha/postgres": "0.10.6",
+		"@alepha/queue": "0.10.6",
+		"@alepha/queue-redis": "0.10.6",
+		"@alepha/react": "0.10.6",
+		"@alepha/react-auth": "0.10.6",
+		"@alepha/react-form": "0.10.6",
+		"@alepha/react-head": "0.10.6",
+		"@alepha/react-i18n": "0.10.6",
+		"@alepha/redis": "0.10.6",
+		"@alepha/retry": "0.10.6",
+		"@alepha/router": "0.10.6",
+		"@alepha/scheduler": "0.10.6",
+		"@alepha/security": "0.10.6",
+		"@alepha/server": "0.10.6",
+		"@alepha/server-cache": "0.10.6",
+		"@alepha/server-compress": "0.10.6",
+		"@alepha/server-cookies": "0.10.6",
+		"@alepha/server-cors": "0.10.6",
+		"@alepha/server-health": "0.10.6",
+		"@alepha/server-helmet": "0.10.6",
+		"@alepha/server-links": "0.10.6",
+		"@alepha/server-metrics": "0.10.6",
+		"@alepha/server-multipart": "0.10.6",
+		"@alepha/server-proxy": "0.10.6",
+		"@alepha/server-security": "0.10.6",
+		"@alepha/server-static": "0.10.6",
+		"@alepha/server-swagger": "0.10.6",
+		"@alepha/topic": "0.10.6",
+		"@alepha/topic-redis": "0.10.6",
+		"@alepha/vite": "0.10.6"
 	},
 	"devDependencies": {
-		"tsdown": "^0.15.6"
+		"tsdown": "^0.15.7"
 	},
 	"scripts": {
 		"build": "node build.ts"

package/postgres.d.ts

@@ -116,14 +116,14 @@ declare const schemaToPgColumns: <T extends TObject>(schema: T) => FromSchema<T>
  * @param value The value of the field.
  * @returns The PG column.
  */
-declare const mapFieldToColumn: (name: string, value: TSchema$1) => pg$1.PgSerialBuilderInitial<string> | pg$1.PgIntegerBuilderInitial<string> | drizzle_orm6.IsIdentity<pg$1.PgBigInt64BuilderInitial<"">, "byDefault"> | drizzle_orm6.IsIdentity<pg$1.PgBigInt64BuilderInitial<"">, "always"> | pg$1.PgBigInt53BuilderInitial<string> | pg$1.PgNumericBuilderInitial<string> | pg$1.PgTimestampBuilderInitial<string> | pg$1.PgUUIDBuilderInitial<string> | pg$1.PgCustomColumnBuilder<{
+declare const mapFieldToColumn: (name: string, value: TSchema$1) => pg$1.PgSerialBuilderInitial<string> | pg$1.PgIntegerBuilderInitial<string> | drizzle_orm6.IsIdentity<pg$1.PgBigInt64BuilderInitial<"">, "byDefault"> | drizzle_orm6.IsIdentity<pg$1.PgBigInt64BuilderInitial<"">, "always"> | pg$1.PgBigInt53BuilderInitial<string> | pg$1.PgNumericBuilderInitial<string> | pg$1.PgDateStringBuilderInitial<string> | pg$1.PgUUIDBuilderInitial<string> | pg$1.PgCustomColumnBuilder<{
   name: string;
   dataType: "custom";
   columnType: "PgCustomColumn";
   data: Buffer<ArrayBufferLike>;
   driverParam: unknown;
   enumValues: undefined;
-}> | pg$1.PgTimestampStringBuilderInitial<string> | pg$1.PgDateStringBuilderInitial<string> | pg$1.PgTextBuilderInitial<string, [string, ...string[]]> | pg$1.PgBooleanBuilderInitial<string> | drizzle_orm6.$Type<pg$1.PgCustomColumnBuilder<{
+}> | pg$1.PgTimestampStringBuilderInitial<string> | pg$1.PgTextBuilderInitial<string, [string, ...string[]]> | pg$1.PgBooleanBuilderInitial<string> | drizzle_orm6.$Type<pg$1.PgCustomColumnBuilder<{
   name: string;
   dataType: "custom";
   columnType: "PgCustomColumn";
@@ -251,14 +251,14 @@ declare const mapFieldToColumn: (name: string, value: TSchema$1) => pg$1.PgSeria
  * @param key The key of the field.
  * @param value The value of the field.
  */
-declare const mapStringToColumn: (key: string, value: TSchema$1) => pg$1.PgUUIDBuilderInitial<string> | pg$1.PgCustomColumnBuilder<{
+declare const mapStringToColumn: (key: string, value: TSchema$1) => pg$1.PgDateStringBuilderInitial<string> | pg$1.PgUUIDBuilderInitial<string> | pg$1.PgCustomColumnBuilder<{
   name: string;
   dataType: "custom";
   columnType: "PgCustomColumn";
   data: Buffer<ArrayBufferLike>;
   driverParam: unknown;
   enumValues: undefined;
-}> | pg$1.PgTimestampStringBuilderInitial<string> | pg$1.PgDateStringBuilderInitial<string> | pg$1.PgTextBuilderInitial<string, [string, ...string[]]>;
+}> | pg$1.PgTimestampStringBuilderInitial<string> | pg$1.PgTextBuilderInitial<string, [string, ...string[]]>;
 declare const camelToSnakeCase: (str: string) => string;
 /**
  * Convert a schema to columns.
@@ -767,6 +767,26 @@ declare class PgError extends AlephaError {
 }
 //#endregion
 //#region src/helpers/pgAttr.d.ts
+/**
+ * Decorates a typebox schema with a Postgres attribute.
+ *
+ * > It's just a fancy way to add Symbols to a field.
+ *
+ * @example
+ * ```ts
+ * import { t } from "alepha";
+ * import { PG_UPDATED_AT } from "../constants/PG_SYMBOLS";
+ *
+ * export const updatedAtSchema = pgAttr(
+ *   t.datetime(), PG_UPDATED_AT,
+ * );
+ * ```
+ */
+declare const pgAttr: <T extends TSchema$1, Attr extends PgSymbolKeys>(type: T, attr: Attr, value?: PgSymbols[Attr]) => PgAttr<T, Attr>;
+/**
+ * Retrieves the fields of a schema that have a specific attribute.
+ */
+declare const getAttrFields: (schema: TObject, name: PgSymbolKeys) => PgAttrField[];
 /**
  * Type representation.
  */
@@ -2248,6 +2268,12 @@ interface TransactionDescriptorOptions<T extends any[], R> {
 }
 type TransactionContext = PgTransaction<any, any, any>;
 //#endregion
+//#region src/errors/PgConflictError.d.ts
+declare class PgConflictError extends PgError {
+  readonly name = "PgConflictError";
+  readonly status = 409;
+}
+//#endregion
 //#region src/errors/PgEntityNotFoundError.d.ts
 declare class PgEntityNotFoundError extends PgError {
   readonly name = "EntityNotFoundError";
@@ -2255,6 +2281,23 @@ declare class PgEntityNotFoundError extends PgError {
   constructor(entityName: string);
 }
 //#endregion
+//#region src/errors/PgMigrationError.d.ts
+declare class PgMigrationError extends PgError {
+  readonly name = "PgMigrationError";
+  constructor(cause?: unknown);
+}
+//#endregion
+//#region src/errors/PgVersionMismatchError.d.ts
+/**
+ * Error thrown when there is a version mismatch.
+ * It's thrown by {@link RepositoryDescriptor#save} when the updated entity version does not match the one in the database.
+ * This is used for optimistic concurrency control.
+ */
+declare class PgVersionMismatchError extends PgError {
+  readonly name = "PgVersionMismatchError";
+  constructor(table: string, id: any);
+}
+//#endregion
 //#region src/providers/RepositoryProvider.d.ts
 declare class RepositoryProvider {
   protected readonly log: _alepha_logger1.Logger;
@@ -2540,5 +2583,5 @@ declare const schema: <TDocument extends TSchema$1>(name: string, document: TDoc
  */
 declare const AlephaPostgres: _alepha_core1.Service<_alepha_core1.Module<{}>>;
 //#endregion
-export { $entity, $repository, $sequence, $transaction, AlephaPostgres, DrizzleKitProvider, Entity, EntityDescriptorOptions, ExtractManyRelations, FilterOperators, FromSchema, NodePostgresProvider, NodePostgresProviderOptions, OrderBy, OrderByClause, OrderDirection, PG_CREATED_AT, PG_DEFAULT, PG_DELETED_AT, PG_IDENTITY, PG_MANY, PG_ONE, PG_PRIMARY_KEY, PG_REF, PG_SCHEMA, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, Page, PageQuery, PgDefault, PgEntityNotFoundError, PgIdentityOptions, PgMany, PgManyOptions, PgOne, PgPrimaryKey, PgQuery, PgQueryWhere, PgQueryWhereOrSQL, PgQueryWhereWithMany, PgQueryWhereWithManyOrSQL, PgQueryWithMany, PgQueryWithMap, PgQueryWithOne, PgRef, PgRefOptions, PgSymbolKeys, PgSymbols, PgTableConfig, PgTableWithColumnsAndSchema, PostgresProvider, PostgresTypeProvider, RelField, RemoveManyRelations, RepositoryDescriptor, RepositoryDescriptorOptions, RepositoryProvider, SQLLike, SequenceDescriptor, SequenceDescriptorOptions, StatementOptions, TObjectInsert, TObjectUpdate, TPage, TransactionContext, TransactionDescriptorOptions, camelToSnakeCase, drizzle_orm6 as drizzle, insertSchema, legacyIdSchema, mapFieldToColumn, mapStringToColumn, pageQuerySchema, pageSchema, pg, schema, schemaToPgColumns, sql, updateSchema };
+export { $entity, $repository, $sequence, $transaction, AlephaPostgres, DrizzleKitProvider, Entity, EntityDescriptorOptions, ExtractManyRelations, FilterOperators, FromSchema, NodePostgresProvider, NodePostgresProviderOptions, OrderBy, OrderByClause, OrderDirection, PG_CREATED_AT, PG_DEFAULT, PG_DELETED_AT, PG_IDENTITY, PG_MANY, PG_ONE, PG_PRIMARY_KEY, PG_REF, PG_SCHEMA, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, Page, PageQuery, PgAttr, PgAttrField, PgConflictError, PgDefault, PgEntityNotFoundError, PgError, PgIdentityOptions, PgMany, PgManyOptions, PgMigrationError, PgOne, PgPrimaryKey, PgQuery, PgQueryWhere, PgQueryWhereOrSQL, PgQueryWhereWithMany, PgQueryWhereWithManyOrSQL, PgQueryWithMany, PgQueryWithMap, PgQueryWithOne, PgRef, PgRefOptions, PgSymbolKeys, PgSymbols, PgTableConfig, PgTableWithColumnsAndSchema, PgVersionMismatchError, PostgresProvider, PostgresTypeProvider, RelField, RemoveManyRelations, RepositoryDescriptor, RepositoryDescriptorOptions, RepositoryProvider, SQLLike, SequenceDescriptor, SequenceDescriptorOptions, StatementOptions, TObjectInsert, TObjectUpdate, TPage, TransactionContext, TransactionDescriptorOptions, camelToSnakeCase, drizzle_orm6 as drizzle, getAttrFields, insertSchema, legacyIdSchema, mapFieldToColumn, mapStringToColumn, pageQuerySchema, pageSchema, pg, pgAttr, schema, schemaToPgColumns, sql, updateSchema };
 //# sourceMappingURL=index.d.ts.map

package/react/auth.d.ts

@@ -43,6 +43,11 @@ declare class ReactAuth {
   };
   protected readonly onBeginTransition: _alepha_core4.HookDescriptor<"react:transition:begin">;
   protected readonly onFetchRequest: _alepha_core4.HookDescriptor<"client:onRequest">;
+  /**
+   * Get the current authenticated user.
+   *
+   * Alias for `alepha.state.get("user")`
+   */
   get user(): UserAccountToken | undefined;
   ping(): Promise<{
     name?: string | undefined;

package/react.d.ts

@@ -1,12 +1,12 @@
-import * as _alepha_core5 from "alepha";
+import * as _alepha_core14 from "alepha";
 import { Alepha, Async, Descriptor, Hooks, KIND, Service, State, Static, TObject, TSchema } from "alepha";
 import { RequestConfigSchema, ServerHandler, ServerProvider, ServerRequest, ServerRouterProvider, ServerTimingProvider } from "alepha/server";
 import { ServerRouteCache } from "alepha/server/cache";
 import { ClientScope, HttpVirtualClient, LinkProvider, VirtualAction } from "alepha/server/links";
-import * as _alepha_logger0 from "alepha/logger";
+import * as _alepha_logger1 from "alepha/logger";
 import * as react0 from "react";
 import React, { AnchorHTMLAttributes, CSSProperties, ErrorInfo, FC, PropsWithChildren, ReactNode } from "react";
-import * as react_jsx_runtime1 from "react/jsx-runtime";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
 import { ServerStaticProvider } from "alepha/server/static";
 import { DateTimeProvider } from "alepha/datetime";
 import { Route, RouterProvider } from "alepha/router";
@@ -40,14 +40,14 @@ declare class Redirection extends Error {
 }
 //#endregion
 //#region src/providers/ReactPageProvider.d.ts
-declare const envSchema$2: _alepha_core5.TObject<{
-  REACT_STRICT_MODE: _alepha_core5.TBoolean;
+declare const envSchema$2: _alepha_core14.TObject<{
+  REACT_STRICT_MODE: _alepha_core14.TBoolean;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$2>> {}
 }
 declare class ReactPageProvider {
-  protected readonly log: _alepha_logger0.Logger;
+  protected readonly log: _alepha_logger1.Logger;
   protected readonly env: {
     REACT_STRICT_MODE: boolean;
   };
@@ -83,7 +83,7 @@ declare class ReactPageProvider {
   }, params?: Record<string, any>): string;
   compile(path: string, params?: Record<string, string>): string;
   protected renderView(index: number, path: string, view: ReactNode | undefined, page: PageRoute): ReactNode;
-  protected readonly configure: _alepha_core5.HookDescriptor<"configure">;
+  protected readonly configure: _alepha_core14.HookDescriptor<"configure">;
   protected map(pages: Array<PageDescriptor>, target: PageDescriptor): PageRouteEntry;
   add(entry: PageRouteEntry): void;
   protected createMatch(page: PageRoute): string;
@@ -489,18 +489,18 @@ interface BrowserRoute extends Route {
   page: PageRoute;
 }
 declare class ReactBrowserRouterProvider extends RouterProvider<BrowserRoute> {
-  protected readonly log: _alepha_logger0.Logger;
+  protected readonly log: _alepha_logger1.Logger;
   protected readonly alepha: Alepha;
   protected readonly pageApi: ReactPageProvider;
   add(entry: PageRouteEntry): void;
-  protected readonly configure: _alepha_core5.HookDescriptor<"configure">;
+  protected readonly configure: _alepha_core14.HookDescriptor<"configure">;
   transition(url: URL, previous?: PreviousLayerData[], meta?: {}): Promise<string | void>;
   root(state: ReactRouterState): ReactNode;
 }
 //#endregion
 //#region src/providers/ReactBrowserProvider.d.ts
-declare const envSchema$1: _alepha_core5.TObject<{
-  REACT_ROOT_ID: _alepha_core5.TString;
+declare const envSchema$1: _alepha_core14.TObject<{
+  REACT_ROOT_ID: _alepha_core14.TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$1>> {}
@@ -512,7 +512,7 @@ declare class ReactBrowserProvider {
   protected readonly env: {
     REACT_ROOT_ID: string;
   };
-  protected readonly log: _alepha_logger0.Logger;
+  protected readonly log: _alepha_logger1.Logger;
   protected readonly client: LinkProvider;
   protected readonly alepha: Alepha;
   protected readonly router: ReactBrowserRouterProvider;
@@ -546,8 +546,8 @@ declare class ReactBrowserProvider {
    * Get embedded layers from the server.
    */
   protected getHydrationState(): ReactHydrationState | undefined;
-  protected readonly onTransitionEnd: _alepha_core5.HookDescriptor<"react:transition:end">;
-  readonly ready: _alepha_core5.HookDescriptor<"ready">;
+  protected readonly onTransitionEnd: _alepha_core14.HookDescriptor<"react:transition:end">;
+  readonly ready: _alepha_core14.HookDescriptor<"ready">;
 }
 interface RouterGoOptions {
   replace?: boolean;
@@ -619,25 +619,25 @@ interface ErrorViewerProps {
 declare const ErrorViewer: ({
   error,
   alepha
-}: ErrorViewerProps) => react_jsx_runtime1.JSX.Element;
+}: ErrorViewerProps) => react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/Link.d.ts
 interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
   href: string;
 }
-declare const Link: (props: LinkProps) => react_jsx_runtime1.JSX.Element;
+declare const Link: (props: LinkProps) => react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/NestedView.d.ts
 interface NestedViewProps {
   children?: ReactNode;
   errorBoundary?: false | ((error: Error) => ReactNode);
 }
-declare const _default: react0.MemoExoticComponent<(props: NestedViewProps) => react_jsx_runtime1.JSX.Element>;
+declare const _default: react0.MemoExoticComponent<(props: NestedViewProps) => react_jsx_runtime0.JSX.Element>;
 //#endregion
 //#region src/components/NotFound.d.ts
 declare function NotFoundPage(props: {
   style?: CSSProperties;
-}): react_jsx_runtime1.JSX.Element;
+}): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/contexts/AlephaContext.d.ts
 declare const AlephaContext: react0.Context<Alepha | undefined>;
@@ -800,12 +800,12 @@ declare const ssrSchemaLoading: (alepha: Alepha, name: string) => RequestConfigS
 declare const useStore: <Key extends keyof State>(key: Key, defaultValue?: State[Key]) => [State[Key], (value: State[Key]) => void];
 //#endregion
 //#region src/providers/ReactServerProvider.d.ts
-declare const envSchema: _alepha_core5.TObject<{
-  REACT_SERVER_DIST: _alepha_core5.TString;
-  REACT_SERVER_PREFIX: _alepha_core5.TString;
-  REACT_SSR_ENABLED: _alepha_core5.TOptional<_alepha_core5.TBoolean>;
-  REACT_ROOT_ID: _alepha_core5.TString;
-  REACT_SERVER_TEMPLATE: _alepha_core5.TOptional<_alepha_core5.TString>;
+declare const envSchema: _alepha_core14.TObject<{
+  REACT_SERVER_DIST: _alepha_core14.TString;
+  REACT_SERVER_PREFIX: _alepha_core14.TString;
+  REACT_SSR_ENABLED: _alepha_core14.TOptional<_alepha_core14.TBoolean>;
+  REACT_ROOT_ID: _alepha_core14.TString;
+  REACT_SERVER_TEMPLATE: _alepha_core14.TOptional<_alepha_core14.TString>;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
@@ -814,7 +814,7 @@ declare module "alepha" {
   }
 }
 declare class ReactServerProvider {
-  protected readonly log: _alepha_logger0.Logger;
+  protected readonly log: _alepha_logger1.Logger;
   protected readonly alepha: Alepha;
   protected readonly pageApi: ReactPageProvider;
   protected readonly serverProvider: ServerProvider;
@@ -824,13 +824,13 @@ declare class ReactServerProvider {
   protected readonly env: {
     REACT_SSR_ENABLED?: boolean | undefined;
     REACT_SERVER_TEMPLATE?: string | undefined;
-    REACT_ROOT_ID: string;
     REACT_SERVER_DIST: string;
     REACT_SERVER_PREFIX: string;
+    REACT_ROOT_ID: string;
   };
   protected readonly ROOT_DIV_REGEX: RegExp;
   protected preprocessedTemplate: PreprocessedTemplate | null;
-  readonly onConfigure: _alepha_core5.HookDescriptor<"configure">;
+  readonly onConfigure: _alepha_core14.HookDescriptor<"configure">;
   get template(): string;
   protected registerPages(templateLoader: TemplateLoader): Promise<void>;
   protected getPublicDirectory(): string;
@@ -903,7 +903,7 @@ declare module "alepha" {
  * @see {@link $page}
  * @module alepha.react
  */
-declare const AlephaReact: _alepha_core5.Service<_alepha_core5.Module<{}>>;
+declare const AlephaReact: _alepha_core14.Service<_alepha_core14.Module<{}>>;
 //#endregion
 export { $page, AlephaContext, AlephaReact, AnchorProps, ClientOnly, CreateLayersResult, ErrorBoundary, ErrorHandler, ErrorViewer, Layer, Link, LinkProps, _default as NestedView, NotFoundPage as NotFound, PageAnimation, PageConfigSchema, PageDescriptor, PageDescriptorOptions, PageDescriptorRenderOptions, PageDescriptorRenderResult, PageRequestConfig, PageResolve, PageRoute, PageRouteEntry, PreviousLayerData, ReactBrowserProvider, ReactBrowserRendererOptions, ReactHydrationState, ReactPageProvider, ReactRouter, ReactRouterState, ReactServerProvider, Redirection, RouterGoOptions, RouterLayerContext, RouterLayerContextValue, RouterRenderOptions, RouterStackItem, TPropsDefault, TPropsParentDefault, TransitionOptions, UseActiveHook, UseActiveOptions, UseQueryParamsHookOptions, UseSchemaReturn, VirtualRouter, isPageRoute, ssrSchemaLoading, useActive, useAlepha, useClient, useInject, useQueryParams, useRouter, useRouterEvents, useRouterState, useSchema, useStore };
 //# sourceMappingURL=index.d.ts.map

package/security.d.ts

@@ -1,6 +1,6 @@
 import * as _alepha_core1 from "alepha";
 import { Alepha, Descriptor, KIND, Static } from "alepha";
-import * as _alepha_logger0 from "alepha/logger";
+import * as _alepha_logger1 from "alepha/logger";
 import { DateTimeProvider, Duration, DurationLike } from "alepha/datetime";
 import { CryptoKey, FlattenedJWSInput, JSONWebKeySet, JWSHeaderParameters, JWTHeaderParameters, JWTPayload, JWTVerifyResult, KeyObject } from "jose";
 import * as typebox0 from "typebox";
@@ -68,7 +68,7 @@ type Role = Static<typeof roleSchema>;
  * Provides utilities for working with JSON Web Tokens (JWT).
  */
 declare class JwtProvider {
-  protected readonly log: _alepha_logger0.Logger;
+  protected readonly log: _alepha_logger1.Logger;
   protected readonly keystore: KeyLoaderHolder[];
   protected readonly dateTimeProvider: DateTimeProvider;
   protected readonly encoder: TextEncoder;
@@ -140,7 +140,7 @@ declare class SecurityProvider {
   protected readonly UNKNOWN_USER_NAME = "Anonymous User";
   protected readonly PERMISSION_REGEXP: RegExp;
   protected readonly PERMISSION_REGEXP_WILDCARD: RegExp;
-  protected readonly log: _alepha_logger0.Logger;
+  protected readonly log: _alepha_logger1.Logger;
   protected readonly jwt: JwtProvider;
   protected readonly env: {
     APP_SECRET: string;
@@ -199,9 +199,6 @@ declare class SecurityProvider {
   checkPermission(permissionLike: string | Permission, ...roleEntries: string[]): SecurityCheckResult;
   /**
    * Creates a user account from the provided payload.
-   *
-   * @param headerOrToken
-   * @param permissionLike
    */
   createUserFromToken(headerOrToken?: string, options?: {
     permission?: Permission | string;
@@ -402,7 +399,7 @@ declare class RealmDescriptor extends Descriptor<RealmDescriptorOptions> {
   protected readonly securityProvider: SecurityProvider;
   protected readonly dateTimeProvider: DateTimeProvider;
   protected readonly jwt: JwtProvider;
-  protected readonly log: _alepha_logger0.Logger;
+  protected readonly log: _alepha_logger1.Logger;
   get name(): string;
   get accessTokenExpiration(): Duration;
   get refreshTokenExpiration(): Duration;

package/server/cache.d.ts

@@ -9,8 +9,22 @@ import { RequestConfigSchema, ServerRequest, ServerRoute } from "alepha/server";
 //#region src/providers/ServerCacheProvider.d.ts
 declare module "alepha/server" {
   interface ServerRoute {
+    /**
+     * Enable caching for this route.
+     * If set to true, a default cache configuration will be applied (5 minutes TTL).
+     * If a DurationLike is provided, it will be used as the TTL for the cache.
+     *
+     * @default false
+     */
     cache?: ServerRouteCache;
-    etag?: string;
+    /**
+     * Enable ETag support for this route.
+     * If set to true, the server will generate and manage ETags automatically.
+     * If a string is provided, it will be used as a static ETag value.
+     *
+     * @default false
+     */
+    etag?: boolean | string;
   }
   interface ActionDescriptor<TConfig extends RequestConfigSchema> {
     invalidate: () => Promise<void>;
@@ -26,13 +40,8 @@ declare class ServerCacheProvider {
   protected readonly onActionRequest: _alepha_core1.HookDescriptor<"action:onRequest">;
   protected readonly onActionResponse: _alepha_core1.HookDescriptor<"action:onResponse">;
   protected readonly onRequest: _alepha_core1.HookDescriptor<"server:onRequest">;
+  protected readonly onSend: _alepha_core1.HookDescriptor<"server:onSend">;
   protected readonly onResponse: _alepha_core1.HookDescriptor<"server:onResponse">;
-  protected getCacheOptions(cache: ServerRouteCache): {
-    provider?: (_alepha_core1.InstantiableClass<_alepha_cache0.CacheProvider> | "memory") | undefined;
-    name?: string | undefined;
-    ttl?: DurationLike | undefined;
-    disabled?: boolean | undefined;
-  };
   protected createCacheKey(route: ServerRoute, config?: ServerRequest): string;
 }
 type ServerRouteCache = boolean | DurationLike | Omit<CacheDescriptorOptions<any>, "handler" | "key">;