@invariant--labs/foundation 1.1.2 → 1.1.5

package/src/nestjs/errors/parsers/axios-metadata.parser.ts

@@ -1,21 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unsafe-assignment */
-import { AxiosError } from "axios";
-
-import { ErrorMetadata } from "./error-metadata.definition";
-
-export const axiosMetadataParser = (error: unknown, extraMetadata: ErrorMetadata = {}): ErrorMetadata => {
-  if (!(error instanceof AxiosError)) {
-    return { ...extraMetadata, rawError: error };
-  }
-
-  const { status, statusText, data, config } = error.response ?? {};
-
-  return {
-    ...extraMetadata,
-    code: status,
-    status: statusText,
-    data,
-    url: config?.url,
-    httpMethod: config?.method,
-  };
-};

package/src/nestjs/errors/parsers/error-metadata.definition.ts

@@ -1 +0,0 @@
-export type ErrorMetadata = Record<string, unknown>;

package/src/nestjs/errors/parsers/knex-metadata.parser.ts

@@ -1,18 +0,0 @@
-import { ErrorMetadata } from "./error-metadata.definition";
-
-export const knexMetadataParser = (error: unknown, extraMetadata: ErrorMetadata = {}): ErrorMetadata => {
-  const knexError = error as Record<string, unknown> | null;
-
-  const metadata: ErrorMetadata = {
-    code: knexError?.code,
-    hint: knexError?.hint,
-    detail: knexError?.detail,
-    ...extraMetadata,
-  };
-
-  if (!metadata.code && !metadata.hint && !metadata.detail) {
-    metadata.rawError = error;
-  }
-
-  return metadata;
-};

package/src/nestjs/errors/parsers/typeorm-metadata.parser.ts

@@ -1,19 +0,0 @@
-import { TypeORMError } from "typeorm";
-
-import { ErrorMetadata } from "./error-metadata.definition";
-
-export const typeormMetadataParser = (error: unknown, extraMetadata: ErrorMetadata = {}): ErrorMetadata => {
-  const metadata: ErrorMetadata = {
-    detail: (error as Record<string, unknown> | null)?.detail,
-    ...extraMetadata,
-  };
-
-  if (error instanceof TypeORMError) {
-    metadata.message = error.message;
-    metadata.name = error.name;
-  } else {
-    metadata.rawError = error;
-  }
-
-  return metadata;
-};

package/src/nestjs/errors/parsers/workos-metadata.parser.ts

@@ -1,17 +0,0 @@
-import { ErrorMetadata } from "./error-metadata.definition";
-
-export const workosMetadataParser = (error: unknown, extraMetadata: ErrorMetadata = {}): ErrorMetadata => {
-  const rawData = (error as Record<string, Record<string, unknown>> | null)?.rawData;
-
-  const metadata: ErrorMetadata = {
-    code: rawData?.code,
-    message: rawData?.message,
-    ...extraMetadata,
-  };
-
-  if (!metadata.code) {
-    metadata.rawError = error;
-  }
-
-  return metadata;
-};

package/src/nestjs/http/decorators/log-app-ctx.decorator.ts

@@ -1,32 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access */
-import { Inject } from "@nestjs/common";
-
-import { ArchitectureLayer, ArchitectureLevel } from "../../../core/types";
-import { LoggerService } from "../../../modules/logger/logger.service";
-
-export function LogAppCtx() {
-  const injectLogger = Inject(LoggerService);
-
-  return function (target: object, _propertyKey: string, descriptor: unknown) {
-    injectLogger(target, "logger");
-
-    const originalMethod = (descriptor as PropertyDescriptor).value;
-
-    (descriptor as PropertyDescriptor).value = function (...args: unknown[]) {
-      const className = target.constructor.name;
-      const type = className.includes("CommandHandler")
-        ? "command"
-        : className.includes("QueryHandler")
-          ? "query"
-          : null;
-
-      if (type) {
-        (this as { logger: LoggerService }).logger?.ctx({
-          [ArchitectureLevel.APPLICATION]: { [type]: { className } },
-        } as ArchitectureLayer);
-      }
-
-      return originalMethod.apply(this, args);
-    };
-  };
-}

package/src/nestjs/http/dtos/date-range.dto.ts

@@ -1,15 +0,0 @@
-import { Type } from "class-transformer";
-import { IsDate, IsOptional } from "class-validator";
-
-// NOTE: only use this dto for POST query
-export class DateRangeDto {
-  @IsOptional()
-  @Type(() => Date)
-  @IsDate()
-  from?: Date;
-
-  @IsOptional()
-  @Type(() => Date)
-  @IsDate()
-  to?: Date;
-}

