@cparra/apexdocs 2.25.0-alpha.8 → 2.25.0

package/lib/transpiler/openapi/parsers/ReferenceBuilder.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferenceBuilder = void 0;
+const yaml = require("js-yaml");
+const types_repository_1 = require("../../../model/types-repository");
+class ReferenceBuilder {
+    constructor() {
+        this.isReferenceString = (targetObject) => {
+            return typeof targetObject === 'string' || targetObject instanceof String;
+        };
+    }
+    build(referencedTypeName) {
+        const originalTypeName = referencedTypeName;
+        // Checking for inline overrides of the type: [memberName:ClassOverrideName]
+        const regexForSchemaOverrides = /\[(.*?)]/g;
+        const schemaOverrides = referencedTypeName.match(regexForSchemaOverrides);
+        let referenceOverrides = [];
+        if (schemaOverrides && schemaOverrides.length > 0) {
+            referenceOverrides = ReferenceOverrides.build(schemaOverrides[0]);
+            referencedTypeName = referencedTypeName.replace(regexForSchemaOverrides, '');
+        }
+        const [parsedReferencedType, isCollection] = this.handlePossibleCollectionReference(referencedTypeName);
+        const referencedTypeBundle = types_repository_1.TypesRepository.getInstance().getFromAllByName(parsedReferencedType);
+        if (!referencedTypeBundle) {
+            throw new Error(`The referenced type ${referencedTypeName} was not found.`);
+        }
+        if (referencedTypeBundle.type.type_name !== 'class') {
+            throw new Error(`Expected the referenced type to be a class, but found a ${referencedTypeBundle.type.type_name}.`);
+        }
+        const typeBundleWithIsCollection = Object.assign(Object.assign({}, referencedTypeBundle), { originalTypeName: originalTypeName, isCollection: isCollection, referenceOverrides: referenceOverrides });
+        return this.buildReferenceFromType(typeBundleWithIsCollection);
+    }
+    /**
+     * Returns a tuple where the first value is the name of the reference without any collection related values
+     * and the second is a boolean representing if we are dealing with a collection or not.
+     * @param referencedTypeName The received raw type name.
+     * @private
+     */
+    handlePossibleCollectionReference(referencedTypeName) {
+        referencedTypeName = referencedTypeName.toLowerCase();
+        if (referencedTypeName.startsWith('list<') && referencedTypeName.endsWith('>')) {
+            referencedTypeName = referencedTypeName.replace('list<', '');
+            referencedTypeName = referencedTypeName.replace('>', '');
+            return [referencedTypeName, true];
+        }
+        if (referencedTypeName.startsWith('set<') && referencedTypeName.endsWith('>')) {
+            referencedTypeName = referencedTypeName.replace('set<', '');
+            referencedTypeName = referencedTypeName.replace('>', '');
+            return [referencedTypeName, true];
+        }
+        return [referencedTypeName, false];
+    }
+    buildReferenceFromType(typeBundle) {
+        // Filtering based on Salesforce's documentation:
+        // https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_rest_methods.htm#ApexRESTUserDefinedTypes
+        // We assume that the class only contains object types allowed by Apex Rest:
+        // "Note that the public, private, or global class member variables must be types allowed by Apex REST"
+        const propertiesAndFields = [
+            ...typeBundle.type.properties,
+            ...typeBundle.type.fields,
+        ]
+            .filter((current) => !current.memberModifiers.includes('static'))
+            .filter((current) => !current.memberModifiers.includes('transient'));
+        const properties = {};
+        let referencedComponents = [];
+        propertiesAndFields.forEach((current) => {
+            var _a, _b;
+            // Check if there are reference overrides for the current property, this takes priority over anything else.
+            const referenceOverride = typeBundle.referenceOverrides.find((currentOverride) => {
+                return currentOverride.propertyName.toLowerCase() === current.name.toLowerCase();
+            });
+            if (referenceOverride) {
+                const reference = this.build(referenceOverride.referenceName);
+                properties[current.name] = reference.entrypointReferenceObject;
+                reference.referenceComponents.forEach((current) => referencedComponents.push(current));
+            }
+            else {
+                // Check for "@http-schema" annotations within properties themselves. If these are specified they
+                // take precedence over the property type itself.
+                const manuallyDefinedHttpSchema = (_a = current.docComment) === null || _a === void 0 ? void 0 : _a.annotations.find((annotation) => annotation.name.toLowerCase() === 'http-schema');
+                if (manuallyDefinedHttpSchema) {
+                    this.handleOverriddenSchema(manuallyDefinedHttpSchema, properties, current, referencedComponents);
+                }
+                else {
+                    const pair = this.getReferenceType(current.typeReference);
+                    properties[current.name] = pair.schema;
+                    referencedComponents.push(...pair.referenceComponents);
+                }
+            }
+            properties[current.name].description = (_b = current.docComment) === null || _b === void 0 ? void 0 : _b.description;
+        });
+        const mainReferenceComponents = this.buildMainReferenceComponent(typeBundle, properties);
+        // Make sure to add the "main" reference first
+        referencedComponents = [...mainReferenceComponents, ...referencedComponents];
+        return {
+            entrypointReferenceObject: {
+                $ref: `#/components/schemas/${this.getReferenceName(typeBundle)}`,
+            },
+            referenceComponents: referencedComponents,
+        };
+    }
+    handleOverriddenSchema(manuallyDefinedHttpSchema, properties, current, referencedComponents) {
+        // This can be of type ApexDocSchemaObject
+        const inYaml = manuallyDefinedHttpSchema === null || manuallyDefinedHttpSchema === void 0 ? void 0 : manuallyDefinedHttpSchema.bodyLines.reduce((prev, current, _) => prev + '\n' + current);
+        const asJson = yaml.load(inYaml);
+        const isReferenceString = this.isReferenceString(asJson);
+        if (isReferenceString) {
+            const reference = this.build(asJson);
+            properties[current.name] = reference.entrypointReferenceObject;
+            reference.referenceComponents.forEach((current) => referencedComponents.push(current));
+        }
+        else {
+            // If we are dealing with a manually defined schema object, we can add it directly to the "properties" map,
+            // because we don't need to add a reference component.
+            properties[current.name] = asJson;
+        }
+    }
+    getReferenceName(typeBundle) {
+        var _a;
+        let referenceName = typeBundle.type.name;
+        if (typeBundle.isChild) {
+            referenceName = `${(_a = typeBundle.parentType) === null || _a === void 0 ? void 0 : _a.name}.${typeBundle.type.name}`;
+        }
+        if (typeBundle.isCollection) {
+            referenceName = `${referenceName}_array`;
+        }
+        if (typeBundle.referenceOverrides.length) {
+            referenceName = `${referenceName}_${typeBundle.originalTypeName}`;
+        }
+        return referenceName;
+    }
+    buildMainReferenceComponent(typeBundle, properties) {
+        // For the main reference, we always want to get the reference of the object without the collection part,
+        // so we pass the typeBundle to `getReferenceName` but with the isCollection flag set to false.
+        const mainReferenceName = this.getReferenceName(Object.assign(Object.assign({}, typeBundle), { isCollection: false }));
+        const mainReference = {
+            referencedClass: mainReferenceName,
+            schema: {
+                type: 'object',
+                properties: properties,
+            },
+        };
+        const referencedComponents = [mainReference];
+        if (!typeBundle.isCollection) {
+            return referencedComponents;
+        }
+        return [
+            {
+                referencedClass: this.getReferenceName(typeBundle),
+                schema: {
+                    type: 'array',
+                    items: {
+                        $ref: `#/components/schemas/${mainReferenceName}`,
+                    },
+                },
+            },
+            ...referencedComponents,
+        ];
+    }
+    getReferenceType(typeInMirror) {
+        // Returns a valid type supported by OpenApi from a received Apex type.
+        const typeName = typeInMirror.type.toLowerCase();
+        switch (typeName) {
+            case 'boolean':
+                return { schema: { type: 'boolean' }, referenceComponents: [] };
+            case 'date':
+                return { schema: { type: 'string', format: 'date' }, referenceComponents: [] };
+            case 'datetime':
+                return { schema: { type: 'string', format: 'date-time' }, referenceComponents: [] };
+            case 'decimal':
+                return { schema: { type: 'number' }, referenceComponents: [] };
+            case 'double':
+                return { schema: { type: 'number' }, referenceComponents: [] };
+            case 'id':
+                return { schema: { type: 'string' }, referenceComponents: [] };
+            case 'integer':
+                return { schema: { type: 'integer' }, referenceComponents: [] };
+            case 'long':
+                return { schema: { type: 'integer', format: 'int64' }, referenceComponents: [] };
+            case 'string':
+                return { schema: { type: 'string' }, referenceComponents: [] };
+            case 'time':
+                return { schema: { type: 'string', format: 'time' }, referenceComponents: [] };
+            case 'list':
+                return this.buildCollectionPair(typeInMirror);
+            case 'set':
+                return this.buildCollectionPair(typeInMirror);
+            case 'map':
+                // For Maps, we treat them as objects but do not try to define their shape, because their keys can vary
+                // at runtime.
+                return { schema: { type: 'object' }, referenceComponents: [] };
+            case 'object':
+                return { schema: { type: 'object' }, referenceComponents: [] };
+            default:
+                // If we got here we are dealing with a non-primitive (most likely a custom class or an SObject).
+                const referencedType = types_repository_1.TypesRepository.getInstance().getFromAllByName(typeName);
+                if (!referencedType) {
+                    return { schema: { type: 'object' }, referenceComponents: [] };
+                }
+                const reference = this.buildReferenceFromType(Object.assign(Object.assign({}, referencedType), { isCollection: false, referenceOverrides: [], originalTypeName: typeName }));
+                return {
+                    schema: reference.entrypointReferenceObject,
+                    referenceComponents: [...reference.referenceComponents],
+                };
+        }
+    }
+    buildCollectionPair(typeInMirror) {
+        const innerReference = this.getReferenceType(typeInMirror.ofType);
+        return {
+            schema: { type: 'array', items: innerReference.schema },
+            referenceComponents: [...innerReference.referenceComponents],
+        };
+    }
+}
+exports.ReferenceBuilder = ReferenceBuilder;
+class ReferenceOverrides {
+    static build(referenceAsString) {
+        const cleanedUpReference = referenceAsString.replace(/[\[\]]/g, '');
+        const referenceStrings = cleanedUpReference.split(',').map((item) => item.replace(/\s/g, ''));
+        return referenceStrings.map((item) => {
+            const [propertyName, referenceName] = item.split(':');
+            return { propertyName, referenceName };
+        });
+    }
+}
+//# sourceMappingURL=ReferenceBuilder.js.map

