atomic-queues 1.6.1 → 2.0.0

package/dist/cli/generators/json-schema.d.ts

@@ -0,0 +1,3 @@
+import { RegistrySnapshot } from '../../services/registry/registry.types';
+export declare function generateJsonSchema(snapshot: RegistrySnapshot): Record<string, any>;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/cli/generators/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../../src/cli/generators/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA6BlF"}

package/dist/cli/generators/json-schema.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateJsonSchema = generateJsonSchema;
+function generateJsonSchema(snapshot) {
+    const output = {
+        $schema: 'http://json-schema.org/draft-07/schema#',
+        title: 'atomic-queues Registry Schema',
+        description: `Generated from registry (prefix: ${snapshot.keyPrefix})`,
+        generatedAt: new Date(snapshot.generatedAt).toISOString(),
+        definitions: {},
+    };
+    for (const entity of snapshot.entities) {
+        for (const [msgName, spec] of Object.entries(entity.messages)) {
+            const defKey = `${entity.entityType}.${msgName}`;
+            output.definitions[defKey] = {
+                title: msgName,
+                description: `${spec.kind} for entity type '${entity.entityType}' (service: ${entity.serviceName})`,
+                ...(spec.schema || { type: 'object' }),
+            };
+            if (spec.replySchema) {
+                output.definitions[`${defKey}Reply`] = {
+                    title: `${msgName}Reply`,
+                    description: `Reply for ${msgName}`,
+                    ...spec.replySchema,
+                };
+            }
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/cli/generators/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../../src/cli/generators/json-schema.ts"],"names":[],"mappings":";;AAEA,gDA6BC;AA7BD,SAAgB,kBAAkB,CAAC,QAA0B;IAC3D,MAAM,MAAM,GAAwB;QAClC,OAAO,EAAE,yCAAyC;QAClD,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,oCAAoC,QAAQ,CAAC,SAAS,GAAG;QACtE,WAAW,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE;QACzD,WAAW,EAAE,EAAE;KAChB,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9D,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,OAAO,EAAE,CAAC;YACjD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG;gBAC3B,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,qBAAqB,MAAM,CAAC,UAAU,eAAe,MAAM,CAAC,WAAW,GAAG;gBACnG,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;aACvC,CAAC;YAEF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG;oBACrC,KAAK,EAAE,GAAG,OAAO,OAAO;oBACxB,WAAW,EAAE,aAAa,OAAO,EAAE;oBACnC,GAAG,IAAI,CAAC,WAAW;iBACpB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/generators/typescript.d.ts

@@ -0,0 +1,3 @@
+import { RegistrySnapshot } from '../../services/registry/registry.types';
+export declare function generateTypeScript(snapshot: RegistrySnapshot): string;
+//# sourceMappingURL=typescript.d.ts.map

package/dist/cli/generators/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../src/cli/generators/typescript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CA6CrE"}

package/dist/cli/generators/typescript.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTypeScript = generateTypeScript;
+function generateTypeScript(snapshot) {
+    const lines = [];
+    lines.push('// Auto-generated by atomic-queues CLI');
+    lines.push(`// Source: Redis registry (prefix: '${snapshot.keyPrefix}')`);
+    lines.push(`// Generated: ${new Date(snapshot.generatedAt).toISOString()}`);
+    lines.push('// DO NOT EDIT — regenerate with: npx atomic-queues generate --ts');
+    lines.push('');
+    for (const entity of snapshot.entities) {
+        const namespace = pascalCase(entity.entityType) + 'Entity';
+        lines.push(`export namespace ${namespace} {`);
+        for (const [msgName, spec] of Object.entries(entity.messages)) {
+            lines.push(`  /** ${spec.kind} — service: ${entity.serviceName} */`);
+            lines.push(`  export interface ${msgName} {`);
+            if (spec.schema?.properties) {
+                for (const [prop, propSchema] of Object.entries(spec.schema.properties)) {
+                    const tsType = jsonSchemaTypeToTS(propSchema);
+                    const required = spec.schema.required?.includes(prop) ?? false;
+                    lines.push(`    ${prop}${required ? '' : '?'}: ${tsType};`);
+                }
+            }
+            lines.push('  }');
+            lines.push('');
+            if (spec.kind === 'query' && spec.replySchema?.properties) {
+                lines.push(`  export interface ${msgName}Reply {`);
+                for (const [prop, propSchema] of Object.entries(spec.replySchema.properties)) {
+                    const tsType = jsonSchemaTypeToTS(propSchema);
+                    const required = spec.replySchema.required?.includes(prop) ?? false;
+                    lines.push(`    ${prop}${required ? '' : '?'}: ${tsType};`);
+                }
+                lines.push('  }');
+                lines.push('');
+            }
+        }
+        lines.push('}');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function jsonSchemaTypeToTS(schema) {
+    if (!schema.type)
+        return 'any';
+    switch (schema.type) {
+        case 'string': return schema.enum ? schema.enum.map((v) => `'${v}'`).join(' | ') : 'string';
+        case 'number':
+        case 'integer': return 'number';
+        case 'boolean': return 'boolean';
+        case 'array': return schema.items ? `${jsonSchemaTypeToTS(schema.items)}[]` : 'any[]';
+        case 'object': return 'Record<string, any>';
+        case 'null': return 'null';
+        default: return 'any';
+    }
+}
+function pascalCase(str) {
+    return str
+        .split(/[-_\s]+/)
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+//# sourceMappingURL=typescript.js.map

package/dist/cli/generators/typescript.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ioredis_1 = __importDefault(require("ioredis"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const typescript_1 = require("./generators/typescript");
+const json_schema_1 = require("./generators/json-schema");
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h') || args.length === 0) {
+        printUsage();
+        process.exit(0);
+    }
+    const command = args[0];
+    if (command !== 'generate') {
+        console.error(`Unknown command: ${command}`);
+        printUsage();
+        process.exit(1);
+    }
+    const format = args.includes('--ts') ? 'ts'
+        : args.includes('--json-schema') ? 'json-schema'
+            : args.includes('--snapshot') ? 'snapshot'
+                : null;
+    if (!format) {
+        console.error('Specify a format: --ts, --json-schema, or --snapshot');
+        process.exit(1);
+    }
+    const outputIdx = args.indexOf('--output');
+    const output = outputIdx >= 0 ? args[outputIdx + 1] : undefined;
+    const redisUrl = process.env.REDIS_URL || 'redis://localhost:6379';
+    const prefixIdx = args.indexOf('--prefix');
+    const keyPrefix = prefixIdx >= 0 ? args[prefixIdx + 1] : 'aq';
+    const redis = new ioredis_1.default(redisUrl);
+    const snapshot = await fetchSnapshot(redis, keyPrefix);
+    await redis.quit();
+    if (snapshot.entities.length === 0) {
+        console.error('No entity types found in the registry. Is the registry enabled and are services running?');
+        process.exit(1);
+    }
+    let content;
+    let defaultFilename;
+    switch (format) {
+        case 'ts':
+            content = (0, typescript_1.generateTypeScript)(snapshot);
+            defaultFilename = 'contracts.ts';
+            break;
+        case 'json-schema':
+            content = JSON.stringify((0, json_schema_1.generateJsonSchema)(snapshot), null, 2);
+            defaultFilename = 'schemas.json';
+            break;
+        case 'snapshot':
+            content = JSON.stringify(snapshot, null, 2);
+            defaultFilename = 'registry-snapshot.json';
+            break;
+        default:
+            throw new Error(`Unknown format: ${format}`);
+    }
+    if (output) {
+        const outputPath = path.resolve(output);
+        const dir = path.dirname(outputPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(outputPath, content, 'utf-8');
+        console.log(`Generated ${format} output: ${outputPath}`);
+    }
+    else {
+        console.log(content);
+    }
+}
+async function fetchSnapshot(redis, keyPrefix) {
+    const pattern = `${keyPrefix}:registry:*`;
+    const keys = [];
+    let cursor = '0';
+    do {
+        const [nextCursor, foundKeys] = await redis.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
+        cursor = nextCursor;
+        keys.push(...foundKeys);
+    } while (cursor !== '0');
+    const entities = [];
+    for (const key of keys) {
+        const raw = await redis.get(key);
+        if (raw) {
+            entities.push(JSON.parse(raw));
+        }
+    }
+    return {
+        generatedAt: Date.now(),
+        keyPrefix,
+        entities,
+    };
+}
+function printUsage() {
+    console.log(`
+atomic-queues CLI
+
+Usage:
+  npx atomic-queues generate --ts [--output <path>]          Generate TypeScript interfaces
+  npx atomic-queues generate --json-schema [--output <path>] Generate JSON Schema
+  npx atomic-queues generate --snapshot [--output <path>]    Export full registry snapshot
+
+Options:
+  --output <path>     Write to file instead of stdout
+  --prefix <prefix>   Redis key prefix (default: 'aq')
+
+Environment:
+  REDIS_URL           Redis connection URL (default: redis://localhost:6379)
+
+Examples:
+  REDIS_URL=redis://prod:6379 npx atomic-queues generate --ts --output ./generated/contracts.ts
+  npx atomic-queues generate --json-schema --output ./schemas/atomic.json
+  npx atomic-queues generate --snapshot
+  `);
+}
+main().catch(err => {
+    console.error('Error:', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/decorators/actor.decorators.d.ts

@@ -0,0 +1,4 @@
+import { ActorOptions } from './interfaces';
+export declare function Actor(entityType: string, options?: Partial<Omit<ActorOptions, 'entityType'>>): ClassDecorator;
+export declare function On(messageClass: Function): MethodDecorator;
+//# sourceMappingURL=actor.decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actor.decorators.d.ts","sourceRoot":"","sources":["../../src/decorators/actor.decorators.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAwB,MAAM,cAAc,CAAC;AAElE,wBAAgB,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,GAAG,cAAc,CAY7G;AAED,wBAAgB,EAAE,CAAC,YAAY,EAAE,QAAQ,GAAG,eAAe,CAsB1D"}

package/dist/decorators/actor.decorators.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Actor = Actor;
+exports.On = On;
+const constants_1 = require("./constants");
+function Actor(entityType, options) {
+    return (target) => {
+        const metadata = {
+            entityType,
+            defaultEntityId: options?.defaultEntityId,
+        };
+        Reflect.defineMetadata(constants_1.ACTOR_METADATA, metadata, target);
+        if (!Reflect.hasMetadata('injectable', target)) {
+            Reflect.defineMetadata('injectable', true, target);
+        }
+    };
+}
+function On(messageClass) {
+    return (target, propertyKey, descriptor) => {
+        const methodName = String(propertyKey);
+        const metadata = {
+            messageClass,
+            methodName,
+        };
+        Reflect.defineMetadata(constants_1.ACTOR_HANDLER_METADATA, metadata, target, propertyKey);
+        const existingHandlers = Reflect.getMetadata(constants_1.ACTOR_HANDLERS_METADATA, target.constructor) || [];
+        existingHandlers.push(metadata);
+        Reflect.defineMetadata(constants_1.ACTOR_HANDLERS_METADATA, existingHandlers, target.constructor);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=actor.decorators.js.map

package/dist/decorators/actor.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.decorators.js","sourceRoot":"","sources":["../../src/decorators/actor.decorators.ts"],"names":[],"mappings":";;AAGA,sBAYC;AAED,gBAsBC;AAvCD,2CAA8F;AAG9F,SAAgB,KAAK,CAAC,UAAkB,EAAE,OAAmD;IAC3F,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAiB;YAC7B,UAAU;YACV,eAAe,EAAE,OAAO,EAAE,eAAe;SAC1C,CAAC;QACF,OAAO,CAAC,cAAc,CAAC,0BAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEzD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,EAAE,CAAC,YAAsB;IACvC,OAAO,CACL,MAAc,EACd,WAA4B,EAC5B,UAA8B,EAC9B,EAAE;QACF,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAEvC,MAAM,QAAQ,GAAyB;YACrC,YAAY;YACZ,UAAU;SACX,CAAC;QAEF,OAAO,CAAC,cAAc,CAAC,kCAAsB,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAE9E,MAAM,gBAAgB,GACpB,OAAO,CAAC,WAAW,CAAC,mCAAuB,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACzE,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,CAAC,cAAc,CAAC,mCAAuB,EAAE,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAEtF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/constants.d.ts

@@ -1,17 +1,10 @@
-/**
- * Metadata keys for decorators
- */
-export declare const ATOMIC_PROCESSOR_METADATA = "atomic:processor";
 export declare const ENTITY_TYPE_METADATA = "atomic:entity-type";
 export declare const ENTITY_ID_METADATA = "atomic:entity-id";
-export declare const JOB_TYPE_METADATA = "atomic:job-type";
-export declare const WORKER_PROCESSOR_METADATA = "atomic:worker-processor";
-export declare const JOB_HANDLER_METADATA = "atomic:job-handler";
-export declare const ENTITY_SCALER_METADATA = "atomic:entity-scaler";
-export declare const GET_ACTIVE_ENTITIES_METADATA = "atomic:get-active-entities";
-export declare const GET_DESIRED_WORKER_COUNT_METADATA = "atomic:get-desired-worker-count";
-export declare const ON_SPAWN_WORKER_METADATA = "atomic:on-spawn-worker";
-export declare const ON_TERMINATE_WORKER_METADATA = "atomic:on-terminate-worker";
 export declare const JOB_COMMAND_METADATA = "atomic:job-command";
 export declare const JOB_QUERY_METADATA = "atomic:job-query";
+export declare const ACTOR_METADATA = "atomic:actor";
+export declare const ACTOR_HANDLER_METADATA = "atomic:actor-handler";
+export declare const ACTOR_HANDLERS_METADATA = "atomic:actor-handlers";
+export declare const SCHEMA_METADATA = "atomic:schema";
+export declare const REPLY_SCHEMA_METADATA = "atomic:reply-schema";
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/decorators/constants.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,yBAAyB,qBAAqB,CAAC;AAC5D,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AACzD,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AACrD,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AACnD,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AACnE,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AACzD,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAC7D,eAAO,MAAM,4BAA4B,+BAA+B,CAAC;AACzE,eAAO,MAAM,iCAAiC,oCAAoC,CAAC;AACnF,eAAO,MAAM,wBAAwB,2BAA2B,CAAC;AACjE,eAAO,MAAM,4BAA4B,+BAA+B,CAAC;AACzE,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AACzD,eAAO,MAAM,kBAAkB,qBAAqB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/decorators/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AACzD,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AAGrD,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AACzD,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AAGrD,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAC7C,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAC7D,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAG/D,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAC/C,eAAO,MAAM,qBAAqB,wBAAwB,CAAC"}

package/dist/decorators/constants.js

@@ -1,23 +1,17 @@
 "use strict";
-// =============================================================================
-// METADATA KEYS
-// =============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
-/**
- * Metadata keys for decorators
- */
-exports.ATOMIC_PROCESSOR_METADATA = 'atomic:processor';
+exports.REPLY_SCHEMA_METADATA = exports.SCHEMA_METADATA = exports.ACTOR_HANDLERS_METADATA = exports.ACTOR_HANDLER_METADATA = exports.ACTOR_METADATA = exports.JOB_QUERY_METADATA = exports.JOB_COMMAND_METADATA = exports.ENTITY_ID_METADATA = exports.ENTITY_TYPE_METADATA = void 0;
+// Entity routing
 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';
+// CQRS job routing
 exports.JOB_COMMAND_METADATA = 'atomic:job-command';
 exports.JOB_QUERY_METADATA = 'atomic:job-query';
+// Actor
+exports.ACTOR_METADATA = 'atomic:actor';
+exports.ACTOR_HANDLER_METADATA = 'atomic:actor-handler';
+exports.ACTOR_HANDLERS_METADATA = 'atomic:actor-handlers';
+// Schema
+exports.SCHEMA_METADATA = 'atomic:schema';
+exports.REPLY_SCHEMA_METADATA = 'atomic:reply-schema';
 //# sourceMappingURL=constants.js.map

package/dist/decorators/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/decorators/constants.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;;;AAEhF;;GAEG;AACU,QAAA,yBAAyB,GAAG,kBAAkB,CAAC;AAC/C,QAAA,oBAAoB,GAAG,oBAAoB,CAAC;AAC5C,QAAA,kBAAkB,GAAG,kBAAkB,CAAC;AACxC,QAAA,iBAAiB,GAAG,iBAAiB,CAAC;AACtC,QAAA,yBAAyB,GAAG,yBAAyB,CAAC;AACtD,QAAA,oBAAoB,GAAG,oBAAoB,CAAC;AAC5C,QAAA,sBAAsB,GAAG,sBAAsB,CAAC;AAChD,QAAA,4BAA4B,GAAG,4BAA4B,CAAC;AAC5D,QAAA,iCAAiC,GAAG,iCAAiC,CAAC;AACtE,QAAA,wBAAwB,GAAG,wBAAwB,CAAC;AACpD,QAAA,4BAA4B,GAAG,4BAA4B,CAAC;AAC5D,QAAA,oBAAoB,GAAG,oBAAoB,CAAC;AAC5C,QAAA,kBAAkB,GAAG,kBAAkB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/decorators/constants.ts"],"names":[],"mappings":";;;AAAA,iBAAiB;AACJ,QAAA,oBAAoB,GAAG,oBAAoB,CAAC;AAC5C,QAAA,kBAAkB,GAAG,kBAAkB,CAAC;AAErD,mBAAmB;AACN,QAAA,oBAAoB,GAAG,oBAAoB,CAAC;AAC5C,QAAA,kBAAkB,GAAG,kBAAkB,CAAC;AAErD,QAAQ;AACK,QAAA,cAAc,GAAG,cAAc,CAAC;AAChC,QAAA,sBAAsB,GAAG,sBAAsB,CAAC;AAChD,QAAA,uBAAuB,GAAG,uBAAuB,CAAC;AAE/D,SAAS;AACI,QAAA,eAAe,GAAG,eAAe,CAAC;AAClC,QAAA,qBAAqB,GAAG,qBAAqB,CAAC"}

package/dist/decorators/index.d.ts

@@ -1,10 +1,10 @@
 export * from './constants';
 export * from './interfaces';
 export * from './entity.decorators';
-export * from './worker.decorators';
-export * from './scaler.decorators';
 export * from './job.decorators';
-export * from './legacy.decorators';
+export * from './actor.decorators';
+export * from './schema.decorators';
 export * from './metadata-readers';
-export * from './type-guards';
+export * from './registry';
+export * from './utils';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

package/dist/decorators/index.js

@@ -17,10 +17,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./constants"), exports);
 __exportStar(require("./interfaces"), exports);
 __exportStar(require("./entity.decorators"), exports);
-__exportStar(require("./worker.decorators"), exports);
-__exportStar(require("./scaler.decorators"), exports);
 __exportStar(require("./job.decorators"), exports);
-__exportStar(require("./legacy.decorators"), exports);
+__exportStar(require("./actor.decorators"), exports);
+__exportStar(require("./schema.decorators"), exports);
 __exportStar(require("./metadata-readers"), exports);
-__exportStar(require("./type-guards"), exports);
+__exportStar(require("./registry"), exports);
+__exportStar(require("./utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,+CAA6B;AAC7B,sDAAoC;AACpC,sDAAoC;AACpC,sDAAoC;AACpC,mDAAiC;AACjC,sDAAoC;AACpC,qDAAmC;AACnC,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,+CAA6B;AAC7B,sDAAoC;AACpC,mDAAiC;AACjC,qDAAmC;AACnC,sDAAoC;AACpC,qDAAmC;AACnC,6CAA2B;AAC3B,0CAAwB"}

package/dist/decorators/interfaces.d.ts

@@ -1,56 +1,3 @@
-import { Type } from '@nestjs/common';
-import { IWorkerConfig } from '../domain';
-/**
- * Options for @WorkerProcessor decorator
- */
-export interface WorkerProcessorOptions {
-    /** Entity type this processor handles (e.g., 'table', 'user') */
-    entityType: string;
-    /** Default property name for entity ID extraction (optional) */
-    defaultEntityId?: string;
-    /** Function to generate queue name from entityId */
-    queueName?: string | ((entityId: string) => string);
-    /** Function to generate worker name from entityId */
-    workerName?: string | ((entityId: string) => string);
-    /** Worker configuration */
-    workerConfig?: IWorkerConfig;
-    /**
-     * If true, workerConfig fully replaces module workerDefaults (no merge).
-     * If false (default), workerConfig is merged with workerDefaults.
-     */
-    overrideDefaults?: boolean;
-    /**
-     * Maximum workers per entity (default: 1).
-     * Used when operating without an EntityScaler.
-     */
-    maxWorkersPerEntity?: number;
-    /**
-     * Idle timeout in seconds before a worker is considered idle and can be terminated.
-     * Workers self-report idle time via heartbeat. Default: 15 seconds.
-     * Used when operating without an EntityScaler.
-     */
-    idleTimeoutSeconds?: number;
-    /**
-     * If true, workers are automatically spawned when jobs arrive (scalerless mode).
-     * When enabled, no @EntityScaler is required - workers spawn on job arrival
-     * and terminate when idle. Default: true if no EntityScaler is registered.
-     */
-    autoSpawn?: boolean;
-}
-/**
- * Options for @EntityScaler decorator
- */
-export interface EntityScalerOptions {
-    /** Entity type this scaler handles */
-    entityType: string;
-    /** Maximum workers per entity */
-    maxWorkersPerEntity?: number;
-    /**
-     * Idle timeout in seconds before a worker is considered idle and can be terminated.
-     * Workers self-report idle time via heartbeat. Default: 15 seconds.
-     */
-    idleTimeoutSeconds?: number;
-}
 /**
  * Options for @JobCommand decorator
  */
@@ -94,37 +41,30 @@ export interface JobQueryMetadata {
     paramNames: string[];
 }
 /**
- * Stored job handler metadata
+ * Options for @Actor decorator
  */
-export interface JobHandlerMetadata {
-    jobName: string;
-    methodName: string;
-    isWildcard: boolean;
+export interface ActorOptions {
+    /** Entity type this actor handles */
+    entityType: string;
+    /** Default property name for entity ID extraction */
+    defaultEntityId?: string;
 }
 /**
- * Stored worker processor metadata
+ * Stored actor handler metadata
  */
-export interface WorkerProcessorMetadata {
-    entityType: string;
-    defaultEntityId?: string;
-    queueNameFn: (entityId: string) => string;
-    workerNameFn: (entityId: string) => string;
-    workerConfig: IWorkerConfig;
-    overrideDefaults: boolean;
-    targetClass: Type<any>;
-    jobHandlers: Map<string, JobHandlerMetadata>;
-    wildcardHandler?: JobHandlerMetadata;
+export interface ActorHandlerMetadata {
+    /** The message class this handler processes */
+    messageClass: Function;
+    /** The method name on the actor class */
+    methodName: string;
 }
 /**
- * Stored entity scaler metadata
+ * Options for @Schema decorator
  */
-export interface EntityScalerMetadata {
-    entityType: string;
-    maxWorkersPerEntity: number;
-    targetClass: Type<any>;
-    getActiveEntitiesMethod?: string;
-    getDesiredWorkerCountMethod?: string;
-    onSpawnWorkerMethod?: string;
-    onTerminateWorkerMethod?: string;
+export interface SchemaDecoratorOptions {
+    /** The Zod schema for the message payload */
+    schema: any;
+    /** Optional reply schema (for queries) */
+    replySchema?: any;
 }
 //# sourceMappingURL=interfaces.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/decorators/interfaces.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/decorators/interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,WAAW,EAAE,QAAQ,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,WAAW,EAAE,QAAQ,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,YAAY,EAAE,QAAQ,CAAC;IACvB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,MAAM,EAAE,GAAG,CAAC;IACZ,0CAA0C;IAC1C,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB"}

package/dist/decorators/metadata-readers.d.ts

@@ -1,31 +1,10 @@
-import { Type } from '@nestjs/common';
-import { WorkerProcessorOptions, JobHandlerMetadata, EntityScalerOptions, JobCommandMetadata, JobQueryMetadata } from './interfaces';
-/**
- * Get the entity type from a command/query class decorated with @EntityType or @QueueEntity
- */
+import { JobCommandMetadata, JobQueryMetadata, ActorOptions, ActorHandlerMetadata } from './interfaces';
 export declare function getEntityType(target: Function): string | undefined;
-/**
- * Get the entity ID property name from a class decorated with @QueueEntityId or @QueueEntity
- */
 export declare function getEntityIdProperty(target: Function): string | undefined;
-/**
- * Get WorkerProcessor metadata from a class
- */
-export declare function getWorkerProcessorMetadata(target: Type<any>): WorkerProcessorOptions | undefined;
-/**
- * Get all JobHandler metadata from a class
- */
-export declare function getJobHandlerMetadata(target: Type<any>): JobHandlerMetadata[];
-/**
- * Get EntityScaler metadata from a class
- */
-export declare function getEntityScalerMetadata(target: Type<any>): EntityScalerOptions | undefined;
-/**
- * Get JobCommand metadata from a class
- */
 export declare function getJobCommandMetadata(target: Function): JobCommandMetadata | undefined;
-/**
- * Get JobQuery metadata from a class
- */
 export declare function getJobQueryMetadata(target: Function): JobQueryMetadata | undefined;
+export declare function getActorMetadata(target: Function): ActorOptions | undefined;
+export declare function getActorHandlers(target: Function): ActorHandlerMetadata[];
+export declare function getSchemaMetadata(target: Function): any | undefined;
+export declare function getReplySchemaMetadata(target: Function): any | undefined;
 //# sourceMappingURL=metadata-readers.d.ts.map

package/dist/decorators/metadata-readers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-readers.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata-readers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAUtC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,sBAAsB,GAAG,SAAS,CAEhG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,kBAAkB,EAAE,CAE7E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,mBAAmB,GAAG,SAAS,CAE1F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAEtF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAElF"}
+{"version":3,"file":"metadata-readers.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata-readers.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAEtB,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAExE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAEtF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAElF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAE3E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,oBAAoB,EAAE,CAEzE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,GAAG,GAAG,SAAS,CAEnE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,GAAG,GAAG,SAAS,CAExE"}