@datarails-ai/dr-cli 0.0.1-locked → 1.6.71

package/dist/chunk-DWMCBGQH.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+
+// src/api/kb.ts
+import { mkdir, writeFile } from "fs/promises";
+import { join, resolve } from "path";
+
+// src/api/_kbHtml.ts
+import { parse as parseHtml } from "node-html-parser";
+import TurndownService from "turndown";
+var turndown = new TurndownService({
+  headingStyle: "atx",
+  codeBlockStyle: "fenced"
+});
+function preserveIframes(html) {
+  const root = parseHtml(html);
+  for (const iframe of root.querySelectorAll("iframe")) {
+    const src = iframe.getAttribute("src");
+    if (src === void 0 || src === "") {
+      iframe.remove();
+      continue;
+    }
+    iframe.replaceWith(parseHtml(`<a href="${src}">Embedded video: ${src}</a>`));
+  }
+  return root.toString();
+}
+function toMarkdown(bodyHtml) {
+  if (bodyHtml === null || bodyHtml === void 0 || bodyHtml === "") {
+    return "";
+  }
+  return turndown.turndown(preserveIframes(bodyHtml)).trim();
+}
+function extractImageUrls(bodyHtml) {
+  if (bodyHtml === null || bodyHtml === void 0 || bodyHtml === "") {
+    return [];
+  }
+  const root = parseHtml(bodyHtml);
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const img of root.querySelectorAll("img")) {
+    const src = img.getAttribute("src");
+    if (src !== void 0 && src !== "" && !seen.has(src)) {
+      seen.add(src);
+      out.push(src);
+    }
+  }
+  return out;
+}
+
+// src/api/kb.ts
+var SUBDOMAIN = process.env.ZENDESK_SUBDOMAIN ?? "datarails";
+var BASE_URL = `https://${SUBDOMAIN}.zendesk.com/api/v2/help_center`;
+function authHeader() {
+  const email = process.env.ZENDESK_EMAIL;
+  const token = process.env.ZENDESK_API_TOKEN;
+  if (email !== void 0 && token !== void 0) {
+    const creds = Buffer.from(`${email}/token:${token}`).toString("base64");
+    return { Authorization: `Basic ${creds}` };
+  }
+  return {};
+}
+async function zget(url) {
+  return fetch(url, { headers: authHeader() });
+}
+function clamp(n, lo, hi) {
+  return Math.max(lo, Math.min(n, hi));
+}
+function toArticle(a) {
+  return {
+    id: a.id ?? 0,
+    title: a.title ?? "",
+    url: a.html_url ?? "",
+    section_id: a.section_id ?? 0,
+    updated_at: a.updated_at ?? "",
+    body: toMarkdown(a.body)
+  };
+}
+function toArticleMeta(a) {
+  return {
+    id: a.id ?? 0,
+    title: a.title ?? "",
+    url: a.html_url ?? "",
+    section_id: a.section_id ?? 0,
+    updated_at: a.updated_at ?? ""
+  };
+}
+async function search(args) {
+  const locale = args.locale ?? "en-us";
+  const limit = clamp(args.limit ?? 5, 1, 100);
+  const url = `${BASE_URL}/articles/search.json?query=${encodeURIComponent(args.query)}&locale=${encodeURIComponent(locale)}&per_page=${limit}`;
+  const r = await zget(url);
+  if (!r.ok) throw new Error(`HTTP ${r.status}`);
+  const data = await r.json();
+  return (data.results ?? []).slice(0, limit).map(toArticle);
+}
+async function fetchArticleRaw(articleId, locale) {
+  const r = await zget(`${BASE_URL}/${locale}/articles/${articleId}.json`);
+  if (r.status === 404) return null;
+  if (!r.ok) throw new Error(`HTTP ${r.status}`);
+  const data = await r.json();
+  return data.article ?? null;
+}
+async function getArticle(args) {
+  const raw = await fetchArticleRaw(args.article_id, args.locale ?? "en-us");
+  return raw !== null ? toArticle(raw) : null;
+}
+async function listCategories(args) {
+  const locale = args.locale ?? "en-us";
+  const r = await zget(`${BASE_URL}/${locale}/categories.json`);
+  if (!r.ok) throw new Error(`HTTP ${r.status}`);
+  const data = await r.json();
+  return (data.categories ?? []).map((c) => ({
+    id: c.id ?? 0,
+    name: c.name ?? "",
+    description: c.description ?? "",
+    url: c.html_url ?? ""
+  }));
+}
+async function listSections(args) {
+  const locale = args.locale ?? "en-us";
+  const limit = clamp(args.limit ?? 50, 1, 100);
+  const url = args.category_id !== void 0 ? `${BASE_URL}/${locale}/categories/${args.category_id}/sections.json?per_page=${limit}` : `${BASE_URL}/${locale}/sections.json?per_page=${limit}`;
+  const r = await zget(url);
+  if (!r.ok) throw new Error(`HTTP ${r.status}`);
+  const data = await r.json();
+  return (data.sections ?? []).slice(0, limit).map((s) => ({
+    id: s.id ?? 0,
+    name: s.name ?? "",
+    description: s.description ?? "",
+    category_id: s.category_id ?? 0,
+    url: s.html_url ?? ""
+  }));
+}
+async function listArticlesInSection(args) {
+  const locale = args.locale ?? "en-us";
+  const limit = clamp(args.limit ?? 25, 1, 100);
+  const include = args.include_bodies ?? false;
+  const r = await zget(
+    `${BASE_URL}/${locale}/sections/${args.section_id}/articles.json?per_page=${limit}`
+  );
+  if (!r.ok) throw new Error(`HTTP ${r.status}`);
+  const data = await r.json();
+  return (data.articles ?? []).slice(0, limit).map((a) => include ? toArticle(a) : toArticleMeta(a));
+}
+async function listRecentArticles(args) {
+  const days = args.days ?? 30;
+  const locale = args.locale ?? "en-us";
+  const limit = clamp(args.limit ?? 25, 1, 100);
+  const cutoff = Date.now() - days * 864e5;
+  const r = await zget(
+    `${BASE_URL}/${locale}/articles.json?sort_by=updated_at&sort_order=desc&per_page=${limit}`
+  );
+  if (!r.ok) throw new Error(`HTTP ${r.status}`);
+  const data = await r.json();
+  const out = [];
+  for (const a of data.articles ?? []) {
+    const t = a.updated_at !== void 0 ? Date.parse(a.updated_at) : NaN;
+    if (Number.isNaN(t)) continue;
+    if (t < cutoff) break;
+    out.push(toArticleMeta(a));
+    if (out.length >= limit) break;
+  }
+  return out;
+}
+async function getArticleAttachments(args) {
+  const locale = args.locale ?? "en-us";
+  const r = await zget(`${BASE_URL}/${locale}/articles/${args.article_id}/attachments.json`);
+  if (r.status === 404) return [];
+  if (!r.ok) throw new Error(`HTTP ${r.status}`);
+  const data = await r.json();
+  return (data.article_attachments ?? []).map((a) => ({
+    id: a.id ?? 0,
+    file_name: a.file_name ?? "",
+    content_type: a.content_type ?? "",
+    content_url: a.content_url ?? "",
+    size: a.size ?? 0,
+    inline: a.inline ?? false
+  }));
+}
+var MAX_IMAGE_BYTES = 5 * 1024 * 1024;
+var CONTENT_TYPE_TO_EXT = {
+  "image/png": "png",
+  "image/jpeg": "jpg",
+  "image/jpg": "jpg",
+  "image/gif": "gif",
+  "image/webp": "webp"
+};
+async function articleImages(args) {
+  const locale = args.locale ?? "en-us";
+  const limit = clamp(args.limit ?? 5, 1, 10);
+  const raw = await fetchArticleRaw(args.article_id, locale);
+  if (raw === null) return [];
+  const urls = extractImageUrls(raw.body).slice(0, limit);
+  if (urls.length === 0) return [];
+  const absOut = resolve(args.out_dir);
+  await mkdir(absOut, { recursive: true });
+  const results = [];
+  let idx = 0;
+  for (const url of urls) {
+    idx++;
+    try {
+      const r = await fetch(url, { redirect: "follow" });
+      if (!r.ok) {
+        results.push({ url, skippedReason: `HTTP ${r.status}` });
+        continue;
+      }
+      const ct = (r.headers.get("content-type") ?? "").split(";")[0]?.trim().toLowerCase() ?? "";
+      const ext = CONTENT_TYPE_TO_EXT[ct];
+      if (ext === void 0) {
+        results.push({ url, skippedReason: `unsupported type '${ct}'` });
+        continue;
+      }
+      const buf = Buffer.from(await r.arrayBuffer());
+      if (buf.length > MAX_IMAGE_BYTES) {
+        results.push({
+          url,
+          skippedReason: `${buf.length} bytes > 5 MB cap`
+        });
+        continue;
+      }
+      const filename = `${args.article_id}-${idx}.${ext}`;
+      const filePath = join(absOut, filename);
+      await writeFile(filePath, buf);
+      results.push({ url, path: filePath });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      results.push({ url, skippedReason: msg });
+    }
+  }
+  return results;
+}
+
+export {
+  extractImageUrls,
+  search,
+  getArticle,
+  listCategories,
+  listSections,
+  listArticlesInSection,
+  listRecentArticles,
+  getArticleAttachments,
+  articleImages
+};