@globalart/nestjs-temporal 1.1.6 → 1.2.2

package/dist/index.cjs

@@ -159,9 +159,9 @@ let TemporalExplorer = _TemporalExplorer = class TemporalExplorer {
 		if (!this.worker) return;
 		try {
 			this.worker.shutdown();
-			if (this.workerRunPromise) await this.workerRunPromise;
+			if (this.workerRunPromise) await this.worker.run();
 		} catch (err) {
-			this.logger.warn("Temporal worker was not cleanly shutdown.", { err: err instanceof Error ? err.message : String(err) });
+			this.logger.warn("Temporal workers were not cleanly shutdown.", { err: err instanceof Error ? err.message : String(err) });
 		}
 	}
 	/**

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["ConfigurableModuleBuilder","Logger","NativeConnection","Worker","Context","WorkflowClient","DiscoveryModule","DiscoveryModule","SCOPE_OPTIONS_METADATA","SCOPE_OPTIONS_METADATA"],"sources":["../src/constants/temporal.constants.ts","../src/temporal-metadata.accessors.ts","../src/temporal.module-definition.ts","../src/temporal-enums.ts","../src/core/temporal-execution-context.ts","../src/temporal-params.factory.ts","../src/temporal.explorer.ts","../src/utils/get-queue-token.util.ts","../src/utils/client.util.ts","../src/utils/provider.util.ts","../src/temporal.module.ts","../src/decorators/activities.decorator.ts","../src/decorators/activity.decorator.ts","../src/decorators/inject-temporal-client.decorator.ts","../src/decorators/workflow.decorator.ts","../src/decorators/workflows.decorator.ts","../src/decorators/payload.decorator.ts"],"sourcesContent":["export const TEMPORAL_MODULE_ACTIVITIES = '_temporal_module_activities';\nexport const TEMPORAL_MODULE_ACTIVITY = '_temporal_module_activity';\nexport const TEMPORAL_MODULE_WORKFLOW = '_temporal_module_workFlow';\nexport const TEMPORAL_MODULE_WORKFLOW_METHOD =\n  '_temporal_module_workflow_method';\nexport const TEMPORAL_ARGS_METADATA = '_temporal_module_args';\nexport const TEMPORAL_CONTEXT_METADATA = '_temporal_module_context';","import { Injectable, Type } from '@nestjs/common';\nimport { Reflector } from '@nestjs/core';\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\n  TEMPORAL_MODULE_WORKFLOW,\n  TEMPORAL_MODULE_WORKFLOW_METHOD,\n} from './constants/temporal.constants';\n\n/**\n * TemporalMetadataAccessor provides methods to check and retrieve Temporal decorator metadata.\n * It uses NestJS Reflector to access metadata set by @Activities(), @Activity(), @Workflows(), and @WorkflowMethod() decorators.\n */\n@Injectable()\nexport class TemporalMetadataAccessor {\n  constructor(private readonly reflector: Reflector) {}\n\n  isActivities(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_ACTIVITIES, target);\n  }\n\n  getActivities(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_ACTIVITIES, target);\n  }\n\n  isActivity(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_ACTIVITY, target);\n  }\n\n  getActivity(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_ACTIVITY, target);\n  }\n\n  isWorkflows(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_WORKFLOW, target);\n  }\n\n  getWorkflows(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_WORKFLOW, target);\n  }\n\n  isWorkflowMethod(\n    target: Type<unknown> | Function | null | undefined,\n  ): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_WORKFLOW_METHOD, target);\n  }\n\n  getWorkflowMethod(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_WORKFLOW_METHOD, target);\n  }\n}\n","import {\n  NativeConnectionOptions,\n  RuntimeOptions,\n  WorkerOptions,\n} from '@temporalio/worker';\nimport { ConfigurableModuleBuilder } from '@nestjs/common';\n\nexport interface TemporalModuleOptions {\n  workerOptions: WorkerOptions;\n  connectionOptions?: NativeConnectionOptions;\n  runtimeOptions?: RuntimeOptions;\n  activityClasses?: object[];\n  errorOnDuplicateActivities?: boolean;\n}\n\nexport const {\n  ConfigurableModuleClass,\n  MODULE_OPTIONS_TOKEN: TEMPORAL_MODULE_OPTIONS_TOKEN,\n  OPTIONS_TYPE: TEMPORAL_MODULE_OPTIONS_TYPE,\n  ASYNC_OPTIONS_TYPE: TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE,\n} = new ConfigurableModuleBuilder<TemporalModuleOptions>()\n  .setClassMethodName('registerWorker')\n  .build();\n","export enum TemporalParamType {\n  PAYLOAD = 3,\n  CONTEXT = 4,\n}\n\n","import { ExecutionContext } from '@nestjs/common';\nimport { Info } from '@temporalio/activity';\n\nexport class TemporalExecutionContext implements ExecutionContext {\n  constructor(\n    private readonly instance: object,\n    private readonly handler: Function,\n    private readonly args: unknown[]\n  ) {}\n\n  getClass<T = unknown>(): Type<T> {\n    return this.instance.constructor as Type<T>;\n  }\n\n  getHandler(): Function {\n    return this.handler;\n  }\n\n  getArgs<T extends Array<unknown> = unknown[]>(): T {\n    return this.args as T;\n  }\n\n  getWorkflowInfo(): Info {\n    return this.args[0] as Info;\n  }\n\n  getArgByIndex<T = unknown>(index: number): T {\n    return this.args[index] as T;\n  }\n\n  switchToRpc(): ReturnType<ExecutionContext['switchToRpc']> {\n    throw new Error('Context does not support RPC context');\n  }\n\n  switchToHttp(): ReturnType<ExecutionContext['switchToHttp']> {\n    throw new Error('Context does not support HTTP context');\n  }\n\n  switchToWs(): ReturnType<ExecutionContext['switchToWs']> {\n    throw new Error('Context does not support WebSocket context');\n  }\n\n  getType<TContext extends string = string>(): TContext {\n    return 'temporal' as TContext;\n  }\n}\n\ntype Type<T = unknown> = new (...args: unknown[]) => T;\n\n","import { ParamData } from '@nestjs/common';\nimport { ParamsFactory } from '@nestjs/core/helpers/external-context-creator';\nimport { TemporalParamType } from './temporal-enums';\nimport { TemporalExecutionContext } from './core/temporal-execution-context';\n\nexport class TemporalParamsFactory implements ParamsFactory {\n  constructor(\n    private readonly instance: object,\n    private readonly handler: Function,\n  ) {}\n\n  exchangeKeyForValue(\n    type: number,\n    data: ParamData,\n    args: unknown[],\n  ): unknown {\n    switch (type) {\n      case TemporalParamType.PAYLOAD:\n        return data && args[0] && typeof args[0] === 'object'\n          ? (args[0] as Record<string, unknown>)[data as string]\n          : args[0];\n\n      case TemporalParamType.CONTEXT:\n        return new TemporalExecutionContext(this.instance, this.handler, args);\n\n      default:\n        return null;\n    }\n  }\n}\n\n","import {\n  Inject,\n  Injectable,\n  Logger,\n  OnApplicationBootstrap,\n  OnModuleDestroy,\n  OnModuleInit,\n} from \"@nestjs/common\";\nimport { DiscoveryService, MetadataScanner, ExternalContextCreator } from \"@nestjs/core\";\nimport { InstanceWrapper } from \"@nestjs/core/injector/instance-wrapper\";\nimport { lastValueFrom, isObservable } from \"rxjs\";\nimport {\n  NativeConnection,\n  NativeConnectionOptions,\n  Runtime,\n  RuntimeOptions,\n  Worker,\n  WorkerOptions,\n} from \"@temporalio/worker\";\nimport { TemporalMetadataAccessor } from \"./temporal-metadata.accessors\";\nimport {\n  TEMPORAL_MODULE_OPTIONS_TOKEN,\n  type TemporalModuleOptions,\n} from \"./temporal.module-definition\";\nimport { TEMPORAL_ARGS_METADATA, TEMPORAL_CONTEXT_METADATA } from \"./constants/temporal.constants\";\nimport { TemporalParamsFactory } from \"./temporal-params.factory\";\nimport { Context } from \"@temporalio/activity\";\n\n/**\n * TemporalExplorer is responsible for discovering and registering Temporal activities\n * and creating the Temporal worker instance.\n *\n * It scans the NestJS application for classes decorated with @Activities() and methods\n * decorated with @Activity(), then registers them with the Temporal worker.\n */\n@Injectable()\nexport class TemporalExplorer\n  implements OnModuleInit, OnModuleDestroy, OnApplicationBootstrap\n{\n  @Inject(TEMPORAL_MODULE_OPTIONS_TOKEN)\n  private readonly options!: TemporalModuleOptions;\n  private readonly logger = new Logger(TemporalExplorer.name);\n  private worker?: Worker;\n  private workerRunPromise?: Promise<void>;\n\n  constructor(\n    private readonly discoveryService: DiscoveryService,\n    private readonly metadataAccessor: TemporalMetadataAccessor,\n    private readonly metadataScanner: MetadataScanner,\n    private readonly externalContextCreator: ExternalContextCreator\n  ) {}\n\n  /**\n   * Initializes the module by exploring and setting up the Temporal worker.\n   */\n  async onModuleInit(): Promise<void> {\n    await this.explore();\n  }\n\n  /**\n   * Shuts down the Temporal worker when the module is destroyed.\n   */\n  async onModuleDestroy(): Promise<void> {\n    if (!this.worker) {\n      return;\n    }\n\n    try {\n      this.worker.shutdown();\n      if (this.workerRunPromise) {\n        await this.workerRunPromise;\n      }\n    } catch (err: unknown) {\n      this.logger.warn(\"Temporal worker was not cleanly shutdown.\", {\n        err: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n\n  /**\n   * Starts the Temporal worker when the application is fully bootstrapped.\n   */\n  onApplicationBootstrap(): void {\n    if (this.worker) {\n      this.workerRunPromise = this.worker.run();\n    }\n  }\n\n  /**\n   * Explores the application for Temporal activities and creates the worker.\n   * This method is called during module initialization.\n   */\n  async explore(): Promise<void> {\n    const workerConfig = this.getWorkerConfigOptions();\n    const runTimeOptions = this.getRuntimeOptions();\n    const connectionOptions = this.getNativeConnectionOptions();\n\n    // Worker must have a taskQueue configured\n    if (!workerConfig.taskQueue) {\n      this.logger.warn(\n        \"Temporal worker configuration missing taskQueue. Worker will not be created.\"\n      );\n      return;\n    }\n\n    this.findDuplicateActivityMethods();\n\n    const activitiesFunc = await this.handleActivities();\n\n    if (runTimeOptions) {\n      this.logger.verbose(\"Instantiating a new Runtime object\");\n      Runtime.install(runTimeOptions);\n    }\n\n    const workerOptions: Partial<WorkerOptions> = {\n      activities: activitiesFunc,\n    };\n\n    if (connectionOptions) {\n      this.logger.verbose(\"Connecting to the Temporal server\");\n      workerOptions.connection = await NativeConnection.connect(\n        connectionOptions\n      );\n    }\n\n    this.logger.verbose(\"Creating a new Worker\");\n    this.worker = await Worker.create({\n      ...workerConfig,\n      ...workerOptions,\n    });\n  }\n\n  /**\n   * Gets the worker configuration options.\n   */\n  getWorkerConfigOptions(): WorkerOptions {\n    return this.options.workerOptions;\n  }\n\n  /**\n   * Gets the native connection options for the Temporal server.\n   */\n  getNativeConnectionOptions(): NativeConnectionOptions | undefined {\n    return this.options.connectionOptions;\n  }\n\n  /**\n   * Gets the runtime options for the Temporal worker.\n   */\n  getRuntimeOptions(): RuntimeOptions | undefined {\n    return this.options.runtimeOptions;\n  }\n\n  /**\n   * Gets the activity classes to register with this worker.\n   * If undefined, all discovered activities will be registered.\n   * Can be either class constructors or InstanceWrappers.\n   */\n  private getActivityClasses(): (InstanceWrapper | Function)[] | undefined {\n    return this.options.activityClasses as\n      | (InstanceWrapper | Function)[]\n      | undefined;\n  }\n\n  /**\n   * Validates that activity method names are unique across all activity classes.\n   * Throws an error if duplicates are found and errorOnDuplicateActivities is enabled.\n   */\n  findDuplicateActivityMethods(): void {\n    if (!this.options.errorOnDuplicateActivities) {\n      return;\n    }\n\n    const activityClasses = this.getActivityClasses();\n    if (!activityClasses || activityClasses.length === 0) {\n      return;\n    }\n\n    const activityMethods: Record<string, string[]> = {};\n\n    activityClasses.forEach((classOrWrapper: InstanceWrapper | Function) => {\n      // Handle both InstanceWrapper and class constructor\n      const wrapper = classOrWrapper as InstanceWrapper;\n      const instance =\n        \"instance\" in wrapper && wrapper.instance\n          ? wrapper.instance\n          : new (classOrWrapper as new () => unknown)();\n\n      this.metadataScanner\n        .getAllMethodNames(Object.getPrototypeOf(instance))\n        .forEach((key) => {\n          if (this.metadataAccessor.isActivity(instance[key])) {\n            activityMethods[key] = (activityMethods[key] || []).concat(\n              instance.constructor.name\n            );\n          }\n        });\n    });\n\n    const violations = Object.entries(activityMethods).filter(\n      ([, classes]) => classes.length > 1\n    );\n\n    if (violations.length > 0) {\n      const message = `Activity names must be unique across all Activity classes. Identified activities with conflicting names: ${JSON.stringify(\n        Object.fromEntries(violations)\n      )}`;\n      this.logger.error(message);\n      throw new Error(message);\n    }\n  }\n\n  /**\n   * Discovers and binds all activity methods from classes decorated with @Activities().\n   * Returns an object mapping activity method names to their bound implementations.\n   */\n  async handleActivities(): Promise<Record<string, Function>> {\n    const activitiesMethod: Record<string, Function> = {};\n\n    const activityClasses = this.getActivityClasses();\n    const activities: InstanceWrapper[] = this.discoveryService\n      .getProviders()\n      .filter(\n        (wrapper: InstanceWrapper) =>\n          this.metadataAccessor.isActivities(\n            !wrapper.metatype || wrapper.inject\n              ? wrapper.instance?.constructor\n              : wrapper.metatype\n          ) &&\n          (!activityClasses ||\n            activityClasses.some(\n              (cls) =>\n                cls === wrapper.metatype ||\n                (cls instanceof Object &&\n                  \"metatype\" in cls &&\n                  (cls as InstanceWrapper).metatype === wrapper.metatype)\n            ))\n      );\n\n    activities.forEach((wrapper: InstanceWrapper) => {\n      const { instance } = wrapper;\n      const isRequestScoped = !wrapper.isDependencyTreeStatic();\n\n      this.metadataScanner.scanFromPrototype(\n        instance,\n        Object.getPrototypeOf(instance),\n        (key: string) => {\n          if (this.metadataAccessor.isActivity(instance[key])) {\n            if (isRequestScoped) {\n              this.logger.warn(\n                `Request-scoped activities are not yet fully supported. Activity \"${key}\" from class \"${instance.constructor.name}\" may not work correctly.`\n              );\n            }\n            const paramsFactory = new TemporalParamsFactory(\n              instance,\n              instance[key]\n            );\n\n            const handler = this.externalContextCreator.create(\n              instance,\n              instance[key],\n              key,\n              TEMPORAL_ARGS_METADATA,\n              paramsFactory,\n              undefined,\n              undefined,\n              undefined,\n              \"temporal\"\n            );\n            \n            activitiesMethod[key] = async (...args: unknown[]) => {\n              const result = handler(...args, Context.current().info);\n\n              return isObservable(result)\n                ? await lastValueFrom(result)\n                : await result;\n            };\n          }\n        }\n      );\n    });\n    return activitiesMethod;\n  }\n}\n","export function getQueueToken(name?: string): string {\n  return name ? `TemporalQueue_${name}` : 'TemporalQueue_default';\n}\n\nexport function getAsyncQueueToken(name?: string): string {\n  return name ? `TemporalAsyncQueue_${name}` : 'TemporalAsyncQueue_default';\n}\n","import { OnApplicationShutdown } from '@nestjs/common';\nimport { WorkflowClient, WorkflowClientOptions } from '@temporalio/client';\n\n/**\n * Assigns an application shutdown hook to a WorkflowClient to ensure\n * the connection is properly closed when the application shuts down.\n *\n * @param client - The WorkflowClient instance\n * @returns The client with shutdown hook assigned\n */\nexport function assignOnAppShutdownHook(\n  client: WorkflowClient,\n): WorkflowClient {\n  (client as unknown as OnApplicationShutdown).onApplicationShutdown =\n    async () => {\n      try {\n        await client.connection?.close();\n      } catch (reason: unknown) {\n        const errorMessage =\n          reason instanceof Error ? reason.message : String(reason);\n        console.error(\n          `Temporal client connection was not cleanly closed: ${errorMessage}`,\n        );\n      }\n    };\n  return client;\n}\n\n/**\n * Creates a new WorkflowClient instance with application shutdown hook.\n *\n * @param options - Optional WorkflowClient configuration options\n * @returns A WorkflowClient instance with shutdown hook\n */\nexport function getWorkflowClient(\n  options?: WorkflowClientOptions,\n): WorkflowClient {\n  const client = new WorkflowClient(options);\n  return assignOnAppShutdownHook(client);\n}\n","import { Provider } from '@nestjs/common';\nimport { WorkflowClientOptions } from '@temporalio/client';\n\nimport { SharedWorkflowClientOptions } from '../interfaces/shared-workflow-client-options.interface';\nimport {\n  SharedConnectionAsyncConfiguration,\n  SharedRuntimeAsyncConfiguration,\n  SharedWorkerAsyncConfiguration,\n} from '../interfaces';\nimport { getWorkflowClient } from './client.util';\nimport { getAsyncQueueToken, getQueueToken } from './get-queue-token.util';\nimport { DiscoveryModule } from '@nestjs/core';\n\nexport function createAsyncProvider(\n  provide: string,\n  options?:\n    | SharedWorkerAsyncConfiguration\n    | SharedRuntimeAsyncConfiguration\n    | SharedConnectionAsyncConfiguration\n    | SharedWorkflowClientOptions,\n): Provider {\n  if (options?.useFactory) {\n    const { useFactory, inject } = options;\n    return {\n      provide,\n      useFactory,\n      inject: inject || [],\n    };\n  }\n  return {\n    provide,\n    useValue: options?.useValue || null,\n  };\n}\n\nexport function createClientAsyncProvider(\n  asyncOptions: SharedWorkflowClientOptions,\n): Provider[] {\n  const name = asyncOptions.name ? asyncOptions.name : undefined;\n  const optionsProvide = getAsyncQueueToken(name);\n  const clientProvide = getQueueToken(name);\n  return [\n    createAsyncProvider(optionsProvide, asyncOptions),\n    {\n      provide: clientProvide,\n      useFactory: (options?: WorkflowClientOptions) =>\n        getWorkflowClient(options),\n      inject: [optionsProvide],\n    },\n    DiscoveryModule,\n  ];\n}\n","import { DynamicModule, Module } from \"@nestjs/common\";\nimport { DiscoveryModule } from \"@nestjs/core\";\n\nimport { TemporalMetadataAccessor } from \"./temporal-metadata.accessors\";\nimport { TemporalExplorer } from \"./temporal.explorer\";\nimport {\n  SharedWorkflowClientOptions,\n  TemporalModuleOptions,\n} from \"./interfaces\";\nimport { createClientProviders } from \"./temporal.providers\";\nimport { createClientAsyncProvider } from \"./utils\";\nimport {\n  ConfigurableModuleClass,\n  TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE,\n  TEMPORAL_MODULE_OPTIONS_TYPE,\n} from \"./temporal.module-definition\";\n\n/**\n * TemporalModule provides integration between NestJS and Temporal workflow orchestration.\n *\n * Use registerWorker() or registerWorkerAsync() to register Temporal workers that execute activities.\n * Use registerClient() or registerClientAsync() to register Temporal clients for starting workflows.\n */\n@Module({})\nexport class TemporalModule extends ConfigurableModuleClass {\n  /**\n   * Registers a Temporal worker asynchronously.\n   * Useful when configuration depends on other async providers (e.g., ConfigService).\n   *\n   * @param options - Async worker configuration options\n   * @returns Dynamic module configuration\n   */\n  static registerWorkerAsync(\n    options: typeof TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE\n  ): DynamicModule {\n    const superDynamicModule = super.registerWorkerAsync(options);\n    superDynamicModule.imports?.push(DiscoveryModule);\n    superDynamicModule.providers?.push(\n      TemporalExplorer,\n      TemporalMetadataAccessor\n    );\n    superDynamicModule.exports?.push(TemporalExplorer, TemporalMetadataAccessor, DiscoveryModule);\n\n    return {\n      ...superDynamicModule,\n      exports: [DiscoveryModule],\n    };\n  }\n\n  /**\n   * Registers a Temporal WorkflowClient asynchronously.\n   * Useful when configuration depends on other async providers (e.g., ConfigService).\n   *\n   * @param asyncSharedWorkflowClientOptions - Async client configuration options\n   * @returns Dynamic module configuration\n   */\n  static registerClientAsync(\n    asyncSharedWorkflowClientOptions: SharedWorkflowClientOptions\n  ): DynamicModule {\n    const providers = createClientAsyncProvider(\n      asyncSharedWorkflowClientOptions\n    );\n\n    return {\n      global: true,\n      module: TemporalModule,\n      providers,\n      exports: providers,\n    };\n  }\n}\n","import { Scope, SetMetadata } from '@nestjs/common';\nimport { SCOPE_OPTIONS_METADATA } from '@nestjs/common/constants';\nimport { ActivityOptions } from '@temporalio/workflow';\n\nimport { TEMPORAL_MODULE_ACTIVITIES } from '../constants/temporal.constants';\n\n/**\n * Options for the @Activities() decorator.\n */\nexport interface ActivitiesOptions extends ActivityOptions {\n  /**\n   * Specifies the name of the queue to subscribe to.\n   */\n  name?: string;\n  /**\n   * Specifies the lifetime of an injected Activities class.\n   */\n  scope?: Scope;\n}\n\n/**\n * Marks a class as containing Temporal activities.\n * Methods within this class decorated with @Activity() will be registered as Temporal activities.\n *\n * @param queueNameOrOptions - Optional queue name (string) or options object\n * @returns Class decorator\n *\n * @example\n * ```typescript\n * @Injectable()\n * @Activities()\n * export class MyActivities {\n *   @Activity()\n *   async doSomething() { }\n * }\n * ```\n */\nexport function Activities(): ClassDecorator;\nexport function Activities(queueName: string): ClassDecorator;\nexport function Activities(\n  activitiesOptions: ActivitiesOptions,\n): ClassDecorator;\nexport function Activities(\n  queueNameOrOptions?: string | ActivitiesOptions,\n): ClassDecorator {\n  const options =\n    queueNameOrOptions && typeof queueNameOrOptions === 'object'\n      ? queueNameOrOptions\n      : { name: queueNameOrOptions };\n  return (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_ACTIVITIES, options)(target);\n  };\n}\n","import { SetMetadata } from '@nestjs/common';\n\nimport { TEMPORAL_MODULE_ACTIVITY } from '../constants/temporal.constants';\n\n/**\n * Options for the @Activity() decorator.\n */\nexport interface ActivityOptions {\n  /**\n   * Custom name for the activity. If not provided, the method name is used.\n   */\n  name?: string;\n}\n\n/**\n * Marks a method as a Temporal activity.\n * The method must be within a class decorated with @Activities().\n *\n * @param nameOrOptions - Optional activity name (string) or options object\n * @returns Method decorator\n *\n * @example\n * ```typescript\n * @Activity()\n * async processOrder(orderId: string) { }\n *\n * @Activity('custom-activity-name')\n * async anotherActivity() { }\n * ```\n */\nexport function Activity(): MethodDecorator;\nexport function Activity(name: string): MethodDecorator;\nexport function Activity(options: ActivityOptions): MethodDecorator;\nexport function Activity(\n  nameOrOptions?: string | ActivityOptions,\n): MethodDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n\n  return SetMetadata(TEMPORAL_MODULE_ACTIVITY, options || {});\n}\n","import { Inject } from '@nestjs/common';\n\nimport { getQueueToken } from '../utils';\n\n/**\n * Injects a Temporal WorkflowClient instance.\n * Use this decorator to inject the client registered via TemporalModule.registerClient().\n *\n * @param name - Optional name of the client instance (for named clients)\n * @returns Parameter decorator for dependency injection\n *\n * @example\n * ```typescript\n * constructor(@InjectTemporalClient() private client: WorkflowClient) {}\n * ```\n */\nexport const InjectTemporalClient = (name?: string): ParameterDecorator =>\n  Inject(getQueueToken(name));\n","import { SetMetadata } from '@nestjs/common';\n\nimport { TEMPORAL_MODULE_WORKFLOW_METHOD } from '../constants/temporal.constants';\n\nexport interface WorkflowMethodOptions {\n  name?: string;\n}\n\nexport function WorkflowMethod(): MethodDecorator;\nexport function WorkflowMethod(name: string): MethodDecorator;\nexport function WorkflowMethod(options: WorkflowMethodOptions): MethodDecorator;\nexport function WorkflowMethod(\n  nameOrOptions?: string | WorkflowMethodOptions,\n): MethodDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n\n  return SetMetadata(TEMPORAL_MODULE_WORKFLOW_METHOD, options || {});\n}\n","import { Scope, SetMetadata } from '@nestjs/common';\nimport { SCOPE_OPTIONS_METADATA } from '@nestjs/common/constants';\n\nimport { TEMPORAL_MODULE_WORKFLOW } from '../constants/temporal.constants';\n\nexport interface WorkflowsOptions {\n  /**\n   * Specifies the name of the queue to subscribe to.\n   */\n  name?: string;\n  /**\n   * Specifies the lifetime of an injected Processor.\n   */\n  scope?: Scope;\n}\n\nexport function Workflows(): ClassDecorator;\nexport function Workflows(name: string): ClassDecorator;\nexport function Workflows(options: WorkflowsOptions): ClassDecorator;\nexport function Workflows(\n  nameOrOptions?: string | WorkflowsOptions,\n): ClassDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n  return (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_WORKFLOW, options)(target);\n  };\n}\n","import { createParamDecorator, ExecutionContext } from \"@nestjs/common\";\n\nexport const ActivityPayload = () => createParamDecorator((_, ctx: ExecutionContext) => {\n  return ctx.getArgByIndex(0);\n});"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["ConfigurableModuleBuilder","Logger","NativeConnection","Worker","Context","WorkflowClient","DiscoveryModule","DiscoveryModule","SCOPE_OPTIONS_METADATA","SCOPE_OPTIONS_METADATA"],"sources":["../src/constants/temporal.constants.ts","../src/temporal-metadata.accessors.ts","../src/temporal.module-definition.ts","../src/temporal-enums.ts","../src/core/temporal-execution-context.ts","../src/temporal-params.factory.ts","../src/temporal.explorer.ts","../src/utils/get-queue-token.util.ts","../src/utils/client.util.ts","../src/utils/provider.util.ts","../src/temporal.module.ts","../src/decorators/activities.decorator.ts","../src/decorators/activity.decorator.ts","../src/decorators/inject-temporal-client.decorator.ts","../src/decorators/workflow.decorator.ts","../src/decorators/workflows.decorator.ts","../src/decorators/payload.decorator.ts"],"sourcesContent":["export const TEMPORAL_MODULE_ACTIVITIES = '_temporal_module_activities';\nexport const TEMPORAL_MODULE_ACTIVITY = '_temporal_module_activity';\nexport const TEMPORAL_MODULE_WORKFLOW = '_temporal_module_workFlow';\nexport const TEMPORAL_MODULE_WORKFLOW_METHOD =\n  '_temporal_module_workflow_method';\nexport const TEMPORAL_ARGS_METADATA = '_temporal_module_args';\nexport const TEMPORAL_CONTEXT_METADATA = '_temporal_module_context';","import { Injectable, Type } from '@nestjs/common';\nimport { Reflector } from '@nestjs/core';\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\n  TEMPORAL_MODULE_WORKFLOW,\n  TEMPORAL_MODULE_WORKFLOW_METHOD,\n} from './constants/temporal.constants';\n\n/**\n * TemporalMetadataAccessor provides methods to check and retrieve Temporal decorator metadata.\n * It uses NestJS Reflector to access metadata set by @Activities(), @Activity(), @Workflows(), and @WorkflowMethod() decorators.\n */\n@Injectable()\nexport class TemporalMetadataAccessor {\n  constructor(private readonly reflector: Reflector) {}\n\n  isActivities(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_ACTIVITIES, target);\n  }\n\n  getActivities(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_ACTIVITIES, target);\n  }\n\n  isActivity(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_ACTIVITY, target);\n  }\n\n  getActivity(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_ACTIVITY, target);\n  }\n\n  isWorkflows(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_WORKFLOW, target);\n  }\n\n  getWorkflows(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_WORKFLOW, target);\n  }\n\n  isWorkflowMethod(\n    target: Type<unknown> | Function | null | undefined,\n  ): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_WORKFLOW_METHOD, target);\n  }\n\n  getWorkflowMethod(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_WORKFLOW_METHOD, target);\n  }\n}\n","import {\n  NativeConnectionOptions,\n  RuntimeOptions,\n  WorkerOptions,\n} from \"@temporalio/worker\";\nimport { ConfigurableModuleBuilder } from \"@nestjs/common\";\n\nexport interface TemporalModuleOptions {\n  workerOptions: WorkerOptions;\n  connectionOptions?: NativeConnectionOptions;\n  runtimeOptions?: RuntimeOptions;\n  activityClasses?: object[];\n  errorOnDuplicateActivities?: boolean;\n}\n\nexport const {\n  ConfigurableModuleClass,\n  MODULE_OPTIONS_TOKEN: TEMPORAL_MODULE_OPTIONS_TOKEN,\n  OPTIONS_TYPE: TEMPORAL_MODULE_OPTIONS_TYPE,\n  ASYNC_OPTIONS_TYPE: TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE,\n} = new ConfigurableModuleBuilder<TemporalModuleOptions>()\n  .setClassMethodName(\"registerWorker\")\n  .build();\n","export enum TemporalParamType {\n  PAYLOAD = 3,\n  CONTEXT = 4,\n}\n\n","import { ExecutionContext } from '@nestjs/common';\nimport { Info } from '@temporalio/activity';\n\nexport class TemporalExecutionContext implements ExecutionContext {\n  constructor(\n    private readonly instance: object,\n    private readonly handler: Function,\n    private readonly args: unknown[]\n  ) {}\n\n  getClass<T = unknown>(): Type<T> {\n    return this.instance.constructor as Type<T>;\n  }\n\n  getHandler(): Function {\n    return this.handler;\n  }\n\n  getArgs<T extends Array<unknown> = unknown[]>(): T {\n    return this.args as T;\n  }\n\n  getWorkflowInfo(): Info {\n    return this.args[0] as Info;\n  }\n\n  getArgByIndex<T = unknown>(index: number): T {\n    return this.args[index] as T;\n  }\n\n  switchToRpc(): ReturnType<ExecutionContext['switchToRpc']> {\n    throw new Error('Context does not support RPC context');\n  }\n\n  switchToHttp(): ReturnType<ExecutionContext['switchToHttp']> {\n    throw new Error('Context does not support HTTP context');\n  }\n\n  switchToWs(): ReturnType<ExecutionContext['switchToWs']> {\n    throw new Error('Context does not support WebSocket context');\n  }\n\n  getType<TContext extends string = string>(): TContext {\n    return 'temporal' as TContext;\n  }\n}\n\ntype Type<T = unknown> = new (...args: unknown[]) => T;\n\n","import { ParamData } from '@nestjs/common';\nimport { ParamsFactory } from '@nestjs/core/helpers/external-context-creator';\nimport { TemporalParamType } from './temporal-enums';\nimport { TemporalExecutionContext } from './core/temporal-execution-context';\n\nexport class TemporalParamsFactory implements ParamsFactory {\n  constructor(\n    private readonly instance: object,\n    private readonly handler: Function,\n  ) {}\n\n  exchangeKeyForValue(\n    type: number,\n    data: ParamData,\n    args: unknown[],\n  ): unknown {\n    switch (type) {\n      case TemporalParamType.PAYLOAD:\n        return data && args[0] && typeof args[0] === 'object'\n          ? (args[0] as Record<string, unknown>)[data as string]\n          : args[0];\n\n      case TemporalParamType.CONTEXT:\n        return new TemporalExecutionContext(this.instance, this.handler, args);\n\n      default:\n        return null;\n    }\n  }\n}\n\n","import {\n  Inject,\n  Injectable,\n  Logger,\n  OnApplicationBootstrap,\n  OnModuleDestroy,\n  OnModuleInit,\n} from \"@nestjs/common\";\nimport {\n  DiscoveryService,\n  MetadataScanner,\n  ExternalContextCreator,\n} from \"@nestjs/core\";\nimport { InstanceWrapper } from \"@nestjs/core/injector/instance-wrapper\";\nimport { lastValueFrom, isObservable } from \"rxjs\";\nimport {\n  NativeConnection,\n  NativeConnectionOptions,\n  Runtime,\n  RuntimeOptions,\n  Worker,\n  WorkerOptions,\n} from \"@temporalio/worker\";\nimport { TemporalMetadataAccessor } from \"./temporal-metadata.accessors\";\nimport {\n  TEMPORAL_MODULE_OPTIONS_TOKEN,\n  type TemporalModuleOptions,\n} from \"./temporal.module-definition\";\nimport {\n  TEMPORAL_ARGS_METADATA,\n  TEMPORAL_CONTEXT_METADATA,\n} from \"./constants/temporal.constants\";\nimport { TemporalParamsFactory } from \"./temporal-params.factory\";\nimport { Context } from \"@temporalio/activity\";\n\n/**\n * TemporalExplorer is responsible for discovering and registering Temporal activities\n * and creating the Temporal worker instance.\n *\n * It scans the NestJS application for classes decorated with @Activities() and methods\n * decorated with @Activity(), then registers them with the Temporal worker.\n */\n@Injectable()\nexport class TemporalExplorer\n  implements OnModuleInit, OnModuleDestroy, OnApplicationBootstrap\n{\n  @Inject(TEMPORAL_MODULE_OPTIONS_TOKEN)\n  private readonly options!: TemporalModuleOptions;\n  private readonly logger = new Logger(TemporalExplorer.name);\n  private worker?: Worker;\n  private workerRunPromise?: Promise<void>;\n\n  constructor(\n    private readonly discoveryService: DiscoveryService,\n    private readonly metadataAccessor: TemporalMetadataAccessor,\n    private readonly metadataScanner: MetadataScanner,\n    private readonly externalContextCreator: ExternalContextCreator,\n  ) {}\n\n  /**\n   * Initializes the module by exploring and setting up the Temporal worker.\n   */\n  async onModuleInit(): Promise<void> {\n    await this.explore();\n  }\n\n  /**\n   * Shuts down the Temporal worker when the module is destroyed.\n   */\n  async onModuleDestroy(): Promise<void> {\n    if (!this.worker) {\n      return;\n    }\n\n    try {\n      this.worker.shutdown();\n      if (this.workerRunPromise) {\n        await this.worker.run();\n      }\n    } catch (err: unknown) {\n      this.logger.warn(\"Temporal workers were not cleanly shutdown.\", {\n        err: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n\n  /**\n   * Starts the Temporal worker when the application is fully bootstrapped.\n   */\n  onApplicationBootstrap(): void {\n    if (this.worker) {\n      this.workerRunPromise = this.worker.run();\n    }\n  }\n\n  /**\n   * Explores the application for Temporal activities and creates the worker.\n   * This method is called during module initialization.\n   */\n  async explore(): Promise<void> {\n    const workerConfig = this.getWorkerConfigOptions();\n    const runTimeOptions = this.getRuntimeOptions();\n    const connectionOptions = this.getNativeConnectionOptions();\n\n    // Worker must have a taskQueue configured\n    if (!workerConfig.taskQueue) {\n      this.logger.warn(\n        \"Temporal worker configuration missing taskQueue. Worker will not be created.\",\n      );\n      return;\n    }\n\n    this.findDuplicateActivityMethods();\n\n    const activitiesFunc = await this.handleActivities();\n\n    if (runTimeOptions) {\n      this.logger.verbose(\"Instantiating a new Runtime object\");\n      Runtime.install(runTimeOptions);\n    }\n\n    const workerOptions: Partial<WorkerOptions> = {\n      activities: activitiesFunc,\n    };\n\n    if (connectionOptions) {\n      this.logger.verbose(\"Connecting to the Temporal server\");\n      workerOptions.connection =\n        await NativeConnection.connect(connectionOptions);\n    }\n\n    this.logger.verbose(\"Creating a new Worker\");\n    this.worker = await Worker.create({\n      ...workerConfig,\n      ...workerOptions,\n    });\n  }\n\n  /**\n   * Gets the worker configuration options.\n   */\n  getWorkerConfigOptions(): WorkerOptions {\n    return this.options.workerOptions;\n  }\n\n  /**\n   * Gets the native connection options for the Temporal server.\n   */\n  getNativeConnectionOptions(): NativeConnectionOptions | undefined {\n    return this.options.connectionOptions;\n  }\n\n  /**\n   * Gets the runtime options for the Temporal worker.\n   */\n  getRuntimeOptions(): RuntimeOptions | undefined {\n    return this.options.runtimeOptions;\n  }\n\n  /**\n   * Gets the activity classes to register with this worker.\n   * If undefined, all discovered activities will be registered.\n   * Can be either class constructors or InstanceWrappers.\n   */\n  private getActivityClasses(): (InstanceWrapper | Function)[] | undefined {\n    return this.options.activityClasses as\n      | (InstanceWrapper | Function)[]\n      | undefined;\n  }\n\n  /**\n   * Validates that activity method names are unique across all activity classes.\n   * Throws an error if duplicates are found and errorOnDuplicateActivities is enabled.\n   */\n  findDuplicateActivityMethods(): void {\n    if (!this.options.errorOnDuplicateActivities) {\n      return;\n    }\n\n    const activityClasses = this.getActivityClasses();\n    if (!activityClasses || activityClasses.length === 0) {\n      return;\n    }\n\n    const activityMethods: Record<string, string[]> = {};\n\n    activityClasses.forEach((classOrWrapper: InstanceWrapper | Function) => {\n      // Handle both InstanceWrapper and class constructor\n      const wrapper = classOrWrapper as InstanceWrapper;\n      const instance =\n        \"instance\" in wrapper && wrapper.instance\n          ? wrapper.instance\n          : new (classOrWrapper as new () => unknown)();\n\n      this.metadataScanner\n        .getAllMethodNames(Object.getPrototypeOf(instance))\n        .forEach((key) => {\n          if (this.metadataAccessor.isActivity(instance[key])) {\n            activityMethods[key] = (activityMethods[key] || []).concat(\n              instance.constructor.name,\n            );\n          }\n        });\n    });\n\n    const violations = Object.entries(activityMethods).filter(\n      ([, classes]) => classes.length > 1,\n    );\n\n    if (violations.length > 0) {\n      const message = `Activity names must be unique across all Activity classes. Identified activities with conflicting names: ${JSON.stringify(\n        Object.fromEntries(violations),\n      )}`;\n      this.logger.error(message);\n      throw new Error(message);\n    }\n  }\n\n  /**\n   * Discovers and binds all activity methods from classes decorated with @Activities().\n   * Returns an object mapping activity method names to their bound implementations.\n   */\n  async handleActivities(): Promise<Record<string, Function>> {\n    const activitiesMethod: Record<string, Function> = {};\n\n    const activityClasses = this.getActivityClasses();\n    const activities: InstanceWrapper[] = this.discoveryService\n      .getProviders()\n      .filter(\n        (wrapper: InstanceWrapper) =>\n          this.metadataAccessor.isActivities(\n            !wrapper.metatype || wrapper.inject\n              ? wrapper.instance?.constructor\n              : wrapper.metatype,\n          ) &&\n          (!activityClasses ||\n            activityClasses.some(\n              (cls) =>\n                cls === wrapper.metatype ||\n                (cls instanceof Object &&\n                  \"metatype\" in cls &&\n                  (cls as InstanceWrapper).metatype === wrapper.metatype),\n            )),\n      );\n\n    activities.forEach((wrapper: InstanceWrapper) => {\n      const { instance } = wrapper;\n      const isRequestScoped = !wrapper.isDependencyTreeStatic();\n\n      this.metadataScanner.scanFromPrototype(\n        instance,\n        Object.getPrototypeOf(instance),\n        (key: string) => {\n          if (this.metadataAccessor.isActivity(instance[key])) {\n            if (isRequestScoped) {\n              this.logger.warn(\n                `Request-scoped activities are not yet fully supported. Activity \"${key}\" from class \"${instance.constructor.name}\" may not work correctly.`,\n              );\n            }\n            const paramsFactory = new TemporalParamsFactory(\n              instance,\n              instance[key],\n            );\n\n            const handler = this.externalContextCreator.create(\n              instance,\n              instance[key],\n              key,\n              TEMPORAL_ARGS_METADATA,\n              paramsFactory,\n              undefined,\n              undefined,\n              undefined,\n              \"temporal\",\n            );\n\n            activitiesMethod[key] = async (...args: unknown[]) => {\n              const result = handler(...args, Context.current().info);\n\n              return isObservable(result)\n                ? await lastValueFrom(result)\n                : await result;\n            };\n          }\n        },\n      );\n    });\n    return activitiesMethod;\n  }\n}\n","export function getQueueToken(name?: string): string {\n  return name ? `TemporalQueue_${name}` : 'TemporalQueue_default';\n}\n\nexport function getAsyncQueueToken(name?: string): string {\n  return name ? `TemporalAsyncQueue_${name}` : 'TemporalAsyncQueue_default';\n}\n","import { OnApplicationShutdown } from '@nestjs/common';\nimport { WorkflowClient, WorkflowClientOptions } from '@temporalio/client';\n\n/**\n * Assigns an application shutdown hook to a WorkflowClient to ensure\n * the connection is properly closed when the application shuts down.\n *\n * @param client - The WorkflowClient instance\n * @returns The client with shutdown hook assigned\n */\nexport function assignOnAppShutdownHook(\n  client: WorkflowClient,\n): WorkflowClient {\n  (client as unknown as OnApplicationShutdown).onApplicationShutdown =\n    async () => {\n      try {\n        await client.connection?.close();\n      } catch (reason: unknown) {\n        const errorMessage =\n          reason instanceof Error ? reason.message : String(reason);\n        console.error(\n          `Temporal client connection was not cleanly closed: ${errorMessage}`,\n        );\n      }\n    };\n  return client;\n}\n\n/**\n * Creates a new WorkflowClient instance with application shutdown hook.\n *\n * @param options - Optional WorkflowClient configuration options\n * @returns A WorkflowClient instance with shutdown hook\n */\nexport function getWorkflowClient(\n  options?: WorkflowClientOptions,\n): WorkflowClient {\n  const client = new WorkflowClient(options);\n  return assignOnAppShutdownHook(client);\n}\n","import { Provider } from '@nestjs/common';\nimport { WorkflowClientOptions } from '@temporalio/client';\n\nimport { SharedWorkflowClientOptions } from '../interfaces/shared-workflow-client-options.interface';\nimport {\n  SharedConnectionAsyncConfiguration,\n  SharedRuntimeAsyncConfiguration,\n  SharedWorkerAsyncConfiguration,\n} from '../interfaces';\nimport { getWorkflowClient } from './client.util';\nimport { getAsyncQueueToken, getQueueToken } from './get-queue-token.util';\nimport { DiscoveryModule } from '@nestjs/core';\n\nexport function createAsyncProvider(\n  provide: string,\n  options?:\n    | SharedWorkerAsyncConfiguration\n    | SharedRuntimeAsyncConfiguration\n    | SharedConnectionAsyncConfiguration\n    | SharedWorkflowClientOptions,\n): Provider {\n  if (options?.useFactory) {\n    const { useFactory, inject } = options;\n    return {\n      provide,\n      useFactory,\n      inject: inject || [],\n    };\n  }\n  return {\n    provide,\n    useValue: options?.useValue || null,\n  };\n}\n\nexport function createClientAsyncProvider(\n  asyncOptions: SharedWorkflowClientOptions,\n): Provider[] {\n  const name = asyncOptions.name ? asyncOptions.name : undefined;\n  const optionsProvide = getAsyncQueueToken(name);\n  const clientProvide = getQueueToken(name);\n  return [\n    createAsyncProvider(optionsProvide, asyncOptions),\n    {\n      provide: clientProvide,\n      useFactory: (options?: WorkflowClientOptions) =>\n        getWorkflowClient(options),\n      inject: [optionsProvide],\n    },\n    DiscoveryModule,\n  ];\n}\n","import { DynamicModule, Module } from \"@nestjs/common\";\nimport { DiscoveryModule } from \"@nestjs/core\";\n\nimport { TemporalMetadataAccessor } from \"./temporal-metadata.accessors\";\nimport { TemporalExplorer } from \"./temporal.explorer\";\nimport {\n  SharedWorkflowClientOptions,\n  TemporalModuleOptions,\n} from \"./interfaces\";\nimport { createClientProviders } from \"./temporal.providers\";\nimport { createClientAsyncProvider } from \"./utils\";\nimport {\n  ConfigurableModuleClass,\n  TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE,\n} from \"./temporal.module-definition\";\n\n/**\n * TemporalModule provides integration between NestJS and Temporal workflow orchestration.\n *\n * Use registerWorker() or registerWorkerAsync() to register Temporal workers that execute activities.\n * Use registerClient() or registerClientAsync() to register Temporal clients for starting workflows.\n */\n@Module({})\nexport class TemporalModule extends ConfigurableModuleClass {\n  /**\n   * Registers a Temporal worker asynchronously.\n   * Useful when configuration depends on other async providers (e.g., ConfigService).\n   *\n   * @param options - Async worker configuration options\n   * @returns Dynamic module configuration\n   */\n  static registerWorkerAsync(\n    options: typeof TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE,\n  ): DynamicModule {\n    const superDynamicModule = super.registerWorkerAsync(options);\n    superDynamicModule.imports?.push(DiscoveryModule);\n    superDynamicModule.providers?.push(\n      TemporalExplorer,\n      TemporalMetadataAccessor,\n    );\n    superDynamicModule.exports?.push(\n      TemporalExplorer,\n      TemporalMetadataAccessor,\n      DiscoveryModule,\n    );\n\n    return {\n      ...superDynamicModule,\n      exports: [DiscoveryModule],\n    };\n  }\n\n  /**\n   * Registers a Temporal WorkflowClient asynchronously.\n   * Useful when configuration depends on other async providers (e.g., ConfigService).\n   *\n   * @param asyncSharedWorkflowClientOptions - Async client configuration options\n   * @returns Dynamic module configuration\n   */\n  static registerClientAsync(\n    asyncSharedWorkflowClientOptions: SharedWorkflowClientOptions,\n  ): DynamicModule {\n    const providers = createClientAsyncProvider(\n      asyncSharedWorkflowClientOptions,\n    );\n\n    return {\n      global: true,\n      module: TemporalModule,\n      providers,\n      exports: providers,\n    };\n  }\n}\n","import { Scope, SetMetadata } from '@nestjs/common';\nimport { SCOPE_OPTIONS_METADATA } from '@nestjs/common/constants';\nimport { ActivityOptions } from '@temporalio/workflow';\n\nimport { TEMPORAL_MODULE_ACTIVITIES } from '../constants/temporal.constants';\n\n/**\n * Options for the @Activities() decorator.\n */\nexport interface ActivitiesOptions extends ActivityOptions {\n  /**\n   * Specifies the name of the queue to subscribe to.\n   */\n  name?: string;\n  /**\n   * Specifies the lifetime of an injected Activities class.\n   */\n  scope?: Scope;\n}\n\n/**\n * Marks a class as containing Temporal activities.\n * Methods within this class decorated with @Activity() will be registered as Temporal activities.\n *\n * @param queueNameOrOptions - Optional queue name (string) or options object\n * @returns Class decorator\n *\n * @example\n * ```typescript\n * @Injectable()\n * @Activities()\n * export class MyActivities {\n *   @Activity()\n *   async doSomething() { }\n * }\n * ```\n */\nexport function Activities(): ClassDecorator;\nexport function Activities(queueName: string): ClassDecorator;\nexport function Activities(\n  activitiesOptions: ActivitiesOptions,\n): ClassDecorator;\nexport function Activities(\n  queueNameOrOptions?: string | ActivitiesOptions,\n): ClassDecorator {\n  const options =\n    queueNameOrOptions && typeof queueNameOrOptions === 'object'\n      ? queueNameOrOptions\n      : { name: queueNameOrOptions };\n  return (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_ACTIVITIES, options)(target);\n  };\n}\n","import { SetMetadata } from '@nestjs/common';\n\nimport { TEMPORAL_MODULE_ACTIVITY } from '../constants/temporal.constants';\n\n/**\n * Options for the @Activity() decorator.\n */\nexport interface ActivityOptions {\n  /**\n   * Custom name for the activity. If not provided, the method name is used.\n   */\n  name?: string;\n}\n\n/**\n * Marks a method as a Temporal activity.\n * The method must be within a class decorated with @Activities().\n *\n * @param nameOrOptions - Optional activity name (string) or options object\n * @returns Method decorator\n *\n * @example\n * ```typescript\n * @Activity()\n * async processOrder(orderId: string) { }\n *\n * @Activity('custom-activity-name')\n * async anotherActivity() { }\n * ```\n */\nexport function Activity(): MethodDecorator;\nexport function Activity(name: string): MethodDecorator;\nexport function Activity(options: ActivityOptions): MethodDecorator;\nexport function Activity(\n  nameOrOptions?: string | ActivityOptions,\n): MethodDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n\n  return SetMetadata(TEMPORAL_MODULE_ACTIVITY, options || {});\n}\n","import { Inject } from '@nestjs/common';\n\nimport { getQueueToken } from '../utils';\n\n/**\n * Injects a Temporal WorkflowClient instance.\n * Use this decorator to inject the client registered via TemporalModule.registerClient().\n *\n * @param name - Optional name of the client instance (for named clients)\n * @returns Parameter decorator for dependency injection\n *\n * @example\n * ```typescript\n * constructor(@InjectTemporalClient() private client: WorkflowClient) {}\n * ```\n */\nexport const InjectTemporalClient = (name?: string): ParameterDecorator =>\n  Inject(getQueueToken(name));\n","import { SetMetadata } from '@nestjs/common';\n\nimport { TEMPORAL_MODULE_WORKFLOW_METHOD } from '../constants/temporal.constants';\n\nexport interface WorkflowMethodOptions {\n  name?: string;\n}\n\nexport function WorkflowMethod(): MethodDecorator;\nexport function WorkflowMethod(name: string): MethodDecorator;\nexport function WorkflowMethod(options: WorkflowMethodOptions): MethodDecorator;\nexport function WorkflowMethod(\n  nameOrOptions?: string | WorkflowMethodOptions,\n): MethodDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n\n  return SetMetadata(TEMPORAL_MODULE_WORKFLOW_METHOD, options || {});\n}\n","import { Scope, SetMetadata } from '@nestjs/common';\nimport { SCOPE_OPTIONS_METADATA } from '@nestjs/common/constants';\n\nimport { TEMPORAL_MODULE_WORKFLOW } from '../constants/temporal.constants';\n\nexport interface WorkflowsOptions {\n  /**\n   * Specifies the name of the queue to subscribe to.\n   */\n  name?: string;\n  /**\n   * Specifies the lifetime of an injected Processor.\n   */\n  scope?: Scope;\n}\n\nexport function Workflows(): ClassDecorator;\nexport function Workflows(name: string): ClassDecorator;\nexport function Workflows(options: WorkflowsOptions): ClassDecorator;\nexport function Workflows(\n  nameOrOptions?: string | WorkflowsOptions,\n): ClassDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n  return (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_WORKFLOW, options)(target);\n  };\n}\n","import { createParamDecorator, ExecutionContext } from \"@nestjs/common\";\n\nexport const ActivityPayload = () => createParamDecorator((_, ctx: ExecutionContext) => {\n  return ctx.getArgByIndex(0);\n});"],"mappings":"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"}