package/src/nestjs/http/dtos/index.ts

@@ -1 +0,0 @@
-export * from "./date-range.dto";

package/src/nestjs/http/filters/all-exceptions.filter.ts

@@ -1,92 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
-import { ArgumentsHost, Catch, ExceptionFilter, HttpException, HttpStatus } from "@nestjs/common";
-import { HttpArgumentsHost, RpcArgumentsHost } from "@nestjs/common/interfaces";
-import * as Sentry from "@sentry/nestjs";
-import { Response } from "express";
-
-import { ArchitectureLayer, ArchitectureLevel } from "../../../core/types";
-import { GenericErrorHandler } from "../../errors/handlers/generic-error-handler";
-import { LoggerService } from "../../../modules/logger/logger.service";
-
-@Catch()
-export class AllExceptionsFilter implements ExceptionFilter {
-  private readonly genericErrorHandler = new GenericErrorHandler();
-  private readonly currentLayer: ArchitectureLayer = {
-    [ArchitectureLevel.INFRASTRUCTURE]: {
-      "web-rest": {
-        className: AllExceptionsFilter.name,
-      },
-    },
-  };
-
-  constructor(private readonly loggerService: LoggerService) {}
-
-  catch(error: unknown, host: ArgumentsHost) {
-    if (!(error instanceof HttpException)) {
-      Sentry.captureException(error);
-    }
-
-    if (host.getType() === "http") {
-      return this.throwHttp(error, host.switchToHttp());
-    }
-
-    if (host.getType() === "rpc") {
-      this.logRpc(error, host.switchToRpc());
-      return;
-    }
-
-    this.loggerService.warn("Unhandled error", error instanceof Error ? { error: error.message, stack: error.stack } : undefined);
-  }
-
-  private throwHttp(error: unknown, httpContext: HttpArgumentsHost) {
-    const response = httpContext.getResponse<Response>();
-
-    if (error instanceof HttpException) {
-      return this.throwHttpException(error, response);
-    }
-
-    const genericHttpException = this.genericErrorHandler.toHttpException(error);
-    if (genericHttpException) {
-      return this.throwHttpException(genericHttpException, response);
-    }
-
-    return this.throwUnhandledException(error, response);
-  }
-
-  private throwHttpException(exception: HttpException, response: Response<unknown, Record<string, unknown>>) {
-    const statusCode = exception.getStatus();
-    const cause = exception.cause as Record<string, unknown> | undefined;
-
-    const layer = (cause?.layer ?? cause?.layerObject ?? this.currentLayer) as ArchitectureLayer;
-    const details = (cause?.details ?? cause?.detailsObject ?? {}) as Record<string, unknown>;
-    const message = (cause?.message as string) ?? "";
-    const errorResponse = cause?.response ?? {};
-
-    this.loggerService.ctx(layer, { ...details });
-    this.loggerService.info(`[Platform] error thrown: ${message}`);
-
-    return response.status(statusCode).json({
-      statusCode,
-      message: exception.message,
-      cause: errorResponse,
-    });
-  }
-
-  private throwUnhandledException(error: unknown, response: Response<unknown, Record<string, unknown>>) {
-    this.loggerService.warn(`Unhandled error: ${String(error)}`, error instanceof Error ? { error: error.message, stack: error.stack } : undefined);
-    return response.status(HttpStatus.INTERNAL_SERVER_ERROR).json({
-      statusCode: HttpStatus.INTERNAL_SERVER_ERROR,
-      message: "Unexpected error",
-    });
-  }
-
-  private logRpc(error: unknown, rpcContext: RpcArgumentsHost) {
-    const context = rpcContext.getContext();
-    const queue = context.args[0].fields.routingKey;
-    const pattern = context.args[2];
-    this.loggerService.warn(
-      "RPC error",
-      error instanceof Error ? { error, queue, pattern, payload: rpcContext.getData() } : undefined,
-    );
-  }
-}

package/src/nestjs/http/filters/command-failure.filter.ts

@@ -1,12 +0,0 @@
-import { ArgumentsHost, Catch } from "@nestjs/common";
-import { GqlArgumentsHost, GqlExceptionFilter } from "@nestjs/graphql";
-
-import { CommandFailureError } from "../../../core/errors/command-failure.error";
-
-@Catch(CommandFailureError)
-export class CommandFailureFilter implements GqlExceptionFilter {
-  catch(error: CommandFailureError, host: ArgumentsHost) {
-    if (GqlArgumentsHost.create(host).getInfo() != null) {return error;}
-    throw error;
-  }
-}

