@cparra/apexdocs 3.0.0 → 3.1.1

package/src/test-helpers/FieldMirrorBuilder.ts

@@ -1,59 +0,0 @@
-import { DocComment, FieldMirror } from '@cparra/apex-reflection';
-import { ReferencedType } from '@cparra/apex-reflection';
-
-type MemberModifier = 'static' | 'webservice' | 'final' | 'override' | 'testmethod' | 'transient';
-
-export class FieldMirrorBuilder {
-  private docComment: DocComment | undefined = undefined;
-  private accessModifier = 'public';
-  private name = 'fieldName';
-  private memberModifiers: MemberModifier[] = [];
-  private type: ReferencedType = {
-    type: 'String',
-    rawDeclaration: 'String',
-  };
-
-  withAccessModifier(accessModifier: string): FieldMirrorBuilder {
-    this.accessModifier = accessModifier;
-    return this;
-  }
-
-  withName(name: string): FieldMirrorBuilder {
-    this.name = name;
-    return this;
-  }
-
-  withType(type: string): FieldMirrorBuilder {
-    this.type = {
-      rawDeclaration: type,
-      type: type,
-    };
-    return this;
-  }
-
-  withReferencedType(type: ReferencedType): FieldMirrorBuilder {
-    this.type = type;
-    return this;
-  }
-
-  addMemberModifier(memberModifier: MemberModifier): FieldMirrorBuilder {
-    this.memberModifiers.push(memberModifier);
-    return this;
-  }
-
-  withDocComment(docComment: DocComment): FieldMirrorBuilder {
-    this.docComment = docComment;
-    return this;
-  }
-
-  build(): FieldMirror {
-    return {
-      access_modifier: this.accessModifier,
-      annotations: [],
-      name: this.name,
-      memberModifiers: this.memberModifiers,
-      typeReference: this.type,
-      docComment: this.docComment,
-    };
-  }
-}

package/src/test-helpers/InterfaceMirrorBuilder.ts

@@ -1,39 +0,0 @@
-import { Annotation, DocComment, InterfaceMirror, MethodMirror } from '@cparra/apex-reflection';
-
-/**
- * Builder class to create Interface objects.
- * For testing purposes only.
- */
-export class InterfaceMirrorBuilder {
-  private name = 'SampleClass';
-  private annotations: Annotation[] = [];
-  private docComment?: DocComment;
-  private methods: MethodMirror[] = [];
-
-  withName(name: string): InterfaceMirrorBuilder {
-    this.name = name;
-    return this;
-  }
-
-  addAnnotation(annotation: Annotation): InterfaceMirrorBuilder {
-    this.annotations.push(annotation);
-    return this;
-  }
-
-  addMethod(method: MethodMirror): InterfaceMirrorBuilder {
-    this.methods.push(method);
-    return this;
-  }
-
-  build(): InterfaceMirror {
-    return {
-      annotations: this.annotations,
-      name: this.name,
-      type_name: 'interface',
-      methods: this.methods,
-      access_modifier: 'public',
-      docComment: this.docComment,
-      extended_interfaces: [],
-    };
-  }
-}

package/src/test-helpers/MethodMirrorBuilder.ts