package/dist/index.mjs

@@ -158,9 +158,9 @@ let TemporalExplorer = _TemporalExplorer = class TemporalExplorer {
 		if (!this.worker) return;
 		try {
 			this.worker.shutdown();
-			if (this.workerRunPromise) await this.workerRunPromise;
+			if (this.workerRunPromise) await this.worker.run();
 		} catch (err) {
-			this.logger.warn("Temporal worker was not cleanly shutdown.", { err: err instanceof Error ? err.message : String(err) });
+			this.logger.warn("Temporal workers were not cleanly shutdown.", { err: err instanceof Error ? err.message : String(err) });
 		}
 	}
 	/**

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/constants/temporal.constants.ts","../src/temporal-metadata.accessors.ts","../src/temporal.module-definition.ts","../src/temporal-enums.ts","../src/core/temporal-execution-context.ts","../src/temporal-params.factory.ts","../src/temporal.explorer.ts","../src/utils/get-queue-token.util.ts","../src/utils/client.util.ts","../src/utils/provider.util.ts","../src/temporal.module.ts","../src/decorators/activities.decorator.ts","../src/decorators/activity.decorator.ts","../src/decorators/inject-temporal-client.decorator.ts","../src/decorators/workflow.decorator.ts","../src/decorators/workflows.decorator.ts","../src/decorators/payload.decorator.ts"],"sourcesContent":["export const TEMPORAL_MODULE_ACTIVITIES = '_temporal_module_activities';\nexport const TEMPORAL_MODULE_ACTIVITY = '_temporal_module_activity';\nexport const TEMPORAL_MODULE_WORKFLOW = '_temporal_module_workFlow';\nexport const TEMPORAL_MODULE_WORKFLOW_METHOD =\n  '_temporal_module_workflow_method';\nexport const TEMPORAL_ARGS_METADATA = '_temporal_module_args';\nexport const TEMPORAL_CONTEXT_METADATA = '_temporal_module_context';","import { Injectable, Type } from '@nestjs/common';\nimport { Reflector } from '@nestjs/core';\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\n  TEMPORAL_MODULE_WORKFLOW,\n  TEMPORAL_MODULE_WORKFLOW_METHOD,\n} from './constants/temporal.constants';\n\n/**\n * TemporalMetadataAccessor provides methods to check and retrieve Temporal decorator metadata.\n * It uses NestJS Reflector to access metadata set by @Activities(), @Activity(), @Workflows(), and @WorkflowMethod() decorators.\n */\n@Injectable()\nexport class TemporalMetadataAccessor {\n  constructor(private readonly reflector: Reflector) {}\n\n  isActivities(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_ACTIVITIES, target);\n  }\n\n  getActivities(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_ACTIVITIES, target);\n  }\n\n  isActivity(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_ACTIVITY, target);\n  }\n\n  getActivity(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_ACTIVITY, target);\n  }\n\n  isWorkflows(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_WORKFLOW, target);\n  }\n\n  getWorkflows(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_WORKFLOW, target);\n  }\n\n  isWorkflowMethod(\n    target: Type<unknown> | Function | null | undefined,\n  ): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_WORKFLOW_METHOD, target);\n  }\n\n  getWorkflowMethod(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_WORKFLOW_METHOD, target);\n  }\n}\n","import {\n  NativeConnectionOptions,\n  RuntimeOptions,\n  WorkerOptions,\n} from '@temporalio/worker';\nimport { ConfigurableModuleBuilder } from '@nestjs/common';\n\nexport interface TemporalModuleOptions {\n  workerOptions: WorkerOptions;\n  connectionOptions?: NativeConnectionOptions;\n  runtimeOptions?: RuntimeOptions;\n  activityClasses?: object[];\n  errorOnDuplicateActivities?: boolean;\n}\n\nexport const {\n  ConfigurableModuleClass,\n  MODULE_OPTIONS_TOKEN: TEMPORAL_MODULE_OPTIONS_TOKEN,\n  OPTIONS_TYPE: TEMPORAL_MODULE_OPTIONS_TYPE,\n  ASYNC_OPTIONS_TYPE: TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE,\n} = new ConfigurableModuleBuilder<TemporalModuleOptions>()\n  .setClassMethodName('registerWorker')\n  .build();\n","export enum TemporalParamType {\n  PAYLOAD = 3,\n  CONTEXT = 4,\n}\n\n","import { ExecutionContext } from '@nestjs/common';\nimport { Info } from '@temporalio/activity';\n\nexport class TemporalExecutionContext implements ExecutionContext {\n  constructor(\n    private readonly instance: object,\n    private readonly handler: Function,\n    private readonly args: unknown[]\n  ) {}\n\n  getClass<T = unknown>(): Type<T> {\n    return this.instance.constructor as Type<T>;\n  }\n\n  getHandler(): Function {\n    return this.handler;\n  }\n\n  getArgs<T extends Array<unknown> = unknown[]>(): T {\n    return this.args as T;\n  }\n\n  getWorkflowInfo(): Info {\n    return this.args[0] as Info;\n  }\n\n  getArgByIndex<T = unknown>(index: number): T {\n    return this.args[index] as T;\n  }\n\n  switchToRpc(): ReturnType<ExecutionContext['switchToRpc']> {\n    throw new Error('Context does not support RPC context');\n  }\n\n  switchToHttp(): ReturnType<ExecutionContext['switchToHttp']> {\n    throw new Error('Context does not support HTTP context');\n  }\n\n  switchToWs(): ReturnType<ExecutionContext['switchToWs']> {\n    throw new Error('Context does not support WebSocket context');\n  }\n\n  getType<TContext extends string = string>(): TContext {\n    return 'temporal' as TContext;\n  }\n}\n\ntype Type<T = unknown> = new (...args: unknown[]) => T;\n\n","import { ParamData } from '@nestjs/common';\nimport { ParamsFactory } from '@nestjs/core/helpers/external-context-creator';\nimport { TemporalParamType } from './temporal-enums';\nimport { TemporalExecutionContext } from './core/temporal-execution-context';\n\nexport class TemporalParamsFactory implements ParamsFactory {\n  constructor(\n    private readonly instance: object,\n    private readonly handler: Function,\n  ) {}\n\n  exchangeKeyForValue(\n    type: number,\n    data: ParamData,\n    args: unknown[],\n  ): unknown {\n    switch (type) {\n      case TemporalParamType.PAYLOAD:\n        return data && args[0] && typeof args[0] === 'object'\n          ? (args[0] as Record<string, unknown>)[data as string]\n          : args[0];\n\n      case TemporalParamType.CONTEXT:\n        return new TemporalExecutionContext(this.instance, this.handler, args);\n\n      default:\n        return null;\n    }\n  }\n}\n\n","import {\n  Inject,\n  Injectable,\n  Logger,\n  OnApplicationBootstrap,\n  OnModuleDestroy,\n  OnModuleInit,\n} from \"@nestjs/common\";\nimport { DiscoveryService, MetadataScanner, ExternalContextCreator } from \"@nestjs/core\";\nimport { InstanceWrapper } from \"@nestjs/core/injector/instance-wrapper\";\nimport { lastValueFrom, isObservable } from \"rxjs\";\nimport {\n  NativeConnection,\n  NativeConnectionOptions,\n  Runtime,\n  RuntimeOptions,\n  Worker,\n  WorkerOptions,\n} from \"@temporalio/worker\";\nimport { TemporalMetadataAccessor } from \"./temporal-metadata.accessors\";\nimport {\n  TEMPORAL_MODULE_OPTIONS_TOKEN,\n  type TemporalModuleOptions,\n} from \"./temporal.module-definition\";\nimport { TEMPORAL_ARGS_METADATA, TEMPORAL_CONTEXT_METADATA } from \"./constants/temporal.constants\";\nimport { TemporalParamsFactory } from \"./temporal-params.factory\";\nimport { Context } from \"@temporalio/activity\";\n\n/**\n * TemporalExplorer is responsible for discovering and registering Temporal activities\n * and creating the Temporal worker instance.\n *\n * It scans the NestJS application for classes decorated with @Activities() and methods\n * decorated with @Activity(), then registers them with the Temporal worker.\n */\n@Injectable()\nexport class TemporalExplorer\n  implements OnModuleInit, OnModuleDestroy, OnApplicationBootstrap\n{\n  @Inject(TEMPORAL_MODULE_OPTIONS_TOKEN)\n  private readonly options!: TemporalModuleOptions;\n  private readonly logger = new Logger(TemporalExplorer.name);\n  private worker?: Worker;\n  private workerRunPromise?: Promise<void>;\n\n  constructor(\n    private readonly discoveryService: DiscoveryService,\n    private readonly metadataAccessor: TemporalMetadataAccessor,\n    private readonly metadataScanner: MetadataScanner,\n    private readonly externalContextCreator: ExternalContextCreator\n  ) {}\n\n  /**\n   * Initializes the module by exploring and setting up the Temporal worker.\n   */\n  async onModuleInit(): Promise<void> {\n    await this.explore();\n  }\n\n  /**\n   * Shuts down the Temporal worker when the module is destroyed.\n   */\n  async onModuleDestroy(): Promise<void> {\n    if (!this.worker) {\n      return;\n    }\n\n    try {\n      this.worker.shutdown();\n      if (this.workerRunPromise) {\n        await this.workerRunPromise;\n      }\n    } catch (err: unknown) {\n      this.logger.warn(\"Temporal worker was not cleanly shutdown.\", {\n        err: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n\n  /**\n   * Starts the Temporal worker when the application is fully bootstrapped.\n   */\n  onApplicationBootstrap(): void {\n    if (this.worker) {\n      this.workerRunPromise = this.worker.run();\n    }\n  }\n\n  /**\n   * Explores the application for Temporal activities and creates the worker.\n   * This method is called during module initialization.\n   */\n  async explore(): Promise<void> {\n    const workerConfig = this.getWorkerConfigOptions();\n    const runTimeOptions = this.getRuntimeOptions();\n    const connectionOptions = this.getNativeConnectionOptions();\n\n    // Worker must have a taskQueue configured\n    if (!workerConfig.taskQueue) {\n      this.logger.warn(\n        \"Temporal worker configuration missing taskQueue. Worker will not be created.\"\n      );\n      return;\n    }\n\n    this.findDuplicateActivityMethods();\n\n    const activitiesFunc = await this.handleActivities();\n\n    if (runTimeOptions) {\n      this.logger.verbose(\"Instantiating a new Runtime object\");\n      Runtime.install(runTimeOptions);\n    }\n\n    const workerOptions: Partial<WorkerOptions> = {\n      activities: activitiesFunc,\n    };\n\n    if (connectionOptions) {\n      this.logger.verbose(\"Connecting to the Temporal server\");\n      workerOptions.connection = await NativeConnection.connect(\n        connectionOptions\n      );\n    }\n\n    this.logger.verbose(\"Creating a new Worker\");\n    this.worker = await Worker.create({\n      ...workerConfig,\n      ...workerOptions,\n    });\n  }\n\n  /**\n   * Gets the worker configuration options.\n   */\n  getWorkerConfigOptions(): WorkerOptions {\n    return this.options.workerOptions;\n  }\n\n  /**\n   * Gets the native connection options for the Temporal server.\n   */\n  getNativeConnectionOptions(): NativeConnectionOptions | undefined {\n    return this.options.connectionOptions;\n  }\n\n  /**\n   * Gets the runtime options for the Temporal worker.\n   */\n  getRuntimeOptions(): RuntimeOptions | undefined {\n    return this.options.runtimeOptions;\n  }\n\n  /**\n   * Gets the activity classes to register with this worker.\n   * If undefined, all discovered activities will be registered.\n   * Can be either class constructors or InstanceWrappers.\n   */\n  private getActivityClasses(): (InstanceWrapper | Function)[] | undefined {\n    return this.options.activityClasses as\n      | (InstanceWrapper | Function)[]\n      | undefined;\n  }\n\n  /**\n   * Validates that activity method names are unique across all activity classes.\n   * Throws an error if duplicates are found and errorOnDuplicateActivities is enabled.\n   */\n  findDuplicateActivityMethods(): void {\n    if (!this.options.errorOnDuplicateActivities) {\n      return;\n    }\n\n    const activityClasses = this.getActivityClasses();\n    if (!activityClasses || activityClasses.length === 0) {\n      return;\n    }\n\n    const activityMethods: Record<string, string[]> = {};\n\n    activityClasses.forEach((classOrWrapper: InstanceWrapper | Function) => {\n      // Handle both InstanceWrapper and class constructor\n      const wrapper = classOrWrapper as InstanceWrapper;\n      const instance =\n        \"instance\" in wrapper && wrapper.instance\n          ? wrapper.instance\n          : new (classOrWrapper as new () => unknown)();\n\n      this.metadataScanner\n        .getAllMethodNames(Object.getPrototypeOf(instance))\n        .forEach((key) => {\n          if (this.metadataAccessor.isActivity(instance[key])) {\n            activityMethods[key] = (activityMethods[key] || []).concat(\n              instance.constructor.name\n            );\n          }\n        });\n    });\n\n    const violations = Object.entries(activityMethods).filter(\n      ([, classes]) => classes.length > 1\n    );\n\n    if (violations.length > 0) {\n      const message = `Activity names must be unique across all Activity classes. Identified activities with conflicting names: ${JSON.stringify(\n        Object.fromEntries(violations)\n      )}`;\n      this.logger.error(message);\n      throw new Error(message);\n    }\n  }\n\n  /**\n   * Discovers and binds all activity methods from classes decorated with @Activities().\n   * Returns an object mapping activity method names to their bound implementations.\n   */\n  async handleActivities(): Promise<Record<string, Function>> {\n    const activitiesMethod: Record<string, Function> = {};\n\n    const activityClasses = this.getActivityClasses();\n    const activities: InstanceWrapper[] = this.discoveryService\n      .getProviders()\n      .filter(\n        (wrapper: InstanceWrapper) =>\n          this.metadataAccessor.isActivities(\n            !wrapper.metatype || wrapper.inject\n              ? wrapper.instance?.constructor\n              : wrapper.metatype\n          ) &&\n          (!activityClasses ||\n            activityClasses.some(\n              (cls) =>\n                cls === wrapper.metatype ||\n                (cls instanceof Object &&\n                  \"metatype\" in cls &&\n                  (cls as InstanceWrapper).metatype === wrapper.metatype)\n            ))\n      );\n\n    activities.forEach((wrapper: InstanceWrapper) => {\n      const { instance } = wrapper;\n      const isRequestScoped = !wrapper.isDependencyTreeStatic();\n\n      this.metadataScanner.scanFromPrototype(\n        instance,\n        Object.getPrototypeOf(instance),\n        (key: string) => {\n          if (this.metadataAccessor.isActivity(instance[key])) {\n            if (isRequestScoped) {\n              this.logger.warn(\n                `Request-scoped activities are not yet fully supported. Activity \"${key}\" from class \"${instance.constructor.name}\" may not work correctly.`\n              );\n            }\n            const paramsFactory = new TemporalParamsFactory(\n              instance,\n              instance[key]\n            );\n\n            const handler = this.externalContextCreator.create(\n              instance,\n              instance[key],\n              key,\n              TEMPORAL_ARGS_METADATA,\n              paramsFactory,\n              undefined,\n              undefined,\n              undefined,\n              \"temporal\"\n            );\n            \n            activitiesMethod[key] = async (...args: unknown[]) => {\n              const result = handler(...args, Context.current().info);\n\n              return isObservable(result)\n                ? await lastValueFrom(result)\n                : await result;\n            };\n          }\n        }\n      );\n    });\n    return activitiesMethod;\n  }\n}\n","export function getQueueToken(name?: string): string {\n  return name ? `TemporalQueue_${name}` : 'TemporalQueue_default';\n}\n\nexport function getAsyncQueueToken(name?: string): string {\n  return name ? `TemporalAsyncQueue_${name}` : 'TemporalAsyncQueue_default';\n}\n","import { OnApplicationShutdown } from '@nestjs/common';\nimport { WorkflowClient, WorkflowClientOptions } from '@temporalio/client';\n\n/**\n * Assigns an application shutdown hook to a WorkflowClient to ensure\n * the connection is properly closed when the application shuts down.\n *\n * @param client - The WorkflowClient instance\n * @returns The client with shutdown hook assigned\n */\nexport function assignOnAppShutdownHook(\n  client: WorkflowClient,\n): WorkflowClient {\n  (client as unknown as OnApplicationShutdown).onApplicationShutdown =\n    async () => {\n      try {\n        await client.connection?.close();\n      } catch (reason: unknown) {\n        const errorMessage =\n          reason instanceof Error ? reason.message : String(reason);\n        console.error(\n          `Temporal client connection was not cleanly closed: ${errorMessage}`,\n        );\n      }\n    };\n  return client;\n}\n\n/**\n * Creates a new WorkflowClient instance with application shutdown hook.\n *\n * @param options - Optional WorkflowClient configuration options\n * @returns A WorkflowClient instance with shutdown hook\n */\nexport function getWorkflowClient(\n  options?: WorkflowClientOptions,\n): WorkflowClient {\n  const client = new WorkflowClient(options);\n  return assignOnAppShutdownHook(client);\n}\n","import { Provider } from '@nestjs/common';\nimport { WorkflowClientOptions } from '@temporalio/client';\n\nimport { SharedWorkflowClientOptions } from '../interfaces/shared-workflow-client-options.interface';\nimport {\n  SharedConnectionAsyncConfiguration,\n  SharedRuntimeAsyncConfiguration,\n  SharedWorkerAsyncConfiguration,\n} from '../interfaces';\nimport { getWorkflowClient } from './client.util';\nimport { getAsyncQueueToken, getQueueToken } from './get-queue-token.util';\nimport { DiscoveryModule } from '@nestjs/core';\n\nexport function createAsyncProvider(\n  provide: string,\n  options?:\n    | SharedWorkerAsyncConfiguration\n    | SharedRuntimeAsyncConfiguration\n    | SharedConnectionAsyncConfiguration\n    | SharedWorkflowClientOptions,\n): Provider {\n  if (options?.useFactory) {\n    const { useFactory, inject } = options;\n    return {\n      provide,\n      useFactory,\n      inject: inject || [],\n    };\n  }\n  return {\n    provide,\n    useValue: options?.useValue || null,\n  };\n}\n\nexport function createClientAsyncProvider(\n  asyncOptions: SharedWorkflowClientOptions,\n): Provider[] {\n  const name = asyncOptions.name ? asyncOptions.name : undefined;\n  const optionsProvide = getAsyncQueueToken(name);\n  const clientProvide = getQueueToken(name);\n  return [\n    createAsyncProvider(optionsProvide, asyncOptions),\n    {\n      provide: clientProvide,\n      useFactory: (options?: WorkflowClientOptions) =>\n        getWorkflowClient(options),\n      inject: [optionsProvide],\n    },\n    DiscoveryModule,\n  ];\n}\n","import { DynamicModule, Module } from \"@nestjs/common\";\nimport { DiscoveryModule } from \"@nestjs/core\";\n\nimport { TemporalMetadataAccessor } from \"./temporal-metadata.accessors\";\nimport { TemporalExplorer } from \"./temporal.explorer\";\nimport {\n  SharedWorkflowClientOptions,\n  TemporalModuleOptions,\n} from \"./interfaces\";\nimport { createClientProviders } from \"./temporal.providers\";\nimport { createClientAsyncProvider } from \"./utils\";\nimport {\n  ConfigurableModuleClass,\n  TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE,\n  TEMPORAL_MODULE_OPTIONS_TYPE,\n} from \"./temporal.module-definition\";\n\n/**\n * TemporalModule provides integration between NestJS and Temporal workflow orchestration.\n *\n * Use registerWorker() or registerWorkerAsync() to register Temporal workers that execute activities.\n * Use registerClient() or registerClientAsync() to register Temporal clients for starting workflows.\n */\n@Module({})\nexport class TemporalModule extends ConfigurableModuleClass {\n  /**\n   * Registers a Temporal worker asynchronously.\n   * Useful when configuration depends on other async providers (e.g., ConfigService).\n   *\n   * @param options - Async worker configuration options\n   * @returns Dynamic module configuration\n   */\n  static registerWorkerAsync(\n    options: typeof TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE\n  ): DynamicModule {\n    const superDynamicModule = super.registerWorkerAsync(options);\n    superDynamicModule.imports?.push(DiscoveryModule);\n    superDynamicModule.providers?.push(\n      TemporalExplorer,\n      TemporalMetadataAccessor\n    );\n    superDynamicModule.exports?.push(TemporalExplorer, TemporalMetadataAccessor, DiscoveryModule);\n\n    return {\n      ...superDynamicModule,\n      exports: [DiscoveryModule],\n    };\n  }\n\n  /**\n   * Registers a Temporal WorkflowClient asynchronously.\n   * Useful when configuration depends on other async providers (e.g., ConfigService).\n   *\n   * @param asyncSharedWorkflowClientOptions - Async client configuration options\n   * @returns Dynamic module configuration\n   */\n  static registerClientAsync(\n    asyncSharedWorkflowClientOptions: SharedWorkflowClientOptions\n  ): DynamicModule {\n    const providers = createClientAsyncProvider(\n      asyncSharedWorkflowClientOptions\n    );\n\n    return {\n      global: true,\n      module: TemporalModule,\n      providers,\n      exports: providers,\n    };\n  }\n}\n","import { Scope, SetMetadata } from '@nestjs/common';\nimport { SCOPE_OPTIONS_METADATA } from '@nestjs/common/constants';\nimport { ActivityOptions } from '@temporalio/workflow';\n\nimport { TEMPORAL_MODULE_ACTIVITIES } from '../constants/temporal.constants';\n\n/**\n * Options for the @Activities() decorator.\n */\nexport interface ActivitiesOptions extends ActivityOptions {\n  /**\n   * Specifies the name of the queue to subscribe to.\n   */\n  name?: string;\n  /**\n   * Specifies the lifetime of an injected Activities class.\n   */\n  scope?: Scope;\n}\n\n/**\n * Marks a class as containing Temporal activities.\n * Methods within this class decorated with @Activity() will be registered as Temporal activities.\n *\n * @param queueNameOrOptions - Optional queue name (string) or options object\n * @returns Class decorator\n *\n * @example\n * ```typescript\n * @Injectable()\n * @Activities()\n * export class MyActivities {\n *   @Activity()\n *   async doSomething() { }\n * }\n * ```\n */\nexport function Activities(): ClassDecorator;\nexport function Activities(queueName: string): ClassDecorator;\nexport function Activities(\n  activitiesOptions: ActivitiesOptions,\n): ClassDecorator;\nexport function Activities(\n  queueNameOrOptions?: string | ActivitiesOptions,\n): ClassDecorator {\n  const options =\n    queueNameOrOptions && typeof queueNameOrOptions === 'object'\n      ? queueNameOrOptions\n      : { name: queueNameOrOptions };\n  return (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_ACTIVITIES, options)(target);\n  };\n}\n","import { SetMetadata } from '@nestjs/common';\n\nimport { TEMPORAL_MODULE_ACTIVITY } from '../constants/temporal.constants';\n\n/**\n * Options for the @Activity() decorator.\n */\nexport interface ActivityOptions {\n  /**\n   * Custom name for the activity. If not provided, the method name is used.\n   */\n  name?: string;\n}\n\n/**\n * Marks a method as a Temporal activity.\n * The method must be within a class decorated with @Activities().\n *\n * @param nameOrOptions - Optional activity name (string) or options object\n * @returns Method decorator\n *\n * @example\n * ```typescript\n * @Activity()\n * async processOrder(orderId: string) { }\n *\n * @Activity('custom-activity-name')\n * async anotherActivity() { }\n * ```\n */\nexport function Activity(): MethodDecorator;\nexport function Activity(name: string): MethodDecorator;\nexport function Activity(options: ActivityOptions): MethodDecorator;\nexport function Activity(\n  nameOrOptions?: string | ActivityOptions,\n): MethodDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n\n  return SetMetadata(TEMPORAL_MODULE_ACTIVITY, options || {});\n}\n","import { Inject } from '@nestjs/common';\n\nimport { getQueueToken } from '../utils';\n\n/**\n * Injects a Temporal WorkflowClient instance.\n * Use this decorator to inject the client registered via TemporalModule.registerClient().\n *\n * @param name - Optional name of the client instance (for named clients)\n * @returns Parameter decorator for dependency injection\n *\n * @example\n * ```typescript\n * constructor(@InjectTemporalClient() private client: WorkflowClient) {}\n * ```\n */\nexport const InjectTemporalClient = (name?: string): ParameterDecorator =>\n  Inject(getQueueToken(name));\n","import { SetMetadata } from '@nestjs/common';\n\nimport { TEMPORAL_MODULE_WORKFLOW_METHOD } from '../constants/temporal.constants';\n\nexport interface WorkflowMethodOptions {\n  name?: string;\n}\n\nexport function WorkflowMethod(): MethodDecorator;\nexport function WorkflowMethod(name: string): MethodDecorator;\nexport function WorkflowMethod(options: WorkflowMethodOptions): MethodDecorator;\nexport function WorkflowMethod(\n  nameOrOptions?: string | WorkflowMethodOptions,\n): MethodDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n\n  return SetMetadata(TEMPORAL_MODULE_WORKFLOW_METHOD, options || {});\n}\n","import { Scope, SetMetadata } from '@nestjs/common';\nimport { SCOPE_OPTIONS_METADATA } from '@nestjs/common/constants';\n\nimport { TEMPORAL_MODULE_WORKFLOW } from '../constants/temporal.constants';\n\nexport interface WorkflowsOptions {\n  /**\n   * Specifies the name of the queue to subscribe to.\n   */\n  name?: string;\n  /**\n   * Specifies the lifetime of an injected Processor.\n   */\n  scope?: Scope;\n}\n\nexport function Workflows(): ClassDecorator;\nexport function Workflows(name: string): ClassDecorator;\nexport function Workflows(options: WorkflowsOptions): ClassDecorator;\nexport function Workflows(\n  nameOrOptions?: string | WorkflowsOptions,\n): ClassDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n  return (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_WORKFLOW, options)(target);\n  };\n}\n","import { createParamDecorator, ExecutionContext } from \"@nestjs/common\";\n\nexport const ActivityPayload = () => createParamDecorator((_, ctx: ExecutionContext) => {\n  return ctx.getArgByIndex(0);\n});"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/constants/temporal.constants.ts","../src/temporal-metadata.accessors.ts","../src/temporal.module-definition.ts","../src/temporal-enums.ts","../src/core/temporal-execution-context.ts","../src/temporal-params.factory.ts","../src/temporal.explorer.ts","../src/utils/get-queue-token.util.ts","../src/utils/client.util.ts","../src/utils/provider.util.ts","../src/temporal.module.ts","../src/decorators/activities.decorator.ts","../src/decorators/activity.decorator.ts","../src/decorators/inject-temporal-client.decorator.ts","../src/decorators/workflow.decorator.ts","../src/decorators/workflows.decorator.ts","../src/decorators/payload.decorator.ts"],"sourcesContent":["export const TEMPORAL_MODULE_ACTIVITIES = '_temporal_module_activities';\nexport const TEMPORAL_MODULE_ACTIVITY = '_temporal_module_activity';\nexport const TEMPORAL_MODULE_WORKFLOW = '_temporal_module_workFlow';\nexport const TEMPORAL_MODULE_WORKFLOW_METHOD =\n  '_temporal_module_workflow_method';\nexport const TEMPORAL_ARGS_METADATA = '_temporal_module_args';\nexport const TEMPORAL_CONTEXT_METADATA = '_temporal_module_context';","import { Injectable, Type } from '@nestjs/common';\nimport { Reflector } from '@nestjs/core';\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\n  TEMPORAL_MODULE_WORKFLOW,\n  TEMPORAL_MODULE_WORKFLOW_METHOD,\n} from './constants/temporal.constants';\n\n/**\n * TemporalMetadataAccessor provides methods to check and retrieve Temporal decorator metadata.\n * It uses NestJS Reflector to access metadata set by @Activities(), @Activity(), @Workflows(), and @WorkflowMethod() decorators.\n */\n@Injectable()\nexport class TemporalMetadataAccessor {\n  constructor(private readonly reflector: Reflector) {}\n\n  isActivities(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_ACTIVITIES, target);\n  }\n\n  getActivities(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_ACTIVITIES, target);\n  }\n\n  isActivity(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_ACTIVITY, target);\n  }\n\n  getActivity(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_ACTIVITY, target);\n  }\n\n  isWorkflows(target: Type<unknown> | Function | null | undefined): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_WORKFLOW, target);\n  }\n\n  getWorkflows(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_WORKFLOW, target);\n  }\n\n  isWorkflowMethod(\n    target: Type<unknown> | Function | null | undefined,\n  ): boolean {\n    if (!target) return false;\n    return !!this.reflector.get(TEMPORAL_MODULE_WORKFLOW_METHOD, target);\n  }\n\n  getWorkflowMethod(target: Type<unknown> | Function): unknown {\n    return this.reflector.get(TEMPORAL_MODULE_WORKFLOW_METHOD, target);\n  }\n}\n","import {\n  NativeConnectionOptions,\n  RuntimeOptions,\n  WorkerOptions,\n} from \"@temporalio/worker\";\nimport { ConfigurableModuleBuilder } from \"@nestjs/common\";\n\nexport interface TemporalModuleOptions {\n  workerOptions: WorkerOptions;\n  connectionOptions?: NativeConnectionOptions;\n  runtimeOptions?: RuntimeOptions;\n  activityClasses?: object[];\n  errorOnDuplicateActivities?: boolean;\n}\n\nexport const {\n  ConfigurableModuleClass,\n  MODULE_OPTIONS_TOKEN: TEMPORAL_MODULE_OPTIONS_TOKEN,\n  OPTIONS_TYPE: TEMPORAL_MODULE_OPTIONS_TYPE,\n  ASYNC_OPTIONS_TYPE: TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE,\n} = new ConfigurableModuleBuilder<TemporalModuleOptions>()\n  .setClassMethodName(\"registerWorker\")\n  .build();\n","export enum TemporalParamType {\n  PAYLOAD = 3,\n  CONTEXT = 4,\n}\n\n","import { ExecutionContext } from '@nestjs/common';\nimport { Info } from '@temporalio/activity';\n\nexport class TemporalExecutionContext implements ExecutionContext {\n  constructor(\n    private readonly instance: object,\n    private readonly handler: Function,\n    private readonly args: unknown[]\n  ) {}\n\n  getClass<T = unknown>(): Type<T> {\n    return this.instance.constructor as Type<T>;\n  }\n\n  getHandler(): Function {\n    return this.handler;\n  }\n\n  getArgs<T extends Array<unknown> = unknown[]>(): T {\n    return this.args as T;\n  }\n\n  getWorkflowInfo(): Info {\n    return this.args[0] as Info;\n  }\n\n  getArgByIndex<T = unknown>(index: number): T {\n    return this.args[index] as T;\n  }\n\n  switchToRpc(): ReturnType<ExecutionContext['switchToRpc']> {\n    throw new Error('Context does not support RPC context');\n  }\n\n  switchToHttp(): ReturnType<ExecutionContext['switchToHttp']> {\n    throw new Error('Context does not support HTTP context');\n  }\n\n  switchToWs(): ReturnType<ExecutionContext['switchToWs']> {\n    throw new Error('Context does not support WebSocket context');\n  }\n\n  getType<TContext extends string = string>(): TContext {\n    return 'temporal' as TContext;\n  }\n}\n\ntype Type<T = unknown> = new (...args: unknown[]) => T;\n\n","import { ParamData } from '@nestjs/common';\nimport { ParamsFactory } from '@nestjs/core/helpers/external-context-creator';\nimport { TemporalParamType } from './temporal-enums';\nimport { TemporalExecutionContext } from './core/temporal-execution-context';\n\nexport class TemporalParamsFactory implements ParamsFactory {\n  constructor(\n    private readonly instance: object,\n    private readonly handler: Function,\n  ) {}\n\n  exchangeKeyForValue(\n    type: number,\n    data: ParamData,\n    args: unknown[],\n  ): unknown {\n    switch (type) {\n      case TemporalParamType.PAYLOAD:\n        return data && args[0] && typeof args[0] === 'object'\n          ? (args[0] as Record<string, unknown>)[data as string]\n          : args[0];\n\n      case TemporalParamType.CONTEXT:\n        return new TemporalExecutionContext(this.instance, this.handler, args);\n\n      default:\n        return null;\n    }\n  }\n}\n\n","import {\n  Inject,\n  Injectable,\n  Logger,\n  OnApplicationBootstrap,\n  OnModuleDestroy,\n  OnModuleInit,\n} from \"@nestjs/common\";\nimport {\n  DiscoveryService,\n  MetadataScanner,\n  ExternalContextCreator,\n} from \"@nestjs/core\";\nimport { InstanceWrapper } from \"@nestjs/core/injector/instance-wrapper\";\nimport { lastValueFrom, isObservable } from \"rxjs\";\nimport {\n  NativeConnection,\n  NativeConnectionOptions,\n  Runtime,\n  RuntimeOptions,\n  Worker,\n  WorkerOptions,\n} from \"@temporalio/worker\";\nimport { TemporalMetadataAccessor } from \"./temporal-metadata.accessors\";\nimport {\n  TEMPORAL_MODULE_OPTIONS_TOKEN,\n  type TemporalModuleOptions,\n} from \"./temporal.module-definition\";\nimport {\n  TEMPORAL_ARGS_METADATA,\n  TEMPORAL_CONTEXT_METADATA,\n} from \"./constants/temporal.constants\";\nimport { TemporalParamsFactory } from \"./temporal-params.factory\";\nimport { Context } from \"@temporalio/activity\";\n\n/**\n * TemporalExplorer is responsible for discovering and registering Temporal activities\n * and creating the Temporal worker instance.\n *\n * It scans the NestJS application for classes decorated with @Activities() and methods\n * decorated with @Activity(), then registers them with the Temporal worker.\n */\n@Injectable()\nexport class TemporalExplorer\n  implements OnModuleInit, OnModuleDestroy, OnApplicationBootstrap\n{\n  @Inject(TEMPORAL_MODULE_OPTIONS_TOKEN)\n  private readonly options!: TemporalModuleOptions;\n  private readonly logger = new Logger(TemporalExplorer.name);\n  private worker?: Worker;\n  private workerRunPromise?: Promise<void>;\n\n  constructor(\n    private readonly discoveryService: DiscoveryService,\n    private readonly metadataAccessor: TemporalMetadataAccessor,\n    private readonly metadataScanner: MetadataScanner,\n    private readonly externalContextCreator: ExternalContextCreator,\n  ) {}\n\n  /**\n   * Initializes the module by exploring and setting up the Temporal worker.\n   */\n  async onModuleInit(): Promise<void> {\n    await this.explore();\n  }\n\n  /**\n   * Shuts down the Temporal worker when the module is destroyed.\n   */\n  async onModuleDestroy(): Promise<void> {\n    if (!this.worker) {\n      return;\n    }\n\n    try {\n      this.worker.shutdown();\n      if (this.workerRunPromise) {\n        await this.worker.run();\n      }\n    } catch (err: unknown) {\n      this.logger.warn(\"Temporal workers were not cleanly shutdown.\", {\n        err: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n\n  /**\n   * Starts the Temporal worker when the application is fully bootstrapped.\n   */\n  onApplicationBootstrap(): void {\n    if (this.worker) {\n      this.workerRunPromise = this.worker.run();\n    }\n  }\n\n  /**\n   * Explores the application for Temporal activities and creates the worker.\n   * This method is called during module initialization.\n   */\n  async explore(): Promise<void> {\n    const workerConfig = this.getWorkerConfigOptions();\n    const runTimeOptions = this.getRuntimeOptions();\n    const connectionOptions = this.getNativeConnectionOptions();\n\n    // Worker must have a taskQueue configured\n    if (!workerConfig.taskQueue) {\n      this.logger.warn(\n        \"Temporal worker configuration missing taskQueue. Worker will not be created.\",\n      );\n      return;\n    }\n\n    this.findDuplicateActivityMethods();\n\n    const activitiesFunc = await this.handleActivities();\n\n    if (runTimeOptions) {\n      this.logger.verbose(\"Instantiating a new Runtime object\");\n      Runtime.install(runTimeOptions);\n    }\n\n    const workerOptions: Partial<WorkerOptions> = {\n      activities: activitiesFunc,\n    };\n\n    if (connectionOptions) {\n      this.logger.verbose(\"Connecting to the Temporal server\");\n      workerOptions.connection =\n        await NativeConnection.connect(connectionOptions);\n    }\n\n    this.logger.verbose(\"Creating a new Worker\");\n    this.worker = await Worker.create({\n      ...workerConfig,\n      ...workerOptions,\n    });\n  }\n\n  /**\n   * Gets the worker configuration options.\n   */\n  getWorkerConfigOptions(): WorkerOptions {\n    return this.options.workerOptions;\n  }\n\n  /**\n   * Gets the native connection options for the Temporal server.\n   */\n  getNativeConnectionOptions(): NativeConnectionOptions | undefined {\n    return this.options.connectionOptions;\n  }\n\n  /**\n   * Gets the runtime options for the Temporal worker.\n   */\n  getRuntimeOptions(): RuntimeOptions | undefined {\n    return this.options.runtimeOptions;\n  }\n\n  /**\n   * Gets the activity classes to register with this worker.\n   * If undefined, all discovered activities will be registered.\n   * Can be either class constructors or InstanceWrappers.\n   */\n  private getActivityClasses(): (InstanceWrapper | Function)[] | undefined {\n    return this.options.activityClasses as\n      | (InstanceWrapper | Function)[]\n      | undefined;\n  }\n\n  /**\n   * Validates that activity method names are unique across all activity classes.\n   * Throws an error if duplicates are found and errorOnDuplicateActivities is enabled.\n   */\n  findDuplicateActivityMethods(): void {\n    if (!this.options.errorOnDuplicateActivities) {\n      return;\n    }\n\n    const activityClasses = this.getActivityClasses();\n    if (!activityClasses || activityClasses.length === 0) {\n      return;\n    }\n\n    const activityMethods: Record<string, string[]> = {};\n\n    activityClasses.forEach((classOrWrapper: InstanceWrapper | Function) => {\n      // Handle both InstanceWrapper and class constructor\n      const wrapper = classOrWrapper as InstanceWrapper;\n      const instance =\n        \"instance\" in wrapper && wrapper.instance\n          ? wrapper.instance\n          : new (classOrWrapper as new () => unknown)();\n\n      this.metadataScanner\n        .getAllMethodNames(Object.getPrototypeOf(instance))\n        .forEach((key) => {\n          if (this.metadataAccessor.isActivity(instance[key])) {\n            activityMethods[key] = (activityMethods[key] || []).concat(\n              instance.constructor.name,\n            );\n          }\n        });\n    });\n\n    const violations = Object.entries(activityMethods).filter(\n      ([, classes]) => classes.length > 1,\n    );\n\n    if (violations.length > 0) {\n      const message = `Activity names must be unique across all Activity classes. Identified activities with conflicting names: ${JSON.stringify(\n        Object.fromEntries(violations),\n      )}`;\n      this.logger.error(message);\n      throw new Error(message);\n    }\n  }\n\n  /**\n   * Discovers and binds all activity methods from classes decorated with @Activities().\n   * Returns an object mapping activity method names to their bound implementations.\n   */\n  async handleActivities(): Promise<Record<string, Function>> {\n    const activitiesMethod: Record<string, Function> = {};\n\n    const activityClasses = this.getActivityClasses();\n    const activities: InstanceWrapper[] = this.discoveryService\n      .getProviders()\n      .filter(\n        (wrapper: InstanceWrapper) =>\n          this.metadataAccessor.isActivities(\n            !wrapper.metatype || wrapper.inject\n              ? wrapper.instance?.constructor\n              : wrapper.metatype,\n          ) &&\n          (!activityClasses ||\n            activityClasses.some(\n              (cls) =>\n                cls === wrapper.metatype ||\n                (cls instanceof Object &&\n                  \"metatype\" in cls &&\n                  (cls as InstanceWrapper).metatype === wrapper.metatype),\n            )),\n      );\n\n    activities.forEach((wrapper: InstanceWrapper) => {\n      const { instance } = wrapper;\n      const isRequestScoped = !wrapper.isDependencyTreeStatic();\n\n      this.metadataScanner.scanFromPrototype(\n        instance,\n        Object.getPrototypeOf(instance),\n        (key: string) => {\n          if (this.metadataAccessor.isActivity(instance[key])) {\n            if (isRequestScoped) {\n              this.logger.warn(\n                `Request-scoped activities are not yet fully supported. Activity \"${key}\" from class \"${instance.constructor.name}\" may not work correctly.`,\n              );\n            }\n            const paramsFactory = new TemporalParamsFactory(\n              instance,\n              instance[key],\n            );\n\n            const handler = this.externalContextCreator.create(\n              instance,\n              instance[key],\n              key,\n              TEMPORAL_ARGS_METADATA,\n              paramsFactory,\n              undefined,\n              undefined,\n              undefined,\n              \"temporal\",\n            );\n\n            activitiesMethod[key] = async (...args: unknown[]) => {\n              const result = handler(...args, Context.current().info);\n\n              return isObservable(result)\n                ? await lastValueFrom(result)\n                : await result;\n            };\n          }\n        },\n      );\n    });\n    return activitiesMethod;\n  }\n}\n","export function getQueueToken(name?: string): string {\n  return name ? `TemporalQueue_${name}` : 'TemporalQueue_default';\n}\n\nexport function getAsyncQueueToken(name?: string): string {\n  return name ? `TemporalAsyncQueue_${name}` : 'TemporalAsyncQueue_default';\n}\n","import { OnApplicationShutdown } from '@nestjs/common';\nimport { WorkflowClient, WorkflowClientOptions } from '@temporalio/client';\n\n/**\n * Assigns an application shutdown hook to a WorkflowClient to ensure\n * the connection is properly closed when the application shuts down.\n *\n * @param client - The WorkflowClient instance\n * @returns The client with shutdown hook assigned\n */\nexport function assignOnAppShutdownHook(\n  client: WorkflowClient,\n): WorkflowClient {\n  (client as unknown as OnApplicationShutdown).onApplicationShutdown =\n    async () => {\n      try {\n        await client.connection?.close();\n      } catch (reason: unknown) {\n        const errorMessage =\n          reason instanceof Error ? reason.message : String(reason);\n        console.error(\n          `Temporal client connection was not cleanly closed: ${errorMessage}`,\n        );\n      }\n    };\n  return client;\n}\n\n/**\n * Creates a new WorkflowClient instance with application shutdown hook.\n *\n * @param options - Optional WorkflowClient configuration options\n * @returns A WorkflowClient instance with shutdown hook\n */\nexport function getWorkflowClient(\n  options?: WorkflowClientOptions,\n): WorkflowClient {\n  const client = new WorkflowClient(options);\n  return assignOnAppShutdownHook(client);\n}\n","import { Provider } from '@nestjs/common';\nimport { WorkflowClientOptions } from '@temporalio/client';\n\nimport { SharedWorkflowClientOptions } from '../interfaces/shared-workflow-client-options.interface';\nimport {\n  SharedConnectionAsyncConfiguration,\n  SharedRuntimeAsyncConfiguration,\n  SharedWorkerAsyncConfiguration,\n} from '../interfaces';\nimport { getWorkflowClient } from './client.util';\nimport { getAsyncQueueToken, getQueueToken } from './get-queue-token.util';\nimport { DiscoveryModule } from '@nestjs/core';\n\nexport function createAsyncProvider(\n  provide: string,\n  options?:\n    | SharedWorkerAsyncConfiguration\n    | SharedRuntimeAsyncConfiguration\n    | SharedConnectionAsyncConfiguration\n    | SharedWorkflowClientOptions,\n): Provider {\n  if (options?.useFactory) {\n    const { useFactory, inject } = options;\n    return {\n      provide,\n      useFactory,\n      inject: inject || [],\n    };\n  }\n  return {\n    provide,\n    useValue: options?.useValue || null,\n  };\n}\n\nexport function createClientAsyncProvider(\n  asyncOptions: SharedWorkflowClientOptions,\n): Provider[] {\n  const name = asyncOptions.name ? asyncOptions.name : undefined;\n  const optionsProvide = getAsyncQueueToken(name);\n  const clientProvide = getQueueToken(name);\n  return [\n    createAsyncProvider(optionsProvide, asyncOptions),\n    {\n      provide: clientProvide,\n      useFactory: (options?: WorkflowClientOptions) =>\n        getWorkflowClient(options),\n      inject: [optionsProvide],\n    },\n    DiscoveryModule,\n  ];\n}\n","import { DynamicModule, Module } from \"@nestjs/common\";\nimport { DiscoveryModule } from \"@nestjs/core\";\n\nimport { TemporalMetadataAccessor } from \"./temporal-metadata.accessors\";\nimport { TemporalExplorer } from \"./temporal.explorer\";\nimport {\n  SharedWorkflowClientOptions,\n  TemporalModuleOptions,\n} from \"./interfaces\";\nimport { createClientProviders } from \"./temporal.providers\";\nimport { createClientAsyncProvider } from \"./utils\";\nimport {\n  ConfigurableModuleClass,\n  TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE,\n} from \"./temporal.module-definition\";\n\n/**\n * TemporalModule provides integration between NestJS and Temporal workflow orchestration.\n *\n * Use registerWorker() or registerWorkerAsync() to register Temporal workers that execute activities.\n * Use registerClient() or registerClientAsync() to register Temporal clients for starting workflows.\n */\n@Module({})\nexport class TemporalModule extends ConfigurableModuleClass {\n  /**\n   * Registers a Temporal worker asynchronously.\n   * Useful when configuration depends on other async providers (e.g., ConfigService).\n   *\n   * @param options - Async worker configuration options\n   * @returns Dynamic module configuration\n   */\n  static registerWorkerAsync(\n    options: typeof TEMPORAL_MODULE_ASYNC_OPTIONS_TYPE,\n  ): DynamicModule {\n    const superDynamicModule = super.registerWorkerAsync(options);\n    superDynamicModule.imports?.push(DiscoveryModule);\n    superDynamicModule.providers?.push(\n      TemporalExplorer,\n      TemporalMetadataAccessor,\n    );\n    superDynamicModule.exports?.push(\n      TemporalExplorer,\n      TemporalMetadataAccessor,\n      DiscoveryModule,\n    );\n\n    return {\n      ...superDynamicModule,\n      exports: [DiscoveryModule],\n    };\n  }\n\n  /**\n   * Registers a Temporal WorkflowClient asynchronously.\n   * Useful when configuration depends on other async providers (e.g., ConfigService).\n   *\n   * @param asyncSharedWorkflowClientOptions - Async client configuration options\n   * @returns Dynamic module configuration\n   */\n  static registerClientAsync(\n    asyncSharedWorkflowClientOptions: SharedWorkflowClientOptions,\n  ): DynamicModule {\n    const providers = createClientAsyncProvider(\n      asyncSharedWorkflowClientOptions,\n    );\n\n    return {\n      global: true,\n      module: TemporalModule,\n      providers,\n      exports: providers,\n    };\n  }\n}\n","import { Scope, SetMetadata } from '@nestjs/common';\nimport { SCOPE_OPTIONS_METADATA } from '@nestjs/common/constants';\nimport { ActivityOptions } from '@temporalio/workflow';\n\nimport { TEMPORAL_MODULE_ACTIVITIES } from '../constants/temporal.constants';\n\n/**\n * Options for the @Activities() decorator.\n */\nexport interface ActivitiesOptions extends ActivityOptions {\n  /**\n   * Specifies the name of the queue to subscribe to.\n   */\n  name?: string;\n  /**\n   * Specifies the lifetime of an injected Activities class.\n   */\n  scope?: Scope;\n}\n\n/**\n * Marks a class as containing Temporal activities.\n * Methods within this class decorated with @Activity() will be registered as Temporal activities.\n *\n * @param queueNameOrOptions - Optional queue name (string) or options object\n * @returns Class decorator\n *\n * @example\n * ```typescript\n * @Injectable()\n * @Activities()\n * export class MyActivities {\n *   @Activity()\n *   async doSomething() { }\n * }\n * ```\n */\nexport function Activities(): ClassDecorator;\nexport function Activities(queueName: string): ClassDecorator;\nexport function Activities(\n  activitiesOptions: ActivitiesOptions,\n): ClassDecorator;\nexport function Activities(\n  queueNameOrOptions?: string | ActivitiesOptions,\n): ClassDecorator {\n  const options =\n    queueNameOrOptions && typeof queueNameOrOptions === 'object'\n      ? queueNameOrOptions\n      : { name: queueNameOrOptions };\n  return (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_ACTIVITIES, options)(target);\n  };\n}\n","import { SetMetadata } from '@nestjs/common';\n\nimport { TEMPORAL_MODULE_ACTIVITY } from '../constants/temporal.constants';\n\n/**\n * Options for the @Activity() decorator.\n */\nexport interface ActivityOptions {\n  /**\n   * Custom name for the activity. If not provided, the method name is used.\n   */\n  name?: string;\n}\n\n/**\n * Marks a method as a Temporal activity.\n * The method must be within a class decorated with @Activities().\n *\n * @param nameOrOptions - Optional activity name (string) or options object\n * @returns Method decorator\n *\n * @example\n * ```typescript\n * @Activity()\n * async processOrder(orderId: string) { }\n *\n * @Activity('custom-activity-name')\n * async anotherActivity() { }\n * ```\n */\nexport function Activity(): MethodDecorator;\nexport function Activity(name: string): MethodDecorator;\nexport function Activity(options: ActivityOptions): MethodDecorator;\nexport function Activity(\n  nameOrOptions?: string | ActivityOptions,\n): MethodDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n\n  return SetMetadata(TEMPORAL_MODULE_ACTIVITY, options || {});\n}\n","import { Inject } from '@nestjs/common';\n\nimport { getQueueToken } from '../utils';\n\n/**\n * Injects a Temporal WorkflowClient instance.\n * Use this decorator to inject the client registered via TemporalModule.registerClient().\n *\n * @param name - Optional name of the client instance (for named clients)\n * @returns Parameter decorator for dependency injection\n *\n * @example\n * ```typescript\n * constructor(@InjectTemporalClient() private client: WorkflowClient) {}\n * ```\n */\nexport const InjectTemporalClient = (name?: string): ParameterDecorator =>\n  Inject(getQueueToken(name));\n","import { SetMetadata } from '@nestjs/common';\n\nimport { TEMPORAL_MODULE_WORKFLOW_METHOD } from '../constants/temporal.constants';\n\nexport interface WorkflowMethodOptions {\n  name?: string;\n}\n\nexport function WorkflowMethod(): MethodDecorator;\nexport function WorkflowMethod(name: string): MethodDecorator;\nexport function WorkflowMethod(options: WorkflowMethodOptions): MethodDecorator;\nexport function WorkflowMethod(\n  nameOrOptions?: string | WorkflowMethodOptions,\n): MethodDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n\n  return SetMetadata(TEMPORAL_MODULE_WORKFLOW_METHOD, options || {});\n}\n","import { Scope, SetMetadata } from '@nestjs/common';\nimport { SCOPE_OPTIONS_METADATA } from '@nestjs/common/constants';\n\nimport { TEMPORAL_MODULE_WORKFLOW } from '../constants/temporal.constants';\n\nexport interface WorkflowsOptions {\n  /**\n   * Specifies the name of the queue to subscribe to.\n   */\n  name?: string;\n  /**\n   * Specifies the lifetime of an injected Processor.\n   */\n  scope?: Scope;\n}\n\nexport function Workflows(): ClassDecorator;\nexport function Workflows(name: string): ClassDecorator;\nexport function Workflows(options: WorkflowsOptions): ClassDecorator;\nexport function Workflows(\n  nameOrOptions?: string | WorkflowsOptions,\n): ClassDecorator {\n  const options =\n    nameOrOptions && typeof nameOrOptions === 'object'\n      ? nameOrOptions\n      : { name: nameOrOptions };\n  return (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_WORKFLOW, options)(target);\n  };\n}\n","import { createParamDecorator, ExecutionContext } from \"@nestjs/common\";\n\nexport const ActivityPayload = () => createParamDecorator((_, ctx: ExecutionContext) => {\n  return ctx.getArgByIndex(0);\n});"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@globalart/nestjs-temporal",
   "description": "Temporal integration for NestJS",
