xpe 0.0.0-alpha.1

package/framework/umd/core/Container/Container.d.ts

@@ -0,0 +1,80 @@
+import type { ClassConstructor } from '../Type/utility';
+import type { IContainer } from '../Type/types';
+/**
+ * Class Container
+ * 容器类
+ * @author SunnyXu <xy@ztes.com>
+ */
+export default class Container implements IContainer {
+    protected static instance: unknown;
+    protected instances: Map<any, any>;
+    protected bindings: Record<string, any>;
+    protected aliases: Record<string, any>;
+    /**
+     * bind 绑定实体
+     * @param {String|Array} abstract
+     * @param {*} concrete
+     */
+    bind(abstract: string | string[], concrete: any): void;
+    /**
+     * make 创建类的实例/获取对象 create instance/object
+     * @param abstract
+     * @param params
+     * @param shared
+     */
+    make(abstract: string, params?: object | [], shared?: boolean): any;
+    /**
+     * makeClass 创建类
+     * @param name
+     * @param executor
+     * @param params
+     * @param shared
+     */
+    protected makeClass(name: string, executor: ClassConstructor, params: unknown, shared?: boolean): any;
+    /**
+     * makeFunc 创建函数
+     * @param name
+     * @param executor
+     * @param params
+     * @param shared
+     * @protected
+     */
+    protected makeFunc(name: string, executor: CallableFunction, params: unknown, shared?: boolean): any;
+    /**
+     * has as existence
+     * 是否存在标识 existence 的别名
+     * @param {String} name
+     */
+    has(name: string): boolean;
+    /**
+     * existence 存在标识
+     * @param {String} name
+     */
+    existence(name: string): boolean;
+    /**
+     * getAlias 获取别名
+     * @param abstract
+     */
+    getAlias(abstract: string): any;
+    /**
+     * get 获取实例
+     * @param abstract
+     */
+    get(abstract: string): any;
+    /**
+     * singleton 单例
+     * @param abstract
+     * @param concrete
+     */
+    singleton(abstract: string, concrete: any): void;
+    /**
+     * getInstance 获取实例
+     *
+     */
+    static getInstance<Instance>(): Container | Instance;
+    /**
+     * proxyInstance 代理实例
+     *
+     */
+    protected proxyInstance(): this;
+}

package/framework/umd/core/Contracts/AxiosAdapter.d.ts

@@ -0,0 +1,12 @@
+import { HttpAdapterInterface } from '../Type/adapters';
+/**
+ * Class AxiosAdapter
+ * @description axios适配器，适配器主要完成
+ */
+export default class AxiosAdapter extends HttpAdapterInterface<{}> {
+    /**
+     * Method request
+     * @returns Promise
+     */
+    request(): Promise<unknown>;
+}

package/framework/umd/core/Helper/Helper.d.ts

@@ -0,0 +1,43 @@
+import Service from '../Service/Service';
+import type { IResponseReturn, TResponseDataReturn, IHelper } from '../Type/types';
+/**
+ * Class Helper
+ * @extends Service
+ */
+export default class Helper extends Service implements IHelper {
+    env(): Record<any, any>;
+    private webStorage;
+    /**
+     * Local storage
+     * @param name
+     * @param payload
+     */
+    storage(name?: string, payload?: any): any | Record<any, any>;
+    cookie(): void;
+    /**
+     * Session storage
+     * @param name
+     * @param payload
+     */
+    session(name?: string, payload?: any): any | Record<any, any>;
+    /**
+     * Method http
+     * 发起一个http请求
+     * @param api
+     * @param data
+     * @param handle
+     */
+    http(api: any, data: any, handle: any): Promise<TResponseDataReturn | IResponseReturn | undefined>;
+    /**
+     * 发送一个Http请求
+     * @param api
+     * @param data
+     * @param handle
+     * @param config
+     * @param returnResponse
+     */
+    send(api: any, data: any, handle: any, config: any, returnResponse?: boolean): Promise<TResponseDataReturn | IResponseReturn>;
+    checkAuth(): void;
+    cookies(name: string): Record<any, any>;
+    cookies(name: string, payload?: any): void;
+}

package/framework/umd/core/Helper/Storage/WebStorage.d.ts

