@ruiapp/rapid-core 0.5.11 → 0.5.13

package/src/plugins/setting/models/UserSettingItemSetting.ts

@@ -1,73 +1,73 @@
-import { RpdDataModel } from "~/types";
-
-export default {
-  maintainedBy: "settingPlugin",
-  namespace: "svc",
-  name: "user_setting_item_setting",
-  singularCode: "user_setting_item_setting",
-  pluralCode: "user_setting_item_settings",
-  schema: "public",
-  tableName: "user_setting_item_settings",
-  properties: [
-    {
-      name: "id",
-      code: "id",
-      columnName: "id",
-      type: "integer",
-      required: true,
-      autoIncrement: true,
-    },
-    {
-      name: "group",
-      code: "group",
-      type: "relation",
-      relation: "one",
-      targetSingularCode: "user_setting_group_setting",
-      targetIdColumnName: "group_id",
-      required: true,
-    },
-    {
-      name: "orderNum",
-      code: "orderNum",
-      columnName: "order_num",
-      type: "integer",
-      required: true,
-      defaultValue: "0",
-    },
-    {
-      name: "type",
-      code: "type",
-      columnName: "type",
-      type: "text",
-      required: true,
-    },
-    {
-      name: "code",
-      code: "code",
-      columnName: "code",
-      type: "text",
-      required: true,
-    },
-    {
-      name: "name",
-      code: "name",
-      columnName: "name",
-      type: "text",
-      required: false,
-    },
-    {
-      name: "description",
-      code: "description",
-      columnName: "description",
-      type: "text",
-      required: false,
-    },
-    {
-      name: "config",
-      code: "config",
-      columnName: "config",
-      type: "json",
-      required: false,
-    },
-  ],
-} as RpdDataModel;
+import { RpdDataModel } from "~/types";
+
+export default {
+  maintainedBy: "settingPlugin",
+  namespace: "svc",
+  name: "user_setting_item_setting",
+  singularCode: "user_setting_item_setting",
+  pluralCode: "user_setting_item_settings",
+  schema: "public",
+  tableName: "user_setting_item_settings",
+  properties: [
+    {
+      name: "id",
+      code: "id",
+      columnName: "id",
+      type: "integer",
+      required: true,
+      autoIncrement: true,
+    },
+    {
+      name: "group",
+      code: "group",
+      type: "relation",
+      relation: "one",
+      targetSingularCode: "user_setting_group_setting",
+      targetIdColumnName: "group_id",
+      required: true,
+    },
+    {
+      name: "orderNum",
+      code: "orderNum",
+      columnName: "order_num",
+      type: "integer",
+      required: true,
+      defaultValue: "0",
+    },
+    {
+      name: "type",
+      code: "type",
+      columnName: "type",
+      type: "text",
+      required: true,
+    },
+    {
+      name: "code",
+      code: "code",
+      columnName: "code",
+      type: "text",
+      required: true,
+    },
+    {
+      name: "name",
+      code: "name",
+      columnName: "name",
+      type: "text",
+      required: false,
+    },
+    {
+      name: "description",
+      code: "description",
+      columnName: "description",
+      type: "text",
+      required: false,
+    },
+    {
+      name: "config",
+      code: "config",
+      columnName: "config",
+      type: "json",
+      required: false,
+    },
+  ],
+} as RpdDataModel;

package/src/plugins/setting/models/index.ts

@@ -1,8 +1,8 @@
-import SystemSettingGroupSetting from "./SystemSettingGroupSetting";
-import SystemSettingItem from "./SystemSettingItem";
-import SystemSettingItemSetting from "./SystemSettingItemSetting";
-import UserSettingGroupSetting from "./UserSettingGroupSetting";
-import UserSettingItem from "./UserSettingItem";
-import UserSettingItemSetting from "./UserSettingItemSetting";
-
-export default [SystemSettingGroupSetting, SystemSettingItem, SystemSettingItemSetting, UserSettingGroupSetting, UserSettingItem, UserSettingItemSetting];
+import SystemSettingGroupSetting from "./SystemSettingGroupSetting";
+import SystemSettingItem from "./SystemSettingItem";
+import SystemSettingItemSetting from "./SystemSettingItemSetting";
+import UserSettingGroupSetting from "./UserSettingGroupSetting";
+import UserSettingItem from "./UserSettingItem";
+import UserSettingItemSetting from "./UserSettingItemSetting";
+
+export default [SystemSettingGroupSetting, SystemSettingItem, SystemSettingItemSetting, UserSettingGroupSetting, UserSettingItem, UserSettingItemSetting];

