@palbase/backend 24.3.0 → 25.0.0

package/dist/openapi/index.js

@@ -1,12 +1,13 @@
 import {
   getErrorRegistry
-} from "../chunk-ERDL5VAE.js";
+} from "../chunk-5CMLOAEF.js";
 import {
+  getRoom,
   getRoutes,
   isController,
   resolveController,
   resolveEffectiveAuth
-} from "../chunk-UWSYTUGM.js";
+} from "../chunk-ZQRWW37O.js";
 import {
   __commonJS,
   __require,
@@ -5832,6 +5833,9 @@ var DEFAULT_IGNORE = [
   "**/node_modules/**"
 ];
 function flattenController(controller) {
+  if (getRoom(controller) !== void 0 && !isController(controller)) {
+    return [];
+  }
   const meta = resolveController(controller);
   const controllerName = deriveControllerName(controller.name);
   const routes = getRoutes(controller);
@@ -6161,6 +6165,44 @@ function isRefinedSchema(schema) {
   if (!typeName) return false;
   return typeName === "ZodEffects" || typeName === "ZodPreprocess" || typeName === "ZodTransform";
 }
+function firstUntypedField(schema) {
+  const shape = schema?.shape;
+  if (!shape) return void 0;
+  for (const [field, sub] of Object.entries(shape)) {
+    const kind = sub?._def?.typeName;
+    if (kind === "ZodUnknown" || kind === "ZodAny") return field;
+  }
+  return void 0;
+}
+function assertRoomFieldsTyped(pattern, room) {
+  for (const [event, schema] of Object.entries(room.events)) {
+    const field = firstUntypedField(schema);
+    if (field !== void 0) {
+      throw new Error(
+        `@Room("${pattern}") event "${event}" has an untyped field "${field}". An untyped payload makes every generated client opaque \u2014 declare its shape.`
+      );
+    }
+  }
+  for (const [message, meta] of Object.entries(room.messages)) {
+    const field = firstUntypedField(meta.schema);
+    if (field !== void 0) {
+      throw new Error(
+        `@Room("${pattern}") message "${message}" has an untyped field "${field}". Inbound payloads reach the server \u2014 declare the shape so it can be validated.`
+      );
+    }
+  }
+}
+function roomExtension(room, register) {
+  const events = {};
+  for (const [name, schema] of Object.entries(room.events)) {
+    events[name] = { $ref: register(name, schema) };
+  }
+  const messages = {};
+  for (const [name, meta] of Object.entries(room.messages)) {
+    messages[name] = { $ref: register(name, meta.schema) };
+  }
+  return { events, messages, graceMs: room.graceMs };
+}
 
 // src/openapi/aggregate.ts
 extendZodWithOpenApi2(z2);
@@ -6186,6 +6228,18 @@ async function aggregateOpenAPI(projectRoot, options = {}) {
     registerControllerRoute(registry, route);
   }
   const generator = new OpenApiGeneratorV312(registry.definitions);
+  const roomExt = {};
+  for (const lc of loadedControllers) {
+    const room = getRoom(lc.controller);
+    if (room === void 0) continue;
+    assertRoomFieldsTyped(room.pattern, room);
+    const slug = room.pattern.replace(/[^A-Za-z0-9]+/g, "_").replace(/^_|_$/g, "");
+    roomExt[room.pattern] = roomExtension(room, (name, schema) => {
+      const componentName = `Room_${slug}_${name}`;
+      registry.register(componentName, schema);
+      return `#/components/schemas/${componentName}`;
+    });
+  }
   const document = generator.generateDocument({
     openapi: "3.2.0",
     info: {
@@ -6194,6 +6248,9 @@ async function aggregateOpenAPI(projectRoot, options = {}) {
       description: "Auto-generated from class controllers (@Controller/@Get/@Post + @Body/@QueryParams/@Param) Zod schemas + method return types at deploy time. Do not edit by hand."
     }
   });
+  if (Object.keys(roomExt).length > 0) {
+    document["x-palbase-room"] = roomExt;
+  }
   return {
     document,
     endpointCount: controllerRoutes.length,