jinbi-utils 1.0.21 → 1.0.23

package/src/http/apiBuilder/example.ts

@@ -1,243 +0,0 @@
-/**
- * 使用示例
- */
-
-import type { FieldCatalog } from './api-builder';
-import { ApiBuilder } from './api-builder';
-
-// 字段目录
-const cartFieldCatalog: FieldCatalog = {
-  'sfs_cart.id': {
-    type: 'number',
-    label: '主键ID',
-    allowed_field: 'id',
-    nullable: false,
-    dict_field: false,
-  },
-  'sfs_cart.user_id': {
-    type: 'number',
-    label: '用户ID',
-    allowed_field: 'user_id',
-    nullable: false,
-    dict_field: false,
-  },
-  'sfs_cart.goods_id': {
-    type: 'number',
-    label: '商品ID',
-    allowed_field: 'goods_id',
-    nullable: false,
-    dict_field: false,
-  },
-  'sfs_cart.quantity': {
-    type: 'number',
-    label: '购买数量',
-    allowed_field: 'quantity',
-    nullable: true,
-    dict_field: false,
-  },
-  'sfs_cart.selected': {
-    type: 'number',
-    label: '是否选中',
-    allowed_field: 'selected',
-    nullable: false,
-    dict_field: true,
-  },
-  'sfs_cart.is_deleted': {
-    type: 'number',
-    label: '逻辑删除',
-    allowed_field: 'is_deleted',
-    nullable: false,
-    dict_field: false,
-  },
-};
-
-// ========== 新用法：实例化后使用（推荐）==========
-console.log('=== 新用法：实例化 ApiBuilder（推荐）===');
-const cartApi = new ApiBuilder(cartFieldCatalog);
-
-// ========== 不传 fieldCatalog（简化版）==========
-console.log('\n=== 不传 fieldCatalog（不拼接 field_catalog 字段）===');
-const simpleApi = new ApiBuilder(); // 不传参数
-
-// 查询示例 - 基础用法
-console.log('\n=== 查询示例 - 基础用法 ===');
-const queryParams = cartApi.query()
-  .where('user_id', 10086) // 简化：默认 =
-  .where('is_deleted', 0)
-  .orderBy('created_time', 'desc')
-  .limit(20)
-  .offset(0)
-  .build();
-
-console.log(JSON.stringify(queryParams, null, 2));
-
-// 查询示例 - 对象形式
-console.log('\n=== 查询示例 - 对象形式 ===');
-const queryParams2 = cartApi.query()
-  .where({ user_id: 10086, is_deleted: 0 })
-  .orderBy('created_time', 'desc')
-  .limit(20)
-  .build();
-
-console.log(JSON.stringify(queryParams2, null, 2));
-
-// 查询示例 - 特殊条件
-console.log('\n=== 查询示例 - 特殊条件 ===');
-const queryParams3 = cartApi.query()
-  .whereIn('status', [1, 2, 3])
-  .whereLike('goods_name', '%手机%')
-  .whereNotNull('goods_price')
-  .orderBy('created_time', 'desc')
-  .limit(20)
-  .build();
-
-console.log(JSON.stringify(queryParams3, null, 2));
-
-// 新增示例
-console.log('\n=== 新增示例 ===');
-const insertParams = cartApi.insert()
-  .add({
-    cart_id: 19,
-    user_id: 10086,
-    store_id: 2001,
-    goods_id: 30005,
-    quantity: 6,
-    goods_price: 50,
-    selected: 1,
-  })
-  .build();
-
-console.log(JSON.stringify(insertParams, null, 2));
-
-// 更新示例
-console.log('\n=== 更新示例 ===');
-const updateParams = cartApi.update()
-  .set({ selected: 1 })
-  .where({ id: 1 })
-  .build();
-
-console.log(JSON.stringify(updateParams, null, 2));
-
-// 批量更新示例
-console.log('\n=== 批量更新示例 ===');
-const batchUpdateParams = cartApi.update()
-  .set({ selected: 0 })
-  .where({ id: 1 })
-  .and()
-  .set({ is_deleted: 1 })
-  .where({ goods_id: 8, user_id: 8 })
-  .build();
-
-console.log(JSON.stringify(batchUpdateParams, null, 2));
-
-// ========== Knex 风格查询示例 ==========
-console.log('\n=== Knex 风格查询 ===');
-const knexStyleQuery = cartApi.query()
-  .where('user_id', 10086)
-  .where('is_deleted', 0)
-  .orderBy('created_time', 'desc')
-  .limit(20)
-  .offset(0)
-  .build();
-
-console.log('类似 Knex.js 的简洁语法：');
-console.log(JSON.stringify(knexStyleQuery, null, 2));
-
-// ========== 不传 fieldCatalog 的查询示例 ==========
-console.log('\n=== 不传 fieldCatalog 的查询（无 field_catalog 字段）===');
-const simpleQuery = simpleApi.query()
-  .where('user_id', 10086)
-  .where('is_deleted', 0)
-  .limit(20)
-  .build();
-
-console.log('生成的参数（不包含 field_catalog）：');
-console.log(JSON.stringify(simpleQuery, null, 2));
-
-// ========== 旧用法：静态方法（仍然支持）==========
-console.log('\n=== 旧用法：静态方法（向后兼容）===');
-const oldStyleQuery = ApiBuilder.query(cartFieldCatalog)
-  .where('user_id', '=', 10086)
-  .build();
-
-console.log(JSON.stringify(oldStyleQuery, null, 2));
-
-// ========== 实际应用示例 ==========
-console.log('\n=== 实际应用示例 ===');
-
-// 购物车服务类（新用法）
-class CartService {
-  private static api = new ApiBuilder(cartFieldCatalog);
-
-  // 查询购物车
-  static getCart(userId: number, page: number = 1, pageSize: number = 20) {
-    return this.api.query()
-      .where('user_id', userId) // 简化：默认 =
-      .where('is_deleted', 0)
-      .orderBy('created_time', 'desc')
-      .limit(pageSize)
-      .offset((page - 1) * pageSize)
-      .build();
-  }
-
-  // 添加到购物车
-  static addToCart(item: {
-    cart_id: number;
-    user_id: number;
-    store_id: number;
-    goods_id: number;
-    quantity: number;
-    goods_price: number;
-  }) {
-    return this.api.insert()
-      .add({ ...item, selected: 1 })
-      .build();
-  }
-
-  // 选中商品
-  static selectItem(itemId: number) {
-    return this.api.update()
-      .set({ selected: 1 })
-      .where({ id: itemId })
-      .build();
-  }
-
-  // 更新数量
-  static updateQuantity(itemId: number, quantity: number) {
-    return this.api.update()
-      .set({ quantity })
-      .where({ id: itemId })
-      .build();
-  }
-
-  // 删除商品
-  static deleteItem(itemId: number) {
-    return this.api.update()
-      .set({ is_deleted: 1 })
-      .where({ id: itemId })
-      .build();
-  }
-
-  // 批量删除
-  static deleteBatch(itemIds: number[]) {
-    const builder = this.api.update();
-
-    itemIds.forEach((id, index) => {
-      if (index > 0)
-        builder.and();
-      builder.set({ is_deleted: 1 }).where({ id });
-    });
-
-    return builder.build();
-  }
-}
-
-// 使用服务
-console.log('查询购物车:');
-console.log(JSON.stringify(CartService.getCart(10086), null, 2));
-
-console.log('\n选中商品:');
-console.log(JSON.stringify(CartService.selectItem(123), null, 2));
-
-console.log('\n批量删除:');
-console.log(JSON.stringify(CartService.deleteBatch([1, 2, 3]), null, 2));

