@aigne/doc-smith 0.9.3-beta.2 → 0.9.4-beta

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.9.4-beta](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.9.3...v0.9.4-beta) (2025-11-14)
+
+
+### Bug Fixes
+
+* resolve access key parsing issues and improve log output ([#309](https://github.com/AIGNE-io/aigne-doc-smith/issues/309)) ([c8d9bf3](https://github.com/AIGNE-io/aigne-doc-smith/commit/c8d9bf3e61d0126c7f117b38308c34cf73c8f141))
+
+## [0.9.3](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.9.3-beta.2...v0.9.3) (2025-11-13)
+
 ## [0.9.3-beta.2](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.9.3-beta.1...v0.9.3-beta.2) (2025-11-13)
 
 

package/agents/publish/publish-docs.mjs

@@ -6,8 +6,8 @@ import fs from "fs-extra";
 
 import {
   getAccessToken,
+  getCachedAccessToken,
   getDiscussKitMountPoint,
-  getOfficialAccessToken,
 } from "../../utils/auth-utils.mjs";
 import {
   CLOUD_SERVICE_URL_PROD,
@@ -76,16 +76,15 @@ export default async function publishDocs(
     let shouldSyncBranding = void 0;
     let token = "";
     let client = null;
-    let authToken = null;
     let sessionId = null;
     let locale = config?.locale;
 
     if (!hasInputAppUrl) {
-      authToken = await getOfficialAccessToken(BASE_URL, false);
+      const officialAccessToken = await getCachedAccessToken(BASE_URL);
 
       sessionId = "";
-      if (authToken) {
-        client = new BrokerClient({ baseUrl: BASE_URL, authToken });
+      if (officialAccessToken) {
+        client = new BrokerClient({ baseUrl: BASE_URL, authToken: officialAccessToken });
         const info = await client.checkCacheSession({
           needShortUrl: true,
           sessionId: config?.checkoutId,
@@ -201,7 +200,7 @@ export default async function publishDocs(
     const discussKitMountPoint = await getDiscussKitMountPoint(appUrlInfo.origin);
     const discussKitUrl = joinURL(appUrlInfo.origin, discussKitMountPoint);
 
-    console.log(`\nPublishing your documentation to ${chalk.cyan(discussKitUrl)}\n`);
+    console.log(`\nPublishing your documentation to ${chalk.cyan(discussKitUrl)}`);
 
     const accessToken = await getAccessToken(appUrlInfo.origin, token, locale);
 
@@ -218,6 +217,8 @@ export default async function publishDocs(
     };
     let finalPath = null;
 
+    console.log(`Publishing docs collection: ${chalk.cyan(projectInfo.name || boardId)}\n`);
+
     // Handle project logo download if it's a URL
     if (projectInfo.icon && isRemoteFile(projectInfo.icon)) {
       const { url: uploadedImageUrl, downloadFinalPath } = await downloadAndUploadImage(
@@ -254,11 +255,11 @@ export default async function publishDocs(
     if (translatedMetadata) {
       boardMeta.translation = translatedMetadata;
     }
-
     const {
       success,
       boardId: newBoardId,
       error,
+      docsUrl,
     } = await publishDocsFn({
       sidebarPath,
       accessToken,
@@ -286,7 +287,8 @@ export default async function publishDocs(
       if (boardId !== newBoardId) {
         await saveValueToConfig("boardId", newBoardId);
       }
-      message = `✅ Documentation published successfully!`;
+      message = `✅ Documentation published successfully!\n📖 Docs available at: ${chalk.cyan(docsUrl)}`;
+
       await saveValueToConfig("checkoutId", "", "Checkout ID for document deployment service");
       await saveValueToConfig("shouldSyncBranding", "", "Should sync branding for documentation");
     } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/doc-smith",
-  "version": "0.9.3-beta.2",
+  "version": "0.9.4-beta",
   "description": "AI-driven documentation generation tool built on the AIGNE Framework",
   "publishConfig": {
     "access": "public"

package/utils/auth-utils.mjs

@@ -19,7 +19,6 @@ import {
   CLOUD_SERVICE_URL_STAGING,
   DISCUSS_KIT_DID,
   DISCUSS_KIT_STORE_URL,
-  DOC_OFFICIAL_ACCESS_TOKEN,
   PAYMENT_KIT_DID,
 } from "./constants/index.mjs";
 import { requestWithAuthToken } from "./request.mjs";
@@ -41,23 +40,23 @@ export function getDocSmithEnvFilePath() {
  * @param {string} baseUrl - The application URL
  * @returns {Promise<string>} - The access token
  */
-async function getCachedAccessToken(baseUrl) {
+export async function getCachedAccessToken(baseUrl) {
   const { hostname: targetHostname } = new URL(baseUrl);
   const DOC_SMITH_ENV_FILE = getDocSmithEnvFilePath();
 
   let accessToken =
-    process.env.DOC_SMITH_PUBLISH_ACCESS_TOKEN || process.env[DOC_OFFICIAL_ACCESS_TOKEN];
+    process.env.DOC_SMITH_PUBLISH_ACCESS_TOKEN || process.env.DOC_DISCUSS_KIT_ACCESS_TOKEN;
 
   // Check if access token exists in environment or config file
   if (!accessToken) {
     try {
       if (existsSync(DOC_SMITH_ENV_FILE)) {
         const data = await readFile(DOC_SMITH_ENV_FILE, "utf8");
-        if (data.includes(DOC_OFFICIAL_ACCESS_TOKEN)) {
+        if (data.includes("DOC_DISCUSS_KIT_ACCESS_TOKEN")) {
           // Handle empty or invalid YAML files
           const envs = data.trim() ? parse(data) : null;
-          if (envs?.[targetHostname]?.[DOC_OFFICIAL_ACCESS_TOKEN]) {
-            accessToken = envs[targetHostname][DOC_OFFICIAL_ACCESS_TOKEN];
+          if (envs?.[targetHostname]?.DOC_DISCUSS_KIT_ACCESS_TOKEN) {
+            accessToken = envs[targetHostname].DOC_DISCUSS_KIT_ACCESS_TOKEN;
           }
         }
       }
@@ -144,7 +143,7 @@ export async function getAccessToken(appUrl, ltToken = "", locale = "en") {
 
         try {
           const officialBaseUrl = process.env.DOC_SMITH_BASE_URL || CLOUD_SERVICE_URL_PROD;
-          const officialAccessToken = await getOfficialAccessToken(officialBaseUrl, false);
+          const officialAccessToken = await getCachedAccessToken(officialBaseUrl);
           if (officialAccessToken) {
             const mountPoint = await getComponentMountPoint(officialBaseUrl, PAYMENT_KIT_DID);
             const data = await requestWithAuthToken(
@@ -170,12 +169,10 @@ export async function getAccessToken(appUrl, ltToken = "", locale = "en") {
 
     accessToken = result.accessKeySecret;
     process.env.DOC_SMITH_PUBLISH_ACCESS_TOKEN = accessToken;
-    process.env[DOC_OFFICIAL_ACCESS_TOKEN] = accessToken;
+    process.env.DOC_DISCUSS_KIT_ACCESS_TOKEN = accessToken;
 
     // Save the access token to config file
-    await saveTokenToConfigFile(targetHostname, {
-      [DOC_OFFICIAL_ACCESS_TOKEN]: accessToken,
-    });
+    await saveTokenToConfigFile(targetHostname, { DOC_DISCUSS_KIT_ACCESS_TOKEN: accessToken });
   } catch {
     throw new Error(
       `${chalk.yellow("⚠️ Failed to obtain access token. This may be due to network issues or authorization timeout.")}\n\n` +
@@ -239,12 +236,9 @@ export async function getOfficialAccessToken(baseUrl, openPage = true, locale =
     });
 
     accessToken = result.accessKeySecret;
-    process.env[DOC_OFFICIAL_ACCESS_TOKEN] = accessToken;
 
     // Save the access token to config file
-    await saveTokenToConfigFile(targetHostname, {
-      [DOC_OFFICIAL_ACCESS_TOKEN]: accessToken,
-    });
+    await saveTokenToConfigFile(targetHostname, { DOC_DISCUSS_KIT_ACCESS_TOKEN: accessToken });
   } catch {
     throw new Error(
       `${chalk.yellow("⚠️ Failed to obtain official access token. This may be due to network issues or authorization timeout.")}\n\n` +

package/utils/constants/index.mjs

@@ -333,8 +333,6 @@ export const MEDIA_KIT_DID = "z8ia1mAXo8ZE7ytGF36L5uBf9kD2kenhqFGp9";
 
 export const PAYMENT_KIT_DID = "z2qaCNvKMv5GjouKdcDWexv6WqtHbpNPQDnAk";
 
-export const DOC_OFFICIAL_ACCESS_TOKEN = "DOC_OFFICIAL_ACCESS_TOKEN";
-
 // Default application URL for the document deployment website.
 export const CLOUD_SERVICE_URL_PROD = "https://docsmith.aigne.io";
 export const CLOUD_SERVICE_URL_STAGING = "https://staging.docsmith.aigne.io";