akanjs 2.0.5 → 2.0.7

package/document/database.ts

@@ -2,7 +2,7 @@ import type { Dayjs, MergedValues, PromiseOrObject } from "akanjs/base";
 import { Logger } from "akanjs/common";
 import type { DocumentModel, QueryOf } from "akanjs/constant";
 import type { CacheAdaptor } from "akanjs/service";
-import type DataLoader from "dataloader";
+import type { DataLoader } from "./dataLoader";
 import type { ExtractQuery, ExtractSort, FilterInstance } from "./filterMeta";
 import type { CRUDEventType, Mdl, SaveEventType } from "./into";
 import type { DataInputOf, FindQueryOption, ListQueryOption } from "./types";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "sourceType": "module",
   "type": "module",
   "bin": {
@@ -162,7 +162,6 @@
     }
   },
   "dependencies": {
-    "@formatjs/intl-localematcher": "^0.8.8",
     "@inquirer/prompts": "^8.4.3",
     "@langchain/core": "^1.1.47",
     "@langchain/deepseek": "^1.0.26",
@@ -171,29 +170,19 @@
     "chalk": "^5.6.2",
     "clsx": "^2.1.1",
     "commander": "^14.0.3",
-    "compare-versions": "^6.1.1",
-    "dataloader": "^2.2.3",
     "dayjs": "^1.11.20",
     "fontaine": "^0.8.0",
     "fonteditor-core": "^2.6.3",
     "ignore": "^7.0.5",
     "immer": "^11.1.8",
     "ink": "^6.8.0",
-    "js-cookie": "^3.0.7",
     "js-yaml": "^4.1.1",
-    "jwt-decode": "^4.0.0",
-    "latest-version": "^9.0.0",
-    "lodash": "^4.18.1",
-    "negotiator": "^1.0.0",
-    "open": "^11.0.0",
     "ora": "^9.4.0",
-    "pluralize": "^8.0.0",
     "qrcode": "^1.5.4",
     "sharp": "^0.34.5",
     "ssh2": "^1.17.0",
     "subset-font": "^2.5.0",
-    "tailwindcss": "^4.3.0",
-    "uuid": "^13.0.2"
+    "tailwindcss": "^4.3.0"
   },
   "peerDependencies": {
     "@capacitor-community/contacts": "^7.2.0",
@@ -222,6 +211,8 @@
     "croner": "^10.0.1",
     "daisyui": "^5.5.20",
     "file-saver": "^2.0.5",
+    "fontaine": "^0.8.0",
+    "fonteditor-core": "^2.6.3",
     "ioredis": "^5.10.1",
     "mermaid": "^11.15.0",
     "postgres": "^3.4.9",
@@ -237,7 +228,10 @@
     "react-simple-pull-to-refresh": "^1.3.4",
     "react-spring": "^9.7.5",
     "scheduler": "^0.27.0",
+    "sharp": "^0.34.5",
+    "subset-font": "^2.5.0",
     "tailwind-scrollbar": "^4.0.2",
+    "tailwindcss": "^4.3.0",
     "typescript": "^6.0.3"
   },
   "peerDependenciesMeta": {

package/server/akanApp.ts

@@ -2,6 +2,7 @@ import { mkdir, rm } from "node:fs/promises";
 import path from "node:path";
 import { Logger } from "akanjs/common";
 import type { AkanChildRole, AkanChildStatus, AkanIpcMessage, AkanMetricsReport, AkanUpstream } from "akanjs/service";
+import { isTraceEnabled } from "akanjs/signal";
 import type { BuilderMessage, BuilderReq, BuilderRes } from "./artifact";
 import { RotatingLogWriter } from "./logging/rotatingLogWriter";
 import { ProcessMetricsCollector } from "./processMetricsCollector";
@@ -17,6 +18,13 @@ interface ChildState {
   healthPath?: string;
   metrics: AkanMetricsReport;
   lastPongAt?: number;
+  restartAttempts: number;
+  restartCount: number;
+  restartTimer: Timer | null;
+  restartPending: boolean;
+  lastExitCode?: number | null;
+  lastRestartAt?: number;
+  lastRestartReason?: string;
 }
 
 interface GatewayWsData {
@@ -49,6 +57,9 @@ interface AkanReplicaConfig {
 
 /** Gateway/orchestrator that starts Akan child servers and proxies HTTP/WebSocket traffic. */
 export class AkanApp {
+  static readonly #childRestartBaseDelayMs = 1_000;
+  static readonly #childRestartMaxDelayMs = 30_000;
+  static readonly #childRestartGraceMs = 5_000;
   static readonly #hopByHopHeaders = new Set([
     "connection",
     "keep-alive",
@@ -75,6 +86,7 @@ export class AkanApp {
   readonly #builderReqMap = new Map<number, { childIdx: number; childLocalId: number }>();
   #server: Bun.Server<GatewayWsData> | null = null;
   #rrIdx = 0;
+  #federationChildCache: ChildState[] | null = null;
   #snapshotTimer: Timer | null = null;
   #healthTimer: Timer | null = null;
   #metricsTimer: Timer | null = null;
@@ -83,6 +95,9 @@ export class AkanApp {
   readonly #childOutputBuffers = new Map<string, string>();
   static readonly #ansiPattern = new RegExp(`${String.fromCharCode(27)}\\[[0-?]*[ -/]*[@-~]`, "g");
   #gatewayMetrics: AkanMetricsReport = {};
+  #proxyHopCount = 0;
+  #proxyHopSumMs = 0;
+  #proxyHopMaxMs = 0;
   #resolveStopped: (() => void) | null = null;
   #exitAfterStop = false;
   #stopping = false;
@@ -171,7 +186,11 @@ export class AkanApp {
     this.#server?.stop(true);
     this.#server = null;
     for (const child of this.#children.values()) {
-      if (!child.proc.killed) child.proc.send({ type: "shutdown", signal } satisfies AkanIpcMessage);
+      if (child.restartTimer) {
+        clearTimeout(child.restartTimer);
+        child.restartTimer = null;
+      }
+      this.#sendToChild(child, { type: "shutdown", signal } satisfies AkanIpcMessage);
     }
     await Promise.race([
       Promise.all([...this.#children.values()].map((child) => child.proc.exited.catch(() => undefined))),
@@ -200,7 +219,8 @@ export class AkanApp {
     const role = this.#getRole(idx);
     const upstream = this.#getChildUpstream(idx, role);
     const childCode = `import(${JSON.stringify(path.resolve(this.#serverPath))}).then((mod)=>{ const server = mod.server ?? mod.app; if (!server?.start) throw new Error("server.ts must export server or app with start()"); return server.start({ listen: process.env.SERVER_MODE !== "batch" }); }).catch((error)=>{ process.send?.({ type: "error", message: error instanceof Error ? error.message : String(error), stack: error instanceof Error ? error.stack : undefined, pid: process.pid }); process.exit(1); });`;
-    const proc = Bun.spawn(["bun", "-e", childCode], {
+    let proc!: Bun.Subprocess<"ignore", "pipe", "pipe">;
+    proc = Bun.spawn(["bun", "-e", childCode], {
       cwd: process.cwd(),
       env: {
         ...process.env,
@@ -212,32 +232,143 @@ export class AkanApp {
         AKAN_CHILD_SOCKET: upstream.http.socketPath,
         AKAN_CHILD_WS_PORT: upstream.ws ? String(upstream.ws.port) : "",
       },
-      ipc: (message) => this.#handleMessage(idx, message as AkanIpcMessage),
+      ipc: (message) => this.#handleMessage(idx, message as AkanIpcMessage, proc),
       stdout: "pipe",
       stderr: "pipe",
       stdin: "ignore",
     });
-    this.#children.set(idx, { idx, role, proc, ready: false, status: "starting", metrics: {} });
+    const previous = this.#children.get(idx);
+    this.#children.set(idx, {
+      idx,
+      role,
+      proc,
+      ready: false,
+      status: "starting",
+      metrics: {},
+      restartAttempts: previous?.restartAttempts ?? 0,
+      restartCount: previous?.restartCount ?? 0,
+      restartTimer: null,
+      restartPending: false,
+      lastExitCode: previous?.lastExitCode,
+      lastRestartAt: previous?.lastRestartAt,
+      lastRestartReason: previous?.lastRestartReason,
+    });
+    this.#invalidateFederationChildCache();
     this.#pipeOutput(idx, role, proc.stdout, "stdout");
     this.#pipeOutput(idx, role, proc.stderr, "stderr");
-    proc.exited.then((code) => {
-      const child = this.#children.get(idx);
-      if (child) child.status = "exited";
-      this.#removeChildRooms(idx);
-      if (this.#stopping) return;
-      this.logger.error(`Child ${idx}/${role} exited with code ${code}; shutting down all children`);
-      void this.stop("child-exit");
+    proc.exited.then((code) => this.#handleChildExit(idx, proc, code));
+  }
+
+  #handleChildExit(idx: number, proc: Bun.Subprocess<"ignore", "pipe", "pipe">, code: number | null) {
+    const child = this.#children.get(idx);
+    if (!child || child.proc !== proc) return;
+    child.status = "exited";
+    child.lastExitCode = code;
+    this.#invalidateFederationChildCache();
+    this.#removeChildRooms(idx);
+    if (this.#stopping) return;
+    void this.#scheduleChildRestart(child, proc, `exit:${code ?? "unknown"}`);
+  }
+
+  #scheduleChildRestart(child: ChildState, proc: Bun.Subprocess<"ignore", "pipe", "pipe">, reason: string): void {
+    if (this.#stopping) return;
+    if (child.proc !== proc) return;
+    if (child.restartPending || child.restartTimer) {
+      child.lastRestartReason = reason;
+      return;
+    }
+
+    child.restartPending = true;
+    child.ready = false;
+    child.status = reason === "health-timeout" ? "unhealthy" : "exited";
+    child.upstream = undefined;
+    child.healthPath = undefined;
+    this.#invalidateFederationChildCache();
+    child.lastRestartReason = reason;
+    child.lastRestartAt = Date.now();
+    this.#removeChildRooms(child.idx);
+
+    const attempt = child.restartAttempts;
+    const delay = Math.min(AkanApp.#childRestartBaseDelayMs * 2 ** attempt, AkanApp.#childRestartMaxDelayMs);
+    child.restartAttempts = attempt + 1;
+    child.restartCount += 1;
+    this.logger.error(
+      `Child ${child.idx}/${child.role} failed (${reason}); restarting in ${delay}ms (attempt ${child.restartAttempts})`,
+    );
+
+    void this.#restartChildAfterDelay(child.idx, proc, reason, delay).catch((error) => {
+      const current = this.#children.get(child.idx);
+      if (!current || current.proc !== proc || this.#stopping) return;
+      current.restartPending = false;
+      this.logger.error(
+        `Failed to restart child ${child.idx}/${child.role}: ${error instanceof Error ? error.message : String(error)}`,
+      );
+      this.#scheduleChildRestart(current, proc, "restart-failed");
     });
   }
 
+  async #restartChildAfterDelay(
+    idx: number,
+    proc: Bun.Subprocess<"ignore", "pipe", "pipe">,
+    reason: string,
+    delay: number,
+  ) {
+    const child = this.#children.get(idx);
+    if (!child || child.proc !== proc || this.#stopping) return;
+    await this.#stopChildForRestart(child, proc, reason);
+    if (this.#stopping) return;
+    const current = this.#children.get(idx);
+    if (!current || current.proc !== proc) return;
+    current.restartTimer = setTimeout(() => {
+      current.restartTimer = null;
+      void this.#respawnChild(idx, proc).catch((error) => {
+        const latest = this.#children.get(idx);
+        if (!latest || latest.proc !== proc || this.#stopping) return;
+        latest.restartPending = false;
+        this.logger.error(
+          `Failed to respawn child ${idx}/${latest.role}: ${error instanceof Error ? error.message : String(error)}`,
+        );
+        this.#scheduleChildRestart(latest, proc, "respawn-failed");
+      });
+    }, delay);
+  }
+
+  async #respawnChild(idx: number, proc: Bun.Subprocess<"ignore", "pipe", "pipe">) {
+    if (this.#stopping) return;
+    const current = this.#children.get(idx);
+    if (!current || current.proc !== proc) return;
+    await this.#removeChildSocket(idx, current.role);
+    current.restartPending = false;
+    this.#spawn(idx);
+  }
+
+  async #stopChildForRestart(child: ChildState, proc: Bun.Subprocess<"ignore", "pipe", "pipe">, reason: string) {
+    if (!proc.killed) {
+      this.#sendToChild(child, { type: "shutdown", signal: reason } satisfies AkanIpcMessage);
+    }
+    const result = await Promise.race([
+      proc.exited.then(() => "exited" as const).catch(() => "exited" as const),
+      new Promise<"timeout">((resolve) => setTimeout(() => resolve("timeout"), AkanApp.#childRestartGraceMs)),
+    ]);
+    if (result === "timeout" && !proc.killed) {
+      this.logger.warn(`Child ${child.idx}/${child.role} did not stop in ${AkanApp.#childRestartGraceMs}ms; killing`);
+      proc.kill();
+      await proc.exited.catch(() => undefined);
+    }
+  }
+
   async #prepareRuntimeDir() {
     await mkdir(this.#runtimeDir, { recursive: true });
     for (let idx = 0; idx < this.#replica.total; idx++) {
-      const socketPath = this.#getChildUpstream(idx, this.#getRole(idx)).http.socketPath;
-      try {
-        await rm(socketPath, { force: true });
-      } catch {
-      }
+      await this.#removeChildSocket(idx, this.#getRole(idx));
+    }
+  }
+
+  async #removeChildSocket(idx: number, role: AkanChildRole) {
+    const socketPath = this.#getChildUpstream(idx, role).http.socketPath;
+    try {
+      await rm(socketPath, { force: true });
+    } catch {
     }
   }
 
@@ -280,6 +411,7 @@ export class AkanApp {
     const url = new URL(req.url);
     if (url.pathname === "/_akan/app/health") return Response.json(this.#getHealthStatus());
     if (url.pathname === "/_akan/app/metrics") return Response.json(this.#getMetricsStatus());
+    if (url.pathname === "/_akan/bench/ping") return new Response("ok");
     if (this.#isWebSocketPath(url.pathname)) return this.#upgradeWebSocket(req, server);
     const assetResponse = await this.#serveImmutableArtifact(req, url);
     if (assetResponse) return assetResponse;
@@ -388,6 +520,12 @@ export class AkanApp {
         ready: child.ready,
         pid: child.pid,
         upstream: child.upstream,
+        restartAttempts: child.restartAttempts,
+        restartCount: child.restartCount,
+        restartPending: child.restartPending,
+        lastExitCode: child.lastExitCode,
+        lastRestartAt: child.lastRestartAt,
+        lastRestartReason: child.lastRestartReason,
       })),
     };
   }
@@ -397,11 +535,24 @@ export class AkanApp {
       rooms: this.#roomChildren.size,
       sockets: this.#socketRooms.size,
       gateway: this.#gatewayMetrics,
+      proxyHop: this.#proxyHopCount
+        ? {
+            count: this.#proxyHopCount,
+            meanMs: Math.round((this.#proxyHopSumMs / this.#proxyHopCount) * 1000) / 1000,
+            maxMs: Math.round(this.#proxyHopMaxMs * 1000) / 1000,
+          }
+        : null,
       children: [...this.#children.values()].map((child) => ({
         idx: child.idx,
         role: child.role,
         metrics: child.metrics,
         rooms: this.#childRooms.get(child.idx)?.size ?? 0,
+        restartAttempts: child.restartAttempts,
+        restartCount: child.restartCount,
+        restartPending: child.restartPending,
+        lastExitCode: child.lastExitCode,
+        lastRestartAt: child.lastRestartAt,
+        lastRestartReason: child.lastRestartReason,
       })),
     };
   }
@@ -416,6 +567,8 @@ export class AkanApp {
     const headers = this.#makeProxyHeaders(req, child.idx);
     child.metrics.activeRequests = (child.metrics.activeRequests ?? 0) + 1;
     child.metrics.totalRequests = (child.metrics.totalRequests ?? 0) + 1;
+    const traced = isTraceEnabled();
+    const hopStart = traced ? performance.now() : 0;
     try {
       const upstreamRes = await fetch(upstreamUrl, {
         unix: child.upstream.socketPath,
@@ -428,9 +581,20 @@ export class AkanApp {
       return this.#proxyResponse(upstreamRes);
     } finally {
       child.metrics.activeRequests = Math.max(0, (child.metrics.activeRequests ?? 1) - 1);
+      if (traced) this.#recordProxyHop(performance.now() - hopStart);
     }
   }
 
+  /**
+   * Gateway-observed upstream round-trip time. The pure proxy overhead is this value
+   * minus the child handler time captured in the per-request trace.
+   */
+  #recordProxyHop(durationMs: number) {
+    this.#proxyHopCount += 1;
+    this.#proxyHopSumMs += durationMs;
+    this.#proxyHopMaxMs = Math.max(this.#proxyHopMaxMs, durationMs);
+  }
+
   #proxyResponse(upstreamRes: Response): Response {
     const headers = new Headers(upstreamRes.headers);
 
@@ -517,27 +681,36 @@ export class AkanApp {
   #makeProxyHeaders(req: Request, childIdx: number) {
     const headers = new Headers(req.headers);
     for (const key of AkanApp.#hopByHopHeaders) headers.delete(key);
-    const url = new URL(req.url);
     const forwardedFor = headers.get("x-forwarded-for");
     const clientAddress = headers.get("x-real-ip") ?? "127.0.0.1";
+    const host = headers.get("host");
     headers.set("x-forwarded-for", forwardedFor ? `${forwardedFor}, ${clientAddress}` : clientAddress);
-    headers.set("x-forwarded-host", headers.get("host") ?? url.host);
-    headers.set("x-forwarded-proto", url.protocol.replace(":", ""));
+    headers.set("x-forwarded-host", host ?? new URL(req.url).host);
+    headers.set("x-forwarded-proto", req.url.startsWith("https:") ? "https" : "http");
     headers.set("x-akan-child-idx", String(childIdx));
-    headers.set("x-request-id", headers.get("x-request-id") ?? crypto.randomUUID());
+    if (!headers.has("x-request-id") && process.env.AKAN_BENCH_SKIP_REQUEST_ID !== "1") {
+      headers.set("x-request-id", crypto.randomUUID());
+    }
     headers.set("host", "akan-child");
     return headers;
   }
 
+  #invalidateFederationChildCache() {
+    this.#federationChildCache = null;
+  }
+
   #pickFederationChild() {
-    const candidates = [...this.#children.values()].filter(
-      (child) =>
-        (child.role === "federation" || child.role === "all") &&
-        child.ready &&
-        child.status !== "unhealthy" &&
-        child.status !== "exited" &&
-        !child.proc.killed,
-    );
+    const candidates =
+      this.#federationChildCache ??
+      [...this.#children.values()].filter(
+        (child) =>
+          (child.role === "federation" || child.role === "all") &&
+          child.ready &&
+          child.status !== "unhealthy" &&
+          child.status !== "exited" &&
+          !child.proc.killed,
+      );
+    this.#federationChildCache = candidates;
     if (candidates.length === 0) return null;
     const child = candidates[this.#rrIdx % candidates.length];
     this.#rrIdx++;
@@ -557,7 +730,13 @@ export class AkanApp {
     };
   }
 
-  #handleMessage(idx: number, message: AkanIpcMessage | BuilderMessage) {
+  #handleMessage(
+    idx: number,
+    message: AkanIpcMessage | BuilderMessage,
+    proc?: Bun.Subprocess<"ignore", "pipe", "pipe">,
+  ) {
+    const child = this.#children.get(idx);
+    if (proc && (!child || child.proc !== proc)) return;
     if (!message || typeof message !== "object") return;
     switch (message.type) {
       case "ready":
@@ -586,7 +765,7 @@ export class AkanApp {
         return;
       case "error":
         this.logger.error(message.message);
-        void this.stop("child-error");
+        if (child && proc) void this.#scheduleChildRestart(child, proc, "child-error");
         return;
       case "build-route":
         this.#forwardBuildRoute(idx, message);
@@ -618,6 +797,9 @@ export class AkanApp {
     child.upstream = message.upstream;
     child.healthPath = message.healthPath;
     child.lastPongAt = Date.now();
+    child.restartAttempts = 0;
+    child.restartPending = false;
+    this.#invalidateFederationChildCache();
     if ([...this.#children.values()].every((item) => item.ready)) {
       process.send?.({ type: "backend-ready", pid: process.pid } satisfies AkanIpcMessage);
       this.logger.verbose(`All ${this.#children.size} child process(es) are ready`);
@@ -629,6 +811,7 @@ export class AkanApp {
     if (!child) return;
     child.status = "healthy";
     child.lastPongAt = Date.now();
+    this.#invalidateFederationChildCache();
   }
 
   #deliverPubsub(originIdx: number, message: Extract<AkanIpcMessage, { type: "pubsub.publish" }>) {
@@ -643,12 +826,15 @@ export class AkanApp {
       if (childIdx === originIdx) continue;
       const child = this.#children.get(childIdx);
       if (!child || child.proc.killed || child.status === "exited") continue;
-      child.proc.send({
-        type: "pubsub.deliver",
-        roomId: message.roomId,
-        data: message.data,
-        origin: message.origin,
-      } satisfies AkanIpcMessage);
+      if (
+        !this.#sendToChild(child, {
+          type: "pubsub.deliver",
+          roomId: message.roomId,
+          data: message.data,
+          origin: message.origin,
+        } satisfies AkanIpcMessage)
+      )
+        continue;
       child.metrics.pubsubDeliverCount = (child.metrics.pubsubDeliverCount ?? 0) + 1;
     }
   }
@@ -747,7 +933,7 @@ export class AkanApp {
   #requestRoomSnapshots() {
     for (const child of this.#children.values()) {
       if (child.proc.killed || child.status === "exited") continue;
-      child.proc.send({ type: "pubsub.snapshot.request" } satisfies AkanIpcMessage);
+      this.#sendToChild(child, { type: "pubsub.snapshot.request" } satisfies AkanIpcMessage);
     }
   }
 
@@ -757,11 +943,15 @@ export class AkanApp {
       if (child.proc.killed || child.status === "exited") continue;
       if (child.lastPongAt && now - child.lastPongAt > 5_000) {
         child.status = "unhealthy";
-        this.logger.error(`Child ${child.idx}/${child.role} health check timed out; shutting down all children`);
-        void this.stop("health-timeout");
+        this.#invalidateFederationChildCache();
+        void this.#scheduleChildRestart(child, child.proc, "health-timeout");
         return;
       }
-      child.proc.send({ type: "health.ping", nonce: crypto.randomUUID(), sentAt: now } satisfies AkanIpcMessage);
+      this.#sendToChild(child, {
+        type: "health.ping",
+        nonce: crypto.randomUUID(),
+        sentAt: now,
+      } satisfies AkanIpcMessage);
     }
   }
 
@@ -780,25 +970,41 @@ export class AkanApp {
     this.#builderReqMap.delete(message.id);
     const child = this.#children.get(request.childIdx);
     if (!child || child.proc.killed) return;
-    child.proc.send({ ...message, id: request.childLocalId } satisfies BuilderRes);
+    this.#sendToChild(child, { ...message, id: request.childLocalId } satisfies BuilderRes);
   }
 
   #fanoutToFederation(message: AkanIpcMessage | BuilderMessage, exceptIdx?: number) {
     for (const child of this.#children.values()) {
       if (child.idx === exceptIdx) continue;
-      if (child.role === "federation" || child.role === "all") child.proc.send(message);
+      if (child.role === "federation" || child.role === "all") this.#sendToChild(child, message);
     }
   }
 
   #fanoutToBatch(message: AkanIpcMessage) {
     for (const child of this.#children.values()) {
       if (child.role === "batch" || child.role === "all") {
-        child.proc.send(message);
-        if (message.type === "queue.wake") child.metrics.queueWakeCount = (child.metrics.queueWakeCount ?? 0) + 1;
+        if (this.#sendToChild(child, message) && message.type === "queue.wake") {
+          child.metrics.queueWakeCount = (child.metrics.queueWakeCount ?? 0) + 1;
+        }
       }
     }
   }
 
+  #sendToChild(child: ChildState, message: AkanIpcMessage | BuilderMessage): boolean {
+    if (child.proc.killed || child.status === "exited") return false;
+    try {
+      child.proc.send(message);
+      return true;
+    } catch (error) {
+      this.logger.warn(
+        `Failed to send ${message.type} to child ${child.idx}/${child.role}: ${
+          error instanceof Error ? error.message : String(error)
+        }`,
+      );
+      return false;
+    }
+  }
+
   async #pipeOutput(
     idx: number,
     role: AkanChildRole,

package/server/di/diLifecycle.ts

@@ -80,7 +80,7 @@ export class DiLifecycle {
     this.#libs = libs;
     this.#service.set("base", {
       service: srv.base,
-      signal: SignalRegistry.registerService(BaseInternal, BaseEndpoint, Base),
+      signal: SignalRegistry.registerService("base" as const, BaseInternal, BaseEndpoint, Base),
     });
     this.#middleware.set(Logging.refName, Logging);
     const defaultOption = createDefaultAkanOption();