@gct-paas/core 0.1.4-dev.0 → 0.1.4-dev.1

package/es/create-app-vue.d.ts

@@ -0,0 +1,8 @@
+import { App } from 'vue';
+/**
+ * 创建 Vue 应用并配置全局错误处理
+ *
+ * @export
+ * @param {App} app Vue 应用实例
+ */
+export declare function createAppVue(app: App): Promise<void>;

package/es/create-app-vue.mjs

@@ -0,0 +1,8 @@
+import { setupErrorHandler } from './modules/error-handler/index.mjs';
+
+"use strict";
+async function createAppVue(app) {
+  await setupErrorHandler(app);
+}
+
+export { createAppVue };

package/es/global/gct/gct.d.ts

@@ -1,4 +1,6 @@
 import { I18n } from 'vue-i18n';
+import { ApiManage as APaasApiManage } from '@gct-paas/api-apaas';
+import { ApiManage as PlatformApiManage } from '@gct-paas/api-platform';
 import { GlobalStoreUtil } from '../../store';
 import { DesignerRegister, EditorRegister, FormItemRegister, RenderRegister } from '../../register';
 import { IMessageUtil } from '../../interface';
@@ -54,7 +56,10 @@ export declare class GctGlobal {
     /**
      * 所有后台 api 服务
      */
-    api: {};
+    api: {
+        apaas: APaasApiManage;
+        platform: PlatformApiManage;
+    };
     /**
      * i18n 实例的 t 方法，多语言转换
      *

package/es/global/gct/gct.mjs

@@ -1,4 +1,6 @@
 import { createI18n } from 'vue-i18n';
+import '../../node_modules/.pnpm/@gct-paas_api-apaas@0.0.2-dev.0/node_modules/@gct-paas/api-apaas/es/index.mjs';
+import '../../node_modules/.pnpm/@gct-paas_api-platform@0.0.2-dev.0/node_modules/@gct-paas/api-platform/es/index.mjs';
 import { GlobalStoreUtil } from '../../store/index.mjs';
 import '../../register/index.mjs';
 import '../../utils/index.mjs';
@@ -7,6 +9,8 @@ import { FormItemRegister } from '../../register/form-item-register/form-item-re
 import { EditorRegister } from '../../register/editor-register/editor-register.mjs';
 import { RenderRegister } from '../../register/render-register/render-register.mjs';
 import { DesignerRegister } from '../../register/designer-register/designer-register.mjs';
+import { ApiManage } from '../../node_modules/.pnpm/@gct-paas_api-platform@0.0.2-dev.0/node_modules/@gct-paas/api-platform/es/service/index.mjs';
+import { ApiManage as ApiManage$1 } from '../../node_modules/.pnpm/@gct-paas_api-apaas@0.0.2-dev.0/node_modules/@gct-paas/api-apaas/es/service/index.mjs';
 
 "use strict";
 class GctGlobal {
@@ -54,7 +58,10 @@ class GctGlobal {
   /**
    * 所有后台 api 服务
    */
-  api = {};
+  api = {
+    apaas: new ApiManage$1(),
+    platform: new ApiManage()
+  };
   /**
    * i18n 实例的 t 方法，多语言转换
    *

package/es/index.d.ts

@@ -6,10 +6,10 @@ export * from './hooks';
 export * from './interface';
 export * from './provider';
 export * from './register';
-export * from './service';
 export * from './state';
 export * from './store';
 export * from './utils';
+export { createAppVue } from './create-app-vue';
 /**
  * 安装核心包，主要用于一些参数的初始化
  *

package/es/index.mjs

@@ -6,10 +6,10 @@ import './hooks/index.mjs';
 import './interface/index.mjs';
 import './provider/index.mjs';
 import './register/index.mjs';
-import './service/index.mjs';
 import './state/index.mjs';
 export { GlobalStoreUtil } from './store/index.mjs';
 import './utils/index.mjs';
+export { createAppVue } from './create-app-vue.mjs';
 import { GctGlobal } from './global/gct/gct.mjs';
 export { EditorRegisterConst } from './constants/editor-register/editor-register.mjs';
 export { EditorType, EditorTypeOld } from './constants/editor-type/editor-type.mjs';
@@ -58,7 +58,6 @@ export { DesignerRegister } from './register/designer-register/designer-register
 export { EditorRegister } from './register/editor-register/editor-register.mjs';
 export { FormItemRegister } from './register/form-item-register/form-item-register.mjs';
 export { RenderRegister } from './register/render-register/render-register.mjs';
-export { BaseService } from './service/base.service.mjs';
 export { GlobalPiniaState } from './state/global-pinia-state/global-pinia-state.mjs';
 export { FormState } from './state/form/form.state.mjs';
 export { FormCollapsePaneState } from './state/form-collapse-pane/form-collapse-pane.state.mjs';
@@ -69,13 +68,12 @@ export { FormEditItemState } from './state/form-edit-item/form-edit-item.state.m
 export { FormGroupState } from './state/form-group/form-group.state.mjs';
 export { FormItemState } from './state/form-item/form-item.state.mjs';
 export { FormItemBasicState } from './state/form-item-basic/form-item-basic.state.mjs';
-export { HttpUtil } from './utils/axios/axios.mjs';
 export { DictionaryUtil } from './utils/dictionary/dictionary.mjs';
 export { t } from './utils/i18n/index.mjs';
 export { Namespace } from './utils/namespace/namespace.mjs';
 export { PluginPgkUtil } from './utils/plugin-pkg-util/plugin-pkg-util.mjs';
 export { PluginStaticResource } from './utils/plugin-static-resource/plugin-static-resource.mjs';
-export { deepMerge, getPathQuery, getTenant, getTimezone, getToken, isMobile, setTenant, setToken } from './utils/tools/tools.mjs';
+export { getPathQuery, getTenant, getTimezone, getToken, isMobile, setTenant, setToken } from './utils/tools/tools.mjs';
 export { widthEditorInstall } from './utils/width-install/width-install.mjs';
 
 "use strict";

package/es/modules/error-handler/error-handler.const.d.ts

@@ -0,0 +1,48 @@
+/** HTTP 状态码常量 */
+export declare const HTTP_STATUS_CODE: {
+    /** 未授权 */
+    readonly UNAUTHORIZED: 401;
+    /** 禁止访问 */
+    readonly FORBIDDEN: 403;
+    /** 资源未找到 */
+    readonly NOT_FOUND: 404;
+    /** 内部服务器错误 */
+    readonly INTERNAL_SERVER_ERROR: 500;
+    /** 网关错误 */
+    readonly BAD_GATEWAY: 502;
+    /** 服务不可用 */
+    readonly SERVICE_UNAVAILABLE: 503;
+    /** 网关超时 */
+    readonly GATEWAY_TIMEOUT: 504;
+};
+/** 错误日志输出模板 */
+export declare const ERROR_LOG_TEMPLATE: {
+    /** JavaScript 错误模板 */
+    readonly SCRIPT_ERROR: "[SCRIPT ERROR]";
+    /** Vue 组件错误模板 */
+    readonly VUE_ERROR: "[VUE ERROR]";
+    /** 资源加载错误模板 */
+    readonly RESOURCE_ERROR: "[RESOURCE ERROR]";
+    /** Ajax 请求错误模板 */
+    readonly AJAX_ERROR: "[AJAX ERROR]";
+    /** Promise 异常模板 */
+    readonly PROMISE_ERROR: "[PROMISE ERROR]";
+};
+/** 网络状态消息 */
+export declare const NETWORK_STATUS_MESSAGE: {
+    /** 网络连接丢失 */
+    readonly CONNECTION_LOST: "Network connection lost";
+    /** 网络连接恢复 */
+    readonly CONNECTION_RESTORED: "Network connection restored";
+};
+/** 错误处理事件名称 */
+export declare const ERROR_EVENT_NAMES: {
+    /** JavaScript 错误事件 */
+    readonly ERROR: "error";
+    /** Promise 拒绝事件 */
+    readonly UNHANDLED_REJECTION: "unhandledrejection";
+    /** 网络离线事件 */
+    readonly OFFLINE: "offline";
+    /** 网络在线事件 */
+    readonly ONLINE: "online";
+};

package/es/modules/error-handler/error-handler.const.mjs

@@ -0,0 +1,47 @@
+"use strict";
+const HTTP_STATUS_CODE = {
+  /** 未授权 */
+  UNAUTHORIZED: 401,
+  /** 禁止访问 */
+  FORBIDDEN: 403,
+  /** 资源未找到 */
+  NOT_FOUND: 404,
+  /** 内部服务器错误 */
+  INTERNAL_SERVER_ERROR: 500,
+  /** 网关错误 */
+  BAD_GATEWAY: 502,
+  /** 服务不可用 */
+  SERVICE_UNAVAILABLE: 503,
+  /** 网关超时 */
+  GATEWAY_TIMEOUT: 504
+};
+const ERROR_LOG_TEMPLATE = {
+  /** JavaScript 错误模板 */
+  SCRIPT_ERROR: "[SCRIPT ERROR]",
+  /** Vue 组件错误模板 */
+  VUE_ERROR: "[VUE ERROR]",
+  /** 资源加载错误模板 */
+  RESOURCE_ERROR: "[RESOURCE ERROR]",
+  /** Ajax 请求错误模板 */
+  AJAX_ERROR: "[AJAX ERROR]",
+  /** Promise 异常模板 */
+  PROMISE_ERROR: "[PROMISE ERROR]"
+};
+const NETWORK_STATUS_MESSAGE = {
+  /** 网络连接丢失 */
+  CONNECTION_LOST: "Network connection lost",
+  /** 网络连接恢复 */
+  CONNECTION_RESTORED: "Network connection restored"
+};
+const ERROR_EVENT_NAMES = {
+  /** JavaScript 错误事件 */
+  ERROR: "error",
+  /** Promise 拒绝事件 */
+  UNHANDLED_REJECTION: "unhandledrejection",
+  /** 网络离线事件 */
+  OFFLINE: "offline",
+  /** 网络在线事件 */
+  ONLINE: "online"
+};
+
+export { ERROR_EVENT_NAMES, ERROR_LOG_TEMPLATE, HTTP_STATUS_CODE, NETWORK_STATUS_MESSAGE };

package/es/modules/error-handler/error-handler.interface.d.ts

@@ -0,0 +1,51 @@
+import { ErrorTypeEnum } from '../../enums/exceptionEnum';
+/**
+ * 错误详细信息接口
+ * 定义了错误处理系统中基础错误信息的结构
+ *
+ * @interface IErrorInfo
+ */
+export interface IErrorInfo {
+    /** 错误类型 */
+    type: ErrorTypeEnum;
+    /** 错误消息 */
+    message: string;
+    /** 错误堆栈信息 */
+    stack?: string;
+    /** 错误发生的时间戳 */
+    timestamp: number;
+    /** 用户代理信息 */
+    userAgent?: string;
+}
+/**
+ * HTTP 错误信息接口
+ * 扩展基础错误信息，增加 HTTP 请求相关的错误详情
+ *
+ * @interface IHttpErrorInfo
+ */
+export interface IHttpErrorInfo extends IErrorInfo {
+    /** HTTP 状态码 */
+    status?: number;
+    /** HTTP 状态文本 */
+    statusText?: string;
+    /** 请求 URL */
+    requestUrl?: string;
+    /** 请求方法 */
+    requestMethod?: string;
+    /** 响应数据 */
+    responseData?: unknown;
+}
+/**
+ * 错误处理策略接口
+ * 定义不同类型错误的处理策略
+ *
+ * @interface IErrorHandlerStrategy
+ */
+export interface IErrorHandlerStrategy {
+    /**
+     * 处理错误
+     *
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    handle(errorInfo: IErrorInfo): void;
+}

package/es/modules/error-handler/error-handler.interface.mjs

@@ -0,0 +1 @@
+"use strict";

package/es/modules/error-handler/error-strategy.d.ts

@@ -0,0 +1,138 @@
+import { IErrorInfo, IErrorHandlerStrategy } from './error-handler.interface';
+import { ErrorTypeEnum } from '../../enums/exceptionEnum';
+/**
+ * JavaScript 错误处理策略
+ * 负责处理 JavaScript 运行时错误
+ *
+ * @export
+ * @class JavaScriptErrorStrategy
+ * @implements {IErrorHandlerStrategy}
+ */
+export declare class JavaScriptErrorStrategy implements IErrorHandlerStrategy {
+    /**
+     * 处理 JavaScript 错误
+     *
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    handle(errorInfo: IErrorInfo): void;
+}
+/**
+ * Vue 组件错误处理策略
+ * 负责处理 Vue 组件相关错误
+ *
+ * @export
+ * @class VueErrorStrategy
+ * @implements {IErrorHandlerStrategy}
+ */
+export declare class VueErrorStrategy implements IErrorHandlerStrategy {
+    /**
+     * 处理 Vue 组件错误
+     *
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    handle(errorInfo: IErrorInfo): void;
+}
+/**
+ * Promise 错误处理策略
+ * 负责处理未捕获的 Promise 异常，包括 HTTP 请求错误
+ *
+ * @export
+ * @class PromiseErrorStrategy
+ * @implements {IErrorHandlerStrategy}
+ */
+export declare class PromiseErrorStrategy implements IErrorHandlerStrategy {
+    /**
+     * 处理 Promise 错误
+     *
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    handle(errorInfo: IErrorInfo): void;
+}
+/**
+ * HTTP 错误处理策略
+ * 负责处理 HTTP 请求相关错误，包括网络错误和业务错误
+ *
+ * @export
+ * @class HttpErrorStrategy
+ * @implements {IErrorHandlerStrategy}
+ */
+export declare class HttpErrorStrategy implements IErrorHandlerStrategy {
+    /**
+     * 处理 HTTP 错误
+     *
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    handle(errorInfo: IErrorInfo): void;
+    /**
+     * 从错误消息中提取 HTTP 状态码
+     *
+     * @private
+     * @param {string} message 错误消息
+     * @return {number | null} HTTP 状态码，如果没有找到则返回 null
+     */
+    private _extractStatusCode;
+    /**
+     * 处理通用 HTTP 错误
+     *
+     * @private
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    private _handleGenericHttpError;
+    /**
+     * 处理未授权错误
+     *
+     * @private
+     */
+    private _handleUnauthorized;
+    /**
+     * 处理禁止访问错误
+     *
+     * @private
+     */
+    private _handleForbidden;
+    /**
+     * 处理资源未找到错误
+     *
+     * @private
+     */
+    private _handleNotFound;
+    /**
+     * 处理服务器错误
+     *
+     * @private
+     * @param {number} [status] HTTP 状态码
+     */
+    private _handleServerError;
+}
+/**
+ * 错误处理策略工厂
+ * 负责根据错误类型创建对应的处理策略
+ *
+ * @export
+ * @class ErrorStrategyFactory
+ */
+export declare class ErrorStrategyFactory {
+    private static _strategies;
+    /**
+     * 初始化策略工厂
+     *
+     * @static
+     */
+    static init(): void;
+    /**
+     * 获取错误处理策略
+     *
+     * @static
+     * @param {ErrorTypeEnum} type 错误类型
+     * @return {IErrorHandlerStrategy | undefined} 错误处理策略
+     */
+    static getStrategy(type: ErrorTypeEnum): IErrorHandlerStrategy | undefined;
+    /**
+     * 注册自定义错误处理策略
+     *
+     * @static
+     * @param {ErrorTypeEnum} type 错误类型
+     * @param {IErrorHandlerStrategy} strategy 错误处理策略
+     */
+    static registerStrategy(type: ErrorTypeEnum, strategy: IErrorHandlerStrategy): void;
+}

package/es/modules/error-handler/error-strategy.mjs

@@ -0,0 +1,173 @@
+import { HTTP_STATUS_CODE } from './error-handler.const.mjs';
+import { ErrorTypeEnum } from '../../enums/exceptionEnum.mjs';
+
+"use strict";
+class JavaScriptErrorStrategy {
+  /**
+   * 处理 JavaScript 错误
+   *
+   * @param {IErrorInfo} errorInfo 错误信息
+   */
+  handle(errorInfo) {
+    console.error(errorInfo);
+  }
+}
+class VueErrorStrategy {
+  /**
+   * 处理 Vue 组件错误
+   *
+   * @param {IErrorInfo} errorInfo 错误信息
+   */
+  handle(errorInfo) {
+    console.error(errorInfo);
+  }
+}
+class PromiseErrorStrategy {
+  /**
+   * 处理 Promise 错误
+   *
+   * @param {IErrorInfo} errorInfo 错误信息
+   */
+  handle(errorInfo) {
+    if (errorInfo.type === ErrorTypeEnum.AJAX) {
+      const httpStrategy = new HttpErrorStrategy();
+      httpStrategy.handle(errorInfo);
+      return;
+    }
+    console.error(errorInfo);
+  }
+}
+class HttpErrorStrategy {
+  /**
+   * 处理 HTTP 错误
+   *
+   * @param {IErrorInfo} errorInfo 错误信息
+   */
+  handle(errorInfo) {
+    const status = this._extractStatusCode(errorInfo.message);
+    if (status) {
+      switch (status) {
+        case HTTP_STATUS_CODE.UNAUTHORIZED:
+          this._handleUnauthorized();
+          break;
+        case HTTP_STATUS_CODE.FORBIDDEN:
+          this._handleForbidden();
+          break;
+        case HTTP_STATUS_CODE.NOT_FOUND:
+          this._handleNotFound();
+          break;
+        case HTTP_STATUS_CODE.INTERNAL_SERVER_ERROR:
+        case HTTP_STATUS_CODE.BAD_GATEWAY:
+        case HTTP_STATUS_CODE.SERVICE_UNAVAILABLE:
+        case HTTP_STATUS_CODE.GATEWAY_TIMEOUT:
+          this._handleServerError(status);
+          break;
+        default:
+          this._handleGenericHttpError(errorInfo);
+          break;
+      }
+    } else {
+      this._handleGenericHttpError(errorInfo);
+    }
+  }
+  /**
+   * 从错误消息中提取 HTTP 状态码
+   *
+   * @private
+   * @param {string} message 错误消息
+   * @return {number | null} HTTP 状态码，如果没有找到则返回 null
+   */
+  _extractStatusCode(message) {
+    const statusMatch = message.match(
+      /HTTP\s+(\d{3})|Business\s+Error\s+\[(\d+)\]/
+    );
+    if (statusMatch) {
+      return parseInt(statusMatch[1] || statusMatch[2], 10);
+    }
+    return null;
+  }
+  /**
+   * 处理通用 HTTP 错误
+   *
+   * @private
+   * @param {IErrorInfo} errorInfo 错误信息
+   */
+  _handleGenericHttpError(errorInfo) {
+    if (errorInfo.message.includes("Business Error")) {
+      console.debug("Handling business error:", errorInfo.message);
+    } else if (errorInfo.message.includes("Network")) {
+      console.debug("Handling network error:", errorInfo.message);
+    } else {
+      console.debug("Handling HTTP error:", errorInfo.message);
+    }
+  }
+  /**
+   * 处理未授权错误
+   *
+   * @private
+   */
+  _handleUnauthorized() {
+    console.warn("Unauthorized access, redirecting to login...");
+  }
+  /**
+   * 处理禁止访问错误
+   *
+   * @private
+   */
+  _handleForbidden() {
+    console.warn("Access forbidden");
+  }
+  /**
+   * 处理资源未找到错误
+   *
+   * @private
+   */
+  _handleNotFound() {
+    console.warn("Resource not found");
+  }
+  /**
+   * 处理服务器错误
+   *
+   * @private
+   * @param {number} [status] HTTP 状态码
+   */
+  _handleServerError(status) {
+    console.warn(`Server error: ${status}`);
+  }
+}
+class ErrorStrategyFactory {
+  static _strategies = /* @__PURE__ */ new Map();
+  /**
+   * 初始化策略工厂
+   *
+   * @static
+   */
+  static init() {
+    this.registerStrategy(ErrorTypeEnum.SCRIPT, new JavaScriptErrorStrategy());
+    this.registerStrategy(ErrorTypeEnum.VUE, new VueErrorStrategy());
+    this.registerStrategy(ErrorTypeEnum.PROMISE, new PromiseErrorStrategy());
+    this.registerStrategy(ErrorTypeEnum.AJAX, new HttpErrorStrategy());
+  }
+  /**
+   * 获取错误处理策略
+   *
+   * @static
+   * @param {ErrorTypeEnum} type 错误类型
+   * @return {IErrorHandlerStrategy | undefined} 错误处理策略
+   */
+  static getStrategy(type) {
+    return this._strategies.get(type);
+  }
+  /**
+   * 注册自定义错误处理策略
+   *
+   * @static
+   * @param {ErrorTypeEnum} type 错误类型
+   * @param {IErrorHandlerStrategy} strategy 错误处理策略
+   */
+  static registerStrategy(type, strategy) {
+    this._strategies.set(type, strategy);
+  }
+}
+
+export { ErrorStrategyFactory, HttpErrorStrategy, JavaScriptErrorStrategy, PromiseErrorStrategy, VueErrorStrategy };

package/es/modules/error-handler/index.d.ts

@@ -0,0 +1,78 @@
+import { IErrorInfo } from './error-handler.interface';
+import { ErrorTypeEnum } from '../../enums/exceptionEnum';
+import { App } from 'vue';
+/**
+ * 全局异常处理器
+ * 负责捕获和处理各种类型的异常，包括 Vue 组件异常、JavaScript 异常、
+ * 资源加载异常、Ajax 请求异常、Promise 异常等
+ *
+ * 采用策略模式和单例模式设计，支持扩展和配置
+ *
+ * @export
+ * @class ErrorHandler
+ */
+export declare class ErrorHandler {
+    private static _instance;
+    /**
+     * 私有构造函数，实现单例模式
+     *
+     * @private
+     */
+    private constructor();
+    /**
+     * 获取单例实例
+     *
+     * @static
+     * @return {ErrorHandler} 错误处理器实例
+     */
+    static getInstance(): ErrorHandler;
+    /**
+     * 初始化全局异常处理
+     * 设置全局异常监听器和处理策略
+     *
+     * @static
+     */
+    static init(): void;
+    /**
+     * 处理 Vue 组件异常
+     *
+     * @static
+     * @param {Error} error 错误对象
+     * @param {unknown} _vm Vue 组件实例
+     * @param {string} info 错误信息
+     */
+    static handleVueError(error: Error, _vm: unknown, info: string): void;
+    /**
+     * 手动报告错误
+     *
+     * @static
+     * @param {Error} error 错误对象
+     * @param {ErrorTypeEnum} [type=ErrorTypeEnum.SCRIPT] 错误类型
+     */
+    static reportError(error: Error, type?: ErrorTypeEnum): void;
+    /**
+     * 初始化错误处理策略
+     *
+     * @private
+     */
+    private _initializeStrategies;
+    /**
+     * 处理错误信息
+     *
+     * @private
+     * @param {IErrorInfo} errorInfo 错误信息
+     */
+    private _processError;
+}
+/**
+ * 设置全局错误处理器
+ *
+ * @author chitanda
+ * @date 2025-08-20 13:08:23
+ * @export
+ * @param {App} app
+ * @returns {*}  {Promise<void>}
+ */
+export declare function setupErrorHandler(app: App): Promise<void>;
+export type { IErrorInfo };
+export { ErrorStrategyFactory } from './error-strategy';