@@ -1,77 +0,0 @@
-import { Annotation, DocComment, MethodMirror, ParameterMirror } from '@cparra/apex-reflection';
-
-type Parameter = ParameterMirror;
-
-export class MethodMirrorBuilder {
-  private name = 'sampleMethod';
-  private annotations: Annotation[] = [];
-  private docComment?: DocComment;
-  private typeReference: { type: string; rawDeclaration: string } = {
-    type: 'void',
-    rawDeclaration: 'void',
-  };
-  private parameters: Parameter[] = [];
-
-  withName(name: string): MethodMirrorBuilder {
-    this.name = name;
-    return this;
-  }
-
-  addAnnotation(annotation: Annotation): MethodMirrorBuilder {
-    this.annotations.push(annotation);
-    return this;
-  }
-
-  withDocComment(docComment: DocComment): MethodMirrorBuilder {
-    this.docComment = docComment;
-    return this;
-  }
-
-  withTypeReference(param: { type: string; rawDeclaration: string }) {
-    this.typeReference = param;
-    return this;
-  }
-
-  addParameter(parameter: Parameter): MethodMirrorBuilder {
-    this.parameters.push(parameter);
-    return this;
-  }
-
-  build(): MethodMirror {
-    return {
-      access_modifier: 'public',
-      annotations: this.annotations,
-      name: this.name,
-      memberModifiers: [],
-      typeReference: this.typeReference,
-      parameters: this.parameters,
-      docComment: this.docComment,
-    };
-  }
-}
-
-export class ParameterBuilder {
-  private name = 'param';
-  private typeReference: { type: string; rawDeclaration: string } = {
-    type: 'String',
-    rawDeclaration: 'String',
-  };
-
-  withName(name: string): ParameterBuilder {
-    this.name = name;
-    return this;
-  }
-
-  withTypeReference(param: { type: string; rawDeclaration: string }) {
-    this.typeReference = param;
-    return this;
-  }
-
-  build(): Parameter {
-    return {
-      memberModifiers: [],
-      name: this.name,
-      typeReference: this.typeReference,
-    };
-  }
-}

package/src/test-helpers/SettingsBuilder.ts

@@ -1,17 +0,0 @@
-import { SettingsConfig } from '../core/openApiSettings';
-
-/**
- * Builder class to create SettingsConfig objects.
- * For testing purposes only.
- */
-export class SettingsBuilder {
-  build(): SettingsConfig {
-    return {
-      sourceDirectory: './',
-      outputDir: './',
-      openApiTitle: 'Apex API',
-      openApiFileName: 'openapi',
-      version: '1.0.0',
-    };
-  }
-}

package/src/util/error-logger.ts

@@ -1,92 +0,0 @@
-import { ClassMirror, InterfaceMirror, Type } from '@cparra/apex-reflection';
-import { Logger } from './logger';
-
-export default class ErrorLogger {
-  public static logErrors(logger: Logger, types: Type[]): void {
-    types.forEach((currentType) => {
-      this.logErrorsForSingleType(logger, currentType);
-    });
-  }
-
-  private static logErrorsForSingleType(logger: Logger, currentType: Type): void {
-    this.logTypeErrors(logger, currentType);
-
-    if (currentType.type_name === 'class') {
-      this.logErrorsForClass(logger, currentType as ClassMirror);
-    } else if (currentType.type_name === 'interface') {
-      this.logErrorsForInterface(logger, currentType as InterfaceMirror);
-    }
-  }
-
-  private static logTypeErrors(logger: Logger, currentType: Type, parentType?: Type) {
-    if (currentType.docComment?.error) {
-      const typeName = parentType ? `${parentType!.name}.${currentType.name}` : currentType.name;
-      logger.error(`${typeName} - Doc comment parsing error. Level: Type`);
-      logger.error(`Comment:\n ${currentType.docComment.rawDeclaration}`);
-      logger.error(currentType.docComment.error);
-      logger.error('=================================');
-    }
-  }
-
-  private static logErrorsForClass(logger: Logger, classMirror: ClassMirror, parentType?: Type): void {
-    const typeName = parentType ? `${parentType!.name}.${classMirror.name}` : classMirror.name;
-    classMirror.constructors.forEach((currentConstructor) => {
-      if (currentConstructor.docComment?.error) {
-        logger.error(`${typeName} - Doc comment parsing error. Level: Constructor`);
-        logger.error(`Comment:\n ${currentConstructor.docComment.rawDeclaration}`);
-        logger.error(currentConstructor.docComment.error);
-        logger.error('=================================');
-      }
-    });
-
-    classMirror.fields.forEach((currentField) => {
-      if (currentField.docComment?.error) {
-        logger.error(`${typeName} - Doc comment parsing error. Level: Field`);
-        logger.error(`Comment:\n ${currentField.docComment.rawDeclaration}`);
-        logger.error(currentField.docComment.error);
-        logger.error('=================================');
-      }
-    });
-
-    classMirror.properties.forEach((currentProperty) => {
-      if (currentProperty.docComment?.error) {
-        logger.error(`${typeName} - Doc comment parsing error. Level: Property`);
-        logger.error(`Comment:\n ${currentProperty.docComment.rawDeclaration}`);
-        logger.error(currentProperty.docComment.error);
-        logger.error('=================================');
-      }
-    });
-
-    classMirror.methods.forEach((currentMethod) => {
-      if (currentMethod.docComment?.error) {
-        logger.error(`${typeName} - Doc comment parsing error. Level: Method`);
-        logger.error(`Comment:\n ${currentMethod.docComment.rawDeclaration}`);
-        logger.error(currentMethod.docComment.error);
-        logger.error('=================================');
-      }
-    });
-
-    classMirror.enums.forEach((currentEnum) => {
-      this.logErrorsForSingleType(logger, currentEnum);
-    });
-
-    classMirror.interfaces.forEach((currentInterface) => {
-      this.logErrorsForSingleType(logger, currentInterface);
-    });
-
-    classMirror.classes.forEach((currentClass) => {
-      this.logErrorsForSingleType(logger, currentClass);
-    });
-  }
-
-  private static logErrorsForInterface(logger: Logger, interfaceMirror: InterfaceMirror): void {
-    interfaceMirror.methods.forEach((currentMethod) => {
-      if (currentMethod.docComment?.error) {
-        logger.error(`${interfaceMirror.name} - Doc comment parsing error. Level: Method`);
-        logger.error(`Comment: ${currentMethod.docComment.rawDeclaration}`);
-        logger.error(currentMethod.docComment.error);
-        logger.error('=================================');
-      }
-    });
-  }
-}

