@celerity-sdk/core 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -431,7 +431,7 @@ declare function RequestContext(): ParameterDecorator;
 declare function EventType(): ParameterDecorator;
 
 type ConsumerMetadata = {
-    sourceId?: string;
+    source?: string;
 };
 type ConsumerHandlerMetadata = {
     route?: string;
@@ -443,13 +443,13 @@ type ConsumerHandlerMetadata = {
  * The class becomes injectable and its `@MessageHandler()` methods are
  * registered as consumer handler callbacks.
  *
- * @param sourceId - Optional annotation hint that tells the deploy engine
- *   which blueprint-defined consumer source this handler should be wired to.
+ * @param source - Optional blueprint resource name that tells the deploy engine
+ *   which blueprint-defined consumer resource this handler should be wired to.
  *   Does not create infrastructure — the blueprint defines the actual source.
  *
  * @example
  * ```ts
- * @Consumer("orders-queue")
+ * @Consumer("ordersConsumer")
  * class OrderConsumer {
  *   @MessageHandler()
  *   async process(@Messages(OrderSchema) messages: ValidatedConsumerMessage<Order>[]): Promise<EventResult> {
@@ -458,7 +458,7 @@ type ConsumerHandlerMetadata = {
  * }
  * ```
  */
-declare function Consumer(sourceId?: string): ClassDecorator;
+declare function Consumer(source?: string): ClassDecorator;
 /**
  * Marks a method inside a `@Consumer()` class as a message handler.
  *
@@ -517,11 +517,11 @@ declare function Vendor(): ParameterDecorator;
 declare function ConsumerTraceContext(): ParameterDecorator;
 
 type ScheduleHandlerMetadata = {
-    scheduleId?: string;
+    source?: string;
     schedule?: string;
 };
 type ScheduleHandlerOptions = {
-    scheduleId?: string;
+    source?: string;
     schedule?: string;
 };
 /**
@@ -538,16 +538,16 @@ type ScheduleHandlerOptions = {
  * @param arg - Optional string or options object. String parsing:
  *   - No args → fully blueprint-driven (no annotations)
  *   - String with `rate(` or `cron(` prefix → `schedule` expression annotation
- *   - String without prefix → `scheduleId` annotation hint for deploy engine
- *   - Object → explicit `{ scheduleId?, schedule? }`
+ *   - String without prefix → `source` blueprint resource name hint for deploy engine
+ *   - Object → explicit `{ source?, schedule? }`
  *
  * @example
  * ```ts
  * @Controller()
  * class MaintenanceTasks {
- *   @ScheduleHandler("daily-cleanup")
+ *   @ScheduleHandler("dailyCleanup")
  *   async cleanup(@ScheduleInput() input: unknown): Promise<EventResult> {
- *     // scheduleId hint — blueprint defines the actual schedule
+ *     // source hint — matches blueprint resource name, blueprint defines the actual schedule
  *   }
  *
  *   @ScheduleHandler("rate(1 day)")
@@ -555,7 +555,7 @@ type ScheduleHandlerOptions = {
  *     // schedule expression annotation — blueprint can override
  *   }
  *
- *   @ScheduleHandler({ scheduleId: "weekly-report", schedule: "cron(0 9 ? * MON *)" })
+ *   @ScheduleHandler({ source: "weeklyReport", schedule: "cron(0 9 ? * MON *)" })
  *   async report(): Promise<EventResult> {
  *     // explicit object with both fields
  *   }
@@ -563,7 +563,7 @@ type ScheduleHandlerOptions = {
  * ```
  */
 declare function ScheduleHandler(): MethodDecorator;
-declare function ScheduleHandler(scheduleIdOrExpression: string): MethodDecorator;
+declare function ScheduleHandler(sourceOrExpression: string): MethodDecorator;
 declare function ScheduleHandler(options: ScheduleHandlerOptions): MethodDecorator;
 
 /**
@@ -752,6 +752,8 @@ type ResolvedHandlerBase = {
     id?: string;
     handlerFn: (...args: unknown[]) => unknown;
     handlerInstance?: object;
+    /** The class to lazily resolve via container on first invocation. */
+    controllerClass?: Type;
     isFunctionHandler?: boolean;
     injectTokens?: InjectionToken[];
     layers: (CelerityLayer<BaseHandlerContext> | Type<CelerityLayer<BaseHandlerContext>>)[];
@@ -788,6 +790,8 @@ type ResolvedGuard = {
     name: string;
     handlerFn: (...args: unknown[]) => unknown;
     handlerInstance?: object;
+    /** The guard class to lazily resolve via container on first invocation. */
+    guardClass?: Type;
     paramMetadata: ParamMetadata[];
     customMetadata: Record<string, unknown>;
     injectTokens?: InjectionToken[];
@@ -1053,7 +1057,7 @@ type ConsumerHandlerFn = (event: ConsumerEventInput, ctx: ConsumerHandlerContext
 declare function createConsumerHandler(config: ConsumerHandlerConfig, handler: ConsumerHandlerFn): FunctionHandlerDefinition;
 
 type ScheduleHandlerConfig<T = unknown> = {
-    scheduleId?: string;
+    source?: string;
     schedule?: string;
     schema?: Schema<T>;
     inject?: InjectionToken[];
@@ -1079,8 +1083,8 @@ type ScheduleHandlerFn = (event: ScheduleEventInput$1, ctx: ScheduleHandlerConte
  *   },
  * );
  *
- * // With scheduleId hint for deploy engine auto-wiring
- * const weeklyReport = createScheduleHandler("weekly-report", {
+ * // With source hint for deploy engine auto-wiring
+ * const weeklyReport = createScheduleHandler("weeklyReport", {
  *   inject: [ReportService],
  * }, async (event, ctx, reportService: ReportService) => {
  *   await reportService.generate();
@@ -1097,7 +1101,7 @@ type ScheduleHandlerFn = (event: ScheduleEventInput$1, ctx: ScheduleHandlerConte
  * ```
  */
 declare function createScheduleHandler(config: ScheduleHandlerConfig, handler: ScheduleHandlerFn): FunctionHandlerDefinition;
-declare function createScheduleHandler(scheduleIdOrExpression: string, config: ScheduleHandlerConfig, handler: ScheduleHandlerFn): FunctionHandlerDefinition;
+declare function createScheduleHandler(sourceOrExpression: string, config: ScheduleHandlerConfig, handler: ScheduleHandlerFn): FunctionHandlerDefinition;
 
 type CustomHandlerConfig<TInput = unknown> = {
     name?: string;

package/dist/index.d.ts

@@ -431,7 +431,7 @@ declare function RequestContext(): ParameterDecorator;
 declare function EventType(): ParameterDecorator;
 
 type ConsumerMetadata = {
-    sourceId?: string;
+    source?: string;
 };
 type ConsumerHandlerMetadata = {
     route?: string;
@@ -443,13 +443,13 @@ type ConsumerHandlerMetadata = {
  * The class becomes injectable and its `@MessageHandler()` methods are
  * registered as consumer handler callbacks.
  *
- * @param sourceId - Optional annotation hint that tells the deploy engine
- *   which blueprint-defined consumer source this handler should be wired to.
+ * @param source - Optional blueprint resource name that tells the deploy engine
+ *   which blueprint-defined consumer resource this handler should be wired to.
  *   Does not create infrastructure — the blueprint defines the actual source.
  *
  * @example
  * ```ts
- * @Consumer("orders-queue")
+ * @Consumer("ordersConsumer")
  * class OrderConsumer {
  *   @MessageHandler()
  *   async process(@Messages(OrderSchema) messages: ValidatedConsumerMessage<Order>[]): Promise<EventResult> {
@@ -458,7 +458,7 @@ type ConsumerHandlerMetadata = {
  * }
  * ```
  */
-declare function Consumer(sourceId?: string): ClassDecorator;
+declare function Consumer(source?: string): ClassDecorator;
 /**
  * Marks a method inside a `@Consumer()` class as a message handler.
  *
@@ -517,11 +517,11 @@ declare function Vendor(): ParameterDecorator;
 declare function ConsumerTraceContext(): ParameterDecorator;
 
 type ScheduleHandlerMetadata = {
-    scheduleId?: string;
+    source?: string;
     schedule?: string;
 };
 type ScheduleHandlerOptions = {
-    scheduleId?: string;
+    source?: string;
     schedule?: string;
 };
 /**
@@ -538,16 +538,16 @@ type ScheduleHandlerOptions = {
  * @param arg - Optional string or options object. String parsing:
  *   - No args → fully blueprint-driven (no annotations)
  *   - String with `rate(` or `cron(` prefix → `schedule` expression annotation
- *   - String without prefix → `scheduleId` annotation hint for deploy engine
- *   - Object → explicit `{ scheduleId?, schedule? }`
+ *   - String without prefix → `source` blueprint resource name hint for deploy engine
+ *   - Object → explicit `{ source?, schedule? }`
  *
  * @example
  * ```ts
  * @Controller()
  * class MaintenanceTasks {
- *   @ScheduleHandler("daily-cleanup")
+ *   @ScheduleHandler("dailyCleanup")
  *   async cleanup(@ScheduleInput() input: unknown): Promise<EventResult> {
- *     // scheduleId hint — blueprint defines the actual schedule
+ *     // source hint — matches blueprint resource name, blueprint defines the actual schedule
  *   }
  *
  *   @ScheduleHandler("rate(1 day)")
@@ -555,7 +555,7 @@ type ScheduleHandlerOptions = {
  *     // schedule expression annotation — blueprint can override
  *   }
  *
- *   @ScheduleHandler({ scheduleId: "weekly-report", schedule: "cron(0 9 ? * MON *)" })
+ *   @ScheduleHandler({ source: "weeklyReport", schedule: "cron(0 9 ? * MON *)" })
  *   async report(): Promise<EventResult> {
  *     // explicit object with both fields
  *   }
@@ -563,7 +563,7 @@ type ScheduleHandlerOptions = {
  * ```
  */
 declare function ScheduleHandler(): MethodDecorator;
-declare function ScheduleHandler(scheduleIdOrExpression: string): MethodDecorator;
+declare function ScheduleHandler(sourceOrExpression: string): MethodDecorator;
 declare function ScheduleHandler(options: ScheduleHandlerOptions): MethodDecorator;
 
 /**
@@ -752,6 +752,8 @@ type ResolvedHandlerBase = {
     id?: string;
     handlerFn: (...args: unknown[]) => unknown;
     handlerInstance?: object;
+    /** The class to lazily resolve via container on first invocation. */
+    controllerClass?: Type;
     isFunctionHandler?: boolean;
     injectTokens?: InjectionToken[];
     layers: (CelerityLayer<BaseHandlerContext> | Type<CelerityLayer<BaseHandlerContext>>)[];
@@ -788,6 +790,8 @@ type ResolvedGuard = {
     name: string;
     handlerFn: (...args: unknown[]) => unknown;
     handlerInstance?: object;
+    /** The guard class to lazily resolve via container on first invocation. */
+    guardClass?: Type;
     paramMetadata: ParamMetadata[];
     customMetadata: Record<string, unknown>;
     injectTokens?: InjectionToken[];
@@ -1053,7 +1057,7 @@ type ConsumerHandlerFn = (event: ConsumerEventInput, ctx: ConsumerHandlerContext
 declare function createConsumerHandler(config: ConsumerHandlerConfig, handler: ConsumerHandlerFn): FunctionHandlerDefinition;
 
 type ScheduleHandlerConfig<T = unknown> = {
-    scheduleId?: string;
+    source?: string;
     schedule?: string;
     schema?: Schema<T>;
     inject?: InjectionToken[];
@@ -1079,8 +1083,8 @@ type ScheduleHandlerFn = (event: ScheduleEventInput$1, ctx: ScheduleHandlerConte
  *   },
  * );
  *
- * // With scheduleId hint for deploy engine auto-wiring
- * const weeklyReport = createScheduleHandler("weekly-report", {
+ * // With source hint for deploy engine auto-wiring
+ * const weeklyReport = createScheduleHandler("weeklyReport", {
  *   inject: [ReportService],
  * }, async (event, ctx, reportService: ReportService) => {
  *   await reportService.generate();
@@ -1097,7 +1101,7 @@ type ScheduleHandlerFn = (event: ScheduleEventInput$1, ctx: ScheduleHandlerConte
  * ```
  */
 declare function createScheduleHandler(config: ScheduleHandlerConfig, handler: ScheduleHandlerFn): FunctionHandlerDefinition;
-declare function createScheduleHandler(scheduleIdOrExpression: string, config: ScheduleHandlerConfig, handler: ScheduleHandlerFn): FunctionHandlerDefinition;
+declare function createScheduleHandler(sourceOrExpression: string, config: ScheduleHandlerConfig, handler: ScheduleHandlerFn): FunctionHandlerDefinition;
 
 type CustomHandlerConfig<TInput = unknown> = {
     name?: string;