alepha 0.9.1 → 0.9.2

package/command.d.ts

@@ -14,12 +14,20 @@ interface Timer {
   name: string;
   duration: string;
 }
+interface RunOptions {
+  /**
+   * Rename the command for logging purposes.
+   */
+  alias?: string;
+  /**
+   * If true, the command will not be logged.
+   */
+  silent?: boolean;
+}
 interface RunnerMethod {
-  (cmd: string | Array<string | Task>, fn?: () => any): Promise<string>;
-  rm: (glob: string | string[]) => Promise<string>;
-  cp: (source: string, dest: string, options?: {
-    alias?: string;
-  }) => Promise<string>;
+  (cmd: string | Array<string | Task>, fn?: () => any, options?: RunOptions): Promise<string>;
+  rm: (glob: string | string[], options?: RunOptions) => Promise<string>;
+  cp: (source: string, dest: string, options?: RunOptions) => Promise<string>;
 }
 declare class Runner {
   protected readonly log: Logger;
@@ -77,6 +85,10 @@ interface CommandDescriptorOptions<T extends TObject> {
    * A TypeBox object schema defining the flags for the command.
    */
   flags?: T;
+  /**
+   * If false, skip summary message at the end of the command execution.
+   */
+  summary?: boolean;
 }
 declare class CommandDescriptor<T extends TObject = TObject> extends Descriptor<CommandDescriptorOptions<T>> {
   readonly flags: TObject<{}>;
@@ -157,5 +169,5 @@ declare module "@sinclair/typebox" {
 //# sourceMappingURL=index.d.ts.map
 
 //#endregion
-export { $command, AlephaCommand, CliProvider, CommandDescriptor, CommandDescriptorOptions, CommandError, CommandHandlerArgs, Runner, RunnerMethod, Task };
+export { $command, AlephaCommand, CliProvider, CommandDescriptor, CommandDescriptorOptions, CommandError, CommandHandlerArgs, RunOptions, Runner, RunnerMethod, Task };
 //# sourceMappingURL=index.d.ts.map

package/core.d.ts

@@ -137,6 +137,7 @@ declare class AlsProvider {
   constructor();
   createContextId(): string;
   run<R>(callback: () => R, data?: Record<string, any>): R;
+  exists(): boolean;
   get<T>(key: string): T | undefined;
   set<T>(key: string, value: T): void;
 }

package/lock.d.ts

@@ -1,5 +1,5 @@
-import * as _alepha_core1 from "alepha";
 import * as _alepha_core0$1 from "alepha";
+import * as _alepha_core5 from "alepha";
 import * as _alepha_core0 from "alepha";
 import { AsyncFn, Descriptor, KIND, Static } from "alepha";
 import * as _alepha_topic0 from "alepha/topic";
@@ -89,14 +89,14 @@ interface LockDescriptorOptions<TFunc extends AsyncFn> {
    */
   gracePeriod?: ((...args: Parameters<TFunc>) => DurationLike | undefined) | DurationLike;
 }
-declare const envSchema: _alepha_core1.TObject<{
-  LOCK_PREFIX_KEY: _alepha_core1.TString;
+declare const envSchema: _alepha_core0$1.TObject<{
+  LOCK_PREFIX_KEY: _alepha_core0$1.TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
 }
 declare class LockDescriptor<TFunc extends AsyncFn> extends Descriptor<LockDescriptorOptions<TFunc>> {
-  protected readonly log: _alepha_core1.Logger;
+  protected readonly log: _alepha_core0$1.Logger;
   protected readonly provider: LockProvider;
   protected readonly env: {
     LOCK_PREFIX_KEY: string;
@@ -105,8 +105,8 @@ declare class LockDescriptor<TFunc extends AsyncFn> extends Descriptor<LockDescr
   protected readonly id: `${string}-${string}-${string}-${string}-${string}`;
   readonly maxDuration: dayjs_plugin_duration0.Duration;
   protected readonly topicLockEnd: _alepha_topic0.TopicDescriptor<{
-    payload: _alepha_core1.TObject<{
-      name: _alepha_core1.TString;
+    payload: _alepha_core0$1.TObject<{
+      name: _alepha_core0$1.TString;
     }>;
   }>;
   run(...args: Parameters<TFunc>): Promise<void>;
@@ -137,7 +137,7 @@ declare abstract class LockTopicProvider extends TopicProvider {}
  */
 declare class MemoryLockProvider implements LockProvider {
   protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly log: _alepha_core0$1.Logger;
+  protected readonly log: _alepha_core5.Logger;
   /**
    * The in-memory store.
    */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "alepha",
-	"version": "0.9.1",
+	"version": "0.9.2",
 	"type": "module",
 	"engines": {
 		"node": ">=22.0.0"
@@ -15,45 +15,47 @@
 	"main": "./core.js",
 	"types": "./core.d.ts",
 	"dependencies": {
-		"@alepha/batch": "0.9.1",
-		"@alepha/bucket": "0.9.1",
-		"@alepha/cache": "0.9.1",
-		"@alepha/cache-redis": "0.9.1",
-		"@alepha/command": "0.9.1",
-		"@alepha/core": "0.9.1",
-		"@alepha/datetime": "0.9.1",
-		"@alepha/file": "0.9.1",
-		"@alepha/lock": "0.9.1",
-		"@alepha/lock-redis": "0.9.1",
-		"@alepha/postgres": "0.9.1",
-		"@alepha/queue": "0.9.1",
-		"@alepha/queue-redis": "0.9.1",
-		"@alepha/react": "0.9.1",
-		"@alepha/react-auth": "0.9.1",
-		"@alepha/react-head": "0.9.1",
-		"@alepha/redis": "0.9.1",
-		"@alepha/retry": "0.9.1",
-		"@alepha/router": "0.9.1",
-		"@alepha/scheduler": "0.9.1",
-		"@alepha/security": "0.9.1",
-		"@alepha/server": "0.9.1",
-		"@alepha/server-cache": "0.9.1",
-		"@alepha/server-compress": "0.9.1",
-		"@alepha/server-cookies": "0.9.1",
-		"@alepha/server-cors": "0.9.1",
-		"@alepha/server-health": "0.9.1",
-		"@alepha/server-helmet": "0.9.1",
-		"@alepha/server-links": "0.9.1",
-		"@alepha/server-metrics": "0.9.1",
-		"@alepha/server-multipart": "0.9.1",
-		"@alepha/server-proxy": "0.9.1",
-		"@alepha/server-security": "0.9.1",
-		"@alepha/server-static": "0.9.1",
-		"@alepha/server-swagger": "0.9.1",
-		"@alepha/testing": "0.9.1",
-		"@alepha/topic": "0.9.1",
-		"@alepha/topic-redis": "0.9.1",
-		"@alepha/vite": "0.9.1"
+		"@alepha/batch": "0.9.2",
+		"@alepha/bucket": "0.9.2",
+		"@alepha/cache": "0.9.2",
+		"@alepha/cache-redis": "0.9.2",
+		"@alepha/command": "0.9.2",
+		"@alepha/core": "0.9.2",
+		"@alepha/datetime": "0.9.2",
+		"@alepha/file": "0.9.2",
+		"@alepha/lock": "0.9.2",
+		"@alepha/lock-redis": "0.9.2",
+		"@alepha/postgres": "0.9.2",
+		"@alepha/queue": "0.9.2",
+		"@alepha/queue-redis": "0.9.2",
+		"@alepha/react": "0.9.2",
+		"@alepha/react-auth": "0.9.2",
+		"@alepha/react-form": "0.9.2",
+		"@alepha/react-head": "0.9.2",
+		"@alepha/react-i18n": "0.9.2",
+		"@alepha/redis": "0.9.2",
+		"@alepha/retry": "0.9.2",
+		"@alepha/router": "0.9.2",
+		"@alepha/scheduler": "0.9.2",
+		"@alepha/security": "0.9.2",
+		"@alepha/server": "0.9.2",
+		"@alepha/server-cache": "0.9.2",
+		"@alepha/server-compress": "0.9.2",
+		"@alepha/server-cookies": "0.9.2",
+		"@alepha/server-cors": "0.9.2",
+		"@alepha/server-health": "0.9.2",
+		"@alepha/server-helmet": "0.9.2",
+		"@alepha/server-links": "0.9.2",
+		"@alepha/server-metrics": "0.9.2",
+		"@alepha/server-multipart": "0.9.2",
+		"@alepha/server-proxy": "0.9.2",
+		"@alepha/server-security": "0.9.2",
+		"@alepha/server-static": "0.9.2",
+		"@alepha/server-swagger": "0.9.2",
+		"@alepha/testing": "0.9.2",
+		"@alepha/topic": "0.9.2",
+		"@alepha/topic-redis": "0.9.2",
+		"@alepha/vite": "0.9.2"
 	},
 	"devDependencies": {
 		"tsdown": "^0.13.0"
@@ -147,11 +149,21 @@
 			"require": "./react/auth.cjs",
 			"types": "./react/auth.d.ts"
 		},
+		"./react/form": {
+			"import": "./react/form.js",
+			"require": "./react/form.cjs",
+			"types": "./react/form.d.ts"
+		},
 		"./react/head": {
 			"import": "./react/head.js",
 			"require": "./react/head.cjs",
 			"types": "./react/head.d.ts"
 		},
+		"./react/i18n": {
+			"import": "./react/i18n.js",
+			"require": "./react/i18n.cjs",
+			"types": "./react/i18n.d.ts"
+		},
 		"./redis": {
 			"import": "./redis.js",
 			"require": "./redis.cjs",
@@ -285,7 +297,9 @@
 		"queue-redis",
 		"react",
 		"react-auth",
+		"react-form",
 		"react-head",
+		"react-i18n",
 		"redis",
 		"retry",
 		"router",

package/postgres.d.ts

@@ -19,8 +19,8 @@ import postgres from "postgres";
 import * as _alepha_retry0 from "alepha/retry";
 import * as _sinclair_typebox9 from "@sinclair/typebox";
 import * as _sinclair_typebox16 from "@sinclair/typebox";
-import * as _sinclair_typebox18 from "@sinclair/typebox";
 import * as _sinclair_typebox17 from "@sinclair/typebox";
+import * as _sinclair_typebox18 from "@sinclair/typebox";
 import * as _sinclair_typebox6 from "@sinclair/typebox";
 import * as _sinclair_typebox0 from "@sinclair/typebox";
 import { Evaluate, IntegerOptions, Kind, NumberOptions, ObjectOptions, OptionalKind, Static as Static$1, StringOptions, TAdditionalProperties, TArray, TBoolean, TInteger, TIntersect, TObject as TObject$1, TOptional, TOptionalWithFlag, TPick, TProperties, TReadonly, TRecord, TSchema as TSchema$2 } from "@sinclair/typebox";
@@ -1406,11 +1406,11 @@ declare const createdAtSchema: PgAttr<PgAttr<_sinclair_typebox16.TString, typeof
 /**
  * @deprecated Use `pg.primaryKey()` instead.
  */
-declare const legacyIdSchema: PgAttr<PgAttr<PgAttr<_sinclair_typebox18.TInteger, typeof PG_PRIMARY_KEY>, typeof PG_SERIAL>, typeof PG_DEFAULT>;
+declare const legacyIdSchema: PgAttr<PgAttr<PgAttr<_sinclair_typebox17.TInteger, typeof PG_PRIMARY_KEY>, typeof PG_SERIAL>, typeof PG_DEFAULT>;
 //# sourceMappingURL=legacyIdSchema.d.ts.map
 //#endregion
 //#region src/schemas/updatedAtSchema.d.ts
-declare const updatedAtSchema: PgAttr<PgAttr<_sinclair_typebox17.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+declare const updatedAtSchema: PgAttr<PgAttr<_sinclair_typebox18.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
 //# sourceMappingURL=updatedAtSchema.d.ts.map
 
 //#endregion

package/react/form.cjs

@@ -0,0 +1,8 @@
+'use strict';
+var m = require('@alepha/react-form');
+Object.keys(m).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return m[k]; }
+	});
+});

package/react/form.d.ts

@@ -0,0 +1,117 @@
+import * as _alepha_core0 from "alepha";
+import { Static, TObject, TSchema } from "alepha";
+import { InputHTMLAttributes } from "react";
+
+//#region src/hooks/useForm.d.ts
+
+/**
+ * Custom hook to create a form with validation and field management.
+ * This hook uses TypeBox schemas to define the structure and validation rules for the form.
+ * It provides a way to handle form submission, field creation, and value management.
+ *
+ * @example
+ * ```tsx
+ * import { t } from "alepha";
+ *
+ * const form = useForm({
+ *   schema: t.object({
+ *     username: t.string(),
+ *     password: t.string(),
+ *   }),
+ *   handler: (values) => {
+ *     console.log("Form submitted with values:", values);
+ *   },
+ * });
+ *
+ * return (
+ *   <form onSubmit={form.onSubmit}>
+ *     <input {...form.input("username")} />
+ *     <input {...form.input("password")} />
+ *     <button type="submit">Submit</button>
+ *   </form>
+ * );
+ * ```
+ */
+declare const useForm: <T extends TObject>(options: UseFormOptions<T>) => UseFormReturn<T>;
+declare const getValueFromInput: (input: FormDataEntryValue, schema: TSchema) => any;
+declare const valueToInputEntry: (value: any) => string | number;
+type UseFormOptions<T extends TObject> = {
+  /**
+   * The schema defining the structure and validation rules for the form.
+   * This should be a TypeBox schema object.
+   */
+  schema: T;
+  /**
+   * Callback function to handle form submission.
+   * This function will receive the parsed and validated form values.
+   */
+  handler: (values: Static<T>, args: {
+    form: HTMLFormElement;
+  }) => void;
+  /**
+   * Optional callback to handle changes in form values.
+   * This can be used to update state or perform side effects when values change.
+   */
+  onValuesChange?: (values: Static<T>, previous: Static<T>) => void;
+  /**
+   * Optional initial values for the form fields.
+   * This can be used to pre-populate the form with existing data.
+   */
+  initialValues?: Static<T>;
+  /**
+   * Optional function to create custom field attributes.
+   * This can be used to add custom validation, styles, or other attributes.
+   */
+  onCreateField?: (name: keyof Static<T> & string, schema: TSchema) => InputHTMLAttributes<unknown>;
+  /**
+   * If defined, this will generate a unique ID for each field, prefixed with this string.
+   *
+   * > "username" with id="form-123" will become "form-123-username".
+   *
+   * If omitted, IDs will not be generated.
+   */
+  id?: string;
+};
+type UseFormReturn<T extends TObject> = {
+  /**
+   * Function to handle form submission.
+   * This should be attached to the form's onSubmit event.
+   *
+   * @example
+   * ```tsx
+   * const form = useForm();
+   *
+   * return <form onSubmit={form.onSubmit}></form>;
+   * ```
+   */
+  onSubmit?: (event: FormEventLike) => void;
+  /**
+   * Creates an input field for the specified schema property.
+   */
+  input: SchemaToInput<T>;
+};
+type SchemaToInput<T extends TObject> = { [K in keyof T["properties"]]: T["properties"][K] extends TObject ? SchemaToInput<T["properties"][K]> : InputHTMLAttributes<unknown> };
+interface FormEventLike {
+  currentTarget: HTMLFormElement;
+  preventDefault: () => void;
+}
+//# sourceMappingURL=useForm.d.ts.map
+//#endregion
+//#region src/index.d.ts
+/**
+ * React hooks for managing forms in Alepha applications.
+ *
+ * This module provides a set of hooks to simplify form handling, validation, and submission in React applications built with Alepha.
+ *
+ * It includes:
+ * - `useForm`: A hook for managing form state, validation, and submission.
+ *
+ * @see {@link useForm}
+ * @module alepha.react.form
+ */
+declare const AlephaReactForm: _alepha_core0.ModuleDescriptor;
+//# sourceMappingURL=index.d.ts.map
+
+//#endregion
+export { AlephaReactForm, FormEventLike, SchemaToInput, UseFormOptions, UseFormReturn, getValueFromInput, useForm, valueToInputEntry };
+//# sourceMappingURL=index.d.ts.map

package/react/form.js

@@ -0,0 +1 @@
+export * from '@alepha/react-form'

package/react/i18n.cjs

@@ -0,0 +1,8 @@
+'use strict';
+var m = require('@alepha/react-i18n');
+Object.keys(m).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return m[k]; }
+	});
+});