@@ -0,0 +1,71 @@
+declare type Type = "localStorage" | "sessionStorage";
+/**
+ * Class WebStorage
+ * 浏览器存储
+ */
+export default class WebStorage {
+    type: Type;
+    storage: Storage;
+    /**
+     * constructor
+     * @param {String} type 存储类型
+     */
+    constructor({ type }: {
+        type: Type;
+    });
+    /**
+     * get get|getAll storage
+     * @param key
+     */
+    get(key?: string): string | any;
+    /**
+     * set
+     * Set storage 保持/设置数据
+     * @param key
+     * @param value
+     */
+    set(key: string, value: string | any[] | Record<any, any>): void;
+    /**
+     * save
+     * Save storage as set set的别名
+     * @param key
+     * @param value
+     */
+    save(key: string, value: string | any[] | Record<any, any>): void;
+    /**
+     * delete
+     * Delete storage 删除一个或数组内多个
+     * @param {String|Array<string>} key
+     */
+    delete(key: string | string[]): void;
+    /**
+     * remove
+     * Remove storage as delete delete的别名
+     * @param key
+     */
+    remove(key: string | string[]): void;
+    /**
+     * clear
+     * Clear storage 清空
+     */
+    clear(): void;
+    /**
+     * keys
+     * Get storage keys 获取全部键
+     * @return keys
+     */
+    keys(): string[];
+    /**
+     * getAll
+     * Get storage key & val 获取全部键值对
+     */
+    getAll(): Record<any, any>;
+    /**
+     * setConfig
+     * @param type
+     */
+    setConfig({ type }: {
+        type: Type;
+    }): void;
+}
+export {};

package/framework/umd/core/Libs/Exception.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Exception Class
+ * 目前原生的错误类型
+ * Error [一般错误类型]
+ * SyntaxError [语法错误]
+ * ReferenceError [不存在的变量]
+ * RangeError [超出有效范围]
+ * TypeError [非预期类型]
+ * URIError [URI参数错误]
+ * EvalError [eval函数没有正确执行]
+ * Example: throw new Exception() catch(error) error.name,error.message,error.code,error.stack
+ */
+export default class Exception extends Error {
+    name: string;
+    message: string;
+    code: number;
+    /**
+     *
+     * @param {String} name 错误名称
+     * @param {String} message 错误提示
+     * @param {Number} code 错误码
+     */
+    constructor(name: string, message: string, code?: number);
+}

package/framework/umd/core/Libs/Lib.d.ts

@@ -0,0 +1,72 @@
+declare type variableType = "string" | "number" | "object" | "undefined" | "function" | "boolean" | "bigInt" | "symbol";
+declare type TrimType = "R" | "L" | "";
+/**
+ * Class Lib
+ * 基础函数库，Lodash、Underscore... So big
+ */
+export default class Lib {
+    /**
+     * typeOf 判断变量类型
+     * @param value
+     * @param type
+     */
+    static typeOf<T>(value: unknown, type: variableType): value is T;
+    /**
+     * getTag 判断变量类型
+     * @param value
+     */
+    static getTag(value: unknown): string;
+    /**
+     * isFunction 是否函数
+     * @param {Function} value
+     * @return {Boolean}
+     */
+    static isFunction(value: unknown): value is typeof Function;
+    /**
+     * isString 是否字符串
+     * @param {String} value
+     * @return {Boolean}
+     */
+    static isString(value: unknown): value is string;
+    /**
+     * isNumber 是否数字
+     * @param value
+     * @return {Boolean}
+     */
+    static isNumber(value: unknown): value is number;
+    /**
+     * isObject 是否对象
+     * @param {Object} value
+     */
+    static isObject(value: unknown): value is Record<any, any>;
+    /**
+     * isObject 是否Undefined
+     * @param {*} value
+     * @return boolean
+     */
+    static isUndefined(value: unknown): boolean;
+    /**
+     * isNull 是否Null
+     * @param value
+     */
+    static isNull(value: unknown): boolean;
+    /**
+     * isEmpty 是否空
+     * 目前只对 null undefined '' {} [] 做处理
+     * @param value
+     */
+    static isEmpty(value: unknown): boolean;
+    /**
+     * isClass 是否类
+     * @param value
+     */
+    static isClass(value: unknown): boolean;
+    /**
+     * 字符串去除首尾字符
+     * @param str 字符串
+     * @param char 字符
+     * @param type 类型
+     */
+    static strTrim(str: string, char: string, type?: TrimType): string;
+}
+export {};

package/framework/umd/core/Provider/CommandProvider.d.ts

@@ -0,0 +1,4 @@
+import ServiceProvider from "./ServiceProvider";
+export default class CommandProvider extends ServiceProvider {
+    register(): void;
+}

package/framework/umd/core/Provider/HelperProvider.d.ts

@@ -0,0 +1,4 @@
+import ServiceProvider from "./ServiceProvider";
+export default class HelperProvider extends ServiceProvider {
+    register(): void;
+}