package/lib/transpiler/openapi/parsers/ReferenceBuilder.js.map

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

package/lib/transpiler/openapi/parsers/RequestBodyBuilder.d.ts

@@ -0,0 +1,10 @@
+import { RequestBody } from '../../../model/openapi/open-api-types';
+import { Reference } from './ReferenceBuilder';
+import { ApexDocHttpRequestBody } from '../../../model/openapi/apex-doc-types';
+import { Builder } from './Builder';
+/**
+ * Parses and builds OpenApi Request Body objects.
+ */
+export declare class RequestBodyBuilder extends Builder<RequestBody, ApexDocHttpRequestBody> {
+    buildBody(apexRequestBody: ApexDocHttpRequestBody, reference?: Reference): RequestBody;
+}

package/lib/transpiler/openapi/parsers/RequestBodyBuilder.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestBodyBuilder = void 0;
+const Builder_1 = require("./Builder");
+/**
+ * Parses and builds OpenApi Request Body objects.
+ */
+class RequestBodyBuilder extends Builder_1.Builder {
+    buildBody(apexRequestBody, reference) {
+        return {
+            description: apexRequestBody.description,
+            content: {
+                'application/json': { schema: this.getOpenApiSchemaFromApexDocSchema(apexRequestBody, reference) },
+            },
+            required: apexRequestBody.required,
+        };
+    }
+}
+exports.RequestBodyBuilder = RequestBodyBuilder;
+//# sourceMappingURL=RequestBodyBuilder.js.map