package/react/i18n.d.ts

@@ -0,0 +1,73 @@
+import * as _alepha_core0$1 from "alepha";
+import * as _alepha_core0 from "alepha";
+import { Alepha, Descriptor, KIND } from "alepha";
+
+//#region src/providers/I18nProvider.d.ts
+declare class I18nProvider {
+  logger: _alepha_core0$1.Logger;
+  alepha: Alepha;
+  registry: Array<{
+    name: string;
+    lang: string;
+    loader: () => Promise<Record<string, string>>;
+    translations: Record<string, string>;
+  }>;
+  options: {
+    fallbackLang: string;
+  };
+  onRender: _alepha_core0$1.HookDescriptor<"server:onRequest">;
+  onStart: _alepha_core0$1.HookDescriptor<"start">;
+  setLang(lang: string): Promise<void>;
+  get lang(): string;
+  translate: (key: string) => string;
+}
+//# sourceMappingURL=I18nProvider.d.ts.map
+//#endregion
+//#region src/descriptors/$dictionary.d.ts
+declare const $dictionary: {
+  <T extends Record<string, string>>(options: DictionaryDescriptorOptions<T>): DictionaryDescriptor<T>;
+  [KIND]: typeof DictionaryDescriptor;
+};
+interface DictionaryDescriptorOptions<T extends Record<string, string>> {
+  lang?: string;
+  name?: string;
+  lazy: () => Promise<{
+    default: T;
+  }>;
+}
+declare class DictionaryDescriptor<T extends Record<string, string>> extends Descriptor<DictionaryDescriptorOptions<T>> {
+  protected provider: I18nProvider;
+  protected onInit(): void;
+}
+//# sourceMappingURL=$dictionary.d.ts.map
+//#endregion
+//#region src/hooks/useI18n.d.ts
+/**
+ * Hook to access the i18n service.
+ */
+declare const useI18n: <S extends object, K extends keyof ServiceDictionary<S>>() => {
+  lang: string;
+  setLang: (lang: string) => Promise<void>;
+  tr: (key: keyof ServiceDictionary<S>[K]) => string;
+};
+type ServiceDictionary<T extends object> = { [K in keyof T]: T[K] extends DictionaryDescriptor<infer U> ? U : never };
+//#endregion
+//#region src/index.d.ts
+declare module "alepha" {
+  interface State {
+    "react.i18n.lang"?: string;
+  }
+}
+/**
+ * Add i18n support to your Alepha React application. SSR and CSR compatible.
+ *
+ * It supports lazy loading of translations and provides a context to access the current language.
+ *
+ * @module alepha.react.i18n
+ */
+declare const AlephaReactI18n: _alepha_core0.ModuleDescriptor;
+//# sourceMappingURL=index.d.ts.map
+
+//#endregion
+export { $dictionary, AlephaReactI18n, DictionaryDescriptor, DictionaryDescriptorOptions, I18nProvider, useI18n };
+//# sourceMappingURL=index.d.ts.map