package/src/http/apiBuilder/index.ts

@@ -1 +0,0 @@
-export * from './api-builder';

package/src/http/apiBuilder//345/277/253/351/200/237/345/217/202/350/200/203.md

@@ -1,199 +0,0 @@
-# 快速参考
-
-## 基础用法
-
-```typescript
-import ApiBuilder from './api-builder';
-
-// 1. 实例化
-const api = new ApiBuilder(fieldCatalog);
-
-// 2. 查询
-api.query()
-  .where('field', 'op', value)
-  .orderBy('field', 'desc')
-  .paginate(20, 0)
-  .build();
-
-// 3. 新增
-api.insert()
-  .add({ field: value })
-  .build();
-
-// 4. 更新
-api.update()
-  .set({ field: value })
-  .where({ id: 1 })
-  .build();
-```
-
-## 查询操作符
-
-| 类型 | 操作符 |
-|------|--------|
-| 字符串 | `=`, `!=`, `like`, `not like`, `in`, `not in` |
-| 数字 | `=`, `!=`, `>`, `>=`, `<`, `<=`, `in`, `not in`, `between` |
-| 日期 | `=`, `>`, `>=`, `<`, `<=`, `between` |
-| 布尔 | `is true`, `is false`, `is null`, `is not null` |
-
-## 常用示例
-
-### 查询
-
-```typescript
-// 单条件（默认 =）
-api.query().where('user_id', 10086).build();
-
-// 多条件（AND）
-api.query()
-  .where('user_id', 10086)
-  .where('is_deleted', 0)
-  .build();
-
-// 对象形式
-api.query()
-  .where({ user_id: 10086, is_deleted: 0 })
-  .build();
-
-// 多条件（OR）
-api.query()
-  .where('status', 1)
-  .orWhere('status', 2)
-  .build();
-
-// IN 条件
-api.query().whereIn('status', [1, 2, 3]).build();
-
-// LIKE 查询
-api.query().whereLike('name', '%关键词%').build();
-
-// NULL 查询
-api.query().whereNull('deleted_at').build();
-api.query().whereNotNull('price').build();
-
-// BETWEEN
-api.query().whereBetween('price', 100, 500).build();
-
-// 排序
-api.query().orderBy('created_time', 'desc').build();
-
-// 分页
-api.query().limit(20).offset(0).build();
-// 或
-api.query().paginate(20, 0).build();
-```
-
-### 新增
-
-```typescript
-// 单条
-api.insert().add({ user_id: 10086, name: '张三' }).build();
-
-// 批量
-api.insert().addBatch([
-  { user_id: 10086, name: '张三' },
-  { user_id: 10087, name: '李四' }
-]).build();
-```
-
-### 更新
-
-```typescript
-// 单条（对象形式）
-api.update()
-  .set({ status: 1 })
-  .where({ id: 1 })
-  .build();
-
-// 单条（键值对形式）
-api.update()
-  .set({ status: 1 })
-  .where('id', 1)
-  .build();
-
-// 多个条件
-api.update()
-  .set({ status: 1 })
-  .where('user_id', 10086)
-  .where('goods_id', 30005)
-  .build();
-
-// 批量更新
-api.update()
-  .set({ status: 0 })
-  .where({ id: 1 })
-  .and()
-  .set({ status: 1 })
-  .where({ id: 2 })
-  .build();
-```
-
-## 服务类模板
-
-```typescript
-class YourService {
-  private static api = new ApiBuilder(YOUR_CATALOG);
-
-  static query(params: any) {
-    return this.api.query()
-      .where('field', '=', params.value)
-      .build();
-  }
-
-  static create(data: any) {
-    return this.api.insert()
-      .add(data)
-      .build();
-  }
-
-  static update(id: number, data: any) {
-    return this.api.update()
-      .set(data)
-      .where({ id })
-      .build();
-  }
-
-  static delete(id: number) {
-    return this.api.update()
-      .set({ is_deleted: 1 })
-      .where({ id })
-      .build();
-  }
-}
-```
-
-## 链式调用顺序
-
-### Query
-```
-query() → where() → logic() → orderBy() → paginate() → build()
-```
-
-### Insert
-```
-insert() → add() / addBatch() → build()
-```
-
-### Update
-```
-update() → set() → where() → [and() → set() → where()] → build()
-```
-
-## 注意事项
-
-1. `where()` 可以多次调用，默认 AND 关系
-2. `logic('or')` 改变条件逻辑为 OR
-3. `and()` 用于批量更新时分隔多个更新操作
-4. `build()` 必须最后调用，返回最终参数
-5. 更新操作必须先 `set()` 再 `where()`
-
-## 类型定义
-
-```typescript
-import ApiBuilder, { 
-  FieldCatalog,
-  QueryParams,
-  InsertParams,
-  UpdateParams
-} from './api-builder';
-```

