@faasjs/func 4.3.0 → 4.5.0

package/README.md

@@ -19,6 +19,7 @@ npm install @faasjs/func
 
 ## Functions
 
+- [nameFunc](functions/nameFunc.md)
 - [useFunc](functions/useFunc.md)
 - [usePlugin](functions/usePlugin.md)
 

package/dist/index.d.mts

@@ -139,5 +139,25 @@ declare function usePlugin<T extends Plugin>(plugin: T & {
  * ```
  */
 declare function useFunc<TEvent = any, TContext = any, TResult = any>(handler: () => Handler<TEvent, TContext, TResult>): Func<TEvent, TContext, TResult>;
+/**
+ * Assigns a name to a given function handler, which will be displayed in logs and error messages.
+ *
+ * @template T - The type of the function handler.
+ * @param {string} name - The name to assign to the function handler.
+ * @param {T} handler - The function handler to which the name will be assigned.
+ * @returns {T} - The original function handler with the assigned name.
+ *
+ * @example
+ * ```ts
+ * import { nameFunc } from '@faasjs/func'
+ *
+ * const handler = nameFunc('myHandler', () => {
+ *  return 'Hello World'
+ * })
+ *
+ * console.log(handler.name) // => 'myHandler'
+ * ```
+ */
+declare function nameFunc<T extends (...args: any[]) => any>(name: string, handler: T): T;
 
-export { type Config, type ExportedHandler, Func, type FuncConfig, type FuncEventType, type FuncReturnType, type Handler, type InvokeData, type LifeCycleKey, type MountData, type Next, type Plugin, type UseifyPlugin, useFunc, usePlugin };
+export { type Config, type ExportedHandler, Func, type FuncConfig, type FuncEventType, type FuncReturnType, type Handler, type InvokeData, type LifeCycleKey, type MountData, type Next, type Plugin, type UseifyPlugin, nameFunc, useFunc, usePlugin };

package/dist/index.d.ts

@@ -139,5 +139,25 @@ declare function usePlugin<T extends Plugin>(plugin: T & {
  * ```
  */
 declare function useFunc<TEvent = any, TContext = any, TResult = any>(handler: () => Handler<TEvent, TContext, TResult>): Func<TEvent, TContext, TResult>;
+/**
+ * Assigns a name to a given function handler, which will be displayed in logs and error messages.
+ *
+ * @template T - The type of the function handler.
+ * @param {string} name - The name to assign to the function handler.
+ * @param {T} handler - The function handler to which the name will be assigned.
+ * @returns {T} - The original function handler with the assigned name.
+ *
+ * @example
+ * ```ts
+ * import { nameFunc } from '@faasjs/func'
+ *
+ * const handler = nameFunc('myHandler', () => {
+ *  return 'Hello World'
+ * })
+ *
+ * console.log(handler.name) // => 'myHandler'
+ * ```
+ */
+declare function nameFunc<T extends (...args: any[]) => any>(name: string, handler: T): T;
 
-export { type Config, type ExportedHandler, Func, type FuncConfig, type FuncEventType, type FuncReturnType, type Handler, type InvokeData, type LifeCycleKey, type MountData, type Next, type Plugin, type UseifyPlugin, useFunc, usePlugin };
+export { type Config, type ExportedHandler, Func, type FuncConfig, type FuncEventType, type FuncReturnType, type Handler, type InvokeData, type LifeCycleKey, type MountData, type Next, type Plugin, type UseifyPlugin, nameFunc, useFunc, usePlugin };

package/dist/index.js

@@ -26,7 +26,7 @@ var RunHandler = class {
           data.response = error;
         }
         data.runHandler = true;
-      } else data.logger.warn("[RunHandler] handler has been run");
+      } else data.logger.warn("handler has been run");
     await next();
   }
 };