package/react/i18n.js

@@ -0,0 +1 @@
+export * from '@alepha/react-i18n'

package/react.d.ts

@@ -1,18 +1,19 @@
-import * as _alepha_core10 from "alepha";
+import * as _alepha_core2 from "alepha";
 import * as _alepha_core16 from "alepha";
-import * as _alepha_core14 from "alepha";
 import * as _alepha_core0$1 from "alepha";
+import * as _alepha_core6 from "alepha";
 import * as _alepha_core0 from "alepha";
-import { Alepha, Async, Descriptor, KIND, Service, Static, TObject, TSchema } from "alepha";
-import { ApiLinksResponse, ServerHandler, ServerRequest, ServerRouterProvider, ServerTimingProvider } from "alepha/server";
+import { Alepha, Async, Descriptor, KIND, Service, State, Static, TObject, TSchema } from "alepha";
+import { ApiLinksResponse, RequestConfigSchema, ServerHandler, ServerRequest, ServerRouterProvider, ServerTimingProvider } from "alepha/server";
 import { ServerRouteCache } from "alepha/server/cache";
-import { ClientScope, HttpVirtualClient, LinkProvider } from "alepha/server/links";
+import { ClientScope, HttpVirtualClient, LinkProvider, VirtualAction } from "alepha/server/links";
 import * as react0$1 from "react";
 import * as react0 from "react";
