@alepha/react 0.13.6 → 0.13.7

package/dist/core/index.d.ts

@@ -1,4 +1,4 @@
-import * as alepha60 from "alepha";
+import * as alepha44 from "alepha";
 import { Alepha, AlephaError, Async, Atom, FileLike, Hook, Hooks, InstantiableClass, KIND, LogLevel, LoggerInterface, Primitive, Service, State, Static, StreamLike, TArray, TAtomObject, TFile, TObject, TRecord, TSchema, TStream, TString, TVoid } from "alepha";
 import * as react0 from "react";
 import React, { AnchorHTMLAttributes, CSSProperties, DependencyList, ErrorInfo, FC, PropsWithChildren, ReactNode } from "react";
@@ -10,15 +10,15 @@ import dayjsDuration from "dayjs/plugin/duration.js";
 import DayjsApi, { Dayjs, ManipulateType, PluginFunc } from "dayjs";
 
 //#region ../../../alepha/src/server/schemas/errorSchema.d.ts
-declare const errorSchema: alepha60.TObject<{
-  error: alepha60.TString;
-  status: alepha60.TInteger;
-  message: alepha60.TString;
-  details: alepha60.TOptional<alepha60.TString>;
-  requestId: alepha60.TOptional<alepha60.TString>;
-  cause: alepha60.TOptional<alepha60.TObject<{
-    name: alepha60.TString;
-    message: alepha60.TString;
+declare const errorSchema: alepha44.TObject<{
+  error: alepha44.TString;
+  status: alepha44.TInteger;
+  message: alepha44.TString;
+  details: alepha44.TOptional<alepha44.TString>;
+  requestId: alepha44.TOptional<alepha44.TString>;
+  cause: alepha44.TOptional<alepha44.TObject<{
+    name: alepha44.TString;
+    message: alepha44.TString;
   }>>;
 }>;
 type ErrorSchema = Static<typeof errorSchema>;
@@ -257,15 +257,15 @@ interface WebRequestEvent {
 }
 //#endregion
 //#region ../../../alepha/src/logger/schemas/logEntrySchema.d.ts
-declare const logEntrySchema: alepha60.TObject<{
-  level: alepha60.TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
-  message: alepha60.TString;
-  service: alepha60.TString;
-  module: alepha60.TString;
-  context: alepha60.TOptional<alepha60.TString>;
-  app: alepha60.TOptional<alepha60.TString>;
-  data: alepha60.TOptional<alepha60.TAny>;
-  timestamp: alepha60.TNumber;
+declare const logEntrySchema: alepha44.TObject<{
+  level: alepha44.TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
+  message: alepha44.TString;
+  service: alepha44.TString;
+  module: alepha44.TString;
+  context: alepha44.TOptional<alepha44.TString>;
+  app: alepha44.TOptional<alepha44.TString>;
+  data: alepha44.TOptional<alepha44.TAny>;
+  timestamp: alepha44.TNumber;
 }>;
 type LogEntry = Static<typeof logEntrySchema>;
 //#endregion
@@ -280,8 +280,8 @@ declare class DateTimeProvider {
   protected readonly timeouts: Timeout[];
   protected readonly intervals: Interval[];
   constructor();
-  protected readonly onStart: alepha60.HookPrimitive<"start">;
-  protected readonly onStop: alepha60.HookPrimitive<"stop">;
+  protected readonly onStart: alepha44.HookPrimitive<"start">;
+  protected readonly onStop: alepha44.HookPrimitive<"stop">;
   setLocale(locale: string): void;
   isDateTime(value: unknown): value is DateTime;
   /**
@@ -413,7 +413,7 @@ declare class Logger implements LoggerInterface {
 }
 //#endregion
 //#region ../../../alepha/src/logger/index.d.ts
-declare const envSchema$6: alepha60.TObject<{
+declare const envSchema$6: alepha44.TObject<{
   /**
    * Default log level for the application.
    *
@@ -430,14 +430,14 @@ declare const envSchema$6: alepha60.TObject<{
    * LOG_LEVEL=my.module.name:debug,info # Set debug level for my.module.name and info for all other modules
    * LOG_LEVEL=alepha:trace, info # Set trace level for all alepha modules and info for all other modules
    */
-  LOG_LEVEL: alepha60.TOptional<alepha60.TString>;
+  LOG_LEVEL: alepha44.TOptional<alepha44.TString>;
   /**
    * Built-in log formats.
    * - "json" - JSON format, useful for structured logging and log aggregation. {@link JsonFormatterProvider}
-   * - "pretty" - Simple text format, human-readable, with colors. {@link SimpleFormatterProvider}
+   * - "pretty" - Simple text format, human-readable, with colors. {@link PrettyFormatterProvider}
    * - "raw" - Raw format, no formatting, just the message.  {@link RawFormatterProvider}
    */
-  LOG_FORMAT: alepha60.TOptional<alepha60.TUnsafe<"json" | "pretty" | "raw">>;
+  LOG_FORMAT: alepha44.TOptional<alepha44.TUnsafe<"json" | "pretty" | "raw">>;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$6>> {}
@@ -474,8 +474,8 @@ declare class ServerTimingProvider {
     prefix: string;
     disabled: boolean;
   };
-  readonly onRequest: alepha60.HookPrimitive<"server:onRequest">;
-  readonly onResponse: alepha60.HookPrimitive<"server:onResponse">;
+  readonly onRequest: alepha44.HookPrimitive<"server:onRequest">;
+  readonly onResponse: alepha44.HookPrimitive<"server:onResponse">;
   protected get handlerName(): string;
   beginTiming(name: string): void;
   endTiming(name: string): void;
@@ -539,11 +539,11 @@ declare class ServerProvider {
   /**
    * When a Node.js HTTP request is received from outside. (Vercel, AWS Lambda, etc.)
    */
-  protected readonly onNodeRequest: alepha60.HookPrimitive<"node:request">;
+  protected readonly onNodeRequest: alepha44.HookPrimitive<"node:request">;
   /**
    * When a Web (Fetch API) request is received from outside. (Netlify, Cloudflare Workers, etc.)
    */
-  protected readonly onWebRequest: alepha60.HookPrimitive<"web:request">;
+  protected readonly onWebRequest: alepha44.HookPrimitive<"web:request">;
   /**
    * Handle Node.js HTTP request event.
    *
@@ -878,18 +878,18 @@ type ServerActionHandler<TConfig extends RequestConfigSchema = RequestConfigSche
 interface ServerActionRequest<TConfig extends RequestConfigSchema> extends ServerRequest<TConfig> {}
 //#endregion
 //#region ../../../alepha/src/server/providers/BunHttpServerProvider.d.ts
-declare const envSchema$5: alepha60.TObject<{
-  SERVER_PORT: alepha60.TInteger;
-  SERVER_HOST: alepha60.TString;
+declare const envSchema$5: alepha44.TObject<{
+  SERVER_PORT: alepha44.TInteger;
+  SERVER_HOST: alepha44.TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$5>> {}
 }
 //#endregion
 //#region ../../../alepha/src/server/providers/NodeHttpServerProvider.d.ts
-declare const envSchema$4: alepha60.TObject<{
-  SERVER_PORT: alepha60.TInteger;
-  SERVER_HOST: alepha60.TString;
+declare const envSchema$4: alepha44.TObject<{
+  SERVER_PORT: alepha44.TInteger;
+  SERVER_HOST: alepha44.TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$4>> {}
@@ -1077,8 +1077,8 @@ declare class Redirection extends Error {
 }
 //#endregion
 //#region ../../src/core/providers/ReactPageProvider.d.ts
-declare const envSchema$3: alepha60.TObject<{
-  REACT_STRICT_MODE: alepha60.TBoolean;
+declare const envSchema$3: alepha44.TObject<{
+  REACT_STRICT_MODE: alepha44.TBoolean;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$3>> {}
@@ -1109,7 +1109,6 @@ declare class ReactPageProvider {
    * It also handles errors and redirects.
    */
   createLayers(route: PageRoute, state: ReactRouterState, previous?: PreviousLayerData[]): Promise<CreateLayersResult>;
-  protected createRedirectionLayer(redirect: string): CreateLayersResult;
   protected getErrorHandler(route: PageRoute): ErrorHandler | undefined;
   protected createElement(page: PageRoute, props: Record<string, any>): Promise<ReactNode>;
   renderError(error: Error): ReactNode;
@@ -1121,7 +1120,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: alepha60.HookPrimitive<"configure">;
+  protected readonly configure: alepha44.HookPrimitive<"configure">;
   protected map(pages: Array<PagePrimitive>, target: PagePrimitive): PageRouteEntry;
   add(entry: PageRouteEntry): void;
   protected createMatch(page: PageRoute): string;
@@ -1336,10 +1335,10 @@ interface PagePrimitiveOptions<TConfig extends PageConfigSchema = PageConfigSche
    * Load data before rendering the page.
    *
    * This function receives
-   * - the request context and
+   * - the request context (params, query, etc.)
    * - the parent props (if page has a parent)
    *
-   * In SSR, the returned data will be serialized and sent to the client, then reused during the client-side hydration.
+   * > In SSR, the returned data will be serialized and sent to the client, then reused during the client-side hydration.
    *
    * Resolve can be stopped by throwing an error, which will be handled by the `errorHandler` function.
    * It's common to throw a `NotFoundError` to display a 404 page.
@@ -1347,6 +1346,12 @@ interface PagePrimitiveOptions<TConfig extends PageConfigSchema = PageConfigSche
    * RedirectError can be thrown to redirect the user to another page.
    */
   resolve?: (context: PageResolve<TConfig, TPropsParent>) => Async<TProps>;
+  /**
+   * Default props to pass to the component when rendering the page.
+   *
+   * Resolved props from the `resolve` function will override these default props.
+   */
+  props?: () => Partial<TProps>;
   /**
    * The component to render when the page is loaded.
    *
@@ -1372,6 +1377,12 @@ interface PagePrimitiveOptions<TConfig extends PageConfigSchema = PageConfigSche
    * Define a parent page for nested routing.
    */
   parent?: PagePrimitive<PageConfigSchema, TPropsParent, any>;
+  /**
+   * Function to determine if the page can be accessed.
+   *
+   * If it returns false, the page will not be accessible and a 403 Forbidden error will be returned.
+   * This function can be used to implement permission-based access control.
+   */
   can?: () => boolean;
   /**
    * Catch any error from the `resolve` function or during `rendering`.
@@ -1540,15 +1551,15 @@ type CssAnimation = {
 };
 //#endregion
 //#region ../../../alepha/src/security/schemas/userAccountInfoSchema.d.ts
-declare const userAccountInfoSchema: alepha60.TObject<{
-  id: alepha60.TString;
-  name: alepha60.TOptional<alepha60.TString>;
-  email: alepha60.TOptional<alepha60.TString>;
-  username: alepha60.TOptional<alepha60.TString>;
-  picture: alepha60.TOptional<alepha60.TString>;
-  sessionId: alepha60.TOptional<alepha60.TString>;
-  organizations: alepha60.TOptional<alepha60.TArray<alepha60.TString>>;
-  roles: alepha60.TOptional<alepha60.TArray<alepha60.TString>>;
+declare const userAccountInfoSchema: alepha44.TObject<{
+  id: alepha44.TString;
+  name: alepha44.TOptional<alepha44.TString>;
+  email: alepha44.TOptional<alepha44.TString>;
+  username: alepha44.TOptional<alepha44.TString>;
+  picture: alepha44.TOptional<alepha44.TString>;
+  sessionId: alepha44.TOptional<alepha44.TString>;
+  organizations: alepha44.TOptional<alepha44.TArray<alepha44.TString>>;
+  roles: alepha44.TOptional<alepha44.TArray<alepha44.TString>>;
 }>;
 type UserAccount = Static<typeof userAccountInfoSchema>;
 //#endregion
@@ -1574,8 +1585,8 @@ interface UserAccountToken extends UserAccount {
 }
 //#endregion
 //#region ../../../alepha/src/security/providers/SecurityProvider.d.ts
-declare const envSchema$2: alepha60.TObject<{
-  APP_SECRET: alepha60.TString;
+declare const envSchema$2: alepha44.TObject<{
+  APP_SECRET: alepha44.TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$2>> {}
@@ -1668,23 +1679,23 @@ declare module "alepha/server" {
  */
 //#endregion
 //#region ../../../alepha/src/server-links/schemas/apiLinksResponseSchema.d.ts
-declare const apiLinkSchema: alepha60.TObject<{
-  name: alepha60.TString;
-  group: alepha60.TOptional<alepha60.TString>;
-  path: alepha60.TString;
-  method: alepha60.TOptional<alepha60.TString>;
-  requestBodyType: alepha60.TOptional<alepha60.TString>;
-  service: alepha60.TOptional<alepha60.TString>;
+declare const apiLinkSchema: alepha44.TObject<{
+  name: alepha44.TString;
+  group: alepha44.TOptional<alepha44.TString>;
+  path: alepha44.TString;
+  method: alepha44.TOptional<alepha44.TString>;
+  requestBodyType: alepha44.TOptional<alepha44.TString>;
+  service: alepha44.TOptional<alepha44.TString>;
 }>;
-declare const apiLinksResponseSchema: alepha60.TObject<{
-  prefix: alepha60.TOptional<alepha60.TString>;
-  links: alepha60.TArray<alepha60.TObject<{
-    name: alepha60.TString;
-    group: alepha60.TOptional<alepha60.TString>;
-    path: alepha60.TString;
-    method: alepha60.TOptional<alepha60.TString>;
-    requestBodyType: alepha60.TOptional<alepha60.TString>;
-    service: alepha60.TOptional<alepha60.TString>;
+declare const apiLinksResponseSchema: alepha44.TObject<{
+  prefix: alepha44.TOptional<alepha44.TString>;
+  links: alepha44.TArray<alepha44.TObject<{
+    name: alepha44.TString;
+    group: alepha44.TOptional<alepha44.TString>;
+    path: alepha44.TString;
+    method: alepha44.TOptional<alepha44.TString>;
+    requestBodyType: alepha44.TOptional<alepha44.TString>;
+    service: alepha44.TOptional<alepha44.TString>;
   }>>;
 }>;
 type ApiLinksResponse = Static<typeof apiLinksResponseSchema>;
@@ -1790,14 +1801,14 @@ declare class ReactBrowserRouterProvider extends RouterProvider<BrowserRoute> {
   protected readonly alepha: Alepha;
   protected readonly pageApi: ReactPageProvider;
   add(entry: PageRouteEntry): void;
-  protected readonly configure: alepha60.HookPrimitive<"configure">;
+  protected readonly configure: alepha44.HookPrimitive<"configure">;
   transition(url: URL, previous?: PreviousLayerData[], meta?: {}): Promise<string | void>;
   root(state: ReactRouterState): ReactNode;
 }
 //#endregion
 //#region ../../src/core/providers/ReactBrowserProvider.d.ts
-declare const envSchema$1: alepha60.TObject<{
-  REACT_ROOT_ID: alepha60.TString;
+declare const envSchema$1: alepha44.TObject<{
+  REACT_ROOT_ID: alepha44.TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$1>> {}
@@ -1805,8 +1816,8 @@ declare module "alepha" {
 /**
  * React browser renderer configuration atom
  */
-declare const reactBrowserOptions: alepha60.Atom<alepha60.TObject<{
-  scrollRestoration: alepha60.TUnsafe<"top" | "manual">;
+declare const reactBrowserOptions: alepha44.Atom<alepha44.TObject<{
+  scrollRestoration: alepha44.TUnsafe<"top" | "manual">;
 }>, "alepha.react.browser.options">;
 type ReactBrowserRendererOptions = Static<typeof reactBrowserOptions.schema>;
 declare module "alepha" {
@@ -1854,8 +1865,8 @@ declare class ReactBrowserProvider {
    * Get embedded layers from the server.
    */
   protected getHydrationState(): ReactHydrationState | undefined;
-  protected readonly onTransitionEnd: alepha60.HookPrimitive<"react:transition:end">;
-  readonly ready: alepha60.HookPrimitive<"ready">;
+  protected readonly onTransitionEnd: alepha44.HookPrimitive<"react:transition:end">;
+  readonly ready: alepha44.HookPrimitive<"ready">;
 }
 interface RouterGoOptions {
   replace?: boolean;
@@ -2017,7 +2028,7 @@ interface UseActionOptions<Args extends any[] = any[], Result = any> {
    * The async action handler function.
    * Receives the action arguments plus an ActionContext as the last parameter.
    */
-  handler: (...args: [...Args, ActionContext]) => Promise<Result>;
+  handler: (...args: [...Args, ActionContext]) => Async<Result>;
   /**
    * Custom error handler. If provided, prevents default error re-throw.
    */
@@ -2030,6 +2041,7 @@ interface UseActionOptions<Args extends any[] = any[], Result = any> {
    * Optional identifier for this action (useful for debugging/analytics)
    */
   id?: string;
+  name?: string;
   /**
    * Debounce delay in milliseconds. If specified, the action will only execute
    * after the specified delay has passed since the last call. Useful for search inputs
@@ -2234,6 +2246,9 @@ interface ErrorViewerProps {
   error: Error;
   alepha: Alepha;
 }
+/**
+ * Error viewer component that displays error details in development mode
+ */
 declare const ErrorViewer: ({
   error,
   alepha
@@ -2261,6 +2276,7 @@ declare function NotFoundPage(props: {
 interface RouterLayerContextValue {
   index: number;
   path: string;
+  onError: ErrorHandler;
 }
 declare const RouterLayerContext: react0.Context<RouterLayerContextValue | undefined>;
 //#endregion
@@ -2312,6 +2328,7 @@ declare class ReactRouter<T$1 extends object> {
     path?: string | undefined;
     schema?: PageConfigSchema | undefined;
     resolve?: ((context: PageResolve<PageConfigSchema, TPropsParentDefault>) => any) | undefined;
+    props?: (() => Partial<any>) | undefined;
     component?: react0.FC<any> | undefined;
     lazy?: (() => Promise<{
       default: react0.FC<any>;
@@ -2591,7 +2608,7 @@ declare class ServerStaticProvider {
   protected readonly fileDetector: FileDetector;
   protected readonly log: Logger;
   protected readonly directories: ServeDirectory[];
-  protected readonly configure: alepha60.HookPrimitive<"configure">;
+  protected readonly configure: alepha44.HookPrimitive<"configure">;
   createStaticServer(options: ServePrimitiveOptions): Promise<void>;
   createFileHandler(filepath: string, options: ServePrimitiveOptions): Promise<ServerHandler>;
   protected getCacheFileTypes(): string[];
@@ -2607,25 +2624,25 @@ interface ServeDirectory {
 }
 //#endregion
 //#region ../../src/core/providers/ReactServerProvider.d.ts
-declare const envSchema: alepha60.TObject<{
-  REACT_SSR_ENABLED: alepha60.TOptional<alepha60.TBoolean>;
-  REACT_ROOT_ID: alepha60.TString;
-  REACT_SERVER_TEMPLATE: alepha60.TOptional<alepha60.TString>;
+declare const envSchema: alepha44.TObject<{
+  REACT_SSR_ENABLED: alepha44.TOptional<alepha44.TBoolean>;
+  REACT_ROOT_ID: alepha44.TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
   interface State {
     "alepha.react.server.ssr"?: boolean;
+    "alepha.react.server.template"?: string;
   }
 }
 /**
  * React server provider configuration atom
  */
-declare const reactServerOptions: alepha60.Atom<alepha60.TObject<{
-  publicDir: alepha60.TString;
-  staticServer: alepha60.TObject<{
-    disabled: alepha60.TBoolean;
-    path: alepha60.TString;
+declare const reactServerOptions: alepha44.Atom<alepha44.TObject<{
+  publicDir: alepha44.TString;
+  staticServer: alepha44.TObject<{
+    disabled: alepha44.TBoolean;
+    path: alepha44.TString;
   }>;
 }>, "alepha.react.server.options">;
 type ReactServerProviderOptions = Static<typeof reactServerOptions.schema>;
@@ -2639,7 +2656,6 @@ declare class ReactServerProvider {
   protected readonly alepha: Alepha;
   protected readonly env: {
     REACT_SSR_ENABLED?: boolean | undefined;
-    REACT_SERVER_TEMPLATE?: string | undefined;
     REACT_ROOT_ID: string;
   };
   protected readonly pageApi: ReactPageProvider;
@@ -2659,7 +2675,7 @@ declare class ReactServerProvider {
   /**
    * Configure the React server provider.
    */
-  readonly onConfigure: alepha60.HookPrimitive<"configure">;
+  readonly onConfigure: alepha44.HookPrimitive<"configure">;
   get template(): string;
   protected registerPages(templateLoader: TemplateLoader): Promise<void>;
   /**
@@ -2795,7 +2811,7 @@ declare module "alepha" {
  * @see {@link $page}
  * @module alepha.react
  */
-declare const AlephaReact: alepha60.Service<alepha60.Module>;
+declare const AlephaReact: alepha44.Service<alepha44.Module>;
 //#endregion
 export { $page, ActionContext, AlephaContext, AlephaReact, AnchorProps, ClientOnly, ConcretePageRoute, CreateLayersResult, ErrorBoundary, ErrorHandler, ErrorViewer, Layer, Link, type LinkProps, _default as NestedView, NotFoundPage as NotFound, PageAnimation, PageConfigSchema, PagePrimitive, PagePrimitiveOptions, PagePrimitiveRenderOptions, PagePrimitiveRenderResult, 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, UseStoreReturn, VirtualRouter, isPageRoute, reactBrowserOptions, reactServerOptions, ssrSchemaLoading, useAction, useActive, useAlepha, useClient, useEvents, useInject, useQueryParams, useRouter, useRouterState, useSchema, useStore };
 //# sourceMappingURL=index.d.ts.map