package/lib/transpiler/openapi/parsers/RequestBodyBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestBodyBuilder.js","sourceRoot":"","sources":["../../../../src/transpiler/openapi/parsers/RequestBodyBuilder.ts"],"names":[],"mappings":";;;AAGA,uCAAoC;AAEpC;;GAEG;AACH,MAAa,kBAAmB,SAAQ,iBAA4C;IAClF,SAAS,CAAC,eAAuC,EAAE,SAAqB;QACtE,OAAO;YACL,WAAW,EAAE,eAAe,CAAC,WAAW;YACxC,OAAO,EAAE;gBACP,kBAAkB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,iCAAiC,CAAC,eAAe,EAAE,SAAS,CAAC,EAAE;aACnG;YACD,QAAQ,EAAE,eAAe,CAAC,QAAQ;SACnC,CAAC;IACJ,CAAC;CACF;AAVD,gDAUC"}

package/lib/transpiler/openapi/parsers/ResponsesBuilder.d.ts

@@ -0,0 +1,7 @@
+import { ResponseObject } from '../../../model/openapi/open-api-types';
+import { Reference } from './ReferenceBuilder';
+import { ApexDocHttpResponse } from '../../../model/openapi/apex-doc-types';
+import { Builder } from './Builder';
+export declare class ResponsesBuilder extends Builder<ResponseObject, ApexDocHttpResponse> {
+    buildBody(apexDocResponseDefinition: ApexDocHttpResponse, reference?: Reference): ResponseObject;
+}