package/src/http/http.ts

@@ -1,79 +0,0 @@
-import axios, {AxiosInstance, AxiosResponse} from "axios";
-import { httpEnum } from './httpEnums';
-import {getDeviceType, getFromType, getToken, removeToken} from "../common/index";
-interface IHttp {
-  cacheType: 'localStorage' | 'sessionStorage' | 'both';
-  currentMode: string; // local | dev | test | prod 等自定义mode
-  errorCb?: (error: any) => void;
-  getTokenCb?: () => void;
-  tokenKey?: 'token';
-}
-const request = axios.create({
-  timeout: 15000,
-  headers: {
-    // 'Authorization': getToken(),
-    "Content-Type": "application/json",
-  },
-});
-// const requestArr = [request];
-
-/**
- * @param cacheType localStorage | sessionStorage | both
- * @param currentMode local | dev | test | prod 等自定义mode
- * @param errorCb 错误回调
- * @param getTokenCb 获取token的回调
- * @param tokenKey
- * */
-export const http = ({cacheType, currentMode, errorCb, getTokenCb, tokenKey}: IHttp):AxiosInstance => {
-  request.interceptors.request.use(
-    async (config: any) => {
-      const token = getToken(cacheType, tokenKey);
-      const deviceType = getDeviceType();
-      config.headers.Authorization = token;
-      config.headers.token = token;
-      config.headers.FrontType = getFromType(deviceType);
-      return config;
-    },
-    (error) => {
-      // do something with request error
-      return Promise.reject(error);
-    }
-  );
-
-  // response interceptor
-  request.interceptors.response.use(
-    async (response: AxiosResponse) => {
-      const res = response.data;
-      const statusCode = res.code || response.status;
-      // blob文件流
-      if (res instanceof Blob) {
-        return res;
-      }
-      // 成功
-      if (statusCode === httpEnum.CODES.Success) {
-        return res;
-      }
-      // token失效
-      if (statusCode === httpEnum.CODES.UnAuthorized) {
-        if (currentMode !== "local" && currentMode !== "dev" && currentMode !== 'development') {
-          removeToken(cacheType, tokenKey);
-          if (getTokenCb && typeof getTokenCb === "function") {
-            getTokenCb();
-          }
-        }
-        return Promise.reject(new Error("token过期！"));
-      }
-      const errMsg = res.message || res.msg;
-      return Promise.reject(new Error(errMsg || "Error"));
-    },
-    async (error) => {
-      if (errorCb && typeof errorCb === "function") {
-        errorCb(error);
-      }
-      return Promise.reject(error);
-    }
-
-  );
-  return request
-}
-