package/framework/umd/core/Provider/HttpProvider.d.ts

@@ -0,0 +1,13 @@
+import ServiceProvider from "./ServiceProvider";
+/**
+ * @name HttpProvider
+ * @description HTTP服务提供者，对HTTP服务进行注册
+ */
+export default class HttpProvider extends ServiceProvider {
+    /**
+     * Method Register
+     * 注册服务
+     * @protected
+     */
+    register(): void;
+}

package/framework/umd/core/Provider/ServiceProvider.d.ts

@@ -0,0 +1,15 @@
+import type { IApplicationInstance } from '../Type/types';
+export default abstract class ServiceProvider {
+    protected app: import("../Type/types").IApplication;
+    /**
+     * constructor
+     * @param app Application instance
+     *
+     */
+    constructor(app: IApplicationInstance);
+    /**
+     * register
+     * 注册 provider
+     */
+    register(): void;
+}

package/framework/umd/core/Service/HttpService.d.ts

@@ -0,0 +1,133 @@
+import Service from "./Service";
+import RESTful from "../Spanner/RESTful";
+import type { TContentType, TCarryData, IHttpSendConfig, RequestMethod, HTTP_SERVICE_CONFIG, DATA_CARRYING } from "../Type/types";
+import type { UtilityObject } from "../Type/utility";
+declare type IApplicationInstance = any;
+/**
+ * Class HttpService
+ */
+export default class HttpService extends Service {
+    _http: any;
+    _api: UtilityObject;
+    _headers: UtilityObject;
+    _host: string;
+    _isRESTful: boolean;
+    _RESTful: typeof RESTful;
+    _carryingData: UtilityObject;
+    _mode: string;
+    $helper: null;
+    _requestMiddleware: CallableFunction;
+    _responseMiddleware: CallableFunction;
+    /**
+     * _contentType Request type 请求类型
+     * 'application/json' 为 Request Payload 请求方式
+     * 'application/x-www-form-urlencoded;charset=UTF-8' 为 Form Data 请求方式 需QS配合使用
+     * OTHER Query String Parameters 为 _method = 'GET'
+     */
+    /**
+     * Constructor
+     * @param {Object} app
+     * @param {Object} HTTP_ADAPTER
+     * @param {String} HTTP_API
+     * @param {String} HTTP_HOST
+     * @param {Boolean} IS_RESTFUL
+     * @param {String} CONTENT_TYPE
+     * @param {Object} DATA_CARRYING
+     * @param {Function} REQUEST_MIDDLEWARE
+     * @param {Function} RESPONSE_MIDDLEWARE
+     */
+    constructor(app: IApplicationInstance, { HTTP_ADAPTER, HTTP_API, HTTP_HOST, IS_RESTFUL, CONTENT_TYPE, DATA_CARRYING, REQUEST_MIDDLEWARE, RESPONSE_MIDDLEWARE, }: HTTP_SERVICE_CONFIG);
+    /**
+     * Method setContentType 设置请求类型
+     * @param {String} mode
+     */
+    setContentType(mode: TContentType): void;
+    /**
+     * Method setDataCarry 处理携带数据
+     * @param {*} REQUEST_HEADERS
+     * @param {*} REQUEST_DATA
+     */
+    setDataCarry(REQUEST_HEADERS: DATA_CARRYING["REQUEST_HEADERS"], REQUEST_DATA: DATA_CARRYING["REQUEST_DATA"]): void;
+    /**
+     * Method carryingHandle 携带数据处理
+     * @param {String} name
+     * @param {*} val
+     * @param {*} type
+     */
+    carryingHandle(name: string, val: any, type?: TCarryData): void;
+    /**
+     * Method http 发送一个请求
+     * @param {String} apiRoute
+     * @param {JSON} data
+     * @param {Boolean} returnResponse
+     * @returns
+     */
+    http(apiRoute: string, data: Record<string, any>, returnResponse?: boolean): Promise<any>;
+    /**
+     * Send Request
+     * @param {Boolean} returnResponse 返回response还是response.data
+     * @returns {Promise<*|*>}
+     */
+    request(returnResponse: boolean): Promise<any>;
+    /**
+     * Method Send
+     * 发送一个自定义请求
+     * @param apiRoute
+     * @param data
+     * @param config
+     * @returns {Promise<void>}
+     */
+    send(apiRoute: string, data: Record<string, any>, config?: IHttpSendConfig): Promise<any>;
+    /**
+     * Method getParameters
+     * 从Api里读取请求方法、参数和地址
+     * @param {*} apiRoute
+     * @param {*} data
+     * @returns
+     */
+    getParameters(apiRoute: string, data: Record<string, any>): {
+        url: string;
+        method: RequestMethod;
+        data: any;
+        auth: boolean;
+        params: {
+            host: string;
+            method: RequestMethod;
+            uri: string;
+            data: any;
+            auth: boolean;
+        };
+    };
+    /**
+     * Method transformRESTful
+     * 使用扳手工具处理RESTful数据
+     * @param {*} uri
+     * @param {*} data
+     * @returns
+     */
+    transformRESTful(uri: string, data?: Record<string, any>): {
+        uri: string;
+        data: any;
+    };
+    /**
+     * Method setHeaders
+     * 设置Headers multiple
+     * @param {JSON|Object} config
+     */
+    setHeaders(config?: {}): void;
+    /**
+     * Method setHeader
+     * 设置Headers single
+     * @param {String} name
+     * @param {String} val
+     */
+    setHeader(name: string, val: string | number | any): void;
+    /**
+     * Method setData
+     * 设置携带数据 通过Data
+     * @param {*} name
+     * @param {*} val
+     */
+    setData(name: string, val: string | number | any): void;
+}
+export {};

