akanjs 2.2.4 → 2.2.6

package/fetch/fetchType/endpointFetch.type.ts

@@ -24,7 +24,6 @@ type PubsubSubscribeFn<E> = (
   ...args: [...EndpInfoArgs<E>, handleEvent: (data: EndpInfoReturns<E>) => PromiseOrObject<void>, options?: FetchPolicy]
 ) => () => void;
 
-// Keys kept as-is: query / mutation / message (emit)
 type PrimaryFetchType<EInfoObj extends { [key: string]: EndpointInfo }> = {
   [K in keyof EInfoObj as EndpInfoType<EInfoObj[K]> extends "query" | "mutation" | "message" ? K : never]: EndpInfoType<
     EInfoObj[K]
@@ -35,7 +34,6 @@ type PrimaryFetchType<EInfoObj extends { [key: string]: EndpointInfo }> = {
       : never;
 };
 
-// Keys remapped to `subscribe${Key}`
 type PubsubFetchType<EInfoObj extends { [key: string]: EndpointInfo }> = {
   [K in keyof EInfoObj as EndpInfoType<EInfoObj[K]> extends "pubsub"
     ? K extends string
@@ -44,7 +42,6 @@ type PubsubFetchType<EInfoObj extends { [key: string]: EndpointInfo }> = {
     : never]: PubsubSubscribeFn<EInfoObj[K]>;
 };
 
-// Keys remapped to `listen${Key}`
 type MessageListenFetchType<EInfoObj extends { [key: string]: EndpointInfo }> = {
   [K in keyof EInfoObj as EndpInfoType<EInfoObj[K]> extends "message"
     ? K extends string

package/fetch/fetchType/sliceFetch.type.ts

@@ -5,8 +5,6 @@ import type { DatabaseModel, ExtractSort, FilterInstance } from "akanjs/document
 import type { SliceCls, SliceInfoArgs } from "akanjs/signal";
 import type { ClientEdit, ClientInit, ClientView, EditReturn, InitReturn, ViewReturn } from "./appliedReturn.type";
 
-// Shortcut accessors — avoids re-typing the long lookup path and lets TS
-// memoize each access once per SlceCls instantiation.
 type _SliceMap<S extends SliceCls> = S[typeof SLICE_META];
 type _RefName<S extends SliceCls> = S["srv"]["cnst"]["refName"];
 type _Cap<S extends SliceCls> = S["srv"]["cnst"]["_CapitalizedRefName"];
@@ -23,11 +21,6 @@ type _Sort<S extends SliceCls> = S["srv"]["db"]["_Sort"];
 type _LightWithId<S extends SliceCls> = _Light<S> extends { id: string } ? _Light<S> : { id: string };
 type _SliceFetchInitOption<S extends SliceCls> = FetchInitOption<_Input<S>, _Filter<S>, _DefaultInput<S>, _Sort<S>>;
 
-// The 4 dynamic parts below are each a single homomorphic mapped type over
-// `keyof SliceMap`, which preserves each result key's declaration trace
-// (better hover, slightly better go-to-def) and avoids the
-// `UnionToIntersection`/`MergedValues` blow-up.
-
 type SliceListFetch<S extends SliceCls> = {
   [Suffix in keyof _SliceMap<S> as Suffix extends string ? `${_RefName<S>}List${Capitalize<Suffix>}` : never]: (
     ...args: [
@@ -145,7 +138,6 @@ type AppliedBaseSliceFetchType<
 } & {
   [K in `get${_CapitalizedRefName}Edit`]: (id: string, option?: FetchPolicy) => ClientEdit<RefName, Full>;
 } & {
-  // TODO: migrate this to shared
   [K in `add${_CapitalizedRefName}Files`]: (
     fileList: FileList,
     parentId?: string,

package/fetch/requestStorage.ts

@@ -15,11 +15,7 @@ declare global {
 let _requestStorage: RequestStorage | null = null;
 if (typeof window === "undefined") {
   try {
-    // Keep this module synchronous. CSR builds import `akanjs/fetch` through
-    // Bun's HMR runtime, and a top-level `await import("node:async_hooks")`
-    // turns the whole `export *` chain into an async module. Named imports
-    // from that chain can then be observed as `null` during evaluation
-    // (notably `FetchClient` in `akanjs/client/useClient.ts`).
+
     const { AsyncLocalStorage } = require("node:async_hooks") as typeof import("node:async_hooks");
     globalThis.__AKAN_REQUEST_STORAGE__ ??= new AsyncLocalStorage() as RequestStorage;
     _requestStorage = globalThis.__AKAN_REQUEST_STORAGE__;
@@ -61,10 +57,6 @@ export function pushRequestFallback(req: Request): () => void {
   };
 }
 
-// Lightweight server-side helpers for server components to read the incoming
-// request's headers/cookies. Kept in akanjs/fetch (no heavy client deps) so
-// they can be imported from inside the RSC worker without pulling `akanjs/
-// client`'s useClient macro chain.
 /** Returns the active server request from AsyncLocalStorage or the fallback stack. */
 export function getRequest(): Request | undefined {
   return requestStorage?.getStore() ?? globalThis.__AKAN_REQUEST_FALLBACK_STACK__?.at(-1);
@@ -112,7 +104,7 @@ export function parseCookieHeader(cookieHeader: string): Map<string, CookieEntry
     if (eq === -1) continue;
     const name = trimmed.slice(0, eq).trim();
     const raw = trimmed.slice(eq + 1).trim();
-    // Support the `j:<json>` convention used elsewhere in akanjs.
+    
     const value = raw.startsWith("j:")
       ? (() => {
           try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "2.2.4",
+  "version": "2.2.6",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -15,98 +15,140 @@
   },
   "exports": {
     ".": {
+      "types": "./types/index.d.ts",
       "import": "./index.ts",
-      "types": "./index.ts",
       "default": "./index.ts"
     },
     "./package.json": "./package.json",
     "./base": {
+      "types": "./types/base/index.d.ts",
       "import": "./base/index.ts",
-      "types": "./base/index.ts",
       "default": "./base/index.ts"
     },
     "./common": {
+      "types": "./types/common/index.d.ts",
       "import": "./common/index.ts",
-      "types": "./common/index.ts",
       "default": "./common/index.ts"
     },
-    "./common/*": "./common/*",
+    "./common/*": {
+      "types": "./types/common/*.d.ts",
+      "import": "./common/*",
+      "default": "./common/*"
+    },
+    "./common/*.ts": {
+      "types": "./types/common/*.d.ts",
+      "import": "./common/*.ts",
+      "default": "./common/*.ts"
+    },
+    "./common/*.tsx": {
+      "types": "./types/common/*.d.ts",
+      "import": "./common/*.tsx",
+      "default": "./common/*.tsx"
+    },
     "./fetch": {
+      "types": "./types/fetch/index.d.ts",
       "import": "./fetch/index.ts",
-      "types": "./fetch/index.ts",
       "default": "./fetch/index.ts"
     },
     "./document": {
+      "types": "./types/document/index.d.ts",
       "import": "./document/index.ts",
-      "types": "./document/index.ts",
       "default": "./document/index.ts"
     },
     "./signal": {
+      "types": "./types/signal/index.d.ts",
       "import": "./signal/index.ts",
-      "types": "./signal/index.ts",
       "default": "./signal/index.ts"
     },
     "./store": {
+      "types": "./types/store/index.d.ts",
       "import": "./store/index.ts",
-      "types": "./store/index.ts",
       "default": "./store/index.ts"
     },
     "./ui": {
+      "types": "./types/ui/index.d.ts",
       "import": "./ui/index.ts",
-      "types": "./ui/index.ts",
       "default": "./ui/index.ts"
     },
-    "./ui/*": "./ui/*",
+    "./ui/*": {
+      "types": "./types/ui/*.d.ts",
+      "import": "./ui/*",
+      "default": "./ui/*"
+    },
+    "./ui/*.ts": {
+      "types": "./types/ui/*.d.ts",
+      "import": "./ui/*.ts",
+      "default": "./ui/*.ts"
+    },
+    "./ui/*.tsx": {
+      "types": "./types/ui/*.d.ts",
+      "import": "./ui/*.tsx",
+      "default": "./ui/*.tsx"
+    },
     "./client": {
+      "types": "./types/client/index.d.ts",
       "import": "./client/index.ts",
-      "types": "./client/index.ts",
       "default": "./client/index.ts"
     },
     "./client/capacitor": {
+      "types": "./types/client/capacitor.d.ts",
       "import": "./client/capacitor.ts",
-      "types": "./client/capacitor.ts",
       "default": "./client/capacitor.ts"
     },
     "./capacitor.base.config": {
+      "types": "./types/capacitor.base.config.d.ts",
       "import": "./capacitor.base.config.ts",
-      "types": "./capacitor.base.config.ts",
       "default": "./capacitor.base.config.ts"
     },
     "./webkit": {
+      "types": "./types/webkit/index.d.ts",
       "import": "./webkit/index.ts",
-      "types": "./webkit/index.ts",
       "default": "./webkit/index.ts"
     },
-    "./webkit/*": "./webkit/*",
+    "./webkit/*": {
+      "types": "./types/webkit/*.d.ts",
+      "import": "./webkit/*",
+      "default": "./webkit/*"
+    },
+    "./webkit/*.ts": {
+      "types": "./types/webkit/*.d.ts",
+      "import": "./webkit/*.ts",
+      "default": "./webkit/*.ts"
+    },
+    "./webkit/*.tsx": {
+      "types": "./types/webkit/*.d.ts",
+      "import": "./webkit/*.tsx",
+      "default": "./webkit/*.tsx"
+    },
     "./server": {
+      "types": "./types/server/index.d.ts",
       "import": "./server/index.ts",
-      "types": "./server/index.ts",
       "default": "./server/index.ts"
     },
     "./service": {
+      "types": "./types/service/index.d.ts",
       "import": "./service/index.ts",
-      "types": "./service/index.ts",
       "default": "./service/index.ts"
     },
     "./constant": {
+      "types": "./types/constant/index.d.ts",
       "import": "./constant/index.ts",
-      "types": "./constant/index.ts",
       "default": "./constant/index.ts"
     },
     "./dictionary": {
+      "types": "./types/dictionary/index.d.ts",
       "import": "./dictionary/index.ts",
-      "types": "./dictionary/index.ts",
       "default": "./dictionary/index.ts"
     },
     "./test": {
+      "types": "./types/test/index.d.ts",
       "import": "./test/index.ts",
-      "types": "./test/index.ts",
       "default": "./test/index.ts"
     },
     "./ui/styles.css": "./ui/styles.css",
     "./server/rsc-worker": {
+      "types": "./types/server/rscWorker.d.ts",
       "import": "./server/rscWorker.tsx",
-      "types": "./server/rscWorker.tsx",
       "default": "./server/rscWorker.tsx"
     }
   },
@@ -286,5 +328,6 @@
   },
   "engines": {
     "bun": ">=1.3.13"
-  }
-}
+  },
+  "main": "./index.ts"
+}

package/server/akanApp.ts

@@ -154,7 +154,7 @@ export class AkanApp {
     process.on("SIGINT", () => this.#handleShutdownSignal("SIGINT"));
     process.on("SIGTERM", () => this.#handleShutdownSignal("SIGTERM"));
     await new Promise<void>((resolve) => {
-      // Keep the orchestrator alive while child processes run.
+      
       this.#resolveStopped = resolve;
     });
   }
@@ -360,7 +360,6 @@ export class AkanApp {
     try {
       await rm(socketPath, { force: true });
     } catch {
-      // Best-effort cleanup for stale Unix sockets.
     }
   }
 
@@ -589,8 +588,7 @@ export class AkanApp {
 
   #proxyResponse(upstreamRes: Response): Response {
     const headers = new Headers(upstreamRes.headers);
-    // Bun fetch transparently decompresses upstream bodies but keeps these
-    // headers, which makes browsers try to decode an already-decoded payload.
+
     headers.delete("content-encoding");
     headers.delete("content-length");
     this.#rewriteInternalLocation(headers);
@@ -608,7 +606,6 @@ export class AkanApp {
       const parsed = new URL(location);
       if (parsed.hostname === "akan-child") headers.set("location", `${parsed.pathname}${parsed.search}${parsed.hash}`);
     } catch {
-      // Relative redirects are already safe to pass through.
     }
   }
 

package/server/akanLib.ts

@@ -19,7 +19,6 @@ export interface ServiceModule {
 export interface ScalarModule {
   constant: ScalarConstantModel;
   database: DatabaseCls;
-  // internal?: InternalCls;
 }
 
 export interface AkanLibProps {

package/server/akanServer.ts

@@ -41,8 +41,7 @@ interface AkanAppPrepared {
 
 export class AkanServer {
   status: "stopped" | "initializing" | "initialized" | "starting" | "running" | "stopping" = "stopped";
-  // Union the app-signal data shape with the HMR channel's data shape so
-  // `server.upgrade(...)` type-checks for both.
+
   #server: Bun.Server<{ createdAt: number } | HmrWsData> | null = null;
   #wsServer: Bun.Server<{ createdAt: number } | HmrWsData> | null = null;
   #prepared: AkanAppPrepared | null = null;
@@ -174,10 +173,10 @@ export class AkanServer {
         hmrState: webRouter ? { state: webRouter.renderState } : null,
         logger: this.logger,
       }),
-      // `data` is typed by the upgrade call site; the runtime default is unused.
+      
       data: {},
     } as Bun.WebSocketHandler<{ createdAt: number } | HmrWsData>;
-    // `builderRpc` lives in `#prepared` only so `stop()` can dispose it.
+    
     this.#server = Bun.serve({
       idleTimeout: 0,
       ...(unix ? { unix } : { port }),

package/server/artifact/builderRpc.ts

@@ -51,7 +51,7 @@ export class BuilderRpc {
       throw new Error("[builder] process.send unavailable — backend must be spawned by the CLI with ipc enabled");
     this.#send = this.#proc.send.bind(this.#proc);
     this.#offMessage = this.#listen((msg) => {
-      // Responses: look up the pending promise by id and settle.
+      
       if (msg.type === "build-route-res") {
         const res = msg as BuilderRes;
         const waiter = this.#pending.get(res.id);
@@ -61,7 +61,7 @@ export class BuilderRpc {
         else waiter.reject(new Error(`[builder] ${res.type} failed: ${res.error}`));
         return;
       }
-      // Broadcast events: dispatch to subscriber hooks.
+      
       const ev = msg as BuilderEvent;
       switch (ev.type) {
         case "builder-ready":

package/server/artifact/ipcTypes.ts

@@ -16,8 +16,6 @@ export interface CssPayload {
   changedFiles?: string[];
 }
 
-// --- backend → builder (request/response) -------------------------------
-
 export type BuilderReq = {
   type: "build-route";
   id: number;
@@ -31,8 +29,6 @@ export type BuilderRes =
   | { type: "build-route-res"; id: number; ok: true; data: BuildRouteResultPayload }
   | { type: "build-route-res"; id: number; ok: false; error: string };
 
-// --- builder → backend (unsolicited events) -----------------------------
-
 export interface PagesBundlePayload {
   bundlePath: string;
   buildId: number;

package/server/decorators.ts

@@ -1,4 +1,4 @@
-// TODO: Deprecate this decorators
+
 
 type DecoratedInstance = {
   logger?: { warn?: (message: string) => void; trace?: (message: string) => void };

package/server/di/diLifecycle.ts

@@ -94,12 +94,12 @@ export class DiLifecycle {
       });
       this.webProxies.push(...lib.option.getWebProxies());
       lib.database.forEach((mod) => {
-        //TODO: change enable as a function
+        
         if (!mod.service.srv.enabled) return;
         this.#database.set(mod.constant.refName, mod);
       });
       lib.service.forEach((mod) => {
-        //TODO: change enable as a function
+        
         if (!mod.service.srv.enabled) return;
         this.#service.set(mod.service.srv.refName, mod);
       });
@@ -144,7 +144,7 @@ export class DiLifecycle {
     };
   }
   async destroyAll() {
-    // 1. Run destroy internals (scheduled jobs, etc.)
+    
     const internalNow = Date.now();
     this.logger.verbose("Running destroy internals...");
     try {
@@ -154,19 +154,16 @@ export class DiLifecycle {
     }
     this.logger.verbose(`Destroy internals in ${Date.now() - internalNow}ms`);
 
-    // 2. Destroy services (reverse order)
     const serviceNow = Date.now();
     this.logger.verbose("Destroying services...");
     await this.destroyServices();
     this.logger.verbose(`Destroy services in ${Date.now() - serviceNow}ms`);
 
-    // 3. Destroy adaptors (reverse order)
     const adaptorNow = Date.now();
     this.logger.verbose("Destroying adaptors...");
     await this.destroyAdaptors();
     this.logger.verbose(`Destroy adaptors in ${Date.now() - adaptorNow}ms`);
 
-    // 4. Destroy external uses (SDK clients, API wrappers, etc.)
     const usesNow = Date.now();
     this.logger.verbose("Destroying uses...");
     await this.destroyUses();

package/server/hmr/clientScript.ts

@@ -1,20 +1,5 @@
-// Browser-side HMR client. Delivered as a classic inline <script> (appended
-// to the RSC bootstrap content) so it starts listening before any module
-// script runs. Keep it small and free of dependencies — we cannot rely on any
-// framework code being available when this executes.
-//
-// Protocol (see wsHub.ts `HmrMessage` for the TypeScript shape):
-//   { type: "hello", buildId, cssAssets }  → initial handshake on connect
-//   { type: "reload", buildId }          → full page refresh
-//   { type: "rsc-refresh", buildId }     → full page refresh
-//   { type: "client-refresh", buildId }  → full page refresh
-//   { type: "css-update", cssAssets }    → atomic current-subroute <link> swap, no reload
-//   { type: "error", message }           → forwarded build error, console only
-//
-// The server-rendered HTML tags the "active" stylesheet with
-// data-akan-css="active" (see rscWorker.tsx) so swapCss can remove the stale
-// one after the new stylesheet has finished loading without a flash of
-// unstyled content.
+
+
 export const HMR_CLIENT_SCRIPT = `(function(){
   if (self.__AKAN_HMR_INSTALLED__) return;
   self.__AKAN_HMR_INSTALLED__ = true;
@@ -34,8 +19,6 @@ export const HMR_CLIENT_SCRIPT = `(function(){
   var overlayJobs = {};
   self.__AKAN_HMR_PHASE__ = null;
 
-  // Bun's React Fast Refresh transform can emit top-level calls to these globals
-  // even when we fall back to full reload instead of applying React Refresh.
   self.$RefreshReg$ = self.$RefreshReg$ || function(){};
   self.$RefreshSig$ = self.$RefreshSig$ || function(){ return function(type){ return type; }; };
 
@@ -90,7 +73,6 @@ export const HMR_CLIENT_SCRIPT = `(function(){
     setTimeout(connect, delay);
   }
 
-  // goseoghyeon: CSR route registry keeps stale module refs, so JS/RSC HMR uses full reload for now.
   function reloadForHmr(msg){
     try { self.__AKAN_RSC_CLEAR_CACHE__ && self.__AKAN_RSC_CLEAR_CACHE__(); } catch(e){}
     if (msg && msg.buildId != null) lastBuildId = msg.buildId;

package/server/hmr/devHmrController.ts

@@ -363,9 +363,6 @@ export class DevHmrController {
     ];
     if (files.some((file) => runtimeRoots.some((needle) => path.resolve(file).includes(needle)))) return true;
 
-    // A route source file that is not in the current seed index is likely a
-    // newly added route/layout. The backend's route seed index is static for
-    // this process, so a full reload is the safer recovery path.
     return (
       routeIds === undefined &&
       files.some((file) => path.resolve(file).includes(`${path.sep}page${path.sep}`) && /\.(tsx|ts|jsx|js)$/.test(file))
@@ -382,7 +379,6 @@ export class DevHmrController {
       try {
         return new URL(`${protoFallback}://${hostFallback}`).origin;
       } catch {
-        /* fallthrough */
       }
     }
     return parsed.origin;

package/server/processMetricsCollector.ts

@@ -34,7 +34,7 @@ class EventLoopLagMonitor {
       if (this.#samples.length < EventLoopLagMonitor.#maxSamples) this.#samples.push(lag);
       else this.#samples[Math.floor(Math.random() * EventLoopLagMonitor.#maxSamples)] = lag;
     }, intervalMs);
-    // Do not keep the process alive solely for lag sampling.
+    
     (this.#timer as { unref?: () => void }).unref?.();
   }
 

package/server/resolver/database.resolver.ts

@@ -171,7 +171,7 @@ export class DatabaseResolver {
             select(select?: any) {
               return createFindManyChain(query, { ...options, select });
             },
-            // biome-ignore lint/suspicious/noThenProperty: model facade intentionally supports Mongoose-style awaitable queries.
+            
             then(resolve: (value: any[]) => void, reject: (reason: unknown) => void) {
               return store.find(query, options).then(resolve, reject);
             },
@@ -192,7 +192,7 @@ export class DatabaseResolver {
             select(select?: any) {
               return createFindOneChain(query, { ...options, select });
             },
-            // biome-ignore lint/suspicious/noThenProperty: model facade intentionally supports Mongoose-style awaitable queries.
+            
             then(resolve: (value: any | null) => void, reject: (reason: unknown) => void) {
               return store.findOne(query, options).then(resolve, reject);
             },

package/server/resolver/resolver.contract.fixture.ts

@@ -72,7 +72,6 @@ export class ServerResolverTestModelMixin {
     ServerResolverTestModelMixin.schemaTouched = true;
     schema.index({ category: 1 });
     schema.pre("create", () => {
-      //
     });
   }
   static modelKind() {

package/server/resolver/signal.resolver.ts

@@ -165,7 +165,6 @@ export class SignalResolver {
         const capitalizedKey = capitalize(key);
         const argLength = sliceInfo.args.length;
 
-        // List endpoint: ${refName}List${Capitalize<key>}
         const listKey = `${refName}List${capitalizedKey}`;
         endpointObj[listKey] = (builder as any)
           .query([sliceInfo.light], sliceInfo.signalOption)
@@ -189,7 +188,6 @@ export class SignalResolver {
             })) as any;
           });
 
-        // Insight endpoint: ${refName}Insight${Capitalize<key>}
         const insightKey = `${refName}Insight${capitalizedKey}`;
         endpointObj[insightKey] = (builder as any)
           .query(sliceInfo.insight, sliceInfo.signalOption)
@@ -203,7 +201,6 @@ export class SignalResolver {
           });
       });
 
-      // model endpoint: ${refName}
       endpointObj[refName] = (builder as any)
         .query(cnst.full, { guards: sliceCls.getGuards })
         .param(`${refName}Id`, ID)
@@ -211,7 +208,6 @@ export class SignalResolver {
           return await this[serviceName][`get${capitalizedRefName}`](id);
         });
 
-      // lightModel endpoint: light${Capitalize<refName>}
       endpointObj[`light${capitalizedRefName}`] = (builder as any)
         .query(cnst.light, { guards: sliceCls.getGuards })
         .param(`${refName}Id`, ID)
@@ -219,7 +215,6 @@ export class SignalResolver {
           return await this[serviceName][`get${capitalizedRefName}`](id);
         });
 
-      // createModel endpoint: create${Capitalize<refName>}
       endpointObj[`create${capitalizedRefName}`] = (builder as any)
         .mutation(cnst.full, { guards: sliceCls.cruGuards })
         .body("data", cnst.input)
@@ -227,7 +222,6 @@ export class SignalResolver {
           return await this[serviceName].__create(data);
         });
 
-      // updateModel endpoint: update${Capitalize<refName>}${Capitalize<key>}
       endpointObj[`update${capitalizedRefName}`] = (builder as any)
         .mutation(cnst.full, { guards: sliceCls.cruGuards })
         .param(`${refName}Id`, ID)
@@ -236,7 +230,6 @@ export class SignalResolver {
           return await this[serviceName].__update(id, data);
         });
 
-      // removeModel endpoint: remove${Capitalize<refName>}${Capitalize<key>}
       endpointObj[`remove${capitalizedRefName}`] = (builder as any)
         .mutation(cnst.full, { guards: sliceCls.cruGuards })
         .param(`${refName}Id`, ID)
@@ -321,7 +314,7 @@ export class SignalResolver {
               const roomCtxMap = SignalResolver.#liveWsPubsubRoomCtx.get(ws) ?? new Map();
               roomCtxMap.set(roomId, context);
               SignalResolver.#liveWsPubsubRoomCtx.set(ws, roomCtxMap);
-              // Track room membership in Redis for cross-server awareness
+              
               websocket.joinRoom(ws, roomId);
               SignalResolver.logger.verbose(`WebSocket subscribed to room ${roomId}`);
             } else {
@@ -335,7 +328,7 @@ export class SignalResolver {
                 }
                 roomCtxMap.delete(roomId);
                 if (roomCtxMap.size === 0) SignalResolver.#liveWsPubsubRoomCtx.delete(ws);
-                // Remove room membership from Redis
+                
                 websocket.leaveRoom(ws, roomId);
                 SignalResolver.logger.verbose(`WebSocket unsubscribed from room ${roomId}`);
               }
@@ -413,7 +406,6 @@ export class SignalResolver {
     }
     SignalResolver.#liveWsPubsubRoomCtx.delete(ws);
 
-    // Clean up socket from Redis
     await SignalResolver.#getWebsocket(registry).unregisterSocket(ws);
     SignalResolver.logger.verbose(`WebSocket disconnected from all rooms`);
   }

package/server/routing/apiRouter.ts

@@ -109,9 +109,7 @@ export class ApiRouter {
   }: WebsocketHandlersInputs): Bun.WebSocketHandler<WsTaggedData> {
     return {
       open: (ws) => {
-        // HMR sockets live in a separate logical channel from the app's signal
-        // websockets. We tag them via `data.kind === "akan-hmr"` at upgrade
-        // time so the dispatcher can skip signal handling.
+
         const data = ws.data as WsTaggedData | undefined;
         if (data?.kind === "akan-hmr" && hmrHub && hmrState) {
           hmrHub.attach(ws as unknown as Bun.ServerWebSocket<HmrWsData>);
@@ -128,7 +126,7 @@ export class ApiRouter {
       },
       message: async (ws, message) => {
         const data = ws.data as WsTaggedData | undefined;
-        if (data?.kind === "akan-hmr") return; // dev HMR is one-way (server→client)
+        if (data?.kind === "akan-hmr") return; 
         try {
           if (typeof message === "string") {
             const msg = JSON.parse(message) as WebsocketReqData;

package/server/rscClient.tsx

@@ -67,13 +67,7 @@ async function fetchRsc(href: string, options: { buildId?: number } = {}): Promi
     return { type: "redirected" };
   }
   if (!res.ok || !res.body) throw new Error(`[rscClient] RSC fetch failed ${res.status} ${res.statusText}`);
-  // Buffer the entire Flight payload before constructing the thenable. The root
-  // `use(thenable)` lives at the document root with no Suspense boundary above it
-  // (see Root / ssrFromRscRenderer), so any mid-render suspension during a client
-  // navigation transition has no fallback and can leave the transition stuck —
-  // committing only when a later navigation flushes the pending lane. Materializing
-  // the payload up front means all RSC rows are present and every referenced client
-  // module `import()` starts immediately, so the committed render does not suspend.
+
   const buffer = await res.arrayBuffer();
   const completeStream = new ReadableStream<Uint8Array>({
     start(controller) {