@globalart/nestjs-temporal 2.4.1 → 2.5.0

package/dist/index.cjs

@@ -276,6 +276,25 @@ function getAsyncQueueToken(name) {
 	return name ? `TemporalAsyncQueue_${name}` : "TemporalAsyncQueue_default";
 }
 //#endregion
+//#region src/core/temporal-workflow.service.ts
+var TemporalWorkflowService = class extends _temporalio_client.WorkflowClient {
+	constructor(options) {
+		super(options);
+	}
+	async describeWorkflow(workflowId) {
+		const handle = this.getHandle(workflowId);
+		try {
+			return {
+				info: await handle.describe(),
+				handle
+			};
+		} catch (error) {
+			if (error instanceof _temporalio_client.WorkflowNotFoundError) return null;
+			throw error;
+		}
+	}
+};
+//#endregion
 //#region src/utils/client.util.ts
 /**
 * Assigns an application shutdown hook to a WorkflowClient to ensure
@@ -302,7 +321,7 @@ function assignOnAppShutdownHook(client) {
 * @returns A WorkflowClient instance with shutdown hook
 */
 function getWorkflowClient(options) {
-	return assignOnAppShutdownHook(new _temporalio_client.WorkflowClient(options));
+	return assignOnAppShutdownHook(new TemporalWorkflowService(options));
 }
 //#endregion
 //#region src/utils/provider.util.ts
@@ -455,5 +474,6 @@ Object.defineProperty(exports, "TemporalModule", {
 		return TemporalModule;
 	}
 });