package/framework/umd/core/Service/Service.d.ts

@@ -0,0 +1,6 @@
+declare type IApplicationInstance = any;
+export default abstract class Service {
+    protected app: IApplicationInstance;
+    constructor(app: IApplicationInstance);
+}
+export {};

package/framework/umd/core/Spanner/RESTful.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Class RESTful
+ * RESTful处理类
+ * @author SunnyXu <xy@ztes.com>
+ */
+export default class RESTful {
+    private readonly isRESTful;
+    private uri;
+    private readonly requestData;
+    /**
+     * Method constructor
+     * @param {String} uri
+     * @param {*} data
+     * @param {*} mode
+     * @returns
+     */
+    constructor(uri: string, data: any, mode: boolean);
+    /**
+     * Method create
+     * 创建RESTful数据
+     */
+    create(): {
+        uri: string;
+        data: any;
+    };
+    /**
+     *  private method transformer
+     */
+    private transformer;
+}

package/framework/umd/core/Transformer/Transformer.d.ts

@@ -0,0 +1,46 @@
+declare type Callback = (item: Record<any, any>, index?: number) => Record<any, any>;
+/**
+ * Class Transformer 转换器
+ * NewTransformer extends Transformer -> constructor(){super(data,payload)}
+ */
+export default class Transformer {
+    private readonly data;
+    private payload;
+    /**
+     * Method constructor
+     * @param {*} data 需处理的数据
+     * @param {*} payload 携带的载荷
+     * @returns
+     */
+    constructor(data: any, payload?: unknown);
+    /**
+     * Method transform
+     * 转换方法
+     * @param {Object|String|Number} data
+     * @param tData
+     * @returns
+     */
+    transform(data: any, tData?: any): any;
+    /**
+     * Method create
+     * 创建新数据
+     * @return {Array/Object|String|Number|*}
+     */
+    create(callback?: Callback): any;
+    /**
+     * 格式化数字
+     * @param {String|Number} number 待处理数字
+     * @param {Number} places 小数点位数 -1为原样保留
+     * @param {String} thousand 千位字符串 默认为空
+     * @param {String} decimal 小数点替换字符 默认为.
+     * @return {String|Number}
+     */
+    formatNumber(number: string | number, places?: number | string, thousand?: string, decimal?: string): string;
+    /**
+     * formatDate 日期格式化
+     * @param {string|number} timestamp
+     * @returns
+     */
+    formatDate(timestamp?: number | string | unknown): Record<string, number | string>;
+}
+export {};

package/framework/umd/core/Type/adapters.d.ts

@@ -0,0 +1,25 @@
+import type { IHttpAdapter, RequestConfig, RequestMethod } from './types';
+export declare abstract class HttpAdapterInterface<T> {
+    protected http: IHttpAdapter<T>;
+    protected method: RequestMethod;
+    protected url: string;
+    protected data: {};
+    protected headers: {};
+    /**
+     * Method constructor 注入Axios
+     * @param {*} $function
+     * @returns
+     */
+    protected constructor($function: IHttpAdapter<T>);
+    /**
+     * Method setConfig
+     * 设置配置信息
+     * @param {method,url,data,headers} param
+     */
+    setConfig({ method, url, data, headers }: RequestConfig): void;
+    /**
+     * Method request
+     * @returns Promise
+     */
+    request(): Promise<unknown>;
+}