@hexaijs/plugin-contracts-generator 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,337 @@
+# @hexaijs/plugin-contracts-generator
+
+> Extract Domain Events, Commands, and Queries from backend source code to generate frontend-compatible contract types
+
+## Overview
+
+`@hexaijs/plugin-contracts-generator` solves the problem of keeping frontend and backend type definitions in sync. In a hexagonal architecture, your backend defines domain events, commands, and queries - but your frontend also needs type-safe access to these message types for API calls, event handling, and validation.
+
+Instead of manually duplicating type definitions (which inevitably drift out of sync), this plugin scans your backend source code for specially decorated classes and extracts them into a standalone contracts package. The generated package contains only the public API surface - the message types and their payloads - without any backend implementation details.
+
+The plugin works at build time by:
+
+1. Scanning TypeScript files for classes decorated with `@PublicEvent()`, `@PublicCommand()`, or `@PublicQuery()`
+2. Resolving all type dependencies (including response types and shared value objects)
+3. Generating a clean contracts package with namespace exports and a MessageRegistry for deserialization
+
+## Installation
+
+```bash
+npm install @hexaijs/plugin-contracts-generator
+```
+
+**Peer dependencies:**
+- `typescript ^5.0.0`
+
+## Core Concepts
+
+### Decorators
+
+The package provides three decorators that mark messages for extraction. These decorators have **no runtime overhead** - they simply tag classes for discovery during the build process.
+
+```typescript
+import { PublicEvent, PublicCommand, PublicQuery } from "@hexaijs/plugin-contracts-generator/decorators";
+```
+
+**@PublicEvent()** - Marks a domain event as part of the public contract:
+
+```typescript
+import { DomainEvent } from "@hexaijs/core";
+import { PublicEvent } from "@hexaijs/plugin-contracts-generator/decorators";
+
+@PublicEvent()
+export class OrderPlaced extends DomainEvent<{
+    orderId: string;
+    customerId: string;
+    totalAmount: number;
+}> {
+    static readonly type = "order.order-placed";
+}
+```
+
+**@PublicCommand()** - Marks a command as part of the public contract:
+
+```typescript
+import { PublicCommand } from "@hexaijs/plugin-contracts-generator/decorators";
+
+@PublicCommand()
+export class CreateOrderRequest extends BaseRequest<{
+    customerId: string;
+    items: OrderItem[];
+}> {
+    static type = "order.create-order";
+}
+
+export type CreateOrderResponse = {
+    orderId: string;
+};
+```
+
+**@PublicQuery()** - Marks a query as part of the public contract:
+
+```typescript
+import { PublicQuery } from "@hexaijs/plugin-contracts-generator/decorators";
+
+@PublicQuery({ response: "OrderDetails" })
+export class GetOrderQuery extends BaseRequest<{
+    orderId: string;
+}> {}
+
+type OrderDetails = {
+    orderId: string;
+    status: string;
+    items: OrderItem[];
+};
+```
+
+Each decorator accepts optional configuration:
+- `context` - Override the context name for this message
+- `version` - Specify a version number for versioned events
+- `response` - Explicitly name the response type (for commands/queries)
+
+### Configuration
+
+Create an `application.config.ts` file in your monorepo root:
+
+```typescript
+// application.config.ts
+export default {
+    contracts: {
+        // Context definitions (required)
+        contexts: [
+            {
+                name: "order",
+                sourceDir: "packages/order/src",
+                tsconfigPath: "packages/order/tsconfig.json", // optional
+            },
+            {
+                name: "inventory",
+                sourceDir: "packages/inventory/src",
+            },
+        ],
+
+        // Output package configuration (required)
+        outputPackage: {
+            name: "@myorg/contracts",
+            dir: "packages/contracts",
+        },
+
+        // Path alias rewrite rules (optional)
+        pathAliasRewrites: {
+            "@myorg/": "@/",
+        },
+
+        // Additional dependencies for contracts package (optional)
+        externalDependencies: {
+            "@hexaijs/core": "workspace:*",
+        },
+
+        // Response type naming conventions (optional)
+        responseNamingConventions: [
+            { messageSuffix: "Command", responseSuffix: "CommandResult" },
+            { messageSuffix: "Query", responseSuffix: "QueryResult" },
+            { messageSuffix: "Request", responseSuffix: "Response" },
+        ],
+    },
+};
+```
+
+For monorepos with many packages, use glob patterns to auto-discover contexts:
+
+```typescript
+export default {
+    contracts: {
+        contexts: ["packages/*"],  // Matches all directories under packages/
+        outputPackage: {
+            name: "@myorg/contracts",
+            dir: "packages/contracts",
+        },
+    },
+};
+```
+
+Each matched package must have its own `application.config.ts` with `contextName` and `sourceDir`.
+
+### Response Types
+
+Commands and queries often have associated response types. The generator includes these in the contracts package automatically.
+
+**Automatic detection via naming conventions:**
+
+```typescript
+// When responseNamingConventions includes { messageSuffix: "Command", responseSuffix: "CommandResult" }
+
+@PublicCommand()
+export class CreateOrderCommand extends Message<{ customerId: string }> {}
+
+type CreateOrderCommandResult = {  // Automatically detected by naming pattern
+    orderId: string;
+};
+```
+
+**Explicit response option:**
+
+```typescript
+@PublicCommand({ response: "OrderCreationResult" })
+export class CreateOrder extends Message<{ customerId: string }> {}
+
+type OrderCreationResult = {
+    orderId: string;
+    createdAt: Date;
+};
+```
+
+Response types must be in the same file as the command/query. Both `type` aliases and `interface` declarations are supported. The generator adds `export` automatically if the type isn't already exported.
+
+### Entry vs Dependency Files
+
+The generator handles two types of files differently:
+
+**Entry files** (files with `@Public*` decorators) undergo symbol extraction:
+- Only decorated classes matching the specified message types are extracted
+- Handler classes are excluded
+- Response types are included based on naming conventions
+- Unused imports are removed
+
+**Dependency files** (imported by entry files) are copied entirely:
+- Supports barrel files (`export * from './module'`)
+- Preserves all exports for transitive dependencies
+- Ensures type dependencies remain intact
+
+## Usage
+
+### CLI
+
+Run the generator from your monorepo root:
+
+```bash
+# Uses application.config.ts by default
+npx contracts-generator
+
+# Specify config file path
+npx contracts-generator --config ./application.config.ts
+
+# Filter by message types
+npx contracts-generator -m event           # Extract only events
+npx contracts-generator -m command         # Extract only commands
+npx contracts-generator -m query           # Extract only queries
+npx contracts-generator -m event,command   # Extract events and commands
+```
+
+### Programmatic API
+
+For custom build scripts:
+
+```typescript
+import { processContext, ConsoleLogger } from "@hexaijs/plugin-contracts-generator";
+
+const result = await processContext({
+    contextName: "order",
+    sourceDir: "packages/order/src",
+    outputDir: "packages/contracts/src",
+    pathAliasRewrites: new Map([["@myorg/", "@/"]]),
+    messageTypes: ["event", "command"],
+    responseNamingConventions: [
+        { messageSuffix: "Command", responseSuffix: "CommandResult" },
+    ],
+    logger: new ConsoleLogger({ level: "info" }),
+});
+
+console.log(`Extracted ${result.events.length} events, ${result.commands.length} commands`);
+```
+
+For fine-grained control, use the `ContractsPipeline` class which provides step-by-step execution: `scan()`, `parse()`, `resolve()`, `copy()`, and `exportBarrel()`.
+
+### Output Structure
+
+The generated contracts package follows this structure:
+
+```
+contracts/
+├── src/
+│   ├── {context}/
+│   │   ├── events.ts
+│   │   ├── commands.ts
+│   │   ├── types.ts       # Dependent types + Response types
+│   │   └── index.ts       # Barrel exports
+│   └── index.ts           # Namespace exports + MessageRegistry
+├── package.json
+└── tsconfig.json
+```
+
+The root `index.ts` uses namespace exports to prevent name collisions:
+
+```typescript
+// contracts/src/index.ts
+import { MessageRegistry } from "@hexaijs/plugin-contracts-generator/runtime";
+
+export * as order from "./order";
+export * as inventory from "./inventory";
+
+export const messageRegistry = new MessageRegistry()
+    .register(order.OrderPlaced)
+    .register(inventory.StockUpdated);
+```
+
+Use namespace exports in your frontend:
+
+```typescript
+import { order, messageRegistry } from "@myorg/contracts";
+
+// Access types via namespace
+const event = new order.OrderPlaced({ orderId: "123", customerId: "456" });
+
+// Deserialize messages from the backend
+const message = messageRegistry.dehydrate(header, body);
+```
+
+## Error Handling
+
+The generator provides specific error types for different failure modes:
+
+```typescript
+import {
+    processContext,
+    MessageParserError,
+    FileReadError,
+    ConfigLoadError,
+} from "@hexaijs/plugin-contracts-generator";
+
+try {
+    await processContext(options);
+} catch (error) {
+    if (error instanceof FileReadError) {
+        console.error(`Failed to read: ${error.path}`, error.cause);
+    } else if (error instanceof ConfigLoadError) {
+        console.error(`Config error: ${error.message}`);
+    } else if (error instanceof MessageParserError) {
+        console.error(`Parser error: ${error.message}`);
+    }
+}
+```
+
+**Error hierarchy:**
+
+- `MessageParserError` (base)
+  - `ConfigurationError` → `ConfigLoadError`, `TsconfigLoadError`
+  - `FileSystemError` → `FileNotFoundError`, `FileReadError`, `FileWriteError`
+  - `ParseError` → `JsonParseError`
+  - `ResolutionError` → `ModuleResolutionError`
+
+## API Highlights
+
+| Export | Description |
+|--------|-------------|
+| `processContext(options)` | Main API for extracting and copying contracts |
+| `ContractsPipeline` | Fine-grained control over extraction process |
+| `PublicEvent` | Decorator to mark events for extraction |
+| `PublicCommand` | Decorator to mark commands for extraction |
+| `PublicQuery` | Decorator to mark queries for extraction |
+| `MessageRegistry` | Runtime registry for message deserialization |
+| `ConsoleLogger` | Configurable logger for build output |
+| Error types | `ConfigLoadError`, `FileReadError`, `MessageParserError`, etc. |
+
+## See Also
+
+- [@hexaijs/core](../core/README.md) - DomainEvent and Message base classes used by contracts
+- [@hexaijs/plugin-application-builder](../plugin-application-builder/README.md) - Companion plugin for handler registration