+exports.TemporalWorkflowService = TemporalWorkflowService;
 
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["ConfigurableModuleBuilder","Logger","NativeConnection","Worker","Context","WorkflowClient","DiscoveryModule","DiscoveryModule","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/inject-temporal-client.decorator.ts","../src/decorators/context.decorator.ts"],"sourcesContent":["export const TEMPORAL_MODULE_ACTIVITIES = \"_temporal_module_activities\";\nexport const TEMPORAL_MODULE_ACTIVITY = \"_temporal_module_activity\";\n\nexport const TEMPORAL_ARGS_METADATA = \"_temporal_module_args\";\nexport const TEMPORAL_CONTEXT_METADATA = \"_temporal_module_context\";\n","import { Injectable, Type } from \"@nestjs/common\";\nimport { Reflector } from \"@nestjs/core\";\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\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() and @Activity() 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}\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 workers?: Worker[];\n  private workerRunPromises?: 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.workers) {\n      return;\n    }\n\n    try {\n      this.workers.forEach((worker) => worker.shutdown());\n      if (this.workerRunPromises) {\n        await Promise.all(this.workerRunPromises);\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.workers) {\n      this.workerRunPromises = this.workers.map((worker) => 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.some((config) => config.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 sharedWorkerOptions: Partial<WorkerOptions> = {\n      activities: activitiesFunc,\n    };\n\n    if (connectionOptions) {\n      this.logger.verbose(\"Connecting to the Temporal server\");\n      sharedWorkerOptions.connection =\n        await NativeConnection.connect(connectionOptions);\n    }\n\n    this.logger.verbose(\"Creating a new Worker\");\n    this.workers = await Promise.all(\n      workerConfig.map(({ activities: configActivities, ...config }) =>\n        Worker.create({\n          ...sharedWorkerOptions,\n          ...config,\n          activities: { ...(configActivities as Record<string, Function>), ...activitiesFunc },\n        }),\n      ),\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 ctx = Context.current();\n              const result = handler(...args, ctx.info);\n\n              const interval = setInterval(() => {\n                ctx.heartbeat(crypto.randomUUID());\n              }, 5000);\n\n              try {\n                return isObservable(result)\n                  ? await lastValueFrom(result)\n                  : await result;\n              } finally {\n                clearInterval(interval);\n              }\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\";\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\n} 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 * 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 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 const Activities =\n  (options?: ActivitiesOptions): ClassDecorator =>\n  (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_ACTIVITIES, options ?? {})(target);\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 const Activity = (options?: ActivityOptions): MethodDecorator =>\n  SetMetadata(TEMPORAL_MODULE_ACTIVITY, options || {});\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 { createParamDecorator, ExecutionContext } from \"@nestjs/common\";\n\nexport const ActivityContext = () =>\n  createParamDecorator((_, ctx: ExecutionContext) => {\n    return ctx.getArgByIndex(1);\n  });\n\nexport const ActivityPayload = () =>\n  createParamDecorator((_, ctx: ExecutionContext) => {\n    return ctx.getArgByIndex(0);\n  });\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["ConfigurableModuleBuilder","Logger","NativeConnection","Worker","Context","WorkflowClient","WorkflowNotFoundError","DiscoveryModule","DiscoveryModule","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/core/temporal-workflow.service.ts","../src/utils/client.util.ts","../src/utils/provider.util.ts","../src/temporal.module.ts","../src/decorators/activities.decorator.ts","../src/decorators/inject-temporal-client.decorator.ts","../src/decorators/context.decorator.ts"],"sourcesContent":["export const TEMPORAL_MODULE_ACTIVITIES = \"_temporal_module_activities\";\nexport const TEMPORAL_MODULE_ACTIVITY = \"_temporal_module_activity\";\n\nexport const TEMPORAL_ARGS_METADATA = \"_temporal_module_args\";\nexport const TEMPORAL_CONTEXT_METADATA = \"_temporal_module_context\";\n","import { Injectable, Type } from \"@nestjs/common\";\nimport { Reflector } from \"@nestjs/core\";\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\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() and @Activity() 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}\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 workers?: Worker[];\n  private workerRunPromises?: 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.workers) {\n      return;\n    }\n\n    try {\n      this.workers.forEach((worker) => worker.shutdown());\n      if (this.workerRunPromises) {\n        await Promise.all(this.workerRunPromises);\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.workers) {\n      this.workerRunPromises = this.workers.map((worker) => 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.some((config) => config.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 sharedWorkerOptions: Partial<WorkerOptions> = {\n      activities: activitiesFunc,\n    };\n\n    if (connectionOptions) {\n      this.logger.verbose(\"Connecting to the Temporal server\");\n      sharedWorkerOptions.connection =\n        await NativeConnection.connect(connectionOptions);\n    }\n\n    this.logger.verbose(\"Creating a new Worker\");\n    this.workers = await Promise.all(\n      workerConfig.map(({ activities: configActivities, ...config }) =>\n        Worker.create({\n          ...sharedWorkerOptions,\n          ...config,\n          activities: { ...(configActivities as Record<string, Function>), ...activitiesFunc },\n        }),\n      ),\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 ctx = Context.current();\n              const result = handler(...args, ctx.info);\n\n              const interval = setInterval(() => {\n                ctx.heartbeat(crypto.randomUUID());\n              }, 5000);\n\n              try {\n                return isObservable(result)\n                  ? await lastValueFrom(result)\n                  : await result;\n              } finally {\n                clearInterval(interval);\n              }\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 { Injectable } from \"@nestjs/common\";\nimport { WorkflowClient, WorkflowClientOptions, WorkflowExecutionDescription, WorkflowHandle, WorkflowNotFoundError } from \"@temporalio/client\";\n\nexport class TemporalWorkflowService extends WorkflowClient {\n  constructor(options?: WorkflowClientOptions) {\n    super(options);\n  }\n\n  public async describeWorkflow(workflowId: string): Promise<{ info: WorkflowExecutionDescription, handle: WorkflowHandle } | null> {\n    const handle = this.getHandle(workflowId);\n\n    try {\n      return {\n        info: await handle.describe(),\n        handle,\n      };\n    } catch (error) {\n      if (error instanceof WorkflowNotFoundError) {\n        return null;\n      }\n      throw error;\n    }\n  }\n}","import { OnApplicationShutdown } from '@nestjs/common';\nimport { WorkflowClient, WorkflowClientOptions } from '@temporalio/client';\nimport { TemporalWorkflowService } from '../core';\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 TemporalWorkflowService(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\";\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\n} 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 * 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 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 const Activities =\n  (options?: ActivitiesOptions): ClassDecorator =>\n  (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_ACTIVITIES, options ?? {})(target);\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 const Activity = (options?: ActivityOptions): MethodDecorator =>\n  SetMetadata(TEMPORAL_MODULE_ACTIVITY, options || {});\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 { createParamDecorator, ExecutionContext } from \"@nestjs/common\";\n\nexport const ActivityContext = () =>\n  createParamDecorator((_, ctx: ExecutionContext) => {\n    return ctx.getArgByIndex(1);\n  });\n\nexport const ActivityPayload = () =>\n  createParamDecorator((_, ctx: ExecutionContext) => {\n    return ctx.getArgByIndex(0);\n  });\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as _$_nestjs_common0 from "@nestjs/common";
 import { DynamicModule, ExecutionContext, FactoryProvider, ModuleMetadata, OnApplicationBootstrap, OnModuleDestroy, OnModuleInit, Scope, Type } from "@nestjs/common";
-import { WorkflowClientOptions } from "@temporalio/client";
+import { WorkflowClient, WorkflowClientOptions, WorkflowExecutionDescription, WorkflowHandle } from "@temporalio/client";
 import { NativeConnectionOptions, RuntimeOptions, WorkerOptions } from "@temporalio/worker";
 import { DiscoveryService, ExternalContextCreator, MetadataScanner, Reflector } from "@nestjs/core";
 import { Info } from "@temporalio/activity";
@@ -244,5 +244,14 @@ declare class TemporalExecutionContext implements ExecutionContext {
 }
 type Type$1<T = unknown> = new (...args: unknown[]) => T;
 //#endregion
-export { Activities, ActivitiesOptions, Activity, ActivityContext, ActivityOptions, ActivityPayload, InjectTemporalClient, TemporalExecutionContext, TemporalExplorer, TemporalModule };
+//#region src/core/temporal-workflow.service.d.ts
+declare class TemporalWorkflowService extends WorkflowClient {
+  constructor(options?: WorkflowClientOptions);
+  describeWorkflow(workflowId: string): Promise<{
+    info: WorkflowExecutionDescription;
+    handle: WorkflowHandle;
+  } | null>;
+}
+//#endregion
+export { Activities, ActivitiesOptions, Activity, ActivityContext, ActivityOptions, ActivityPayload, InjectTemporalClient, TemporalExecutionContext, TemporalExplorer, TemporalModule, TemporalWorkflowService };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -3,7 +3,7 @@ import { DynamicModule, ExecutionContext, FactoryProvider, ModuleMetadata, OnApp
 import { DiscoveryService, ExternalContextCreator, MetadataScanner, Reflector } from "@nestjs/core";
 import { NativeConnectionOptions, RuntimeOptions, WorkerOptions } from "@temporalio/worker";
 import { Info } from "@temporalio/activity";
-import { WorkflowClientOptions } from "@temporalio/client";
+import { WorkflowClient, WorkflowClientOptions, WorkflowExecutionDescription, WorkflowHandle } from "@temporalio/client";
 
 //#region src/interfaces/shared-workflow-client-options.interface.d.ts
 interface SharedWorkflowClientOptionsFactory {
@@ -244,5 +244,14 @@ declare class TemporalExecutionContext implements ExecutionContext {
 }
 type Type$1<T = unknown> = new (...args: unknown[]) => T;
 //#endregion
-export { Activities, ActivitiesOptions, Activity, ActivityContext, ActivityOptions, ActivityPayload, InjectTemporalClient, TemporalExecutionContext, TemporalExplorer, TemporalModule };
+//#region src/core/temporal-workflow.service.d.ts
+declare class TemporalWorkflowService extends WorkflowClient {
+  constructor(options?: WorkflowClientOptions);
+  describeWorkflow(workflowId: string): Promise<{
+    info: WorkflowExecutionDescription;
+    handle: WorkflowHandle;
+  } | null>;
+}
+//#endregion
+export { Activities, ActivitiesOptions, Activity, ActivityContext, ActivityOptions, ActivityPayload, InjectTemporalClient, TemporalExecutionContext, TemporalExplorer, TemporalModule, TemporalWorkflowService };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -3,7 +3,7 @@ import { DiscoveryModule, DiscoveryService, ExternalContextCreator, MetadataScan
 import { isObservable, lastValueFrom } from "rxjs";
 import { NativeConnection, Runtime, Worker } from "@temporalio/worker";
 import { Context } from "@temporalio/activity";
-import { WorkflowClient } from "@temporalio/client";
+import { WorkflowClient, WorkflowNotFoundError } from "@temporalio/client";
 import { SCOPE_OPTIONS_METADATA } from "@nestjs/common/constants.js";
 //#region src/constants/temporal.constants.ts
 const TEMPORAL_MODULE_ACTIVITIES = "_temporal_module_activities";
@@ -275,6 +275,25 @@ function getAsyncQueueToken(name) {
 	return name ? `TemporalAsyncQueue_${name}` : "TemporalAsyncQueue_default";
 }
 //#endregion
+//#region src/core/temporal-workflow.service.ts
+var TemporalWorkflowService = class extends WorkflowClient {
+	constructor(options) {
+		super(options);
+	}
+	async describeWorkflow(workflowId) {
+		const handle = this.getHandle(workflowId);
+		try {
+			return {
+				info: await handle.describe(),
+				handle
+			};
+		} catch (error) {
+			if (error instanceof WorkflowNotFoundError) return null;
+			throw error;
+		}
+	}
+};
+//#endregion
 //#region src/utils/client.util.ts
 /**
 * Assigns an application shutdown hook to a WorkflowClient to ensure
@@ -301,7 +320,7 @@ function assignOnAppShutdownHook(client) {
 * @returns A WorkflowClient instance with shutdown hook
 */
 function getWorkflowClient(options) {
-	return assignOnAppShutdownHook(new WorkflowClient(options));
+	return assignOnAppShutdownHook(new TemporalWorkflowService(options));
 }
 //#endregion
 //#region src/utils/provider.util.ts
@@ -436,6 +455,6 @@ const ActivityPayload = () => createParamDecorator((_, ctx) => {
 	return ctx.getArgByIndex(0);
 });
 //#endregion
-export { Activities, Activity, ActivityContext, ActivityPayload, InjectTemporalClient, TemporalExecutionContext, TemporalExplorer, TemporalModule };
+export { Activities, Activity, ActivityContext, ActivityPayload, InjectTemporalClient, TemporalExecutionContext, TemporalExplorer, TemporalModule, TemporalWorkflowService };
 
 //# sourceMappingURL=index.mjs.map

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/inject-temporal-client.decorator.ts","../src/decorators/context.decorator.ts"],"sourcesContent":["export const TEMPORAL_MODULE_ACTIVITIES = \"_temporal_module_activities\";\nexport const TEMPORAL_MODULE_ACTIVITY = \"_temporal_module_activity\";\n\nexport const TEMPORAL_ARGS_METADATA = \"_temporal_module_args\";\nexport const TEMPORAL_CONTEXT_METADATA = \"_temporal_module_context\";\n","import { Injectable, Type } from \"@nestjs/common\";\nimport { Reflector } from \"@nestjs/core\";\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\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() and @Activity() 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}\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 workers?: Worker[];\n  private workerRunPromises?: 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.workers) {\n      return;\n    }\n\n    try {\n      this.workers.forEach((worker) => worker.shutdown());\n      if (this.workerRunPromises) {\n        await Promise.all(this.workerRunPromises);\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.workers) {\n      this.workerRunPromises = this.workers.map((worker) => 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.some((config) => config.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 sharedWorkerOptions: Partial<WorkerOptions> = {\n      activities: activitiesFunc,\n    };\n\n    if (connectionOptions) {\n      this.logger.verbose(\"Connecting to the Temporal server\");\n      sharedWorkerOptions.connection =\n        await NativeConnection.connect(connectionOptions);\n    }\n\n    this.logger.verbose(\"Creating a new Worker\");\n    this.workers = await Promise.all(\n      workerConfig.map(({ activities: configActivities, ...config }) =>\n        Worker.create({\n          ...sharedWorkerOptions,\n          ...config,\n          activities: { ...(configActivities as Record<string, Function>), ...activitiesFunc },\n        }),\n      ),\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 ctx = Context.current();\n              const result = handler(...args, ctx.info);\n\n              const interval = setInterval(() => {\n                ctx.heartbeat(crypto.randomUUID());\n              }, 5000);\n\n              try {\n                return isObservable(result)\n                  ? await lastValueFrom(result)\n                  : await result;\n              } finally {\n                clearInterval(interval);\n              }\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\";\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\n} 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 * 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 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 const Activities =\n  (options?: ActivitiesOptions): ClassDecorator =>\n  (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_ACTIVITIES, options ?? {})(target);\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 const Activity = (options?: ActivityOptions): MethodDecorator =>\n  SetMetadata(TEMPORAL_MODULE_ACTIVITY, options || {});\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 { createParamDecorator, ExecutionContext } from \"@nestjs/common\";\n\nexport const ActivityContext = () =>\n  createParamDecorator((_, ctx: ExecutionContext) => {\n    return ctx.getArgByIndex(1);\n  });\n\nexport const ActivityPayload = () =>\n  createParamDecorator((_, ctx: ExecutionContext) => {\n    return ctx.getArgByIndex(0);\n  });\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/core/temporal-workflow.service.ts","../src/utils/client.util.ts","../src/utils/provider.util.ts","../src/temporal.module.ts","../src/decorators/activities.decorator.ts","../src/decorators/inject-temporal-client.decorator.ts","../src/decorators/context.decorator.ts"],"sourcesContent":["export const TEMPORAL_MODULE_ACTIVITIES = \"_temporal_module_activities\";\nexport const TEMPORAL_MODULE_ACTIVITY = \"_temporal_module_activity\";\n\nexport const TEMPORAL_ARGS_METADATA = \"_temporal_module_args\";\nexport const TEMPORAL_CONTEXT_METADATA = \"_temporal_module_context\";\n","import { Injectable, Type } from \"@nestjs/common\";\nimport { Reflector } from \"@nestjs/core\";\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\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() and @Activity() 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}\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 workers?: Worker[];\n  private workerRunPromises?: 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.workers) {\n      return;\n    }\n\n    try {\n      this.workers.forEach((worker) => worker.shutdown());\n      if (this.workerRunPromises) {\n        await Promise.all(this.workerRunPromises);\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.workers) {\n      this.workerRunPromises = this.workers.map((worker) => 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.some((config) => config.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 sharedWorkerOptions: Partial<WorkerOptions> = {\n      activities: activitiesFunc,\n    };\n\n    if (connectionOptions) {\n      this.logger.verbose(\"Connecting to the Temporal server\");\n      sharedWorkerOptions.connection =\n        await NativeConnection.connect(connectionOptions);\n    }\n\n    this.logger.verbose(\"Creating a new Worker\");\n    this.workers = await Promise.all(\n      workerConfig.map(({ activities: configActivities, ...config }) =>\n        Worker.create({\n          ...sharedWorkerOptions,\n          ...config,\n          activities: { ...(configActivities as Record<string, Function>), ...activitiesFunc },\n        }),\n      ),\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 ctx = Context.current();\n              const result = handler(...args, ctx.info);\n\n              const interval = setInterval(() => {\n                ctx.heartbeat(crypto.randomUUID());\n              }, 5000);\n\n              try {\n                return isObservable(result)\n                  ? await lastValueFrom(result)\n                  : await result;\n              } finally {\n                clearInterval(interval);\n              }\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 { Injectable } from \"@nestjs/common\";\nimport { WorkflowClient, WorkflowClientOptions, WorkflowExecutionDescription, WorkflowHandle, WorkflowNotFoundError } from \"@temporalio/client\";\n\nexport class TemporalWorkflowService extends WorkflowClient {\n  constructor(options?: WorkflowClientOptions) {\n    super(options);\n  }\n\n  public async describeWorkflow(workflowId: string): Promise<{ info: WorkflowExecutionDescription, handle: WorkflowHandle } | null> {\n    const handle = this.getHandle(workflowId);\n\n    try {\n      return {\n        info: await handle.describe(),\n        handle,\n      };\n    } catch (error) {\n      if (error instanceof WorkflowNotFoundError) {\n        return null;\n      }\n      throw error;\n    }\n  }\n}","import { OnApplicationShutdown } from '@nestjs/common';\nimport { WorkflowClient, WorkflowClientOptions } from '@temporalio/client';\nimport { TemporalWorkflowService } from '../core';\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 TemporalWorkflowService(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\";\n\nimport {\n  TEMPORAL_MODULE_ACTIVITIES,\n  TEMPORAL_MODULE_ACTIVITY,\n} 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 * 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 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 const Activities =\n  (options?: ActivitiesOptions): ClassDecorator =>\n  (target: Function) => {\n    SetMetadata(SCOPE_OPTIONS_METADATA, options)(target);\n    SetMetadata(TEMPORAL_MODULE_ACTIVITIES, options ?? {})(target);\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 const Activity = (options?: ActivityOptions): MethodDecorator =>\n  SetMetadata(TEMPORAL_MODULE_ACTIVITY, options || {});\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 { createParamDecorator, ExecutionContext } from \"@nestjs/common\";\n\nexport const ActivityContext = () =>\n  createParamDecorator((_, ctx: ExecutionContext) => {\n    return ctx.getArgByIndex(1);\n  });\n\nexport const ActivityPayload = () =>\n  createParamDecorator((_, ctx: ExecutionContext) => {\n    return ctx.getArgByIndex(0);\n  });\n"],"mappings":";;;;;;;;AAAA,MAAa,6BAA6B;AAC1C,MAAa,2BAA2B;AAExC,MAAa,yBAAyB;;;;;;;;;;;;;;;;;ACU/B,IAAA,2BAAA,MAAM,yBAAyB;CACpC,YAAY,WAAuC;AAAtB,OAAA,YAAA;;CAE7B,aAAa,QAA8D;AACzE,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,CAAC,CAAC,KAAK,UAAU,IAAI,4BAA4B,OAAO;;CAGjE,cAAc,QAA2C;AACvD,SAAO,KAAK,UAAU,IAAI,4BAA4B,OAAO;;CAG/D,WAAW,QAA8D;AACvE,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,CAAC,CAAC,KAAK,UAAU,IAAI,0BAA0B,OAAO;;CAG/D,YAAY,QAA2C;AACrD,SAAO,KAAK,UAAU,IAAI,0BAA0B,OAAO;;;uCAnB9D,YAAY,EAAA,mBAAA,qBAAA,CAAA,QAAA,SAAA,OAAA,cAAA,eAAA,eAAA,aAAA,SAAA,OAAA,CAAA,CAAA,EAAA,yBAAA;;;ACGb,MAAa,EACX,yBACA,sBAAsB,+BACtB,cAAc,8BACd,oBAAoB,uCAClB,IAAI,2BAAkD,CACvD,mBAAmB,iBAAiB,CACpC,OAAO;;;ACtBV,IAAY,oBAAL,yBAAA,mBAAA;AACL,mBAAA,kBAAA,aAAA,KAAA;AACA,mBAAA,kBAAA,aAAA,KAAA;;KACD;;;ACAD,IAAa,2BAAb,MAAkE;CAChE,YACE,UACA,SACA,MACA;AAHiB,OAAA,WAAA;AACA,OAAA,UAAA;AACA,OAAA,OAAA;;CAGnB,WAAiC;AAC/B,SAAO,KAAK,SAAS;;CAGvB,aAAuB;AACrB,SAAO,KAAK;;CAGd,UAAmD;AACjD,SAAO,KAAK;;CAGd,kBAAwB;AACtB,SAAO,KAAK,KAAK;;CAGnB,cAA2B,OAAkB;AAC3C,SAAO,KAAK,KAAK;;CAGnB,cAA2D;AACzD,QAAM,IAAI,MAAM,uCAAuC;;CAGzD,eAA6D;AAC3D,QAAM,IAAI,MAAM,wCAAwC;;CAG1D,aAAyD;AACvD,QAAM,IAAI,MAAM,6CAA6C;;CAG/D,UAAsD;AACpD,SAAO;;;;;ACtCX,IAAa,wBAAb,MAA4D;CAC1D,YACE,UACA,SACA;AAFiB,OAAA,WAAA;AACA,OAAA,UAAA;;CAGnB,oBACE,MACA,MACA,MACS;AACT,UAAQ,MAAR;GACE,KAAK,kBAAkB,QACrB,QAAO,QAAQ,KAAK,MAAM,OAAO,KAAK,OAAO,WACxC,KAAK,GAA+B,QACrC,KAAK;GAEX,KAAK,kBAAkB,QACrB,QAAO,IAAI,yBAAyB,KAAK,UAAU,KAAK,SAAS,KAAK;GAExE,QACE,QAAO;;;;;;;ACiBR,IAAA,mBAAA,oBAAA,MAAM,iBAEb;CACE;CAEA,SAA0B,IAAI,OAAA,kBAAwB,KAAK;CAC3D;CACA;CAEA,YACE,kBACA,kBACA,iBACA,wBACA;AAJiB,OAAA,mBAAA;AACA,OAAA,mBAAA;AACA,OAAA,kBAAA;AACA,OAAA,yBAAA;;;;;CAMnB,MAAM,eAA8B;AAClC,QAAM,KAAK,SAAS;;;;;CAMtB,MAAM,kBAAiC;AACrC,MAAI,CAAC,KAAK,QACR;AAGF,MAAI;AACF,QAAK,QAAQ,SAAS,WAAW,OAAO,UAAU,CAAC;AACnD,OAAI,KAAK,kBACP,OAAM,QAAQ,IAAI,KAAK,kBAAkB;WAEpC,KAAc;AACrB,QAAK,OAAO,KAAK,+CAA+C,EAC9D,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,EACtD,CAAC;;;;;;CAON,yBAA+B;AAC7B,MAAI,KAAK,QACP,MAAK,oBAAoB,KAAK,QAAQ,KAAK,WAAW,OAAO,KAAK,CAAC;;;;;;CAQvE,MAAM,UAAyB;EAC7B,MAAM,eAAe,KAAK,wBAAwB;EAClD,MAAM,iBAAiB,KAAK,mBAAmB;EAC/C,MAAM,oBAAoB,KAAK,4BAA4B;AAG3D,MAAI,CAAC,aAAa,MAAM,WAAW,OAAO,UAAU,EAAE;AACpD,QAAK,OAAO,KACV,+EACD;AACD;;AAGF,OAAK,8BAA8B;EAEnC,MAAM,iBAAiB,MAAM,KAAK,kBAAkB;AAEpD,MAAI,gBAAgB;AAClB,QAAK,OAAO,QAAQ,qCAAqC;AACzD,WAAQ,QAAQ,eAAe;;EAGjC,MAAM,sBAA8C,EAClD,YAAY,gBACb;AAED,MAAI,mBAAmB;AACrB,QAAK,OAAO,QAAQ,oCAAoC;AACxD,uBAAoB,aAClB,MAAM,iBAAiB,QAAQ,kBAAkB;;AAGrD,OAAK,OAAO,QAAQ,wBAAwB;AAC5C,OAAK,UAAU,MAAM,QAAQ,IAC3B,aAAa,KAAK,EAAE,YAAY,kBAAkB,GAAG,aACnD,OAAO,OAAO;GACZ,GAAG;GACH,GAAG;GACH,YAAY;IAAE,GAAI;IAA+C,GAAG;IAAgB;GACrF,CAAC,CACH,CACF;;;;;CAMH,yBAA0C;AACxC,SAAO,KAAK,QAAQ;;;;;CAMtB,6BAAkE;AAChE,SAAO,KAAK,QAAQ;;;;;CAMtB,oBAAgD;AAC9C,SAAO,KAAK,QAAQ;;;;;;;CAQtB,qBAAyE;AACvE,SAAO,KAAK,QAAQ;;;;;;CAStB,+BAAqC;AACnC,MAAI,CAAC,KAAK,QAAQ,2BAChB;EAGF,MAAM,kBAAkB,KAAK,oBAAoB;AACjD,MAAI,CAAC,mBAAmB,gBAAgB,WAAW,EACjD;EAGF,MAAM,kBAA4C,EAAE;AAEpD,kBAAgB,SAAS,mBAA+C;GAEtE,MAAM,UAAU;GAChB,MAAM,WACJ,cAAc,WAAW,QAAQ,WAC7B,QAAQ,WACR,IAAK,gBAAsC;AAEjD,QAAK,gBACF,kBAAkB,OAAO,eAAe,SAAS,CAAC,CAClD,SAAS,QAAQ;AAChB,QAAI,KAAK,iBAAiB,WAAW,SAAS,KAAK,CACjD,iBAAgB,QAAQ,gBAAgB,QAAQ,EAAE,EAAE,OAClD,SAAS,YAAY,KACtB;KAEH;IACJ;EAEF,MAAM,aAAa,OAAO,QAAQ,gBAAgB,CAAC,QAChD,GAAG,aAAa,QAAQ,SAAS,EACnC;AAED,MAAI,WAAW,SAAS,GAAG;GACzB,MAAM,UAAU,4GAA4G,KAAK,UAC/H,OAAO,YAAY,WAAW,CAC/B;AACD,QAAK,OAAO,MAAM,QAAQ;AAC1B,SAAM,IAAI,MAAM,QAAQ;;;;;;;CAQ5B,MAAM,mBAAsD;EAC1D,MAAM,mBAA6C,EAAE;EAErD,MAAM,kBAAkB,KAAK,oBAAoB;AACX,OAAK,iBACxC,cAAc,CACd,QACE,YACC,KAAK,iBAAiB,aACpB,CAAC,QAAQ,YAAY,QAAQ,SACzB,QAAQ,UAAU,cAClB,QAAQ,SACb,KACA,CAAC,mBACA,gBAAgB,MACb,QACC,QAAQ,QAAQ,YACf,eAAe,UACd,cAAc,OACb,IAAwB,aAAa,QAAQ,SACnD,EACN,CAEQ,SAAS,YAA6B;GAC/C,MAAM,EAAE,aAAa;GACrB,MAAM,kBAAkB,CAAC,QAAQ,wBAAwB;AAEzD,QAAK,gBAAgB,kBACnB,UACA,OAAO,eAAe,SAAS,GAC9B,QAAgB;AACf,QAAI,KAAK,iBAAiB,WAAW,SAAS,KAAK,EAAE;AACnD,SAAI,gBACF,MAAK,OAAO,KACV,oEAAoE,IAAI,gBAAgB,SAAS,YAAY,KAAK,2BACnH;KAEH,MAAM,gBAAgB,IAAI,sBACxB,UACA,SAAS,KACV;KAED,MAAM,UAAU,KAAK,uBAAuB,OAC1C,UACA,SAAS,MACT,KACA,wBACA,eACA,KAAA,GACA,KAAA,GACA,KAAA,GACA,WACD;AAED,sBAAiB,OAAO,OAAO,GAAG,SAAoB;MACpD,MAAM,MAAM,QAAQ,SAAS;MAC7B,MAAM,SAAS,QAAQ,GAAG,MAAM,IAAI,KAAK;MAEzC,MAAM,WAAW,kBAAkB;AACjC,WAAI,UAAU,OAAO,YAAY,CAAC;SACjC,IAAK;AAER,UAAI;AACF,cAAO,aAAa,OAAO,GACvB,MAAM,cAAc,OAAO,GAC3B,MAAM;gBACF;AACR,qBAAc,SAAS;;;;KAKhC;IACD;AACF,SAAO;;;YA/PR,OAAO,8BAA8B,EAAA,mBAAA,eAAA,OAAA,CAAA,EAAA,iBAAA,WAAA,WAAA,KAAA,EAAA;mDAJvC,YAAY,EAAA,mBAAA,qBAAA;;;;;;;;AC1Cb,SAAgB,cAAc,MAAuB;AACnD,QAAO,OAAO,iBAAiB,SAAS;;AAG1C,SAAgB,mBAAmB,MAAuB;AACxD,QAAO,OAAO,sBAAsB,SAAS;;;;ACF/C,IAAa,0BAAb,cAA6C,eAAe;CAC1D,YAAY,SAAiC;AAC3C,QAAM,QAAQ;;CAGhB,MAAa,iBAAiB,YAAoG;EAChI,MAAM,SAAS,KAAK,UAAU,WAAW;AAEzC,MAAI;AACF,UAAO;IACL,MAAM,MAAM,OAAO,UAAU;IAC7B;IACD;WACM,OAAO;AACd,OAAI,iBAAiB,sBACnB,QAAO;AAET,SAAM;;;;;;;;;;;;;ACTZ,SAAgB,wBACd,QACgB;AACf,QAA4C,wBAC3C,YAAY;AACV,MAAI;AACF,SAAM,OAAO,YAAY,OAAO;WACzB,QAAiB;GACxB,MAAM,eACJ,kBAAkB,QAAQ,OAAO,UAAU,OAAO,OAAO;AAC3D,WAAQ,MACN,sDAAsD,eACvD;;;AAGP,QAAO;;;;;;;;AAST,SAAgB,kBACd,SACgB;AAEhB,QAAO,wBADQ,IAAI,wBAAwB,QAAQ,CACb;;;;AC1BxC,SAAgB,oBACd,SACA,SAKU;AACV,KAAI,SAAS,YAAY;EACvB,MAAM,EAAE,YAAY,WAAW;AAC/B,SAAO;GACL;GACA;GACA,QAAQ,UAAU,EAAE;GACrB;;AAEH,QAAO;EACL;EACA,UAAU,SAAS,YAAY;EAChC;;AAGH,SAAgB,0BACd,cACY;CACZ,MAAM,OAAO,aAAa,OAAO,aAAa,OAAO,KAAA;CACrD,MAAM,iBAAiB,mBAAmB,KAAK;CAC/C,MAAM,gBAAgB,cAAc,KAAK;AACzC,QAAO;EACL,oBAAoB,gBAAgB,aAAa;EACjD;GACE,SAAS;GACT,aAAa,YACX,kBAAkB,QAAQ;GAC5B,QAAQ,CAAC,eAAe;GACzB;EACD;EACD;;;;;AC3BI,IAAA,iBAAA,kBAAA,MAAM,uBAAuB,wBAAwB;;;;;;;;CAQ1D,OAAO,oBACL,SACe;EACf,MAAM,qBAAqB,MAAM,oBAAoB,QAAQ;AAC7D,qBAAmB,SAAS,KAAK,gBAAgB;AACjD,qBAAmB,WAAW,KAC5B,kBACA,yBACD;AACD,qBAAmB,SAAS,KAC1B,kBACA,0BACA,gBACD;AAED,SAAO;GACL,GAAG;GACH,SAAS,CAAC,gBAAgB;GAC3B;;;;;;;;;CAUH,OAAO,oBACL,kCACe;EACf,MAAM,YAAY,0BAChB,iCACD;AAED,SAAO;GACL,QAAQ;GACR,QAAA;GACA;GACA,SAAS;GACV;;;+CAjDJ,OAAO,EAAE,CAAC,CAAA,EAAA,eAAA;;;;;;;;;;;;;;;;;;;;AC2BX,MAAa,cACV,aACA,WAAqB;AACpB,aAAY,wBAAwB,QAAQ,CAAC,OAAO;AACpD,aAAY,4BAA4B,WAAW,EAAE,CAAC,CAAC,OAAO;;;;;;;;;;;;;;;;;;AAmBlE,MAAa,YAAY,YACvB,YAAY,0BAA0B,WAAW,EAAE,CAAC;;;;;;;;;;;;;;;ACzDtD,MAAa,wBAAwB,SACnC,OAAO,cAAc,KAAK,CAAC;;;ACf7B,MAAa,wBACX,sBAAsB,GAAG,QAA0B;AACjD,QAAO,IAAI,cAAc,EAAE;EAC3B;AAEJ,MAAa,wBACX,sBAAsB,GAAG,QAA0B;AACjD,QAAO,IAAI,cAAc,EAAE;EAC3B"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@globalart/nestjs-temporal",
   "description": "Temporal integration for NestJS",
-  "version": "2.4.1",
+  "version": "2.5.0",
   "type": "module",
   "main": "dist/index.mjs",
   "module": "dist/index.mjs",
@@ -54,7 +54,7 @@
     "rxjs": "^7.8.2"
   },
   "devDependencies": {
-    "@types/node": "25.5.0",
+    "@types/node": "25.5.2",
     "reflect-metadata": "^0.2.2",
     "release-it": "19.2.4",
     "tsdown": "0.21.7",