@@ -81,7 +81,7 @@ var Func = class {
         let fn = list[i];
         if (i === list.length) fn = next;
         if (!fn) return Promise.resolve();
-        if (typeof fn.key === "undefined") fn.key = `UnNamedPlugin#${i}`;
+        if (typeof fn.key === "undefined") fn.key = `uname#${i}`;
         if (!data.context) data.context = /* @__PURE__ */ Object.create(null);
         if (!data.context.request_at)
           data.context.request_at = crypto.randomBytes(16).toString("hex");
@@ -120,7 +120,7 @@ var Func = class {
     }
     if (!data.config) data.config = this.config;
     data.logger.debug(
-      `Plugins: ${this.plugins.map((p) => `${p.type}#${p.name}`).join(",")}`
+      `plugins: ${this.plugins.map((p) => `${p.type}#${p.name}`).join(",")}`
     );
     await this.compose("onMount")(data);
     this.mounted = true;
@@ -150,8 +150,6 @@ var Func = class {
         context.request_at = crypto.randomBytes(16).toString("hex");
       context.callbackWaitsForEmptyEventLoop = false;
       const logger$1 = new logger.Logger(context.request_id);
-      logger$1.debug("event: %j", event);
-      logger$1.debug("context: %j", context);
       const data = {
         event,
         context,
@@ -197,7 +195,12 @@ function useFunc(handler) {
   plugins = [];
   return func;
 }
+function nameFunc(name, handler) {
+  Object.defineProperty(handler, "name", { value: name });
+  return handler;
+}
 
 exports.Func = Func;
+exports.nameFunc = nameFunc;
 exports.useFunc = useFunc;
 exports.usePlugin = usePlugin;

package/dist/index.mjs

@@ -24,7 +24,7 @@ var RunHandler = class {
           data.response = error;
         }
         data.runHandler = true;
-      } else data.logger.warn("[RunHandler] handler has been run");
+      } else data.logger.warn("handler has been run");
     await next();
   }
 };
@@ -79,7 +79,7 @@ var Func = class {
         let fn = list[i];
         if (i === list.length) fn = next;
         if (!fn) return Promise.resolve();
-        if (typeof fn.key === "undefined") fn.key = `UnNamedPlugin#${i}`;
+        if (typeof fn.key === "undefined") fn.key = `uname#${i}`;
         if (!data.context) data.context = /* @__PURE__ */ Object.create(null);
         if (!data.context.request_at)
           data.context.request_at = randomBytes(16).toString("hex");
@@ -118,7 +118,7 @@ var Func = class {
     }
     if (!data.config) data.config = this.config;
     data.logger.debug(
-      `Plugins: ${this.plugins.map((p) => `${p.type}#${p.name}`).join(",")}`
+      `plugins: ${this.plugins.map((p) => `${p.type}#${p.name}`).join(",")}`
     );
     await this.compose("onMount")(data);
     this.mounted = true;
@@ -148,8 +148,6 @@ var Func = class {
         context.request_at = randomBytes(16).toString("hex");
       context.callbackWaitsForEmptyEventLoop = false;
       const logger = new Logger(context.request_id);
-      logger.debug("event: %j", event);
-      logger.debug("context: %j", context);
       const data = {
         event,
         context,
@@ -195,5 +193,9 @@ function useFunc(handler) {
   plugins = [];
   return func;
 }
+function nameFunc(name, handler) {
+  Object.defineProperty(handler, "name", { value: name });
+  return handler;
+}
 
-export { Func, useFunc, usePlugin };
+export { Func, nameFunc, useFunc, usePlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faasjs/func",
-  "version": "4.3.0",
+  "version": "4.5.0",
   "license": "MIT",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -34,12 +34,12 @@
     "dist"
   ],
   "peerDependencies": {
-    "@faasjs/deep_merge": "4.3.0",
-    "@faasjs/logger": "4.3.0"
+    "@faasjs/deep_merge": "4.5.0",
+    "@faasjs/logger": "4.5.0"
   },
   "devDependencies": {
-    "@faasjs/deep_merge": "4.3.0",
-    "@faasjs/logger": "4.3.0"
+    "@faasjs/deep_merge": "4.5.0",
+    "@faasjs/logger": "4.5.0"
   },
   "engines": {
     "node": ">=22.0.0",