apifm-admin 26.6.13 → 26.6.15

package/README.md

@@ -24,6 +24,28 @@ const res = await apifmAdmin.loginAdminMobile({
 })
 ```
 
+## 动态获取 X-Token
+
+如果每个项目保存 token 的位置不同，不需要重写请求适配器，只注入获取 token 的方法即可：
+
+```js
+import apifmAdmin from 'apifm-admin'
+
+apifmAdmin.setTokenGetter(() => {
+  return uni.getStorageSync('tokenData')?.token || ''
+})
+```
+
+也可以通过 `setConfig` 一起配置：
+
+```js
+apifmAdmin.setConfig({
+  tokenGetter: () => uni.getStorageSync('tokenData')?.token || ''
+})
+```
+
+SDK 会在每次请求前调用 `tokenGetter`，并自动写入唯一的 `X-Token` 请求头。
+
 ## 跨端请求适配
 
 默认优先使用：
@@ -32,7 +54,7 @@ const res = await apifmAdmin.loginAdminMobile({
 2. `wx.request`
 3. `fetch`
 
-也可以手动注入请求适配器：
+只有在需要完全接管请求行为时，才需要手动注入请求适配器：
 
 ```js
 import apifmAdmin from 'apifm-admin'
@@ -57,7 +79,7 @@ apifmAdmin.setRequestAdapter(async (requestOptions) => {
 apifmAdmin.setConfig({
   token: 'xtoken',
   headers: {
-    'x-token': 'xtoken'
+    'X-Token': 'xtoken'
   }
 })
 ```
@@ -66,6 +88,7 @@ apifmAdmin.setConfig({
 
 ```js
 apifmAdmin.setToken('xtoken')
+apifmAdmin.setTokenGetter(() => uni.getStorageSync('tokenData')?.token || '')
 apifmAdmin.setHeader('tenant-id', '1001')
 apifmAdmin.setDomain('common', 'https://common.apifm.com')
 ```

package/dist/index.cjs

@@ -38321,6 +38321,7 @@ const DEFAULT_DOMAINS = {
 
 const state = {
   token: '',
+  tokenGetter: null,
   headers: {},
   domains: { ...DEFAULT_DOMAINS },
   requestAdapter: null
@@ -38361,10 +38362,17 @@ function mergeHeaders(headers) {
     ...state.headers,
     ...headers
   }
-  const token = headers?.['X-Token'] || headers?.['x-token'] || state.token
+  const headerToken =
+    headers?.['X-Token'] ||
+    headers?.['x-token'] ||
+    state.headers?.['X-Token'] ||
+    state.headers?.['x-token']
+  const dynamicToken = typeof state.tokenGetter === 'function' ? state.tokenGetter() : ''
+  const token = headerToken || dynamicToken || state.token
+  delete merged['X-Token']
+  delete merged['x-token']
   if (token) {
     merged['X-Token'] = token
-    merged['x-token'] = token
   }
   return merged
 }
@@ -38466,6 +38474,7 @@ const sdk = {
   getConfig() {
     return {
       token: state.token,
+      tokenGetter: state.tokenGetter,
       headers: { ...state.headers },
       domains: { ...state.domains }
     }
@@ -38474,6 +38483,9 @@ const sdk = {
     if (config.token !== undefined) {
       state.token = config.token || ''
     }
+    if (config.tokenGetter !== undefined) {
+      state.tokenGetter = typeof config.tokenGetter === 'function' ? config.tokenGetter : null
+    }
     if (config.headers) {
       state.headers = { ...state.headers, ...config.headers }
     }
@@ -38489,6 +38501,10 @@ const sdk = {
     state.token = token || ''
     return sdk
   },
+  setTokenGetter(tokenGetter) {
+    state.tokenGetter = typeof tokenGetter === 'function' ? tokenGetter : null
+    return sdk
+  },
   setHeader(name, value) {
     if (isNil(value)) {
       delete state.headers[name]

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export interface RequestOptions {
 
 export interface SDKConfig {
   token?: string;
+  tokenGetter?: () => string;
   headers?: Record<string, string>;
   domains?: Record<string, string>;
   requestAdapter?: (options: RequestAdapterOptions) => Promise<any>;
@@ -13255,9 +13256,10 @@ export interface YuyueJoinSuccessPayload {
 }
 
 declare const sdk: {
-  getConfig(): { token: string; headers: Record<string, string>; domains: Record<string, string> };
+  getConfig(): { token: string; tokenGetter: (() => string) | null; headers: Record<string, string>; domains: Record<string, string> };
   setConfig(config?: SDKConfig): typeof sdk;
   setToken(token: string): typeof sdk;
+  setTokenGetter(tokenGetter?: () => string): typeof sdk;
   setHeader(name: string, value?: string): typeof sdk;
   setHeaders(headers?: Record<string, string>): typeof sdk;
   setDomain(domainKey: string, domainValue: string): typeof sdk;

package/dist/index.js

@@ -38321,6 +38321,7 @@ const DEFAULT_DOMAINS = {
 
 const state = {
   token: '',
+  tokenGetter: null,
   headers: {},
   domains: { ...DEFAULT_DOMAINS },
   requestAdapter: null
@@ -38361,10 +38362,17 @@ function mergeHeaders(headers) {
     ...state.headers,
     ...headers
   }
-  const token = headers?.['X-Token'] || headers?.['x-token'] || state.token
+  const headerToken =
+    headers?.['X-Token'] ||
+    headers?.['x-token'] ||
+    state.headers?.['X-Token'] ||
+    state.headers?.['x-token']
+  const dynamicToken = typeof state.tokenGetter === 'function' ? state.tokenGetter() : ''
+  const token = headerToken || dynamicToken || state.token
+  delete merged['X-Token']
+  delete merged['x-token']
   if (token) {
     merged['X-Token'] = token
-    merged['x-token'] = token
   }
   return merged
 }
@@ -38466,6 +38474,7 @@ const sdk = {
   getConfig() {
     return {
       token: state.token,
+      tokenGetter: state.tokenGetter,
       headers: { ...state.headers },
       domains: { ...state.domains }
     }
@@ -38474,6 +38483,9 @@ const sdk = {
     if (config.token !== undefined) {
       state.token = config.token || ''
     }
+    if (config.tokenGetter !== undefined) {
+      state.tokenGetter = typeof config.tokenGetter === 'function' ? config.tokenGetter : null
+    }
     if (config.headers) {
       state.headers = { ...state.headers, ...config.headers }
     }
@@ -38489,6 +38501,10 @@ const sdk = {
     state.token = token || ''
     return sdk
   },
+  setTokenGetter(tokenGetter) {
+    state.tokenGetter = typeof tokenGetter === 'function' ? tokenGetter : null
+    return sdk
+  },
   setHeader(name, value) {
     if (isNil(value)) {
       delete state.headers[name]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apifm-admin",
-  "version": "26.6.13",
+  "version": "26.6.15",
   "description": "API 工厂后台接口 SDK，支持 Web、uni-app、微信小程序",
   "license": "MIT",
   "author": "",