package/src/nestjs/http/filters/rpc-exceptions.filter.ts

@@ -1,10 +0,0 @@
-import { Catch, RpcExceptionFilter as NestRpcExceptionFilter } from "@nestjs/common";
-import { RpcException } from "@nestjs/microservices";
-import { Observable, throwError } from "rxjs";
-
-@Catch(RpcException)
-export class RpcExceptionFilter implements NestRpcExceptionFilter {
-  catch(exception: RpcException): Observable<unknown> {
-    return throwError(() => exception.getError());
-  }
-}

package/src/nestjs/http/filters/too-many-results.filter.ts

@@ -1,12 +0,0 @@
-import { ArgumentsHost, Catch } from "@nestjs/common";
-import { GqlArgumentsHost, GqlExceptionFilter } from "@nestjs/graphql";
-
-import { TooManyResultsError } from "../../../core/errors/too-many-results.error";
-
-@Catch(TooManyResultsError)
-export class TooManyResultsFilter implements GqlExceptionFilter {
-  catch(error: TooManyResultsError, host: ArgumentsHost) {
-    if (GqlArgumentsHost.create(host).getInfo() != null) {return error;}
-    throw error;
-  }
-}

package/src/nestjs/http/interceptors/log-app-ctx.interceptor.ts

@@ -1,109 +0,0 @@
-import { CallHandler, ExecutionContext, Injectable, NestInterceptor } from "@nestjs/common";
-import { GqlContextType, GqlExecutionContext } from "@nestjs/graphql";
-import type { Request } from "express";
-import type { GraphQLResolveInfo } from "graphql";
-
-import { ArchitectureLevel } from "../../../core/types";
-import { LoggerService } from "../../../modules/logger/logger.service";
-
-@Injectable()
-export class LogAppCtxInterceptor implements NestInterceptor {
-  constructor(private readonly loggerService: LoggerService) {}
-
-  intercept(context: ExecutionContext, next: CallHandler) {
-    switch (context.getType<GqlContextType>()) {
-      case "http": {
-        this.setHttpLogContext(context);
-        break;
-      }
-      case "rpc": {
-        this.setRpcLogContext(context);
-        break;
-      }
-      case "ws": {
-        this.setWsLogContext(context);
-        break;
-      }
-      case "graphql": {
-        this.setGraphqlLogContext(context);
-        break;
-      }
-    }
-
-    return next.handle();
-  }
-
-  private setHttpLogContext(context: ExecutionContext) {
-    const className = context.getClass().name;
-    const handlerName = context.getHandler().name;
-    const httpContext = context.switchToHttp();
-    const request = httpContext.getRequest<Request>();
-
-    this.loggerService.ctx({
-      [ArchitectureLevel.INFRASTRUCTURE]: {
-        "web-rest": {
-          className,
-          meta: {
-            handlerName,
-            path: request.url,
-            method: request.method,
-          },
-        },
-      },
-    });
-  }
-
-  private setRpcLogContext(context: ExecutionContext) {
-    const className = context.getClass().name;
-    const handlerName = context.getHandler().name;
-
-    this.loggerService.ctx({
-      [ArchitectureLevel.INFRASTRUCTURE]: {
-        "web-rpc": {
-          className,
-          meta: { handlerName },
-        },
-      },
-    });
-  }
-
-  private setWsLogContext(context: ExecutionContext) {
-    const className = context.getClass().name;
-    const handlerName = context.getHandler().name;
-    const wsContext = context.switchToWs();
-    const pattern = wsContext.getPattern();
-
-    this.loggerService.ctx({
-      [ArchitectureLevel.INFRASTRUCTURE]: {
-        "web-socket": {
-          className,
-          meta: {
-            handlerName,
-            pattern,
-          },
-        },
-      },
-    });
-  }
-
-  private setGraphqlLogContext(context: ExecutionContext) {
-    const className = context.getClass().name;
-    const handlerName = context.getHandler().name;
-    const gqlContext = GqlExecutionContext.create(context);
-    const info = gqlContext.getInfo<GraphQLResolveInfo>();
-
-    this.loggerService.ctx({
-      [ArchitectureLevel.INFRASTRUCTURE]: {
-        "web-graphql": {
-          className,
-          meta: {
-            handlerName,
-            operationName: info.operation.name?.value,
-            operationType: info.operation.operation,
-            fieldName: info.fieldName,
-          },
-        },
-      },
-    });
-  }
-}

package/src/nestjs/http/interceptors/serialize-output.interceptor.ts

