alepha 0.9.0 → 0.9.2

package/command.d.ts

@@ -14,9 +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>;
+  (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;
@@ -24,6 +35,7 @@ declare class Runner {
   protected readonly startTime: number;
   readonly run: RunnerMethod;
   constructor(log: Logger);
+  protected createRunMethod(): RunnerMethod;
   protected exec(cmd: string): Promise<string>;
   /**
    * Executes one or more tasks.
@@ -73,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<{}>;
@@ -140,8 +156,18 @@ declare class CliProvider {
  * @module alepha.command
  */
 declare const AlephaCommand: _alepha_core0.ModuleDescriptor;
+declare module "@sinclair/typebox" {
+  interface StringOptions {
+    /**
+     * Additional aliases for the flags.
+     *
+     * @module alepha.command
+     */
+    aliases?: string[];
+  }
+}
 //# 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;
 }
@@ -495,7 +496,10 @@ declare class Alepha {
    * Modules are used to group services and provide a way to register them in the container.
    */
   protected modules: Array<ModuleDefinition>;
-  protected substitutions: Map<Service, Service>;
+  protected substitutions: Map<Service, {
+    use: Service;
+    module?: ModuleDefinition;
+  }>;
   protected configurations: Map<Service, object>;
   protected descriptorRegistry: Map<Service<Descriptor<{}>>, Descriptor<{}>[]>;
   /**
@@ -629,10 +633,12 @@ declare class Alepha {
    * > It's useful for testing or for providing different implementations of a service.
    * > If you are interested in configuring a service, use Alepha#configure() instead.
    *
-   * @param entry - The service to register in the container.
+   * @param serviceEntry - The service to register in the container.
    * @return Current instance of Alepha.
    */
-  with<T extends object>(entry: ServiceEntry<T>): this;
+  with<T extends object>(serviceEntry: ServiceEntry<T> | {
+    default: ServiceEntry<T>;
+  }): this;
   /**
    * Get the instance of the specified service and apply some changes, depending on the options.
    * - If the service is already registered, it will return the existing instance. (except if `skipCache` is true)
@@ -814,14 +820,6 @@ interface Env extends LoggerEnv {
    * Optional root module name.
    */
   MODULE_NAME?: string;
-  /**
-   * If true, the container will not automatically register the default providers based on the descriptors.
-   *
-   * It means that you have to alepha.with(ServiceModule) manually. No magic.
-   *
-   * @default false
-   */
-  EXPLICIT_PROVIDERS?: boolean;
 }
 interface State {
   log: Logger;
@@ -1436,6 +1434,14 @@ declare function isEmail(value: string): boolean;
 //# sourceMappingURL=TypeProvider.d.ts.map
 //#endregion
 //#region src/index.d.ts
+declare global {
+  interface ImportMetaEnv {
+    SSR: boolean;
+  }
+  interface ImportMeta {
+    readonly env: ImportMetaEnv;
+  }
+}
 /**
  *
  */

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.0",
+	"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.0",
-		"@alepha/bucket": "0.9.0",
-		"@alepha/cache": "0.9.0",
-		"@alepha/cache-redis": "0.9.0",
-		"@alepha/command": "0.9.0",
-		"@alepha/core": "0.9.0",
-		"@alepha/datetime": "0.9.0",
-		"@alepha/file": "0.9.0",
-		"@alepha/lock": "0.9.0",
-		"@alepha/lock-redis": "0.9.0",
-		"@alepha/postgres": "0.9.0",
-		"@alepha/queue": "0.9.0",
-		"@alepha/queue-redis": "0.9.0",
-		"@alepha/react": "0.9.0",
-		"@alepha/react-auth": "0.9.0",
-		"@alepha/react-head": "0.9.0",
-		"@alepha/redis": "0.9.0",
-		"@alepha/retry": "0.9.0",
-		"@alepha/router": "0.9.0",
-		"@alepha/scheduler": "0.9.0",
-		"@alepha/security": "0.9.0",
-		"@alepha/server": "0.9.0",
-		"@alepha/server-cache": "0.9.0",
-		"@alepha/server-compress": "0.9.0",
-		"@alepha/server-cookies": "0.9.0",
-		"@alepha/server-cors": "0.9.0",
-		"@alepha/server-health": "0.9.0",
-		"@alepha/server-helmet": "0.9.0",
-		"@alepha/server-links": "0.9.0",
-		"@alepha/server-metrics": "0.9.0",
-		"@alepha/server-multipart": "0.9.0",
-		"@alepha/server-proxy": "0.9.0",
-		"@alepha/server-security": "0.9.0",
-		"@alepha/server-static": "0.9.0",
-		"@alepha/server-swagger": "0.9.0",
-		"@alepha/testing": "0.9.0",
-		"@alepha/topic": "0.9.0",
-		"@alepha/topic-redis": "0.9.0",
-		"@alepha/vite": "0.9.0"
+		"@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

@@ -18,9 +18,9 @@ import { PostgresJsDatabase } from "drizzle-orm/postgres-js";
 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_typebox17 from "@sinclair/typebox";
 import * as _sinclair_typebox18 from "@sinclair/typebox";
-import * as _sinclair_typebox16 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";
@@ -1398,7 +1398,7 @@ declare class NodePostgresProvider extends PostgresProvider {
 type PgAttr<T extends TSchema$1, TAttr extends PgSymbolKeys> = T & { [K in TAttr]: PgSymbols[K] };
 //#endregion
 //#region src/schemas/createdAtSchema.d.ts
-declare const createdAtSchema: PgAttr<PgAttr<_sinclair_typebox17.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+declare const createdAtSchema: PgAttr<PgAttr<_sinclair_typebox16.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
 //# sourceMappingURL=createdAtSchema.d.ts.map
 
 //#endregion
@@ -1406,11 +1406,11 @@ declare const createdAtSchema: PgAttr<PgAttr<_sinclair_typebox17.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_typebox16.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_core8 from "alepha";
-import * as _alepha_core14 from "alepha";
-import * as _alepha_core12 from "alepha";
+import * as _alepha_core2 from "alepha";
+import * as _alepha_core16 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_runtime1 from "react/jsx-runtime";
+import * as react_jsx_runtime0$1 from "react/jsx-runtime";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
-import * as react_jsx_runtime2 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_core8.TObject<{
-  REACT_STRICT_MODE: _alepha_core8.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_core8.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_core8.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;
@@ -272,11 +273,11 @@ interface BrowserRoute extends Route {
   page: PageRoute;
 }
 declare class BrowserRouterProvider extends RouterProvider<BrowserRoute> {
-  protected readonly log: _alepha_core14.Logger;
+  protected readonly log: _alepha_core16.Logger;
   protected readonly alepha: Alepha;
   protected readonly pageDescriptorProvider: PageDescriptorProvider;
   add(entry: PageRouteEntry): void;
-  protected readonly configure: _alepha_core14.HookDescriptor<"configure">;
+  protected readonly configure: _alepha_core16.HookDescriptor<"configure">;
   transition(url: URL, options?: TransitionOptions): Promise<RouterRenderResult>;
   root(state: RouterState, context: PageReactContext): ReactNode;
 }
@@ -284,7 +285,7 @@ declare class BrowserRouterProvider extends RouterProvider<BrowserRoute> {
 //#endregion
 //#region src/providers/ReactBrowserProvider.d.ts
 declare class ReactBrowserProvider {
-  protected readonly log: _alepha_core12.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_core12.HookDescriptor<"ready">;
+  readonly ready: _alepha_core0$1.HookDescriptor<"ready">;
 }
 interface RouterGoOptions {
   replace?: boolean;
@@ -366,7 +367,7 @@ interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
   to: string | PageDescriptor;
   children?: React.ReactNode;
 }
-declare const Link: (props: LinkProps) => react_jsx_runtime1.JSX.Element | null;
+declare const Link: (props: LinkProps) => react_jsx_runtime0$1.JSX.Element | null;
 //#endregion
 //#region src/components/NestedView.d.ts
 interface NestedViewProps {
@@ -396,16 +397,19 @@ interface NestedViewProps {
 declare const NestedView: (props: NestedViewProps) => react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/components/NotFound.d.ts
-declare function NotFoundPage(): react_jsx_runtime2.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,24 +539,43 @@ 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;
+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>> {}
   interface State {
-    "react.server.template"?: string;
     "react.server.ssr"?: boolean;
   }
 }
 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;
@@ -560,12 +583,13 @@ declare class ReactServerProvider {
   protected readonly serverTimingProvider: ServerTimingProvider;
   protected readonly env: {
     REACT_SSR_ENABLED?: boolean | undefined;
+    REACT_SERVER_TEMPLATE?: string | undefined;
     REACT_SERVER_DIST: string;
     REACT_SERVER_PREFIX: string;
     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;
@@ -646,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/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/security.d.ts

@@ -62,7 +62,9 @@ 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 | {
+      optional?: boolean;
+    };
   }
   interface ClientRequestOptions extends FetchOptions {
     /**

package/server.d.ts

@@ -1,9 +1,9 @@
 import * as _alepha_core1 from "alepha";
 import * as _alepha_core0$1 from "alepha";
-import * as _alepha_core5 from "alepha";
-import * as _alepha_core13 from "alepha";
-import * as _alepha_core12 from "alepha";
+import * as _alepha_core6 from "alepha";
 import * as _alepha_core2 from "alepha";
+import * as _alepha_core13 from "alepha";
+import * as _alepha_core14 from "alepha";
 import * as _alepha_core0 from "alepha";
 import { Alepha, Async, Descriptor, FileLike, KIND, Static, StreamLike, TObject, TSchema } from "alepha";
 import { Readable } from "node:stream";
@@ -11,9 +11,9 @@ import { ReadableStream } from "node:stream/web";
 import { Route, RouterProvider } from "alepha/router";
 import * as _alepha_cache0 from "alepha/cache";
 import { IncomingMessage, ServerResponse as ServerResponse$1 } from "node:http";
-import { DurationLike } from "alepha/datetime";
+import { DateTimeProvider, DurationLike } from "alepha/datetime";
+import * as _sinclair_typebox17 from "@sinclair/typebox";
 import * as _sinclair_typebox7 from "@sinclair/typebox";
-import * as _sinclair_typebox33 from "@sinclair/typebox";
 import * as _sinclair_typebox0 from "@sinclair/typebox";
 import * as http0 from "http";
 
@@ -470,23 +470,23 @@ declare const isMultipart: (options: {
 //# sourceMappingURL=isMultipart.d.ts.map
 //#endregion
 //#region src/schemas/apiLinksResponseSchema.d.ts
-declare const apiLinkSchema: _sinclair_typebox7.TObject<{
-  name: _sinclair_typebox7.TString;
-  path: _sinclair_typebox7.TString;
-  method: _sinclair_typebox7.TOptional<_sinclair_typebox7.TString>;
-  group: _sinclair_typebox7.TOptional<_sinclair_typebox7.TString>;
-  requestBodyType: _sinclair_typebox7.TOptional<_sinclair_typebox7.TString>;
-  service: _sinclair_typebox7.TOptional<_sinclair_typebox7.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_typebox7.TObject<{
-  prefix: _sinclair_typebox7.TOptional<_sinclair_typebox7.TString>;
-  links: _sinclair_typebox7.TArray<_sinclair_typebox7.TObject<{
-    name: _sinclair_typebox7.TString;
-    path: _sinclair_typebox7.TString;
-    method: _sinclair_typebox7.TOptional<_sinclair_typebox7.TString>;
-    group: _sinclair_typebox7.TOptional<_sinclair_typebox7.TString>;
-    requestBodyType: _sinclair_typebox7.TOptional<_sinclair_typebox7.TString>;
-    service: _sinclair_typebox7.TOptional<_sinclair_typebox7.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,14 +494,14 @@ 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
@@ -516,40 +516,41 @@ type Ok = Static<typeof okSchema>;
 //# sourceMappingURL=okSchema.d.ts.map
 //#endregion
 //#region src/providers/NodeHttpServerProvider.d.ts
-declare const envSchema: _alepha_core5.TObject<{
-  SERVER_PORT: _alepha_core5.TNumber;
-  SERVER_HOST: _alepha_core5.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>> {}
 }
 declare class NodeHttpServerProvider extends ServerProvider {
   protected readonly alepha: Alepha;
-  protected readonly log: _alepha_core5.Logger;
+  protected readonly dateTimeProvider: DateTimeProvider;
+  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_core5.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_core5.HookDescriptor<"start">;
-  protected readonly stop: _alepha_core5.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_core13.Logger;
+  protected readonly log: _alepha_core2.Logger;
   protected readonly alepha: Alepha;
-  readonly onRequest: _alepha_core13.HookDescriptor<"server:onRequest">;
-  readonly onError: _alepha_core13.HookDescriptor<"server:onError">;
-  readonly onResponse: _alepha_core13.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
@@ -563,17 +564,17 @@ declare class ServerLoggerProvider {
  */
 declare class ServerNotReadyProvider {
   protected readonly alepha: Alepha;
-  readonly onRequest: _alepha_core12.HookDescriptor<"server:onRequest">;
+  readonly onRequest: _alepha_core13.HookDescriptor<"server:onRequest">;
 }
 //# sourceMappingURL=ServerNotReadyProvider.d.ts.map
 //#endregion
 //#region src/providers/ServerTimingProvider.d.ts
 type TimingMap = Record<string, [number, number]>;
 declare class ServerTimingProvider {
-  protected readonly log: _alepha_core2.Logger;
+  protected readonly log: _alepha_core14.Logger;
   protected readonly alepha: Alepha;
-  readonly onRequest: _alepha_core2.HookDescriptor<"server:onRequest">;
-  readonly onResponse: _alepha_core2.HookDescriptor<"server:onResponse">;
+  readonly onRequest: _alepha_core14.HookDescriptor<"server:onRequest">;
+  readonly onResponse: _alepha_core14.HookDescriptor<"server:onResponse">;
   protected get handlerName(): string;
   beginTiming(name: string): void;
   endTiming(name: string): void;