alepha 0.11.5 → 0.11.6

package/queue/redis.d.ts

@@ -23,7 +23,7 @@ declare class RedisQueueProvider implements QueueProvider {
  * @see {@link RedisQueueProvider}
  * @module alepha.queue.redis
  */
-declare const AlephaQueueRedis: _alepha_core0.Service<_alepha_core0.Module<{}>>;
+declare const AlephaQueueRedis: _alepha_core0.Service<_alepha_core0.Module>;
 //#endregion
 export { AlephaQueueRedis, RedisQueueProvider };
 //# sourceMappingURL=index.d.ts.map

package/queue.d.ts

@@ -754,7 +754,7 @@ declare class ConsumerDescriptor<T extends TSchema> extends Descriptor<ConsumerD
  * @see {@link $consumer}
  * @module alepha.queue
  */
-declare const AlephaQueue: _alepha_core1.Service<_alepha_core1.Module<{}>>;
+declare const AlephaQueue: _alepha_core1.Service<_alepha_core1.Module>;
 //#endregion
 export { $consumer, $queue, AlephaQueue, ConsumerDescriptor, ConsumerDescriptorOptions, MemoryQueueProvider, QueueDescriptor, QueueDescriptorOptions, QueueMessage, QueueMessageSchema, QueueProvider };
 //# sourceMappingURL=index.d.ts.map

package/react/auth.d.ts

@@ -479,7 +479,12 @@ declare const useAuth: <T extends object = any>() => {
 //#region src/index.d.ts
 declare module "alepha" {
   interface State {
-    user?: UserAccount;
+    /**
+     * The authenticated user account attached to the server request state.
+     *
+     * @internal
+     */
+    "alepha.server.request.user"?: UserAccount;
   }
 }
 declare module "alepha/react" {
@@ -493,7 +498,7 @@ declare module "alepha/react" {
  * @see {@link ReactAuthProvider}
  * @module alepha.react.auth
  */
-declare const AlephaReactAuth: _alepha_core4.Service<_alepha_core4.Module<{}>>;
+declare const AlephaReactAuth: _alepha_core4.Service<_alepha_core4.Module>;
 //#endregion
 export { $auth, AccessToken, AlephaReactAuth, AuthDescriptor, AuthDescriptorOptions, AuthExternal, AuthInternal, CredentialsOptions, OAuth2Options, OAuth2Profile, OidcOptions, ReactAuth, ReactAuthProvider, SessionExpiredError, useAuth };
 //# sourceMappingURL=index.d.ts.map

package/react/form.d.ts

@@ -4,6 +4,15 @@ import { InputHTMLAttributes, ReactNode } from "react";
 import * as _alepha_logger0 from "alepha/logger";
 
 //#region src/services/FormModel.d.ts
+
+/**
+ * FormModel is a dynamic form handler that generates form inputs based on a provided TypeBox schema.
+ * It manages form state, handles input changes, and processes form submissions with validation.
+ *
+ * It means to be injected and used within React components to provide a structured way to create and manage forms.
+ *
+ * @see {@link useForm}
+ */
 declare class FormModel<T extends TObject> {
   readonly id: string;
   readonly options: FormCtrlOptions<T>;
@@ -12,16 +21,26 @@ declare class FormModel<T extends TObject> {
   protected readonly values: Record<string, any>;
   input: SchemaToInput<T>;
   constructor(id: string, options: FormCtrlOptions<T>);
+  get element(): HTMLFormElement;
   get currentValues(): Record<string, any>;
   get props(): {
+    id: string;
     noValidate: boolean;
-    onSubmit: (values: FormEventLike) => Promise<void>;
+    onSubmit: (ev?: FormEventLike) => void;
     onReset: (event: FormEventLike) => Promise<void>;
   };
-  protected readonly reset: (event: FormEventLike) => Promise<void>;
-  protected readonly submit: (event: FormEventLike) => Promise<void>;
-  protected parseValuesFromFormElement<T extends TObject>(options: FormCtrlOptions<T>, store: Record<string, any>): Record<string, any>;
-  protected getValueFromInputObject<T extends TObject>(options: FormCtrlOptions<T>, values: Record<string, any>, key: string, value: FormDataEntryValue): void;
+  readonly reset: (event: FormEventLike) => Promise<void>;
+  readonly submit: () => Promise<void>;
+  /**
+   * Restructures flat keys like "address.city" into nested objects like { address: { city: ... } }
+   * Values are already typed from onChange, so no conversion is needed.
+   */
+  protected restructureValues(store: Record<string, any>): Record<string, any>;
+  /**
+   * Helper to restructure a flat key like "address.city" into nested object structure.
+   * The value is already typed, so we just assign it to the nested path.
+   */
+  protected restructureNestedValue(values: Record<string, any>, key: string, value: any): void;
   protected createProxyFromSchema<T extends TObject>(options: FormCtrlOptions<T>, schema: TSchema, context: {
     parent: string;
     store: Record<string, any>;
@@ -31,16 +50,16 @@ declare class FormModel<T extends TObject> {
     store: Record<string, any>;
   }): InputField;
   /**
-   * Convert an input value from HTML to the correct type based on the schema.
+   * Convert an input value to the correct type based on the schema.
+   * Handles raw DOM values (strings, booleans from checkboxes, Files, etc.)
    */
-  protected getValueFromInput(input: FormDataEntryValue, schema: TSchema): any;
+  protected getValueFromInput(input: any, schema: TSchema): any;
   protected valueToInputEntry(value: any): string | number | boolean;
 }
 type SchemaToInput<T extends TObject> = { [K in keyof T["properties"]]: T["properties"][K] extends TObject ? SchemaToInput<T["properties"][K]> : InputField };
 interface FormEventLike {
-  currentTarget: any;
-  preventDefault: () => void;
-  stopPropagation: () => void;
+  preventDefault?: () => void;
+  stopPropagation?: () => void;
 }
 interface InputField {
   path: string;
@@ -90,6 +109,7 @@ type FormCtrlOptions<T extends TObject> = {
     form: HTMLFormElement;
   }) => void;
   onChange?: (key: string, value: any, store: Record<string, any>) => void;
+  onReset?: () => void;
 };
 //#endregion
 //#region src/components/FormState.d.ts
@@ -122,15 +142,15 @@ declare const FormState: <T extends TObject>(props: {
  * });
  *
  * return (
- *   <form onSubmit={form.onSubmit}>
- *     <input {...form.input("username")} />
- *     <input {...form.input("password")} />
+ *   <form {...form.props}>
+ *     <input {...form.input.username.props} />
+ *     <input {...form.input.password.props} />
  *     <button type="submit">Submit</button>
  *   </form>
  * );
  * ```
  */
-declare const useForm: <T extends TObject>(options: FormCtrlOptions<T>) => FormModel<T>;
+declare const useForm: <T extends TObject>(options: FormCtrlOptions<T>, deps?: any[]) => FormModel<T>;
 //#endregion
 //#region src/hooks/useFormState.d.ts
 interface UseFormStateReturn {
@@ -182,7 +202,7 @@ declare module "alepha" {
  * @see {@link useForm}
  * @module alepha.react.form
  */
-declare const AlephaReactForm: _alepha_core0.Service<_alepha_core0.Module<{}>>;
+declare const AlephaReactForm: _alepha_core0.Service<_alepha_core0.Module>;
 //#endregion
 export { AlephaReactForm, FormCtrlOptions, FormEventLike, FormModel, FormState, InputField, InputHTMLAttributesLike, SchemaToInput, UseFormStateReturn, useForm, useFormState };
 //# sourceMappingURL=index.d.ts.map

package/react/head.d.ts

@@ -114,7 +114,7 @@ declare module "alepha/react" {
  * @see {@link ServerHeadProvider}
  * @module alepha.react.head
  */
-declare const AlephaReactHead: _alepha_core1.Service<_alepha_core1.Module<{}>>;
+declare const AlephaReactHead: _alepha_core1.Service<_alepha_core1.Module>;
 //#endregion
 export { $head, AlephaReactHead, Head, HeadDescriptor, HeadDescriptorOptions, ServerHeadProvider, SimpleHead, UseHeadOptions, UseHeadReturn, useHead };
 //# sourceMappingURL=index.d.ts.map

package/react/i18n.d.ts

@@ -152,7 +152,7 @@ declare class DictionaryDescriptor<T extends Record<string, string>> extends Des
 //#region src/index.d.ts
 declare module "alepha" {
   interface State {
-    "react.i18n.lang"?: string;
+    "alepha.react.i18n.lang"?: string;
   }
 }
 /**
@@ -162,7 +162,7 @@ declare module "alepha" {
  *
  * @module alepha.react.i18n
  */
-declare const AlephaReactI18n: _alepha_core1.Service<_alepha_core1.Module<{}>>;
+declare const AlephaReactI18n: _alepha_core1.Service<_alepha_core1.Module>;
 //#endregion
 export { $dictionary, AlephaReactI18n, DictionaryDescriptor, DictionaryDescriptorOptions, I18nLocalizeOptions, I18nLocalizeType, I18nProvider, Localize, type LocalizeProps, ServiceDictionary, useI18n };
 //# sourceMappingURL=index.d.ts.map

package/react.d.ts

@@ -1,5 +1,5 @@
-import * as _alepha_core10 from "alepha";
-import { Alepha, Async, Configurable, Descriptor, Hook, Hooks, KIND, Service, State, Static, TObject, TSchema } from "alepha";
+import * as _alepha_core14 from "alepha";
+import { Alepha, Async, Descriptor, Hook, Hooks, KIND, Service, State, Static, TObject, TSchema } from "alepha";
 import { DateTimeProvider, DurationLike } from "alepha/datetime";
 import { RequestConfigSchema, ServerHandler, ServerProvider, ServerRequest, ServerRouterProvider, ServerTimingProvider } from "alepha/server";
 import { ServerRouteCache } from "alepha/server/cache";
@@ -8,8 +8,9 @@ import * as _alepha_logger0 from "alepha/logger";
 import * as react0 from "react";
 import React, { AnchorHTMLAttributes, CSSProperties, DependencyList, ErrorInfo, FC, PropsWithChildren, ReactNode } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
-import { ServeDescriptorOptions, ServerStaticProvider } from "alepha/server/static";
+import { ServerStaticProvider } from "alepha/server/static";
 import { Route, RouterProvider } from "alepha/router";
+import * as typebox0 from "typebox";
 
 //#region src/components/ClientOnly.d.ts
 interface ClientOnlyProps {
@@ -40,8 +41,8 @@ declare class Redirection extends Error {
 }
 //#endregion
 //#region src/providers/ReactPageProvider.d.ts
-declare const envSchema$2: _alepha_core10.TObject<{
-  REACT_STRICT_MODE: _alepha_core10.TBoolean;
+declare const envSchema$2: _alepha_core14.TObject<{
+  REACT_STRICT_MODE: _alepha_core14.TBoolean;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$2>> {}
@@ -84,7 +85,7 @@ declare class ReactPageProvider {
   }, params?: Record<string, any>): string;
   compile(path: string, params?: Record<string, string>): string;
   protected renderView(index: number, path: string, view: ReactNode | undefined, page: PageRoute): ReactNode;
-  protected readonly configure: _alepha_core10.HookDescriptor<"configure">;
+  protected readonly configure: _alepha_core14.HookDescriptor<"configure">;
   protected map(pages: Array<PageDescriptor>, target: PageDescriptor): PageRouteEntry;
   add(entry: PageRouteEntry): void;
   protected createMatch(page: PageRoute): string;
@@ -502,20 +503,29 @@ declare class ReactBrowserRouterProvider extends RouterProvider<BrowserRoute> {
   protected readonly alepha: Alepha;
   protected readonly pageApi: ReactPageProvider;
   add(entry: PageRouteEntry): void;
-  protected readonly configure: _alepha_core10.HookDescriptor<"configure">;
+  protected readonly configure: _alepha_core14.HookDescriptor<"configure">;
   transition(url: URL, previous?: PreviousLayerData[], meta?: {}): Promise<string | void>;
   root(state: ReactRouterState): ReactNode;
 }
 //#endregion
 //#region src/providers/ReactBrowserProvider.d.ts
-declare const envSchema$1: _alepha_core10.TObject<{
-  REACT_ROOT_ID: _alepha_core10.TString;
+declare const envSchema$1: _alepha_core14.TObject<{
+  REACT_ROOT_ID: _alepha_core14.TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$1>> {}
 }
-interface ReactBrowserRendererOptions {
-  scrollRestoration?: "top" | "manual";
+/**
+ * React browser renderer configuration atom
+ */
+declare const reactBrowserOptions: _alepha_core14.Atom<_alepha_core14.TObject<{
+  scrollRestoration: typebox0.TUnsafe<"top" | "manual">;
+}>, "alepha.react.browser.options">;
+type ReactBrowserRendererOptions = Static<typeof reactBrowserOptions.schema>;
+declare module "alepha" {
+  interface State {
+    [reactBrowserOptions.key]: ReactBrowserRendererOptions;
+  }
 }
 declare class ReactBrowserProvider {
   protected readonly env: {
@@ -526,7 +536,9 @@ declare class ReactBrowserProvider {
   protected readonly alepha: Alepha;
   protected readonly router: ReactBrowserRouterProvider;
   protected readonly dateTimeProvider: DateTimeProvider;
-  options: ReactBrowserRendererOptions;
+  protected readonly options: Readonly<{
+    scrollRestoration: "top" | "manual";
+  }>;
   protected getRootElement(): HTMLElement;
   transitioning?: {
     to: string;
@@ -555,8 +567,8 @@ declare class ReactBrowserProvider {
    * Get embedded layers from the server.
    */
   protected getHydrationState(): ReactHydrationState | undefined;
-  protected readonly onTransitionEnd: _alepha_core10.HookDescriptor<"react:transition:end">;
-  readonly ready: _alepha_core10.HookDescriptor<"ready">;
+  protected readonly onTransitionEnd: _alepha_core14.HookDescriptor<"react:transition:end">;
+  readonly ready: _alepha_core14.HookDescriptor<"ready">;
 }
 interface RouterGoOptions {
   replace?: boolean;
@@ -1055,34 +1067,39 @@ declare const ssrSchemaLoading: (alepha: Alepha, name: string) => RequestConfigS
 declare const useStore: <Key extends keyof State>(key: Key, defaultValue?: State[Key]) => [State[Key], (value: State[Key]) => void];
 //#endregion
 //#region src/providers/ReactServerProvider.d.ts
-declare const envSchema: _alepha_core10.TObject<{
-  REACT_SERVER_DIST: _alepha_core10.TString;
-  REACT_SERVER_PREFIX: _alepha_core10.TString;
-  REACT_SSR_ENABLED: _alepha_core10.TOptional<_alepha_core10.TBoolean>;
-  REACT_ROOT_ID: _alepha_core10.TString;
-  REACT_SERVER_TEMPLATE: _alepha_core10.TOptional<_alepha_core10.TString>;
+declare const envSchema: _alepha_core14.TObject<{
+  REACT_SSR_ENABLED: _alepha_core14.TOptional<_alepha_core14.TBoolean>;
+  REACT_ROOT_ID: _alepha_core14.TString;
+  REACT_SERVER_TEMPLATE: _alepha_core14.TOptional<_alepha_core14.TString>;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
   interface State {
-    "react.server.ssr"?: boolean;
+    "alepha.react.server.ssr"?: boolean;
   }
 }
-interface ReactServerProviderOptions {
-  /**
-   * Override default options for the static file server.
-   * > Static file server is only created in non-serverless production mode.
-   */
-  static?: Partial<Omit<ServeDescriptorOptions, "root">>;
+/**
+ * React server provider configuration atom
+ */
+declare const reactServerOptions: _alepha_core14.Atom<_alepha_core14.TObject<{
+  publicDir: _alepha_core14.TString;
+  staticServer: _alepha_core14.TObject<{
+    disabled: _alepha_core14.TBoolean;
+    path: _alepha_core14.TString;
+  }>;
+}>, "alepha.react.server.options">;
+type ReactServerProviderOptions = Static<typeof reactServerOptions.schema>;
+declare module "alepha" {
+  interface State {
+    [reactServerOptions.key]: ReactServerProviderOptions;
+  }
 }
-declare class ReactServerProvider implements Configurable {
+declare class ReactServerProvider {
   protected readonly log: _alepha_logger0.Logger;
   protected readonly alepha: Alepha;
   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 pageApi: ReactPageProvider;
@@ -1092,11 +1109,17 @@ declare class ReactServerProvider implements Configurable {
   protected readonly serverTimingProvider: ServerTimingProvider;
   readonly ROOT_DIV_REGEX: RegExp;
   protected preprocessedTemplate: PreprocessedTemplate | null;
-  options: ReactServerProviderOptions;
+  protected readonly options: Readonly<{
+    publicDir: string;
+    staticServer: {
+      disabled: boolean;
+      path: string;
+    };
+  }>;
   /**
    * Configure the React server provider.
    */
-  readonly onConfigure: _alepha_core10.HookDescriptor<"configure">;
+  readonly onConfigure: _alepha_core14.HookDescriptor<"configure">;
   get template(): string;
   protected registerPages(templateLoader: TemplateLoader): Promise<void>;
   /**
@@ -1133,7 +1156,7 @@ interface PreprocessedTemplate {
 //#region src/index.d.ts
 declare module "alepha" {
   interface State {
-    "react.router.state"?: ReactRouterState;
+    "alepha.react.router.state"?: ReactRouterState;
   }
   interface Hooks {
     /**
@@ -1232,7 +1255,7 @@ declare module "alepha" {
  * @see {@link $page}
  * @module alepha.react
  */
-declare const AlephaReact: _alepha_core10.Service<_alepha_core10.Module<{}>>;
+declare const AlephaReact: _alepha_core14.Service<_alepha_core14.Module>;
 //#endregion
-export { $page, ActionContext, AlephaContext, AlephaReact, AnchorProps, ClientOnly, CreateLayersResult, ErrorBoundary, ErrorHandler, ErrorViewer, Layer, Link, type LinkProps, _default as NestedView, NotFoundPage as NotFound, PageAnimation, PageConfigSchema, PageDescriptor, PageDescriptorOptions, PageDescriptorRenderOptions, PageDescriptorRenderResult, PageRequestConfig, PageResolve, PageRoute, PageRouteEntry, PreviousLayerData, ReactBrowserProvider, ReactBrowserRendererOptions, ReactHydrationState, ReactPageProvider, ReactRouter, ReactRouterState, ReactServerProvider, ReactServerProviderOptions, Redirection, RouterGoOptions, RouterLayerContext, RouterLayerContextValue, RouterRenderOptions, RouterStackItem, TPropsDefault, TPropsParentDefault, TransitionOptions, UseActionOptions, UseActionReturn, UseActiveHook, UseActiveOptions, UseQueryParamsHookOptions, UseSchemaReturn, VirtualRouter, isPageRoute, ssrSchemaLoading, useAction, useActive, useAlepha, useClient, useEvents, useInject, useQueryParams, useRouter, useRouterState, useSchema, useStore };
+export { $page, ActionContext, AlephaContext, AlephaReact, AnchorProps, ClientOnly, CreateLayersResult, ErrorBoundary, ErrorHandler, ErrorViewer, Layer, Link, type LinkProps, _default as NestedView, NotFoundPage as NotFound, PageAnimation, PageConfigSchema, PageDescriptor, PageDescriptorOptions, PageDescriptorRenderOptions, PageDescriptorRenderResult, PageRequestConfig, PageResolve, PageRoute, PageRouteEntry, PreviousLayerData, ReactBrowserProvider, ReactBrowserRendererOptions, ReactHydrationState, ReactPageProvider, ReactRouter, ReactRouterState, ReactServerProvider, ReactServerProviderOptions, Redirection, RouterGoOptions, RouterLayerContext, RouterLayerContextValue, RouterRenderOptions, RouterStackItem, TPropsDefault, TPropsParentDefault, TransitionOptions, UseActionOptions, UseActionReturn, UseActiveHook, UseActiveOptions, UseQueryParamsHookOptions, UseSchemaReturn, VirtualRouter, isPageRoute, reactBrowserOptions, reactServerOptions, ssrSchemaLoading, useAction, useActive, useAlepha, useClient, useEvents, useInject, useQueryParams, useRouter, useRouterState, useSchema, useStore };
 //# sourceMappingURL=index.d.ts.map

package/redis.d.ts

@@ -1,13 +1,13 @@
-import * as _alepha_core3 from "alepha";
+import * as _alepha_core1 from "alepha";
 import { Alepha, Static } from "alepha";
 import * as _alepha_logger0 from "alepha/logger";
 import { RedisClientType, SetOptions, createClient } from "@redis/client";
 
 //#region src/providers/RedisProvider.d.ts
-declare const envSchema: _alepha_core3.TObject<{
-  REDIS_PORT: _alepha_core3.TInteger;
-  REDIS_HOST: _alepha_core3.TString;
-  REDIS_PASSWORD: _alepha_core3.TOptional<_alepha_core3.TString>;
+declare const envSchema: _alepha_core1.TObject<{
+  REDIS_PORT: _alepha_core1.TInteger;
+  REDIS_HOST: _alepha_core1.TString;
+  REDIS_PASSWORD: _alepha_core1.TOptional<_alepha_core1.TString>;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
@@ -30,8 +30,8 @@ declare class RedisProvider {
   };
   protected readonly client: RedisClient;
   get publisher(): RedisClient;
-  protected readonly start: _alepha_core3.HookDescriptor<"start">;
-  protected readonly stop: _alepha_core3.HookDescriptor<"stop">;
+  protected readonly start: _alepha_core1.HookDescriptor<"start">;
+  protected readonly stop: _alepha_core1.HookDescriptor<"stop">;
   /**
    * Connect to the Redis server.
    */
@@ -59,8 +59,8 @@ declare class RedisSubscriberProvider {
   protected readonly redisProvider: RedisProvider;
   protected readonly client: RedisClient;
   get subscriber(): RedisClient;
-  protected readonly start: _alepha_core3.HookDescriptor<"start">;
-  protected readonly stop: _alepha_core3.HookDescriptor<"stop">;
+  protected readonly start: _alepha_core1.HookDescriptor<"start">;
+  protected readonly stop: _alepha_core1.HookDescriptor<"stop">;
   connect(): Promise<void>;
   close(): Promise<void>;
   /**
@@ -76,7 +76,7 @@ declare class RedisSubscriberProvider {
  * @see {@link RedisProvider}
  * @module alepha.redis
  */
-declare const AlephaRedis: _alepha_core3.Service<_alepha_core3.Module<{}>>;
+declare const AlephaRedis: _alepha_core1.Service<_alepha_core1.Module>;
 //#endregion
 export { AlephaRedis, RedisClient, RedisClientOptions, RedisProvider, RedisSetOptions, RedisSubscriberProvider };
 //# sourceMappingURL=index.d.ts.map

package/retry.d.ts

@@ -1,17 +1,9 @@
 import { AlephaError, Descriptor, DescriptorArgs, KIND } from "alepha";
 import { DateTimeProvider, DurationLike } from "alepha/datetime";
+import * as _alepha_logger0 from "alepha/logger";
 
-//#region src/descriptors/$retry.d.ts
-
-/**
- * Creates a function that automatically retries a handler upon failure,
- * with support for exponential backoff, max duration, and cancellation.
- */
-declare const $retry: {
-  <T extends (...args: any[]) => any>(options: RetryDescriptorOptions<T>): RetryDescriptorFn<T>;
-  [KIND]: typeof RetryDescriptor;
-};
-interface RetryDescriptorOptions<T extends (...args: any[]) => any> {
+//#region src/providers/RetryProvider.d.ts
+interface RetryOptions<T extends (...args: any[]) => any> {
   /**
    * The function to retry.
    */
@@ -50,15 +42,11 @@ interface RetryDescriptorOptions<T extends (...args: any[]) => any> {
    * An AbortSignal to allow for external cancellation of the retry loop.
    */
   signal?: AbortSignal;
-}
-declare class RetryDescriptor<T extends (...args: any[]) => any> extends Descriptor<RetryDescriptorOptions<T>> {
-  protected readonly dateTimeProvider: DateTimeProvider;
-  protected appAbortController: AbortController;
-  constructor(args: DescriptorArgs<RetryDescriptorOptions<T>>);
-  run(...args: Parameters<T>): Promise<ReturnType<T>>;
-}
-interface RetryDescriptorFn<T extends (...args: any[]) => any> extends RetryDescriptor<T> {
-  (...args: Parameters<T>): Promise<ReturnType<T>>;
+  /**
+   * An additional AbortSignal to combine with the provided signal.
+   * Used internally by $retry to handle app lifecycle.
+   */
+  additionalSignal?: AbortSignal;
 }
 interface RetryBackoffOptions {
   /**
@@ -84,6 +72,81 @@ interface RetryBackoffOptions {
    */
   jitter?: boolean;
 }
+/**
+ * Service for executing functions with automatic retry logic.
+ * Supports exponential backoff, max duration, conditional retries, and cancellation.
+ */
+declare class RetryProvider {
+  protected readonly log: _alepha_logger0.Logger;
+  protected readonly dateTime: DateTimeProvider;
+  /**
+   * Execute a function with automatic retry logic.
+   */
+  retry<T extends (...args: any[]) => any>(options: RetryOptions<T>, ...args: Parameters<T>): Promise<ReturnType<T>>;
+  /**
+   * Calculate the backoff delay for a given attempt.
+   */
+  protected calculateBackoff(attempt: number, options?: number | RetryBackoffOptions): number;
+}
+//#endregion
+//#region src/descriptors/$retry.d.ts
+/**
+ * Creates a function that automatically retries a handler upon failure,
+ * with support for exponential backoff, max duration, and cancellation.
+ */
+declare const $retry: {
+  <T extends (...args: any[]) => any>(options: RetryDescriptorOptions<T>): RetryDescriptorFn<T>;
+  [KIND]: typeof RetryDescriptor;
+};
+interface RetryDescriptorOptions<T extends (...args: any[]) => any> {
+  /**
+   * The function to retry.
+   */
+  handler: T;
+  /**
+   * The maximum number of attempts.
+   *
+   * @default 3
+   */
+  max?: number;
+  /**
+   * The backoff strategy for delays between retries.
+   * Can be a fixed number (in ms) or a configuration object for exponential backoff.
+   *
+   * @default { initial: 200, factor: 2, jitter: true }
+   */
+  backoff?: number | RetryBackoffOptions;
+  /**
+   * An overall time limit for all retry attempts combined.
+   *
+   * e.g., `[5, 'seconds']`
+   */
+  maxDuration?: DurationLike;
+  /**
+   * A function that determines if a retry should be attempted based on the error.
+   *
+   * @default (error) => true (retries on any error)
+   */
+  when?: (error: Error) => boolean;
+  /**
+   * A custom callback for when a retry attempt fails.
+   * This is called before the delay.
+   */
+  onError?: (error: Error, attempt: number, ...args: Parameters<T>) => void;
+  /**
+   * An AbortSignal to allow for external cancellation of the retry loop.
+   */
+  signal?: AbortSignal;
+}
+declare class RetryDescriptor<T extends (...args: any[]) => any> extends Descriptor<RetryDescriptorOptions<T>> {
+  protected readonly retryProvider: RetryProvider;
+  protected appAbortController: AbortController;
+  constructor(args: DescriptorArgs<RetryDescriptorOptions<T>>);
+  run(...args: Parameters<T>): Promise<ReturnType<T>>;
+}
+interface RetryDescriptorFn<T extends (...args: any[]) => any> extends RetryDescriptor<T> {
+  (...args: Parameters<T>): Promise<ReturnType<T>>;
+}
 //#endregion
 //#region src/errors/RetryCancelError.d.ts
 declare class RetryCancelError extends AlephaError {
@@ -95,5 +158,5 @@ declare class RetryTimeoutError extends AlephaError {
   constructor(duration: number);
 }
 //#endregion
-export { $retry, RetryBackoffOptions, RetryCancelError, RetryDescriptor, RetryDescriptorFn, RetryDescriptorOptions, RetryTimeoutError };
+export { $retry, RetryBackoffOptions, RetryCancelError, RetryDescriptor, RetryDescriptorFn, RetryDescriptorOptions, RetryOptions, RetryProvider, RetryTimeoutError };
 //# sourceMappingURL=index.d.ts.map

package/scheduler.d.ts

@@ -139,7 +139,7 @@ declare module "alepha" {
  * @see {@link $scheduler}
  * @module alepha.scheduler
  */
-declare const AlephaScheduler: _alepha_core1.Service<_alepha_core1.Module<{}>>;
+declare const AlephaScheduler: _alepha_core1.Service<_alepha_core1.Module>;
 //#endregion
 export { $scheduler, AlephaScheduler, CRON, CronJob, CronProvider, SchedulerDescriptor, SchedulerDescriptorOptions, SchedulerHandlerArguments };
 //# sourceMappingURL=index.d.ts.map