package/dist/ast-utils.d.ts

@@ -0,0 +1,6 @@
+import * as ts from "typescript";
+import type { TypeRef, Field } from "./domain";
+export declare function isPrimitiveTypeName(name: string): boolean;
+export declare function parseTypeNode(typeNode: ts.TypeNode): TypeRef;
+export declare function extractFieldsFromMembers(members: ts.NodeArray<ts.TypeElement>): Field[];
+//# sourceMappingURL=ast-utils.d.ts.map

package/dist/ast-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-utils.d.ts","sourceRoot":"","sources":["../src/ast-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,KAAK,EACR,OAAO,EAOP,KAAK,EACR,MAAM,UAAU,CAAC;AAgBlB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,GAAG,OAAO,CAwC5D;AAED,wBAAgB,wBAAwB,CACpC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,WAAW,CAAC,GACtC,KAAK,EAAE,CAsBT"}

package/dist/ast-utils.js

@@ -0,0 +1,111 @@
+"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.isPrimitiveTypeName = isPrimitiveTypeName;
+exports.parseTypeNode = parseTypeNode;
+exports.extractFieldsFromMembers = extractFieldsFromMembers;
+const ts = __importStar(require("typescript"));
+const PRIMITIVE_TYPE_NAMES = new Set([
+    "string",
+    "number",
+    "boolean",
+    "void",
+    "null",
+    "undefined",
+    "any",
+    "unknown",
+    "never",
+    "bigint",
+    "symbol",
+]);
+function isPrimitiveTypeName(name) {
+    return PRIMITIVE_TYPE_NAMES.has(name);
+}
+function parseTypeNode(typeNode) {
+    if (typeNode.kind === ts.SyntaxKind.StringKeyword) {
+        return { kind: "primitive", name: "string" };
+    }
+    if (typeNode.kind === ts.SyntaxKind.NumberKeyword) {
+        return { kind: "primitive", name: "number" };
+    }
+    if (typeNode.kind === ts.SyntaxKind.BooleanKeyword) {
+        return { kind: "primitive", name: "boolean" };
+    }
+    if (ts.isArrayTypeNode(typeNode)) {
+        const elementType = parseTypeNode(typeNode.elementType);
+        return { kind: "array", elementType };
+    }
+    if (ts.isTypeReferenceNode(typeNode)) {
+        const name = typeNode.typeName.getText();
+        const typeArguments = typeNode.typeArguments
+            ? typeNode.typeArguments.map((t) => parseTypeNode(t))
+            : undefined;
+        return { kind: "reference", name, typeArguments };
+    }
+    if (ts.isIntersectionTypeNode(typeNode)) {
+        const types = typeNode.types.map((t) => parseTypeNode(t));
+        return { kind: "intersection", types };
+    }
+    if (ts.isUnionTypeNode(typeNode)) {
+        const types = typeNode.types.map((t) => parseTypeNode(t));
+        return { kind: "union", types };
+    }
+    if (ts.isTypeLiteralNode(typeNode)) {
+        const fields = extractFieldsFromMembers(typeNode.members);
+        return { kind: "object", fields };
+    }
+    return { kind: "reference", name: typeNode.getText() };
+}
+function extractFieldsFromMembers(members) {
+    const fields = [];
+    for (const member of members) {
+        if (ts.isPropertySignature(member) && member.name) {
+            const fieldName = member.name.getText();
+            const fieldType = member.type
+                ? parseTypeNode(member.type)
+                : { kind: "primitive", name: "any" };
+            const optional = !!member.questionToken;
+            const readonly = member.modifiers?.some((m) => m.kind === ts.SyntaxKind.ReadonlyKeyword) ?? false;
+            fields.push({
+                name: fieldName,
+                type: fieldType,
+                optional,
+                readonly,
+            });
+        }
+    }
+    return fields;
+}
+//# sourceMappingURL=ast-utils.js.map

