@aithe/aithe-ui 26.2.3 → 26.3.2

package/dist/core/datahub/core/api-styles.d.ts

@@ -10,7 +10,7 @@
  *              - k8s: Kubernetes API style (request sends object directly, response includes kind/apiVersion/metadata)
  *              - raw: Passthrough style, no request/response transformation, returns raw HTTP data directly
  */
-import type { DataHubAPIStyle } from '../types';
+import type { DataHubAPIStyle } from '../../datahub/types';
 /**
  * 获取内置 APIStyle / Get a built-in APIStyle by name
  * @param name - 风格名称，可选 "default" 或 "k8s" / Style name, either "default" or "k8s"

package/dist/core/datahub/core/api-styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-styles.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/core/api-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,UAAU,CAAC;AAsHlB;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}
+{"version":3,"file":"api-styles.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/core/api-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,qBAAqB,CAAC;AAqI7B;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}

package/dist/core/datahub/core/api-styles.js

@@ -0,0 +1,136 @@
+/**
+ * @file 内置 APIStyle 实现 / Built-in APIStyle Implementations
+ * @description 提供开箱即用的 APIStyle：
+ *              - default: Aithe UI 标准风格（请求 { data }，响应 { code/message/data }）
+ *              - k8s: Kubernetes API 风格（请求直接传对象，响应包含 kind/apiVersion/metadata）
+ *              - raw: 原始风格，不对请求体和响应做任何转换，直接透传原始 HTTP 数据
+ *
+ *              Provides ready-to-use APIStyle implementations:
+ *              - default: Aithe UI standard style (request { data }, response { code/message/data })
+ *              - k8s: Kubernetes API style (request sends object directly, response includes kind/apiVersion/metadata)
+ *              - raw: Passthrough style, no request/response transformation, returns raw HTTP data directly
+ */
+// ─── Default Style / 默认风格 ──────────────────────────────────
+const defaultStyle = {
+    name: 'default',
+    onRequest(req) {
+        // GET 请求不发送 body，无需包装 data，避免触发 "GET request with body is unusual" 警告
+        // GET requests do not send a body, so skip wrapping data to avoid the "GET request with body is unusual" warning
+        if (req.options.method === 'GET') {
+            return;
+        }
+        req.data = { data: req.data };
+    },
+    onResponse(res) {
+        const rawData = res.data;
+        if (!rawData || typeof rawData !== 'object') {
+            return { code: 'UnknownError', message: 'Invalid response format', data: undefined };
+        }
+        const obj = rawData;
+        return {
+            code: obj.code ?? 'UnknownError',
+            message: obj.message ?? '',
+            data: obj.data,
+        };
+    },
+    isSuccess(result) {
+        return result.code === 'Ok';
+    },
+};
+// ─── K8s Style / Kubernetes 风格 ───────────────────────────────
+const k8sStyle = {
+    name: 'k8s',
+    onRequest(_req) {
+        // K8s 风格直接发送业务对象，不额外包装
+    },
+    onResponse(res) {
+        const rawData = res.data;
+        if (!rawData || typeof rawData !== 'object') {
+            return { code: 'UnknownError', message: 'Invalid response format', data: undefined };
+        }
+        const obj = rawData;
+        // K8s 非 2xx 错误响应：Status 对象 { kind: "Status", status: "Failure", message, reason, code }
+        // K8s error response: Status object with top-level status string and message/reason fields
+        if (!res.ok && typeof obj.status === 'string') {
+            return {
+                code: obj.reason ?? obj.status ?? 'UnknownError',
+                message: obj.message ?? '',
+                data: rawData,
+            };
+        }
+        const status = obj.status;
+        const phase = status?.phase;
+        const conditions = status?.conditions;
+        const reason = status?.reason;
+        const k8sMessage = status?.message;
+        let code = 'Ok';
+        let message = '';
+        if (phase && phase !== 'Active' && phase !== 'Available' && phase !== 'Ready') {
+            code = phase;
+        }
+        if (reason) {
+            code = reason;
+        }
+        if (conditions && conditions.length > 0) {
+            const lastCondition = conditions.at(-1);
+            if (lastCondition && lastCondition.status !== 'True') {
+                code = lastCondition.reason ?? code;
+                message = lastCondition.message ?? '';
+            }
+        }
+        if (k8sMessage) {
+            message = k8sMessage;
+        }
+        return {
+            code,
+            message,
+            data: rawData,
+        };
+    },
+    isSuccess(result) {
+        return result.code === 'Ok';
+    },
+};
+// ─── 注册表 / Registry ─────────────────────────────────────────
+/**
+ * Raw 风格：不对请求体和响应做任何转换，直接透传原始 HTTP 数据。
+ * 适用于对接不遵循统一业务协议的三方接口。
+ * Raw style: no request/response transformation, passes raw HTTP data through.
+ * Useful for third-party APIs that don't follow a standard business protocol.
+ */
+const rawStyle = {
+    name: 'raw',
+    onRequest(_req) {
+        // 不包装请求体，直接透传
+    },
+    onResponse(res) {
+        return {
+            code: 'Ok',
+            message: '',
+            data: res.data,
+        };
+    },
+    isSuccess(_result) {
+        return true;
+    },
+};
+const builtinStyles = {
+    default: defaultStyle,
+    k8s: k8sStyle,
+    raw: rawStyle,
+};
+/**
+ * 获取内置 APIStyle / Get a built-in APIStyle by name
+ * @param name - 风格名称，可选 "default" 或 "k8s" / Style name, either "default" or "k8s"
+ * @returns APIStyle 实例，未找到返回 undefined / APIStyle instance, or undefined if not found
+ */
+export function getBuiltinStyle(name) {
+    return builtinStyles[name];
+}
+/**
+ * 获取所有内置 APIStyle 名称列表 / Get all built-in APIStyle names
+ * @returns 风格名称数组 / Array of style names
+ */
+export function getBuiltinStyleNames() {
+    return Object.keys(builtinStyles);
+}

