@objectstack/rest 9.5.1 → 9.6.0

package/dist/index.cjs

@@ -1586,6 +1586,56 @@ var RestServer = class {
           tags: ["metadata"]
         }
       });
+      this.routeManager.register({
+        method: "GET",
+        path: `${metaPath}/book/:name/tree`,
+        handler: async (req, res) => {
+          try {
+            const environmentId = isScoped ? req.params?.environmentId : void 0;
+            const prot = await this.resolveProtocol(environmentId, req);
+            const locale = this.extractLocale(req);
+            const packageId = req.query?.package || void 0;
+            const { resolveBookTree, deriveImplicitPackageBook, isPublicAudience, resolveDocLocale } = await import("@objectstack/spec/system");
+            const norm = (raw) => Array.isArray(raw) ? raw : raw && Array.isArray(raw.items) ? raw.items : [];
+            const books = norm(await prot.getMetaItems({
+              type: "book",
+              ...packageId ? { packageId } : {},
+              ...environmentId ? { environmentId } : {}
+            }));
+            let book = books.find((b) => b && b.name === req.params.name);
+            if (!book) {
+              book = deriveImplicitPackageBook(req.params.name, req.params.name);
+            }
+            const ctx = await this.resolveExecCtx(environmentId, req).catch(() => void 0);
+            if (!ctx?.userId && !isPublicAudience(book.audience)) {
+              sendError(res, { code: "unauthorized", message: "This documentation requires sign-in", status: 401 });
+              return;
+            }
+            const docs = norm(await prot.getMetaItems({
+              type: "doc",
+              ...packageId ? { packageId } : {},
+              ...environmentId ? { environmentId } : {}
+            })).map((d) => d && typeof d === "object" ? resolveDocLocale(d, locale) : d).map((d) => ({
+              name: d.name,
+              label: d.label,
+              description: d.description,
+              order: d.order,
+              group: d.group,
+              tags: d.tags,
+              packageId: d._packageId
+            }));
+            const tree = resolveBookTree(book, docs, book._packageId);
+            res.json(tree);
+          } catch (error) {
+            logError("[REST] Unhandled error:", error);
+            sendError(res, error);
+          }
+        },
+        metadata: {
+          summary: "Resolve a documentation book spine into its rendered tree (ADR-0046 \xA76)",
+          tags: ["metadata"]
+        }
+      });
       this.routeManager.register({
         method: "GET",
         path: `${metaPath}/:type/:name`,