package/dist/ast-utils.js.map

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

package/dist/class-analyzer.d.ts

@@ -0,0 +1,16 @@
+import * as ts from "typescript";
+export declare function hasDecorator(node: ts.ClassDeclaration, decoratorName: string): boolean;
+export interface DecoratorOptions {
+    response?: string;
+    context?: string;
+}
+/**
+ * Extracts options from a decorator call expression.
+ * For example, @PublicCommand({ response: 'CreateUserResult' }) returns { response: 'CreateUserResult' }
+ */
+export declare function getDecoratorOptions(node: ts.ClassDeclaration, decoratorName: string): DecoratorOptions | undefined;
+export declare function hasExportModifier(node: ts.Node): boolean;
+export declare function extractClassSourceText(node: ts.ClassDeclaration, sourceCode: string): string;
+export declare function getBaseClassName(node: ts.ClassDeclaration): string | undefined;
+export declare function collectClassReferences(node: ts.ClassDeclaration): Set<string>;
+//# sourceMappingURL=class-analyzer.d.ts.map

package/dist/class-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-analyzer.d.ts","sourceRoot":"","sources":["../src/class-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAIjC,wBAAgB,YAAY,CACxB,IAAI,EAAE,EAAE,CAAC,gBAAgB,EACzB,aAAa,EAAE,MAAM,GACtB,OAAO,CAaT;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,EAAE,CAAC,gBAAgB,EACzB,aAAa,EAAE,MAAM,GACtB,gBAAgB,GAAG,SAAS,CAmC9B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO,CAOxD;AAED,wBAAgB,sBAAsB,CAClC,IAAI,EAAE,EAAE,CAAC,gBAAgB,EACzB,UAAU,EAAE,MAAM,GACnB,MAAM,CAMR;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAe9E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,GAAG,GAAG,CAAC,MAAM,CAAC,CAgC7E"}