@@ -1,19 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-argument */
-import { ClassSerializerInterceptor, mixin, Type, UseInterceptors } from "@nestjs/common";
-import * as ClassTransformer from "class-transformer";
-
-function PojoSerializer<T>(serializedClass: Type<T>): Type<ClassSerializerInterceptor> {
-  class CustomSerializer extends ClassSerializerInterceptor {
-    override transformToPlain(pojoOrInstance: unknown, transformOptions: ClassTransformer.ClassTransformOptions) {
-      transformOptions.strategy ??= "excludeAll";
-      const instance = Object.assign(Object.create(serializedClass.prototype), pojoOrInstance);
-      return super.transformToPlain(instance, transformOptions);
-    }
-  }
-
-  return mixin(CustomSerializer);
-}
-
-export function SerializeOutput<T>(dtoClass: Type<T>) {
-  return UseInterceptors(PojoSerializer(dtoClass));
-}

package/src/nestjs/http/middleware/http-logger.middleware.ts

@@ -1,31 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unsafe-member-access */
-import { Injectable, NestMiddleware } from "@nestjs/common";
-import type { NextFunction, Request, Response } from "express";
-
-import { LoggerService } from "../../../modules/logger/logger.service";
-
-@Injectable()
-export class HttpLoggerMiddleware implements NestMiddleware {
-  constructor(private readonly loggerService: LoggerService) {}
-  use(req?: Request, res?: Response, next?: NextFunction) {
-    try {
-      if (req && res) {
-        const start = Date.now();
-        res.on("close", () => {
-          const graphql = req.body?.operationName ? ` ${req.body.operationName}` : "";
-          this.loggerService.clearCtx();
-          this.loggerService.http(`[${req.method}] ${req.originalUrl}${graphql}`, {
-            body: req.body,
-            method: req.method,
-            metrics: { duration: Date.now() - start },
-            status: res.statusCode,
-          });
-        });
-      }
-    } catch {
-      this.loggerService.warn("something went wrong while logging");
-    }
-
-    next?.();
-  }
-}

package/src/nestjs/http/middleware/logger.middleware.ts

@@ -1,21 +0,0 @@
-import { Injectable, NestMiddleware } from "@nestjs/common";
-import type { NextFunction, Request, Response } from "express";
-import { v4 as uuidv4 } from "uuid";
-
-import { ArchitectureLevel } from "../../../core/types";
-import { LoggerService } from "../../../modules/logger/logger.service";
-
-@Injectable()
-export class LoggerMiddleware implements NestMiddleware {
-  constructor(private readonly loggerService: LoggerService) {}
-  use(req: Request, res: Response, next: NextFunction) {
-    const requestId = uuidv4();
-    this.loggerService.init(req, res, () => {
-      this.loggerService.ctx(
-        { [ArchitectureLevel.INFRASTRUCTURE]: { "web-rest": { className: LoggerMiddleware.name } } },
-        { requestId },
-      );
-      next();
-    });
-  }
-}

package/src/nestjs/http/swagger/index.ts

@@ -1 +0,0 @@
-export * from "./swagger";

package/src/nestjs/http/swagger/swagger.ts

@@ -1,44 +0,0 @@
-import { INestApplication } from "@nestjs/common";
-import { DocumentBuilder, SwaggerModule } from "@nestjs/swagger";
-import basicAuth from "express-basic-auth";
-
-import { ConfigService } from "../../../core/infrastructure/config";
-
-export function setupSwagger(app: INestApplication) {
-  if (process.env.NODE_ENV !== "development") {
-    setupAuthorization(app);
-  }
-  setupDocumentation(app);
-}
-
-function setupDocumentation(app: INestApplication) {
-  const options = new DocumentBuilder().setTitle("Harbor API").setVersion("1.0").build();
-
-  const document = SwaggerModule.createDocument(app, options);
-  SwaggerModule.setup("docs", app, document, {
-    swaggerOptions: {
-      tagsSorter: "alpha",
-      operationsSorter: "alpha",
-    },
-  });
-}
-
-function setupAuthorization(app: INestApplication) {
-  const configService = app.get(ConfigService);
-
-  app.use(
-    ["/docs"],
-    basicAuth({
-      challenge: true,
-      authorizeAsync: true,
-      authorizer: (email, password, authorize) => {
-        const valid =
-          !!email &&
-          !!password &&
-          email === configService.get("SWAGGER_EMAIL_SWAGGER") &&
-          password === configService.get("SWAGGER_PASSWORD_SWAGGER");
-        authorize(null, valid);
-      },
-    }),
-  );
-}

package/src/testing/command-bus.stub.ts

