@docupace/pipeline 1.0.77-alpha.2 → 1.0.77

package/src/changeset/changelog-wiki.js

@@ -1,328 +1,328 @@
-// npm i axios
-import axios from 'axios';
-import { readFileSync } from 'fs';
-import { getPackageNames } from './package-util.js';
-import path from 'path';
-import { toShortVersion } from './version.js';
-
-/**
- * Required env:
- *   CONFLUENCE_BASE_URL   e.g. "https://docupacellc.atlassian.net/wiki"
- *   CONFLUENCE_EMAIL      e.g. "you@docupace.com"
- *   CONFLUENCE_API_TOKEN  Atlassian API token
- */
-const BASE_URL = process.env.CONFLUENCE_BASE_URL;
-const EMAIL = process.env.CONFLUENCE_EMAIL;
-const API_TOKEN = process.env.CONFLUENCE_API_TOKEN;
-
-const getHttpService = () =>
-  axios.create({
-    baseURL: BASE_URL.replace(/\/+$/, ''),
-    auth: { username: EMAIL, password: API_TOKEN },
-  });
-
-/** ---------- ADF builder: Markdown macro ---------- */
-function adfMarkdown(markdown) {
-  return {
-    type: 'doc',
-    version: 1,
-    content: [
-      {
-        type: 'extension',
-        attrs: {
-          layout: 'default',
-          extensionType: 'com.atlassian.confluence.macro.core',
-          extensionKey: 'markdown',
-          parameters: {
-            macroParams: {
-              sourceType: { value: 'MacroBody' },
-              darkmode: { value: 'auto' },
-              syntax: { value: 'Markdown' },
-              attachmentPageId: { value: '' },
-              attachmentId: { value: '' },
-              url: { value: '' },
-              __bodyContent: { value: markdown },
-            },
-          },
-        },
-      },
-    ],
-  };
-}
-
-/** ---------- API helpers (v2) ---------- */
-
-// get a page (v2) by id
-async function getPage(pageId) {
-  const { data } = await getHttpService().get(`/api/v2/pages/${pageId}`);
-  return data;
-}
-
-// list child pages (paginated) and return *all* children
-async function listChildPages(parentId) {
-  const all = [];
-  let next = `/api/v2/pages/${parentId}/children?limit=200`;
-
-  while (next) {
-    const { data } = await getHttpService().get(next);
-    if (Array.isArray(data.results)) all.push(...data.results);
-    next = data?._links?.next || null;
-  }
-  return all;
-}
-
-// find a direct child page by exact title
-async function findChildByTitle(parentId, title) {
-  const kids = await listChildPages(parentId);
-  return kids.find((p) => (p.title || '').trim() === title.trim()) || null;
-}
-
-// create a child page under a parent
-async function createChildPage({
-  parentId,
-  spaceId,
-  title,
-  adf,
-  message = 'Create via API',
-}) {
-  const payload = {
-    status: 'current',
-    title,
-    spaceId,
-    parentId,
-    body: {
-      atlas_doc_format: {
-        value: adf,
-        representation: 'atlas_doc_format',
-      },
-    },
-    version: { number: 1, message, minorEdit: false },
-  };
-  const { data } = await getHttpService().post(`/api/v2/pages`, payload);
-  return data;
-}
-
-// update an existing page (replace body + optionally title)
-async function updatePage({
-  page,
-  title = page.title,
-  adf,
-  message = 'Update via API',
-}) {
-  if (!page.version) {
-    page = await getPage(page.id);
-  }
-  const payload = {
-    id: page.id,
-    status: 'current',
-    title,
-    spaceId: page.spaceId,
-    body: {
-      atlas_doc_format: {
-        value: adf,
-        representation: 'atlas_doc_format',
-      },
-    },
-    version: {
-      number: page.version.number + 1,
-      message,
-      minorEdit: false,
-    },
-  };
-  const { data } = await getHttpService().put(
-    `/api/v2/pages/${page.id}`,
-    payload,
-  );
-  return data;
-}
-
-const childPagesAdf = {
-  type: 'doc',
-  version: 1,
-  content: [
-    {
-      type: 'extension',
-      attrs: {
-        extensionType: 'com.atlassian.confluence.macro.core',
-        extensionKey: 'children',
-        layout: 'default',
-        parameters: {
-          macroParams: {
-            allChildren: { value: 'true' },
-          },
-          macroMetadata: {
-            macroId: { value: '9ea4beb6-ac0a-42d7-baf1-e8e6eca01bfd' },
-            schemaVersion: { value: '2' },
-            title: { value: 'Child pages' },
-          },
-        },
-        localId: '4890f00c-c519-4947-a60c-0c3b7e1c7b72',
-      },
-    },
-  ],
-};
-
-/** ---------- Main upsert workflow ---------- */
-
-/**
- * Upsert release notes at: Versions(parent) -> Version(title) -> Component(title)
- *
- * @param {object} args
- * @param {string} args.versionsParentId - Page ID of the "Versions" page
- * @param {string} args.versionTitle     - e.g. "Version 1"
- * @param {string} args.componentTitle   - e.g. "Component A"
- * @param {string} args.markdown         - Release notes markdown for the component page
- *
- * @returns {Promise<{versionPage:any, componentPage:any}>}
- */
-export async function upsertReleaseNotes({
-  versionsParentId,
-  version,
-  component,
-  markdown,
-  group,
-}) {
-  if (!BASE_URL || !EMAIL || !API_TOKEN) {
-    throw new Error(
-      'Missing required env: CONFLUENCE_BASE_URL, CONFLUENCE_EMAIL, CONFLUENCE_API_TOKEN',
-    );
-  }
-
-  if (!versionsParentId || !version || !component) {
-    throw new Error(
-      'versionsParentId, versionTitle, and componentTitle are required',
-    );
-  }
-
-  if (!markdown || markdown.trim() === '') {
-    throw new Error('markdown content is required and cannot be empty');
-  }
-
-  // 1) fetch the parent to get spaceId
-  const parent = await getPage(versionsParentId);
-  const spaceId = parent.spaceId;
-
-  const versionTitle = `Docupace ${group} - Version ${version}`;
-  // 2) ensure Version page under parent
-  let versionPage = await findChildByTitle(parent.id, versionTitle);
-  if (!versionPage) {
-    versionPage = await createChildPage({
-      parentId: parent.id,
-      spaceId,
-      title: versionTitle,
-      adf: JSON.stringify(childPagesAdf),
-      message: `Create version page ${versionTitle}`,
-    });
-  }
-
-  const componentTitle = `${versionTitle} - ${component} Changelog`;
-
-  // 3) ensure Component page under Version
-  let componentPage = await findChildByTitle(versionPage.id, componentTitle);
-  const adf = adfMarkdown(markdown);
-
-  if (!componentPage) {
-    componentPage = await createChildPage({
-      parentId: versionPage.id,
-      spaceId,
-      title: componentTitle,
-      adf: JSON.stringify(adf),
-      message: `Create component page ${componentTitle}`,
-    });
-  } else {
-    // update existing component page with new markdown
-    componentPage = await updatePage({
-      page: componentPage,
-      title: componentTitle,
-      adf: JSON.stringify(adf),
-      message: `Update component page ${componentTitle}`,
-    });
-  }
-
-  return { versionPage, componentPage };
-}
-
-/**
- * Upsert release notes from a markdown file
- *
- * @param {object} args
- * @param {string} args.versionTitle     - e.g. "Version 1"
- * @param {string} args.componentTitle   - e.g. "Component A"
- * @param {string} args.markdownFile     - Path to markdown file
- *
- * @returns {Promise<{versionPage:any, componentPage:any}>}
- */
-export async function upsertReleaseNotesFromFile({
-  version,
-  component,
-  markdownFile,
-  group,
-}) {
-  if (!group) {
-    throw new Error('changelog.group must be specified in package.json');
-  }
-
-  const versionsParentId =
-    process.env[`CONFLUENCE_${group.toUpperCase()}_PARENT_ID`];
-
-  if (!versionsParentId) {
-    throw new Error(
-      `CONFLUENCE_${group.toUpperCase()}_PARENT_ID environment variable is required`,
-    );
-  }
-
-  if (!markdownFile) {
-    throw new Error('markdownFile is required');
-  }
-
-  // Read markdown content from file
-  const markdown = readFileSync(markdownFile, 'utf8');
-
-  return upsertReleaseNotes({
-    versionsParentId,
-    version,
-    component,
-    markdown,
-    group,
-  });
-}
-
-export async function updateWikiWithVersion(releases) {
-  const packageNames = getPackageNames();
-  console.log(releases);
-
-  const promises = packageNames
-    .filter(
-      (packageName) =>
-        releases.find((release) => release.name == packageName.name) &&
-        packageName.content?.changelog?.component,
-    )
-    .map(async (packageName) => {
-      try {
-        const release = releases.find(
-          (release) => release.name == packageName.name,
-        );
-        await upsertReleaseNotesFromFile({
-          version: toShortVersion(release.newVersion),
-          component: packageName.content.changelog?.component,
-          markdownFile: path.join(packageName.path, 'CHANGELOG.md'),
-          group: packageName.content.changelog?.group,
-        });
-        console.log(`✅ Successfully updated wiki for ${packageName.name}`);
-      } catch (error) {
-        console.error(
-          `❌ Failed to update wiki for ${packageName.name}:`,
-          error.message,
-        );
-        // Continue with other packages instead of stopping the build
-      }
-    });
-
-  try {
-    await Promise.all(promises);
-    console.log('✅ Wiki update process completed');
-  } catch (error) {
-    console.error('❌ Error during wiki update process:', error.message);
-    // Don't throw the error to prevent build failure
-  }
-}
+// npm i axios
+import axios from 'axios';
+import { readFileSync } from 'fs';
+import { getPackageNames } from './package-util.js';
+import path from 'path';
+import { toShortVersion } from './version.js';
+
+/**
+ * Required env:
+ *   CONFLUENCE_BASE_URL   e.g. "https://docupacellc.atlassian.net/wiki"
+ *   CONFLUENCE_EMAIL      e.g. "you@docupace.com"
+ *   CONFLUENCE_API_TOKEN  Atlassian API token
+ */
+const BASE_URL = process.env.CONFLUENCE_BASE_URL;
+const EMAIL = process.env.CONFLUENCE_EMAIL;
+const API_TOKEN = process.env.CONFLUENCE_API_TOKEN;
+
+const getHttpService = () =>
+  axios.create({
+    baseURL: BASE_URL.replace(/\/+$/, ''),
+    auth: { username: EMAIL, password: API_TOKEN },
+  });
+
+/** ---------- ADF builder: Markdown macro ---------- */
+function adfMarkdown(markdown) {
+  return {
+    type: 'doc',
+    version: 1,
+    content: [
+      {
+        type: 'extension',
+        attrs: {
+          layout: 'default',
+          extensionType: 'com.atlassian.confluence.macro.core',
+          extensionKey: 'markdown',
+          parameters: {
+            macroParams: {
+              sourceType: { value: 'MacroBody' },
+              darkmode: { value: 'auto' },
+              syntax: { value: 'Markdown' },
+              attachmentPageId: { value: '' },
+              attachmentId: { value: '' },
+              url: { value: '' },
+              __bodyContent: { value: markdown },
+            },
+          },
+        },
+      },
+    ],
+  };
+}
+
+/** ---------- API helpers (v2) ---------- */
+
+// get a page (v2) by id
+async function getPage(pageId) {
+  const { data } = await getHttpService().get(`/api/v2/pages/${pageId}`);
+  return data;
+}
+
+// list child pages (paginated) and return *all* children
+async function listChildPages(parentId) {
+  const all = [];
+  let next = `/api/v2/pages/${parentId}/children?limit=200`;
+
+  while (next) {
+    const { data } = await getHttpService().get(next);
+    if (Array.isArray(data.results)) all.push(...data.results);
+    next = data?._links?.next || null;
+  }
+  return all;
+}
+
+// find a direct child page by exact title
+async function findChildByTitle(parentId, title) {
+  const kids = await listChildPages(parentId);
+  return kids.find((p) => (p.title || '').trim() === title.trim()) || null;
+}
+
+// create a child page under a parent
+async function createChildPage({
+  parentId,
+  spaceId,
+  title,
+  adf,
+  message = 'Create via API',
+}) {
+  const payload = {
+    status: 'current',
+    title,
+    spaceId,
+    parentId,
+    body: {
+      atlas_doc_format: {
+        value: adf,
+        representation: 'atlas_doc_format',
+      },
+    },
+    version: { number: 1, message, minorEdit: false },
+  };
+  const { data } = await getHttpService().post(`/api/v2/pages`, payload);
+  return data;
+}
+
+// update an existing page (replace body + optionally title)
+async function updatePage({
+  page,
+  title = page.title,
+  adf,
+  message = 'Update via API',
+}) {
+  if (!page.version) {
+    page = await getPage(page.id);
+  }
+  const payload = {
+    id: page.id,
+    status: 'current',
+    title,
+    spaceId: page.spaceId,
+    body: {
+      atlas_doc_format: {
+        value: adf,
+        representation: 'atlas_doc_format',
+      },
+    },
+    version: {
+      number: page.version.number + 1,
+      message,
+      minorEdit: false,
+    },
+  };
+  const { data } = await getHttpService().put(
+    `/api/v2/pages/${page.id}`,
+    payload,
+  );
+  return data;
+}
+
+const childPagesAdf = {
+  type: 'doc',
+  version: 1,
+  content: [
+    {
+      type: 'extension',
+      attrs: {
+        extensionType: 'com.atlassian.confluence.macro.core',
+        extensionKey: 'children',
+        layout: 'default',
+        parameters: {
+          macroParams: {
+            allChildren: { value: 'true' },
+          },
+          macroMetadata: {
+            macroId: { value: '9ea4beb6-ac0a-42d7-baf1-e8e6eca01bfd' },
+            schemaVersion: { value: '2' },
+            title: { value: 'Child pages' },
+          },
+        },
+        localId: '4890f00c-c519-4947-a60c-0c3b7e1c7b72',
+      },
+    },
+  ],
+};
+
+/** ---------- Main upsert workflow ---------- */
+
+/**
+ * Upsert release notes at: Versions(parent) -> Version(title) -> Component(title)
+ *
+ * @param {object} args
+ * @param {string} args.versionsParentId - Page ID of the "Versions" page
+ * @param {string} args.versionTitle     - e.g. "Version 1"
+ * @param {string} args.componentTitle   - e.g. "Component A"
+ * @param {string} args.markdown         - Release notes markdown for the component page
+ *
+ * @returns {Promise<{versionPage:any, componentPage:any}>}
+ */
+export async function upsertReleaseNotes({
+  versionsParentId,
+  version,
+  component,
+  markdown,
+  group,
+}) {
+  if (!BASE_URL || !EMAIL || !API_TOKEN) {
+    throw new Error(
+      'Missing required env: CONFLUENCE_BASE_URL, CONFLUENCE_EMAIL, CONFLUENCE_API_TOKEN',
+    );
+  }
+
+  if (!versionsParentId || !version || !component) {
+    throw new Error(
+      'versionsParentId, versionTitle, and componentTitle are required',
+    );
+  }
+
+  if (!markdown || markdown.trim() === '') {
+    throw new Error('markdown content is required and cannot be empty');
+  }
+
+  // 1) fetch the parent to get spaceId
+  const parent = await getPage(versionsParentId);
+  const spaceId = parent.spaceId;
+
+  const versionTitle = `Docupace ${group} - Version ${version}`;
+  // 2) ensure Version page under parent
+  let versionPage = await findChildByTitle(parent.id, versionTitle);
+  if (!versionPage) {
+    versionPage = await createChildPage({
+      parentId: parent.id,
+      spaceId,
+      title: versionTitle,
+      adf: JSON.stringify(childPagesAdf),
+      message: `Create version page ${versionTitle}`,
+    });
+  }
+
+  const componentTitle = `${versionTitle} - ${component} Changelog`;
+
+  // 3) ensure Component page under Version
+  let componentPage = await findChildByTitle(versionPage.id, componentTitle);
+  const adf = adfMarkdown(markdown);
+
+  if (!componentPage) {
+    componentPage = await createChildPage({
+      parentId: versionPage.id,
+      spaceId,
+      title: componentTitle,
+      adf: JSON.stringify(adf),
+      message: `Create component page ${componentTitle}`,
+    });
+  } else {
+    // update existing component page with new markdown
+    componentPage = await updatePage({
+      page: componentPage,
+      title: componentTitle,
+      adf: JSON.stringify(adf),
+      message: `Update component page ${componentTitle}`,
+    });
+  }
+
+  return { versionPage, componentPage };
+}
+
+/**
+ * Upsert release notes from a markdown file
+ *
+ * @param {object} args
+ * @param {string} args.versionTitle     - e.g. "Version 1"
+ * @param {string} args.componentTitle   - e.g. "Component A"
+ * @param {string} args.markdownFile     - Path to markdown file
+ *
+ * @returns {Promise<{versionPage:any, componentPage:any}>}
+ */
+export async function upsertReleaseNotesFromFile({
+  version,
+  component,
+  markdownFile,
+  group,
+}) {
+  if (!group) {
+    throw new Error('changelog.group must be specified in package.json');
+  }
+
+  const versionsParentId =
+    process.env[`CONFLUENCE_${group.toUpperCase()}_PARENT_ID`];
+
+  if (!versionsParentId) {
+    throw new Error(
+      `CONFLUENCE_${group.toUpperCase()}_PARENT_ID environment variable is required`,
+    );
+  }
+
+  if (!markdownFile) {
+    throw new Error('markdownFile is required');
+  }
+
+  // Read markdown content from file
+  const markdown = readFileSync(markdownFile, 'utf8');
+
+  return upsertReleaseNotes({
+    versionsParentId,
+    version,
+    component,
+    markdown,
+    group,
+  });
+}
+
+export async function updateWikiWithVersion(releases) {
+  const packageNames = getPackageNames();
+  console.log(releases);
+
+  const promises = packageNames
+    .filter(
+      (packageName) =>
+        releases.find((release) => release.name == packageName.name) &&
+        packageName.content?.changelog?.component,
+    )
+    .map(async (packageName) => {
+      try {
+        const release = releases.find(
+          (release) => release.name == packageName.name,
+        );
+        await upsertReleaseNotesFromFile({
+          version: toShortVersion(release.newVersion),
+          component: packageName.content.changelog?.component,
+          markdownFile: path.join(packageName.path, 'CHANGELOG.md'),
+          group: packageName.content.changelog?.group,
+        });
+        console.log(`✅ Successfully updated wiki for ${packageName.name}`);
+      } catch (error) {
+        console.error(
+          `❌ Failed to update wiki for ${packageName.name}:`,
+          error.message,
+        );
+        // Continue with other packages instead of stopping the build
+      }
+    });
+
+  try {
+    await Promise.all(promises);
+    console.log('✅ Wiki update process completed');
+  } catch (error) {
+    console.error('❌ Error during wiki update process:', error.message);
+    // Don't throw the error to prevent build failure
+  }
+}