package/lib/transpiler/openapi/parsers/ResponsesBuilder.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponsesBuilder = void 0;
+const Builder_1 = require("./Builder");
+class ResponsesBuilder extends Builder_1.Builder {
+    buildBody(apexDocResponseDefinition, reference) {
+        let description = `Status code ${apexDocResponseDefinition.statusCode}`;
+        if (apexDocResponseDefinition.description) {
+            description = apexDocResponseDefinition.description;
+        }
+        return {
+            description: description,
+            content: {
+                'application/json': {
+                    schema: this.getOpenApiSchemaFromApexDocSchema(apexDocResponseDefinition, reference),
+                },
+            },
+        };
+    }
+}
+exports.ResponsesBuilder = ResponsesBuilder;
+//# sourceMappingURL=ResponsesBuilder.js.map

package/lib/transpiler/openapi/parsers/ResponsesBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponsesBuilder.js","sourceRoot":"","sources":["../../../../src/transpiler/openapi/parsers/ResponsesBuilder.ts"],"names":[],"mappings":";;;AAGA,uCAAoC;AAEpC,MAAa,gBAAiB,SAAQ,iBAA4C;IAChF,SAAS,CAAC,yBAA8C,EAAE,SAAqB;QAC7E,IAAI,WAAW,GAAG,eAAe,yBAAyB,CAAC,UAAU,EAAE,CAAC;QACxE,IAAI,yBAAyB,CAAC,WAAW,EAAE;YACzC,WAAW,GAAG,yBAAyB,CAAC,WAAW,CAAC;SACrD;QACD,OAAO;YACL,WAAW,EAAE,WAAW;YACxB,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,IAAI,CAAC,iCAAiC,CAAC,yBAAyB,EAAE,SAAS,CAAC;iBACrF;aACF;SACF,CAAC;IACJ,CAAC;CACF;AAfD,4CAeC"}

package/lib/transpiler/processor-type-transpiler.d.ts

@@ -0,0 +1,10 @@
+import { Type } from '@cparra/apex-reflection';
+import { FileContainer } from './file-container';
+export type LinkingStrategy = 'root-relative' | 'path-relative';
+export default abstract class ProcessorTypeTranspiler {
+    onBeforeProcess: ((types: Type[]) => void) | undefined;
+    abstract onProcess(type: Type): void;
+    onAfterProcess: ((types: Type[]) => void) | undefined;
+    abstract fileBuilder(): FileContainer;
+    getLinkingStrategy(): LinkingStrategy;
+}

package/lib/transpiler/processor-type-transpiler.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class ProcessorTypeTranspiler {
+    getLinkingStrategy() {
+        return 'root-relative';
+    }
+}
+exports.default = ProcessorTypeTranspiler;
+//# sourceMappingURL=processor-type-transpiler.js.map