package/dist/core/datahub/core/datahub-core.d.ts

@@ -23,9 +23,9 @@
  *              - Strategy is auto-detected; the business layer need not worry about cache/dedup/idempotent details
  *              - Unified error handling, only for transport-layer exceptions
  */
-import type { DataHubConfig, DataHubAdapter, DataHubRequestOptions, DataHubAdapterRequest, DataHubAdapterResponse, DataHubAPIStyle } from '../types';
-import { DataHubError as DataHubErrorClass } from '../types';
-import { onLoadingChange, isLoading } from '../utils/loading';
+import type { DataHubConfig, DataHubAdapter, DataHubRequestOptions, DataHubAdapterRequest, DataHubAdapterResponse, DataHubAPIStyle } from '../../datahub/types';
+import { DataHubError as DataHubErrorClass } from '../../datahub/types';
+import { onLoadingChange, isLoading } from '../../datahub/utils/loading';
 /**
  * DataHubCore - 核心调度器 / Core Dispatcher
  * @description 管理适配器注册、API 注册、请求调度及中间件编排。
@@ -107,6 +107,56 @@ export declare class DataHubCore {
      * if (biz.code === 'Ok') { /* handle success *\/ }
      */
     request<T = unknown>(url: string, data?: unknown, options?: DataHubRequestOptions): Promise<DataHubAdapterResponse<T>>;
+    /**
+     * 应用全局响应拦截器（命中缓存与实际请求路径共用）。
+     * Apply global response interceptor (shared by cache-hit and real-request paths).
+     */
+    private applyResponseInterceptor;
+    /**
+     * 实际执行请求：适配器调用 + 响应拦截 + HTTP 错误处理 + 统一响应处理 + 缓存写入。
+     * Execute the request: adapter call + response interceptor + HTTP error handling +
+     * unified response handling + cache write.
+     */
+    private executeRequest;
+    /**
+     * 构造 HTTP 传输层错误：优先用 APIStyle 解析响应体，回退到 transport error。
+     * Build HTTP transport error: try APIStyle first, fall back to transport error.
+     */
+    private buildHttpError;
+    /**
+     * 是否可缓存：strategy 默认判定，或 forceCache 强制启用。
+     * Whether cacheable: by strategy, or force-enabled by forceCache.
+     */
+    private isCacheable;
+    /**
+     * 是否可去重：strategy 默认判定，或 forceDedup 强制启用。
+     * Whether dedupable: by strategy, or force-enabled by forceDedup.
+     */
+    private isDedupable;
+    /**
+     * 是否需要幂等防护：strategy 判定为提交类、未跳过、且未被 force 选项豁免。
+     * Whether idempotent guard applies: strategy says submit, not skipped, and not
+     * exempted by forceDedup/forceCache (which mark the request as a query).
+     */
+    private shouldGuardIdempotent;
+    /**
+     * 统一响应处理：APIStyle 转换 + isSuccess 业务校验 + 返回业务数据
+     * Unified response handling: APIStyle transform + isSuccess check + return business data
+     *
+     * 抽取该方法的目的：让「实际请求路径」与「缓存命中路径」走完全一致的响应处理逻辑，
+     * 避免缓存命中时跳过 isSuccess 校验或丢失 code/message 等字段。
+     *
+     * This method is extracted so that both the real-request path and the cache-hit path
+     * share identical response handling, avoiding skipped isSuccess checks or lost
+     * code/message fields when cache hits.
+     *
+     * @param res - 适配器返回的原始响应 / Raw response from adapter
+     * @param requestStyle - 解析后的 APIStyle / Resolved APIStyle
+     * @param traceId - 链路追踪 ID / Trace ID
+     * @param fullUrl - 完整请求 URL / Full request URL
+     * @returns 业务数据已替换的响应 / Response with business data replaced
+     */
+    private handleResponse;
     /** 清空所有缓存 / Clear all cache */
     clearCache(): void;
     /** 清空所有去重记录 / Clear all dedup records */

