alepha 0.10.5 → 0.10.6

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "alepha",
-	"version": "0.10.5",
+	"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.5",
-		"@alepha/api-jobs": "0.10.5",
-		"@alepha/api-users": "0.10.5",
-		"@alepha/batch": "0.10.5",
-		"@alepha/bucket": "0.10.5",
-		"@alepha/cache": "0.10.5",
-		"@alepha/cache-redis": "0.10.5",
-		"@alepha/command": "0.10.5",
-		"@alepha/core": "0.10.5",
-		"@alepha/datetime": "0.10.5",
-		"@alepha/devtools": "0.10.5",
-		"@alepha/email": "0.10.5",
-		"@alepha/file": "0.10.5",
-		"@alepha/lock": "0.10.5",
-		"@alepha/lock-redis": "0.10.5",
-		"@alepha/logger": "0.10.5",
-		"@alepha/postgres": "0.10.5",
-		"@alepha/queue": "0.10.5",
-		"@alepha/queue-redis": "0.10.5",
-		"@alepha/react": "0.10.5",
-		"@alepha/react-auth": "0.10.5",
-		"@alepha/react-form": "0.10.5",
-		"@alepha/react-head": "0.10.5",
-		"@alepha/react-i18n": "0.10.5",
-		"@alepha/redis": "0.10.5",
-		"@alepha/retry": "0.10.5",
-		"@alepha/router": "0.10.5",
-		"@alepha/scheduler": "0.10.5",
-		"@alepha/security": "0.10.5",
-		"@alepha/server": "0.10.5",
-		"@alepha/server-cache": "0.10.5",
-		"@alepha/server-compress": "0.10.5",
-		"@alepha/server-cookies": "0.10.5",
-		"@alepha/server-cors": "0.10.5",
-		"@alepha/server-health": "0.10.5",
-		"@alepha/server-helmet": "0.10.5",
-		"@alepha/server-links": "0.10.5",
-		"@alepha/server-metrics": "0.10.5",
-		"@alepha/server-multipart": "0.10.5",
-		"@alepha/server-proxy": "0.10.5",
-		"@alepha/server-security": "0.10.5",
-		"@alepha/server-static": "0.10.5",
-		"@alepha/server-swagger": "0.10.5",
-		"@alepha/topic": "0.10.5",
-		"@alepha/topic-redis": "0.10.5",
-		"@alepha/vite": "0.10.5"
+		"@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

@@ -1,6 +1,6 @@
 import * as _alepha_core1 from "alepha";
 import { Alepha, AlephaError, Descriptor, KIND, Service, Static, TArray, TBigInt, TBoolean, TInteger, TNull, TNumber, TNumberOptions, TObject, TObjectOptions, TOptional, TOptionalAdd, TRecord, TSchema as TSchema$1, TString, TStringOptions, TUnion } from "alepha";
-import * as drizzle_orm7 from "drizzle-orm";
+import * as drizzle_orm6 from "drizzle-orm";
 import { BuildColumns, BuildExtraConfigColumns, SQL, SQLWrapper, TableConfig, sql } from "drizzle-orm";
 import * as pg$1 from "drizzle-orm/pg-core";
 import { AnyPgColumn, AnyPgTable, LockConfig, LockStrength, PgColumn, PgColumnBuilderBase, PgDatabase, PgInsertValue, PgSequenceOptions, PgTableExtraConfigValue, PgTableWithColumns, PgTransaction, PgTransactionConfig, SelectedFields, TableConfig as TableConfig$1, UpdateDeleteAction } from "drizzle-orm/pg-core";
@@ -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_orm7.IsIdentity<pg$1.PgBigInt64BuilderInitial<"">, "byDefault"> | drizzle_orm7.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_orm7.$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";
@@ -138,14 +138,14 @@ declare const mapFieldToColumn: (name: string, value: TSchema$1) => pg$1.PgSeria
   [x: string]: unknown;
   [x: number]: unknown;
   [x: symbol]: unknown;
