@growi/sdk-typescript 1.7.0 → 1.10.0

package/src/generated/v3/index.ts

@@ -2,7 +2,7 @@
  * Generated by orval v7.9.0 🍺
  * Do not edit manually.
  * GROWI REST API v3
- * OpenAPI spec version: 7.3.0-RC.0
+ * OpenAPI spec version: 7.5.5-RC.0
  */
 import type {
   ActivityResponse,
@@ -46,8 +46,6 @@ import type {
   GetActivityParams,
   GetAdminHome200,
   GetAllShareLinksForSecuritySetting200,
-  GetAncestorsChildrenForPageListing200,
-  GetAncestorsChildrenForPageListingParams,
   GetAncestorsForExternalUserGroups200,
   GetAncestorsForExternalUserGroupsParams,
   GetAncestorsForUserGroups200,
@@ -64,6 +62,7 @@ import type {
   GetChildrenForUserGroups200,
   GetChildrenForUserGroupsParams,
   GetCollectionsForMongo200,
+  GetContentDispositionSettings200,
   GetCustomizeSetting200,
   GetEditorSettingsForPersonalSetting200,
   GetExistForPage200,
@@ -86,7 +85,6 @@ import type {
   GetGrowiInfoForG2gTransfer200,
   GetHealthcheck200,
   GetHealthcheckParams,
-  GetImport200,
   GetInAppNotificationSettingsForPersonalSetting200,
   GetIndicesForSearch200,
   GetInfoForBookmarksParams,
@@ -94,6 +92,8 @@ import type {
   GetInfoForPageListingParams,
   GetInfoForPageParams,
   GetIsPasswordSetForPersonalSetting200,
+  GetItemForPageListing200,
+  GetItemForPageListingParams,
   GetLimitForAttachment200,
   GetLimitForAttachmentParams,
   GetListByUserIdForBookmarkFolder200,
@@ -110,6 +110,7 @@ import type {
   GetNonUserRelatedGroupsGrantedForPageParams,
   GetNotificationSetting200,
   GetPageParams,
+  GetPageResponse,
   GetPagesByIdForUserGroups200,
   GetPersonalSetting200,
   GetPluginTemplatesByLocaleByTemplateIdByReposIdByOrganizationIdForTemplates200,
@@ -126,6 +127,7 @@ import type {
   GetSelectableParentGroupsParams,
   GetShareLinks200,
   GetShareLinksParams,
+  GetSharedForPageParams,
   GetSlackIntegrationLegacySetting200,
   GetSlackIntegrationSettings200,
   GetStatusForExport200,
@@ -166,7 +168,7 @@ import type {
   NotifyForPageGrant,
   OidcAuthSetting,
   Page,
-  PageInfoAll,
+  PageInfoExt,
   PersonalSettings,
   PostAccessTokenForPersonalSetting200,
   PostAddBookmarkToFolderForBookmarkFolder200,
@@ -230,6 +232,7 @@ import type {
   PostShareLinksBody,
   PostSlackAppIntegrationsForSlackIntegrationSettings200,
   PostSmtpTestForAppSettings200,
+  PostSuggestPathForAiToolsBody,
   PostTestForSlackIntegrationSettingsWithoutProxyBody,
   PostTransferForG2gTransfer200,
   PostTransferForG2gTransferBody,
@@ -250,6 +253,7 @@ import type {
   PutBookmarkFolder200,
   PutBookmarkFolderBody,
   PutBookmarks200,
+  PutContentDispositionSettings200,
   PutContentWidthByPageId200,
   PutContentWidthByPageIdBody,
   PutCustomizeCssForCustomizeSetting200,
@@ -289,6 +293,8 @@ import type {
   PutLdapForSecuritySetting200,
   PutLineBreakForMarkdownSetting200,
   PutLocalSettingForSecuritySetting200,
+  PutOauth2SettingForAppSettings200,
+  PutOauth2SettingForAppSettingsBody,
   PutOidcForSecuritySetting200,
   PutPage200,
   PutPageBody,
@@ -347,6 +353,7 @@ import type {
   SiteUrlSettingParams,
   SmtpSettingParams,
   StatisticsUserResponse,
+  SuggestPathResponse,
   SyncStatus,
   UserNotification,
   UserNotificationParams,
@@ -532,6 +539,17 @@ export const getGrowirestapiv3 = () => {
     );
   };
 
+  /**
+   * Analyzes the given content and suggests appropriate page paths using keyword extraction, search, and AI evaluation.
+   * @summary Suggest page paths based on content
+   */
+  const postSuggestPathForAiTools = (postSuggestPathForAiToolsBody: PostSuggestPathForAiToolsBody, options?: SecondParameter<typeof customInstance>) => {
+    return customInstance<SuggestPathResponse>(
+      { url: `/ai-tools/suggest-path`, method: 'POST', headers: { 'Content-Type': 'application/json' }, data: postSuggestPathForAiToolsBody },
+      options,
+    );
+  };
+
   /**
    * Install a plugin
    * @summary /plugins
@@ -571,6 +589,17 @@ export const getGrowirestapiv3 = () => {
     return customInstance<GetAdminHome200>({ url: `/admin-home/`, method: 'GET' }, options);
   };
 
+  /**
+   * Update fileUploadSetting
+   * @summary /app-settings/file-upload-setting
+   */
+  const putFileUploadSettingsForAppSettings = (fileUploadSettingParams: FileUploadSettingParams, options?: SecondParameter<typeof customInstance>) => {
+    return customInstance<PutFileUploadSettingsForAppSettings200>(
+      { url: `/app-settings/file-upload-settings`, method: 'PUT', headers: { 'Content-Type': 'application/json' }, data: fileUploadSettingParams },
+      options,
+    );
+  };
+
   /**
    * get app setting params
    * @summary /app-settings
@@ -632,12 +661,15 @@ export const getGrowirestapiv3 = () => {
   };
 
   /**
-   * Update fileUploadSetting
-   * @summary /app-settings/file-upload-setting
+   * Update OAuth 2.0 setting for email
+   * @summary /app-settings/oauth2-setting
    */
-  const putFileUploadSettingsForAppSettings = (fileUploadSettingParams: FileUploadSettingParams, options?: SecondParameter<typeof customInstance>) => {
-    return customInstance<PutFileUploadSettingsForAppSettings200>(
-      { url: `/app-settings/file-upload-settings`, method: 'PUT', headers: { 'Content-Type': 'application/json' }, data: fileUploadSettingParams },
+  const putOauth2SettingForAppSettings = (
+    putOauth2SettingForAppSettingsBody: PutOauth2SettingForAppSettingsBody,
+    options?: SecondParameter<typeof customInstance>,
+  ) => {
+    return customInstance<PutOauth2SettingForAppSettings200>(
+      { url: `/app-settings/oauth2-setting`, method: 'PUT', headers: { 'Content-Type': 'application/json' }, data: putOauth2SettingForAppSettingsBody },
       options,
     );
   };
@@ -792,6 +824,20 @@ export const getGrowirestapiv3 = () => {
     );
   };
 
+  /**
+   * @summary Replace content disposition settings for configurable MIME types with recieved lists.
+   */
+  const putContentDispositionSettings = (options?: SecondParameter<typeof customInstance>) => {
+    return customInstance<PutContentDispositionSettings200>({ url: `/content-disposition-settings/`, method: 'PUT' }, options);
+  };
+
+  /**
+   * @summary Get content disposition settings for configurable MIME types
+   */
+  const getContentDispositionSettings = (options?: SecondParameter<typeof customInstance>) => {
+    return customInstance<GetContentDispositionSettings200>({ url: `/content-disposition-settings`, method: 'GET' }, options);
+  };
+
   /**
    * Get customize parameters
    * @summary /customize-setting
@@ -1110,11 +1156,11 @@ export const getGrowirestapiv3 = () => {
   };
 
   /**
-   * Get import settings params
-   * @summary /import
+   * Get properties of stored zip files for import
+   * @summary /import/status
    */
-  const getImport = (options?: SecondParameter<typeof customInstance>) => {
-    return customInstance<GetImport200>({ url: `/import`, method: 'GET' }, options);
+  const getStatusForImport = (options?: SecondParameter<typeof customInstance>) => {
+    return customInstance<GetStatusForImport200>({ url: `/import/status`, method: 'GET' }, options);
   };
 
   /**
@@ -1125,14 +1171,6 @@ export const getGrowirestapiv3 = () => {
     return customInstance<void>({ url: `/import`, method: 'POST', headers: { 'Content-Type': 'application/json' }, data: postImportBody }, options);
   };
 
-  /**
-   * Get properties of stored zip files for import
-   * @summary /import/status
-   */
-  const getStatusForImport = (options?: SecondParameter<typeof customInstance>) => {
-    return customInstance<GetStatusForImport200>({ url: `/import/status`, method: 'GET' }, options);
-  };
-
   /**
    * upload a zip file
    * @summary /import/upload
@@ -1378,14 +1416,6 @@ export const getGrowirestapiv3 = () => {
     return customInstance<GetRootForPageListing200>({ url: `/page-listing/root`, method: 'GET' }, options);
   };
 
-  /**
-   * Get the ancestors and children of a page
-   * @summary /page-listing/ancestors-children
-   */
-  const getAncestorsChildrenForPageListing = (params: GetAncestorsChildrenForPageListingParams, options?: SecondParameter<typeof customInstance>) => {
-    return customInstance<GetAncestorsChildrenForPageListing200>({ url: `/page-listing/ancestors-children`, method: 'GET', params }, options);
-  };
-
   /**
    * Get the children of a page
    * @summary /page-listing/children
@@ -1403,11 +1433,35 @@ export const getGrowirestapiv3 = () => {
   };
 
   /**
-   * get page by pagePath or pageId
+   * Get a single page item for tree display
+   * @summary /page-listing/item
+   */
+  const getItemForPageListing = (params: GetItemForPageListingParams, options?: SecondParameter<typeof customInstance>) => {
+    return customInstance<GetItemForPageListing200>({ url: `/page-listing/item`, method: 'GET', params }, options);
+  };
+
+  /**
+   * Get page data via a valid share link (public endpoint, no authentication required)
+   * @summary Get page by share link
+   */
+  const getSharedForPage = (params: GetSharedForPageParams, options?: SecondParameter<typeof customInstance>) => {
+    return customInstance<GetPageResponse>({ url: `/page/shared`, method: 'GET', params }, options);
+  };
+
+  /**
+   * Get summary informations for a page
+   * @summary /page/info
+   */
+  const getInfoForPage = (params: GetInfoForPageParams, options?: SecondParameter<typeof customInstance>) => {
+    return customInstance<PageInfoExt>({ url: `/page/info`, method: 'GET', params }, options);
+  };
+
+  /**
+   * Get page by pagePath or pageId. Returns a single page or multiple pages based on parameters.
    * @summary Get page
    */
   const getPage = (params?: GetPageParams, options?: SecondParameter<typeof customInstance>) => {
-    return customInstance<Page>({ url: `/page`, method: 'GET', params }, options);
+    return customInstance<GetPageResponse>({ url: `/page`, method: 'GET', params }, options);
   };
 
   /**
@@ -1441,14 +1495,6 @@ export const getGrowirestapiv3 = () => {
     return customInstance<Page>({ url: `/page/likes`, method: 'PUT', headers: { 'Content-Type': 'application/json' }, data: likeParams }, options);
   };
 
-  /**
-   * Get summary informations for a page
-   * @summary /page/info
-   */
-  const getInfoForPage = (params: GetInfoForPageParams, options?: SecondParameter<typeof customInstance>) => {
-    return customInstance<PageInfoAll>({ url: `/page/info`, method: 'GET', params }, options);
-  };
-
   /**
    * Retrieve current page's grant data
    * @summary Get page grant data
@@ -2775,18 +2821,20 @@ export const getGrowirestapiv3 = () => {
     getTemplates,
     getPresetTemplatesByLocaleByTemplateIdForTemplates,
     getPluginTemplatesByLocaleByTemplateIdByReposIdByOrganizationIdForTemplates,
+    postSuggestPathForAiTools,
     postPlugins,
     putActivateByIdForPlugins,
     deleteRemoveByIdForPlugins,
     getActivity,
     getAdminHome,
+    putFileUploadSettingsForAppSettings,
     getAppSettings,
     putAppSettingForAppSettings,
     putSiteUrlSettingForAppSettings,
     putSmtpSettingForAppSettings,
     postSmtpTestForAppSettings,
     putSesSettingForAppSettings,
-    putFileUploadSettingsForAppSettings,
+    putOauth2SettingForAppSettings,
     postV5SchemaMigrationForAppSettings,
     postMaintenanceModeForAppSettings,
     getListForAttachment,
@@ -2802,6 +2850,8 @@ export const getGrowirestapiv3 = () => {
     getInfoForBookmarks,
     getBookmarksByUserId,
     putBookmarks,
+    putContentDispositionSettings,
+    getContentDispositionSettings,
     getCustomizeSetting,
     getLayoutForCustomizeSetting,
     putLayoutForCustomizeSetting,
@@ -2831,9 +2881,8 @@ export const getGrowirestapiv3 = () => {
     postGenerateKeyForG2gTransfer,
     postTransferForG2gTransfer,
     getHealthcheck,
-    getImport,
-    postImport,
     getStatusForImport,
+    postImport,
     postUploadForImport,
     deleteAllForImport,
     getListForInAppNotification,
@@ -2858,15 +2907,16 @@ export const getGrowirestapiv3 = () => {
     putNotifyForPageGrantForNotificationSetting,
     putEnabledByIdForNotificationSettingGlobalNotification,
     getRootForPageListing,
-    getAncestorsChildrenForPageListing,
     getChildrenForPageListing,
     getInfoForPageListing,
+    getItemForPageListing,
+    getSharedForPage,
+    getInfoForPage,
     getPage,
     postPage,
     putPage,
     getExistForPage,
     putLikesForPage,
-    getInfoForPage,
     getGrantDataForPage,
     getNonUserRelatedGroupsGrantedForPage,
     getApplicableGrantForPage,
@@ -3037,20 +3087,22 @@ export type GetPresetTemplatesByLocaleByTemplateIdForTemplatesResult = NonNullab
 export type GetPluginTemplatesByLocaleByTemplateIdByReposIdByOrganizationIdForTemplatesResult = NonNullable<
   Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getPluginTemplatesByLocaleByTemplateIdByReposIdByOrganizationIdForTemplates']>>
 >;
+export type PostSuggestPathForAiToolsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['postSuggestPathForAiTools']>>>;
 export type PostPluginsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['postPlugins']>>>;
 export type PutActivateByIdForPluginsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putActivateByIdForPlugins']>>>;
 export type DeleteRemoveByIdForPluginsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['deleteRemoveByIdForPlugins']>>>;
 export type GetActivityResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getActivity']>>>;
 export type GetAdminHomeResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getAdminHome']>>>;
+export type PutFileUploadSettingsForAppSettingsResult = NonNullable<
+  Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putFileUploadSettingsForAppSettings']>>
+>;
 export type GetAppSettingsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getAppSettings']>>>;
 export type PutAppSettingForAppSettingsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putAppSettingForAppSettings']>>>;
 export type PutSiteUrlSettingForAppSettingsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putSiteUrlSettingForAppSettings']>>>;
 export type PutSmtpSettingForAppSettingsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putSmtpSettingForAppSettings']>>>;
 export type PostSmtpTestForAppSettingsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['postSmtpTestForAppSettings']>>>;
 export type PutSesSettingForAppSettingsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putSesSettingForAppSettings']>>>;
-export type PutFileUploadSettingsForAppSettingsResult = NonNullable<
-  Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putFileUploadSettingsForAppSettings']>>
->;
+export type PutOauth2SettingForAppSettingsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putOauth2SettingForAppSettings']>>>;
 export type PostV5SchemaMigrationForAppSettingsResult = NonNullable<
   Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['postV5SchemaMigrationForAppSettings']>>
 >;
@@ -3074,6 +3126,8 @@ export type PutUpdateBookmarkForBookmarkFolderResult = NonNullable<
 export type GetInfoForBookmarksResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getInfoForBookmarks']>>>;
 export type GetBookmarksByUserIdResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getBookmarksByUserId']>>>;
 export type PutBookmarksResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putBookmarks']>>>;
+export type PutContentDispositionSettingsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putContentDispositionSettings']>>>;
+export type GetContentDispositionSettingsResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getContentDispositionSettings']>>>;
 export type GetCustomizeSettingResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getCustomizeSetting']>>>;
 export type GetLayoutForCustomizeSettingResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getLayoutForCustomizeSetting']>>>;
 export type PutLayoutForCustomizeSettingResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putLayoutForCustomizeSetting']>>>;
@@ -3119,9 +3173,8 @@ export type GetGrowiInfoForG2gTransferResult = NonNullable<Awaited<ReturnType<Re
 export type PostGenerateKeyForG2gTransferResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['postGenerateKeyForG2gTransfer']>>>;
 export type PostTransferForG2gTransferResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['postTransferForG2gTransfer']>>>;
 export type GetHealthcheckResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getHealthcheck']>>>;
-export type GetImportResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getImport']>>>;
-export type PostImportResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['postImport']>>>;
 export type GetStatusForImportResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getStatusForImport']>>>;
+export type PostImportResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['postImport']>>>;
 export type PostUploadForImportResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['postUploadForImport']>>>;
 export type DeleteAllForImportResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['deleteAllForImport']>>>;
 export type GetListForInAppNotificationResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getListForInAppNotification']>>>;
@@ -3164,17 +3217,16 @@ export type PutEnabledByIdForNotificationSettingGlobalNotificationResult = NonNu
   Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putEnabledByIdForNotificationSettingGlobalNotification']>>
 >;
 export type GetRootForPageListingResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getRootForPageListing']>>>;
-export type GetAncestorsChildrenForPageListingResult = NonNullable<
-  Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getAncestorsChildrenForPageListing']>>
->;
 export type GetChildrenForPageListingResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getChildrenForPageListing']>>>;
 export type GetInfoForPageListingResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getInfoForPageListing']>>>;
+export type GetItemForPageListingResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getItemForPageListing']>>>;
+export type GetSharedForPageResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getSharedForPage']>>>;
+export type GetInfoForPageResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getInfoForPage']>>>;
 export type GetPageResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getPage']>>>;
 export type PostPageResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['postPage']>>>;
 export type PutPageResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putPage']>>>;
 export type GetExistForPageResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getExistForPage']>>>;
 export type PutLikesForPageResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['putLikesForPage']>>>;
-export type GetInfoForPageResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getInfoForPage']>>>;
 export type GetGrantDataForPageResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getGrantDataForPage']>>>;
 export type GetNonUserRelatedGroupsGrantedForPageResult = NonNullable<
   Awaited<ReturnType<ReturnType<typeof getGrowirestapiv3>['getNonUserRelatedGroupsGrantedForPage']>>

package/src/index.ts

@@ -1,4 +1,4 @@
-export { AXIOS_DEFAULT } from './utils/axios-default-instance.js';
+export { axiosInstanceManager } from './utils/axios-instance-manager.js';
 
 export type * as Apiv1Types from './apiv1/index.js';
 export type * as Apiv3Types from './apiv3/index.js';

package/src/utils/axios-instance-manager.test.ts

@@ -0,0 +1,185 @@
+import type { AxiosInstance } from 'axios';
+import { describe, expect, it } from 'vitest';
+import { axiosInstanceManager } from './axios-instance-manager.js';
+
+type CapturedHeaders = {
+  authorization: unknown;
+  hasGrowiAccessToken: boolean;
+  growiAccessToken: unknown;
+};
+
+/**
+ * Fire a request through the instance and capture the fully-merged outgoing headers via a request interceptor,
+ * rejecting before any network call. This asserts what GROWI would actually receive, rather than poking the
+ * instance's internal `defaults`, so the test stays meaningful even if the header wiring changes.
+ */
+const captureRequestHeaders = async (instance: AxiosInstance): Promise<CapturedHeaders> => {
+  const marker = '__captured__';
+  let captured: CapturedHeaders = { authorization: undefined, hasGrowiAccessToken: false, growiAccessToken: undefined };
+
+  const interceptorId = instance.interceptors.request.use((config) => {
+    const headers = config.headers;
+    captured = {
+      authorization: headers.get('Authorization'),
+      hasGrowiAccessToken: headers.has('X-GROWI-ACCESS-TOKEN'),
+      growiAccessToken: headers.get('X-GROWI-ACCESS-TOKEN'),
+    };
+    return Promise.reject(new Error(marker));
+  });
+
+  try {
+    await instance.get('/probe');
+  } catch (error) {
+    if (!(error instanceof Error) || error.message !== marker) throw error;
+  } finally {
+    instance.interceptors.request.eject(interceptorId);
+  }
+
+  return captured;
+};
+
+describe('AxiosInstanceManager', () => {
+  describe('addAxiosInstance', () => {
+    it('sends a Bearer Authorization header and no GROWI access token by default', async () => {
+      axiosInstanceManager.addAxiosInstance({
+        appName: 'bearer-app',
+        baseURL: 'https://api.example.com',
+        token: 'test-token-123',
+      });
+
+      const headers = await captureRequestHeaders(axiosInstanceManager.getAxiosInstance('bearer-app'));
+
+      expect(headers.authorization).toBe('Bearer test-token-123');
+      expect(headers.hasGrowiAccessToken).toBe(false);
+    });
+
+    it('sends the custom Authorization header and the token via X-GROWI-ACCESS-TOKEN when authorizationHeader is provided', async () => {
+      axiosInstanceManager.addAxiosInstance({
+        appName: 'custom-auth-app',
+        baseURL: 'https://api.example.com',
+        token: 'growi-token-456',
+        authorizationHeader: 'Custom custom-auth-value',
+      });
+
+      const headers = await captureRequestHeaders(axiosInstanceManager.getAxiosInstance('custom-auth-app'));
+
+      expect(headers.authorization).toBe('Custom custom-auth-value');
+      expect(headers.growiAccessToken).toBe('growi-token-456');
+    });
+
+    it('applies the configured baseURL to the instance', () => {
+      axiosInstanceManager.addAxiosInstance({
+        appName: 'baseurl-app',
+        baseURL: 'https://api.example.com',
+        token: 'test-token',
+      });
+
+      expect(axiosInstanceManager.getAxiosInstance('baseurl-app').defaults.baseURL).toBe('https://api.example.com');
+    });
+
+    it('keeps instances isolated so each carries its own credentials', async () => {
+      axiosInstanceManager.addAxiosInstance({
+        appName: 'multi-1',
+        baseURL: 'https://api1.example.com',
+        token: 'token1',
+      });
+      axiosInstanceManager.addAxiosInstance({
+        appName: 'multi-2',
+        baseURL: 'https://api2.example.com',
+        token: 'token2',
+        authorizationHeader: 'Bearer custom-token',
+      });
+
+      const headers1 = await captureRequestHeaders(axiosInstanceManager.getAxiosInstance('multi-1'));
+      const headers2 = await captureRequestHeaders(axiosInstanceManager.getAxiosInstance('multi-2'));
+
+      expect(headers1.authorization).toBe('Bearer token1');
+      expect(headers1.hasGrowiAccessToken).toBe(false);
+      expect(headers2.authorization).toBe('Bearer custom-token');
+      expect(headers2.growiAccessToken).toBe('token2');
+    });
+
+    it('overwrites the existing instance when the same appName is reused', async () => {
+      axiosInstanceManager.addAxiosInstance({
+        appName: 'overwrite-app',
+        baseURL: 'https://api.example.com',
+        token: 'original-token',
+      });
+      axiosInstanceManager.addAxiosInstance({
+        appName: 'overwrite-app',
+        baseURL: 'https://api-updated.example.com',
+        token: 'updated-token',
+        authorizationHeader: 'Bearer updated-auth',
+      });
+
+      const instance = axiosInstanceManager.getAxiosInstance('overwrite-app');
+      const headers = await captureRequestHeaders(instance);
+
+      expect(instance.defaults.baseURL).toBe('https://api-updated.example.com');
+      expect(headers.authorization).toBe('Bearer updated-auth');
+      expect(headers.growiAccessToken).toBe('updated-token');
+    });
+
+    it('throws when appName is an empty string', () => {
+      expect(() => {
+        axiosInstanceManager.addAxiosInstance({ appName: '', baseURL: 'https://api.example.com', token: 'token' });
+      }).toThrow('appName must be a non-empty string');
+    });
+
+    it('throws when baseURL is an empty string', () => {
+      expect(() => {
+        axiosInstanceManager.addAxiosInstance({ appName: 'app-name', baseURL: '', token: 'token' });
+      }).toThrow('baseURL must be a non-empty string');
+    });
+
+    it('throws when token is an empty string', () => {
+      expect(() => {
+        axiosInstanceManager.addAxiosInstance({ appName: 'app-name', baseURL: 'https://api.example.com', token: '' });
+      }).toThrow('token must be a non-empty string');
+    });
+
+    it('throws when authorizationHeader is provided but empty, instead of silently falling back to Bearer', () => {
+      expect(() => {
+        axiosInstanceManager.addAxiosInstance({
+          appName: 'empty-auth-header',
+          baseURL: 'https://api.example.com',
+          token: 'token',
+          authorizationHeader: '',
+        });
+      }).toThrow('authorizationHeader must be a non-empty string when provided');
+    });
+  });
+
+  describe('getAxiosInstance', () => {
+    it('returns the same instance for a given appName', () => {
+      axiosInstanceManager.addAxiosInstance({
+        appName: 'stable-app',
+        baseURL: 'https://api.example.com',
+        token: 'test-token',
+      });
+
+      expect(axiosInstanceManager.getAxiosInstance('stable-app')).toBe(axiosInstanceManager.getAxiosInstance('stable-app'));
+    });
+
+    it('returns different instances for different appNames', () => {
+      axiosInstanceManager.addAxiosInstance({
+        appName: 'distinct-1',
+        baseURL: 'https://api1.example.com',
+        token: 'token1',
+      });
+      axiosInstanceManager.addAxiosInstance({
+        appName: 'distinct-2',
+        baseURL: 'https://api2.example.com',
+        token: 'token2',
+      });
+
+      expect(axiosInstanceManager.getAxiosInstance('distinct-1')).not.toBe(axiosInstanceManager.getAxiosInstance('distinct-2'));
+    });
+
+    it('throws for a non-existent appName', () => {
+      expect(() => {
+        axiosInstanceManager.getAxiosInstance('non-existent-app');
+      }).toThrow('No Axios instance found for appName: non-existent-app');
+    });
+  });
+});

package/src/utils/axios-instance-manager.ts

@@ -0,0 +1,61 @@
+import Axios, { type AxiosRequestConfig, type AxiosInstance } from 'axios';
+
+/**
+ * A singleton class for managing multiple named Axios instances.
+ */
+class AxiosInstanceManager {
+  private instances: Map<string, AxiosInstance> = new Map();
+
+  /**
+   * Add or update a named Axios instance.
+   * @param config The configuration for the Axios instance.
+   * @param config.appName The name/key for the instance.
+   * @param config.baseURL The base URL of the GROWI instance.
+   * @param config.token The GROWI API token.
+   * @param config.authorizationHeader Optional custom `Authorization` header value. When provided, it must be a non-empty
+   *   string; it overrides the default Bearer scheme and the token is sent via the `X-GROWI-ACCESS-TOKEN` header instead.
+   *   Useful when GROWI sits behind Digest, Basic, or custom proxy authentication.
+   */
+  addAxiosInstance(config: { appName: string; baseURL: string; token: string; authorizationHeader?: string }) {
+    if (typeof config.appName !== 'string' || config.appName.length === 0) throw new Error('appName must be a non-empty string');
+    if (typeof config.baseURL !== 'string' || config.baseURL.length === 0) throw new Error('baseURL must be a non-empty string');
+    if (typeof config.token !== 'string' || config.token.length === 0) throw new Error('token must be a non-empty string');
+    // Validate authorizationHeader for parity with the required fields: when present it must be a usable header value,
+    // so an empty/non-string value fails loudly instead of silently falling back to the default Bearer scheme.
+    if (config.authorizationHeader !== undefined && (typeof config.authorizationHeader !== 'string' || config.authorizationHeader.length === 0)) {
+      throw new Error('authorizationHeader must be a non-empty string when provided');
+    }
+
+    const axiosInstance = Axios.create({
+      baseURL: config.baseURL,
+    });
+
+    // Set the Authorization header. When a custom authorization header is provided (e.g. Digest/Basic/proxy auth),
+    // send the GROWI access token via X-GROWI-ACCESS-TOKEN instead of the default Bearer scheme.
+    if (config.authorizationHeader) {
+      axiosInstance.defaults.headers.common.Authorization = config.authorizationHeader;
+      axiosInstance.defaults.headers.common['X-GROWI-ACCESS-TOKEN'] = config.token;
+    } else {
+      axiosInstance.defaults.headers.common.Authorization = `Bearer ${config.token}`;
+    }
+
+    this.instances.set(config.appName, axiosInstance);
+  }
+
+  /**
+   * Get a named Axios instance.
+   * @param appName The name/key of the instance.
+   * @returns The AxiosInstance.
+   * @throws Error if no instance is found for the given appName.
+   */
+  getAxiosInstance(appName: string): AxiosInstance {
+    const instance = this.instances.get(appName);
+    if (!instance) {
+      throw new Error(`No Axios instance found for appName: ${appName}`);
+    }
+    return instance;
+  }
+}
+
+// Export singleton instance
+export const axiosInstanceManager = new AxiosInstanceManager();

package/src/utils/types/custom-instance.ts

@@ -0,0 +1,6 @@
+import type { AxiosRequestConfig } from 'axios';
+
+export type CustomInstanceOptions = {
+  appName?: string;
+  axiosOptions?: AxiosRequestConfig;
+};