@soederpop/luca 0.0.30 → 0.0.31

package/src/introspection/generated.node.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-24T06:38:35.496Z
+// Generated at: 2026-03-24T09:08:05.888Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -10426,6 +10426,16 @@ setBuildTimeData('features.helpers', {
         "absPath": {
           "type": "string",
           "description": "Absolute path to the module file"
+        },
+        "options": {
+          "type": "{ cacheBust?: boolean }",
+          "description": "Optional settings",
+          "properties": {
+            "cacheBust": {
+              "type": "any",
+              "description": "When true, appends a timestamp query to bypass the native import cache (useful for hot reload)"
+            }
+          }
         }
       },
       "required": [
@@ -12749,6 +12759,19 @@ setBuildTimeData('servers.express', {
       ],
       "returns": "Promise<this>"
     },
+    "reloadEndpoint": {
+      "description": "Reload a mounted endpoint by its file path. Re-reads the module through the helpers VM loader so the next request picks up the new handlers.",
+      "parameters": {
+        "filePath": {
+          "type": "string",
+          "description": "Absolute path to the endpoint file"
+        }
+      },
+      "required": [
+        "filePath"
+      ],
+      "returns": "Promise<Endpoint | null>"
+    },
     "useEndpointModules": {
       "description": "",
       "parameters": {
@@ -23768,6 +23791,16 @@ export const introspectionData = [
           "absPath": {
             "type": "string",
             "description": "Absolute path to the module file"
+          },
+          "options": {
+            "type": "{ cacheBust?: boolean }",
+            "description": "Optional settings",
+            "properties": {
+              "cacheBust": {
+                "type": "any",
+                "description": "When true, appends a timestamp query to bypass the native import cache (useful for hot reload)"
+              }
+            }
           }
         },
         "required": [
@@ -26080,6 +26113,19 @@ export const introspectionData = [
         ],
         "returns": "Promise<this>"
       },
+      "reloadEndpoint": {
+        "description": "Reload a mounted endpoint by its file path. Re-reads the module through the helpers VM loader so the next request picks up the new handlers.",
+        "parameters": {
+          "filePath": {
+            "type": "string",
+            "description": "Absolute path to the endpoint file"
+          }
+        },
+        "required": [
+          "filePath"
+        ],
+        "returns": "Promise<Endpoint | null>"
+      },
       "useEndpointModules": {
         "description": "",
         "parameters": {

package/src/introspection/generated.web.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-24T06:38:35.508Z
+// Generated at: 2026-03-24T09:08:05.900Z
 
 setBuildTimeData('features.containerLink', {
   "id": "features.containerLink",

package/src/node/features/helpers.ts

@@ -408,11 +408,14 @@ export class Helpers extends Feature<HelpersState, HelpersOptions> {
    * Uses the same `useNativeImport` check as discovery to decide the loading strategy.
    *
    * @param absPath - Absolute path to the module file
+   * @param options - Optional settings
+   * @param options.cacheBust - When true, appends a timestamp query to bypass the native import cache (useful for hot reload)
    * @returns The module's exports
    */
-  async loadModuleExports(absPath: string): Promise<Record<string, any>> {
+  async loadModuleExports(absPath: string, options?: { cacheBust?: boolean }): Promise<Record<string, any>> {
     if (this.useNativeImport) {
-      const mod = await import(absPath)
+      const importPath = options?.cacheBust ? `${absPath}?t=${Date.now()}` : absPath
+      const mod = await import(importPath)
       return mod
     }
 

package/src/scaffolds/generated.ts

@@ -1,5 +1,5 @@
 // Auto-generated scaffold and MCP readme content
-// Generated at: 2026-03-24T06:38:36.374Z
+// Generated at: 2026-03-24T09:08:06.782Z
 // Source: docs/scaffolds/*.md, docs/examples/assistant/, and docs/mcp/readme.md
 //
 // Do not edit manually. Run: luca build-scaffolds

package/src/servers/express.ts

@@ -211,6 +211,24 @@ export class ExpressServer<T extends ServerState = ServerState, K extends Expres
       return this
     }
 
+    /**
+     * Reload a mounted endpoint by its file path. Re-reads the module through
+     * the helpers VM loader so the next request picks up the new handlers.
+     *
+     * @param filePath - Absolute path to the endpoint file
+     * @returns The reloaded Endpoint, or null if no mounted endpoint matches
+     */
+    async reloadEndpoint(filePath: string): Promise<Endpoint | null> {
+      const endpoint = this._mountedEndpoints.find(ep => (ep.options as any).filePath === filePath)
+      if (!endpoint) return null
+
+      const helpers = this.container.feature('helpers') as any
+      const mod = await helpers.loadModuleExports(filePath, { cacheBust: true })
+      const endpointModule: EndpointModule = mod.default || mod
+      await endpoint.load(endpointModule)
+      return endpoint
+    }
+
     async useEndpointModules(modules: EndpointModule[]): Promise<this> {
       for (const mod of modules) {
         try {