package/dist/class-analyzer.js

@@ -0,0 +1,155 @@
+"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.hasDecorator = hasDecorator;
+exports.getDecoratorOptions = getDecoratorOptions;
+exports.hasExportModifier = hasExportModifier;
+exports.extractClassSourceText = extractClassSourceText;
+exports.getBaseClassName = getBaseClassName;
+exports.collectClassReferences = collectClassReferences;
+const ts = __importStar(require("typescript"));
+const ast_utils_1 = require("./ast-utils");
+function hasDecorator(node, decoratorName) {
+    const decorators = ts.getDecorators(node);
+    if (!decorators)
+        return false;
+    return decorators.some((decorator) => {
+        if (ts.isCallExpression(decorator.expression)) {
+            const expr = decorator.expression.expression;
+            if (ts.isIdentifier(expr)) {
+                return expr.text === decoratorName;
+            }
+        }
+        return false;
+    });
+}
+/**
+ * Extracts options from a decorator call expression.
+ * For example, @PublicCommand({ response: 'CreateUserResult' }) returns { response: 'CreateUserResult' }
+ */
+function getDecoratorOptions(node, decoratorName) {
+    const decorators = ts.getDecorators(node);
+    if (!decorators)
+        return undefined;
+    for (const decorator of decorators) {
+        if (!ts.isCallExpression(decorator.expression))
+            continue;
+        const expr = decorator.expression.expression;
+        if (!ts.isIdentifier(expr) || expr.text !== decoratorName)
+            continue;
+        // Found the decorator, now extract options from the first argument
+        const args = decorator.expression.arguments;
+        if (args.length === 0)
+            return {};
+        const firstArg = args[0];
+        if (!ts.isObjectLiteralExpression(firstArg))
+            return {};
+        const options = {};
+        for (const prop of firstArg.properties) {
+            if (!ts.isPropertyAssignment(prop))
+                continue;
+            if (!ts.isIdentifier(prop.name))
+                continue;
+            const propName = prop.name.text;
+            if (propName === "response" && ts.isStringLiteral(prop.initializer)) {
+                options.response = prop.initializer.text;
+            }
+            else if (propName === "context" && ts.isStringLiteral(prop.initializer)) {
+                options.context = prop.initializer.text;
+            }
+        }
+        return options;
+    }
+    return undefined;
+}
+function hasExportModifier(node) {
+    const modifiers = ts.canHaveModifiers(node)
+        ? ts.getModifiers(node)
+        : undefined;
+    return (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false);
+}
+function extractClassSourceText(node, sourceCode) {
+    const fullStart = node.getFullStart();
+    const end = node.getEnd();
+    let sourceText = sourceCode.slice(fullStart, end);
+    sourceText = sourceText.replace(/^\s*\n/, "");
+    return sourceText;
+}
+function getBaseClassName(node) {
+    if (!node.heritageClauses)
+        return undefined;
+    for (const clause of node.heritageClauses) {
+        if (clause.token === ts.SyntaxKind.ExtendsKeyword) {
+            const firstType = clause.types[0];
+            if (firstType && ts.isExpressionWithTypeArguments(firstType)) {
+                const expr = firstType.expression;
+                if (ts.isIdentifier(expr)) {
+                    return expr.text;
+                }
+            }
+        }
+    }
+    return undefined;
+}
+function collectClassReferences(node) {
+    const references = new Set();
+    const baseClass = getBaseClassName(node);
+    if (baseClass) {
+        references.add(baseClass);
+    }
+    const visitNode = (child) => {
+        if (ts.isTypeReferenceNode(child)) {
+            const name = child.typeName.getText();
+            if (!(0, ast_utils_1.isPrimitiveTypeName)(name)) {
+                references.add(name);
+            }
+        }
+        else if (ts.isIdentifier(child)) {
+            const parent = child.parent;
+            if (parent &&
+                (ts.isTypeReferenceNode(parent) ||
+                    ts.isExpressionWithTypeArguments(parent))) {
+                const name = child.text;
+                if (!(0, ast_utils_1.isPrimitiveTypeName)(name)) {
+                    references.add(name);
+                }
+            }
+        }
+        ts.forEachChild(child, visitNode);
+    };
+    ts.forEachChild(node, visitNode);
+    return references;
+}
+//# sourceMappingURL=class-analyzer.js.map