package/src/http/httpEnums.ts

@@ -1,61 +0,0 @@
-export const httpEnum = {
-    // http响应状态码
-    HTTP_STATUS: {
-      // 1xx，临时响应
-      TEMP_RESPOND: {
-        Continue: 100, // 服务器通知浏览器之前一切正常，请客户端继续请求，如果请求结束，可忽略
-        SwitchingProtocal: 101 // 针对请求头的Upgrade返回的信息。表明服务器正在切换到指定的协议
-      },
-      // 2xx，成功
-      SUCCESS: {
-        Ok: 200, // 请求成功
-        Created: 201, // 常用于POST，PUT 请求，表明请求已经成功，并新建了一个资源。并在响应体中返回路径
-        Accepted: 202, // 请求已经接收到，但没有响应，稍后也不会返回一个异步请求结果。 该状态码适用于等待其他进程处理或者批处理的场景
-        NoAuthoritativeInformation: 203, // 表明响应返回的元信息（meta-infomation）和最初的服务器不同，而是从本地或者第三方获取的
-        NoContent: 204, // 请求没有数据返回，但是头信息有用。用户代理(浏览器)会更新缓存的头信息
-        ResetContent: 205, // 告诉用户代理（浏览器）重置发送该请求的文档
-        ParticalContent: 206 // 客户端使用Range请求头时，返回该状态码
-      },
-      // 3xx，重定向
-      REDIRECT: {
-        MultipleChoice: 300, // 返回多个响应，需要浏览器或者用户选择
-        MovedPermanently: 301, // 请求资源的URL被永久的改变，新的URL会在响应的Location中给出。浏览器到新的URL重新请求资源，因为有些客户端会把请求方式method改成GET。所以该状态码建议GET和HEAD方法中使用。搜索引擎会更新地址到资源的链接（SEO中‘link-judge’被发送到新的URL）
-        Found: 302, // 请求资源的URL被暂时修改到Location提供的URL。未来可能还会有新的修改。览器会根据新的URL重新请求资源。有些客户端会把方法method改为GET，建议在GET和HEAD方法中使用。搜索引擎不会更改URL到资源的。
-        SeeOther: 303, // 服务通过返回的响应数据指导客户端通过GET方法去另一个URL获取资源。通常用于POST或者PUT的请求返回结果，重定向到信息提示页面或者进度展示页面。重定向页面的方法是GET方法。
-        NotModified: 304, // 资源未变更。服务器根据请求头判断，需要资源未修改，只返回响应头；否则将资源一起返回。
-        TemporaryRedirect: 307, // 临时重定向。基本和302相同。唯一的区别是这个状态码严格禁止浏览器到新URL请求资源时修改原来的请求方式和请求体。
-        PermanentRedirect: 308 // 永久重定向。基本和301相同。但是严格禁止修改请求方式和请求体。
-      },
-      // 4xx，请求错误
-      REQUEST_ERROR: {
-        BadRequest: 400, // 请求语法有问题，服务器无法识别。
-        UnAuthorized: 401, // 客户端未授权该请求。缺乏有效的身份认证凭证，一般可能是未登陆。登陆后一般都解决问题。
-        Forbidden: 403, // 服务器拒绝响应。权限不足。
-        NotFound: 404, // URL无效或者URL有效但是没有资源。
-        MethodNotAllowed: 405, // 请求方式Method不允许。但是GET和HEAD属于强制方式，不能返回这个状态码。
-        NotAccepted: 406, // 资源类型不符合服务器要求。
-        ProxyAuthorizationRequired: 407, //  需要代理授权。
-        RequestTimeout: 408, // 服务器将不再使用的连接关闭。响应头会有Connection: close。
-        UpgradeRequired: 426, // 告诉客户端需要升级通信协议。
-        TokenUnAuthorized: 499, // 告诉客户端需要升级通信协议。
-      },
-      // 5xx，服务器错误
-      SERVER_ERROR: {
-        InternalServerError: 500, // 服务器内部错误，未捕获。
-        BadGateway: 502, // 服务器作为网关使用时，收到上游服务器返回的无效响应。
-        ServiceUnavailable: 503, // 无法服务。一般发生在因维护而停机或者服务过载。一般还会伴随着返回一个响应头Retry-After: 说明恢复服务的估计时间。
-        GateTimeout: 504, // 网关超时。服务器作为网关或者代理，不能及时从上游服务器获取响应返回给客户端。
-        HttpVersionNotSupported: 505 // 发出的请求http版本服务器不支持。如果请求通过http2发送，服务器不支持http2.0，就会返回该状态码。
-      }
-    },
-    // http状态码
-    CODES: {
-      Success: '00000',
-      UnAuthorized: '00099',
-      UnAuthorizedPhone: '11001', //未授权用户手机号
-      UnAuthorizedWecom: '11000', //调用企微接口异常
-      UnAuthorizedHavePhone: '11002', //查到手机号但是也报错
-    },
-    // http状态码白名单，在具体业务中处理
-    ERR_CODE_WHITE_LIST: []
-  }

