alepha 0.13.0 → 0.13.2

package/package.json

@@ -2,7 +2,7 @@
   "name": "alepha",
   "description": "Easy-to-use modern TypeScript framework for building many kind of applications.",
   "author": "Nicolas Foures",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -71,267 +71,277 @@
     "./api/files": {
       "types": "./dist/api-files/index.js",
       "import": "./dist/api-files/index.js",
-      "require": "./dist/api-files/index.js"
+      "default": "./dist/api-files/index.js"
     },
     "./api/jobs": {
       "types": "./dist/api-jobs/index.js",
       "import": "./dist/api-jobs/index.js",
-      "require": "./dist/api-jobs/index.js"
+      "default": "./dist/api-jobs/index.js"
     },
     "./api/notifications": {
       "types": "./dist/api-notifications/index.js",
       "import": "./dist/api-notifications/index.js",
-      "require": "./dist/api-notifications/index.js"
+      "default": "./dist/api-notifications/index.js"
     },
     "./api/parameters": {
       "types": "./dist/api-parameters/index.js",
       "import": "./dist/api-parameters/index.js",
-      "require": "./dist/api-parameters/index.js"
+      "default": "./dist/api-parameters/index.js"
     },
     "./api/users": {
       "types": "./dist/api-users/index.js",
+      "react-native": "./dist/api-users/index.browser.js",
       "browser": "./dist/api-users/index.browser.js",
       "import": "./dist/api-users/index.js",
-      "require": "./dist/api-users/index.js"
+      "default": "./dist/api-users/index.js"
     },
     "./api/verifications": {
       "types": "./dist/api-verifications/index.js",
       "import": "./dist/api-verifications/index.js",
-      "require": "./dist/api-verifications/index.js"
+      "default": "./dist/api-verifications/index.js"
     },
     "./batch": {
       "types": "./dist/batch/index.js",
       "import": "./dist/batch/index.js",
-      "require": "./dist/batch/index.js"
+      "default": "./dist/batch/index.js"
     },
     "./bin": {
       "types": "./dist/bin/index.js",
       "import": "./dist/bin/index.js",
-      "require": "./dist/bin/index.js"
+      "default": "./dist/bin/index.js"
     },
     "./bucket": {
       "types": "./dist/bucket/index.js",
       "import": "./dist/bucket/index.js",
-      "require": "./dist/bucket/index.js"
+      "default": "./dist/bucket/index.js"
     },
     "./cache": {
       "types": "./dist/cache/index.js",
       "import": "./dist/cache/index.js",
-      "require": "./dist/cache/index.js"
+      "default": "./dist/cache/index.js"
     },
     "./cache/redis": {
       "types": "./dist/cache-redis/index.js",
       "import": "./dist/cache-redis/index.js",
-      "require": "./dist/cache-redis/index.js"
+      "default": "./dist/cache-redis/index.js"
     },
     "./cli": {
       "types": "./dist/cli/index.js",
       "import": "./dist/cli/index.js",
-      "require": "./dist/cli/index.js"
+      "default": "./dist/cli/index.js"
     },
     "./command": {
       "types": "./dist/command/index.js",
       "import": "./dist/command/index.js",
-      "require": "./dist/command/index.js"
+      "default": "./dist/command/index.js"
     },
     ".": {
       "types": "./dist/core/index.js",
+      "react-native": "./dist/core/index.native.js",
       "browser": "./dist/core/index.browser.js",
       "import": "./dist/core/index.js",
-      "require": "./dist/core/index.js"
+      "default": "./dist/core/index.js"
     },
     "./datetime": {
       "types": "./dist/datetime/index.js",
       "import": "./dist/datetime/index.js",
-      "require": "./dist/datetime/index.js"
+      "default": "./dist/datetime/index.js"
     },
     "./email": {
       "types": "./dist/email/index.js",
       "import": "./dist/email/index.js",
-      "require": "./dist/email/index.js"
+      "default": "./dist/email/index.js"
     },
     "./fake": {
       "types": "./dist/fake/index.js",
       "import": "./dist/fake/index.js",
-      "require": "./dist/fake/index.js"
+      "default": "./dist/fake/index.js"
     },
     "./file": {
       "types": "./dist/file/index.js",
       "import": "./dist/file/index.js",
-      "require": "./dist/file/index.js"
+      "default": "./dist/file/index.js"
     },
     "./lock": {
       "types": "./dist/lock/index.js",
       "import": "./dist/lock/index.js",
-      "require": "./dist/lock/index.js"
+      "default": "./dist/lock/index.js"
     },
     "./lock/redis": {
       "types": "./dist/lock-redis/index.js",
       "import": "./dist/lock-redis/index.js",
-      "require": "./dist/lock-redis/index.js"
+      "default": "./dist/lock-redis/index.js"
     },
     "./logger": {
       "types": "./dist/logger/index.js",
       "import": "./dist/logger/index.js",
-      "require": "./dist/logger/index.js"
+      "default": "./dist/logger/index.js"
     },
     "./orm": {
       "types": "./dist/orm/index.js",
+      "react-native": "./dist/orm/index.browser.js",
       "browser": "./dist/orm/index.browser.js",
       "import": "./dist/orm/index.js",
-      "require": "./dist/orm/index.js"
+      "default": "./dist/orm/index.js"
     },
     "./queue": {
       "types": "./dist/queue/index.js",
       "import": "./dist/queue/index.js",
-      "require": "./dist/queue/index.js"
+      "default": "./dist/queue/index.js"
     },
     "./queue/redis": {
       "types": "./dist/queue-redis/index.js",
       "import": "./dist/queue-redis/index.js",
-      "require": "./dist/queue-redis/index.js"
+      "default": "./dist/queue-redis/index.js"
     },
     "./redis": {
       "types": "./dist/redis/index.js",
       "import": "./dist/redis/index.js",
-      "require": "./dist/redis/index.js"
+      "default": "./dist/redis/index.js"
     },
     "./retry": {
       "types": "./dist/retry/index.js",
       "import": "./dist/retry/index.js",
-      "require": "./dist/retry/index.js"
+      "default": "./dist/retry/index.js"
     },
     "./router": {
       "types": "./dist/router/index.js",
       "import": "./dist/router/index.js",
-      "require": "./dist/router/index.js"
+      "default": "./dist/router/index.js"
     },
     "./scheduler": {
       "types": "./dist/scheduler/index.js",
       "import": "./dist/scheduler/index.js",
-      "require": "./dist/scheduler/index.js"
+      "default": "./dist/scheduler/index.js"
     },
     "./security": {
       "types": "./dist/security/index.js",
+      "react-native": "./dist/security/index.browser.js",
       "browser": "./dist/security/index.browser.js",
       "import": "./dist/security/index.js",
-      "require": "./dist/security/index.js"
+      "default": "./dist/security/index.js"
     },
     "./server": {
       "types": "./dist/server/index.js",
+      "react-native": "./dist/server/index.browser.js",
       "browser": "./dist/server/index.browser.js",
       "import": "./dist/server/index.js",
-      "require": "./dist/server/index.js"
+      "default": "./dist/server/index.js"
     },
     "./server/auth": {
       "types": "./dist/server-auth/index.js",
+      "react-native": "./dist/server-auth/index.browser.js",
       "browser": "./dist/server-auth/index.browser.js",
       "import": "./dist/server-auth/index.js",
-      "require": "./dist/server-auth/index.js"
+      "default": "./dist/server-auth/index.js"
     },
     "./server/cache": {
       "types": "./dist/server-cache/index.js",
       "import": "./dist/server-cache/index.js",
-      "require": "./dist/server-cache/index.js"
+      "default": "./dist/server-cache/index.js"
     },
     "./server/compress": {
       "types": "./dist/server-compress/index.js",
       "import": "./dist/server-compress/index.js",
-      "require": "./dist/server-compress/index.js"
+      "default": "./dist/server-compress/index.js"
     },
     "./server/cookies": {
       "types": "./dist/server-cookies/index.js",
+      "react-native": "./dist/server-cookies/index.browser.js",
       "browser": "./dist/server-cookies/index.browser.js",
       "import": "./dist/server-cookies/index.js",
-      "require": "./dist/server-cookies/index.js"
+      "default": "./dist/server-cookies/index.js"
     },
     "./server/cors": {
       "types": "./dist/server-cors/index.js",
       "import": "./dist/server-cors/index.js",
-      "require": "./dist/server-cors/index.js"
+      "default": "./dist/server-cors/index.js"
     },
     "./server/health": {
       "types": "./dist/server-health/index.js",
       "import": "./dist/server-health/index.js",
-      "require": "./dist/server-health/index.js"
+      "default": "./dist/server-health/index.js"
     },
     "./server/helmet": {
       "types": "./dist/server-helmet/index.js",
       "import": "./dist/server-helmet/index.js",
-      "require": "./dist/server-helmet/index.js"
+      "default": "./dist/server-helmet/index.js"
     },
     "./server/links": {
       "types": "./dist/server-links/index.js",
+      "react-native": "./dist/server-links/index.browser.js",
       "browser": "./dist/server-links/index.browser.js",
       "import": "./dist/server-links/index.js",
-      "require": "./dist/server-links/index.js"
+      "default": "./dist/server-links/index.js"
     },
     "./server/metrics": {
       "types": "./dist/server-metrics/index.js",
       "import": "./dist/server-metrics/index.js",
-      "require": "./dist/server-metrics/index.js"
+      "default": "./dist/server-metrics/index.js"
     },
     "./server/multipart": {
       "types": "./dist/server-multipart/index.js",
       "import": "./dist/server-multipart/index.js",
-      "require": "./dist/server-multipart/index.js"
+      "default": "./dist/server-multipart/index.js"
     },
     "./server/proxy": {
       "types": "./dist/server-proxy/index.js",
       "import": "./dist/server-proxy/index.js",
-      "require": "./dist/server-proxy/index.js"
+      "default": "./dist/server-proxy/index.js"
     },
     "./server/rate-limit": {
       "types": "./dist/server-rate-limit/index.js",
       "import": "./dist/server-rate-limit/index.js",
-      "require": "./dist/server-rate-limit/index.js"
+      "default": "./dist/server-rate-limit/index.js"
     },
     "./server/security": {
       "types": "./dist/server-security/index.js",
+      "react-native": "./dist/server-security/index.browser.js",
       "browser": "./dist/server-security/index.browser.js",
       "import": "./dist/server-security/index.js",
-      "require": "./dist/server-security/index.js"
+      "default": "./dist/server-security/index.js"
     },
     "./server/static": {
       "types": "./dist/server-static/index.js",
       "import": "./dist/server-static/index.js",
-      "require": "./dist/server-static/index.js"
+      "default": "./dist/server-static/index.js"
     },
     "./server/swagger": {
       "types": "./dist/server-swagger/index.js",
       "import": "./dist/server-swagger/index.js",
-      "require": "./dist/server-swagger/index.js"
+      "default": "./dist/server-swagger/index.js"
     },
     "./sms": {
       "types": "./dist/sms/index.js",
       "import": "./dist/sms/index.js",
-      "require": "./dist/sms/index.js"
+      "default": "./dist/sms/index.js"
     },
     "./thread": {
       "types": "./dist/thread/index.js",
       "import": "./dist/thread/index.js",
-      "require": "./dist/thread/index.js"
+      "default": "./dist/thread/index.js"
     },
     "./topic": {
       "types": "./dist/topic/index.js",
       "import": "./dist/topic/index.js",
-      "require": "./dist/topic/index.js"
+      "default": "./dist/topic/index.js"
     },
     "./topic/redis": {
       "types": "./dist/topic-redis/index.js",
       "import": "./dist/topic-redis/index.js",
-      "require": "./dist/topic-redis/index.js"
+      "default": "./dist/topic-redis/index.js"
     },
     "./vite": {
       "types": "./dist/vite/index.js",
       "import": "./dist/vite/index.js",
-      "require": "./dist/vite/index.js"
+      "default": "./dist/vite/index.js"
     },
     "./websocket": {
       "types": "./dist/websocket/index.js",
+      "react-native": "./dist/websocket/index.browser.js",
       "browser": "./dist/websocket/index.browser.js",
       "import": "./dist/websocket/index.js",
-      "require": "./dist/websocket/index.js"
+      "default": "./dist/websocket/index.js"
     },
     "./tsconfig.base": "./tsconfig.base.json",
     "./package.json": "./package.json"