-  "version": "1.1.6",
+  "version": "1.2.2",
   "type": "module",
   "main": "dist/index.mjs",
   "module": "dist/index.mjs",
@@ -45,18 +45,18 @@
     "publish:npm": "release-it --config ../../.release-it.json"
   },
   "dependencies": {
-    "@nestjs/common": "11.1.13",
-    "@nestjs/core": "11.1.13",
-    "@temporalio/activity": "^1.8.3",
-    "@temporalio/client": "^1.8.3",
-    "@temporalio/common": "^1.8.3",
-    "@temporalio/worker": "^1.8.3",
-    "@temporalio/workflow": "^1.8.3",
+    "@nestjs/common": "11.1.14",
+    "@nestjs/core": "11.1.14",
+    "@temporalio/activity": "^1.15.0",
+    "@temporalio/client": "^1.15.0",
+    "@temporalio/common": "^1.15.0",
+    "@temporalio/worker": "^1.15.0",
+    "@temporalio/workflow": "^1.15.0",
     "lodash": "^4.17.23",
     "rxjs": "^7.8.2"
   },
   "devDependencies": {
-    "@types/node": "25.2.1",
+    "@types/node": "25.3.0",
     "reflect-metadata": "^0.2.2",
     "release-it": "19.2.4",
     "tsdown": "0.20.3",