chore(packages): create the logger package

.eslintignore

@@ -1,10 +1,10 @@
 build
 .eslintrc.js
 jest.config.js
-app/graphql/types
 module.d.ts
 dist
 .next
 .turbo
 coverage
 env.d.ts
+**/*.d.ts

packages/logger/.eslintrc.js

@@ -0,0 +1,4 @@
+module.exports = {
+ "rules": {},
+ ignorePatterns: ["jest.config.js", "dist"]
+}

packages/logger/.gitignore

@@ -0,0 +1,2 @@
+node_modules
+dist

packages/logger/index.ts

@@ -0,0 +1,7 @@
+import BaseLogger from './src/base-logger';
+import FileLogger from './src/file-logger';
+
+const baseLogger = new BaseLogger();
+const fileLogger = new FileLogger();
+
+export { baseLogger, fileLogger };

packages/logger/jest.config.js

@@ -0,0 +1,11 @@
+module.exports = {
+ roots: ['.'],
+ preset: 'ts-jest',
+ testMatch: ['**/?(*.)+(spec|test).[jt]s'],
+ testEnvironment: 'node',
+ clearMocks: true,
+ maxWorkers: 1,
+ snapshotFormat: {
+ "printBasicPrototype": false
+ }
+};

packages/logger/package.json

@@ -0,0 +1,27 @@
+{
+ "name": "@sharingan/logger",
+ "version": "1.0.0",
+ "description": "Sharingan logger",
+ "main": "dist/index.js",
+ "types": "dist/index.d.ts",
+ "license": "MIT",
+ "scripts": {
+ "build": "tsc --project tsconfig.prod.json",
+ "clean": "rm -rf .turbo dist",
+ "lint": "eslint src index.ts",
+ "test": "jest"
+ },
+ "dependencies": {
+ "@sentry/node": "^6.19.2",
+ "@sentry/tracing": "^6.19.2",
+ "winston": "^3.6.0",
+ "winston-daily-rotate-file": "^4.6.1"
+ },
+ "devDependencies": {
+ "@types/jest": "^27.4.1",
+ "@types/lodash": "^4.14.180",
+ "jest": "^27.5.1",
+ "ts-jest": "^27.1.3",
+ "typescript": "^4.6.2"
+ }
+}

packages/logger/src/base-logger.ts

@@ -0,0 +1,67 @@
+import { createLogger, format, Logger, transports } from 'winston';
+import { isObject } from 'lodash';
+import * as Sentry from '@sentry/node';
+import { LoggerInitOptions } from './types';
+
+const { combine, printf, timestamp }: typeof format = format;
+
+class BaseLogger {
+ protected logger: Logger = createLogger();
+ protected canLogToSentry = false;
+
+ init(options: LoggerInitOptions): void {
+ this.canLogToSentry = Boolean(options.logToSentry) && Boolean(options.sentryDsn);
+
+ this.initSentryIfNecessary();
+
+ this.logger = createLogger({
+ format: combine(timestamp(), this.customFormat()),
+ silent: Boolean(options.silent),
+ transports: [new transports.Console()],
+ });
+ }
+
+ error(error: unknown): void {
+ this.logger.error(this.logMessage(error));
+
+ if (this.canLogToSentry) {
+ this.logErrorToSentry(error);
+ }
+ }
+
+ info(output: unknown): void {
+ this.logger.info(this.logMessage(output));
+ }
+
+ private initSentryIfNecessary(sentryDsn?: string) {
+ if (!this.canLogToSentry || !sentryDsn) {
+ return;
+ }
+
+ Sentry.init({
+ dsn: sentryDsn,
+ // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
+ // We recommend adjusting this value in production
+ tracesSampleRate: 1.0,
+ });
+ }
+
+ private logErrorToSentry(e: any) {
+ Sentry.captureException(e);
+ }
+
+ private logMessage(message: any): string {
+ // @ts-ignore
+ return isObject(message) ? (message.stack ? message.stack : JSON.stringify(message, null, 2)) : message.toString();
+ }
+
+ private customFormat() {
+ return printf((info) => {
+ const { level, message, timestamp } = info;
+
+ return `${timestamp} ${level}: ${this.logMessage(message)}`;
+ });
+ }
+}
+
+export default BaseLogger;

packages/logger/src/file-logger.ts

@@ -0,0 +1,27 @@
+import fs from 'fs';
+import WinstonFileRotation from 'winston-daily-rotate-file';
+import { FileLoggerInitOptions } from './types';
+import BaseLogger from './base-logger';
+
+class FileLogger extends BaseLogger {
+ public init(options: FileLoggerInitOptions) {
+ super.init(options);
+
+ if (!fs.existsSync(options.logFileDirectory)) {
+ fs.mkdirSync(options.logFileDirectory);
+ }
+
+ const transport = new WinstonFileRotation({
+ datePattern: 'YYYY-MM-DD',
+ dirname: options.logFileDirectory,
+ filename: `${options.appName}-%DATE%.log`,
+ maxFiles: '14d',
+ maxSize: '20m',
+ zippedArchive: true,
+ });
+
+ this.logger.add(transport);
+ }
+}
+
+export default FileLogger;

packages/logger/src/types.ts

@@ -0,0 +1,15 @@
+export type EnhancedLogger = {
+ error: (output: unknown, logToSentry?: boolean) => void;
+ info: (output: unknown) => void;
+};
+
+export type LoggerInitOptions = {
+ logToSentry?: boolean;
+ sentryDsn?: string;
+ silent?: boolean;
+};
+
+export type FileLoggerInitOptions = LoggerInitOptions & {
+ appName: string;
+ logFileDirectory: string;
+};

packages/logger/tsconfig.json

@@ -0,0 +1,16 @@
+{
+ "extends": "../../tsconfig.base.json",
+ "compilerOptions": {
+ "target": "es5",
+ "module": "commonjs",
+ "lib": ["dom"],
+ "outDir": "./dist",
+ "declaration": true,
+ "composite": true,
+ "sourceMap": true,
+ },
+ "include": ["./src/**/*", "./tests/**/*", "index.ts"],
+ "exclude": [
+ "node_modules"
+ ]
+}

packages/logger/tsconfig.prod.json

@@ -0,0 +1,7 @@
+{
+ "extends": "./tsconfig",
+ "compilerOptions": {
+ "sourceMap": false
+ },
+ "exclude": ["tests"]
+}