nestjs-log-decorator 1.1.0 → 1.3.0

package/dist/index.cjs

@@ -438,5 +438,14 @@ const NoLog = () => {
 
 //#endregion
 exports.Log = Log;
+exports.LogWrapper = LogWrapper;
+exports.NO_LOG_METADATA_KEY = NO_LOG_METADATA_KEY;
 exports.NoLog = NoLog;
-exports.isLoggable = isLoggable;
+exports.applyToClass = applyToClass;
+exports.applyToMethod = applyToMethod;
+exports.buildArgsObject = buildArgsObject;
+exports.createLogWrapper = createLogWrapper;
+exports.getParameterNames = getParameterNames;
+exports.handleAsyncExecution = handleAsyncExecution;
+exports.isLoggable = isLoggable;
+exports.prettifyAxiosError = prettifyAxiosError;

package/dist/index.d.cts

@@ -29,14 +29,53 @@ interface LogOptions<TArgs extends unknown[] = unknown[]> {
    */
   args?: LogArgsFormatter<TArgs>;
 }
+/**
+ * Symbol used to mark methods that should not be logged
+ * @internal
+ */
+declare const NO_LOG_METADATA_KEY: unique symbol;
 //#endregion
 //#region src/LogWrapper.d.ts
-
+/**
+ * Wrapper class for logging operations with consistent format.
+ * @internal
+ */
+declare class LogWrapper {
+  private readonly logger;
+  private readonly method;
+  private readonly args;
+  constructor(logger: Logger, method: string, args: string | number | Record<string, unknown> | undefined);
+  invoked(): void;
+  success(): void;
+  error(error: unknown): void;
+}
 /** If you see it, then you probably forgot to add `readonly logger = new Logger(YourClass.name)` to your class */
 interface Loggable {
   logger: Logger;
 }
 declare const isLoggable: (instance: unknown) => instance is Loggable;
+/**
+ * Creates a LogWrapper instance with validated logger and built args object.
+ * @internal
+ */
+declare const createLogWrapper: (instance: unknown, className: string, methodName: string, argsObject: string | number | Record<string, unknown> | undefined) => LogWrapper;
+/**
+ * Builds an object mapping parameter names to their values.
+ *
+ * Creates a record where keys are parameter names and values are the
+ * corresponding argument values passed to the function.
+ *
+ * @param parameterNames - Array of parameter names
+ * @param args - Array of argument values
+ * @returns Object mapping parameter names to values
+ *
+ * @example
+ * buildArgsObject(['id', 'name'], [1, 'John'])
+ * // Returns: { id: 1, name: 'John' }
+ *
+ * @internal
+ */
+declare const buildArgsObject: (parameterNames: string[], args: unknown[]) => Record<string, unknown> | undefined;
 //#endregion
 //#region src/log.decorator.d.ts
 type LoggableConstructor = new (...args: any[]) => Loggable;
@@ -250,4 +289,49 @@ declare const Log: <TArgs extends unknown[]>(options?: LogOptions<TArgs>) => Log
  */
 declare const NoLog: () => (_target: unknown, _propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 //#endregion
-export { Log, type LogArgsFormatter, type LogOptions, type Loggable, NoLog, isLoggable };
+//#region src/axios/axios.logger.d.ts
+declare function prettifyAxiosError(error: unknown): unknown;
+//#endregion
+//#region src/decorate/applyToMethod.d.ts
+type MethodFunction = (...args: unknown[]) => unknown;
+/**
+ * Applies logging to a single method.
+ * @internal
+ */
+declare const applyToMethod: (target: object, propertyKey: string, descriptor: PropertyDescriptor, {
+  onInvoke: shouldLogInvoke,
+  args: formatArgs
+}?: LogOptions) => PropertyDescriptor;
+/**
+ * Extracts parameter names from a function signature.
+ *
+ * This function parses the function's string representation to extract
+ * parameter names, handling TypeScript type annotations and default values.
+ *
+ * @param func - The function to extract parameter names from
+ * @returns Array of parameter names
+ *
+ * @example
+ * function example(id: number, name: string = 'default') {}
+ * getParameterNames(example) // Returns: ['id', 'name']
+ *
+ * @internal
+ */
+declare const getParameterNames: (func: MethodFunction) => string[];
+/**
+ * Handles execution of async methods with proper logging.
+ * @internal
+ */
+declare const handleAsyncExecution: (result: Promise<unknown>, logWrapper: LogWrapper) => Promise<unknown>;
+//#endregion
+//#region src/decorate/applyToClass.d.ts
+interface Constructor {
+  prototype: Record<string, unknown>;
+}
+/**
+ * Applies logging to all methods in a class.
+ * @internal
+ */
+declare const applyToClass: (target: Constructor, options: LogOptions) => void;
+//#endregion
+export { Log, LogArgsFormatter, LogOptions, LogWrapper, Loggable, NO_LOG_METADATA_KEY, NoLog, applyToClass, applyToMethod, buildArgsObject, createLogWrapper, getParameterNames, handleAsyncExecution, isLoggable, prettifyAxiosError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestjs-log-decorator",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Decorator that removes try catch boilerplate logging from NestJS service methods",
   "author": "Vlad Goncharov <leovs010@gmail.com>",
   "license": "AGPL-3.0",