atomic-queues 1.4.1 → 1.6.0

package/dist/decorators/decorators.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators/decorators.ts"],"names":[],"mappings":"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"}

package/dist/decorators/decorators.js

@@ -1,680 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InjectAtomicQueue = exports.JobType = exports.EntityId = exports.AtomicProcessor = exports.JOB_QUERY_METADATA = exports.JOB_COMMAND_METADATA = exports.ON_TERMINATE_WORKER_METADATA = exports.ON_SPAWN_WORKER_METADATA = exports.GET_DESIRED_WORKER_COUNT_METADATA = exports.GET_ACTIVE_ENTITIES_METADATA = exports.ENTITY_SCALER_METADATA = exports.JOB_HANDLER_METADATA = exports.WORKER_PROCESSOR_METADATA = exports.JOB_TYPE_METADATA = exports.ENTITY_ID_METADATA = exports.ENTITY_TYPE_METADATA = exports.ATOMIC_PROCESSOR_METADATA = void 0;
-exports.EntityType = EntityType;
-exports.QueueEntityId = QueueEntityId;
-exports.getEntityType = getEntityType;
-exports.getEntityIdProperty = getEntityIdProperty;
-exports.QueueEntity = QueueEntity;
-exports.WorkerProcessor = WorkerProcessor;
-exports.JobHandler = JobHandler;
-exports.EntityScaler = EntityScaler;
-exports.GetActiveEntities = GetActiveEntities;
-exports.GetDesiredWorkerCount = GetDesiredWorkerCount;
-exports.OnSpawnWorker = OnSpawnWorker;
-exports.OnTerminateWorker = OnTerminateWorker;
-exports.JobCommand = JobCommand;
-exports.JobQuery = JobQuery;
-exports.getJobCommandMetadata = getJobCommandMetadata;
-exports.getJobQueryMetadata = getJobQueryMetadata;
-exports.isJobCommand = isJobCommand;
-exports.isJobQuery = isJobQuery;
-exports.getWorkerProcessorMetadata = getWorkerProcessorMetadata;
-exports.getJobHandlerMetadata = getJobHandlerMetadata;
-exports.getEntityScalerMetadata = getEntityScalerMetadata;
-exports.isWorkerProcessor = isWorkerProcessor;
-exports.isEntityScaler = isEntityScaler;
-const common_1 = require("@nestjs/common");
-// =============================================================================
-// METADATA KEYS
-// =============================================================================
-/**
- * Metadata keys for decorators
- */
-exports.ATOMIC_PROCESSOR_METADATA = 'atomic:processor';
-exports.ENTITY_TYPE_METADATA = 'atomic:entity-type';
-exports.ENTITY_ID_METADATA = 'atomic:entity-id';
-exports.JOB_TYPE_METADATA = 'atomic:job-type';
-exports.WORKER_PROCESSOR_METADATA = 'atomic:worker-processor';
-exports.JOB_HANDLER_METADATA = 'atomic:job-handler';
-exports.ENTITY_SCALER_METADATA = 'atomic:entity-scaler';
-exports.GET_ACTIVE_ENTITIES_METADATA = 'atomic:get-active-entities';
-exports.GET_DESIRED_WORKER_COUNT_METADATA = 'atomic:get-desired-worker-count';
-exports.ON_SPAWN_WORKER_METADATA = 'atomic:on-spawn-worker';
-exports.ON_TERMINATE_WORKER_METADATA = 'atomic:on-terminate-worker';
-exports.JOB_COMMAND_METADATA = 'atomic:job-command';
-exports.JOB_QUERY_METADATA = 'atomic:job-query';
-// Registry to track @QueueEntityId usage per class (for duplicate detection)
-const queueEntityIdRegistry = new Map();
-// =============================================================================
-// LEGACY DECORATORS (Preserved for backward compatibility)
-// =============================================================================
-/**
- * @AtomicProcessor decorator (LEGACY)
- *
- * Marks a method as an atomic job processor.
- * Can be used on handler methods to auto-register them.
- *
- * @deprecated Use @WorkerProcessor class decorator with @JobHandler method decorators instead
- *
- * @example
- * ```typescript
- * @Injectable()
- * export class MessageProcessor {
- *   @AtomicProcessor('send-message')
- *   async handleSendMessage(job: Job<IAtomicJobData>) {
- *     // Process the job
- *   }
- * }
- * ```
- */
-const AtomicProcessor = (jobType) => {
-    return (0, common_1.SetMetadata)(exports.ATOMIC_PROCESSOR_METADATA, jobType);
-};
-exports.AtomicProcessor = AtomicProcessor;
-/**
- * @EntityType decorator
- *
- * Marks a command/query class with its entity type for automatic routing.
- * When present, queueBus.enqueue(cmd) can auto-route without forEntity().
- *
- * @example
- * ```typescript
- * @EntityType('account')
- * export class WithdrawCommand {
- *   @QueueEntityId()
- *   public readonly accountId: string;
- *   public readonly amount: number;
- * }
- *
- * // Can now use direct enqueue:
- * await queueBus.enqueue(new WithdrawCommand(accountId, amount));
- * ```
- */
-function EntityType(entityType) {
-    return (target) => {
-        Reflect.defineMetadata(exports.ENTITY_TYPE_METADATA, entityType, target);
-    };
-}
-/**
- * @QueueEntityId decorator
- *
- * Marks a property OR constructor parameter as the entity ID for queue routing.
- * Only ONE @QueueEntityId() allowed per class (enforced at decoration time).
- * Overrides module-level defaultEntityId configuration.
- *
- * @example Property decorator:
- * ```typescript
- * export class TransferCommand {
- *   @QueueEntityId()
- *   public readonly sourceAccountId: string;
- *   public readonly amount: number;
- * }
- * ```
- *
- * @example Parameter decorator (recommended):
- * ```typescript
- * @QueueEntity('account')
- * export class TransferCommand {
- *   constructor(
- *     @QueueEntityId() public readonly sourceAccountId: string,
- *     public readonly amount: number,
- *   ) {}
- * }
- * ```
- */
-function QueueEntityId() {
-    return (target, propertyKey, parameterIndex) => {
-        // Parameter decorator case (on constructor param)
-        if (typeof parameterIndex === 'number') {
-            const constructor = target;
-            const className = constructor.name;
-            // Extract parameter name from constructor
-            const paramName = getConstructorParamName(constructor, parameterIndex);
-            if (!paramName) {
-                throw new Error(`Cannot determine parameter name at index ${parameterIndex} in ${className}. ` +
-                    `Ensure you're using 'public readonly paramName' syntax.`);
-            }
-            // Check for duplicate
-            const existing = queueEntityIdRegistry.get(constructor);
-            if (existing) {
-                throw new Error(`Multiple @QueueEntityId() decorators on ${className}. ` +
-                    `Found on '${existing}' and '${paramName}'. ` +
-                    `Only one parameter/property can be the entity ID.`);
-            }
-            queueEntityIdRegistry.set(constructor, paramName);
-            Reflect.defineMetadata(exports.ENTITY_ID_METADATA, paramName, constructor);
-            return;
-        }
-        // Property decorator case (on class property)
-        const constructor = target.constructor;
-        const className = constructor.name;
-        const propName = String(propertyKey);
-        // Check for duplicate @QueueEntityId on same class
-        const existing = queueEntityIdRegistry.get(constructor);
-        if (existing) {
-            throw new Error(`Multiple @QueueEntityId() decorators on ${className}. ` +
-                `Found on '${existing}' and '${propName}'. ` +
-                `Only one property can be the entity ID.`);
-        }
-        queueEntityIdRegistry.set(constructor, propName);
-        Reflect.defineMetadata(exports.ENTITY_ID_METADATA, propName, constructor);
-    };
-}
-/**
- * @deprecated Use @QueueEntityId() instead. This alias is provided for backwards compatibility.
- */
-exports.EntityId = QueueEntityId;
-/**
- * Extract parameter name from constructor function by parsing its string representation.
- * Works with TypeScript's 'public readonly paramName' shorthand.
- */
-function getConstructorParamName(constructor, index) {
-    const fnStr = constructor.toString();
-    // Match constructor parameters - handles various formats
-    const constructorMatch = fnStr.match(/constructor\s*\(([^)]*)\)/);
-    if (!constructorMatch)
-        return undefined;
-    const paramsStr = constructorMatch[1];
-    if (!paramsStr.trim())
-        return undefined;
-    // Split by comma, but be careful with nested generics/objects
-    const params = splitParams(paramsStr);
-    if (index >= params.length)
-        return undefined;
-    const param = params[index].trim();
-    // Extract the actual parameter name, handling:
-    // - @Decorator() public readonly paramName: Type
-    // - public readonly paramName: Type
-    // - paramName: Type
-    // - paramName
-    const nameMatch = param.match(/(?:@\w+\([^)]*\)\s*)*(?:public\s+)?(?:readonly\s+)?(\w+)/);
-    return nameMatch ? nameMatch[1] : undefined;
-}
-/**
- * Split parameter string by commas, respecting nested structures
- */
-function splitParams(paramsStr) {
-    const params = [];
-    let current = '';
-    let depth = 0;
-    for (const char of paramsStr) {
-        if (char === '(' || char === '<' || char === '{' || char === '[') {
-            depth++;
-            current += char;
-        }
-        else if (char === ')' || char === '>' || char === '}' || char === ']') {
-            depth--;
-            current += char;
-        }
-        else if (char === ',' && depth === 0) {
-            params.push(current);
-            current = '';
-        }
-        else {
-            current += char;
-        }
-    }
-    if (current.trim()) {
-        params.push(current);
-    }
-    return params;
-}
-/**
- * Get the entity type from a command/query class decorated with @EntityType or @QueueEntity
- */
-function getEntityType(target) {
-    return Reflect.getMetadata(exports.ENTITY_TYPE_METADATA, target);
-}
-/**
- * Get the entity ID property name from a class decorated with @QueueEntityId or @QueueEntity
- */
-function getEntityIdProperty(target) {
-    return Reflect.getMetadata(exports.ENTITY_ID_METADATA, target);
-}
-// =============================================================================
-// NEW COMBINED DECORATOR - Less Invasive
-// =============================================================================
-/**
- * @QueueEntity decorator
- *
- * Single decorator that combines @EntityType and @QueueEntityId into one.
- * This is the recommended way to mark commands/queries for queue routing.
- *
- * @param entityType - The entity type for routing (e.g., 'table', 'account')
- * @param entityIdProperty - Optional property name containing the entity ID.
- *                           If omitted, uses module-level defaultEntityId from entities config.
- *
- * @example
- * // With explicit property name:
- * @QueueEntity('table', 'tableId')
- * export class MakeBetCommand {
- *   constructor(
- *     public readonly tableId: string,  // ← unchanged!
- *     public readonly amount: number,
- *   ) {}
- * }
- *
- * @example
- * // Using module default (entities config has defaultEntityId: 'tableId'):
- * @QueueEntity('table')
- * export class DealCommand {
- *   constructor(
- *     public readonly tableId: string,
- *     public readonly card: string,
- *   ) {}
- * }
- *
- * @example
- * // Then just enqueue directly:
- * await queueBus.enqueue(new MakeBetCommand(tableId, 100));
- */
-function QueueEntity(entityType, entityIdProperty) {
-    return (target) => {
-        // Always set entity type
-        Reflect.defineMetadata(exports.ENTITY_TYPE_METADATA, entityType, target);
-        // Set entity ID property if provided (otherwise falls back to module config)
-        if (entityIdProperty) {
-            Reflect.defineMetadata(exports.ENTITY_ID_METADATA, entityIdProperty, target);
-        }
-    };
-}
-/**
- * @JobType decorator (LEGACY)
- *
- * Specifies the job type for a processor method.
- *
- * @deprecated Use @JobHandler method decorator instead
- */
-const JobType = (jobType) => {
-    return (0, common_1.SetMetadata)(exports.JOB_TYPE_METADATA, jobType);
-};
-exports.JobType = JobType;
-/**
- * @InjectAtomicQueue decorator
- *
- * Custom parameter decorator for injecting a specific queue.
- * Useful when you need direct access to a queue in a service.
- */
-const InjectAtomicQueue = (entityType, entityId) => {
-    return (target, propertyKey, parameterIndex) => {
-        const existingParams = Reflect.getMetadata('atomic:inject-queue', target, propertyKey) || [];
-        existingParams.push({
-            type: entityType,
-            id: entityId,
-            index: parameterIndex,
-        });
-        Reflect.defineMetadata('atomic:inject-queue', existingParams, target, propertyKey);
-    };
-};
-exports.InjectAtomicQueue = InjectAtomicQueue;
-// =============================================================================
-// NEW DECORATORS - Worker-First Architecture
-// =============================================================================
-/**
- * @WorkerProcessor class decorator
- *
- * Marks a class as a worker processor for a specific entity type.
- * Combined with @JobHandler method decorators, this enables declarative
- * job processing with automatic worker creation and management.
- *
- * @example
- * ```typescript
- * @WorkerProcessor({
- *   entityType: 'table',
- *   queueName: (tableId) => `${tableId}-queue`,
- *   workerName: (tableId) => `table-worker-${tableId}`,
- *   workerConfig: {
- *     concurrency: 1,
- *     heartbeatTTL: 3,
- *   }
- * })
- * @Injectable()
- * export class TableWorkerProcessor {
- *   constructor(private readonly commandBus: CommandBus) {}
- *
- *   @JobHandler('make-bet')
- *   async handleMakeBet(job: Job<MakeBetData>, entityId: string) {
- *     return this.commandBus.execute(new MakeBetCommand(entityId, job.data));
- *   }
- *
- *   @JobHandler('*') // Wildcard handler for any unmatched job
- *   async handleDynamic(job: Job, entityId: string) {
- *     // Dynamic handling
- *   }
- * }
- * ```
- */
-function WorkerProcessor(options) {
-    return (target) => {
-        // Store the options with defaults
-        const metadata = {
-            ...options,
-            overrideDefaults: options.overrideDefaults ?? false,
-        };
-        Reflect.defineMetadata(exports.WORKER_PROCESSOR_METADATA, metadata, target);
-        // Mark as injectable if not already
-        if (!Reflect.hasMetadata('injectable', target)) {
-            Reflect.defineMetadata('injectable', true, target);
-        }
-    };
-}
-/**
- * @JobHandler method decorator
- *
- * Marks a method as a handler for a specific job name.
- * Use '*' as jobName to create a wildcard handler that catches
- * any jobs not matched by specific handlers.
- *
- * @example
- * ```typescript
- * @JobHandler('make-bet')
- * async handleMakeBet(job: Job<MakeBetData>, entityId: string) {
- *   // Handle make-bet jobs
- * }
- *
- * @JobHandler('*')
- * async handleOther(job: Job, entityId: string) {
- *   // Handle any other jobs
- * }
- * ```
- */
-function JobHandler(jobName) {
-    return (target, propertyKey, descriptor) => {
-        const methodName = String(propertyKey);
-        const isWildcard = jobName === '*';
-        // Store handler metadata on the method
-        const metadata = {
-            jobName,
-            methodName,
-            isWildcard,
-        };
-        Reflect.defineMetadata(exports.JOB_HANDLER_METADATA, metadata, target, propertyKey);
-        // Collect all handlers on the class
-        const existingHandlers = Reflect.getMetadata(exports.JOB_HANDLER_METADATA, target.constructor) || [];
-        existingHandlers.push(metadata);
-        Reflect.defineMetadata(exports.JOB_HANDLER_METADATA, existingHandlers, target.constructor);
-        return descriptor;
-    };
-}
-/**
- * @EntityScaler class decorator
- *
- * Marks a class as an entity scaler provider for a specific entity type.
- * Methods decorated with @GetActiveEntities, @GetDesiredWorkerCount,
- * @OnSpawnWorker, and @OnTerminateWorker define the scaling behavior.
- *
- * @example
- * ```typescript
- * @EntityScaler({
- *   entityType: 'table',
- *   maxWorkersPerEntity: 1,
- * })
- * @Injectable()
- * export class TableEntityScaler {
- *   constructor(private readonly redis: Redis) {}
- *
- *   @GetActiveEntities()
- *   async getAllTables(): Promise<string[]> {
- *     // Return all table IDs that need workers
- *   }
- *
- *   @GetDesiredWorkerCount()
- *   async getWorkerCount(entityId: string): Promise<number> {
- *     return 1; // Each table gets 1 worker
- *   }
- *
- *   @OnSpawnWorker()
- *   async spawnWorker(entityId: string): Promise<void> {
- *     // Called when a worker should be spawned
- *   }
- * }
- * ```
- */
-function EntityScaler(options) {
-    return (target) => {
-        Reflect.defineMetadata(exports.ENTITY_SCALER_METADATA, options, target);
-        if (!Reflect.hasMetadata('injectable', target)) {
-            Reflect.defineMetadata('injectable', true, target);
-        }
-    };
-}
-/**
- * @GetActiveEntities method decorator
- *
- * Marks a method that returns all active entity IDs for scaling decisions.
- * Used within an @EntityScaler class.
- */
-function GetActiveEntities() {
-    return (target, propertyKey, descriptor) => {
-        Reflect.defineMetadata(exports.GET_ACTIVE_ENTITIES_METADATA, true, target, propertyKey);
-        Reflect.defineMetadata(exports.GET_ACTIVE_ENTITIES_METADATA + ':method', String(propertyKey), target.constructor);
-        return descriptor;
-    };
-}
-/**
- * @GetDesiredWorkerCount method decorator
- *
- * Marks a method that returns the desired worker count for an entity.
- * Used within an @EntityScaler class.
- */
-function GetDesiredWorkerCount() {
-    return (target, propertyKey, descriptor) => {
-        Reflect.defineMetadata(exports.GET_DESIRED_WORKER_COUNT_METADATA, true, target, propertyKey);
-        Reflect.defineMetadata(exports.GET_DESIRED_WORKER_COUNT_METADATA + ':method', String(propertyKey), target.constructor);
-        return descriptor;
-    };
-}
-/**
- * @OnSpawnWorker method decorator
- *
- * Marks a method that is called when a worker should be spawned.
- * Used within an @EntityScaler class.
- */
-function OnSpawnWorker() {
-    return (target, propertyKey, descriptor) => {
-        Reflect.defineMetadata(exports.ON_SPAWN_WORKER_METADATA, true, target, propertyKey);
-        Reflect.defineMetadata(exports.ON_SPAWN_WORKER_METADATA + ':method', String(propertyKey), target.constructor);
-        return descriptor;
-    };
-}
-/**
- * @OnTerminateWorker method decorator
- *
- * Marks a method that is called when a worker should be terminated.
- * Used within an @EntityScaler class.
- */
-function OnTerminateWorker() {
-    return (target, propertyKey, descriptor) => {
-        Reflect.defineMetadata(exports.ON_TERMINATE_WORKER_METADATA, true, target, propertyKey);
-        Reflect.defineMetadata(exports.ON_TERMINATE_WORKER_METADATA + ':method', String(propertyKey), target.constructor);
-        return descriptor;
-    };
-}
-// =============================================================================
-// JOB COMMAND/QUERY DECORATORS - Zero-Boilerplate CQRS Integration
-// =============================================================================
-/**
- * Helper to convert class name to kebab-case job name
- * MakeBetCommand -> make-bet
- * ProcessPaymentCommand -> process-payment
- */
-function deriveJobName(className, suffix) {
-    return className
-        .replace(new RegExp(`${suffix}$`), '')
-        .replace(/([a-z])([A-Z])/g, '$1-$2')
-        .toLowerCase();
-}
-/**
- * Helper to extract constructor parameter names using reflection
- */
-function getConstructorParamNames(target) {
-    const paramTypes = Reflect.getMetadata('design:paramtypes', target) || [];
-    // Try to extract parameter names from the constructor string
-    const constructorStr = target.toString();
-    const match = constructorStr.match(/constructor\s*\(([^)]*)\)/);
-    if (match && match[1]) {
-        return match[1]
-            .split(',')
-            .map((param) => {
-            // Handle various patterns: 
-            // "public readonly tableId: string" -> "tableId"
-            // "tableId" -> "tableId"
-            // "private tableId: string" -> "tableId"
-            const cleaned = param.trim();
-            const nameMatch = cleaned.match(/(?:public\s+)?(?:private\s+)?(?:protected\s+)?(?:readonly\s+)?(\w+)/);
-            return nameMatch ? nameMatch[1] : cleaned;
-        })
-            .filter((name) => name.length > 0);
-    }
-    // Fallback: generate param0, param1, etc.
-    return paramTypes.map((_, i) => `param${i}`);
-}
-/**
- * @JobCommand class decorator
- *
- * Marks a command class for automatic job routing. When a job with the
- * specified name arrives, the library will automatically instantiate
- * the command with entityId + job.data and execute it via CommandBus.
- *
- * This eliminates the need for @JobHandler boilerplate in processors.
- *
- * @example
- * ```typescript
- * // Option 1: Explicit job name
- * @JobCommand('make-bet')
- * export class MakeBetCommand {
- *   constructor(
- *     public readonly tableId: string,    // entityId (first param)
- *     public readonly playerId: string,
- *     public readonly amount: number,
- *   ) {}
- * }
- *
- * // Option 2: Auto-derived job name (MakeBetCommand -> 'make-bet')
- * @JobCommand()
- * export class MakeBetCommand { ... }
- *
- * // Option 3: With options
- * @JobCommand({
- *   name: 'place-bet',
- *   entityType: 'table',
- *   entityIdParam: 'tableId',  // or 0 for first param
- * })
- * export class PlaceBetCommand { ... }
- * ```
- */
-function JobCommand(options) {
-    return (target) => {
-        const opts = typeof options === 'string'
-            ? { name: options }
-            : (options || {});
-        const jobName = opts.name || deriveJobName(target.name, 'Command');
-        const paramNames = getConstructorParamNames(target);
-        const metadata = {
-            jobName,
-            entityType: opts.entityType,
-            entityIdParam: opts.entityIdParam ?? 0,
-            targetClass: target,
-            paramNames,
-        };
-        Reflect.defineMetadata(exports.JOB_COMMAND_METADATA, metadata, target);
-    };
-}
-/**
- * @JobQuery class decorator
- *
- * Marks a query class for automatic job routing. When a job with the
- * specified name arrives, the library will automatically instantiate
- * the query with entityId + job.data and execute it via QueryBus.
- *
- * @example
- * ```typescript
- * @JobQuery('get-score')
- * export class GetScoreQuery {
- *   constructor(
- *     public readonly tableId: string,
- *     public readonly seatIndex: number,
- *   ) {}
- * }
- *
- * // Auto-derived: GetTableStateQuery -> 'get-table-state'
- * @JobQuery()
- * export class GetTableStateQuery { ... }
- * ```
- */
-function JobQuery(options) {
-    return (target) => {
-        const opts = typeof options === 'string'
-            ? { name: options }
-            : (options || {});
-        const jobName = opts.name || deriveJobName(target.name, 'Query');
-        const paramNames = getConstructorParamNames(target);
-        const metadata = {
-            jobName,
-            entityType: opts.entityType,
-            entityIdParam: opts.entityIdParam ?? 0,
-            targetClass: target,
-            paramNames,
-        };
-        Reflect.defineMetadata(exports.JOB_QUERY_METADATA, metadata, target);
-    };
-}
-/**
- * Get JobCommand metadata from a class
- */
-function getJobCommandMetadata(target) {
-    return Reflect.getMetadata(exports.JOB_COMMAND_METADATA, target);
-}
-/**
- * Get JobQuery metadata from a class
- */
-function getJobQueryMetadata(target) {
-    return Reflect.getMetadata(exports.JOB_QUERY_METADATA, target);
-}
-/**
- * Check if a class is a JobCommand
- */
-function isJobCommand(target) {
-    return Reflect.hasMetadata(exports.JOB_COMMAND_METADATA, target);
-}
-/**
- * Check if a class is a JobQuery
- */
-function isJobQuery(target) {
-    return Reflect.hasMetadata(exports.JOB_QUERY_METADATA, target);
-}
-// =============================================================================
-// UTILITY FUNCTIONS
-// =============================================================================
-/**
- * Get WorkerProcessor metadata from a class
- */
-function getWorkerProcessorMetadata(target) {
-    return Reflect.getMetadata(exports.WORKER_PROCESSOR_METADATA, target);
-}
-/**
- * Get all JobHandler metadata from a class
- */
-function getJobHandlerMetadata(target) {
-    return Reflect.getMetadata(exports.JOB_HANDLER_METADATA, target) || [];
-}
-/**
- * Get EntityScaler metadata from a class
- */
-function getEntityScalerMetadata(target) {
-    return Reflect.getMetadata(exports.ENTITY_SCALER_METADATA, target);
-}
-/**
- * Check if a class is a WorkerProcessor
- */
-function isWorkerProcessor(target) {
-    return Reflect.hasMetadata(exports.WORKER_PROCESSOR_METADATA, target);
-}
-/**
- * Check if a class is an EntityScaler
- */
-function isEntityScaler(target) {
-    return Reflect.hasMetadata(exports.ENTITY_SCALER_METADATA, target);
-}
-//# sourceMappingURL=decorators.js.map