@@ -1,33 +0,0 @@
-import { ModuleRef } from "@nestjs/core";
-import { CommandBus, ICommand } from "@nestjs/cqrs";
-
-export class StubCommandBus extends CommandBus {
-  stubCommandData = new Map<string, unknown>();
-  executedCommand: ICommand[] = [];
-  error?: string;
-
-  constructor() {
-    super({} as ModuleRef);
-  }
-
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  override execute(command: ICommand): Promise<any> {
-    if (this.error) {throw new Error(this.error);}
-    this.executedCommand.push(command);
-    return Promise.resolve(this.stubCommandData.get(command.constructor.name));
-  }
-
-  setCommandResponse(commandType: { name: string }, commandResponse: unknown) {
-    this.stubCommandData.set(commandType.name, commandResponse);
-  }
-
-  setError(error: string) {
-    this.error = error;
-  }
-
-  clear() {
-    this.stubCommandData.clear();
-    this.executedCommand = [];
-    this.error = undefined;
-  }
-}

package/src/testing/event-bus.stub.ts

@@ -1,56 +0,0 @@
-import { IEvent, IEventBus, IEventPublisher, ObservableBus } from "@nestjs/cqrs";
-import { Observable } from "rxjs";
-
-export class StubEventBus<EventBase extends IEvent = IEvent> extends ObservableBus<EventBase> implements IEventBus<EventBase> {
-  stubEventData: Map<unknown, IEvent> = new Map();
-  error?: string;
-
-  get publisher() {
-    return this;
-  }
-
-  set publisher(_publisher: IEventPublisher<EventBase>) {}
-
-  publishAll(events: IEvent[]): unknown {
-    if (this.error) {
-      throw new Error(this.error);
-    }
-    return events.map((event) => this.stubEventData.set(event, event));
-  }
-
-  publish(event: IEvent): unknown {
-    return this.stubEventData.set(event.constructor.name, event);
-  }
-
-  getEvents() {
-    return this.stubEventData;
-  }
-
-  clear() {
-    this.stubEventData.clear();
-  }
-
-  registerSagas() {
-    return undefined;
-  }
-
-  register() {
-    return undefined;
-  }
-
-  bind() {
-    return undefined;
-  }
-
-  protected registerHandler() {
-    return undefined;
-  }
-
-  protected ofEventId(): Observable<EventBase> {
-    return new Observable();
-  }
-
-  protected registerSaga() {
-    return undefined;
-  }
-}

package/src/testing/event-publisher.stub.ts

@@ -1,24 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unsafe-assignment */
-import { AggregateRoot, Constructor, IEvent } from "@nestjs/cqrs";
-
-import { StubEventBus } from "./event-bus.stub";
-
-export class StubEventPublisher<EventBase extends IEvent = IEvent> extends StubEventBus<EventBase> {
-  mergeObjectContext<T extends AggregateRoot<EventBase>>(object: T): T {
-    Object.assign(object, {
-      publish: this.publish.bind(this),
-      publishAll: this.publishAll.bind(this),
-    });
-
-    return object;
-  }
-
-  mergeClassContext<T extends Constructor<AggregateRoot<EventBase>>>(metatype: T): T {
-    Object.assign(metatype.prototype, {
-      publish: this.publish.bind(this),
-      publishAll: this.publishAll.bind(this),
-    });
-
-    return metatype;
-  }
-}

package/src/testing/fake-logger.ts

@@ -1,20 +0,0 @@
-import { LoggerService } from "../modules/logger/logger.service";
-import { FakeTransport } from "../modules/logger/transports/fake.transport";
-
-export class FakeLogger extends LoggerService {
-  private transport: FakeTransport;
-
-  constructor() {
-    const transport = new FakeTransport();
-    super({ service: "test", transports: [transport] });
-    this.transport = transport;
-  }
-
-  get logs() {
-    return this.transport.logs;
-  }
-
-  clear() {
-    this.transport.logs = [];
-  }
-}

package/src/testing/query-bus.stub.ts

@@ -1,27 +0,0 @@
-import { IQuery } from "@nestjs/cqrs";
-
-export class StubQueryBus {
-  stubQueryData: Map<string, unknown> = new Map();
-  error?: string;
-
-  execute(query: IQuery) {
-    if (this.error) {
-      throw new Error(this.error);
-    }
-
-    return this.stubQueryData.get(query.constructor.name);
-  }
-
-  setQueryResponse(queryType: IQuery, queryResponse: unknown) {
-    this.stubQueryData.set(queryType.constructor.name, queryResponse);
-  }
-
-  setError(error: string) {
-    this.error = error;
-  }
-
-  clear() {
-    this.stubQueryData.clear();
-    this.error = undefined;
-  }
-}