@blaaiz/docs-core 0.2.0 → 0.4.0

package/dist/{chunk-3ZX4WIE3.js → chunk-JHN5XQPU.js}

@@ -1544,6 +1544,20 @@ function dirname(file) {
   const i = file.lastIndexOf("/");
   return i === -1 ? "" : file.slice(0, i);
 }
+function firstDocFile(items) {
+  for (const item of items) {
+    if (item.kind === "doc") {
+      return item.file;
+    }
+    if (item.kind === "group") {
+      const found = firstDocFile(item.items);
+      if (found !== void 0) {
+        return found;
+      }
+    }
+  }
+  return void 0;
+}
 function planDocsTree(navigation, options = {}) {
   const apiDir = options.apiDir ?? "api";
   const specs = [];
@@ -1551,6 +1565,9 @@ function planDocsTree(navigation, options = {}) {
   const apiGroups = [];
   const metas = [];
   const rootPages = [];
+  const apiTabDocPages = [];
+  const apiTabs = navigation.filter((tab) => hasOpenApi(tab.items));
+  const soleApiTab = apiTabs.length === 1;
   for (const tab of navigation) {
     if (hasOpenApi(tab.items)) {
       planApiTab(tab);
@@ -1559,38 +1576,52 @@ function planDocsTree(navigation, options = {}) {
     planDocTab(tab);
   }
   metas.unshift({ path: "meta.json", content: { pages: rootPages } });
-  return { specs, apiPages, apiGroups, metas };
+  return { specs, apiPages, apiGroups, metas, apiTabDocPages };
   function planApiTab(tab) {
-    rootPages.push(apiDir);
-    const groupDirs = [];
-    for (const item of tab.items) {
-      if (item.kind !== "group") {
+    const tabDir = soleApiTab ? apiDir : slugify(tab.title);
+    rootPages.push(tabDir);
+    const at = apiGroups.length;
+    const children = planApiItems(tab.items, tabDir);
+    apiGroups.splice(at, 0, {
+      dir: tabDir,
+      title: tab.title,
+      root: true,
+      ...tab.icon ? { icon: tab.icon } : {},
+      children
+    });
+  }
+  function planApiItems(items, dir) {
+    const children = [];
+    const takenFolders = /* @__PURE__ */ new Set();
+    let order = 0;
+    for (const item of items) {
+      if (item.kind === "group") {
+        const folder = slugify(item.title);
+        if (takenFolders.has(folder)) {
+          throw new Error(
+            `[docs-core] Two sibling groups under '${dir}' share the folder name '${folder}'. Rename one of the groups in docs.json.`
+          );
+        }
+        takenFolders.add(folder);
+        const childDir = `${dir}/${folder}`;
+        const at = apiGroups.length;
+        const sub = planApiItems(item.items, childDir);
+        apiGroups.splice(at, 0, { dir: childDir, title: item.title, children: sub });
+        children.push({ order, folder });
+        order += 1;
         continue;
       }
-      const dir = `${apiDir}/${slugify(item.title)}`;
-      groupDirs.push(slugify(item.title));
-      apiGroups.push({ dir, title: item.title });
-      let order = 0;
-      for (const page of item.items) {
-        if (page.kind !== "openapi") {
-          continue;
-        }
-        if (!specs.includes(page.file)) {
-          specs.push(page.file);
+      if (item.kind === "openapi") {
+        if (!specs.includes(item.file)) {
+          specs.push(item.file);
         }
-        apiPages.push({ file: page.file, method: page.method, apiPath: page.apiPath, dir, order });
+        apiPages.push({ file: item.file, method: item.method, apiPath: item.apiPath, dir, order });
         order += 1;
+        continue;
       }
+      apiTabDocPages.push(item.file);
     }
-    metas.push({
-      path: `${apiDir}/meta.json`,
-      content: {
-        title: tab.title,
-        root: true,
-        ...tab.icon ? { icon: tab.icon } : {},
-        pages: groupDirs
-      }
-    });
+    return children;
   }
   function planDocTab(tab) {
     const directPages = tab.items.filter((item) => item.kind === "doc");
@@ -1601,36 +1632,58 @@ function planDocsTree(navigation, options = {}) {
       }
       return;
     }
-    const firstFile = directPages[0]?.file ?? groups.flatMap((g) => g.items).find((item) => item.kind === "doc")?.file;
+    const firstFile = firstDocFile(tab.items);
     if (firstFile === void 0) {
       return;
     }
     const tabDir = firstFile.split("/")[0] ?? "";
     rootPages.push(tabDir);
-    const tabPages = directPages.map((page) => basename(page.file));
-    for (const group of groups) {
-      const pages = group.items.filter((item) => item.kind === "doc");
-      const groupDir = dirname(pages[0]?.file ?? "");
-      const folder = groupDir.split("/").slice(1).join("/");
-      if (folder === "") {
-        tabPages.push(...pages.map((page) => basename(page.file)));
-        continue;
-      }
-      tabPages.push(folder);
-      metas.push({
-        path: `${groupDir}/meta.json`,
-        content: { title: group.title, pages: pages.map((page) => basename(page.file)) }
-      });
-    }
     metas.push({
       path: `${tabDir}/meta.json`,
       content: {
         title: tab.title,
         root: true,
         ...tab.icon ? { icon: tab.icon } : {},
-        pages: tabPages
+        pages: planDocItems(tab.items, tabDir)
+      }
+    });
+  }
+  function planDocItems(items, dir) {
+    const entries = [];
+    for (const item of items) {
+      if (item.kind === "doc") {
+        entries.push(basename(item.file));
+        continue;
+      }
+      if (item.kind !== "group") {
+        continue;
+      }
+      const groupDir = planDocGroup(item, dir);
+      if (groupDir === null) {
+        continue;
+      }
+      if (groupDir === dir) {
+        entries.push(...planDocItems(item.items, dir));
+        continue;
       }
+      entries.push(groupDir.slice(dir.length + 1));
+    }
+    return entries;
+  }
+  function planDocGroup(group, dir) {
+    const firstFile = firstDocFile(group.items);
+    if (firstFile === void 0) {
+      return null;
+    }
+    const groupDir = dirname(firstFile);
+    if (groupDir === dir || groupDir === "") {
+      return dir;
+    }
+    metas.push({
+      path: `${groupDir}/meta.json`,
+      content: { title: group.title, pages: planDocItems(group.items, groupDir) }
     });
+    return groupDir;
   }
 }
 
@@ -2526,6 +2579,92 @@ function createSignOut(options = {}) {
   };
 }
 
+// src/core/auth/site-auth.ts
+var notConfigured = () => new Response("This sign-in method is not configured for this site.", { status: 501 });
+var PUBLIC_SITE = {
+  enabled: false,
+  signInPath: "/signin",
+  secretEnabled: false,
+  googleEnabled: false,
+  emailSignIn: () => Promise.resolve(notConfigured()),
+  secretSignIn: () => Promise.resolve(notConfigured()),
+  google: {
+    start: () => notConfigured(),
+    callback: () => Promise.resolve(notConfigured())
+  }
+};
+function createSiteAuth(auth, options = {}) {
+  if (auth === "public") {
+    return {
+      ...PUBLIC_SITE,
+      gate: () => Promise.resolve(null),
+      signOut: createSignOut()
+    };
+  }
+  return workspaceSiteAuth(auth, options);
+}
+function workspaceSiteAuth(auth, options) {
+  const env = options.env ?? ((name) => process.env[name]);
+  const signInPath = auth.signInPath ?? "/signin";
+  const secure = auth.secureCookies ?? true;
+  const ttlSeconds = auth.sessionTtlSeconds;
+  const sessionSecretEnv = auth.sessionSecretEnv ?? "DOCS_SESSION_SECRET";
+  const secret = env(sessionSecretEnv) ?? "";
+  if (secret === "") {
+    throw new DocsConfigError(
+      `auth.mode is 'workspace': set the ${sessionSecretEnv} environment variable to a long random value (for example: openssl rand -hex 32).`
+    );
+  }
+  const shared = {
+    secret,
+    allowedDomains: auth.allowedDomains,
+    secureCookies: secure,
+    signInPath,
+    ...ttlSeconds === void 0 ? {} : { ttlSeconds }
+  };
+  const emailEnabled = auth.providers.email === true;
+  const accessSecret = auth.providers.secret ? env(auth.providers.secret.secretEnv ?? "DOCS_ACCESS_SECRET") ?? "" : "";
+  const secretEnabled = accessSecret !== "";
+  const googleConfig = auth.providers.google;
+  const clientId = googleConfig ? env(googleConfig.clientIdEnv ?? "GOOGLE_CLIENT_ID") : void 0;
+  const clientSecret = googleConfig ? env(googleConfig.clientSecretEnv ?? "GOOGLE_CLIENT_SECRET") : void 0;
+  const googleEnabled = Boolean(googleConfig && clientId && clientSecret);
+  const emailSignIn = emailEnabled ? createEmailSignIn(shared) : null;
+  const secretSignIn = secretEnabled ? createSecretSignIn({ ...shared, accessSecret }) : null;
+  const googleFor = (request) => {
+    if (!googleEnabled || !googleConfig || !clientId || !clientSecret) {
+      return null;
+    }
+    const origin = new URL(request.url).origin;
+    const redirectPath = googleConfig.redirectPath ?? "/api/auth/google/callback";
+    return createGoogleAuth({
+      ...shared,
+      clientId,
+      clientSecret,
+      redirectUri: `${origin}${redirectPath}`
+    });
+  };
+  return {
+    enabled: true,
+    signInPath,
+    secretEnabled,
+    googleEnabled,
+    gate: createAuthGate({
+      secret,
+      allowedDomains: auth.allowedDomains,
+      signInPath,
+      publicPaths: [...options.publicPaths ?? ["/api/proxy"]]
+    }),
+    emailSignIn: (request) => emailSignIn?.(request) ?? Promise.resolve(notConfigured()),
+    secretSignIn: (request) => secretSignIn?.(request) ?? Promise.resolve(notConfigured()),
+    google: {
+      start: (request) => googleFor(request)?.start(request) ?? notConfigured(),
+      callback: (request) => googleFor(request)?.callback(request) ?? Promise.resolve(notConfigured())
+    },
+    signOut: createSignOut({ secureCookies: secure, redirectTo: signInPath })
+  };
+}
+
 // src/core/proxy.ts
 var DEFAULT_RATE_LIMIT_PER_MINUTE2 = 60;
 var ProxyTargetError = class extends Error {
@@ -2979,6 +3118,6 @@ function mergeOpenApiDocuments(inputs, options) {
   };
 }
 
-export { AI_PROVIDER_MODELS, AI_PROVIDER_NAMES, AiConfigError, DocsConfigError, InvalidNavigationError, OpenApiMergeError, ProxyTargetError, SESSION_COOKIE, assertAllowedTarget, buildMetadata, buildRobots, buildSearchIndex, buildSessionCookie, buildSitemap, buildThemeCss, clearSessionCookie, createAskAiRoute, createAuthGate, createEmailSignIn, createGoogleAuth, createMarkdownRoute, createSecretSignIn, createSignOut, createTryItProxy, createTryItProxyRoute, defineDocsConfig, isAllowedEmail, mdxToMarkdown, mergeOpenApiDocuments, openApiOperationToMarkdown, parseNavigation, planDocsTree, readCookie, resolveAiConfig, searchIndex, signSession, unwrapProxyTarget, validateDocsConfig, verifySession };
-//# sourceMappingURL=chunk-3ZX4WIE3.js.map
-//# sourceMappingURL=chunk-3ZX4WIE3.js.map
+export { AI_PROVIDER_MODELS, AI_PROVIDER_NAMES, AiConfigError, DocsConfigError, InvalidNavigationError, OpenApiMergeError, ProxyTargetError, SESSION_COOKIE, assertAllowedTarget, buildMetadata, buildRobots, buildSearchIndex, buildSessionCookie, buildSitemap, buildThemeCss, clearSessionCookie, createAskAiRoute, createAuthGate, createEmailSignIn, createGoogleAuth, createMarkdownRoute, createSecretSignIn, createSignOut, createSiteAuth, createTryItProxy, createTryItProxyRoute, defineDocsConfig, isAllowedEmail, mdxToMarkdown, mergeOpenApiDocuments, openApiOperationToMarkdown, parseNavigation, planDocsTree, readCookie, resolveAiConfig, searchIndex, signSession, unwrapProxyTarget, validateDocsConfig, verifySession };
+//# sourceMappingURL=chunk-JHN5XQPU.js.map
+//# sourceMappingURL=chunk-JHN5XQPU.js.map