alepha 0.9.5 → 0.10.0

package/README.md

@@ -45,49 +45,3 @@ run(App);
 ```
 
 👉 For more information, please visit the [documentation](https://feunard.github.io/alepha/).
-
-## Modules
-
-Alepha is modular, with a LOT of modules.
-
-### Core & Application Layer
-
-*   **Core ([@alepha/core](https://feunard.github.io/alepha/docs/alepha-core)) 📦:** The heart of the framework, providing a powerful dependency injection container, application lifecycle management, and the core descriptor system.
-*   **Server ([@alepha/server](https://feunard.github.io/alepha/docs/alepha-server)) 🌐:** A high-performance, minimalist HTTP server for creating type-safe REST APIs using declarative `$action` descriptors.
-*   **Database ([@alepha/postgres](https://feunard.github.io/alepha/docs/alepha-postgres)) 🗄️:** A powerful and type-safe ORM built on Drizzle. Define your schema with `$entity` and get fully-typed repositories with `$repository`.
-*   **React ([@alepha/react](https://feunard.github.io/alepha/docs/alepha-react)) ⚛️:** Build full-stack, server-side rendered React applications with a file-based routing system (`$page`) that handles data fetching, hydration, and type-safe props.
-
-### Backend Infrastructure & Abstractions
-
-*   **Security ([@alepha/security](https://feunard.github.io/alepha/docs/alepha-security)) 🛡️:** A complete authentication and authorization system. Manage roles (`$role`), permissions (`$permission`), JWTs, and realms (`$realm`).
-*   **Queue ([@alepha/queue](https://feunard.github.io/alepha/docs/alepha-queue)) ⏳:** A simple and robust interface for background job processing. Define workers with the `$queue` descriptor and integrate with backends like Redis.
-*   **Cache ([@alepha/cache](https://feunard.github.io/alepha/docs/alepha-cache)) ⚡:** A flexible caching layer with support for TTL, automatic function caching (`$cache`), and multiple backends like in-memory or Redis.
-*   **Bucket ([@alepha/bucket](https://feunard.github.io/alepha/docs/alepha-bucket)) ☁️:** A unified API for file and object storage. Abstract away the details of local, in-memory, or cloud storage providers like Azure Blob Storage.
-*   **Scheduler ([@alepha/scheduler](https://feunard.github.io/alepha/docs/alepha-scheduler)) ⏰:** Schedule recurring tasks using cron expressions or fixed intervals with the `$scheduler` descriptor, with built-in support for distributed locking.
-*   **Topic ([@alepha/topic](https://feunard.github.io/alepha/docs/alepha-topic)) 📢:** A publish-subscribe (pub/sub) messaging interface for building event-driven architectures with `$topic` and `$subscriber`.
-*   **Lock ([@alepha/lock](https://feunard.github.io/alepha/docs/alepha-lock)) 🔒:** A distributed locking mechanism to ensure safe concurrent access to shared resources, using Redis or other backends.
-
-### Server Middleware & Plugins
-
-*   **Links ([@alepha/server-links](https://feunard.github.io/alepha/docs/alepha-server-links)) 🔗:** Enables end-to-end type-safe communication between your frontend and backend, or between microservices, with the `$client` descriptor.
-*   **Swagger ([@alepha/server-swagger](https://feunard.github.io/alepha/docs/alepha-server-swagger)) 📜:** Automatically generate OpenAPI 3.0 documentation and a beautiful Swagger UI for all your `$action` API endpoints.
-*   **Helmet ([@alepha/server-helmet](https://feunard.github.io/alepha/docs/alepha-server-helmet)) 🎩:** Enhance your application's security by automatically applying essential HTTP security headers like CSP and HSTS.
-*   **CORS ([@alepha/server-cors](https://feunard.github.io/alepha/docs/alepha-server-cors)) ↔️:** A configurable middleware to handle Cross-Origin Resource Sharing (CORS) for your server.
-*   **Multipart ([@alepha/server-multipart](https://feunard.github.io/alepha/docs/alepha-server-multipart)) 📎:** Seamlessly handle `multipart/form-data` requests for file uploads.
-*   **Compress ([@alepha/server-compress](https://feunard.github.io/alepha/docs/alepha-server-compress)) 📦💨:** Automatically compress server responses with Gzip or Brotli to improve performance.
-
-And more, like **Request Logging**, **Error Handling**, and **Response Caching**, cookie parsers, and more, to enhance your server's capabilities.
-
-### Full-Stack & React Ecosystem
-
-*   **Auth ([@alepha/react-auth](https://feunard.github.io/alepha/docs/alepha-react-auth)) 🔑:** Simplifies frontend authentication flows, providing the `useAuth` hook to manage user sessions and permissions in your React components.
-*   **Head ([@alepha/react-head](https://feunard.github.io/alepha/docs/alepha-react-head))  SEO:** Manage your document's `<head>` for SEO and metadata. Control titles, meta tags, and more, both on the server and client.
-*   **i18n ([@alepha/react-i18n](https://feunard.github.io/alepha/docs/alepha-react-i18n)) 🌍:** A complete internationalization solution for your React applications, with support for lazy-loaded translation files and the `useI18n` hook.
-*   **Form ([@alepha/react-form](https://feunard.github.io/alepha/docs/alepha-react-form)) 📝:** Create powerful, type-safe forms with automatic validation using the `useForm` hook, powered by your TypeBox schemas.
-
-### Tooling & Utilities
-
-*   **Vite ([@alepha/vite](https://feunard.github.io/alepha/docs/alepha-vite)) ✨:** A seamless Vite plugin that handles all the complex build and development server configurations for your full-stack Alepha applications.
-*   **Command ([@alepha/command](https://feunard.github.io/alepha/docs/alepha-command)) ⌨️:** Build powerful, type-safe command-line interfaces and scripts directly within your application using the `$command` descriptor.
-*   **Retry ([@alepha/retry](https://feunard.github.io/alepha/docs/alepha-retry)) 🔄:** A declarative and powerful decorator (`$retry`) for automatically retrying failed operations with exponential backoff.
-

package/batch.d.ts

@@ -4,6 +4,7 @@ import { DateTimeProvider, DurationLike } from "alepha/datetime";
 import * as _alepha_logger0 from "alepha/logger";
 import * as _alepha_retry0 from "alepha/retry";
 import { RetryDescriptorOptions } from "alepha/retry";
+import * as typebox0 from "typebox";
 
 //#region src/descriptors/$batch.d.ts
 
@@ -532,9 +533,7 @@ declare class BatchDescriptor<TItem extends TSchema, TResponse = any> extends De
   protected readonly dateTime: DateTimeProvider;
   protected readonly partitions: Map<any, any>;
   protected activeHandlers: PromiseWithResolvers<void>[];
-  protected retry: _alepha_retry0.RetryDescriptorFn<(items: (TItem & {
-    params: [];
-  })["static"][]) => TResponse>;
+  protected retry: _alepha_retry0.RetryDescriptorFn<(items: typebox0.StaticType<"Encode", {}, {}, TItem>[]) => TResponse>;
   /**
    * Pushes an item into the batch. The item will be processed
    * asynchronously with other items when the batch is flushed.

package/bucket.d.ts

@@ -2,7 +2,7 @@ import * as _alepha_core1 from "alepha";
 import { Alepha, AlephaError, Descriptor, FileLike, KIND, Service } from "alepha";
 import * as fs from "node:fs";
 import * as _alepha_logger0 from "alepha/logger";
-import * as _sinclair_typebox0 from "@sinclair/typebox";
+import * as typebox0 from "typebox";
 
 //#region src/providers/FileStorageProvider.d.ts
 declare abstract class FileStorageProvider {
@@ -519,7 +519,7 @@ interface BucketFileOptions {
   maxSize?: number;
 }
 declare class BucketDescriptor extends Descriptor<BucketDescriptorOptions> {
-  readonly provider: MemoryFileStorageProvider | FileStorageProvider;
+  readonly provider: FileStorageProvider | MemoryFileStorageProvider;
   get name(): string;
   /**
    * Uploads a file to the bucket.
@@ -537,7 +537,7 @@ declare class BucketDescriptor extends Descriptor<BucketDescriptorOptions> {
    * Downloads a file from the bucket.
    */
   download(fileId: string): Promise<FileLike>;
-  protected $provider(): MemoryFileStorageProvider | FileStorageProvider;
+  protected $provider(): FileStorageProvider | MemoryFileStorageProvider;
 }
 interface BucketFileOptions {
   /**
@@ -579,10 +579,10 @@ declare class LocalFileStorageProvider implements FileStorageProvider {
   protected path(container: string, fileId?: string): string;
   protected isErrorNoEntry(error: unknown): boolean;
 }
-declare const fileMetadataSchema: _sinclair_typebox0.TObject<{
-  name: _sinclair_typebox0.TString;
-  type: _sinclair_typebox0.TString;
-  size: _sinclair_typebox0.TNumber;
+declare const fileMetadataSchema: typebox0.TObject<{
+  name: typebox0.TString;
+  type: typebox0.TString;
+  size: typebox0.TNumber;
 }>;
 //#endregion
 //#region src/index.d.ts

package/command.d.ts

@@ -3,7 +3,7 @@ import { Alepha, AlephaError, Async, Descriptor, KIND, Static, TObject, TSchema
 import * as fs from "node:fs/promises";
 import { glob } from "node:fs/promises";
 import * as _alepha_logger0 from "alepha/logger";
-import * as _sinclair_typebox0 from "@sinclair/typebox";
+import * as typebox0 from "typebox";
 
 //#region src/helpers/Runner.d.ts
 type Task = {
@@ -59,14 +59,14 @@ declare class Runner {
  * within your Alepha application structure.
  */
 declare const $command: {
-  <T extends TObject>(options: CommandDescriptorOptions<T>): CommandDescriptor<T>;
+  <T extends TObject, A extends TSchema>(options: CommandDescriptorOptions<T, A>): CommandDescriptor<T, A>;
   [KIND]: typeof CommandDescriptor;
 };
-interface CommandDescriptorOptions<T extends TObject> {
+interface CommandDescriptorOptions<T extends TObject, A extends TSchema> {
   /**
    * The handler function to execute when the command is matched.
    */
-  handler: (args: CommandHandlerArgs<T>) => Async<void>;
+  handler: (args: CommandHandlerArgs<T, A>) => Async<void>;
   /**
    * The name of the command. If omitted, the property key is used.
    *
@@ -85,18 +85,36 @@ interface CommandDescriptorOptions<T extends TObject> {
    * A TypeBox object schema defining the flags for the command.
    */
   flags?: T;
+  /**
+   * An optional TypeBox schema defining the arguments for the command.
+   *
+   * @example
+   * args: t.string()
+   * my-cli command <arg1: string>
+   *
+   * args: t.optional(t.string())
+   * my-cli command [arg1: string]
+   *
+   * args: t.tuple([t.string(), t.number()])
+   * my-cli command <arg1: string> <arg2: number>
+   *
+   * args: t.tuple([t.string(), t.optional(t.number())])
+   * my-cli command <arg1: string> [arg2: number]
+   */
+  args?: A;
   /**
    * 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>> {
+declare class CommandDescriptor<T extends TObject = TObject, A extends TSchema = TSchema> extends Descriptor<CommandDescriptorOptions<T, A>> {
   readonly flags: TObject<{}>;
   readonly aliases: string[];
   get name(): string;
 }
-interface CommandHandlerArgs<T extends TObject> {
+interface CommandHandlerArgs<T extends TObject, A extends TSchema = TSchema> {
   flags: Static<T>;
+  args: A extends TSchema ? Static<A> : undefined;
   run: RunnerMethod;
   glob: typeof glob;
   fs: typeof fs;
@@ -132,7 +150,7 @@ declare class CliProvider {
     help: {
       aliases: string[];
       description: string;
-      schema: _sinclair_typebox0.TBoolean;
+      schema: typebox0.TBoolean;
     };
   };
   protected readonly onReady: _alepha_core1.HookDescriptor<"ready">;
@@ -144,6 +162,10 @@ declare class CliProvider {
     aliases: string[];
     schema: TSchema;
   }[]): Record<string, any>;
+  protected parseCommandArgs(argv: string[], schema?: TSchema): any;
+  protected parseArgumentValue(value: string, schema: TSchema): any;
+  protected generateArgsUsage(schema?: TSchema): string;
+  protected getTypeName(schema: TSchema): string;
   printHelp(command?: CommandDescriptor<any>): void;
   private getMaxCmdLength;
   private getMaxFlagLength;
@@ -160,7 +182,7 @@ declare class CliProvider {
  * @module alepha.command
  */
 declare const AlephaCommand: _alepha_core1.Service<_alepha_core1.Module>;
-declare module "@sinclair/typebox" {
+declare module "typebox" {
   interface StringOptions {
     /**
      * Additional aliases for the flags.