package/lib/transpiler/processor-type-transpiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor-type-transpiler.js","sourceRoot":"","sources":["../../src/transpiler/processor-type-transpiler.ts"],"names":[],"mappings":";;AAKA,MAA8B,uBAAuB;IASnD,kBAAkB;QAChB,OAAO,eAAe,CAAC;IACzB,CAAC;CACF;AAZD,0CAYC"}

package/lib/transpiler/transpiler.d.ts

@@ -0,0 +1,5 @@
+import { Type } from '@cparra/apex-reflection';
+import ProcessorTypeTranspiler from './processor-type-transpiler';
+export default class Transpiler {
+    static generate(types: Type[], processor: ProcessorTypeTranspiler): void;
+}

package/lib/transpiler/transpiler.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const settings_1 = require("../settings");
+const state_1 = require("../service/state");
+class Transpiler {
+    static generate(types, processor) {
+        var _a, _b;
+        const sortedTypes = types.sort((apexTypeA, apexTypeB) => {
+            if (apexTypeA.name < apexTypeB.name)
+                return -1;
+            if (apexTypeA.name > apexTypeB.name)
+                return 1;
+            return 0;
+        });
+        (_a = processor.onBeforeProcess) === null || _a === void 0 ? void 0 : _a.call(processor, sortedTypes);
+        if (settings_1.Settings.getInstance().indexOnly) {
+            return;
+        }
+        sortedTypes.forEach((currentType) => {
+            state_1.default.getInstance().setTypeBeingProcessed(currentType);
+            processor.onProcess(currentType);
+        });
+        (_b = processor.onAfterProcess) === null || _b === void 0 ? void 0 : _b.call(processor, sortedTypes);
+    }
+}
+exports.default = Transpiler;
+//# sourceMappingURL=transpiler.js.map

package/lib/transpiler/transpiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpiler.js","sourceRoot":"","sources":["../../src/transpiler/transpiler.ts"],"names":[],"mappings":";;AAEA,0CAAuC;AACvC,4CAAqC;AAErC,MAAqB,UAAU;IAC7B,MAAM,CAAC,QAAQ,CAAC,KAAa,EAAE,SAAkC;;QAC/D,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE;YACtD,IAAI,SAAS,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI;gBAAE,OAAO,CAAC,CAAC,CAAC;YAC/C,IAAI,SAAS,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI;gBAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QAEH,MAAA,SAAS,CAAC,eAAe,0DAAG,WAAW,CAAC,CAAC;QAEzC,IAAI,mBAAQ,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE;YACpC,OAAO;SACR;QAED,WAAW,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;YAClC,eAAK,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;YACvD,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,MAAA,SAAS,CAAC,cAAc,0DAAG,WAAW,CAAC,CAAC;IAC1C,CAAC;CACF;AApBD,6BAoBC"}

package/lib/util/error-logger.d.ts

@@ -0,0 +1,8 @@
+import { Type } from '@cparra/apex-reflection';
+export default class ErrorLogger {
+    static logErrors(types: Type[]): void;
+    private static logErrorsForSingleType;
+    private static logTypeErrors;
+    private static logErrorsForClass;
+    private static logErrorsForInterface;
+}