package/src/plugins/setting/routes/getSystemSettingValues.ts

@@ -1,15 +1,15 @@
-import { RpdRoute } from "~/types";
-
-export default {
-  namespace: "svc",
-  name: "svc.getSystemSettingValues",
-  code: "svc.getSystemSettingValues",
-  type: "RESTful",
-  method: "GET",
-  endpoint: "/svc/systemSettingValues",
-  actions: [
-    {
-      code: "getSystemSettingValues",
-    },
-  ],
-} satisfies RpdRoute;
+import { RpdRoute } from "~/types";
+
+export default {
+  namespace: "svc",
+  name: "svc.getSystemSettingValues",
+  code: "svc.getSystemSettingValues",
+  type: "RESTful",
+  method: "GET",
+  endpoint: "/svc/systemSettingValues",
+  actions: [
+    {
+      code: "getSystemSettingValues",
+    },
+  ],
+} satisfies RpdRoute;

package/src/plugins/setting/routes/getUserSettingValues.ts

@@ -1,15 +1,15 @@
-import { RpdRoute } from "~/types";
-
-export default {
-  namespace: "svc",
-  name: "svc.getUserSettingValues",
-  code: "svc.getUserSettingValues",
-  type: "RESTful",
-  method: "GET",
-  endpoint: "/svc/userSettingValues",
-  actions: [
-    {
-      code: "getUserSettingValues",
-    },
-  ],
-} satisfies RpdRoute;
+import { RpdRoute } from "~/types";
+
+export default {
+  namespace: "svc",
+  name: "svc.getUserSettingValues",
+  code: "svc.getUserSettingValues",
+  type: "RESTful",
+  method: "GET",
+  endpoint: "/svc/userSettingValues",
+  actions: [
+    {
+      code: "getUserSettingValues",
+    },
+  ],
+} satisfies RpdRoute;

package/src/plugins/setting/routes/index.ts

@@ -1,5 +1,5 @@
-import getUserSettingValues from "./getUserSettingValues";
-import getSystemSettingValues from "./getSystemSettingValues";
-import setSystemSettingValues from "./setSystemSettingValues";
-
-export default [getUserSettingValues, getSystemSettingValues, setSystemSettingValues];
+import getUserSettingValues from "./getUserSettingValues";
+import getSystemSettingValues from "./getSystemSettingValues";
+import setSystemSettingValues from "./setSystemSettingValues";
+
+export default [getUserSettingValues, getSystemSettingValues, setSystemSettingValues];

package/src/plugins/setting/routes/setSystemSettingValues.ts

@@ -1,15 +1,15 @@
-import { RpdRoute } from "~/types";
-
-export default {
-  namespace: "svc",
-  name: "svc.setSystemSettingValues",
-  code: "svc.setSystemSettingValues",
-  type: "RESTful",
-  method: "PATCH",
-  endpoint: "/svc/systemSettingValues",
-  actions: [
-    {
-      code: "setSystemSettingValues",
-    },
-  ],
-} satisfies RpdRoute;
+import { RpdRoute } from "~/types";
+
+export default {
+  namespace: "svc",
+  name: "svc.setSystemSettingValues",
+  code: "svc.setSystemSettingValues",
+  type: "RESTful",
+  method: "PATCH",
+  endpoint: "/svc/systemSettingValues",
+  actions: [
+    {
+      code: "setSystemSettingValues",
+    },
+  ],
+} satisfies RpdRoute;

package/src/plugins/stateMachine/StateMachinePlugin.ts

