alepha 0.13.0 → 0.13.2

package/dist/queue/index.d.ts

@@ -1,5 +1,5 @@
 import * as alepha1 from "alepha";
-import { Alepha, Descriptor, KIND, Service, Static, TSchema } from "alepha";
+import { Alepha, KIND, Primitive, Service, Static, TSchema } from "alepha";
 import * as alepha_logger1 from "alepha/logger";
 import { DateTimeProvider } from "alepha/datetime";
 
@@ -642,11 +642,11 @@ declare class MemoryQueueProvider extends QueueProvider {
   cancelWaiters(): void;
 }
 //#endregion
-//#region src/queue/descriptors/$queue.d.ts
+//#region src/queue/primitives/$queue.d.ts
 /**
- * Creates a queue descriptor for asynchronous message processing with background workers.
+ * Creates a queue primitive for asynchronous message processing with background workers.
  *
- * The $queue descriptor enables powerful asynchronous communication patterns in your application.
+ * The $queue primitive enables powerful asynchronous communication patterns in your application.
  * It provides type-safe message queuing with automatic worker processing, making it perfect for
  * decoupling components and handling background tasks efficiently.
  *
@@ -755,10 +755,10 @@ declare class MemoryQueueProvider extends QueueProvider {
  * ```
  */
 declare const $queue: {
-  <T extends TSchema>(options: QueueDescriptorOptions<T>): QueueDescriptor<T>;
-  [KIND]: typeof QueueDescriptor;
+  <T extends TSchema>(options: QueuePrimitiveOptions<T>): QueuePrimitive<T>;
+  [KIND]: typeof QueuePrimitive;
 };
