@hexaijs/plugin-contracts-generator 0.2.1 → 0.2.2

package/dist/errors.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Base error class for all contracts-generator errors.
+ * Allows catching all library errors with `instanceof MessageParserError`.
+ */
+export declare class MessageParserError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Base class for configuration-related errors.
+ */
+export declare class ConfigurationError extends MessageParserError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when loading application.config.ts fails.
+ */
+export declare class ConfigLoadError extends ConfigurationError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Base class for file system operation errors.
+ */
+export declare class FileSystemError extends MessageParserError {
+    readonly path: string;
+    constructor(message: string, path: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when a required file is not found.
+ */
+export declare class FileNotFoundError extends FileSystemError {
+    constructor(path: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when reading a file fails.
+ */
+export declare class FileReadError extends FileSystemError {
+    constructor(path: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when writing a file fails.
+ */
+export declare class FileWriteError extends FileSystemError {
+    constructor(path: string, options?: ErrorOptions);
+}
+/**
+ * Base class for parsing errors.
+ */
+export declare class ParseError extends MessageParserError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when JSON parsing fails.
+ */
+export declare class JsonParseError extends ParseError {
+    readonly filePath?: string;
+    constructor(message: string, filePath?: string, options?: ErrorOptions);
+}
+/**
+ * Base class for module/path resolution errors.
+ */
+export declare class ResolutionError extends MessageParserError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when module resolution fails.
+ */
+export declare class ModuleResolutionError extends ResolutionError {
+    readonly moduleSpecifier: string;
+    readonly fromFile: string;
+    constructor(moduleSpecifier: string, fromFile: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IACzC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACJ;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,kBAAkB;IACtD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACJ;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,kBAAkB;IACnD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACJ;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,kBAAkB;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAIhE;CACJ;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IAClD,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAG/C;CACJ;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,eAAe;IAC9C,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAG/C;CACJ;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,eAAe;IAC/C,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAG/C;CACJ;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,kBAAkB;IAC9C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACJ;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,YAAY,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAOrE;CACJ;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,kBAAkB;IACnD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACJ;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;IACtD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAQ5E;CACJ"}

package/dist/errors.js

@@ -0,0 +1,112 @@
+/**
+ * Base error class for all contracts-generator errors.
+ * Allows catching all library errors with `instanceof MessageParserError`.
+ */
+export class MessageParserError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "MessageParserError";
+    }
+}
+/**
+ * Base class for configuration-related errors.
+ */
+export class ConfigurationError extends MessageParserError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ConfigurationError";
+    }
+}
+/**
+ * Error thrown when loading application.config.ts fails.
+ */
+export class ConfigLoadError extends ConfigurationError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ConfigLoadError";
+    }
+}
+/**
+ * Base class for file system operation errors.
+ */
+export class FileSystemError extends MessageParserError {
+    path;
+    constructor(message, path, options) {
+        super(message, options);
+        this.name = "FileSystemError";
+        this.path = path;
+    }
+}
+/**
+ * Error thrown when a required file is not found.
+ */
+export class FileNotFoundError extends FileSystemError {
+    constructor(path, options) {
+        super(`File not found: ${path}`, path, options);
+        this.name = "FileNotFoundError";
+    }
+}
+/**
+ * Error thrown when reading a file fails.
+ */
+export class FileReadError extends FileSystemError {
+    constructor(path, options) {
+        super(`Failed to read file: ${path}`, path, options);
+        this.name = "FileReadError";
+    }
+}
+/**
+ * Error thrown when writing a file fails.
+ */
+export class FileWriteError extends FileSystemError {
+    constructor(path, options) {
+        super(`Failed to write file: ${path}`, path, options);
+        this.name = "FileWriteError";
+    }
+}
+/**
+ * Base class for parsing errors.
+ */
+export class ParseError extends MessageParserError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ParseError";
+    }
+}
+/**
+ * Error thrown when JSON parsing fails.
+ */
+export class JsonParseError extends ParseError {
+    filePath;
+    constructor(message, filePath, options) {
+        const fullMessage = filePath
+            ? `Failed to parse JSON in ${filePath}: ${message}`
+            : `Failed to parse JSON: ${message}`;
+        super(fullMessage, options);
+        this.name = "JsonParseError";
+        this.filePath = filePath;
+    }
+}
+/**
+ * Base class for module/path resolution errors.
+ */
+export class ResolutionError extends MessageParserError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ResolutionError";
+    }
+}
+/**
+ * Error thrown when module resolution fails.
+ */
+export class ModuleResolutionError extends ResolutionError {
+    moduleSpecifier;
+    fromFile;
+    constructor(moduleSpecifier, fromFile, options) {
+        super(`Failed to resolve module '${moduleSpecifier}' from '${fromFile}'`, options);
+        this.name = "ModuleResolutionError";
+        this.moduleSpecifier = moduleSpecifier;
+        this.fromFile = fromFile;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/file-copier.d.ts

@@ -0,0 +1,84 @@
+import type { FileGraph } from "./file-graph-resolver.js";
+import { FileSystem } from "./file-system.js";
+import type { MessageType, DecoratorNames } from "./domain/index.js";
+export interface CopyOptions {
+    sourceRoot: string;
+    outputDir: string;
+    fileGraph: FileGraph;
+    pathAliasRewrites?: Map<string, string>;
+    removeDecorators?: boolean;
+    responseTypesToExport?: Map<string, string[]>;
+    messageTypes?: readonly MessageType[];
+    decoratorNames?: DecoratorNames;
+}
+export interface CopyResult {
+    copiedFiles: string[];
+    rewrittenImports: Map<string, string[]>;
+}
+export interface FileCopierOptions {
+    fileSystem?: FileSystem;
+}
+export declare class FileCopier {
+    private readonly fs;
+    constructor(options?: FileCopierOptions);
+    copyFiles(options: CopyOptions): Promise<CopyResult>;
+    private preprocessEntryFiles;
+    private expandTransitiveDependencies;
+    private resolveNodeContent;
+    private applyTransformations;
+    generateBarrelExport(copiedFiles: string[], outputDir: string): string;
+    private readFileContent;
+    private writeOutputFile;
+    private processExcludedImports;
+    private processDecoratorRemoval;
+    private processTypeExports;
+    private processInternalPathAliases;
+    private processExternalPathAliases;
+    private createExportStatement;
+    private rewriteInternalPathAliases;
+    private isExternalOrRelativeImport;
+    private resolveInternalImport;
+    private rewriteModuleSpecifier;
+    private computeRelativePath;
+    private applyPathAliasRewrites;
+    private escapeRegex;
+    private removeExcludedImports;
+    private findExcludedModuleSpecifiers;
+    private createExcludedImportsVisitor;
+    private isImportFromExcludedModule;
+    private isExportFromExcludedModule;
+    private removeContractDecorators;
+    private createDecoratorRemovalVisitor;
+    private processContractGeneratorImport;
+    private createImportWithFilteredBindings;
+    private removeContractDecoratorsFromClass;
+    private extractDecoratorName;
+    private isDecoratorCallExpression;
+    private hasExportModifier;
+    private prependExportModifier;
+    private addExportToTypes;
+    private createExportAdditionVisitor;
+    private addExportToTypeAlias;
+    private addExportToInterface;
+    private transformSourceFile;
+    private extractSymbolsFromEntry;
+    private buildDecoratorToMessageTypeMap;
+    private findTargetClasses;
+    private computeRelatedTypeNames;
+    private collectUsedIdentifiers;
+    private collectDecoratorIdentifier;
+    private collectLocalTypeDeclarations;
+    private addToDeclarationMap;
+    private resolveIncludedLocalTypes;
+    private collectTypeIdentifiersFromNodes;
+    private collectComputedPropertyIdentifier;
+    private generateExtractedOutput;
+    private buildImportMap;
+    private filterImports;
+    private appendImportStatements;
+    private appendLocalTypeDeclarations;
+    private appendTargetClasses;
+    private appendNodeWithExport;
+    private nodeHasExportKeyword;
+}
+//# sourceMappingURL=file-copier.d.ts.map

package/dist/file-copier.d.ts.map

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