@@ -1,196 +1,196 @@
-/**
- * State machine plugin
- */
-
-import { CreateEntityOptions, RpdApplicationConfig, RpdDataModel, RpdDataModelProperty, UpdateEntityByIdOptions } from "~/types";
-import {
-  IRpdServer,
-  RapidPlugin,
-  RpdConfigurationItemOptions,
-  RpdServerPluginConfigurableTargetOptions,
-  RpdServerPluginExtendingAbilities,
-} from "~/core/server";
-
-import pluginActionHandlers from "./actionHandlers";
-import pluginModels from "./models";
-import pluginRoutes from "./routes";
-import { filter, find, first, get, isEqual } from "lodash";
-import { PropertyStateMachineConfig } from "./StateMachinePluginTypes";
-import { isNullOrUndefined } from "~/utilities/typeUtility";
-import { getStateMachineNextSnapshot } from "./stateMachineHelper";
-import { getEntityPropertiesIncludingBase } from "~/helpers/metaHelper";
-
-class StateMachinePlugin implements RapidPlugin {
-  get code(): string {
-    return "stateMachinePlugin";
-  }
-
-  get description(): string {
-    return null;
-  }
-
-  get extendingAbilities(): RpdServerPluginExtendingAbilities[] {
-    return [];
-  }
-
-  get configurableTargets(): RpdServerPluginConfigurableTargetOptions[] {
-    return [];
-  }
-
-  get configurations(): RpdConfigurationItemOptions[] {
-    return [];
-  }
-
-  async registerActionHandlers(server: IRpdServer): Promise<any> {
-    for (const actionHandler of pluginActionHandlers) {
-      server.registerActionHandler(this, actionHandler);
-    }
-  }
-
-  async configureModels(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
-    server.appendApplicationConfig({ models: pluginModels });
-  }
-
-  async configureRoutes(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
-    server.appendApplicationConfig({ routes: pluginRoutes });
-  }
-
-  async onApplicationLoaded(server: IRpdServer, applicationConfig: RpdApplicationConfig) {
-    const models = server.getApplicationConfig().models;
-    for (const model of models) {
-      for (const property of getEntityPropertiesIncludingBase(server, model)) {
-        const propertyStateMachineConfig: PropertyStateMachineConfig = property.config?.stateMachine;
-        if (propertyStateMachineConfig) {
-          const stateMachineCode = getStateMachineCode(model, property);
-          const stateMachineConfig = propertyStateMachineConfig.config;
-
-          const stateMachineDataAccessor = server.getDataAccessor({
-            singularCode: "state_machine",
-          });
-          const stateMachine = await stateMachineDataAccessor.findOne(
-            {
-              filters: [
-                {
-                  operator: "eq",
-                  field: "code",
-                  value: stateMachineCode,
-                },
-              ],
-            },
-            null,
-          );
-
-          if (stateMachine) {
-            if (!isEqual(stateMachine.config, stateMachineConfig)) {
-              await stateMachineDataAccessor.updateById(
-                stateMachine.id,
-                {
-                  config: stateMachineConfig,
-                },
-                null,
-              );
-            }
-          } else {
-            await stateMachineDataAccessor.create(
-              {
-                code: stateMachineCode,
-                config: stateMachineConfig,
-              },
-              null,
-            );
-          }
-        }
-      }
-    }
-  }
-
-  /**
-   * 创建实体前的处理。
-   * 当属性启用了状态机管理，如创建实体时没有指定该属性的状态值，则应将该属性设置为 stateMachine.config.initial 。
-   * @param server
-   * @param model
-   * @param options
-   */
-  async beforeCreateEntity(server: IRpdServer, model: RpdDataModel, options: CreateEntityOptions) {
-    for (const property of getEntityPropertiesIncludingBase(server, model)) {
-      const isStateMachineEnabled = get(property.config, "stateMachine.enabled", false);
-      if (isStateMachineEnabled && isNullOrUndefined(options.entity[property.code])) {
-        const initialState = get(property.config, "stateMachine.config.initial", null);
-        if (initialState) {
-          options.entity[property.code] = initialState;
-        }
-      }
-    }
-  }
-
-  /**
-   * 更新实体前的处理。
-   * 1. 对所有启用了状态机管理，且 transferControl 为 true 的属性，应禁止直接更新这些属性
-   * 2. 当更新实体时指定了operation，则查找启用了状态机管理的属性。
-   * 如果一个模型中存在多个属性启用了状态机管理，则以 options.stateProperty 中指定的为准。
-   * 对于该状态属性应用 options.operation，使其转换到下一状态。
-   * @param server
-   * @param model
-   * @param options
-   */
-  async beforeUpdateEntity(server: IRpdServer, model: RpdDataModel, options: UpdateEntityByIdOptions, currentEntity: any) {
-    const entity = options.entityToSave;
-
-    const stateMachineEnabledProperties: RpdDataModelProperty[] = [];
-    for (const property of getEntityPropertiesIncludingBase(server, model)) {
-      const isStateMachineEnabled = get(property.config, "stateMachine.enabled", false);
-
-      if (isStateMachineEnabled) {
-        stateMachineEnabledProperties.push(property);
-
-        const isTransferControlEnabled = get(property.config, "stateMachine.transferControl", false);
-        if (isTransferControlEnabled && !isNullOrUndefined(entity[property.code])) {
-          throw new Error(`You're not allowed to change '${property.code}' property directly when transfer control is enabled, do an operation instead.`);
-        }
-      }
-    }
-
-    if (!options.operation) {
-      return;
-    }
-
-    let statePropertiesToUpdate: RpdDataModelProperty[];
-    const statePropertyCodes = options.stateProperties;
-    if (statePropertyCodes && statePropertyCodes.length) {
-      statePropertiesToUpdate = filter(stateMachineEnabledProperties, (property) => statePropertyCodes.includes(property.code));
-    } else {
-      statePropertiesToUpdate = stateMachineEnabledProperties;
-    }
-
-    if (!statePropertiesToUpdate.length) {
-      throw new Error(`State machine property not found.`);
-    }
-
-    for (const statePropertyToUpdate of statePropertiesToUpdate) {
-      const machineConfig = get(statePropertyToUpdate.config, "stateMachine.config", null);
-      if (!machineConfig) {
-        throw new Error(`State machine of property '${statePropertyToUpdate.code}' not configured.`);
-      }
-      machineConfig.id = getStateMachineCode(model, statePropertyToUpdate);
-
-      const nextSnapshot = await getStateMachineNextSnapshot({
-        machineConfig,
-        context: {},
-        currentState: currentEntity[statePropertyToUpdate.code],
-        event: options.operation,
-      });
-
-      entity[statePropertyToUpdate.code] = nextSnapshot.value;
-    }
-  }
-}
-
-function getStateMachineCode(model: RpdDataModel, property: RpdDataModelProperty) {
-  if (property.isBaseProperty) {
-    return `propertyStateMachine.${model.namespace}.${model.base}.${property.code}`;
-  } else {
-    return `propertyStateMachine.${model.namespace}.${model.singularCode}.${property.code}`;
-  }
-}
-
-export default StateMachinePlugin;
+/**
+ * State machine plugin
+ */
+
+import { CreateEntityOptions, RpdApplicationConfig, RpdDataModel, RpdDataModelProperty, UpdateEntityByIdOptions } from "~/types";
+import {
+  IRpdServer,
+  RapidPlugin,
+  RpdConfigurationItemOptions,
+  RpdServerPluginConfigurableTargetOptions,
+  RpdServerPluginExtendingAbilities,
+} from "~/core/server";
+
+import pluginActionHandlers from "./actionHandlers";
+import pluginModels from "./models";
+import pluginRoutes from "./routes";
+import { filter, find, first, get, isEqual } from "lodash";
+import { PropertyStateMachineConfig } from "./StateMachinePluginTypes";
+import { isNullOrUndefined } from "~/utilities/typeUtility";
+import { getStateMachineNextSnapshot } from "./stateMachineHelper";
+import { getEntityPropertiesIncludingBase } from "~/helpers/metaHelper";
+
+class StateMachinePlugin implements RapidPlugin {
+  get code(): string {
+    return "stateMachinePlugin";
+  }
+
+  get description(): string {
+    return null;
+  }
+
+  get extendingAbilities(): RpdServerPluginExtendingAbilities[] {
+    return [];
+  }
+
+  get configurableTargets(): RpdServerPluginConfigurableTargetOptions[] {
+    return [];
+  }
+
+  get configurations(): RpdConfigurationItemOptions[] {
+    return [];
+  }
+
+  async registerActionHandlers(server: IRpdServer): Promise<any> {
+    for (const actionHandler of pluginActionHandlers) {
+      server.registerActionHandler(this, actionHandler);
+    }
+  }
+
+  async configureModels(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
+    server.appendApplicationConfig({ models: pluginModels });
+  }
+
+  async configureRoutes(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
+    server.appendApplicationConfig({ routes: pluginRoutes });
+  }
+
+  async onApplicationLoaded(server: IRpdServer, applicationConfig: RpdApplicationConfig) {
+    const models = server.getApplicationConfig().models;
+    for (const model of models) {
+      for (const property of getEntityPropertiesIncludingBase(server, model)) {
+        const propertyStateMachineConfig: PropertyStateMachineConfig = property.config?.stateMachine;
+        if (propertyStateMachineConfig) {
+          const stateMachineCode = getStateMachineCode(model, property);
+          const stateMachineConfig = propertyStateMachineConfig.config;
+
+          const stateMachineDataAccessor = server.getDataAccessor({
+            singularCode: "state_machine",
+          });
+          const stateMachine = await stateMachineDataAccessor.findOne(
+            {
+              filters: [
+                {
+                  operator: "eq",
+                  field: "code",
+                  value: stateMachineCode,
+                },
+              ],
+            },
+            null,
+          );
+
+          if (stateMachine) {
+            if (!isEqual(stateMachine.config, stateMachineConfig)) {
+              await stateMachineDataAccessor.updateById(
+                stateMachine.id,
+                {
+                  config: stateMachineConfig,
+                },
+                null,
+              );
+            }
+          } else {
+            await stateMachineDataAccessor.create(
+              {
+                code: stateMachineCode,
+                config: stateMachineConfig,
+              },
+              null,
+            );
+          }
+        }
+      }
+    }
+  }
+
+  /**
+   * 创建实体前的处理。
+   * 当属性启用了状态机管理，如创建实体时没有指定该属性的状态值，则应将该属性设置为 stateMachine.config.initial 。
+   * @param server
+   * @param model
+   * @param options
+   */
+  async beforeCreateEntity(server: IRpdServer, model: RpdDataModel, options: CreateEntityOptions) {
+    for (const property of getEntityPropertiesIncludingBase(server, model)) {
+      const isStateMachineEnabled = get(property.config, "stateMachine.enabled", false);
+      if (isStateMachineEnabled && isNullOrUndefined(options.entity[property.code])) {
+        const initialState = get(property.config, "stateMachine.config.initial", null);
+        if (initialState) {
+          options.entity[property.code] = initialState;
+        }
+      }
+    }
+  }
+
+  /**
+   * 更新实体前的处理。
+   * 1. 对所有启用了状态机管理，且 transferControl 为 true 的属性，应禁止直接更新这些属性
+   * 2. 当更新实体时指定了operation，则查找启用了状态机管理的属性。
+   * 如果一个模型中存在多个属性启用了状态机管理，则以 options.stateProperty 中指定的为准。
+   * 对于该状态属性应用 options.operation，使其转换到下一状态。
+   * @param server
+   * @param model
+   * @param options
+   */
+  async beforeUpdateEntity(server: IRpdServer, model: RpdDataModel, options: UpdateEntityByIdOptions, currentEntity: any) {
+    const entity = options.entityToSave;
+
+    const stateMachineEnabledProperties: RpdDataModelProperty[] = [];
+    for (const property of getEntityPropertiesIncludingBase(server, model)) {
+      const isStateMachineEnabled = get(property.config, "stateMachine.enabled", false);
+
+      if (isStateMachineEnabled) {
+        stateMachineEnabledProperties.push(property);
+
+        const isTransferControlEnabled = get(property.config, "stateMachine.transferControl", false);
+        if (isTransferControlEnabled && !isNullOrUndefined(entity[property.code])) {
+          throw new Error(`You're not allowed to change '${property.code}' property directly when transfer control is enabled, do an operation instead.`);
+        }
+      }
+    }
+
+    if (!options.operation) {
+      return;
+    }
+
+    let statePropertiesToUpdate: RpdDataModelProperty[];
+    const statePropertyCodes = options.stateProperties;
+    if (statePropertyCodes && statePropertyCodes.length) {
+      statePropertiesToUpdate = filter(stateMachineEnabledProperties, (property) => statePropertyCodes.includes(property.code));
+    } else {
+      statePropertiesToUpdate = stateMachineEnabledProperties;
+    }
+
+    if (!statePropertiesToUpdate.length) {
+      throw new Error(`State machine property not found.`);
+    }
+
+    for (const statePropertyToUpdate of statePropertiesToUpdate) {
+      const machineConfig = get(statePropertyToUpdate.config, "stateMachine.config", null);
+      if (!machineConfig) {
+        throw new Error(`State machine of property '${statePropertyToUpdate.code}' not configured.`);
+      }
+      machineConfig.id = getStateMachineCode(model, statePropertyToUpdate);
+
+      const nextSnapshot = await getStateMachineNextSnapshot({
+        machineConfig,
+        context: {},
+        currentState: currentEntity[statePropertyToUpdate.code],
+        event: options.operation,
+      });
+
+      entity[statePropertyToUpdate.code] = nextSnapshot.value;
+    }
+  }
+}
+
+function getStateMachineCode(model: RpdDataModel, property: RpdDataModelProperty) {
+  if (property.isBaseProperty) {
+    return `propertyStateMachine.${model.namespace}.${model.base}.${property.code}`;
+  } else {
+    return `propertyStateMachine.${model.namespace}.${model.singularCode}.${property.code}`;
+  }
+}
+
+export default StateMachinePlugin;