alepha 0.13.1 → 0.13.3

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.1",
+  "version": "0.13.3",
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -23,10 +23,10 @@
     "drizzle-kit": "^0.31.7",
     "drizzle-orm": "^0.44.7",
     "postgres": "^3.4.7",
-    "tsx": "^4.20.6",
-    "typebox": "^1.0.58",
+    "tsx": "^4.21.0",
+    "typebox": "^1.0.61",
     "typescript": "^5.9.3",
-    "vite": "^7.2.4",
+    "vite": "^7.2.6",
     "vite-bundle-analyzer": "^1.2.3",
     "ws": "^8.18.3"
   },
@@ -37,12 +37,12 @@
     "@types/nodemailer": "^7.0.4",
     "@types/ws": "^8.18.1",
     "cron-schedule": "^6.0.0",
-    "jose": "^6.1.2",
+    "jose": "^6.1.3",
     "nodemailer": "^7.0.11",
     "openid-client": "^6.8.1",
     "prom-client": "^15.1.3",
     "swagger-ui-dist": "^5.30.3",
-    "vitest": "^4.0.14"
+    "vitest": "^4.0.15"
   },
   "scarfSettings": {
     "enabled": false
@@ -70,217 +70,288 @@
   "exports": {
     "./api/files": {
       "types": "./dist/api-files/index.js",
-      "import": "./dist/api-files/index.js"
+      "react-native": "./dist/api-files/index.browser.js",
+      "browser": "./dist/api-files/index.browser.js",
+      "import": "./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"
+      "react-native": "./dist/api-jobs/index.browser.js",
+      "browser": "./dist/api-jobs/index.browser.js",
+      "import": "./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"
+      "react-native": "./dist/api-notifications/index.browser.js",
+      "browser": "./dist/api-notifications/index.browser.js",
+      "import": "./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"
+      "react-native": "./dist/api-parameters/index.browser.js",
+      "browser": "./dist/api-parameters/index.browser.js",
+      "import": "./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"
+      "import": "./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"
+      "react-native": "./dist/api-verifications/index.browser.js",
+      "browser": "./dist/api-verifications/index.browser.js",
+      "import": "./dist/api-verifications/index.js",
+      "default": "./dist/api-verifications/index.js"
     },
     "./batch": {
       "types": "./dist/batch/index.js",
-      "import": "./dist/batch/index.js"
+      "import": "./dist/batch/index.js",
+      "default": "./dist/batch/index.js"
     },
     "./bin": {
       "types": "./dist/bin/index.js",
-      "import": "./dist/bin/index.js"
+      "import": "./dist/bin/index.js",
+      "default": "./dist/bin/index.js"
     },
     "./bucket": {
       "types": "./dist/bucket/index.js",
-      "import": "./dist/bucket/index.js"
+      "import": "./dist/bucket/index.js",
+      "default": "./dist/bucket/index.js"
     },
     "./cache": {
       "types": "./dist/cache/index.js",
-      "import": "./dist/cache/index.js"
+      "import": "./dist/cache/index.js",
+      "default": "./dist/cache/index.js"
     },
     "./cache/redis": {
       "types": "./dist/cache-redis/index.js",
-      "import": "./dist/cache-redis/index.js"
+      "import": "./dist/cache-redis/index.js",
+      "default": "./dist/cache-redis/index.js"
     },
     "./cli": {
       "types": "./dist/cli/index.js",
-      "import": "./dist/cli/index.js"
+      "import": "./dist/cli/index.js",
+      "default": "./dist/cli/index.js"
     },
     "./command": {
       "types": "./dist/command/index.js",
-      "import": "./dist/command/index.js"
+      "import": "./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"
+      "import": "./dist/core/index.js",
+      "default": "./dist/core/index.js"
     },
     "./datetime": {
       "types": "./dist/datetime/index.js",
-      "import": "./dist/datetime/index.js"
+      "import": "./dist/datetime/index.js",
+      "default": "./dist/datetime/index.js"
     },
     "./email": {
       "types": "./dist/email/index.js",
-      "import": "./dist/email/index.js"
+      "import": "./dist/email/index.js",
+      "default": "./dist/email/index.js"
     },
     "./fake": {
       "types": "./dist/fake/index.js",
-      "import": "./dist/fake/index.js"
+      "import": "./dist/fake/index.js",
+      "default": "./dist/fake/index.js"
     },
     "./file": {
       "types": "./dist/file/index.js",
-      "import": "./dist/file/index.js"
+      "import": "./dist/file/index.js",
+      "default": "./dist/file/index.js"
     },
     "./lock": {
       "types": "./dist/lock/index.js",
-      "import": "./dist/lock/index.js"
+      "import": "./dist/lock/index.js",
+      "default": "./dist/lock/index.js"
     },
     "./lock/redis": {
       "types": "./dist/lock-redis/index.js",
-      "import": "./dist/lock-redis/index.js"
+      "import": "./dist/lock-redis/index.js",
+      "default": "./dist/lock-redis/index.js"
     },
     "./logger": {
       "types": "./dist/logger/index.js",
-      "import": "./dist/logger/index.js"
+      "import": "./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"
+      "import": "./dist/orm/index.js",
+      "default": "./dist/orm/index.js"
     },
     "./queue": {
       "types": "./dist/queue/index.js",
-      "import": "./dist/queue/index.js"
+      "import": "./dist/queue/index.js",
+      "default": "./dist/queue/index.js"
     },
     "./queue/redis": {
       "types": "./dist/queue-redis/index.js",
-      "import": "./dist/queue-redis/index.js"
+      "import": "./dist/queue-redis/index.js",
+      "default": "./dist/queue-redis/index.js"
     },
     "./redis": {
       "types": "./dist/redis/index.js",
-      "import": "./dist/redis/index.js"
+      "import": "./dist/redis/index.js",
+      "default": "./dist/redis/index.js"
     },
     "./retry": {
       "types": "./dist/retry/index.js",
-      "import": "./dist/retry/index.js"
+      "import": "./dist/retry/index.js",
+      "default": "./dist/retry/index.js"
     },
     "./router": {
       "types": "./dist/router/index.js",
-      "import": "./dist/router/index.js"
+      "import": "./dist/router/index.js",
+      "default": "./dist/router/index.js"
     },
     "./scheduler": {
       "types": "./dist/scheduler/index.js",
-      "import": "./dist/scheduler/index.js"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./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"
+      "import": "./dist/server-swagger/index.js",
+      "default": "./dist/server-swagger/index.js"
     },
     "./sms": {
       "types": "./dist/sms/index.js",
-      "import": "./dist/sms/index.js"
+      "import": "./dist/sms/index.js",
+      "default": "./dist/sms/index.js"
     },
     "./thread": {
       "types": "./dist/thread/index.js",
-      "import": "./dist/thread/index.js"
+      "import": "./dist/thread/index.js",
+      "default": "./dist/thread/index.js"
     },
     "./topic": {
       "types": "./dist/topic/index.js",
-      "import": "./dist/topic/index.js"
+      "import": "./dist/topic/index.js",
+      "default": "./dist/topic/index.js"
     },
     "./topic/redis": {
       "types": "./dist/topic-redis/index.js",
-      "import": "./dist/topic-redis/index.js"
+      "import": "./dist/topic-redis/index.js",
+      "default": "./dist/topic-redis/index.js"
     },
     "./vite": {
       "types": "./dist/vite/index.js",
-      "import": "./dist/vite/index.js"
+      "import": "./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"
+      "import": "./dist/websocket/index.js",
+      "default": "./dist/websocket/index.js"
     },
     "./tsconfig.base": "./tsconfig.base.json",
     "./package.json": "./package.json"

package/src/api-files/index.browser.ts

@@ -0,0 +1,17 @@
+import { $module } from "alepha";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export type * from "./controllers/FileController.ts";
+export type * from "./controllers/StorageStatsController.ts";
+export * from "./entities/files.ts";
+export * from "./schemas/fileQuerySchema.ts";
+export * from "./schemas/fileResourceSchema.ts";
+export * from "./schemas/storageStatsSchema.ts";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export const AlephaApiFiles = $module({
+  name: "alepha.api.files",
+  services: [],
+});

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.browser.ts

@@ -0,0 +1,15 @@
+import { $module } from "alepha";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export * from "./entities/jobExecutions.ts";
+export * from "./schemas/jobExecutionQuerySchema.ts";
+export * from "./schemas/jobExecutionResourceSchema.ts";
+export * from "./schemas/triggerJobSchema.ts";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export const AlephaApiJobs = $module({
+  name: "alepha.api.jobs",
+  services: [],
+});

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/controllers/NotificationController.ts

@@ -1 +1,26 @@
-export class NotificationController {}
+import { $inject } from "alepha";
+import { pg } from "alepha/orm";
+import { $action } from "alepha/server";
+import { notifications } from "../entities/notifications.ts";
+import { notificationQuerySchema } from "../schemas/notificationQuerySchema.ts";
+import { NotificationService } from "../services/NotificationService.ts";
+
+export class NotificationController {
+  protected readonly url = "/notifications";
+  protected readonly group = "notifications";
+  protected readonly notificationService = $inject(NotificationService);
+
+  /**
+   * Find notifications with pagination and filtering.
+   */
+  public readonly findNotifications = $action({
+    path: this.url,
+    group: this.group,
+    description: "Find notifications with pagination and filtering",
+    schema: {
+      query: notificationQuerySchema,
+      response: pg.page(notifications.schema),
+    },
+    handler: ({ query }) => this.notificationService.findNotifications(query),
+  });
+}

package/src/api-notifications/index.browser.ts

@@ -0,0 +1,17 @@
+import { $module } from "alepha";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export * from "./controllers/NotificationController.ts";
+export * from "./entities/notifications.ts";
+export * from "./schemas/notificationContactPreferencesSchema.ts";
+export * from "./schemas/notificationContactSchema.ts";
+export * from "./schemas/notificationCreateSchema.ts";
+export * from "./schemas/notificationQuerySchema.ts";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+export const AlephaApiNotifications = $module({
+  name: "alepha.api.notifications",
+  services: [],
+});