package/lib/util/error-logger.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const logger_1 = require("./logger");
+class ErrorLogger {
+    static logErrors(types) {
+        types.forEach((currentType) => {
+            this.logErrorsForSingleType(currentType);
+        });
+    }
+    static logErrorsForSingleType(currentType, parentType) {
+        this.logTypeErrors(currentType);
+        if (currentType.type_name === 'class') {
+            this.logErrorsForClass(currentType);
+        }
+        else if (currentType.type_name === 'interface') {
+            this.logErrorsForInterface(currentType);
+        }
+    }
+    static logTypeErrors(currentType, parentType) {
+        var _a;
+        if ((_a = currentType.docComment) === null || _a === void 0 ? void 0 : _a.error) {
+            const typeName = parentType ? `${parentType.name}.${currentType.name}` : currentType.name;
+            logger_1.Logger.error(`${typeName} - Doc comment parsing error. Level: Type`);
+            logger_1.Logger.error(`Comment:\n ${currentType.docComment.rawDeclaration}`);
+            logger_1.Logger.error(currentType.docComment.error);
+            logger_1.Logger.error('=================================');
+        }
+    }
+    static logErrorsForClass(classMirror, parentType) {
+        const typeName = parentType ? `${parentType.name}.${classMirror.name}` : classMirror.name;
+        classMirror.constructors.forEach((currentConstructor) => {
+            var _a;
+            if ((_a = currentConstructor.docComment) === null || _a === void 0 ? void 0 : _a.error) {
+                logger_1.Logger.error(`${typeName} - Doc comment parsing error. Level: Constructor`);
+                logger_1.Logger.error(`Comment:\n ${currentConstructor.docComment.rawDeclaration}`);
+                logger_1.Logger.error(currentConstructor.docComment.error);
+                logger_1.Logger.error('=================================');
+            }
+        });
+        classMirror.fields.forEach((currentField) => {
+            var _a;
+            if ((_a = currentField.docComment) === null || _a === void 0 ? void 0 : _a.error) {
+                logger_1.Logger.error(`${typeName} - Doc comment parsing error. Level: Field`);
+                logger_1.Logger.error(`Comment:\n ${currentField.docComment.rawDeclaration}`);
+                logger_1.Logger.error(currentField.docComment.error);
+                logger_1.Logger.error('=================================');
+            }
+        });
+        classMirror.properties.forEach((currentProperty) => {
+            var _a;
+            if ((_a = currentProperty.docComment) === null || _a === void 0 ? void 0 : _a.error) {
+                logger_1.Logger.error(`${typeName} - Doc comment parsing error. Level: Property`);
+                logger_1.Logger.error(`Comment:\n ${currentProperty.docComment.rawDeclaration}`);
+                logger_1.Logger.error(currentProperty.docComment.error);
+                logger_1.Logger.error('=================================');
+            }
+        });
+        classMirror.methods.forEach((currentMethod) => {
+            var _a;
+            if ((_a = currentMethod.docComment) === null || _a === void 0 ? void 0 : _a.error) {
+                logger_1.Logger.error(`${typeName} - Doc comment parsing error. Level: Method`);
+                logger_1.Logger.error(`Comment:\n ${currentMethod.docComment.rawDeclaration}`);
+                logger_1.Logger.error(currentMethod.docComment.error);
+                logger_1.Logger.error('=================================');
+            }
+        });
+        classMirror.enums.forEach((currentEnum) => {
+            this.logErrorsForSingleType(currentEnum, classMirror);
+        });
+        classMirror.interfaces.forEach((currentInterface) => {
+            this.logErrorsForSingleType(currentInterface, classMirror);
+        });
+        classMirror.classes.forEach((currentClass) => {
+            this.logErrorsForSingleType(currentClass, classMirror);
+        });
+    }
+    static logErrorsForInterface(interfaceMirror) {
+        interfaceMirror.methods.forEach((currentMethod) => {
+            var _a;
+            if ((_a = currentMethod.docComment) === null || _a === void 0 ? void 0 : _a.error) {
+                logger_1.Logger.error(`${interfaceMirror.name} - Doc comment parsing error. Level: Method`);
+                logger_1.Logger.error(`Comment: ${currentMethod.docComment.rawDeclaration}`);
+                logger_1.Logger.error(currentMethod.docComment.error);
+                logger_1.Logger.error('=================================');
+            }
+        });
+    }
+}
+exports.default = ErrorLogger;
+//# sourceMappingURL=error-logger.js.map