package/src/iam/index.ts

@@ -1,46 +0,0 @@
-/**
- * 扁平化 state 字段
- * @param state 需要扁平化的 state 字段
- * @param keyName 需要剥离的 key 名称
- * @returns 扁平化后的 state 字段
- */
-function flattenStateRecursive(state: unknown, keyName: string = 'state') {
-  let result: unknown = state;
-  let lastResult: unknown;
-  // 递归解码和解析
-  while (typeof result === 'string') {
-    try {
-      lastResult = result;
-      result = decodeURIComponent(result as string);
-      result = JSON.parse(result as string);
-    } catch {
-      result = lastResult;
-      break;
-    }
-  }
-  // 递归剥离 state 字段
-  while (
-    result &&
-    typeof result === 'object' &&
-    keyName in result &&
-    (typeof (result as any)[keyName] === 'string' || typeof (result as any)[keyName] === 'object')
-  ) {
-    result = (result as any)[keyName];
-    if (typeof result === 'string') {
-      try {
-        result = decodeURIComponent(result as string);
-        result = JSON.parse(result as string);
-      } catch {
-        break;
-      }
-    }
-  }
-  return result;
-}
-export const handleFlatStr = (keyName: string = 'state', value: unknown) => {
-  // return `${key}=${value}`
-
-    let flat = flattenStateRecursive(value, keyName);
-    let flatStr = typeof flat === 'object' ? JSON.stringify(flat) : String(flat);
-    return flatStr;
-}

package/src/index.ts

@@ -1,20 +0,0 @@
-export * from './common';
-export * from './date';
-export * from './file';
-export * from './object';
-export * from './print';
-export * from './validate';
-export * from './number';
-export * from './string';
-export * from './http/httpEnums'
-export * from './http/http'
-export * from './http/apiBuilder'
-export * from './middleware/requestLogger.middware'
-export * from './iam'
-export * from './color';
-export * from './array';
-export * from './dom';
-// chunk-optimizer 是构建时工具，不应该被打包到浏览器端
-// 如需使用，请通过单独的导入路径：import { createChunkOptimizer } from 'jinbi-utils/chunk-optimizer'
-// export * from './build/chunk-optimizer'
-export * from './websocket'