@hexaijs/plugin-application-builder 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Sangwoo Hyun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,278 @@
+# @hexaijs/plugin-application-builder
+
+> Build plugin for generating ApplicationBuilder code from decorated handlers
+
+## Overview
+
+`@hexaijs/plugin-application-builder` eliminates the boilerplate of manually registering every handler with `ApplicationBuilder`. Instead of maintaining a growing list of `.withCommandHandler()` and `.withEventHandler()` calls, you decorate your handler classes and let the build tool generate the registration code automatically.
+
+The plugin works at build time by:
+
+1. Scanning your TypeScript files for handler classes decorated with marker decorators
+2. Extracting metadata using TypeScript's AST (Abstract Syntax Tree) parser
+3. Generating a `createApplicationBuilder()` function with all handlers properly registered
+
+This approach keeps your handler files self-documenting (the decorator shows what type of handler it is) while centralizing the wiring in a generated file that stays in sync automatically.
+
+## Installation
+
+```bash
+npm install @hexaijs/plugin-application-builder
+```
+
+**Peer dependencies:**
+- `@hexaijs/core`
+- `@hexaijs/application`
+- `typescript ^5.0.0`
+
+## Core Concepts
+
+### Marker Decorators
+
+The package provides three decorators that serve as markers for the code generator. These decorators have **no runtime behavior** - they simply tag classes for discovery during the build process.
+
+```typescript
+import {
+    CommandHandlerMarker,
+    QueryHandlerMarker,
+    EventHandlerMarker
+} from "@hexaijs/plugin-application-builder";
+```
+
+**CommandHandlerMarker** - Marks a class as a command handler and links it to its request type:
+
+```typescript
+import { CommandHandlerMarker } from "@hexaijs/plugin-application-builder";
+import { CreateOrderRequest } from "./request";
+
+@CommandHandlerMarker(CreateOrderRequest)
+export class CreateOrderHandler extends BaseHandler<
+    CreateOrderRequest,
+    CreateOrderResponse,
+    OrderApplicationContext
+> {
+    protected async doExecute(
+        request: CreateOrderRequest,
+        ctx: OrderApplicationContext
+    ): Promise<CreateOrderResponse> {
+        // Implementation
+    }
+}
+```
+
+**QueryHandlerMarker** - Marks a class as a query handler:
+
+```typescript
+import { QueryHandlerMarker } from "@hexaijs/plugin-application-builder";
+import { GetOrderQuery } from "./query";
+
+@QueryHandlerMarker(GetOrderQuery)
+export class GetOrderHandler extends BaseHandler<
+    GetOrderQuery,
+    OrderDto,
+    OrderApplicationContext
+> {
+    protected async doExecute(
+        query: GetOrderQuery,
+        ctx: OrderApplicationContext
+    ): Promise<OrderDto> {
+        // Implementation
+    }
+}
+```
+
+**EventHandlerMarker** - Marks a class as an event handler:
+
+```typescript
+import { Message } from "@hexaijs/core";
+import { EventHandlerMarker } from "@hexaijs/plugin-application-builder";
+
+@EventHandlerMarker()
+export class HandleOrderPlaced extends BaseEventHandler<OrderApplicationContext> {
+    canHandle(message: Message): message is OrderPlaced {
+        return message.getMessageType() === OrderPlaced.getType();
+    }
+
+    async handle(
+        event: OrderPlaced,
+        ctx: OrderApplicationContext
+    ): Promise<void> {
+        const payload = event.getPayload();
+        // React to event
+    }
+}
+```
+
+For event handlers that need a unique identifier (useful for idempotency tracking), provide a `name` option:
+
+```typescript
+@EventHandlerMarker({ name: "send-order-confirmation" })
+export class SendOrderConfirmationEmail extends BaseEventHandler<OrderApplicationContext> {
+    // ...
+}
+```
+
+### Configuration
+
+Create an `application.config.ts` file in your package root:
+
+```typescript
+import { RawBuildPluginConfig } from "@hexaijs/plugin-application-builder";
+
+const config: RawBuildPluginConfig = {
+    // Glob patterns to find handler files
+    handlers: [
+        "src/commands/**/*.ts",
+        "src/queries/**/*.ts",
+        "src/event-handlers/**/*.ts"
+    ],
+
+    // Import path for ApplicationBuilder in generated code
+    applicationBuilderImportPath: "@/application-builder",
+
+    // Output file path (optional, defaults to "src/.generated/application-builder.ts")
+    outputFile: "src/.generated/application-builder.ts"
+};
+
+export default config;
+```
+
+| Option | Required | Default | Description |
+|--------|----------|---------|-------------|
+| `handlers` | Yes | - | Glob patterns for files containing decorated handlers |
+| `applicationBuilderImportPath` | Yes | - | Import path for your `ApplicationBuilder` class |
+| `outputFile` | No | `src/.generated/application-builder.ts` | Where to write the generated code |
+
+### Code Generation
+
+Run the generator using the CLI:
+
+```bash
+npx generate-app-builder
+```
+
+Or specify a custom path:
+
+```bash
+npx generate-app-builder --context-path ./packages/my-bounded-context
+```
+
+The generator produces a file like:
+
+```typescript
+// src/.generated/application-builder.ts (auto-generated)
+import { ApplicationBuilder } from '@/application-builder';
+import { CreateOrderHandler } from '../commands/create-order/handler';
+import { CreateOrderRequest } from '../commands/create-order/request';
+import { GetOrderHandler } from '../queries/get-order/handler';
+import { GetOrderQuery } from '../queries/get-order/query';
+import { HandleOrderPlaced } from '../event-handlers/handle-order-placed';
+
+export function createApplicationBuilder(): ApplicationBuilder {
+  return new ApplicationBuilder()
+    .withCommandHandler(CreateOrderRequest, () => new CreateOrderHandler())
+    .withQueryHandler(GetOrderQuery, () => new GetOrderHandler())
+    .withEventHandler(() => new HandleOrderPlaced());
+}
+```
+
+### Programmatic API
+
+For custom build scripts, use the `generateApplicationBuilder` function:
+
+```typescript
+import { generateApplicationBuilder } from "@hexaijs/plugin-application-builder";
+
+await generateApplicationBuilder("./packages/order", {
+    configFile: "application.config.ts"  // optional
+});
+```
+
+## Usage
+
+### Integrating into Your Build
+
+Add the generator to your build scripts:
+
+```json
+{
+  "scripts": {
+    "prebuild": "generate-app-builder",
+    "build": "tsc"
+  }
+}
+```
+
+This ensures the generated file is always up-to-date before compilation.
+
+### Using the Generated Builder
+
+Import and use the generated function in your application setup:
+
+```typescript
+import { createApplicationBuilder } from "./.generated/application-builder";
+
+// The generated builder has all handlers registered
+const builder = createApplicationBuilder();
+
+// Add your application context and build
+const application = builder
+    .withApplicationContext(new OrderApplicationContext())
+    .build();
+```
+
+### Path Alias Support
+
+The generator respects TypeScript path aliases defined in your `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  }
+}
+```
+
+When handlers import request classes using aliases (e.g., `import { CreateOrderRequest } from "@/commands/create-order/request"`), the generator correctly resolves these paths.
+
+## Error Handling
+
+The generator validates your configuration and throws descriptive errors:
+
+**DuplicateCommandHandlerError** - Thrown when multiple handlers are registered for the same command:
+
+```
+Duplicate command handlers for "CreateOrderRequest": CreateOrderHandler, AnotherCreateOrderHandler
+```
+
+**DuplicateQueryHandlerError** - Thrown when multiple handlers are registered for the same query.
+
+**DuplicateEventHandlerError** - Thrown when multiple event handlers share the same `name` option.
+
+**MessageClassNotFoundError** - Thrown when a decorator references a class that cannot be found:
+
+```
+Cannot find "CreateOrderRequest" - not imported and not defined in "src/commands/create-order/handler.ts"
+```
+
+## API Highlights
+
+| Export | Description |
+|--------|-------------|
+| `generateApplicationBuilder(path, options?)` | Programmatic API to run code generation |
+| `CommandHandlerMarker` | Decorator to mark command handlers |
+| `QueryHandlerMarker` | Decorator to mark query handlers |
+| `EventHandlerMarker` | Decorator to mark event handlers |
+| `EventHandlerOptions` | Type for event handler decorator options |
+| `DuplicateCommandHandlerError` | Error for duplicate command handler registration |
+| `DuplicateQueryHandlerError` | Error for duplicate query handler registration |
+| `DuplicateEventHandlerError` | Error for duplicate event handler registration |
+| `HandlerMetadataExtractor` | Class for extracting handler metadata from TypeScript files |
+
+## See Also
+
+- [@hexaijs/application](../application/README.md) - The ApplicationBuilder this plugin generates code for
+- [@hexaijs/core](../core/README.md) - Core domain primitives used by handlers

