@restura/logger 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { ResturaLogger } from '@restura/core';
+export { ResturaLogger } from '@restura/core';
+import { SerializerFn, Level, TransportTargetOptions, DestinationStream } from 'pino';
+
+type ErrorSerializerFactory = (baseSerializer: SerializerFn) => SerializerFn;
+interface LoggerConfig {
+    level?: Level;
+    transports?: TransportTargetOptions[];
+    serializers?: {
+        err?: ErrorSerializerFactory;
+    };
+    stream?: DestinationStream;
+}
+
+declare function createLogger(config?: LoggerConfig): ResturaLogger;
+
+export { type ErrorSerializerFactory, type LoggerConfig, createLogger };

package/dist/index.js

@@ -0,0 +1,91 @@
+// src/createLogger.ts
+import { RsError } from "@restura/core";
+import pino from "pino";
+import pinoPretty from "pino-pretty";
+function buildDefaultStream() {
+  return pinoPretty({
+    colorize: true,
+    translateTime: "yyyy-mm-dd HH:MM:ss.l",
+    ignore: "pid,hostname,_meta",
+    messageFormat: "{msg}",
+    levelFirst: true,
+    customColors: "error:red,warn:yellow,info:green,debug:blue,trace:magenta",
+    destination: process.stdout
+  });
+}
+function buildErrorSerializer(loggerConfig) {
+  const baseSerializer = pino.stdSerializers.err;
+  const defaultSerializer = (error) => {
+    const isAxiosError = error !== null && typeof error === "object" && "isAxiosError" in error && error.isAxiosError === true;
+    if (isAxiosError) {
+      const err = error;
+      return {
+        type: "AxiosError",
+        message: err.message,
+        stack: err.stack,
+        url: err.config?.url,
+        method: err.config?.method?.toUpperCase(),
+        status: err.response?.status,
+        responseData: err.response?.data
+      };
+    }
+    if (RsError.isRsError(error)) return error.toJSON();
+    return baseSerializer(error);
+  };
+  if (!loggerConfig?.serializers?.err) return defaultSerializer;
+  try {
+    return loggerConfig.serializers.err(baseSerializer);
+  } catch (err) {
+    console.error("Failed to initialize custom error serializer, falling back to default", err);
+    return defaultSerializer;
+  }
+}
+function buildPinoInstance(loggerConfig, level) {
+  const options = { level, serializers: { err: buildErrorSerializer(loggerConfig) } };
+  if (loggerConfig?.transports) {
+    options.transport = { targets: loggerConfig.transports };
+    return pino(options);
+  }
+  return pino(options, loggerConfig?.stream ?? buildDefaultStream());
+}
+function buildContext(args) {
+  const ctx = {};
+  const primitives = [];
+  for (const arg of args) {
+    if (arg instanceof Error && !ctx.err) {
+      ctx.err = arg;
+    } else if (arg && typeof arg === "object" && !Array.isArray(arg)) {
+      Object.assign(ctx, arg);
+    } else {
+      primitives.push(arg);
+    }
+  }
+  if (primitives.length) ctx.args = primitives;
+  return ctx;
+}
+function log(pinoInstance, level, msg, ...args) {
+  if (typeof msg === "string") {
+    pinoInstance[level](buildContext(args), msg);
+  } else {
+    pinoInstance[level](buildContext([msg, ...args]));
+  }
+}
+function createLogger(config) {
+  const VALID_LEVELS = ["fatal", "error", "warn", "info", "debug", "trace"];
+  const envLevel = process.env.RESTURA_LOG_LEVEL;
+  const level = config?.level ?? (VALID_LEVELS.includes(envLevel) ? envLevel : "info");
+  const pinoInstance = buildPinoInstance(config, level);
+  return {
+    level: pinoInstance.level,
+    fatal: (msg, ...args) => log(pinoInstance, "fatal", msg, ...args),
+    error: (msg, ...args) => log(pinoInstance, "error", msg, ...args),
+    warn: (msg, ...args) => log(pinoInstance, "warn", msg, ...args),
+    info: (msg, ...args) => log(pinoInstance, "info", msg, ...args),
+    debug: (msg, ...args) => log(pinoInstance, "debug", msg, ...args),
+    trace: (msg, ...args) => log(pinoInstance, "trace", msg, ...args)
+  };
+}
+export {
+  createLogger
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/createLogger.ts"],"sourcesContent":["import { RsError, type LogLevel, type ResturaLogger } from '@restura/core';\nimport pino from 'pino';\nimport pinoPretty from 'pino-pretty';\nimport type { LoggerConfig } from './loggerConfigSchema.js';\n\nfunction buildDefaultStream() {\n\treturn pinoPretty({\n\t\tcolorize: true,\n\t\ttranslateTime: 'yyyy-mm-dd HH:MM:ss.l',\n\t\tignore: 'pid,hostname,_meta',\n\t\tmessageFormat: '{msg}',\n\t\tlevelFirst: true,\n\t\tcustomColors: 'error:red,warn:yellow,info:green,debug:blue,trace:magenta',\n\t\tdestination: process.stdout\n\t});\n}\n\nfunction buildErrorSerializer(loggerConfig?: LoggerConfig) {\n\tconst baseSerializer = pino.stdSerializers.err;\n\n\tconst defaultSerializer = (error: unknown) => {\n\t\tconst isAxiosError =\n\t\t\terror !== null &&\n\t\t\ttypeof error === 'object' &&\n\t\t\t'isAxiosError' in error &&\n\t\t\t(error as { isAxiosError: unknown }).isAxiosError === true;\n\n\t\tif (isAxiosError) {\n\t\t\tconst err = error as unknown as {\n\t\t\t\tmessage: string;\n\t\t\t\tstack: string;\n\t\t\t\tconfig: { url: string; method: string };\n\t\t\t\tresponse: { status: number; data: unknown };\n\t\t\t};\n\t\t\treturn {\n\t\t\t\ttype: 'AxiosError',\n\t\t\t\tmessage: err.message,\n\t\t\t\tstack: err.stack,\n\t\t\t\turl: err.config?.url,\n\t\t\t\tmethod: err.config?.method?.toUpperCase(),\n\t\t\t\tstatus: err.response?.status,\n\t\t\t\tresponseData: err.response?.data\n\t\t\t};\n\t\t}\n\n\t\tif (RsError.isRsError(error)) return error.toJSON();\n\t\treturn baseSerializer(error as Error);\n\t};\n\n\tif (!loggerConfig?.serializers?.err) return defaultSerializer;\n\n\ttry {\n\t\treturn loggerConfig.serializers.err(baseSerializer);\n\t} catch (err) {\n\t\tconsole.error('Failed to initialize custom error serializer, falling back to default', err);\n\t\treturn defaultSerializer;\n\t}\n}\n\nfunction buildPinoInstance(loggerConfig: LoggerConfig | undefined, level: string): pino.Logger {\n\tconst options: pino.LoggerOptions = { level, serializers: { err: buildErrorSerializer(loggerConfig) } };\n\n\tif (loggerConfig?.transports) {\n\t\toptions.transport = { targets: loggerConfig.transports };\n\t\treturn pino(options);\n\t}\n\n\treturn pino(options, loggerConfig?.stream ?? buildDefaultStream());\n}\n\nfunction buildContext(args: unknown[]) {\n\tconst ctx: Record<string, unknown> = {};\n\tconst primitives: unknown[] = [];\n\n\tfor (const arg of args) {\n\t\tif (arg instanceof Error && !ctx.err) {\n\t\t\tctx.err = arg;\n\t\t} else if (arg && typeof arg === 'object' && !Array.isArray(arg)) {\n\t\t\tObject.assign(ctx, arg as object);\n\t\t} else {\n\t\t\tprimitives.push(arg);\n\t\t}\n\t}\n\n\tif (primitives.length) ctx.args = primitives;\n\treturn ctx;\n}\n\nfunction log(pinoInstance: pino.Logger, level: pino.Level, msg: string | unknown, ...args: unknown[]) {\n\tif (typeof msg === 'string') {\n\t\tpinoInstance[level](buildContext(args), msg);\n\t} else {\n\t\tpinoInstance[level](buildContext([msg, ...args]));\n\t}\n}\n\nexport function createLogger(config?: LoggerConfig): ResturaLogger {\n\tconst VALID_LEVELS: LogLevel[] = ['fatal', 'error', 'warn', 'info', 'debug', 'trace'];\n\tconst envLevel = process.env.RESTURA_LOG_LEVEL;\n\tconst level = config?.level ?? (VALID_LEVELS.includes(envLevel as LogLevel) ? (envLevel as LogLevel) : 'info');\n\tconst pinoInstance = buildPinoInstance(config, level);\n\n\treturn {\n\t\tlevel: pinoInstance.level as LogLevel,\n\t\tfatal: (msg: unknown, ...args: unknown[]) => log(pinoInstance, 'fatal', msg, ...args),\n\t\terror: (msg: unknown, ...args: unknown[]) => log(pinoInstance, 'error', msg, ...args),\n\t\twarn: (msg: unknown, ...args: unknown[]) => log(pinoInstance, 'warn', msg, ...args),\n\t\tinfo: (msg: unknown, ...args: unknown[]) => log(pinoInstance, 'info', msg, ...args),\n\t\tdebug: (msg: unknown, ...args: unknown[]) => log(pinoInstance, 'debug', msg, ...args),\n\t\ttrace: (msg: unknown, ...args: unknown[]) => log(pinoInstance, 'trace', msg, ...args)\n\t};\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@restura/logger",
+  "version": "1.0.1",
+  "description": "Pino-based logger implementation for Restura",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "repository": "https://github.com/redsky-engineering/restura",
+  "author": "Joshua Hintze",
+  "license": "MIT",
+  "files": [
+    "dist/**"
+  ],
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "keywords": [
+    "restura",
+    "restura logger",
+    "pino",
+    "low code api"
+  ],
+  "dependencies": {
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "@restura/core": "2.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "mocha": {
+    "enable-source-maps": true,
+    "node-option": [
+      "import=tsx"
+    ]
+  },
+  "scripts": {
+    "test": "mocha 'src/**/*.test.ts'",
+    "build": "tsup ./src/index.ts",
+    "lint": "eslint src"
+  }
+}