@celerity-sdk/core 0.2.0 → 0.2.1

package/dist/index.d.cts

@@ -153,6 +153,7 @@ declare const APP_CONFIG: unique symbol;
 declare const RUNTIME_APP: unique symbol;
 
 type ResolvedHandler = {
+    id?: string;
     path?: string;
     method?: string;
     protectedBy: string[];
@@ -200,6 +201,7 @@ declare function registerModuleGraph(graph: ModuleGraph, container: Container):
 declare class HandlerRegistry {
     private handlers;
     getHandler(path: string, method: string): ResolvedHandler | undefined;
+    getHandlerById(id: string): ResolvedHandler | undefined;
     getAllHandlers(): ResolvedHandler[];
     populateFromGraph(graph: ModuleGraph, container: Container): Promise<void>;
     scanModule(moduleClass: Type, container: Container): Promise<void>;
@@ -408,11 +410,14 @@ declare function mapRuntimeRequest(request: Request): HttpRequest;
 /** Convert SDK HttpResponse → NAPI runtime Response. */
 declare function mapToRuntimeResponse(response: HttpResponse): Response;
 
+type RuntimeCallback = (err: Error | null, request: Request) => Promise<Response>;
 type RuntimeBootstrapResult = {
     registry: HandlerRegistry;
     container: Container;
     /** Create a runtime-compatible handler callback for a specific route. */
-    createRouteCallback(path: string, method: string): ((err: Error | null, request: Request) => Promise<Response>) | null;
+    createRouteCallback(path: string, method: string): RuntimeCallback | null;
+    /** Create a runtime-compatible handler callback by handler ID (blueprint handler field). */
+    createRouteCallbackById(handlerId: string): RuntimeCallback | null;
 };
 /**
  * Bootstrap the user's module and return an object with per-route callback creation.

package/dist/index.d.ts

@@ -153,6 +153,7 @@ declare const APP_CONFIG: unique symbol;
 declare const RUNTIME_APP: unique symbol;
 
 type ResolvedHandler = {
+    id?: string;
     path?: string;
     method?: string;
     protectedBy: string[];
@@ -200,6 +201,7 @@ declare function registerModuleGraph(graph: ModuleGraph, container: Container):
 declare class HandlerRegistry {
     private handlers;
     getHandler(path: string, method: string): ResolvedHandler | undefined;
+    getHandlerById(id: string): ResolvedHandler | undefined;
     getAllHandlers(): ResolvedHandler[];
     populateFromGraph(graph: ModuleGraph, container: Container): Promise<void>;
     scanModule(moduleClass: Type, container: Container): Promise<void>;
@@ -408,11 +410,14 @@ declare function mapRuntimeRequest(request: Request): HttpRequest;
 /** Convert SDK HttpResponse → NAPI runtime Response. */
 declare function mapToRuntimeResponse(response: HttpResponse): Response;
 
+type RuntimeCallback = (err: Error | null, request: Request) => Promise<Response>;
 type RuntimeBootstrapResult = {
     registry: HandlerRegistry;
     container: Container;
     /** Create a runtime-compatible handler callback for a specific route. */
-    createRouteCallback(path: string, method: string): ((err: Error | null, request: Request) => Promise<Response>) | null;
+    createRouteCallback(path: string, method: string): RuntimeCallback | null;
+    /** Create a runtime-compatible handler callback by handler ID (blueprint handler field). */
+    createRouteCallbackById(handlerId: string): RuntimeCallback | null;
 };
 /**
  * Bootstrap the user's module and return an object with per-route callback creation.

package/dist/index.js

@@ -1055,6 +1055,11 @@ var HandlerRegistry = class {
     debug4("getHandler %s %s \u2192 %s", method, path, found ? "matched" : "not found");
     return found;
   }
+  getHandlerById(id) {
+    const found = this.handlers.find((h) => h.id !== void 0 && h.id === id);
+    debug4("getHandlerById %s \u2192 %s", id, found ? "matched" : "not found");
+    return found;
+  }
   getAllHandlers() {
     return [
       ...this.handlers
@@ -1140,8 +1145,9 @@ var HandlerRegistry = class {
         layers.unshift(validate(schemas));
       }
     }
-    debug4("registerFunctionHandler: %s", meta.method && meta.path ? `${meta.method} ${meta.path}` : "(no route)");
+    debug4("registerFunctionHandler: %s", definition.id ?? (meta.method && meta.path ? `${meta.method} ${meta.path}` : "(no route)"));
     this.handlers.push({
+      id: definition.id,
       path: meta.path,
       method: meta.method,
       protectedBy: [],
@@ -1759,20 +1765,26 @@ async function bootstrapForRuntime(modulePath, systemLayers) {
   const layers = systemLayers ?? await createDefaultSystemLayers();
   const rootModule = await discoverModule(modulePath);
   const { container, registry } = await bootstrap(rootModule);
+  function buildCallback(handler) {
+    if (!handler) return null;
+    return async (_err, request) => {
+      const httpRequest = mapRuntimeRequest(request);
+      const httpResponse = await executeHandlerPipeline(handler, httpRequest, {
+        container,
+        systemLayers: layers
+      });
+      return mapToRuntimeResponse(httpResponse);
+    };
+  }
+  __name(buildCallback, "buildCallback");
   return {
     registry,
     container,
     createRouteCallback(path, method) {
-      const handler = registry.getHandler(path, method);
-      if (!handler) return null;
-      return async (_err, request) => {
-        const httpRequest = mapRuntimeRequest(request);
-        const httpResponse = await executeHandlerPipeline(handler, httpRequest, {
-          container,
-          systemLayers: layers
-        });
-        return mapToRuntimeResponse(httpResponse);
-      };
+      return buildCallback(registry.getHandler(path, method));
+    },
+    createRouteCallbackById(handlerId) {
+      return buildCallback(registry.getHandlerById(handlerId));
     }
   };
 }
@@ -1787,7 +1799,7 @@ async function startRuntime(options) {
   const appConfig = app.setup();
   const result = await bootstrapForRuntime();
   for (const def of appConfig.api?.http?.handlers ?? []) {
-    const callback = result.createRouteCallback(def.path, def.method);
+    const callback = result.createRouteCallback(def.path, def.method) ?? result.createRouteCallbackById(def.handler);
     if (callback) {
       app.registerHttpHandler(def.path, def.method, def.timeout, callback);
     }