package/lib/util/error-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-logger.js","sourceRoot":"","sources":["../../src/util/error-logger.ts"],"names":[],"mappings":";;AACA,qCAAkC;AAElC,MAAqB,WAAW;IACvB,MAAM,CAAC,SAAS,CAAC,KAAa;QACnC,KAAK,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;YAC5B,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,sBAAsB,CAAC,WAAiB,EAAE,UAAiB;QACxE,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAEhC,IAAI,WAAW,CAAC,SAAS,KAAK,OAAO,EAAE;YACrC,IAAI,CAAC,iBAAiB,CAAC,WAA0B,CAAC,CAAC;SACpD;aAAM,IAAI,WAAW,CAAC,SAAS,KAAK,WAAW,EAAE;YAChD,IAAI,CAAC,qBAAqB,CAAC,WAA8B,CAAC,CAAC;SAC5D;IACH,CAAC;IAEO,MAAM,CAAC,aAAa,CAAC,WAAiB,EAAE,UAAiB;;QAC/D,IAAI,MAAA,WAAW,CAAC,UAAU,0CAAE,KAAK,EAAE;YACjC,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAW,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC;YAC3F,eAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,2CAA2C,CAAC,CAAC;YACrE,eAAM,CAAC,KAAK,CAAC,cAAc,WAAW,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;YACpE,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC3C,eAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;SACnD;IACH,CAAC;IAEO,MAAM,CAAC,iBAAiB,CAAC,WAAwB,EAAE,UAAiB;QAC1E,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAW,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC;QAC3F,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,kBAAkB,EAAE,EAAE;;YACtD,IAAI,MAAA,kBAAkB,CAAC,UAAU,0CAAE,KAAK,EAAE;gBACxC,eAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,kDAAkD,CAAC,CAAC;gBAC5E,eAAM,CAAC,KAAK,CAAC,cAAc,kBAAkB,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;gBAC3E,eAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAClD,eAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;aACnD;QACH,CAAC,CAAC,CAAC;QAEH,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;;YAC1C,IAAI,MAAA,YAAY,CAAC,UAAU,0CAAE,KAAK,EAAE;gBAClC,eAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,4CAA4C,CAAC,CAAC;gBACtE,eAAM,CAAC,KAAK,CAAC,cAAc,YAAY,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;gBACrE,eAAM,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC5C,eAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;aACnD;QACH,CAAC,CAAC,CAAC;QAEH,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,EAAE;;YACjD,IAAI,MAAA,eAAe,CAAC,UAAU,0CAAE,KAAK,EAAE;gBACrC,eAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,+CAA+C,CAAC,CAAC;gBACzE,eAAM,CAAC,KAAK,CAAC,cAAc,eAAe,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;gBACxE,eAAM,CAAC,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC/C,eAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;aACnD;QACH,CAAC,CAAC,CAAC;QAEH,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,EAAE;;YAC5C,IAAI,MAAA,aAAa,CAAC,UAAU,0CAAE,KAAK,EAAE;gBACnC,eAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,6CAA6C,CAAC,CAAC;gBACvE,eAAM,CAAC,KAAK,CAAC,cAAc,aAAa,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;gBACtE,eAAM,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC7C,eAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;aACnD;QACH,CAAC,CAAC,CAAC;QAEH,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;YACxC,IAAI,CAAC,sBAAsB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,EAAE;YAClD,IAAI,CAAC,sBAAsB,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;YAC3C,IAAI,CAAC,sBAAsB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,qBAAqB,CAAC,eAAgC;QACnE,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,EAAE;;YAChD,IAAI,MAAA,aAAa,CAAC,UAAU,0CAAE,KAAK,EAAE;gBACnC,eAAM,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,IAAI,6CAA6C,CAAC,CAAC;gBACnF,eAAM,CAAC,KAAK,CAAC,YAAY,aAAa,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;gBACpE,eAAM,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC7C,eAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;aACnD;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAxFD,8BAwFC"}

package/lib/util/logger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Logs messages to the console.
+ */
+export declare class Logger {
+    static currentFrame: number;
+    static frames: string[];
+    /**
+     * Logs a message with optional arguments.
+     * @param message The message to log.
+     * @param args Optional arguments.
+     */
+    static log(message: string, ...args: string[]): void;
+    /**
+     * Logs an error message with optional arguments.
+     * @param message The error message to log.
+     * @param args Optional arguments.
+     */
+    static error(message: string, ...args: string[]): void;
+    static logSingle(text: string, showSpinner?: boolean, color?: 'green' | 'red', overrideConsole?: boolean): void;
+    static clear(): void;
+}