-}> | drizzle_orm7.$Type<pg$1.PgCustomColumnBuilder<{
+}> | drizzle_orm6.$Type<pg$1.PgCustomColumnBuilder<{
   name: string;
   dataType: "custom";
   columnType: "PgCustomColumn";
   data: Record<string, unknown>;
   driverParam: string;
   enumValues: undefined;
-}>, Record<string, unknown>> | drizzle_orm7.$Type<pg$1.PgCustomColumnBuilder<{
+}>, Record<string, unknown>> | 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.
@@ -1505,7 +1505,7 @@ declare class RepositoryDescriptor<EntityTableConfig extends TableConfig, Entity
   /**
    * Getter for the database connection from the database provider.
    */
-  protected get db(): PgDatabase<any, Record<string, never>, drizzle_orm7.ExtractTablesWithRelations<Record<string, never>>>;
+  protected get db(): PgDatabase<any, Record<string, never>, drizzle_orm6.ExtractTablesWithRelations<Record<string, never>>>;
   /**
    * Execute a SQL query.
    */
@@ -1530,10 +1530,10 @@ declare class RepositoryDescriptor<EntityTableConfig extends TableConfig, Entity
    *
    * @returns The SELECT query builder.
    */
-  protected select(opts?: StatementOptions): pg$1.PgSelectBase<string, Record<string, PgColumn<drizzle_orm7.ColumnBaseConfig<drizzle_orm7.ColumnDataType, string>, {}, {}>>, "single", Record<string, "not-null">, false, never, {
+  protected select(opts?: StatementOptions): pg$1.PgSelectBase<string, Record<string, PgColumn<drizzle_orm6.ColumnBaseConfig<drizzle_orm6.ColumnDataType, string>, {}, {}>>, "single", Record<string, "not-null">, false, never, {
     [x: string]: unknown;
   }[], {
-    [x: string]: PgColumn<drizzle_orm7.ColumnBaseConfig<drizzle_orm7.ColumnDataType, string>, {}, {}>;
+    [x: string]: PgColumn<drizzle_orm6.ColumnBaseConfig<drizzle_orm6.ColumnDataType, string>, {}, {}>;
   }>;
   protected selectDistinct(opts: StatementOptions | undefined, fields: SelectedFields): pg$1.PgSelectBase<string, SelectedFields, "partial", Record<string, "not-null">, false, never, {
     [x: string]: unknown;
@@ -1750,7 +1750,7 @@ declare class RepositoryDescriptor<EntityTableConfig extends TableConfig, Entity
    */
   protected getPrimaryKey(schema: TObject): {
     key: string;
-    col: PgColumn<drizzle_orm7.ColumnBaseConfig<drizzle_orm7.ColumnDataType, string>, {}, {}>;
+    col: PgColumn<drizzle_orm6.ColumnBaseConfig<drizzle_orm6.ColumnDataType, string>, {}, {}>;
     type: TSchema$1;
   };
 }
@@ -2268,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";
@@ -2275,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;
@@ -2508,7 +2531,7 @@ declare const legacyIdSchema: PgAttr<PgAttr<PgAttr<typebox1.TInteger, typeof PG_
 /**
  * Postgres schema type.
  */
-declare const schema: <TDocument extends TSchema$1>(name: string, document: TDocument) => drizzle_orm7.$Type<pg$1.PgCustomColumnBuilder<{
+declare const schema: <TDocument extends TSchema$1>(name: string, document: TDocument) => drizzle_orm6.$Type<pg$1.PgCustomColumnBuilder<{
   name: string;
   dataType: "custom";
   columnType: "PgCustomColumn";
@@ -2560,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, PgAttr, PgAttrField, 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_orm7 as drizzle, getAttrFields, insertSchema, legacyIdSchema, mapFieldToColumn, mapStringToColumn, pageQuerySchema, pageSchema, pg, pgAttr, 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.d.ts

@@ -1,10 +1,10 @@
-import * as _alepha_core10 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 react1 from "react";
+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_runtime0 from "react/jsx-runtime";
 import { ServerStaticProvider } from "alepha/server/static";
@@ -40,14 +40,14 @@ declare class Redirection extends Error {
 }
 //#endregion
 //#region src/providers/ReactPageProvider.d.ts
-declare const envSchema$2: _alepha_core10.TObject<{
-  REACT_STRICT_MODE: _alepha_core10.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_core10.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_core10.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_core10.TObject<{
-  REACT_ROOT_ID: _alepha_core10.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_core10.HookDescriptor<"react:transition:end">;
-  readonly ready: _alepha_core10.HookDescriptor<"ready">;
+  protected readonly onTransitionEnd: _alepha_core14.HookDescriptor<"react:transition:end">;
+  readonly ready: _alepha_core14.HookDescriptor<"ready">;
 }
 interface RouterGoOptions {
   replace?: boolean;
@@ -632,7 +632,7 @@ interface NestedViewProps {
   children?: ReactNode;
   errorBoundary?: false | ((error: Error) => ReactNode);
 }
-declare const _default: react1.MemoExoticComponent<(props: NestedViewProps) => react_jsx_runtime0.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: {
@@ -640,14 +640,14 @@ declare function NotFoundPage(props: {
 }): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/contexts/AlephaContext.d.ts
-declare const AlephaContext: react1.Context<Alepha | undefined>;
+declare const AlephaContext: react0.Context<Alepha | undefined>;
 //#endregion
 //#region src/contexts/RouterLayerContext.d.ts
 interface RouterLayerContextValue {
   index: number;
   path: string;
 }
-declare const RouterLayerContext: react1.Context<RouterLayerContextValue | undefined>;
+declare const RouterLayerContext: react0.Context<RouterLayerContextValue | undefined>;
 //#endregion
 //#region src/hooks/useActive.d.ts
 interface UseActiveOptions {
@@ -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_core10.TObject<{
-  REACT_SERVER_DIST: _alepha_core10.TString;
-  REACT_SERVER_PREFIX: _alepha_core10.TString;
-  REACT_SSR_ENABLED: _alepha_core10.TOptional<_alepha_core10.TBoolean>;
-  REACT_ROOT_ID: _alepha_core10.TString;
-  REACT_SERVER_TEMPLATE: _alepha_core10.TOptional<_alepha_core10.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;
@@ -830,7 +830,7 @@ declare class ReactServerProvider {
   };
   protected readonly ROOT_DIV_REGEX: RegExp;
   protected preprocessedTemplate: PreprocessedTemplate | null;
-  readonly onConfigure: _alepha_core10.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_core10.Service<_alepha_core10.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">;

package/server/links.d.ts

@@ -1,4 +1,4 @@
-import "alepha/server/security";
+import { ServerRouteSecure } from "alepha/server/security";
 import * as _alepha_core2 from "alepha";
 import { Alepha, Descriptor, KIND, Static } from "alepha";
 import * as _alepha_server0 from "alepha/server";
@@ -7,26 +7,26 @@ import * as _alepha_logger0 from "alepha/logger";
 import * as _alepha_retry0 from "alepha/retry";
 import { ProxyDescriptorOptions, ServerProxyProvider } from "alepha/server/proxy";
 import { ServiceAccountDescriptor, UserAccountToken } from "alepha/security";
-import * as typebox0 from "typebox";
+import * as typebox18 from "typebox";
 
 //#region src/schemas/apiLinksResponseSchema.d.ts
-declare const apiLinkSchema: typebox0.TObject<{
-  name: typebox0.TString;
-  group: typebox0.TOptional<typebox0.TString>;
-  path: typebox0.TString;
-  method: typebox0.TOptional<typebox0.TString>;
-  requestBodyType: typebox0.TOptional<typebox0.TString>;
-  service: typebox0.TOptional<typebox0.TString>;
+declare const apiLinkSchema: typebox18.TObject<{
+  name: typebox18.TString;
+  group: typebox18.TOptional<typebox18.TString>;
+  path: typebox18.TString;
+  method: typebox18.TOptional<typebox18.TString>;
+  requestBodyType: typebox18.TOptional<typebox18.TString>;
+  service: typebox18.TOptional<typebox18.TString>;
 }>;
-declare const apiLinksResponseSchema: typebox0.TObject<{
-  prefix: typebox0.TOptional<typebox0.TString>;
-  links: typebox0.TArray<typebox0.TObject<{
-    name: typebox0.TString;
-    group: typebox0.TOptional<typebox0.TString>;
-    path: typebox0.TString;
-    method: typebox0.TOptional<typebox0.TString>;
-    requestBodyType: typebox0.TOptional<typebox0.TString>;
-    service: typebox0.TOptional<typebox0.TString>;
+declare const apiLinksResponseSchema: typebox18.TObject<{
+  prefix: typebox18.TOptional<typebox18.TString>;
+  links: typebox18.TArray<typebox18.TObject<{
+    name: typebox18.TString;
+    group: typebox18.TOptional<typebox18.TString>;
+    path: typebox18.TString;
+    method: typebox18.TOptional<typebox18.TString>;
+    requestBodyType: typebox18.TOptional<typebox18.TString>;
+    service: typebox18.TOptional<typebox18.TString>;
   }>>;
 }>;
 type ApiLinksResponse = Static<typeof apiLinksResponseSchema>;
@@ -81,7 +81,7 @@ declare class LinkProvider {
   protected getLinkByName(name: string, options?: ClientScope): Promise<HttpClientLink>;
 }
 interface HttpClientLink extends ApiLink {
-  secured?: boolean;
+  secured?: boolean | ServerRouteSecure;
   prefix?: string;
   host?: string;
   service?: string;
@@ -257,15 +257,15 @@ declare class ServerLinksProvider {
    * This is based on the user's permissions.
    */
   readonly links: _alepha_server0.RouteDescriptor<{
-    response: typebox0.TObject<{
-      prefix: typebox0.TOptional<typebox0.TString>;
-      links: typebox0.TArray<typebox0.TObject<{
-        name: typebox0.TString;
-        group: typebox0.TOptional<typebox0.TString>;
-        path: typebox0.TString;
-        method: typebox0.TOptional<typebox0.TString>;
-        requestBodyType: typebox0.TOptional<typebox0.TString>;
-        service: typebox0.TOptional<typebox0.TString>;
+    response: typebox18.TObject<{
+      prefix: typebox18.TOptional<typebox18.TString>;
+      links: typebox18.TArray<typebox18.TObject<{
+        name: typebox18.TString;
+        group: typebox18.TOptional<typebox18.TString>;
+        path: typebox18.TString;
+        method: typebox18.TOptional<typebox18.TString>;
+        requestBodyType: typebox18.TOptional<typebox18.TString>;
+        service: typebox18.TOptional<typebox18.TString>;
       }>>;
     }>;
   }>;
@@ -276,10 +276,10 @@ declare class ServerLinksProvider {
    * I mean for 150+ links, you got 50ms of serialization time.
    */
   readonly schema: _alepha_server0.RouteDescriptor<{
-    params: typebox0.TObject<{
-      name: typebox0.TString;
+    params: typebox18.TObject<{
+      name: typebox18.TString;
     }>;
-    response: typebox0.TRecord<string, typebox0.TAny>;
+    response: typebox18.TRecord<string, typebox18.TAny>;
   }>;
   getSchemaByName(name: string, options?: GetApiLinksOptions): Promise<RequestConfigSchema>;
   /**

package/server/security.d.ts

@@ -13,6 +13,7 @@ declare class ServerSecurityProvider {
   protected readonly onConfigure: _alepha_core1.HookDescriptor<"configure">;
   protected readonly onActionRequest: _alepha_core1.HookDescriptor<"action:onRequest">;
   protected readonly onRequest: _alepha_core1.HookDescriptor<"server:onRequest">;
+  protected check(user: UserAccountToken, secure: ServerRouteSecure): void;
   /**
    * Get the user account token for a local action call.
    * There are three possible sources for the user:
@@ -30,11 +31,8 @@ declare class ServerSecurityProvider {
   protected createTestUser(): UserAccountToken;
   protected readonly onClientRequest: _alepha_core1.HookDescriptor<"client:onRequest">;
 }
-type ServerRouteSecure = boolean | {
-  permissions?: string[];
-  roles?: string[];
-  realms?: string[];
-  organizations?: string[];
+type ServerRouteSecure = {
+  realm?: string;
 };
 //#endregion
 //#region src/index.d.ts
@@ -62,7 +60,7 @@ declare module "alepha/server" {
      * 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;
+    secure?: boolean | ServerRouteSecure;
   }
   interface ClientRequestOptions extends FetchOptions {
     /**