@arkyn/server 3.0.1-beta.33 → 3.0.1-beta.35

package/dist/index.d.ts

@@ -20,6 +20,6 @@ export { errorHandler } from "./services/errorHandler";
 export { formParse } from "./services/formParse";
 export { getCaller } from "./services/getCaller";
 export { getScopedParams } from "./services/getScopedParams";
-export { httpDebug } from "./services/httpDebug";
+export { httpDebug, HttpDebugService } from "./services/httpDebug";
 export { SchemaValidator } from "./services/schemaValidator";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAG9E,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAG1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAG9E,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAG1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -24,5 +24,5 @@ export { errorHandler } from "./services/errorHandler";
 export { formParse } from "./services/formParse";
 export { getCaller } from "./services/getCaller";
 export { getScopedParams } from "./services/getScopedParams";
-export { httpDebug } from "./services/httpDebug";
+export { httpDebug, HttpDebugService } from "./services/httpDebug";
 export { SchemaValidator } from "./services/schemaValidator";

package/dist/services/getCaller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getCaller.d.ts","sourceRoot":"","sources":["../../src/services/getCaller.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,iBAAS,SAAS;;;EAkEjB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"getCaller.d.ts","sourceRoot":"","sources":["../../src/services/getCaller.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH,iBAAS,SAAS;;;EA+DjB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/services/getCaller.js

@@ -1,4 +1,5 @@
 import path from "path";
+import { HttpDebugService } from "./httpDebug";
 /**
  * Retrieves information about the caller of the current function.
  *
@@ -15,51 +16,45 @@ function getCaller() {
     const err = new Error();
     const stack = err.stack || "";
     const stackLines = stack.split("\n").map((line) => line.trim());
-    // The first line is the error message
-    // The second line is this function (getCaller)
-    // The third line should be the direct caller
-    // We start from 2 because indexes are zero-based
+    const ignoreFile = HttpDebugService.ignoreFile;
     let callerIndex = 2;
-    // Ignore internal or infrastructure lines if necessary
     while (callerIndex < stackLines.length &&
         (stackLines[callerIndex].includes("node:internal") ||
             stackLines[callerIndex].includes("/node_modules/"))) {
         callerIndex++;
     }
+    if (ignoreFile) {
+        while (callerIndex < stackLines.length &&
+            stackLines[callerIndex].includes(ignoreFile)) {
+            callerIndex++;
+        }
+    }
     const callerLine = stackLines[callerIndex] || "";
     let functionName = "Unknown function";
     let callerInfo = "Unknown caller";
-    // Default for named functions: "at functionName (file:line:column)"
     const namedFunctionMatch = callerLine.match(/at\s+([^(\s]+)\s+\(([^)]+)\)/);
     if (namedFunctionMatch) {
         functionName = namedFunctionMatch[1];
         callerInfo = namedFunctionMatch[2];
     }
-    // Default for anonymous functions or methods: "at file:line:column"
     else {
         const anonymousFunctionMatch = callerLine.match(/at\s+(.+)/);
         if (anonymousFunctionMatch) {
             callerInfo = anonymousFunctionMatch[1];
-            // Tenta extrair nome da função de padrões como Object.method ou Class.method
             const objectMethodMatch = callerInfo.match(/at\s+([^(\s]+)\s+/);
             if (objectMethodMatch && objectMethodMatch[1] !== "new") {
                 functionName = objectMethodMatch[1];
             }
         }
     }
-    // Handles file paths
     if (callerInfo.includes("(")) {
         callerInfo = callerInfo.substring(callerInfo.indexOf("(") + 1, callerInfo.lastIndexOf(")"));
     }
-    // Remove the line:column part of the file path
     callerInfo = callerInfo.split(":").slice(0, -2).join(":");
-    // Make the path relative to the project
     try {
         callerInfo = path.relative(projectRoot, callerInfo);
     }
-    catch (e) {
-        // If it fails to relativize, use the original path
-    }
+    catch (e) { }
     return { functionName, callerInfo };
 }
 export { getCaller };

package/dist/services/httpDebug.d.ts

@@ -1,3 +1,42 @@
+/**
+ * Service for managing HTTP debug configuration and behavior.
+ *
+ * This service provides functionality to configure how the `getCaller` function
+ * identifies the actual caller in the stack trace by allowing specific files
+ * to be ignored during stack trace analysis.
+ *
+ * @example
+ * ```typescript
+ * // Configure to ignore httpAdapter.ts in stack traces
+ * HttpDebugService.setIgnoreFile("httpAdapter.ts");
+ *
+ * // Now when httpDebug is called from within httpAdapter.ts,
+ * // it will show the actual caller (e.g., cart.ts) instead
+ * ```
+ */
+declare class HttpDebugService {
+    /**
+     * The name of the file to ignore when analyzing the stack trace.
+     * When set, the `getCaller` function will skip stack frames containing this file name.
+     */
+    static ignoreFile?: string;
+    /**
+     * Sets the file name to be ignored during stack trace analysis.
+     *
+     * This method configures the debug service to skip specific files when
+     * determining the actual caller of a function. This is useful when you have
+     * adapter or wrapper functions that you want to be transparent in the debug output.
+     *
+     * @param file - The name of the file to ignore in stack traces (e.g., "httpAdapter.ts")
+     *
+     * @example
+     * ```typescript
+     * // Ignore the HTTP adapter file so debug shows the actual business logic caller
+     * HttpDebugService.setIgnoreFile("httpAdapter.ts");
+     * ```
+     */
+    static setIgnoreFile(file: string): void;
+}
 /**
  * Logs debug information to the console when in development mode or when the
  * `SHOW_ERRORS_IN_CONSOLE` environment variable is set to "true".
@@ -31,5 +70,5 @@
  * ```
  */
 declare function httpDebug(name: string, body: any, cause?: any): void;
-export { httpDebug };
+export { httpDebug, HttpDebugService };
 //# sourceMappingURL=httpDebug.d.ts.map

package/dist/services/httpDebug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"httpDebug.d.ts","sourceRoot":"","sources":["../../src/services/httpDebug.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,QAuBtD;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"httpDebug.d.ts","sourceRoot":"","sources":["../../src/services/httpDebug.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,cAAM,gBAAgB;IACpB;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM;CAGlC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,QAuBtD;AAED,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/services/httpDebug.js

@@ -1,4 +1,45 @@
 import { getCaller } from "../services/getCaller";
+/**
+ * Service for managing HTTP debug configuration and behavior.
+ *
+ * This service provides functionality to configure how the `getCaller` function
+ * identifies the actual caller in the stack trace by allowing specific files
+ * to be ignored during stack trace analysis.
+ *
+ * @example
+ * ```typescript
+ * // Configure to ignore httpAdapter.ts in stack traces
+ * HttpDebugService.setIgnoreFile("httpAdapter.ts");
+ *
+ * // Now when httpDebug is called from within httpAdapter.ts,
+ * // it will show the actual caller (e.g., cart.ts) instead
+ * ```
+ */
+class HttpDebugService {
+    /**
+     * The name of the file to ignore when analyzing the stack trace.
+     * When set, the `getCaller` function will skip stack frames containing this file name.
+     */
+    static ignoreFile;
+    /**
+     * Sets the file name to be ignored during stack trace analysis.
+     *
+     * This method configures the debug service to skip specific files when
+     * determining the actual caller of a function. This is useful when you have
+     * adapter or wrapper functions that you want to be transparent in the debug output.
+     *
+     * @param file - The name of the file to ignore in stack traces (e.g., "httpAdapter.ts")
+     *
+     * @example
+     * ```typescript
+     * // Ignore the HTTP adapter file so debug shows the actual business logic caller
+     * HttpDebugService.setIgnoreFile("httpAdapter.ts");
+     * ```
+     */
+    static setIgnoreFile(file) {
+        this.ignoreFile = file;
+    }
+}
 /**
  * Logs debug information to the console when in development mode or when the
  * `SHOW_ERRORS_IN_CONSOLE` environment variable is set to "true".
@@ -49,4 +90,4 @@ function httpDebug(name, body, cause) {
         console.log(consoleData);
     }
 }
-export { httpDebug };
+export { httpDebug, HttpDebugService };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkyn/server",
-  "version": "3.0.1-beta.33",
+  "version": "3.0.1-beta.35",
   "author": "Arkyn | Lucas Gonçalves",
   "main": "./dist/index.js",
   "module": "./src/index.ts",

package/src/index.ts

@@ -27,5 +27,5 @@ export { errorHandler } from "./services/errorHandler";
 export { formParse } from "./services/formParse";
 export { getCaller } from "./services/getCaller";
 export { getScopedParams } from "./services/getScopedParams";
-export { httpDebug } from "./services/httpDebug";
+export { httpDebug, HttpDebugService } from "./services/httpDebug";
 export { SchemaValidator } from "./services/schemaValidator";

package/src/services/getCaller.ts

@@ -1,4 +1,5 @@
 import path from "path";
+import { HttpDebugService } from "./httpDebug";
 
 /**
  * Retrieves information about the caller of the current function.
@@ -11,6 +12,7 @@ import path from "path";
  * - `functionName`: The name of the function that called the current function, or "Unknown function" if it cannot be determined.
  * - `callerInfo`: The file path of the caller relative to the project root, or "Unknown caller" if it cannot be determined.
  */
+
 function getCaller() {
   const projectRoot = process.cwd();
 
@@ -18,13 +20,10 @@ function getCaller() {
   const stack = err.stack || "";
   const stackLines = stack.split("\n").map((line) => line.trim());
 
-  // The first line is the error message
-  // The second line is this function (getCaller)
-  // The third line should be the direct caller
-  // We start from 2 because indexes are zero-based
+  const ignoreFile = HttpDebugService.ignoreFile;
+
   let callerIndex = 2;
 
-  // Ignore internal or infrastructure lines if necessary
   while (
     callerIndex < stackLines.length &&
     (stackLines[callerIndex].includes("node:internal") ||
@@ -33,24 +32,29 @@ function getCaller() {
     callerIndex++;
   }
 
+  if (ignoreFile) {
+    while (
+      callerIndex < stackLines.length &&
+      stackLines[callerIndex].includes(ignoreFile)
+    ) {
+      callerIndex++;
+    }
+  }
+
   const callerLine = stackLines[callerIndex] || "";
 
   let functionName = "Unknown function";
   let callerInfo = "Unknown caller";
 
-  // Default for named functions: "at functionName (file:line:column)"
   const namedFunctionMatch = callerLine.match(/at\s+([^(\s]+)\s+\(([^)]+)\)/);
   if (namedFunctionMatch) {
     functionName = namedFunctionMatch[1];
     callerInfo = namedFunctionMatch[2];
-  }
-  // Default for anonymous functions or methods: "at file:line:column"
-  else {
+  } else {
     const anonymousFunctionMatch = callerLine.match(/at\s+(.+)/);
     if (anonymousFunctionMatch) {
       callerInfo = anonymousFunctionMatch[1];
 
-      // Tenta extrair nome da função de padrões como Object.method ou Class.method
       const objectMethodMatch = callerInfo.match(/at\s+([^(\s]+)\s+/);
       if (objectMethodMatch && objectMethodMatch[1] !== "new") {
         functionName = objectMethodMatch[1];
@@ -58,7 +62,6 @@ function getCaller() {
     }
   }
 
-  // Handles file paths
   if (callerInfo.includes("(")) {
     callerInfo = callerInfo.substring(
       callerInfo.indexOf("(") + 1,
@@ -66,15 +69,11 @@ function getCaller() {
     );
   }
 
-  // Remove the line:column part of the file path
   callerInfo = callerInfo.split(":").slice(0, -2).join(":");
 
-  // Make the path relative to the project
   try {
     callerInfo = path.relative(projectRoot, callerInfo);
-  } catch (e) {
-    // If it fails to relativize, use the original path
-  }
+  } catch (e) {}
 
   return { functionName, callerInfo };
 }

package/src/services/httpDebug.ts

@@ -1,5 +1,48 @@
 import { getCaller } from "../services/getCaller";
 
+/**
+ * Service for managing HTTP debug configuration and behavior.
+ *
+ * This service provides functionality to configure how the `getCaller` function
+ * identifies the actual caller in the stack trace by allowing specific files
+ * to be ignored during stack trace analysis.
+ *
+ * @example
+ * ```typescript
+ * // Configure to ignore httpAdapter.ts in stack traces
+ * HttpDebugService.setIgnoreFile("httpAdapter.ts");
+ *
+ * // Now when httpDebug is called from within httpAdapter.ts,
+ * // it will show the actual caller (e.g., cart.ts) instead
+ * ```
+ */
+class HttpDebugService {
+  /**
+   * The name of the file to ignore when analyzing the stack trace.
+   * When set, the `getCaller` function will skip stack frames containing this file name.
+   */
+  static ignoreFile?: string;
+
+  /**
+   * Sets the file name to be ignored during stack trace analysis.
+   *
+   * This method configures the debug service to skip specific files when
+   * determining the actual caller of a function. This is useful when you have
+   * adapter or wrapper functions that you want to be transparent in the debug output.
+   *
+   * @param file - The name of the file to ignore in stack traces (e.g., "httpAdapter.ts")
+   *
+   * @example
+   * ```typescript
+   * // Ignore the HTTP adapter file so debug shows the actual business logic caller
+   * HttpDebugService.setIgnoreFile("httpAdapter.ts");
+   * ```
+   */
+  static setIgnoreFile(file: string) {
+    this.ignoreFile = file;
+  }
+}
+
 /**
  * Logs debug information to the console when in development mode or when the
  * `SHOW_ERRORS_IN_CONSOLE` environment variable is set to "true".
@@ -58,4 +101,4 @@ function httpDebug(name: string, body: any, cause?: any) {
   }
 }
 
-export { httpDebug };
+export { httpDebug, HttpDebugService };