alepha 0.6.9 → 0.7.0

package/cache.d.ts

@@ -92,6 +92,7 @@ interface TSchema extends TKind, SchemaOptions {
 }
 
 declare class CacheProvider {
+    constructor();
     /**
      * Get the value of a key.
      *

package/core.d.ts

@@ -17,6 +17,13 @@ import { Readable } from 'node:stream';
  */
 declare const KIND: unique symbol;
 
+/**
+ * Used for identifying descriptors.
+ *
+ * @internal
+ */
+declare const OPTIONS: unique symbol;
+
 /**
  * Represents a value that can be either a value or a promise.
  */
@@ -84,42 +91,7 @@ interface ClassProvider<T extends object = any> {
     parents: Array<Class | null>;
 }
 
-/**
- * Used for identifying descriptors.
- *
- * @internal
- */
-declare const OPTIONS: unique symbol;
-
 declare const KEY = "HOOK";
-interface Hooks {
-    /**
-     * Triggered during the configuration phase. Before the start phase.
-     *
-     * - Configuration should technically be called many times without any side effects.
-     * - Spamming Alepha#configure() should not cause any issues.
-     */
-    configure: Alepha;
-    /**
-     * Triggered during the start phase. When `Alepha#start()` is called.
-     *
-     * - Start is called only once. It should not be called multiple times.
-     */
-    start: Alepha;
-    /**
-     * Triggered during the ready phase. After the start phase.
-     *
-     * - Ready is called only once. It should not be called multiple times.
-     */
-    ready: Alepha;
-    /**
-     * Triggered during the stop phase.
-     *
-     * - Stop is called only once. It should not be called multiple times.
-     * - Stop should be called after a SIGINT or SIGTERM signal in order to gracefully shutdown the application.
-     */
-    stop: Alepha;
-}
 interface HookOptions<T extends keyof Hooks> {
     /**
      * The name of the hook. "configure", "start", "ready", "stop", ...
@@ -442,6 +414,35 @@ interface State {
     afterEach?: (run: any) => any;
     onTestFinished?: (run: any) => any;
 }
+interface Hooks {
+    echo: any;
+    /**
+     * Triggered during the configuration phase. Before the start phase.
+     *
+     * - Configuration should technically be called many times without any side effects.
+     * - Spamming Alepha#configure() should not cause any issues.
+     */
+    configure: Alepha;
+    /**
+     * Triggered during the start phase. When `Alepha#start()` is called.
+     *
+     * - Start is called only once. It should not be called multiple times.
+     */
+    start: Alepha;
+    /**
+     * Triggered during the ready phase. After the start phase.
+     *
+     * - Ready is called only once. It should not be called multiple times.
+     */
+    ready: Alepha;
+    /**
+     * Triggered during the stop phase.
+     *
+     * - Stop is called only once. It should not be called multiple times.
+     * - Stop should be called after a SIGINT or SIGTERM signal in order to gracefully shutdown the application.
+     */
+    stop: Alepha;
+}
 /**
  *
  *
@@ -623,10 +624,11 @@ declare class Alepha {
         skipRegistration?: boolean;
         args?: any[];
     }): T;
-    on<T extends keyof Hooks>(event: T, hook: Hook<T>): () => void;
+    on<T extends keyof Hooks>(event: T, hookOrFunc: Hook<T> | ((payload: Hooks[T]) => Async<void>)): () => void;
     emit<T extends keyof Hooks>(func: keyof Hooks, payload: Hooks[T], options?: {
         reverse?: boolean;
         log?: boolean;
+        catch?: boolean;
     }): Promise<void>;
     /**
      * Casts the given value to the specified schema.
@@ -708,6 +710,10 @@ declare class Alepha {
  */
 declare const PROVIDER: unique symbol;
 
+declare const $module: (opts: {
+    services: Array<Class>;
+}) => {};
+
 /**
  * Get the instance of the specified type from the context.
  *
@@ -734,11 +740,15 @@ declare const $logger: (name?: string) => Logger;
  */
 interface RetryDescriptorOptions<T extends (...args: any[]) => any> {
     /**
+     * Maximum number of attempts.
      *
+     * @default 3
      */
     max?: number;
     /**
+     * Delay in milliseconds.
      *
+     * @default 0
      */
     delay?: number;
     /**
@@ -749,14 +759,23 @@ interface RetryDescriptorOptions<T extends (...args: any[]) => any> {
      *
      */
     handler: T;
+    /**
+     * Optional error handler.
+     *
+     * This will be called when an error occurs.
+     *
+     * @default undefined
+     */
+    onError?: (error: Error, attempt: number, ...parameters: Parameters<T>) => void;
 }
+type MaybePromise<T> = T extends Promise<any> ? T : Promise<T>;
 /**
  * Retry descriptor.
  *
  * @param opts - Retry descriptor options.
  * @returns A function that will retry the handler.
  */
-declare const $retry: <T extends (...args: any[]) => any>(opts: RetryDescriptorOptions<T>) => ((...parameters: Parameters<T>) => Promise<ReturnType<T>>);
+declare const $retry: <T extends (...args: any[]) => any>(opts: RetryDescriptorOptions<T>) => ((...parameters: Parameters<T>) => MaybePromise<ReturnType<T>>);
 
 declare class AppNotStartedError extends Error {
     constructor();
@@ -779,26 +798,6 @@ declare class TypeBoxError extends Error {
     constructor(value: ValueError);
 }
 
-interface EventEmitterItem<T extends object> {
-    name: keyof T;
-    handler: (arg: any) => Async<void>;
-}
-declare class EventEmitter<T extends object> {
-    protected events: EventEmitterItem<T>[];
-    /**
-     *
-     * @param name
-     * @param handler
-     */
-    on<Key extends keyof T>(name: Key, handler: (arg: T[Key]) => void): () => void;
-    /**
-     *
-     * @param name
-     * @param data
-     */
-    emit<Key extends keyof T>(name: Key, data: T[Key]): Promise<void>;
-}
-
 declare class TypeProvider {
     static DEFAULT_STRING_MAX_LENGTH: number;
     static DEFAULT_LONG_STRING_MAX_LENGTH: number;
@@ -995,4 +994,4 @@ declare const run: (arg: Alepha | Class | ((env?: Env) => Alepha), opts?: {
     ready?: (alepha: Alepha) => Async<void>;
 }) => Alepha;
 
-export { $cursor, $hook, $inject, $logger, $retry, Alepha, type AlephaStringOptions, AppNotStartedError, type Async, type AsyncFn, type AsyncLocalStorageData, AsyncLocalStorageProvider, COLORS, CircularDependencyError, type Class, type ClassEntry, type ClassProvider, type ClassSwap, ContainerLockedError, type CursorDescriptor, type Descriptor, type DescriptorIdentifier, type DescriptorItem, type Env, EventEmitter, type EventEmitterItem, EventEmitterLike, type FileLike, type Hook, type HookDescriptor, type HookOptions, type Hooks, KIND, LEVEL_COLORS, type LogLevel, Logger, type LoggerEnv, type LoggerOptions, MockLogger, type MockLoggerStore, NotImplementedError, OPTIONS, PROVIDER, type PromiseFn, type RetryDescriptorOptions, type State, type StreamLike, type TFile, type TStream, type TextLength, TypeBoxError, TypeProvider, __alephaRef, __bind, __descriptor, descriptorEvents, isDescriptorValue, isFileLike, isTypeFile, isTypeStream, isUUID, run, t };
+export { $cursor, $hook, $inject, $logger, $module, $retry, Alepha, type AlephaStringOptions, AppNotStartedError, type Async, type AsyncFn, type AsyncLocalStorageData, AsyncLocalStorageProvider, COLORS, CircularDependencyError, type Class, type ClassEntry, type ClassProvider, type ClassSwap, ContainerLockedError, type CursorDescriptor, type Descriptor, type DescriptorIdentifier, type DescriptorItem, type Env, EventEmitterLike, type FileLike, type Hook, type HookDescriptor, type HookOptions, type Hooks, KIND, LEVEL_COLORS, type LogLevel, Logger, type LoggerEnv, type LoggerOptions, type MaybePromise, MockLogger, type MockLoggerStore, NotImplementedError, OPTIONS, PROVIDER, type PromiseFn, type RetryDescriptorOptions, type State, type StreamLike, type TFile, type TStream, type TextLength, TypeBoxError, TypeProvider, __alephaRef, __bind, __descriptor, descriptorEvents, isDescriptorValue, isFileLike, isTypeFile, isTypeStream, isUUID, run, t };

package/lock.d.ts

@@ -123,6 +123,7 @@ declare const $lock: {
  * Store Provider Interface
  */
 declare class LockProvider {
+    constructor();
     /**
      * Set the string value of a key.
      *
@@ -238,7 +239,7 @@ declare class MemoryLockProvider implements LockProvider {
 /**
  * A store provider that uses Redis.
  */
-declare class RedisLockProvider extends LockProvider {
+declare class RedisLockProvider implements LockProvider {
     protected readonly log: _alepha_core.Logger;
     protected readonly redisProvider: RedisProvider;
     /**

package/package.json

@@ -1,31 +1,37 @@
 {
 	"name": "alepha",
-	"version": "0.6.9",
+	"version": "0.7.0",
 	"type": "module",
 	"license": "MIT",
+	"description": "TypeScript framework for building full-stack apps with strict conventions, custom schemas, and React-based SPA or SSR without filesystem-based routing.",
+	"homepage": "https://github.com/feunard/alepha",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/feunard/alepha.git"
+	},
 	"main": "./core.js",
 	"types": "./core.d.ts",
 	"dependencies": {
-		"@alepha/cache": "0.6.9",
-		"@alepha/core": "0.6.9",
-		"@alepha/datetime": "0.6.9",
-		"@alepha/lock": "0.6.9",
-		"@alepha/postgres": "0.6.9",
-		"@alepha/queue": "0.6.9",
-		"@alepha/react": "0.6.9",
-		"@alepha/react-auth": "0.6.9",
-		"@alepha/redis": "0.6.9",
-		"@alepha/scheduler": "0.6.9",
-		"@alepha/security": "0.6.9",
-		"@alepha/server": "0.6.9",
-		"@alepha/server-cookies": "0.6.9",
-		"@alepha/server-metrics": "0.6.9",
-		"@alepha/server-proxy": "0.6.9",
-		"@alepha/server-static": "0.6.9",
-		"@alepha/server-swagger": "0.6.9",
-		"@alepha/testing": "0.6.9",
-		"@alepha/topic": "0.6.9",
-		"@alepha/vite": "0.6.9"
+		"@alepha/cache": "0.7.0",
+		"@alepha/core": "0.7.0",
+		"@alepha/datetime": "0.7.0",
+		"@alepha/lock": "0.7.0",
+		"@alepha/postgres": "0.7.0",
+		"@alepha/queue": "0.7.0",
+		"@alepha/react": "0.7.0",
+		"@alepha/react-auth": "0.7.0",
+		"@alepha/redis": "0.7.0",
+		"@alepha/scheduler": "0.7.0",
+		"@alepha/security": "0.7.0",
+		"@alepha/server": "0.7.0",
+		"@alepha/server-cookies": "0.7.0",
+		"@alepha/server-metrics": "0.7.0",
+		"@alepha/server-proxy": "0.6.10",
+		"@alepha/server-static": "0.7.0",
+		"@alepha/server-swagger": "0.7.0",
+		"@alepha/testing": "0.7.0",
+		"@alepha/topic": "0.7.0",
+		"@alepha/vite": "0.7.0"
 	},
 	"peerDependencies": {
 		"@types/react": "^19",