package/dist/core/datahub/core/datahub-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datahub-core.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/core/datahub-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,IAAI,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAO7D,OAAO,EAA4B,eAAe,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAexF;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,uDAAuD;IACvD,OAAO,CAAC,MAAM,CAAiB;IAC/B,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAA8B;IAE9C;;OAEG;gBACS,MAAM,GAAE,aAAkB;IAatC;;;;OAIG;IACI,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIrD;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAM3D;;;;;;;;;;;;;;;OAeG;IACI,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI;IAezD;;;OAGG;IACI,WAAW,IAAI,eAAe,GAAG,SAAS;IAIjD;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;;;;;;;;;;;;;;;;OAkBG;IACU,OAAO,CAAC,CAAC,GAAG,OAAO,EAC9B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAsIrC,+BAA+B;IACxB,UAAU,IAAI,IAAI;IAIzB,yCAAyC;IAClC,UAAU,IAAI,IAAI;IAIzB,2CAA2C;IACpC,eAAe,IAAI,IAAI;IAM9B;;OAEG;IACI,qBAAqB,CAC1B,OAAO,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,qBAAqB,GAAG,IAAI,GACpE,IAAI;IAIP;;OAEG;IACI,sBAAsB,CAC3B,OAAO,EAAE,CACP,GAAG,EAAE,sBAAsB,EAC3B,GAAG,EAAE,qBAAqB,KACvB,sBAAsB,GAAG,IAAI,GACjC,IAAI;IAIP;;OAEG;IACI,eAAe,CACpB,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,qBAAqB,KAAK,IAAI,GACtE,IAAI;IAIP;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAIzD;;OAEG;IACI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;IAM3C,2DAA2D;IACpD,eAAe,yBAAmB;IAEzC,wEAAwE;IACjE,SAAS,mBAAa;IAI7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;;OAGG;IACH,OAAO,CAAC,cAAc;CA0BvB"}
+{"version":3,"file":"datahub-core.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/core/datahub-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EAEhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,IAAI,iBAAiB,EAAyC,MAAM,qBAAqB,CAAC;AAO/G,OAAO,EAA4B,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAenG;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,uDAAuD;IACvD,OAAO,CAAC,MAAM,CAAiB;IAC/B,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAA8B;IAE9C;;OAEG;gBACS,MAAM,GAAE,aAAkB;IAatC;;;;OAIG;IACI,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIrD;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAM3D;;;;;;;;;;;;;;;OAeG;IACI,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI;IAezD;;;OAGG;IACI,WAAW,IAAI,eAAe,GAAG,SAAS;IAIjD;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;;;;;;;;;;;;;;;;OAkBG;IACU,OAAO,CAAC,CAAC,GAAG,OAAO,EAC9B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IA8ErC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAMhC;;;;OAIG;YACW,cAAc;IAuD5B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAInB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,cAAc;IA+BtB,+BAA+B;IACxB,UAAU,IAAI,IAAI;IAIzB,yCAAyC;IAClC,UAAU,IAAI,IAAI;IAIzB,2CAA2C;IACpC,eAAe,IAAI,IAAI;IAM9B;;OAEG;IACI,qBAAqB,CAC1B,OAAO,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,qBAAqB,GAAG,IAAI,GACpE,IAAI;IAIP;;OAEG;IACI,sBAAsB,CAC3B,OAAO,EAAE,CACP,GAAG,EAAE,sBAAsB,EAC3B,GAAG,EAAE,qBAAqB,KACvB,sBAAsB,GAAG,IAAI,GACjC,IAAI;IAIP;;OAEG;IACI,eAAe,CACpB,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,qBAAqB,KAAK,IAAI,GACtE,IAAI;IAIP;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAIzD;;OAEG;IACI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;IAM3C,2DAA2D;IACpD,eAAe,yBAAmB;IAEzC,wEAAwE;IACjE,SAAS,mBAAa;IAI7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;;OAGG;IACH,OAAO,CAAC,cAAc;CA0BvB"}