alepha 0.7.4 → 0.7.5

package/README.md

@@ -1,21 +1,44 @@
 <div align="center">
 
-<img src="./assets/logo.png" alt="Logo" style="width: 256px"/>
-
-<h1>Alepha</h1>
-
+<h1 >
+<img
+	src="https://raw.githubusercontent.com/feunard/alepha/main/assets/logo.png"
+	width="128"
+	height="128"
+	alt="Logo"
+  valign="middle"
+/>
+Alepha
+</h1>
 <p style="max-width: 512px">
 🚧
 </p>
-
+<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/v/alepha.svg" alt="npm"/></a>
+<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/l/alepha.svg" alt="npm"/></a>
+<a href="https://codecov.io/gh/feunard/alepha"><img src="https://codecov.io/gh/feunard/alepha/graph/badge.svg?token=ZDLWI514CP" alt="npm"/></a>
+<a href="https://www.npmjs.com/package/alepha"><img src="https://img.shields.io/npm/dt/alepha.svg" alt="npm"/></a>
+<a href="https://github.com/feunard/alepha"><img src="https://img.shields.io/github/stars/feunard/alepha.svg?style=social" alt="GitHub stars"/></a>
 </div>
 
-[![npm](https://img.shields.io/npm/v/alepha.svg)](https://www.npmjs.com/package/alepha)
-[![license](https://img.shields.io/npm/l/alepha.svg)](https://www.npmjs.com/package/alepha)
-[![downloads](https://img.shields.io/npm/dt/alepha.svg)](https://www.npmjs.com/package/alepha)
-
 ## Installation
 
 ```bash
 npm install alepha
 ```
+
+## Usage
+
+Minimalist http server with a single endpoint.
+
+```ts
+import { run } from "alepha";
+import { $action } from "alepha/server";
+
+class App {
+  hello = $action({
+    handler: () => "Hello world!",
+  })
+}
+
+run(App);
+```

package/cache/redis.d.ts

@@ -81,8 +81,8 @@ declare class RedisCacheProvider implements CacheProvider {
         REDIS_CACHE_PREFIX?: string | undefined;
     };
     protected readonly alepha: Alepha;
-    get(name: string, key: string): Promise<Buffer | undefined>;
-    set(name: string, key: string, value: Buffer | string, ttl?: number): Promise<Buffer>;
+    get(name: string, key: string): Promise<Uint8Array | undefined>;
+    set(name: string, key: string, value: Uint8Array | string, ttl?: number): Promise<Uint8Array>;
     del(name: string, ...keys: string[]): Promise<void>;
     has(name: string, key: string): Promise<boolean>;
     keys(name: string): Promise<string[]>;
@@ -97,9 +97,9 @@ declare class RedisCacheProvider implements CacheProvider {
  * @see {@link RedisCacheProvider}
  * @module alepha.cache.redis
  */
-declare class AlephaRedisCache implements Module {
+declare class AlephaCacheRedis implements Module {
     readonly name = "alepha.cache.redis";
     readonly $services: (alepha: Alepha) => Alepha;
 }
 
-export { AlephaRedisCache, RedisCacheProvider };
+export { AlephaCacheRedis, RedisCacheProvider };

package/cache.d.ts

@@ -6,7 +6,7 @@ import { DurationLike, DateTimeProvider, Timeout } from '@alepha/datetime';
  * Cache provider interface.
  *
  * All methods are asynchronous and return promises.
- * Values are stored as Buffer.
+ * Values are stored as Uint8Array.
  */
 declare abstract class CacheProvider {
     /**
@@ -17,7 +17,7 @@ declare abstract class CacheProvider {
      *
      * @return The value of the key, or undefined if the key does not exist.
      */
-    abstract get(name: string, key: string): Promise<Buffer | undefined>;
+    abstract get(name: string, key: string): Promise<Uint8Array | undefined>;
     /**
      * Set the string value of a key.
      *
@@ -28,7 +28,7 @@ declare abstract class CacheProvider {
      *
      * @return The value of the key.
      */
-    abstract set(name: string, key: string, value: Buffer, ttl?: number): Promise<Buffer>;
+    abstract set(name: string, key: string, value: Uint8Array, ttl?: number): Promise<Uint8Array>;
     /**
      * Remove the specified keys.
      *
@@ -201,15 +201,15 @@ interface TSchema extends TKind, SchemaOptions {
 type CacheName = string;
 type CacheKey = string;
 type CacheValue = {
-    data?: Buffer;
+    data?: Uint8Array;
     timeout?: Timeout;
 };
 declare class MemoryCacheProvider implements CacheProvider {
     protected readonly dateTimeProvider: DateTimeProvider;
     protected readonly log: _alepha_core.Logger;
     protected store: Record<CacheName, Record<CacheKey, CacheValue>>;
-    get(name: string, key: string): Promise<Buffer | undefined>;
-    set(name: string, key: string, value: Buffer, ttl?: number): Promise<Buffer>;
+    get(name: string, key: string): Promise<Uint8Array | undefined>;
+    set(name: string, key: string, value: Uint8Array, ttl?: number): Promise<Uint8Array>;
     del(name: string, ...keys: string[]): Promise<void>;
     has(name: string, key: string): Promise<boolean>;
     keys(name: string): Promise<string[]>;
@@ -273,8 +273,15 @@ declare class CacheDescriptorProvider {
      * @param ttl Override cache.ttl option.
      */
     set<TReturn>(cache: Cache<TReturn>, key: string, value: TReturn, ttl?: DurationLike): Promise<void>;
-    protected serialize<TReturn>(value: TReturn): Buffer;
-    protected deserialize<TReturn>(buffer: Buffer): TReturn;
+    protected encoder: TextEncoder;
+    protected decoder: TextDecoder;
+    protected codes: {
+        BINARY: number;
+        JSON: number;
+        STRING: number;
+    };
+    protected serialize<TReturn>(value: TReturn): Uint8Array;
+    protected deserialize<TReturn>(uint8Array: Uint8Array): Promise<TReturn>;
 }
 interface Cache<TReturn = any, TParameter extends any[] = any[]> {
     name: string;

package/core.d.ts

@@ -530,8 +530,12 @@ interface Hooks {
  */
 declare class Alepha {
     /**
-     * Syntactic sugar for creating a new instance of the container.
-     * Equivalent to `Alepha.create()`.
+     * Creates a new instance of the Alepha container with some helpers:
+     *
+     * - merges `process.env` with the provided state.env when available.
+     * - populates the test hooks for Vitest or Jest environments when available.
+     *
+     * If you are not interested about these helpers, you can use the constructor directly.
      */
     static create(state?: Partial<State>): Alepha;
     /**

package/datetime.d.ts

@@ -94,12 +94,18 @@ declare class DateTimeProvider {
     tick(): Promise<void>;
     /**
      * Wait for a certain duration.
+     *
+     * You can clear the timeout by using the `AbortSignal` API.
+     * Aborted signal will resolve the promise immediately, it does not reject it.
      */
-    wait(duration: DurationLike, signal?: AbortSignal): Promise<void>;
+    wait(duration: DurationLike, options?: {
+        signal?: AbortSignal;
+        now?: number;
+    }): Promise<void>;
     /**
      * Run a callback after a certain duration.
      */
-    timeout(callback: () => void, duration: DurationLike): Timeout;
+    timeout(callback: () => void, duration: DurationLike, now?: number): Timeout;
     /**
      * Create an interval.
      *
@@ -113,7 +119,7 @@ declare class DateTimeProvider {
     /**
      * Add time to the current date.
      */
-    travel(duration: DurationLike): Promise<void>;
+    travel(duration: DurationLike, unit?: ManipulateType): Promise<void>;
     /**
      * Stop the time.
      */

package/lock/redis.cjs

@@ -33,7 +33,7 @@ class RedisLockProvider {
     await this.redisProvider.del(keys);
   }
 }
-class AlephaLock {
+class AlephaLockRedis {
   name = "alepha.lock.redis";
   $services = (alepha) => alepha.with({
     provide: lock.LockTopicProvider,
@@ -43,8 +43,8 @@ class AlephaLock {
     provide: lock.LockProvider,
     use: RedisLockProvider,
     optional: true
-  }).with(AlephaLock);
+  }).with(lock.AlephaLock);
 }
 
-exports.AlephaLock = AlephaLock;
+exports.AlephaLockRedis = AlephaLockRedis;
 exports.RedisLockProvider = RedisLockProvider;

package/lock/redis.d.ts

@@ -18,9 +18,9 @@ declare class RedisLockProvider implements LockProvider {
  * @see {@link RedisLockProvider}
  * @module alepha.lock.redis
  */
-declare class AlephaLock {
+declare class AlephaLockRedis {
     readonly name = "alepha.lock.redis";
     readonly $services: (alepha: Alepha) => Alepha;
 }
 
-export { AlephaLock, RedisLockProvider };
+export { AlephaLockRedis, RedisLockProvider };

package/lock/redis.js

@@ -1,4 +1,4 @@
-import { LockTopicProvider, LockProvider } from '@alepha/lock';
+import { LockTopicProvider, LockProvider, AlephaLock } from '@alepha/lock';
 import { RedisTopicProvider } from '@alepha/topic-redis';
 import { $logger, $inject } from '@alepha/core';
 import { RedisProvider } from '@alepha/redis';
@@ -31,7 +31,7 @@ class RedisLockProvider {
     await this.redisProvider.del(keys);
   }
 }
-class AlephaLock {
+class AlephaLockRedis {
   name = "alepha.lock.redis";
   $services = (alepha) => alepha.with({
     provide: LockTopicProvider,
@@ -44,4 +44,4 @@ class AlephaLock {
   }).with(AlephaLock);
 }
 
-export { AlephaLock, RedisLockProvider };
+export { AlephaLockRedis, RedisLockProvider };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "alepha",
-	"version": "0.7.4",
+	"version": "0.7.5",
 	"type": "module",
 	"license": "MIT",
 	"description": "TypeScript framework for building full-stack apps with strict conventions, and React-based SPA or SSR without filesystem-based routing.",
@@ -12,28 +12,28 @@
 	"main": "./core.js",
 	"types": "./core.d.ts",
 	"dependencies": {
-		"@alepha/cache": "0.7.4",
-		"@alepha/cache-redis": "0.7.4",
-		"@alepha/core": "0.7.4",
-		"@alepha/datetime": "0.7.4",
-		"@alepha/lock": "0.7.4",
-		"@alepha/postgres": "0.7.4",
-		"@alepha/queue": "0.7.4",
-		"@alepha/react": "0.7.4",
-		"@alepha/react-auth": "0.7.4",
-		"@alepha/redis": "0.7.4",
-		"@alepha/retry": "0.7.4",
-		"@alepha/scheduler": "0.7.4",
-		"@alepha/security": "0.7.4",
-		"@alepha/server": "0.7.4",
-		"@alepha/server-cache": "0.7.4",
-		"@alepha/server-cookies": "0.7.4",
-		"@alepha/server-static": "0.7.4",
-		"@alepha/server-swagger": "0.7.4",
-		"@alepha/testing": "0.7.4",
-		"@alepha/topic": "0.7.4",
-		"@alepha/topic-redis": "0.7.4",
-		"@alepha/vite": "0.7.4",
+		"@alepha/cache": "0.7.5",
+		"@alepha/cache-redis": "0.7.5",
+		"@alepha/core": "0.7.5",
+		"@alepha/datetime": "0.7.5",
+		"@alepha/lock": "0.7.5",
+		"@alepha/postgres": "0.7.5",
+		"@alepha/queue": "0.7.5",
+		"@alepha/react": "0.7.5",
+		"@alepha/react-auth": "0.7.5",
+		"@alepha/redis": "0.7.5",
+		"@alepha/retry": "0.7.5",
+		"@alepha/scheduler": "0.7.5",
+		"@alepha/security": "0.7.5",
+		"@alepha/server": "0.7.5",
+		"@alepha/server-cache": "0.7.5",
+		"@alepha/server-cookies": "0.7.5",
+		"@alepha/server-static": "0.7.5",
+		"@alepha/server-swagger": "0.7.5",
+		"@alepha/testing": "0.7.5",
+		"@alepha/topic": "0.7.5",
+		"@alepha/topic-redis": "0.7.5",
+		"@alepha/vite": "0.7.5",
 		"@types/react": "^19.1.8",
 		"react": "^19.1.0"
 	},
@@ -47,7 +47,6 @@
 	},
 	"files": [
 		"src",
-		"assets",
 		"**/*.js",
 		"**/*.cjs",
 		"**/*.d.ts",

package/postgres.d.ts

@@ -7,7 +7,7 @@ import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
 import { PgSequenceOptions, AnyPgTable, AnyPgColumn, UpdateDeleteAction, PgTableWithColumns, PgColumnBuilderBase, PgTableExtraConfigValue, PgDatabase, TableConfig as TableConfig$1, PgColumn, PgTransaction, PgTransactionConfig, LockStrength, LockConfig, PgInsertValue, PgSelectJoinFn } from 'drizzle-orm/pg-core';
 export * from 'drizzle-orm/pg-core';
 import * as _sinclair_typebox from '@sinclair/typebox';
-import { TObject, TSchema, ObjectOptions, Kind, TProperties, Evaluate, TReadonly, TOptional, Static, TAdditionalProperties, OptionalKind, TArray, TIntersect, TRecord, TBoolean, TInteger, TOptionalWithFlag, IntegerOptions, NumberOptions, StringOptions } from '@sinclair/typebox';
+import { TObject, TSchema, ObjectOptions, Kind, TProperties, Evaluate, TReadonly, TOptional, Static, TAdditionalProperties, OptionalKind, TArray, TPick, TIntersect, TRecord, TBoolean, TInteger, TOptionalWithFlag, IntegerOptions, NumberOptions, StringOptions } from '@sinclair/typebox';
 import { BuildExtraConfigColumns } from 'drizzle-orm/column-builder';
 import * as _alepha_lock from '@alepha/lock';
 import { MigrationConfig } from 'drizzle-orm/migrator';
@@ -680,15 +680,19 @@ type PgQueryWhere<T extends object> = {
     exists?: SQLWrapper;
 };
 
-interface PgQuery<T extends TObject> {
+interface PgQuery<T extends TObject, Select extends (keyof Static<T>)[] = []> {
+    columns?: Select;
+    distinct?: boolean;
     where?: PgQueryWhereWithMany<T> | SQLWrapper;
     limit?: number;
     offset?: number;
     sort?: {
         [key in keyof Static<T>]?: "asc" | "desc";
     };
+    groupBy?: (keyof Static<T>)[];
     relations?: PgQueryWithMap<T>;
 }
+type PgQueryResult<T extends TObject, Select extends (keyof Static<T>)[]> = TPick<T, Select>;
 type PgQueryWhereWithMany<T extends TObject> = PgQueryWhere<Static<RemoveManyRelations<T>>> & ExtractManyRelations<T>;
 type ExtractManyRelations<T extends TObject> = {
     [K in keyof T["properties"] as T["properties"][K] extends {
@@ -879,7 +883,7 @@ declare class Repository<TTable extends PgTableWithColumns<TableConfig$1>, TTabl
      * @param opts The statement options.
      * @returns The found entities.
      */
-    find(query?: PgQuery<TTableSchema>, opts?: StatementOptions): Promise<Static<TTableSchema>[]>;
+    find<Select extends (keyof Static<TTableSchema>)[]>(query?: PgQuery<TTableSchema, Select>, opts?: StatementOptions): Promise<Static<PgQueryResult<TTableSchema, Select>>[]>;
     /**
      * Find a single entity.
      *
@@ -4358,13 +4362,7 @@ declare const envSchema: _alepha_core.TObject<{
     PG_DATABASE: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
     PG_PASSWORD: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
     PG_PORT: _sinclair_typebox.TOptional<_sinclair_typebox.TNumber>;
-    /**
-     *
-     */
-    DATABASE_URL: _sinclair_typebox.TString;
-    /**
-     *
-     */
+    DATABASE_URL: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
     DATABASE_MIGRATIONS_FOLDER: _sinclair_typebox.TString;
     /**
      * The schema to use.
@@ -4404,10 +4402,10 @@ declare class NodePostgresProvider implements PostgresProvider {
         PG_DATABASE?: string | undefined;
         PG_PASSWORD?: string | undefined;
         PG_PORT?: number | undefined;
+        DATABASE_URL?: string | undefined;
         POSTGRES_SCHEMA?: string | undefined;
         POSTGRES_SYNCHRONIZE?: boolean | undefined;
         POSTGRES_PUSH_SCHEMA?: boolean | undefined;
-        DATABASE_URL: string;
         DATABASE_MIGRATIONS_FOLDER: string;
         POSTGRES_REJECT_UNAUTHORIZED: boolean;
     };
@@ -4590,4 +4588,4 @@ declare class AlephaPostgres implements Module {
     readonly $services: (alepha: Alepha) => Alepha;
 }
 
-export { $entity, $repository, $sequence, $transaction, AlephaPostgres, type BaseEntity, type BaseEntityKeys, DrizzleKitProvider, type Entity, type EntityDescriptorOptions, EntityNotFoundError, type ExtractManyRelations, type FilterOperators, type FromSchema, NodePostgresProvider, type NodePostgresProviderState, type NullToUndefined, type NullifyIfOptional, PG_CREATED_AT, PG_DEFAULT, PG_IDENTITY, PG_MANY, PG_ONE, PG_PRIMARY_KEY, PG_REF, PG_SCHEMA, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, type Page, type PageQuery, type PgAttrField, type PgDefault, type PgIdentityOptions, type PgMany, type PgManyOptions, type PgPrimaryKey, type PgQuery, type PgQueryWhere, type PgQueryWhereWithMany, type PgQueryWith, type PgQueryWithMap, type PgRef, type PgRefOptions, type PgSymbolKeys, type PgSymbols, type PgTableConfig, type PgTableWithColumnsAndSchema, PostgresProvider, PostgresTypeProvider, type RemoveManyRelations, Repository, type RepositoryDescriptorOptions, RepositoryDescriptorProvider, type SQLLike, type SequenceDescriptor, type SequenceDescriptorOptions, type StatementOptions, type TEntity, type TInsertObject, type TPage, type TransactionContext, type TransactionDescriptorOptions, entityKeys, entitySchema, nullToUndefined, pageQuerySchema, pageSchema, pg, pgTableSchema, schema, schemaToColumns };
+export { $entity, $repository, $sequence, $transaction, AlephaPostgres, type BaseEntity, type BaseEntityKeys, DrizzleKitProvider, type Entity, type EntityDescriptorOptions, EntityNotFoundError, type ExtractManyRelations, type FilterOperators, type FromSchema, NodePostgresProvider, type NodePostgresProviderState, type NullToUndefined, type NullifyIfOptional, PG_CREATED_AT, PG_DEFAULT, PG_IDENTITY, PG_MANY, PG_ONE, PG_PRIMARY_KEY, PG_REF, PG_SCHEMA, PG_SERIAL, PG_UPDATED_AT, PG_VERSION, type Page, type PageQuery, type PgAttrField, type PgDefault, type PgIdentityOptions, type PgMany, type PgManyOptions, type PgPrimaryKey, type PgQuery, type PgQueryResult, type PgQueryWhere, type PgQueryWhereWithMany, type PgQueryWith, type PgQueryWithMap, type PgRef, type PgRefOptions, type PgSymbolKeys, type PgSymbols, type PgTableConfig, type PgTableWithColumnsAndSchema, PostgresProvider, PostgresTypeProvider, type RemoveManyRelations, Repository, type RepositoryDescriptorOptions, RepositoryDescriptorProvider, type SQLLike, type SequenceDescriptor, type SequenceDescriptorOptions, type StatementOptions, type TEntity, type TInsertObject, type TPage, type TransactionContext, type TransactionDescriptorOptions, entityKeys, entitySchema, nullToUndefined, pageQuerySchema, pageSchema, pg, pgTableSchema, schema, schemaToColumns };

package/react/auth.d.ts

@@ -142,6 +142,7 @@ interface AuthDescriptorOptions {
         clientSecret?: string;
         redirectUri?: string;
         useIdToken?: boolean;
+        logoutUri?: string;
     };
 }
 interface AuthDescriptor {
@@ -236,6 +237,7 @@ declare class ReactAuthProvider {
         redirectUri: string;
         fallback?: () => Async<AccessToken>;
         useIdToken?: boolean;
+        logoutUri?: string;
     }>;
     /**
      *
@@ -261,6 +263,7 @@ interface AuthProvider {
     };
     fallback?: () => Async<AccessToken>;
     useIdToken?: boolean;
+    logoutUri?: string;
 }
 interface ReactUser {
     id: string;

package/react.d.ts

@@ -1,8 +1,9 @@
 import * as _alepha_core from '@alepha/core';
 import { TSchema as TSchema$1, KIND, OPTIONS, Static, Async, Alepha, Service, TObject, Module } from '@alepha/core';
-import { ServerRoute, ServerRequest, ApiLinksResponse, HttpClient, ClientScope, HttpVirtualClient, ServerRouterProvider, ServerTimingProvider, ServerHandler } from '@alepha/server';
+import { ServerRequest, ApiLinksResponse, HttpClient, ClientScope, HttpVirtualClient, ServerRouterProvider, ServerTimingProvider, ServerHandler } from '@alepha/server';
 import * as React from 'react';
 import React__default, { PropsWithChildren, ReactNode, FC, ErrorInfo, AnchorHTMLAttributes } from 'react';
+import { ServerRouteCache } from '@alepha/server-cache';
 import { Root } from 'react-dom/client';
 import { RouterProvider, Route } from '@alepha/router';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -101,7 +102,7 @@ interface PageConfigSchema {
 }
 type TPropsDefault = any;
 type TPropsParentDefault = {};
-interface PageDescriptorOptions<TConfig extends PageConfigSchema = PageConfigSchema, TProps extends object = TPropsDefault, TPropsParent extends object = TPropsParentDefault> extends Pick<ServerRoute, "cache"> {
+interface PageDescriptorOptions<TConfig extends PageConfigSchema = PageConfigSchema, TProps extends object = TPropsDefault, TPropsParent extends object = TPropsParentDefault> {
     /**
      * Name your page.
      *
@@ -181,6 +182,7 @@ interface PageDescriptorOptions<TConfig extends PageConfigSchema = PageConfigSch
      */
     client?: boolean | ClientOnlyProps;
     afterHandler?: (request: ServerRequest) => any;
+    cache?: ServerRouteCache;
 }
 interface PageDescriptor<TConfig extends PageConfigSchema = PageConfigSchema, TProps extends object = TPropsDefault, TPropsParent extends object = TPropsParentDefault> {
     [KIND]: typeof KEY;
@@ -436,6 +438,51 @@ interface ReactHydrationState {
     links?: ApiLinksResponse;
 }
 
+/**
+ * Props for the ErrorBoundary component.
+ */
+interface ErrorBoundaryProps {
+    /**
+     * Fallback React node to render when an error is caught.
+     * If not provided, a default error message will be shown.
+     */
+    fallback: (error: Error) => ReactNode;
+    /**
+     * Optional callback that receives the error and error info.
+     * Use this to log errors to a monitoring service.
+     */
+    onError?: (error: Error, info: ErrorInfo) => void;
+}
+/**
+ * State of the ErrorBoundary component.
+ */
+interface ErrorBoundaryState {
+    error?: Error;
+}
+/**
+ * A reusable error boundary for catching rendering errors
+ * in any part of the React component tree.
+ */
+declare class ErrorBoundary extends React__default.Component<PropsWithChildren<ErrorBoundaryProps>, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    /**
+     * Update state so the next render shows the fallback UI.
+     */
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    /**
+     * Lifecycle method called when an error is caught.
+     * You can log the error or perform side effects here.
+     */
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): ReactNode;
+}
+
+interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
+    to: string | PageDescriptor;
+    children?: React__default.ReactNode;
+}
+declare const Link: (props: LinkProps) => react_jsx_runtime.JSX.Element | null;
+
 interface NestedViewProps {
     children?: ReactNode;
 }
@@ -462,6 +509,19 @@ interface NestedViewProps {
  */
 declare const NestedView: (props: NestedViewProps) => react_jsx_runtime.JSX.Element;
 
+interface RouterContextValue {
+    alepha: Alepha;
+    state: RouterState;
+    context: PageReactContext;
+}
+declare const RouterContext: React.Context<RouterContextValue | undefined>;
+
+interface RouterLayerContextValue {
+    index: number;
+    path: string;
+}
+declare const RouterLayerContext: React.Context<RouterLayerContextValue | undefined>;
+
 declare class RouterHookApi {
     private readonly pages;
     private readonly state;
@@ -523,64 +583,6 @@ declare class RedirectionError extends Error {
     constructor(page: HrefLike);
 }
 
-/**
- * Props for the ErrorBoundary component.
- */
-interface ErrorBoundaryProps {
-    /**
-     * Fallback React node to render when an error is caught.
-     * If not provided, a default error message will be shown.
-     */
-    fallback: (error: Error) => ReactNode;
-    /**
-     * Optional callback that receives the error and error info.
-     * Use this to log errors to a monitoring service.
-     */
-    onError?: (error: Error, info: ErrorInfo) => void;
-}
-/**
- * State of the ErrorBoundary component.
- */
-interface ErrorBoundaryState {
-    error?: Error;
-}
-/**
- * A reusable error boundary for catching rendering errors
- * in any part of the React component tree.
- */
-declare class ErrorBoundary extends React__default.Component<PropsWithChildren<ErrorBoundaryProps>, ErrorBoundaryState> {
-    constructor(props: ErrorBoundaryProps);
-    /**
-     * Update state so the next render shows the fallback UI.
-     */
-    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
-    /**
-     * Lifecycle method called when an error is caught.
-     * You can log the error or perform side effects here.
-     */
-    componentDidCatch(error: Error, info: ErrorInfo): void;
-    render(): ReactNode;
-}
-
-interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
-    to: string | PageDescriptor;
-    children?: React__default.ReactNode;
-}
-declare const Link: (props: LinkProps) => react_jsx_runtime.JSX.Element | null;
-
-interface RouterContextValue {
-    alepha: Alepha;
-    state: RouterState;
-    context: PageReactContext;
-}
-declare const RouterContext: React.Context<RouterContextValue | undefined>;
-
-interface RouterLayerContextValue {
-    index: number;
-    path: string;
-}
-declare const RouterLayerContext: React.Context<RouterLayerContextValue | undefined>;
-
 declare const useActive: (path: HrefLike) => UseActiveHook;
 interface UseActiveHook {
     isActive: boolean;

package/scheduler.d.ts

@@ -1,8 +1,8 @@
 import * as _alepha_core from '@alepha/core';
-import { Async, KIND, OPTIONS, Static, Alepha } from '@alepha/core';
-import { DurationLike, DateTimeProvider, Interval } from '@alepha/datetime';
+import { Async, KIND, OPTIONS, Alepha, Static } from '@alepha/core';
+import { DateTime, DurationLike, DateTimeProvider, Interval } from '@alepha/datetime';
 import * as _alepha_lock from '@alepha/lock';
-import { ScheduledTask } from 'node-cron';
+import { Cron } from 'cron-schedule';
 
 declare const KEY = "SCHEDULER";
 /**
@@ -17,7 +17,7 @@ type SchedulerDescriptorOptions = {
     /**
      * Function to run on schedule.
      */
-    handler: () => Async<void>;
+    handler: (args: SchedulerHandlerArguments) => Async<void>;
     /**
      * Name of the scheduler. Defaults to the function name.
      */
@@ -36,7 +36,9 @@ type SchedulerDescriptorOptions = {
     interval?: DurationLike;
     /**
      * If true, the scheduler will be locked and only one instance will run at a time.
-     * Defaults to true.
+     * You probably need to import {@link AlephaLockRedis} for distributed locking.
+     *
+     * @default true
      */
     lock?: boolean;
 };
@@ -45,6 +47,9 @@ interface SchedulerDescriptor {
     [OPTIONS]: SchedulerDescriptorOptions;
     (): Promise<void>;
 }
+interface SchedulerHandlerArguments {
+    now: DateTime;
+}
 
 /** Symbol key applied to readonly types */
 declare const ReadonlyKind: unique symbol;
@@ -110,6 +115,28 @@ interface TSchema extends TKind, SchemaOptions {
     static: unknown;
 }
 
+interface CronJob {
+    handler: (context: {
+        now: DateTime;
+    }) => Promise<void>;
+    cron: Cron;
+    loop: boolean;
+    running?: boolean;
+    onError?: (error: Error) => void;
+    abort: AbortController;
+}
+declare class CronProvider {
+    protected readonly dt: DateTimeProvider;
+    protected readonly alepha: Alepha;
+    protected readonly log: _alepha_core.Logger;
+    start(cron: CronJob): void;
+    stop(cron: CronJob): void;
+    create(expression: string, handler: (context: {
+        now: DateTime;
+    }) => Promise<void>): CronJob;
+    run(task: CronJob, now?: undefined): void;
+}
+
 declare const envSchema: _alepha_core.TObject<{
     SCHEDULER_PREFIX: TOptional<TString>;
 }>;
@@ -124,10 +151,12 @@ declare class SchedulerDescriptorProvider {
     };
     protected readonly alepha: Alepha;
     protected readonly dateTimeProvider: DateTimeProvider;
+    protected readonly cronProvider: CronProvider;
     protected readonly schedulers: Scheduler[];
     protected readonly configure: _alepha_core.HookDescriptor<"configure">;
     protected readonly start: _alepha_core.HookDescriptor<"start">;
     protected readonly stop: _alepha_core.HookDescriptor<"stop">;
+    protected createContextId(): string;
     /**
      * Get the schedulers.
      */
@@ -147,11 +176,12 @@ declare class SchedulerDescriptorProvider {
      * @protected
      */
     protected createScheduler(options: SchedulerDescriptorOptions, instance: any, key: string): Scheduler;
+    protected createHandler(name: string, options: SchedulerDescriptorOptions): (args: SchedulerHandlerArguments) => Promise<void>;
     trigger(name: string): Promise<void>;
     protected runLock: _alepha_lock.LockDescriptor<(options: SchedulerDescriptorOptions & {
         name: string;
+        args: SchedulerHandlerArguments;
     }) => Promise<void>>;
-    protected run(options: SchedulerDescriptorOptions): Promise<void>;
     /**
      * Prefix the scheduler key.
      */
@@ -166,8 +196,8 @@ declare class SchedulerDescriptorProvider {
 interface Scheduler {
     name: string;
     options: SchedulerDescriptorOptions;
-    trigger: () => Promise<void>;
-    cron?: ScheduledTask;
+    trigger: (args: SchedulerHandlerArguments) => Promise<void>;
+    cron?: CronJob;
     interval?: Interval;
 }
 
@@ -184,4 +214,4 @@ declare class AlephaScheduler {
     readonly $services: (alepha: Alepha) => Alepha;
 }
 
-export { $scheduler, AlephaScheduler, type Scheduler, type SchedulerDescriptor, type SchedulerDescriptorOptions, SchedulerDescriptorProvider, isScheduler };
+export { $scheduler, AlephaScheduler, type Scheduler, type SchedulerDescriptor, type SchedulerDescriptorOptions, SchedulerDescriptorProvider, type SchedulerHandlerArguments, isScheduler };

package/server/cache.d.ts

@@ -6,7 +6,7 @@ import { ServerHandler, ServerRequestConfig } from '@alepha/server';
 
 declare module "alepha/server" {
     interface ServerRoute {
-        cache?: ServiceRouteCache;
+        cache?: ServerRouteCache;
     }
     interface ActionDescriptor {
         invalidate: () => Promise<void>;
@@ -27,7 +27,7 @@ declare class ServerCacheProvider {
     protected getCacheByRoute(route: RouteLike): RouteCache | undefined;
     protected createCacheKey(args: ServerRequestConfig): string;
 }
-type ServiceRouteCache = boolean | DurationLike | Omit<CacheDescriptorOptions<any>, "handler" | "key">;
+type ServerRouteCache = boolean | DurationLike | Omit<CacheDescriptorOptions<any>, "handler" | "key">;
 type RouteCache = Cache<{
     contentType?: string;
     body: string;
@@ -43,9 +43,40 @@ type RouteLike = {
     handler?: ServerHandler;
 };
 
+/**
+ * # Alepha Server Cache Module
+ *
+ * @description
+ * Plugin for Alepha Server that provides server-side caching capabilities.
+ * It uses the Alepha Cache module to cache responses from server actions ($action).
+ * It also provides a ETag-based cache invalidation mechanism.
+ *
+ * @example
+ * ```ts
+ * import { Alepha } from "@alepha/core";
+ * import { $action } from "@alepha/server";
+ * import { AlephaServerCache } from "alepha/server/cache";
+ *
+ * class ApiServer {
+ *   hello = $action({
+ *     cache: true,
+ *     handler: () => "Hello, World!",
+ *   });
+ * }
+ *
+ * const alepha = Alepha.create()
+ *   .with(AlephaServerCache)
+ *   .with(ApiServer);
+ *
+ * run(alepha);
+ * ```
+ *
+ * @see {@link ServerCacheProvider}
+ * @module alepha.server.cache
+ */
 declare class AlephaServerCache implements Module {
     readonly name = "alepha.server.cache";
     readonly $services: (alepha: Alepha) => Alepha;
 }
 
-export { AlephaServerCache, ServerCacheProvider, type ServiceRouteCache };
+export { AlephaServerCache, ServerCacheProvider, type ServerRouteCache };

package/server/swagger.d.ts

@@ -100,6 +100,16 @@ declare class ServerSwaggerProvider {
     protected configureSwaggerUi(prefix: string, options: SwaggerDescriptorOptions): Promise<void>;
 }
 
+/**
+ * Alepha Server Swagger Module
+ *
+ * Plugin for Alepha Server that provides Swagger documentation capabilities.
+ * It generates OpenAPI v3 documentation for the server's endpoints ($action).
+ * It also provides a Swagger UI for interactive API documentation.
+ *
+ * @see {@link ServerSwaggerProvider}
+ * @module alepha.server.swagger
+ */
 declare class AlephaServerSwagger implements Module {
     readonly name = "alepha.server.swagger";
     readonly $services: (alepha: Alepha) => Alepha;

package/vite.d.ts

@@ -59,11 +59,11 @@ interface ViteAlephaBuildVercelOptions {
      */
     clientDir?: string;
 }
-declare function viteAlephaBuildVercel(opts?: ViteAlephaBuildVercelOptions): {
+declare function viteAlephaBuildVercel(opts?: ViteAlephaBuildVercelOptions): Promise<{
     name: string;
     apply: string;
     writeBundle(): void;
-};
+}>;
 
 interface ViteCompressOptions {
     /**