package/dist/class-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-analyzer.js","sourceRoot":"","sources":["../src/class-analyzer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,oCAgBC;AAWD,kDAsCC;AAED,8CAOC;AAED,wDASC;AAED,4CAeC;AAED,wDAgCC;AA5ID,+CAAiC;AAEjC,2CAAkD;AAElD,SAAgB,YAAY,CACxB,IAAyB,EACzB,aAAqB;IAErB,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAE9B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QACjC,IAAI,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC;YAC7C,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,OAAO,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC;YACvC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC,CAAC;AACP,CAAC;AAOD;;;GAGG;AACH,SAAgB,mBAAmB,CAC/B,IAAyB,EACzB,aAAqB;IAErB,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAC;YAAE,SAAS;QAEzD,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC;QAC7C,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;YAAE,SAAS;QAEpE,mEAAmE;QACnE,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC;QAC5C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEjC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,EAAE,CAAC,yBAAyB,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QAEvD,MAAM,OAAO,GAAqB,EAAE,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACrC,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC7C,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAE1C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAChC,IAAI,QAAQ,KAAK,UAAU,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YAC7C,CAAC;iBAAM,IAAI,QAAQ,KAAK,SAAS,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBACxE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YAC5C,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAgB,iBAAiB,CAAC,IAAa;IAC3C,MAAM,SAAS,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;QACvC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;QACvB,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,CACH,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,KAAK,CAC1E,CAAC;AACN,CAAC;AAED,SAAgB,sBAAsB,CAClC,IAAyB,EACzB,UAAkB;IAElB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC1B,IAAI,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAClD,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC9C,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAyB;IACtD,IAAI,CAAC,IAAI,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC;IAE5C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;YAChD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,SAAS,IAAI,EAAE,CAAC,6BAA6B,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC;gBAClC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;oBACxB,OAAO,IAAI,CAAC,IAAI,CAAC;gBACrB,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAgB,sBAAsB,CAAC,IAAyB;IAC5D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,SAAS,EAAE,CAAC;QACZ,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,KAAc,EAAQ,EAAE;QACvC,IAAI,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,CAAC,IAAA,+BAAmB,EAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;QACL,CAAC;aAAM,IAAI,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,IACI,MAAM;gBACN,CAAC,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC;oBAC3B,EAAE,CAAC,6BAA6B,CAAC,MAAM,CAAC,CAAC,EAC/C,CAAC;gBACC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;gBACxB,IAAI,CAAC,IAAA,+BAAmB,EAAC,IAAI,CAAC,EAAE,CAAC;oBAC7B,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC;YACL,CAAC;QACL,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC;AACtB,CAAC"}