package/dist/application-builder-generator.d.ts

@@ -0,0 +1,15 @@
+import { BuildPluginConfig } from "./config";
+/**
+ * Orchestrates the application builder generation process
+ */
+export declare class ApplicationBuilderGenerator {
+    private contextPath;
+    private config;
+    private metadataExtractor;
+    private codeGenerator;
+    constructor(contextPath: string, config: BuildPluginConfig);
+    generate(): Promise<void>;
+    private scanHandlerFiles;
+    private writeToFile;
+}
+//# sourceMappingURL=application-builder-generator.d.ts.map

package/dist/application-builder-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-builder-generator.d.ts","sourceRoot":"","sources":["../src/application-builder-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAI7C;;GAEG;AACH,qBAAa,2BAA2B;IAKhC,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM;IALlB,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,aAAa,CAA2B;gBAGpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB;IAS/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAOjB,gBAAgB;IAc9B,OAAO,CAAC,WAAW;CAOtB"}

package/dist/application-builder-generator.js

@@ -0,0 +1,81 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplicationBuilderGenerator = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const glob_1 = require("glob");
+const metadata_extractor_1 = require("./metadata-extractor");
+const code_generator_1 = require("./code-generator");
+/**
+ * Orchestrates the application builder generation process
+ */
+class ApplicationBuilderGenerator {
+    contextPath;
+    config;
+    metadataExtractor;
+    codeGenerator;
+    constructor(contextPath, config) {
+        this.contextPath = contextPath;
+        this.config = config;
+        this.metadataExtractor = new metadata_extractor_1.HandlerMetadataExtractor(contextPath, config.outputFile);
+        this.codeGenerator = new code_generator_1.ApplicationCodeGenerator(config);
+    }
+    async generate() {
+        const handlerFiles = await this.scanHandlerFiles();
+        const handlers = this.metadataExtractor.extractHandlersMetadata(handlerFiles);
+        const code = this.codeGenerator.generateCode(handlers);
+        this.writeToFile(code);
+    }
+    async scanHandlerFiles() {
+        const allFiles = [];
+        for (const pattern of this.config.handlers) {
+            const files = await (0, glob_1.glob)(pattern, {
+                cwd: this.contextPath,
+                absolute: true,
+            });
+            allFiles.push(...files);
+        }
+        return allFiles.sort();
+    }
+    writeToFile(code) {
+        const outputFile = path.join(this.contextPath, this.config.outputFile);
+        const outputDir = path.dirname(outputFile);
+        fs.mkdirSync(outputDir, { recursive: true });
+        fs.writeFileSync(outputFile, code, "utf-8");
+    }
+}
+exports.ApplicationBuilderGenerator = ApplicationBuilderGenerator;
+//# sourceMappingURL=application-builder-generator.js.map

