@lcap/nasl 3.9.0-beta.2 → 3.9.0-beta.20

package/sandbox/stdlib/nasl.util.ts

@@ -15,7 +15,9 @@ declare namespace nasl.util {
   export function FromString(value: nasl.core.String): <T extends nasl.core.Decimal | nasl.core.Date | nasl.core.Time | nasl.core.DateTime | nasl.core.Decimal | nasl.core.Long | nasl.core.Boolean>() => T;
   export function EnumToList<T extends nasl.core.Enums<nasl.core.Long>>(): nasl.collection.List<{ text: nasl.core.String, value: nasl.core.Long }>;
   export function EnumToList<T extends nasl.core.Enums<nasl.core.String>>(): nasl.collection.List<{ text: nasl.core.String, value: nasl.core.String }>;
-  export function EnumValueToText<T extends nasl.core.Enums<nasl.core.Long | nasl.core.String>>(value: nasl.core.Enums<nasl.core.Long | nasl.core.String>): nasl.core.String;
+  export function EnumItemToText<T extends nasl.core.Enums<nasl.core.Long | nasl.core.String>>(value: nasl.core.Enums<nasl.core.Long | nasl.core.String>): nasl.core.String;
+  export function EnumItemToStructure<T extends nasl.core.Enums<nasl.core.Long>>(value: nasl.core.Enums<nasl.core.Long>): { text: nasl.core.String, value: nasl.core.Long };
+  export function EnumItemToStructure<T extends nasl.core.Enums<nasl.core.String>>(value: nasl.core.Enums<nasl.core.String>): { text: nasl.core.String, value: nasl.core.String };
   export function ToEnumItem<T extends nasl.core.Enums<nasl.core.Long>>(value: nasl.core.Long): T;
   export function ToEnumItem<T extends nasl.core.Enums<nasl.core.String>>(value: nasl.core.String): T;
 
@@ -117,6 +119,7 @@ declare namespace nasl.util {
   export function ValidMapKey<K extends nasl.core.None>(key: K): K;
   export function CreateListPage<T>(list: nasl.collection.List<T>, total: nasl.core.Long): { list: nasl.collection.List<T>, total: nasl.core.Long };
 
+  // 为防止nasl没有被干净，先保留这部分的声明
   export function consoleLog(arg: nasl.core.Any): void;
 
   export function jsonSerialize(arg: nasl.core.Any, timeZone?: nasl.core.String): nasl.core.String;
@@ -147,18 +150,6 @@ declare namespace nasl.util {
   export function callLogicWithChecker<T extends (...args: any[]) => any>(func: T, checker: (...args: Parameters<T>) => any): T;
   // 分页组件函数
   export function paginateLimit<T>(list: nasl.collection.List<T>, page: nasl.core.Long, size: nasl.core.Long): { list: nasl.collection.List<T>, total: nasl.core.Long };
-
-  // 判断ReturnType是否包含‘enums’, 只给组件属性校验使用
-  export function _bindAttrWrap<T extends (...args: any[]) => any, I extends boolean>(func: T, ignore: I): I extends true
-    ? any
-    : ReturnType<T> extends nasl.core.Enums<any>
-      ? any
-      : ReturnType<T> extends nasl.collection.List<infer E>
-        ? E extends nasl.core.Enums<any>
-          ? any
-          : ReturnType<T>
-        : ReturnType<T>;
-
-  // Enum类型转换成any类型
-  export type _formatEnum<T> = T extends nasl.core.Enums<any> ? any : T;
+  // 审批人判断函数
+  export function isListorString(value: nasl.core.String | nasl.collection.List<nasl.core.String>): Boolean;
 }

package/sandbox-natural/stdlib/nasl.core.d.ts

@@ -0,0 +1,54 @@
+/* 基本类型定义 */
+type Any = any;
+type Long = number;
+type Integer = number;
+type Decimal = number;
+type Boolean = boolean;
+type String = string;
+type List<T> = Array<T>;
+
+type Date = globalThis.Date;
+class Time {
+  accept: 'Time';
+}
+/* 日期时间类型 */
+class DateTime {
+  accept: 'DateTime';
+}
+
+/**
+ * 数据实体接口
+ * 作用：创建、更新和删除数据表中的数据
+*/
+interface Entity<T> {
+  /* 根据主键ID获取一条数据 */
+  get(id: Integer): T;
+  /**
+   * 将传入的数据实体插入到数据表中
+   * @param entity 数据实体，T类型。不包含id, createTime, updateTime, createdBy, updatedBy字段
+   * @returns 返回插入的数据实体，T类型。已自动生成id, createTime, updateTime, createdBy, updatedBy字段, 可以通过返回值获取插入数据在数据库中的id
+   * @example const person = nasl.util.NewEntity<app.dataSources.defaultDS.entities.Person>({name: 'test', age: 18}; insertPerson = app.dataSources.defaultDS.entities.PersonEntity.create(person); // 可以根据insertPerson.id获取插入数据在数据库中的id
+  */
+  create(entity: T): T;
+  /* 根据传入的数据对象更新数据表中的数据 */
+  update(entity: T): T;
+  /* 根据主键ID删除数据表中的数据 */
+  delete(id: Integer): void;
+  /* 根据传入的数据对象创建或更新数据表中的数据 */
+  createOrUpdate(body: T): T;
+  /* 根据主键ID列表批量删除数据表中的数据 */
+  batchCreate(list: List<T>): List<T>;
+  /* 根据传入的数据对象列表批量更新数据表中的数据 */
+  batchUpdate(list: List<T>): List<T>;
+  /* 根据主键ID列表批量删除数据表中的数据 */
+  batchDelete(list: List<Integer>): void;
+}
+
+/*
+* createEntity函数：根据数据表类型创建一个数据实体接口，然后通过该接口调用数据表中的数据。
+* @example const LCAPUserEntity = createEntity<app.dataSources.defaultDS.entities.LCAPUser>(); app.dataSources.defaultDS.entities.LCAPUserEntity.delete(id);
+* 注意：对应接口已经在下面的实体列表中定义好了，不需要重新定义。
+*/
+declare const createEntity: <T>() => Entity<T>;
+/* EntityRelation函数：用于定义数据表内的外键关联关系。*/
+declare function EntityRelation(property: any): any;

package/sandbox-natural/stdlib/nasl.oql.d.ts

@@ -0,0 +1,22 @@
+declare namespace nasl.oql {
+  /**
+   * SQL数据查询
+   * @param sql 数据查询需要的 SQL
+   * @returns 返回查询结果列表
+   * 关于T的类型说明：
+   *  1. 如果查询字段均来自一个数据表，T为该数据表的类型
+   *  2. 如果查询字段来自多个数据表，那么T为匿名类型，包含所有查询字段, 如：{name: string, age: number}
+   * 在调用时，T可以不指定，平台会自动进行推断
+   *
+   * 优先使用数据库的查询和数据操纵能力，例如 JOIN、SUM、GROUP_BY 等
+   * 所有变量格式为：${variable}，不能用''包裹，不能用函数处理。
+   * @example nasl.oql.query(`SELECT * FROM Student WHERE id = ${id}`)
+   * @example nasl.oql.query(`SELECT OrderProduct.*, Product.price as price FROM OrderProduct JOIN Product WHERE orderId = ${orderId}`)
+   * 可直接使用list查询，无需拼接成字符串
+   * @example nasl.oql.query(`SELECT * FROM Student WHERE id IN ${idList}`)
+   */
+  export function query<T>(sql: string): List<T> | T;
+}
+
+/* 分页组件函数，用于分页 */
+declare function PAGINATE<T>(list: List<T>, page: Integer, size: Integer): { list: List<T>, total: Integer; };

package/sandbox-natural/stdlib/nasl.ui.d.ts

@@ -0,0 +1,78 @@
+declare namespace nasl.ui {
+  /* 校验类型 */
+  export interface ValidateResult { valid: Boolean; }
+  /* current: 推导类型 */
+  export class Current<T> {
+    item: T;
+    constructor(obj: Partial<Current<T>>);
+  }
+
+  export class ViewComponentOptions {
+    @Prop({
+      title: '显示条件',
+      description: '是否展示组件',
+    })
+    _if: Boolean;
+
+    @Prop({
+      title: '工具提示',
+      description: '在鼠标悬停时显示的文字',
+    })
+    _tooltip: String;
+
+    @Prop({
+      title: '样式',
+      description: '任意组件的样式，使用 inline CSS',
+    })
+    _staticStyle: String;
+
+    @Prop({
+      title: '动态文本颜色',
+      description: '动态调整文本颜色，CSS 的 color 值',
+    })
+    _color: String;
+
+    @Prop({
+      title: '动态背景颜色',
+      description: '动态调整背景颜色，CSS 的 background-color 值',
+    })
+    _backgroundColor: String;
+
+    @Prop({
+      title: '动态背景图片',
+      description: '动态调整背景图片，CSS 的 background-image 值',
+    })
+    _backgroundImage: String;
+  }
+
+  // 在页面上弹出消息
+  export function showMessage(text: Any): void;
+  /** 跳转到指定页面
+   * @example nasl.ui.destination('pageType.some_view.sub1_view', { param1, param2, ... });
+   * pageType 为 namespace，如 pc 或者 m，必填
+   */
+  export function destination(path: String, args: object): void;
+}
+
+declare namespace nasl.auth {
+  // 检查当前用户是否有当前资源的权限
+  export function hasAuth(authPath: String): Boolean;
+  // 退出当前登录状态
+  export function logout(): void;
+  // 对字符串 实现aes加密，返回加密后的字符串
+  export function encryptByAES(authPath: String): String;
+  // 对字符串 实现aes解密，返回解密后的字符串
+  export function decryptByAES(authPath: String): String;
+  // 获取用户信息
+  export const userInfo: {
+    Status: String;
+    UserName: String;
+    Email: String;
+    UserId: String;
+    Phone: String;
+    CreateTime: Long;
+    UpdateTime: Long;
+    LoginCount: Long;
+    Source: String;
+  };
+}