package/src/util/fp.ts

@@ -1,3 +0,0 @@
-export function apply<T extends unknown[], U extends unknown[], R>(fn: (...args: [...T, ...U]) => R, ...front: T) {
-  return (...tailArgs: U) => fn(...front, ...tailArgs);
-}

package/src/util/logger.ts

@@ -1,51 +0,0 @@
-import chalk from 'chalk';
-
-export interface Logger {
-  log(message: string, ...args: string[]): void;
-  error(message: unknown, ...args: string[]): void;
-  logSingle(text: unknown, color?: 'green' | 'red'): void;
-}
-
-/**
- * Logs messages to the console.
- */
-export class StdOutLogger {
-  /**
-   * Logs a message with optional arguments.
-   * @param message The message to log.
-   * @param args Optional arguments.
-   */
-  public log(message: string, ...args: string[]) {
-    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.
-   */
-  public error(message: unknown, ...args: string[]) {
-    this.logSingle(message, 'red');
-    args.forEach(() => {
-      this.logSingle(message, 'red');
-    });
-  }
-
-  public logSingle(text: unknown, color: 'green' | 'red' = 'green') {
-    const logMessage = `${this.getChalkFn(color)(new Date().toLocaleString() + ': ')}${text}\n`;
-    process.stdout.write(logMessage);
-  }
-
-  private getChalkFn(color: 'green' | 'red') {
-    return color === 'green' ? chalk.green : chalk.red;
-  }
-}
-
-export class NoLogger implements Logger {
-  public log() {}
-  public error() {}
-  public logSingle() {}
-}

package/src/util/string-utils.ts

@@ -1,7 +0,0 @@
-export const camel2title = (camelCase: string) =>
-  camelCase
-    .replace(/\//g, ' ')
-    .replace(/([A-Z])/g, (match) => ` ${match}`)
-    .replace(/\b\w/g, (match) => match.toUpperCase())
-    .replace(/^./, (match) => match.toUpperCase())
-    .trim();

package/tsconfig.json

@@ -1,25 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "es6",
-    "module": "commonjs",
-    "declaration": true,
-    "outDir": "./dist",
-    "strict": true,
-    "sourceMap": true,
-    "esModuleInterop": true,
-    "lib": [
-      "ES2021"
-    ],
-    "baseUrl": "./",
-    "paths": {
-      "#utils/*": ["src/util/*"],
-    }
-  },
-  "include": [
-    "src", "jest.d.ts"
-  ],
-  "exclude": [
-    "node_modules",
-    "**/__tests__/*"
-  ]
-}

package/tslint.json

@@ -1,6 +0,0 @@
-{
-    "extends": [
-        "tslint:recommended",
-        "tslint-config-prettier"
-    ]
-}