-interface QueueDescriptorOptions<T extends TSchema> {
+interface QueuePrimitiveOptions<T extends TSchema> {
   /**
    * Unique name for the queue.
    *
@@ -946,7 +946,7 @@ interface QueueDescriptorOptions<T extends TSchema> {
    */
   removeOnFail?: boolean | number;
 }
-declare class QueueDescriptor<T extends TSchema> extends Descriptor<QueueDescriptorOptions<T>> {
+declare class QueuePrimitive<T extends TSchema> extends Primitive<QueuePrimitiveOptions<T>> {
   protected readonly log: alepha_logger1.Logger;
   readonly provider: QueueProvider | MemoryQueueProvider;
   /**
@@ -966,7 +966,7 @@ declare class QueueDescriptor<T extends TSchema> extends Descriptor<QueueDescrip
    */
   push(payload: Static<T>, options: QueueAddJobOptions): Promise<void>;
   /**
-   * Get default job options from descriptor configuration.
+   * Get default job options from primitive configuration.
    */
   protected getDefaultJobOptions(): {
     maxAttempts: number | undefined;
@@ -985,16 +985,16 @@ interface QueueMessage<T extends TSchema> {
   payload: Static<T>;
 }
 //#endregion
-//#region src/queue/descriptors/$consumer.d.ts
+//#region src/queue/primitives/$consumer.d.ts
 /**
- * Creates a consumer descriptor to process messages from a specific queue.
+ * Creates a consumer primitive to process messages from a specific queue.
  *
  * Provides a dedicated message consumer that connects to a queue and processes messages
  * with custom handler logic, enabling scalable architectures where multiple consumers
  * can process messages from the same queue.
  *
  * **Key Features**
- * - Seamless integration with any $queue descriptor
+ * - Seamless integration with any $queue primitive
  * - Full type safety inherited from queue schema
  * - Automatic worker management for background processing
  * - Built-in error handling and retry mechanisms
@@ -1036,12 +1036,12 @@ interface QueueMessage<T extends TSchema> {
  * ```
  */
 declare const $consumer: {
-  <T extends TSchema>(options: ConsumerDescriptorOptions<T>): ConsumerDescriptor<T>;
-  [KIND]: typeof ConsumerDescriptor;
+  <T extends TSchema>(options: ConsumerPrimitiveOptions<T>): ConsumerPrimitive<T>;
+  [KIND]: typeof ConsumerPrimitive;
 };
-interface ConsumerDescriptorOptions<T extends TSchema> {
+interface ConsumerPrimitiveOptions<T extends TSchema> {
   /**
-   * The queue descriptor that this consumer will process messages from.
+   * The queue primitive that this consumer will process messages from.
    *
    * This establishes the connection between the consumer and its source queue:
    * - The consumer inherits the queue's message schema for type safety
@@ -1065,12 +1065,12 @@ interface ConsumerDescriptorOptions<T extends TSchema> {
    *
    * // Then, create a consumer for that queue
    * emailConsumer = $consumer({
-   *   queue: this.emailQueue,  // Reference the queue descriptor
+   *   queue: this.emailQueue,  // Reference the queue primitive
    *   handler: async (message) => { } // process email
    * });
    * ```
    */
-  queue: QueueDescriptor<T>;
+  queue: QueuePrimitive<T>;
   /**
    * Message handler function that processes individual messages from the queue.
    *
@@ -1148,7 +1148,7 @@ interface ConsumerDescriptorOptions<T extends TSchema> {
     payload: Static<T>;
   }) => Promise<void>;
 }
-declare class ConsumerDescriptor<T extends TSchema> extends Descriptor<ConsumerDescriptorOptions<T>> {}
+declare class ConsumerPrimitive<T extends TSchema> extends Primitive<ConsumerPrimitiveOptions<T>> {}
 //#endregion
 //#region src/queue/providers/WorkerProvider.d.ts
 declare const envSchema: alepha1.TObject<{
@@ -1201,7 +1201,7 @@ declare class WorkerProvider {
   protected abortController: AbortController | undefined;
   protected workerId: string;
   get isRunning(): boolean;
-  protected readonly start: alepha1.HookDescriptor<"start">;
+  protected readonly start: alepha1.HookPrimitive<"start">;
   /**
    * Start the workers.
    * Each worker acquires jobs and processes them with proper lifecycle management.
@@ -1216,7 +1216,7 @@ declare class WorkerProvider {
    * Promotes delayed jobs and recovers stalled jobs.
    */
   protected runSchedulerCycle(): Promise<void>;
-  protected readonly stop: alepha1.HookDescriptor<"stop">;
+  protected readonly stop: alepha1.HookPrimitive<"stop">;
   /**
    * Acquire the next available job from any provider.
    */
@@ -1238,7 +1238,7 @@ declare class WorkerProvider {
   protected stopWorkers(): Promise<void>;
 }
 interface Consumer<T extends TSchema = TSchema> {
-  queue: QueueDescriptor<T>;
+  queue: QueuePrimitive<T>;
   handler: (message: QueueMessage<T>) => Promise<void>;
 }
 interface AcquiredJobWithConsumer {
@@ -1249,9 +1249,9 @@ interface AcquiredJobWithConsumer {
 //#endregion
 //#region src/queue/index.d.ts
 /**
- * Provides asynchronous message queuing and processing capabilities through declarative queue descriptors.
+ * Provides asynchronous message queuing and processing capabilities through declarative queue primitives.
  *
- * The queue module enables reliable background job processing and message passing using the `$queue` descriptor
+ * The queue module enables reliable background job processing and message passing using the `$queue` primitive
  * on class properties. It supports schema validation, automatic retries, and multiple queue backends for
  * building scalable, decoupled applications with robust error handling.
  *
@@ -1261,5 +1261,5 @@ interface AcquiredJobWithConsumer {
  */
 declare const AlephaQueue: alepha1.Service<alepha1.Module>;
 //#endregion
-export { $consumer, $queue, AcquiredJobWithConsumer, AlephaQueue, Consumer, ConsumerDescriptor, ConsumerDescriptorOptions, MemoryQueueProvider, type QueueAcquiredJob, type QueueAddJobOptions, type QueueCleanOptions, QueueDescriptor, QueueDescriptorOptions, type QueueEvent, type QueueEventActive, type QueueEventBase, type QueueEventCompleted, type QueueEventFailed, type QueueEventHandler, type QueueEventMap, type QueueEventProgress, type QueueEventRemoved, type QueueEventRetrying, type QueueEventStalled, type QueueEventType, type QueueEventWaiting, type QueueGetJobsOptions, type QueueJob, type QueueJobBackoff, type QueueJobCounts, type QueueJobOptions, type QueueJobState, type QueueJobStatus, QueueMessage, QueueMessageSchema, QueueProvider, WorkerProvider };
+export { $consumer, $queue, AcquiredJobWithConsumer, AlephaQueue, Consumer, ConsumerPrimitive, ConsumerPrimitiveOptions, MemoryQueueProvider, type QueueAcquiredJob, type QueueAddJobOptions, type QueueCleanOptions, type QueueEvent, type QueueEventActive, type QueueEventBase, type QueueEventCompleted, type QueueEventFailed, type QueueEventHandler, type QueueEventMap, type QueueEventProgress, type QueueEventRemoved, type QueueEventRetrying, type QueueEventStalled, type QueueEventType, type QueueEventWaiting, type QueueGetJobsOptions, type QueueJob, type QueueJobBackoff, type QueueJobCounts, type QueueJobOptions, type QueueJobState, type QueueJobStatus, QueueMessage, QueueMessageSchema, QueuePrimitive, QueuePrimitiveOptions, QueueProvider, WorkerProvider };
 //# sourceMappingURL=index.d.ts.map

package/dist/queue/index.js

@@ -1,17 +1,17 @@
-import { $env, $hook, $inject, $module, Alepha, Descriptor, KIND, createDescriptor, t } from "alepha";
+import { $env, $hook, $inject, $module, Alepha, KIND, Primitive, createPrimitive, t } from "alepha";
 import { $logger } from "alepha/logger";
 import { DateTimeProvider } from "alepha/datetime";
 
-//#region src/queue/descriptors/$consumer.ts
+//#region src/queue/primitives/$consumer.ts
 /**
-* Creates a consumer descriptor to process messages from a specific queue.
+* Creates a consumer primitive to process messages from a specific queue.
 *
 * Provides a dedicated message consumer that connects to a queue and processes messages
 * with custom handler logic, enabling scalable architectures where multiple consumers
 * can process messages from the same queue.
 *
 * **Key Features**
-* - Seamless integration with any $queue descriptor
+* - Seamless integration with any $queue primitive
 * - Full type safety inherited from queue schema
 * - Automatic worker management for background processing
 * - Built-in error handling and retry mechanisms
@@ -53,10 +53,10 @@ import { DateTimeProvider } from "alepha/datetime";
 * ```
 */
 const $consumer = (options) => {
-	return createDescriptor(ConsumerDescriptor, options);
+	return createPrimitive(ConsumerPrimitive, options);
 };
-var ConsumerDescriptor = class extends Descriptor {};
-$consumer[KIND] = ConsumerDescriptor;
+var ConsumerPrimitive = class extends Primitive {};
+$consumer[KIND] = ConsumerPrimitive;
 
 //#endregion
 //#region src/queue/providers/QueueProvider.ts
@@ -656,11 +656,11 @@ var MemoryQueueProvider = class extends QueueProvider {
 };
 
 //#endregion
-//#region src/queue/descriptors/$queue.ts
+//#region src/queue/primitives/$queue.ts
 /**
-* Creates a queue descriptor for asynchronous message processing with background workers.
+* Creates a queue primitive for asynchronous message processing with background workers.
 *
-* The $queue descriptor enables powerful asynchronous communication patterns in your application.
+* The $queue primitive enables powerful asynchronous communication patterns in your application.
 * It provides type-safe message queuing with automatic worker processing, making it perfect for
 * decoupling components and handling background tasks efficiently.
 *
@@ -769,9 +769,9 @@ var MemoryQueueProvider = class extends QueueProvider {
 * ```
 */
 const $queue = (options) => {
-	return createDescriptor(QueueDescriptor, options);
+	return createPrimitive(QueuePrimitive, options);
 };
-var QueueDescriptor = class extends Descriptor {
+var QueuePrimitive = class extends Primitive {
 	log = $logger();
 	provider = this.$provider();
 	async push(payloadOrFirst, optionsOrSecond, ...rest) {
@@ -800,7 +800,7 @@ var QueueDescriptor = class extends Descriptor {
 		}
 	}
 	/**
-	* Get default job options from descriptor configuration.
+	* Get default job options from primitive configuration.
 	*/
 	getDefaultJobOptions() {
 		return {
@@ -820,7 +820,7 @@ var QueueDescriptor = class extends Descriptor {
 		return this.alepha.inject(this.options.provider);
 	}
 };
-$queue[KIND] = QueueDescriptor;
+$queue[KIND] = QueuePrimitive;
 
 //#endregion
 //#region src/queue/providers/WorkerProvider.ts
@@ -853,14 +853,14 @@ var WorkerProvider = class {
 		on: "start",
 		priority: "last",
 		handler: () => {
-			for (const queue of this.alepha.descriptors($queue)) {
+			for (const queue of this.alepha.primitives($queue)) {
 				const handler = queue.options.handler;
 				if (handler) this.consumers.push({
 					handler,
 					queue
 				});
 			}
-			for (const consumer of this.alepha.descriptors($consumer)) this.consumers.push(consumer.options);
+			for (const consumer of this.alepha.primitives($consumer)) this.consumers.push(consumer.options);
 			for (const consumer of this.consumers) {
 				const provider = consumer.queue.provider;
 				const list = this.consumersByProvider.get(provider) ?? [];
@@ -1007,9 +1007,9 @@ var WorkerProvider = class {
 //#endregion
 //#region src/queue/index.ts
 /**
-* Provides asynchronous message queuing and processing capabilities through declarative queue descriptors.
+* Provides asynchronous message queuing and processing capabilities through declarative queue primitives.
 *
-* The queue module enables reliable background job processing and message passing using the `$queue` descriptor
+* The queue module enables reliable background job processing and message passing using the `$queue` primitive
 * on class properties. It supports schema validation, automatic retries, and multiple queue backends for
 * building scalable, decoupled applications with robust error handling.
 *
@@ -1019,7 +1019,7 @@ var WorkerProvider = class {
 */
 const AlephaQueue = $module({
 	name: "alepha.queue",
-	descriptors: [$queue, $consumer],
+	primitives: [$queue, $consumer],
 	services: [
 		QueueProvider,
 		MemoryQueueProvider,
@@ -1033,5 +1033,5 @@ const AlephaQueue = $module({
 });
 
 //#endregion
-export { $consumer, $queue, AlephaQueue, ConsumerDescriptor, MemoryQueueProvider, QueueDescriptor, QueueProvider, WorkerProvider };
+export { $consumer, $queue, AlephaQueue, ConsumerPrimitive, MemoryQueueProvider, QueuePrimitive, QueueProvider, WorkerProvider };
 //# sourceMappingURL=index.js.map