package/dist/application-builder-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-builder-generator.js","sourceRoot":"","sources":["../src/application-builder-generator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAC7B,+BAA4B;AAE5B,6DAAgE;AAChE,qDAA4D;AAE5D;;GAEG;AACH,MAAa,2BAA2B;IAKxB;IACA;IALJ,iBAAiB,CAA2B;IAC5C,aAAa,CAA2B;IAEhD,YACY,WAAmB,EACnB,MAAyB;QADzB,gBAAW,GAAX,WAAW,CAAQ;QACnB,WAAM,GAAN,MAAM,CAAmB;QAEjC,IAAI,CAAC,iBAAiB,GAAG,IAAI,6CAAwB,CACjD,WAAW,EACX,MAAM,CAAC,UAAU,CACpB,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,IAAI,yCAAwB,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,gBAAgB;QAC1B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,MAAM,IAAA,WAAI,EAAC,OAAO,EAAE;gBAC9B,GAAG,EAAE,IAAI,CAAC,WAAW;gBACrB,QAAQ,EAAE,IAAI;aACjB,CAAC,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAEO,WAAW,CAAC,IAAY;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE3C,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;CACJ;AA3CD,kEA2CC"}

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,61 @@
+#!/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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = __importStar(require("path"));
+const index_1 = require("./index");
+async function main() {
+    const args = process.argv.slice(2);
+    // Support --context-path or default to cwd
+    let contextPath = process.cwd();
+    const contextPathIndex = args.indexOf("--context-path");
+    if (contextPathIndex !== -1 && args[contextPathIndex + 1]) {
+        contextPath = path.resolve(args[contextPathIndex + 1]);
+    }
+    try {
+        console.log(`Generating application builder for: ${contextPath}`);
+        await (0, index_1.generateApplicationBuilder)(contextPath);
+        console.log("✓ Application builder generated successfully");
+    }
+    catch (error) {
+        console.error("Error generating application builder:", error);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error("Unexpected error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,2CAA6B;AAC7B,mCAAqD;AAErD,KAAK,UAAU,IAAI;IACf,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,2CAA2C;IAC3C,IAAI,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAEhC,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxD,IAAI,gBAAgB,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC;QACxD,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,uCAAuC,WAAW,EAAE,CAAC,CAAC;QAClE,MAAM,IAAA,kCAA0B,EAAC,WAAW,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/code-generator.d.ts

@@ -0,0 +1,30 @@
+import { BuildPluginConfig } from "./config";
+import { HandlerMetadata } from "./types";
+/**
+ * Generates TypeScript code for ApplicationBuilder
+ */
+export declare class ApplicationCodeGenerator {
+    private config;
+    constructor(config: BuildPluginConfig);
+    generateCode(handlers: HandlerMetadata[]): string;
+    private validateNoDuplicates;
+    private validateNoDuplicateHandlers;
+    private validateNoDuplicateCommandHandlers;
+    private validateNoDuplicateEventHandlers;
+    private validateNoDuplicateQueryHandlers;
+    private createImportStatement;
+    private createCommandHandlerRegistration;
+    private createEventHandlerRegistration;
+    private createQueryHandlerRegistration;
+    private isCommandHandler;
+    private isEventHandler;
+    private isQueryHandler;
+    private collectImports;
+    private generateRegistrations;
+    private generateCommandRegistrations;
+    private generateQueryRegistrations;
+    private generateEventRegistrations;
+    private validateEventHandlerOptions;
+    private assembleGeneratedCode;
+}
+//# sourceMappingURL=code-generator.d.ts.map

package/dist/code-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generator.d.ts","sourceRoot":"","sources":["../src/code-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAM7C,OAAO,EACH,eAAe,EAIlB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,wBAAwB;IACrB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAE7C,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM;IAOjD,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,2BAA2B;IAuBnC,OAAO,CAAC,kCAAkC;IAW1C,OAAO,CAAC,gCAAgC;IAmBxC,OAAO,CAAC,gCAAgC;IAWxC,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,gCAAgC;IAOxC,OAAO,CAAC,8BAA8B;IAQtC,OAAO,CAAC,8BAA8B;IAOtC,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,cAAc;IAuCtB,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,4BAA4B;IAepC,OAAO,CAAC,0BAA0B;IAelC,OAAO,CAAC,0BAA0B;IAalC,OAAO,CAAC,2BAA2B;IAcnC,OAAO,CAAC,qBAAqB;CAehC"}

package/dist/code-generator.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplicationCodeGenerator = void 0;
+const errors_1 = require("./errors");
+/**
+ * Generates TypeScript code for ApplicationBuilder
+ */
+class ApplicationCodeGenerator {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    generateCode(handlers) {
+        this.validateNoDuplicates(handlers);
+        const imports = this.collectImports(handlers);
+        const registrations = this.generateRegistrations(handlers);
+        return this.assembleGeneratedCode(imports, registrations);
+    }
+    validateNoDuplicates(handlers) {
+        this.validateNoDuplicateCommandHandlers(handlers);
+        this.validateNoDuplicateEventHandlers(handlers);
+        this.validateNoDuplicateQueryHandlers(handlers);
+    }
+    validateNoDuplicateHandlers(handlers, typeFilter, keyExtractor, errorFactory) {
+        const filteredHandlers = handlers.filter(typeFilter);
+        const keyToHandlers = new Map();
+        for (const handler of filteredHandlers) {
+            const key = keyExtractor(handler);
+            const existing = keyToHandlers.get(key) ?? [];
+            existing.push(handler.handlerClassName);
+            keyToHandlers.set(key, existing);
+        }
+        for (const [key, handlerList] of keyToHandlers) {
+            if (handlerList.length > 1) {
+                throw errorFactory(key, handlerList);
+            }
+        }
+    }
+    validateNoDuplicateCommandHandlers(handlers) {
+        this.validateNoDuplicateHandlers(handlers, (h) => h.type === "command", (h) => h.commandClassName, (key, handlers) => new errors_1.DuplicateCommandHandlerError(key, handlers));
+    }
+    validateNoDuplicateEventHandlers(handlers) {
+        const eventHandlers = handlers.filter((h) => h.type === "event");
+        const namedEventHandlers = eventHandlers.filter((h) => h.eventHandlerOptions.name !== undefined);
+        this.validateNoDuplicateHandlers(namedEventHandlers, (h) => true, (h) => h.eventHandlerOptions.name, (key, handlers) => new errors_1.DuplicateEventHandlerError(key, handlers));
+    }
+    validateNoDuplicateQueryHandlers(handlers) {
+        this.validateNoDuplicateHandlers(handlers, (h) => h.type === "query", (h) => h.queryClassName, (key, handlers) => new errors_1.DuplicateQueryHandlerError(key, handlers));
+    }
+    createImportStatement(symbolName, importPath) {
+        return `import { ${symbolName} } from '${importPath}';`;
+    }
+    createCommandHandlerRegistration(commandClassName, handlerClassName) {
+        return `    .withCommandHandler(${commandClassName}, () => new ${handlerClassName}())`;
+    }
+    createEventHandlerRegistration(handlerClassName, eventName) {
+        const nameArg = eventName ? `, '${eventName}'` : "";
+        return `    .withEventHandler(() => new ${handlerClassName}()${nameArg})`;
+    }
+    createQueryHandlerRegistration(queryClassName, handlerClassName) {
+        return `    .withQueryHandler(${queryClassName}, () => new ${handlerClassName}())`;
+    }
+    isCommandHandler(handler) {
+        return handler.type === "command";
+    }
+    isEventHandler(handler) {
+        return handler.type === "event";
+    }
+    isQueryHandler(handler) {
+        return handler.type === "query";
+    }
+    collectImports(handlers) {
+        const imports = new Set();
+        imports.add(this.createImportStatement("ApplicationBuilder", this.config.applicationBuilderImportPath));
+        for (const handler of handlers) {
+            imports.add(this.createImportStatement(handler.handlerClassName, handler.handlerPath));
+            if (this.isCommandHandler(handler) && handler.commandPath) {
+                imports.add(this.createImportStatement(handler.commandClassName, handler.commandPath));
+            }
+            if (this.isQueryHandler(handler) && handler.queryPath) {
+                imports.add(this.createImportStatement(handler.queryClassName, handler.queryPath));
+            }
+        }
+        return imports;
+    }
+    generateRegistrations(handlers) {
+        const commandRegistrations = this.generateCommandRegistrations(handlers);
+        const queryRegistrations = this.generateQueryRegistrations(handlers);
+        const eventRegistrations = this.generateEventRegistrations(handlers);
+        return [...commandRegistrations, ...queryRegistrations, ...eventRegistrations];
+    }
+    generateCommandRegistrations(handlers) {
+        return handlers
+            .filter((h) => this.isCommandHandler(h))
+            .map((h) => this.createCommandHandlerRegistration(h.commandClassName, h.handlerClassName));
+    }
+    generateQueryRegistrations(handlers) {
+        return handlers
+            .filter((h) => this.isQueryHandler(h))
+            .map((h) => this.createQueryHandlerRegistration(h.queryClassName, h.handlerClassName));
+    }
+    generateEventRegistrations(handlers) {
+        return handlers
+            .filter((h) => this.isEventHandler(h))
+            .map((handler) => {
+            this.validateEventHandlerOptions(handler);
+            const eventName = handler.eventHandlerOptions.name;
+            return this.createEventHandlerRegistration(handler.handlerClassName, eventName);
+        });
+    }
+    validateEventHandlerOptions(handler) {
+        const options = handler.eventHandlerOptions;
+        const invalidKeys = Object.keys(options).filter((key) => key !== "name");
+        if (invalidKeys.length > 0) {
+            throw new Error(`EventHandler for ${handler.handlerClassName} has invalid options: ${invalidKeys.join(", ")}.\n` +
+                `Only 'name' option is supported. Use @EventHandler({ name: 'event-name' })`);
+        }
+    }
+    assembleGeneratedCode(imports, registrations) {
+        const registrationCode = registrations.length > 0 ? "\n" + registrations.join("\n") : "";
+        return `
+${Array.from(imports).join("\n")}
+
+export function createApplicationBuilder(): ApplicationBuilder {
+  return new ApplicationBuilder()${registrationCode};
+}
+`;
+    }
+}
+exports.ApplicationCodeGenerator = ApplicationCodeGenerator;
+//# sourceMappingURL=code-generator.js.map

package/dist/code-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generator.js","sourceRoot":"","sources":["../src/code-generator.ts"],"names":[],"mappings":";;;AACA,qCAIkB;AAQlB;;GAEG;AACH,MAAa,wBAAwB;IACb;IAApB,YAAoB,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAEjD,YAAY,CAAC,QAA2B;QACpC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC9D,CAAC;IAEO,oBAAoB,CAAC,QAA2B;QACpD,IAAI,CAAC,kCAAkC,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,gCAAgC,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,gCAAgC,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAEO,2BAA2B,CAC/B,QAA2B,EAC3B,UAA0C,EAC1C,YAA8B,EAC9B,YAAwD;QAExD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAErD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAoB,CAAC;QAClD,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;YACxC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,aAAa,EAAE,CAAC;YAC7C,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YACzC,CAAC;QACL,CAAC;IACL,CAAC;IAEO,kCAAkC,CACtC,QAA2B;QAE3B,IAAI,CAAC,2BAA2B,CAC5B,QAAQ,EACR,CAAC,CAAC,EAA+B,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,EACxD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,EACzB,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,qCAA4B,CAAC,GAAG,EAAE,QAAQ,CAAC,CACrE,CAAC;IACN,CAAC;IAEO,gCAAgC,CACpC,QAA2B;QAE3B,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CACjC,CAAC,CAAC,EAA6B,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CACvD,CAAC;QAEF,MAAM,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,KAAK,SAAS,CAClD,CAAC;QAEF,IAAI,CAAC,2BAA2B,CAC5B,kBAAkB,EAClB,CAAC,CAAC,EAA6B,EAAE,CAAC,IAAI,EACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAK,EAClC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,mCAA0B,CAAC,GAAG,EAAE,QAAQ,CAAC,CACnE,CAAC;IACN,CAAC;IAEO,gCAAgC,CACpC,QAA2B;QAE3B,IAAI,CAAC,2BAA2B,CAC5B,QAAQ,EACR,CAAC,CAAC,EAA6B,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,EACpD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,EACvB,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,mCAA0B,CAAC,GAAG,EAAE,QAAQ,CAAC,CACnE,CAAC;IACN,CAAC;IAEO,qBAAqB,CACzB,UAAkB,EAClB,UAAkB;QAElB,OAAO,YAAY,UAAU,YAAY,UAAU,IAAI,CAAC;IAC5D,CAAC;IAEO,gCAAgC,CACpC,gBAAwB,EACxB,gBAAwB;QAExB,OAAO,2BAA2B,gBAAgB,eAAe,gBAAgB,KAAK,CAAC;IAC3F,CAAC;IAEO,8BAA8B,CAClC,gBAAwB,EACxB,SAAkB;QAElB,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,mCAAmC,gBAAgB,KAAK,OAAO,GAAG,CAAC;IAC9E,CAAC;IAEO,8BAA8B,CAClC,cAAsB,EACtB,gBAAwB;QAExB,OAAO,yBAAyB,cAAc,eAAe,gBAAgB,KAAK,CAAC;IACvF,CAAC;IAEO,gBAAgB,CACpB,OAAwB;QAExB,OAAO,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC;IACtC,CAAC;IAEO,cAAc,CAClB,OAAwB;QAExB,OAAO,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC;IACpC,CAAC;IAEO,cAAc,CAClB,OAAwB;QAExB,OAAO,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC;IACpC,CAAC;IAEO,cAAc,CAAC,QAA2B;QAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,OAAO,CAAC,GAAG,CACP,IAAI,CAAC,qBAAqB,CACtB,oBAAoB,EACpB,IAAI,CAAC,MAAM,CAAC,4BAA4B,CAC3C,CACJ,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CACP,IAAI,CAAC,qBAAqB,CACtB,OAAO,CAAC,gBAAgB,EACxB,OAAO,CAAC,WAAW,CACtB,CACJ,CAAC;YAEF,IAAI,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBACxD,OAAO,CAAC,GAAG,CACP,IAAI,CAAC,qBAAqB,CACtB,OAAO,CAAC,gBAAgB,EACxB,OAAO,CAAC,WAAW,CACtB,CACJ,CAAC;YACN,CAAC;YAED,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACpD,OAAO,CAAC,GAAG,CACP,IAAI,CAAC,qBAAqB,CACtB,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,SAAS,CACpB,CACJ,CAAC;YACN,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAEO,qBAAqB,CAAC,QAA2B;QACrD,MAAM,oBAAoB,GACtB,IAAI,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,kBAAkB,GAAG,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QACrE,MAAM,kBAAkB,GAAG,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,oBAAoB,EAAE,GAAG,kBAAkB,EAAE,GAAG,kBAAkB,CAAC,CAAC;IACnF,CAAC;IAEO,4BAA4B,CAChC,QAA2B;QAE3B,OAAO,QAAQ;aACV,MAAM,CAAC,CAAC,CAAC,EAA+B,EAAE,CACvC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAC3B;aACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACP,IAAI,CAAC,gCAAgC,CACjC,CAAC,CAAC,gBAAgB,EAClB,CAAC,CAAC,gBAAgB,CACrB,CACJ,CAAC;IACV,CAAC;IAEO,0BAA0B,CAC9B,QAA2B;QAE3B,OAAO,QAAQ;aACV,MAAM,CAAC,CAAC,CAAC,EAA6B,EAAE,CACrC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CACzB;aACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACP,IAAI,CAAC,8BAA8B,CAC/B,CAAC,CAAC,cAAc,EAChB,CAAC,CAAC,gBAAgB,CACrB,CACJ,CAAC;IACV,CAAC;IAEO,0BAA0B,CAAC,QAA2B;QAC1D,OAAO,QAAQ;aACV,MAAM,CAAC,CAAC,CAAC,EAA6B,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;aAChE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACb,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC;YACnD,OAAO,IAAI,CAAC,8BAA8B,CACtC,OAAO,CAAC,gBAAgB,EACxB,SAAS,CACZ,CAAC;QACN,CAAC,CAAC,CAAC;IACX,CAAC;IAEO,2BAA2B,CAAC,OAA6B;QAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;QAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAC3C,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CAC1B,CAAC;QAEF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACX,oBAAoB,OAAO,CAAC,gBAAgB,yBAAyB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;gBAC5F,4EAA4E,CACnF,CAAC;QACN,CAAC;IACL,CAAC;IAEO,qBAAqB,CACzB,OAAoB,EACpB,aAAuB;QAEvB,MAAM,gBAAgB,GAClB,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEpE,OAAO;EACb,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;mCAGG,gBAAgB;;CAElD,CAAC;IACE,CAAC;CACJ;AAtPD,4DAsPC"}

package/dist/config-loader.d.ts

@@ -0,0 +1,3 @@
+import { BuildPluginConfig } from "./config";
+export declare function loadConfig(configPath: string): Promise<BuildPluginConfig>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../src/config-loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAwB,MAAM,UAAU,CAAC;AAEnE,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAM/E"}