@faasjs/load 7.0.3 → 7.1.0

package/README.md

@@ -15,6 +15,7 @@ npm install @faasjs/load
 
 - [detectNodeRuntime](functions/detectNodeRuntime.md)
 - [loadConfig](functions/loadConfig.md)
+- [loadFunc](functions/loadFunc.md)
 - [loadPackage](functions/loadPackage.md)
 - [resetRuntime](functions/resetRuntime.md)
 

package/dist/index.cjs

@@ -111,7 +111,15 @@ async function loadPackage(name, defaultNames = "default") {
   throw Error("Unknown runtime");
 }
 
+// src/load_func.ts
+async function loadFunc(root, filename, staging) {
+  const func = await loadPackage(filename);
+  func.config = await loadConfig(root, filename, staging);
+  return func.export().handler;
+}
+
 exports.detectNodeRuntime = detectNodeRuntime;
 exports.loadConfig = loadConfig;
+exports.loadFunc = loadFunc;
 exports.loadPackage = loadPackage;
 exports.resetRuntime = resetRuntime;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Config } from '@faasjs/func';
+import { Config, ExportedHandler } from '@faasjs/func';
 import { Logger } from '@faasjs/logger';
 
 /**
@@ -6,6 +6,31 @@ import { Logger } from '@faasjs/logger';
  */
 declare function loadConfig(root: string, filename: string, staging: string, logger?: Logger): Config;
 
+/**
+ * Load a FaasJS function and its configuration, returning the handler.
+ *
+ * @param root - Project root directory used to resolve configuration
+ * @param filename - Path to the packaged FaasJS function file to load
+ * @param staging - Staging directory name (used when locating config)
+ *
+ * @returns A Promise that resolves to the function handler
+ *
+ * @example
+ * ```ts
+ * import { loadFunc } from '@faasjs/load'
+ *
+ * const handler = await loadFunc(
+ *   process.cwd(),
+ *   __dirname + '/example.func.ts',
+ *   'development'
+ * )
+ *
+ * const result = await handler(event, context)
+ * console.log(result)
+ * ```
+ */
+declare function loadFunc<TEvent = any, TContext = any, TResult = any>(root: string, filename: string, staging: string): Promise<ExportedHandler<TEvent, TContext, TResult>>;
+
 type NodeRuntime = 'commonjs' | 'module';
 declare function resetRuntime(): void;
 /**
@@ -36,4 +61,4 @@ declare function detectNodeRuntime(): NodeRuntime;
  */
 declare function loadPackage<T = unknown>(name: string, defaultNames?: string | string[]): Promise<T>;
 
-export { type NodeRuntime, detectNodeRuntime, loadConfig, loadPackage, resetRuntime };
+export { type NodeRuntime, detectNodeRuntime, loadConfig, loadFunc, loadPackage, resetRuntime };

package/dist/index.mjs

@@ -108,4 +108,11 @@ async function loadPackage(name, defaultNames = "default") {
   throw Error("Unknown runtime");
 }
 
-export { detectNodeRuntime, loadConfig, loadPackage, resetRuntime };
+// src/load_func.ts
+async function loadFunc(root, filename, staging) {
+  const func = await loadPackage(filename);
+  func.config = await loadConfig(root, filename, staging);
+  return func.export().handler;
+}
+
+export { detectNodeRuntime, loadConfig, loadFunc, loadPackage, resetRuntime };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faasjs/load",
-  "version": "7.0.3",
+  "version": "7.1.0",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.cjs",
@@ -32,15 +32,15 @@
   "peerDependencies": {
     "js-yaml": "*",
     "tsx": "*",
-    "@faasjs/deep_merge": ">=7.0.3",
-    "@faasjs/func": ">=7.0.3"
+    "@faasjs/deep_merge": ">=7.1.0",
+    "@faasjs/func": ">=7.1.0"
   },
   "devDependencies": {
     "js-yaml": "*",
     "tsx": "*",
     "@types/js-yaml": "*",
-    "@faasjs/deep_merge": ">=7.0.3",
-    "@faasjs/func": ">=7.0.3"
+    "@faasjs/deep_merge": ">=7.1.0",
+    "@faasjs/func": ">=7.1.0"
   },
   "engines": {
     "node": ">=24.0.0",