package/lib/util/logger.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const chalk = require("chalk");
+const logUpdate = require("log-update");
+/**
+ * Logs messages to the console.
+ */
+class Logger {
+    /**
+     * Logs a message with optional arguments.
+     * @param message The message to log.
+     * @param args Optional arguments.
+     */
+    static log(message, ...args) {
+        this.logSingle(message);
+        args.forEach((arg) => {
+            this.logSingle(arg);
+        });
+    }
+    /**
+     * Logs an error message with optional arguments.
+     * @param message The error message to log.
+     * @param args Optional arguments.
+     */
+    static error(message, ...args) {
+        this.logSingle(message, false, 'red', false);
+        args.forEach((arg) => {
+            this.logSingle(message, false, 'red', false);
+        });
+    }
+    static logSingle(text, showSpinner = true, color = 'green', overrideConsole = true) {
+        if (this.currentFrame > 9) {
+            this.currentFrame = 0;
+        }
+        const spinner = showSpinner ? `${this.frames[this.currentFrame++]}` : '';
+        let logMessage;
+        if (color === 'green') {
+            logMessage = `${chalk.green(new Date().toLocaleString() + ': ')}${text}\n`;
+        }
+        else {
+            logMessage = `${chalk.red(new Date().toLocaleString() + ': ')}${text}\n`;
+        }
+        if (overrideConsole) {
+            logUpdate(`${spinner} ${logMessage}`);
+        }
+        else {
+            process.stdout.write(`${spinner} ${logMessage}`);
+        }
+    }
+    static clear() {
+        logUpdate.clear();
+    }
+}
+exports.Logger = Logger;
+Logger.currentFrame = -1;
+Logger.frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+//# sourceMappingURL=logger.js.map

package/lib/util/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":";;;AAAA,+BAA+B;AAC/B,wCAAwC;AAExC;;GAEG;AACH,MAAa,MAAM;IAKjB;;;;OAIG;IACI,MAAM,CAAC,GAAG,CAAC,OAAe,EAAE,GAAG,IAAc;QAClD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,OAAe,EAAE,GAAG,IAAc;QACpD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,SAAS,CAAC,IAAY,EAAE,WAAW,GAAG,IAAI,EAAE,QAAyB,OAAO,EAAE,eAAe,GAAG,IAAI;QAChH,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE;YACzB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;SACvB;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,IAAI,UAAU,CAAC;QACf,IAAI,KAAK,KAAK,OAAO,EAAE;YACrB,UAAU,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC;SAC5E;aAAM;YACL,UAAU,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC;SAC1E;QACD,IAAI,eAAe,EAAE;YACnB,SAAS,CAAC,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC;SACvC;aAAM;YACL,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC;SAClD;IACH,CAAC;IAEM,MAAM,CAAC,KAAK;QACjB,SAAS,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;;AAjDH,wBAkDC;AAjDQ,mBAAY,GAAG,CAAC,CAAC,CAAC;AAElB,aAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC"}

package/lib/util/string-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function truncate(str: string, n: number): string;
+export declare const camel2title: (camelCase: string) => string;

package/lib/util/string-utils.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.camel2title = exports.truncate = void 0;
+function truncate(str, n) {
+    return str.length > n ? str.substr(0, n - 1) + '…' : str;
+}
+exports.truncate = truncate;
+const camel2title = (camelCase) => camelCase
+    .replace(/\//g, ' ')
+    .replace(/([A-Z])/g, (match) => ` ${match}`)
+    .replace(/\b\w/g, (match) => match.toUpperCase())
+    .replace(/^./, (match) => match.toUpperCase())
+    .trim();
+exports.camel2title = camel2title;
+//# sourceMappingURL=string-utils.js.map

package/lib/util/string-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../src/util/string-utils.ts"],"names":[],"mappings":";;;AAAA,SAAgB,QAAQ,CAAC,GAAW,EAAE,CAAS;IAC7C,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;AAClE,CAAC;AAFD,4BAEC;AAEM,MAAM,WAAW,GAAG,CAAC,SAAiB,EAAE,EAAE,CAC/C,SAAS;KACN,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;KACnB,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;KAC3C,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;KAChD,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;KAC7C,IAAI,EAAE,CAAC;AANC,QAAA,WAAW,eAMZ"}