+import * as react1 from "react";
 import React, { AnchorHTMLAttributes, ErrorInfo, FC, PropsWithChildren, ReactNode } from "react";
 import * as react_jsx_runtime0$1 from "react/jsx-runtime";
-import * as react_jsx_runtime1 from "react/jsx-runtime";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime1 from "react/jsx-runtime";
 import { Route, RouterProvider } from "alepha/router";
 import { ServerStaticProvider } from "alepha/server/static";
 import { Root } from "react-dom/client";
@@ -157,14 +158,14 @@ type PageResolve<TConfig extends PageConfigSchema = PageConfigSchema, TPropsPare
 //# sourceMappingURL=$page.d.ts.map
 //#endregion
 //#region src/providers/PageDescriptorProvider.d.ts
-declare const envSchema$1: _alepha_core10.TObject<{
-  REACT_STRICT_MODE: _alepha_core10.TBoolean;
+declare const envSchema$1: _alepha_core2.TObject<{
+  REACT_STRICT_MODE: _alepha_core2.TBoolean;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$1>> {}
 }
 declare class PageDescriptorProvider {
-  protected readonly log: _alepha_core10.Logger;
+  protected readonly log: _alepha_core2.Logger;
   protected readonly env: {
     REACT_STRICT_MODE: boolean;
   };
@@ -189,7 +190,7 @@ declare class PageDescriptorProvider {
   }, 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_core2.HookDescriptor<"configure">;
   protected map(pages: Array<PageDescriptor>, target: PageDescriptor): PageRouteEntry;
   add(entry: PageRouteEntry): void;
   protected createMatch(page: PageRoute): string;
@@ -284,7 +285,7 @@ declare class BrowserRouterProvider extends RouterProvider<BrowserRoute> {
 //#endregion
 //#region src/providers/ReactBrowserProvider.d.ts
 declare class ReactBrowserProvider {
-  protected readonly log: _alepha_core14.Logger;
+  protected readonly log: _alepha_core0$1.Logger;
   protected readonly client: LinkProvider;
   protected readonly alepha: Alepha;
   protected readonly router: BrowserRouterProvider;
@@ -308,7 +309,7 @@ declare class ReactBrowserProvider {
    * Get embedded layers from the server.
    */
   protected getHydrationState(): ReactHydrationState | undefined;
-  readonly ready: _alepha_core14.HookDescriptor<"ready">;
+  readonly ready: _alepha_core0$1.HookDescriptor<"ready">;
 }
 interface RouterGoOptions {
   replace?: boolean;
@@ -393,19 +394,22 @@ interface NestedViewProps {
  * }
  * ```
  */
-declare const NestedView: (props: NestedViewProps) => react_jsx_runtime1.JSX.Element;
+declare const NestedView: (props: NestedViewProps) => react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/NotFound.d.ts
-declare function NotFoundPage(): react_jsx_runtime0.JSX.Element;
+declare function NotFoundPage(): react_jsx_runtime1.JSX.Element;
 //# sourceMappingURL=NotFound.d.ts.map
 //#endregion
+//#region src/contexts/AlephaContext.d.ts
+declare const AlephaContext: react0$1.Context<Alepha | undefined>;
+//# sourceMappingURL=AlephaContext.d.ts.map
+//#endregion
 //#region src/contexts/RouterContext.d.ts
 interface RouterContextValue {
-  alepha: Alepha;
   state: RouterState;
   context: PageReactContext;
 }
-declare const RouterContext: react0$1.Context<RouterContextValue | undefined>;
+declare const RouterContext: react0.Context<RouterContextValue | undefined>;
 //# sourceMappingURL=RouterContext.d.ts.map
 //#endregion
 //#region src/contexts/RouterLayerContext.d.ts
@@ -413,7 +417,7 @@ interface RouterLayerContextValue {
   index: number;
   path: string;
 }
-declare const RouterLayerContext: react0.Context<RouterLayerContextValue | undefined>;
+declare const RouterLayerContext: react1.Context<RouterLayerContextValue | undefined>;
 //# sourceMappingURL=RouterLayerContext.d.ts.map
 //#endregion
 //#region src/hooks/RouterHookApi.d.ts
@@ -501,7 +505,7 @@ declare const useClient: <T extends object>(_scope?: ClientScope) => HttpVirtual
 //# sourceMappingURL=useClient.d.ts.map
 //#endregion
 //#region src/hooks/useInject.d.ts
-declare const useInject: <T extends object>(clazz: Service<T>) => T;
+declare const useInject: <T extends object>(service: Service<T>) => T;
 //# sourceMappingURL=useInject.d.ts.map
 //#endregion
 //#region src/hooks/useQueryParams.d.ts
@@ -535,15 +539,34 @@ declare const useRouterEvents: (opts?: {
 //#region src/hooks/useRouterState.d.ts
 declare const useRouterState: () => RouterState;
 //# sourceMappingURL=useRouterState.d.ts.map
-
+//#endregion
+//#region src/hooks/useSchema.d.ts
+declare const useSchema: <TConfig extends RequestConfigSchema>(action: VirtualAction<TConfig>) => UseSchemaReturn<TConfig>;
+type UseSchemaReturn<TConfig extends RequestConfigSchema> = TConfig & {
+  loading: boolean;
+};
+/**
+ * Get an action schema during server-side rendering (SSR) or client-side rendering (CSR).
+ */
+declare const ssrSchemaLoading: (alepha: Alepha, name: string) => RequestConfigSchema | {
+  loading: boolean;
+};
+//# sourceMappingURL=useSchema.d.ts.map
+//#endregion
+//#region src/hooks/useStore.d.ts
+/**
+ * Hook to access and mutate the Alepha state.
+ */
+declare const useStore: <Key extends keyof State>(key: Key) => [State[Key], (value: State[Key]) => void];
+//# sourceMappingURL=useStore.d.ts.map
 //#endregion
 //#region src/providers/ReactServerProvider.d.ts
-declare const envSchema: _alepha_core0$1.TObject<{
-  REACT_SERVER_DIST: _alepha_core0$1.TString;
-  REACT_SERVER_PREFIX: _alepha_core0$1.TString;
-  REACT_SSR_ENABLED: _alepha_core0$1.TOptional<_alepha_core0$1.TBoolean>;
-  REACT_ROOT_ID: _alepha_core0$1.TString;
-  REACT_SERVER_TEMPLATE: _alepha_core0$1.TOptional<_alepha_core0$1.TString>;
+declare const envSchema: _alepha_core6.TObject<{
+  REACT_SERVER_DIST: _alepha_core6.TString;
+  REACT_SERVER_PREFIX: _alepha_core6.TString;
+  REACT_SSR_ENABLED: _alepha_core6.TOptional<_alepha_core6.TBoolean>;
+  REACT_ROOT_ID: _alepha_core6.TString;
+  REACT_SERVER_TEMPLATE: _alepha_core6.TOptional<_alepha_core6.TString>;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
@@ -552,7 +575,7 @@ declare module "alepha" {
   }
 }
 declare class ReactServerProvider {
-  protected readonly log: _alepha_core0$1.Logger;
+  protected readonly log: _alepha_core6.Logger;
   protected readonly alepha: Alepha;
   protected readonly pageDescriptorProvider: PageDescriptorProvider;
   protected readonly serverStaticProvider: ServerStaticProvider;
@@ -566,7 +589,7 @@ declare class ReactServerProvider {
     REACT_ROOT_ID: string;
   };
   protected readonly ROOT_DIV_REGEX: RegExp;
-  readonly onConfigure: _alepha_core0$1.HookDescriptor<"configure">;
+  readonly onConfigure: _alepha_core6.HookDescriptor<"configure">;
   get template(): string;
   protected registerPages(templateLoader: TemplateLoader): Promise<void>;
   protected getPublicDirectory(): string;
@@ -647,5 +670,5 @@ declare const AlephaReact: _alepha_core0.ModuleDescriptor;
 //# sourceMappingURL=index.d.ts.map
 
 //#endregion
-export { $page, AlephaReact, AnchorProps, ClientOnly, CreateLayersResult, ErrorBoundary, HrefLike, Layer, Link, NestedView, NotFoundPage as NotFound, PageConfigSchema, PageDescriptor, PageDescriptorOptions, PageDescriptorProvider, PageDescriptorRenderOptions, PageDescriptorRenderResult, PageReactContext, PageRequest, PageRequestConfig, PageResolve, PageRoute, PageRouteEntry, PreviousLayerData, ReactBrowserProvider, ReactHydrationState, ReactServerProvider, RedirectionError, RouterContext, RouterContextValue, RouterGoOptions, RouterHookApi, RouterLayerContext, RouterLayerContextValue, RouterRenderResult, RouterStackItem, RouterState, TPropsDefault, TPropsParentDefault, TransitionOptions, UseActiveHook, UseQueryParamsHookOptions, VirtualRouter, isPageRoute, useActive, useAlepha, useClient, useInject, useQueryParams, useRouter, useRouterEvents, useRouterState };
+export { $page, AlephaContext, AlephaReact, AnchorProps, ClientOnly, CreateLayersResult, ErrorBoundary, HrefLike, Layer, Link, NestedView, NotFoundPage as NotFound, PageConfigSchema, PageDescriptor, PageDescriptorOptions, PageDescriptorProvider, PageDescriptorRenderOptions, PageDescriptorRenderResult, PageReactContext, PageRequest, PageRequestConfig, PageResolve, PageRoute, PageRouteEntry, PreviousLayerData, ReactBrowserProvider, ReactHydrationState, ReactServerProvider, RedirectionError, RouterContext, RouterContextValue, RouterGoOptions, RouterHookApi, RouterLayerContext, RouterLayerContextValue, RouterRenderResult, RouterStackItem, RouterState, TPropsDefault, TPropsParentDefault, TransitionOptions, UseActiveHook, UseQueryParamsHookOptions, UseSchemaReturn, VirtualRouter, isPageRoute, ssrSchemaLoading, useActive, useAlepha, useClient, useInject, useQueryParams, useRouter, useRouterEvents, useRouterState, useSchema, useStore };
 //# sourceMappingURL=index.d.ts.map

package/security.d.ts

@@ -4,8 +4,8 @@ import * as _alepha_core0 from "alepha";
 import { Alepha, Descriptor, KIND, Static } from "alepha";
 import { DateTimeProvider } from "alepha/datetime";
 import { CryptoKey, FlattenedJWSInput, JSONWebKeySet, JWSHeaderParameters, JWTHeaderParameters, JWTPayload, JWTVerifyResult, KeyObject } from "jose";
+import * as _sinclair_typebox13 from "@sinclair/typebox";
 import * as _sinclair_typebox0 from "@sinclair/typebox";
-import * as _sinclair_typebox9 from "@sinclair/typebox";
 
 //#region src/interfaces/UserAccountInfo.d.ts
 /**
@@ -55,25 +55,25 @@ interface UserAccountToken extends UserAccountInfo {
 //# sourceMappingURL=UserAccountToken.d.ts.map
 //#endregion
 //#region src/schemas/permissionSchema.d.ts
-declare const permissionSchema: _sinclair_typebox0.TObject<{
-  name: _sinclair_typebox0.TString;
-  group: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
-  description: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
-  method: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
-  path: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
+declare const permissionSchema: _sinclair_typebox13.TObject<{
+  name: _sinclair_typebox13.TString;
+  group: _sinclair_typebox13.TOptional<_sinclair_typebox13.TString>;
+  description: _sinclair_typebox13.TOptional<_sinclair_typebox13.TString>;
+  method: _sinclair_typebox13.TOptional<_sinclair_typebox13.TString>;
+  path: _sinclair_typebox13.TOptional<_sinclair_typebox13.TString>;
 }>;
 type Permission = Static<typeof permissionSchema>;
 //# sourceMappingURL=permissionSchema.d.ts.map
 //#endregion
 //#region src/schemas/roleSchema.d.ts
-declare const roleSchema: _sinclair_typebox9.TObject<{
-  name: _sinclair_typebox9.TString;
-  description: _sinclair_typebox9.TOptional<_sinclair_typebox9.TString>;
-  default: _sinclair_typebox9.TOptional<_sinclair_typebox9.TBoolean>;
-  permissions: _sinclair_typebox9.TArray<_sinclair_typebox9.TObject<{
-    name: _sinclair_typebox9.TString;
-    ownership: _sinclair_typebox9.TOptional<_sinclair_typebox9.TBoolean>;
-    exclude: _sinclair_typebox9.TOptional<_sinclair_typebox9.TArray<_sinclair_typebox9.TString>>;
+declare const roleSchema: _sinclair_typebox0.TObject<{
+  name: _sinclair_typebox0.TString;
+  description: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
+  default: _sinclair_typebox0.TOptional<_sinclair_typebox0.TBoolean>;
+  permissions: _sinclair_typebox0.TArray<_sinclair_typebox0.TObject<{
+    name: _sinclair_typebox0.TString;
+    ownership: _sinclair_typebox0.TOptional<_sinclair_typebox0.TBoolean>;
+    exclude: _sinclair_typebox0.TOptional<_sinclair_typebox0.TArray<_sinclair_typebox0.TString>>;
   }>>;
 }>;
 type Role = Static<typeof roleSchema>;

package/server/links.d.ts

@@ -19,6 +19,7 @@ declare class LinkProvider {
   pushLink(link: HttpClientLink): void;
   getLinks(force?: boolean): Promise<HttpClientLink[]>;
   client<T extends object>(scope?: ClientScope): HttpVirtualClient<T>;
+  protected createVirtualAction<T extends RequestConfigSchema>(name: string, scope?: ClientScope): VirtualAction<T>;
   /**
    * Resolve a link by its name and call it.
    * - If link is local, it will call the local handler.
@@ -41,11 +42,11 @@ interface ClientScope {
   group?: string;
   service?: string;
 }
-type HttpVirtualClient<T> = { [K in keyof T as T[K] extends ActionDescriptor<RequestConfigSchema> ? K : never]: T[K] extends ActionDescriptor<infer Schema> ? T[K] & {
-  (config?: ClientRequestEntry<Schema>, opts?: ClientRequestOptions): Promise<ClientRequestResponse<Schema>>;
+type HttpVirtualClient<T> = { [K in keyof T as T[K] extends ActionDescriptor<RequestConfigSchema> ? K : never]: T[K] extends ActionDescriptor<infer Schema> ? VirtualAction<Schema> : never };
+interface VirtualAction<T extends RequestConfigSchema> extends Pick<ActionDescriptor<T>, "name" | "run" | "fetch"> {
+  (config?: ClientRequestEntry<T>, opts?: ClientRequestOptions): Promise<ClientRequestResponse<T>>;
   can: () => boolean;
-  schema: Schema;
-} : never };
+}
 //# sourceMappingURL=LinkProvider.d.ts.map
 //#endregion
 //#region src/descriptors/$client.d.ts
@@ -198,5 +199,5 @@ declare const AlephaServerLinks: _alepha_core0.ModuleDescriptor;
 //# sourceMappingURL=index.d.ts.map
 
 //#endregion
-export { $client, $remote, AlephaServerLinks, ClientScope, FetchLinksOptions, GetLinksOptions, HttpClientLink, HttpVirtualClient, LinkProvider, RemoteDescriptor, RemoteDescriptorOptions, RemoteDescriptorProvider, ServerLinksProvider, ServerRemote };
+export { $client, $remote, AlephaServerLinks, ClientScope, FetchLinksOptions, GetLinksOptions, HttpClientLink, HttpVirtualClient, LinkProvider, RemoteDescriptor, RemoteDescriptorOptions, RemoteDescriptorProvider, ServerLinksProvider, ServerRemote, VirtualAction };
 //# sourceMappingURL=index.d.ts.map

package/server.d.ts

@@ -1,7 +1,7 @@
 import * as _alepha_core1 from "alepha";
 import * as _alepha_core0$1 from "alepha";
+import * as _alepha_core6 from "alepha";
 import * as _alepha_core2 from "alepha";
-import * as _alepha_core9 from "alepha";
 import * as _alepha_core13 from "alepha";
 import * as _alepha_core14 from "alepha";
 import * as _alepha_core0 from "alepha";
@@ -12,9 +12,9 @@ import { Route, RouterProvider } from "alepha/router";
 import * as _alepha_cache0 from "alepha/cache";
 import { IncomingMessage, ServerResponse as ServerResponse$1 } from "node:http";
 import { DateTimeProvider, DurationLike } from "alepha/datetime";
+import * as _sinclair_typebox17 from "@sinclair/typebox";
+import * as _sinclair_typebox7 from "@sinclair/typebox";
 import * as _sinclair_typebox0 from "@sinclair/typebox";
-import * as _sinclair_typebox33 from "@sinclair/typebox";
-import * as _sinclair_typebox25 from "@sinclair/typebox";
 import * as http0 from "http";
 
 //#region src/constants/routeMethods.d.ts
@@ -470,23 +470,23 @@ declare const isMultipart: (options: {
 //# sourceMappingURL=isMultipart.d.ts.map
 //#endregion
 //#region src/schemas/apiLinksResponseSchema.d.ts
-declare const apiLinkSchema: _sinclair_typebox0.TObject<{
-  name: _sinclair_typebox0.TString;
-  path: _sinclair_typebox0.TString;
-  method: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
-  group: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
-  requestBodyType: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
-  service: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
+declare const apiLinkSchema: _sinclair_typebox17.TObject<{
+  name: _sinclair_typebox17.TString;
+  path: _sinclair_typebox17.TString;
+  method: _sinclair_typebox17.TOptional<_sinclair_typebox17.TString>;
+  group: _sinclair_typebox17.TOptional<_sinclair_typebox17.TString>;
+  requestBodyType: _sinclair_typebox17.TOptional<_sinclair_typebox17.TString>;
+  service: _sinclair_typebox17.TOptional<_sinclair_typebox17.TString>;
 }>;
-declare const apiLinksResponseSchema: _sinclair_typebox0.TObject<{
-  prefix: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
-  links: _sinclair_typebox0.TArray<_sinclair_typebox0.TObject<{
-    name: _sinclair_typebox0.TString;
-    path: _sinclair_typebox0.TString;
-    method: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
-    group: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
-    requestBodyType: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
-    service: _sinclair_typebox0.TOptional<_sinclair_typebox0.TString>;
+declare const apiLinksResponseSchema: _sinclair_typebox17.TObject<{
+  prefix: _sinclair_typebox17.TOptional<_sinclair_typebox17.TString>;
+  links: _sinclair_typebox17.TArray<_sinclair_typebox17.TObject<{
+    name: _sinclair_typebox17.TString;
+    path: _sinclair_typebox17.TString;
+    method: _sinclair_typebox17.TOptional<_sinclair_typebox17.TString>;
+    group: _sinclair_typebox17.TOptional<_sinclair_typebox17.TString>;
+    requestBodyType: _sinclair_typebox17.TOptional<_sinclair_typebox17.TString>;
+    service: _sinclair_typebox17.TOptional<_sinclair_typebox17.TString>;
   }>>;
 }>;
 type ApiLinksResponse = Static<typeof apiLinksResponseSchema>;
@@ -494,31 +494,31 @@ type ApiLink = Static<typeof apiLinkSchema>;
 //# sourceMappingURL=apiLinksResponseSchema.d.ts.map
 //#endregion
 //#region src/schemas/errorSchema.d.ts
-declare const errorSchema: _sinclair_typebox33.TObject<{
-  error: _sinclair_typebox33.TString;
-  status: _sinclair_typebox33.TNumber;
-  message: _sinclair_typebox33.TString;
-  details: _sinclair_typebox33.TOptional<_sinclair_typebox33.TString>;
-  cause: _sinclair_typebox33.TOptional<_sinclair_typebox33.TObject<{
-    name: _sinclair_typebox33.TString;
-    message: _sinclair_typebox33.TString;
+declare const errorSchema: _sinclair_typebox7.TObject<{
+  error: _sinclair_typebox7.TString;
+  status: _sinclair_typebox7.TNumber;
+  message: _sinclair_typebox7.TString;
+  details: _sinclair_typebox7.TOptional<_sinclair_typebox7.TString>;
+  cause: _sinclair_typebox7.TOptional<_sinclair_typebox7.TObject<{
+    name: _sinclair_typebox7.TString;
+    message: _sinclair_typebox7.TString;
   }>>;
 }>;
 //# sourceMappingURL=errorSchema.d.ts.map
 //#endregion
 //#region src/schemas/okSchema.d.ts
-declare const okSchema: _sinclair_typebox25.TObject<{
-  ok: _sinclair_typebox25.TBoolean;
-  id: _sinclair_typebox25.TOptional<_sinclair_typebox25.TUnion<[_sinclair_typebox25.TString, _sinclair_typebox25.TInteger]>>;
-  count: _sinclair_typebox25.TOptional<_sinclair_typebox25.TNumber>;
+declare const okSchema: _sinclair_typebox0.TObject<{
+  ok: _sinclair_typebox0.TBoolean;
+  id: _sinclair_typebox0.TOptional<_sinclair_typebox0.TUnion<[_sinclair_typebox0.TString, _sinclair_typebox0.TInteger]>>;
+  count: _sinclair_typebox0.TOptional<_sinclair_typebox0.TNumber>;
 }>;
 type Ok = Static<typeof okSchema>;
 //# sourceMappingURL=okSchema.d.ts.map
 //#endregion
 //#region src/providers/NodeHttpServerProvider.d.ts
-declare const envSchema: _alepha_core2.TObject<{
-  SERVER_PORT: _alepha_core2.TNumber;
-  SERVER_HOST: _alepha_core2.TString;
+declare const envSchema: _alepha_core6.TObject<{
+  SERVER_PORT: _alepha_core6.TNumber;
+  SERVER_HOST: _alepha_core6.TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
@@ -526,31 +526,31 @@ declare module "alepha" {
 declare class NodeHttpServerProvider extends ServerProvider {
   protected readonly alepha: Alepha;
   protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly log: _alepha_core2.Logger;
+  protected readonly log: _alepha_core6.Logger;
   protected readonly env: {
     SERVER_PORT: number;
     SERVER_HOST: string;
   };
   protected readonly router: ServerRouterProvider;
   protected readonly server: http0.Server<typeof IncomingMessage, typeof ServerResponse$1>;
-  protected readonly onNodeRequest: _alepha_core2.HookDescriptor<"node:request">;
+  protected readonly onNodeRequest: _alepha_core6.HookDescriptor<"node:request">;
   handle(req: IncomingMessage, res: ServerResponse$1): Promise<void>;
   createRouterRequest(req: IncomingMessage, res: ServerResponse$1, params?: Record<string, string>): ServerRawRequest;
   getProtocol(req: IncomingMessage): "http" | "https";
   get hostname(): string;
-  readonly start: _alepha_core2.HookDescriptor<"start">;
-  protected readonly stop: _alepha_core2.HookDescriptor<"stop">;
+  readonly start: _alepha_core6.HookDescriptor<"start">;
+  protected readonly stop: _alepha_core6.HookDescriptor<"stop">;
   protected listen(): Promise<void>;
   protected close(): Promise<void>;
 }
 //#endregion
 //#region src/providers/ServerLoggerProvider.d.ts
 declare class ServerLoggerProvider {
-  protected readonly log: _alepha_core9.Logger;
+  protected readonly log: _alepha_core2.Logger;
   protected readonly alepha: Alepha;
-  readonly onRequest: _alepha_core9.HookDescriptor<"server:onRequest">;
-  readonly onError: _alepha_core9.HookDescriptor<"server:onError">;
-  readonly onResponse: _alepha_core9.HookDescriptor<"server:onResponse">;
+  readonly onRequest: _alepha_core2.HookDescriptor<"server:onRequest">;
+  readonly onError: _alepha_core2.HookDescriptor<"server:onError">;
+  readonly onResponse: _alepha_core2.HookDescriptor<"server:onResponse">;
 }
 //# sourceMappingURL=ServerLoggerProvider.d.ts.map
 //#endregion

package/topic.d.ts

@@ -1,5 +1,5 @@
-import * as _alepha_core2 from "alepha";
 import * as _alepha_core0$1 from "alepha";
+import * as _alepha_core1 from "alepha";
 import * as _alepha_core0 from "alepha";
 import { Alepha, Descriptor, KIND, Service, Static, TSchema } from "alepha";
 import { DateTimeProvider, DurationLike } from "alepha/datetime";
@@ -76,7 +76,7 @@ interface TopicDescriptorOptions<T extends TopicMessageSchema> {
   handler?: TopicHandler<T>;
 }
 declare class TopicDescriptor<T extends TopicMessageSchema> extends Descriptor<TopicDescriptorOptions<T>> {
-  protected readonly log: _alepha_core2.Logger;
+  protected readonly log: _alepha_core0$1.Logger;
   protected readonly dateTimeProvider: DateTimeProvider;
   readonly provider: TopicProvider;
   get name(): string;
@@ -127,9 +127,9 @@ declare class TopicTimeoutError extends Error {
 //#endregion
 //#region src/providers/MemoryTopicProvider.d.ts
 declare class MemoryTopicProvider extends TopicProvider {
-  protected readonly log: _alepha_core0$1.Logger;
+  protected readonly log: _alepha_core1.Logger;
   protected readonly subscriptions: Record<string, SubscribeCallback[]>;
-  protected readonly start: _alepha_core0$1.HookDescriptor<"start">;
+  protected readonly start: _alepha_core1.HookDescriptor<"start">;
   /**
    * Publish a message to a topic.
    *