package/src/api-files/services/FileService.ts

@@ -2,7 +2,7 @@ import { createHash } from "node:crypto";
 import { $hook, $inject, Alepha, type FileLike } from "alepha";
 import {
   $bucket,
-  type BucketDescriptor,
+  type BucketPrimitive,
   FileNotFoundError,
 } from "alepha/bucket";
 import {
@@ -77,17 +77,15 @@ export class FileService {
   }
 
   /**
-   * Gets a bucket descriptor by name.
+   * Gets a bucket primitive by name.
    *
    * @param bucketName - The name of the bucket to retrieve (defaults to "default")
-   * @returns The bucket descriptor
+   * @returns The bucket primitive
    * @throws {NotFoundError} If the bucket is not found
    */
-  public bucket(
-    bucketName: string = this.defaultBucket.name,
-  ): BucketDescriptor {
+  public bucket(bucketName: string = this.defaultBucket.name): BucketPrimitive {
     const bucket = this.alepha
-      .descriptors($bucket)
+      .primitives($bucket)
       .find((it) => it.name === bucketName);
 
     if (!bucket) {

package/src/api-jobs/index.ts

@@ -6,8 +6,8 @@ import { JobService } from "./services/JobService.ts";
 // ---------------------------------------------------------------------------------------------------------------------
 
 export * from "./controllers/JobController.ts";
-export * from "./descriptors/$job.ts";
 export * from "./entities/jobExecutions.ts";
+export * from "./primitives/$job.ts";
 export * from "./providers/JobProvider.ts";
 export * from "./schemas/jobExecutionQuerySchema.ts";
 export * from "./schemas/jobExecutionResourceSchema.ts";

package/src/api-jobs/{descriptors → primitives}/$job.ts

@@ -1,26 +1,26 @@
-import { $inject, createDescriptor, Descriptor, KIND } from "alepha";
+import { $inject, createPrimitive, KIND, Primitive } from "alepha";
 import type { DateTime } from "alepha/datetime";
 import { type Job, JobProvider } from "../providers/JobProvider.ts";
 
 /**
- * Job descriptor - a drop-in replacement for $scheduler with built-in execution tracking.
+ * Job primitive - a drop-in replacement for $scheduler with built-in execution tracking.
  */
-export const $job = (options: JobDescriptorOptions): JobDescriptor => {
-  return createDescriptor(JobDescriptor, options);
+export const $job = (options: JobPrimitiveOptions): JobPrimitive => {
+  return createPrimitive(JobPrimitive, options);
 };
 
 // ---------------------------------------------------------------------------------------------------------------------
 
-export type JobDescriptorOptions = Omit<Job, "name"> & {
+export type JobPrimitiveOptions = Omit<Job, "name"> & {
   /**
-   * Name of the job. Defaults to the descriptor property name.
+   * Name of the job. Defaults to the primitive property name.
    */
   name?: string;
 };
 
 // ---------------------------------------------------------------------------------------------------------------------
 
-export class JobDescriptor extends Descriptor<JobDescriptorOptions> {
+export class JobPrimitive extends Primitive<JobPrimitiveOptions> {
   protected readonly jobProvider = $inject(JobProvider);
 
   public get name(): string {
@@ -43,7 +43,7 @@ export class JobDescriptor extends Descriptor<JobDescriptorOptions> {
   }
 }
 
-$job[KIND] = JobDescriptor;
+$job[KIND] = JobPrimitive;
 
 // ---------------------------------------------------------------------------------------------------------------------
 

package/src/api-jobs/providers/JobProvider.ts

@@ -1,6 +1,6 @@
 import { $env, $inject, Alepha, type Async, type Static, t } from "alepha";
 import { type DateTime, DateTimeProvider } from "alepha/datetime";
-import { $lock, type LockDescriptor } from "alepha/lock";
+import { $lock, type LockPrimitive } from "alepha/lock";
 import type { LogEntry } from "alepha/logger";
 import { $repository } from "alepha/orm";
 import { CronProvider } from "alepha/scheduler";
@@ -32,7 +32,7 @@ export class JobProvider {
   protected readonly jobs = new Map<string, JobRegistration>();
 
   /**
-   * Register and set up a job for execution (called during descriptor initialization).
+   * Register and set up a job for execution (called during primitive initialization).
    */
   public registerJob(options: Job): JobRegistration {
     const jobName = options.name;
@@ -55,8 +55,8 @@ export class JobProvider {
       });
     }
 
-    // Create lock descriptor if locking is enabled
-    const lockDescriptor =
+    // Create lock primitive if locking is enabled
+    const lockPrimitive =
       options.lock !== false
         ? $lock({
             name: () => {
@@ -74,7 +74,7 @@ export class JobProvider {
     const registration: JobRegistration = {
       name: jobName,
       options,
-      lockDescriptor,
+      lockPrimitive,
     };
 
     this.jobs.set(jobName, registration);
@@ -99,15 +99,15 @@ export class JobProvider {
     }
 
     // Execute handler with or without lock
-    if (registration.options.lock !== false && registration.lockDescriptor) {
-      await registration.lockDescriptor.run();
+    if (registration.options.lock !== false && registration.lockPrimitive) {
+      await registration.lockPrimitive.run();
     } else {
       await this.executeJob(jobName, registration.options.handler);
     }
   }
 
   /**
-   * Execute a job handler (called by the job descriptor).
+   * Execute a job handler (called by the job primitive).
    */
   public async executeJob(
     jobName: string,
@@ -260,5 +260,5 @@ export interface Job {
 export interface JobRegistration {
   name: string;
   options: Job;
-  lockDescriptor: LockDescriptor<() => Promise<void>> | null;
+  lockPrimitive: LockPrimitive<() => Promise<void>> | null;
 }

package/src/api-jobs/services/JobService.ts

@@ -1,7 +1,7 @@
 import { $inject, Alepha } from "alepha";
 import { $repository } from "alepha/orm";
-import { $job } from "../descriptors/$job.ts";
 import { jobExecutions } from "../entities/jobExecutions.ts";
+import { $job } from "../primitives/$job.ts";
 import type { JobExecutionQuery } from "../schemas/jobExecutionQuerySchema.ts";
 
 export class JobService {
@@ -9,8 +9,8 @@ export class JobService {
   protected readonly executionRepository = $repository(jobExecutions);
 
   public async getJobs(): Promise<string[]> {
-    const jobDescriptors = this.alepha.descriptors($job);
-    return jobDescriptors.map((job) => job.name);
+    const jobPrimitives = this.alepha.primitives($job);
+    return jobPrimitives.map((job) => job.name);
   }
 
   public async getJobExecutions(query: JobExecutionQuery = {}) {
@@ -34,8 +34,8 @@ export class JobService {
   }
 
   public async triggerJob(name: string): Promise<{ ok: boolean }> {
-    const jobDescriptors = this.alepha.descriptors($job);
-    const job = jobDescriptors.find((j) => j.name === name);
+    const jobPrimitives = this.alepha.primitives($job);
+    const job = jobPrimitives.find((j) => j.name === name);
 
     if (!job) {
       throw new Error(`Job not found: ${name}`);

package/src/api-notifications/index.ts

@@ -1,9 +1,7 @@
 import { $module } from "alepha";
 import { NotificationController } from "./controllers/NotificationController.ts";
-import { $notification } from "./descriptors/$notification.ts";
 import { NotificationJobs } from "./jobs/NotificationJobs.ts";
-import { MemorySmsProvider } from "./providers/MemorySmsProvider.ts";
-import { SmsProvider } from "./providers/SmsProvider.ts";
+import { $notification } from "./primitives/$notification.ts";
 import { NotificationQueues } from "./queues/NotificationQueues.ts";
 import { NotificationSenderService } from "./services/NotificationSenderService.ts";
 import {
@@ -14,11 +12,9 @@ import {
 // ---------------------------------------------------------------------------------------------------------------------
 
 export * from "./controllers/NotificationController.ts";
-export * from "./descriptors/$notification.ts";
 export * from "./entities/notifications.ts";
 export * from "./jobs/NotificationJobs.ts";
-export * from "./providers/MemorySmsProvider.ts";
-export * from "./providers/SmsProvider.ts";
+export * from "./primitives/$notification.ts";
 export * from "./queues/NotificationQueues.ts";
 export * from "./schemas/notificationContactPreferencesSchema.ts";
 export * from "./schemas/notificationCreateSchema.ts";
@@ -33,27 +29,21 @@ export * from "./services/NotificationService.ts";
  * This module includes notification sending, retrieval, status tracking,
  * and user notification preferences management.
  *
+ * Requires `AlephaSms` module to be loaded for SMS notifications.
+ *
  * @module alepha.api.notifications
  */
 export const AlephaApiNotifications = $module({
   name: "alepha.api.notifications",
-  descriptors: [$notification],
+  primitives: [$notification],
   services: [
     NotificationController,
     NotificationService,
     NotificationSenderService,
     NotificationQueues,
     NotificationJobs,
-    SmsProvider,
-    MemorySmsProvider,
   ],
   register: (alepha) => {
-    alepha.with({
-      optional: true,
-      provide: SmsProvider,
-      use: MemorySmsProvider,
-    });
-
     const env = alepha.parseEnv(notificationServiceEnvSchema);
     if (env.NOTIFICATION_QUEUE) {
       alepha.with(NotificationQueues);

package/src/api-notifications/{descriptors → primitives}/$notification.ts

@@ -1,8 +1,8 @@
 import {
   $inject,
-  createDescriptor,
-  Descriptor,
+  createPrimitive,
   KIND,
+  Primitive,
   type Static,
   type StaticEncode,
   type TObject,
@@ -10,7 +10,7 @@ import {
 import { NotificationService } from "../services/NotificationService.ts";
 
 /**
- * Creates a notification descriptor for managing email/SMS notification templates.
+ * Creates a notification primitive for managing email/SMS notification templates.
  *
  * Provides type-safe, reusable notification templates with multi-language support,
  * variable substitution, and categorization for different notification channels.
@@ -38,12 +38,12 @@ import { NotificationService } from "../services/NotificationService.ts";
  * ```
  */
 export const $notification = <T extends TObject>(
-  options: NotificationDescriptorOptions<T>,
-) => createDescriptor(NotificationDescriptor<T>, options);
+  options: NotificationPrimitiveOptions<T>,
+) => createPrimitive(NotificationPrimitive<T>, options);
 
 // ---------------------------------------------------------------------------------------------------------------------
 
-export interface NotificationDescriptorOptions<T extends TObject>
+export interface NotificationPrimitiveOptions<T extends TObject>
   extends NotificationMessage<T> {
   name?: string;
   description?: string;
@@ -59,8 +59,8 @@ export interface NotificationDescriptorOptions<T extends TObject>
 
 // ---------------------------------------------------------------------------------------------------------------------
 
-export class NotificationDescriptor<T extends TObject> extends Descriptor<
-  NotificationDescriptorOptions<T>
+export class NotificationPrimitive<T extends TObject> extends Primitive<
+  NotificationPrimitiveOptions<T>
 > {
   protected readonly notificationService = $inject(NotificationService);
 
@@ -78,12 +78,12 @@ export class NotificationDescriptor<T extends TObject> extends Descriptor<
     }
   }
 
-  public configure(options: Partial<NotificationDescriptorOptions<T>>) {
+  public configure(options: Partial<NotificationPrimitiveOptions<T>>) {
     Object.assign(this.options, options);
   }
 }
 
-$notification[KIND] = NotificationDescriptor;
+$notification[KIND] = NotificationPrimitive;
 
 // ---------------------------------------------------------------------------------------------------------------------