@ruiapp/rapid-core 0.1.83 → 0.2.1

package/src/plugins/entityAccessControl/EntityAccessControlPlugin.ts

@@ -1,146 +1,146 @@
-import type { RpdApplicationConfig, RpdDataModelProperty } from "~/types";
-
-import {
-  IRpdServer,
-  RapidPlugin,
-  RpdConfigurationItemOptions,
-  RpdServerPluginConfigurableTargetOptions,
-  RpdServerPluginExtendingAbilities,
-} from "~/core/server";
-import { find, set } from "lodash";
-import { ActionHandlerContext } from "~/core/actionHandler";
-import { isAccessAllowed } from "~/utilities/accessControlUtility";
-import { RouteContext } from "~/core/routeContext";
-
-class EntityAccessControlPlugin implements RapidPlugin {
-  constructor() {}
-
-  get code(): string {
-    return "entityAccessControl";
-  }
-
-  get description(): string {
-    return "";
-  }
-
-  get extendingAbilities(): RpdServerPluginExtendingAbilities[] {
-    return [];
-  }
-
-  get configurableTargets(): RpdServerPluginConfigurableTargetOptions[] {
-    return [];
-  }
-
-  get configurations(): RpdConfigurationItemOptions[] {
-    return [];
-  }
-
-  async onLoadingApplication(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
-    const properties: RpdDataModelProperty[] = [
-      {
-        name: "permissionPolicies",
-        code: "permissionPolicies",
-        columnName: "permission_policies",
-        type: "json",
-      },
-    ];
-    server.appendModelProperties("model", properties);
-  }
-
-  async configureRoutes(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
-    const logger = server.getLogger();
-    logger.info("Configuring entity access checking policies...");
-
-    const routes = applicationConfig.routes;
-    for (const route of routes) {
-      const { actions } = route;
-      if (!actions) {
-        continue;
-      }
-
-      for (const action of route.actions) {
-        if (action.code === "findCollectionEntityById" || action.code === "findCollectionEntities" || action.code === "countCollectionEntities") {
-          const model = find(applicationConfig.models, (item) => item.singularCode === action.config.singularCode);
-          if (!model) {
-            continue;
-          }
-          const { permissionPolicies } = model;
-          if (!permissionPolicies) {
-            continue;
-          }
-          if (permissionPolicies.find) {
-            set(action, "config.permissionCheck", permissionPolicies.find);
-          }
-        } else if (action.code === "createCollectionEntity" || action.code === "createCollectionEntitiesBatch") {
-          const model = find(applicationConfig.models, (item) => item.singularCode === action.config.singularCode);
-          if (!model) {
-            continue;
-          }
-          const { permissionPolicies } = model;
-          if (!permissionPolicies) {
-            continue;
-          }
-          if (permissionPolicies.create) {
-            set(action, "config.permissionCheck", permissionPolicies.create);
-          }
-        } else if (action.code === "updateCollectionEntityById" || action.code === "addEntityRelations" || action.code === "removeEntityRelations") {
-          const model = find(applicationConfig.models, (item) => item.singularCode === action.config.singularCode);
-          if (!model) {
-            continue;
-          }
-          const { permissionPolicies } = model;
-          if (!permissionPolicies) {
-            continue;
-          }
-          if (permissionPolicies.update) {
-            set(action, "config.permissionCheck", permissionPolicies.update);
-          }
-        } else if (action.code === "deleteCollectionEntityById" || action.code === "deleteCollectionEntities") {
-          const model = find(applicationConfig.models, (item) => item.singularCode === action.config.singularCode);
-          if (!model) {
-            continue;
-          }
-          const { permissionPolicies } = model;
-          if (!permissionPolicies) {
-            continue;
-          }
-          if (permissionPolicies.delete) {
-            set(action, "config.permissionCheck", permissionPolicies.delete);
-          }
-        }
-      }
-    }
-  }
-
-  async onPrepareRouteContext(server: IRpdServer, routeContext: RouteContext) {
-    const userId = routeContext.state.userId;
-    if (!userId) {
-      return;
-    }
-
-    const actions = await server.queryDatabaseObject(
-      `select distinct a.* from sys_actions a
-      inner join oc_role_sys_action_links ra on a.id = ra.action_id
-      inner join oc_role_user_links ru on ru.role_id = ra.role_id
-      where ru.user_id = $1;`,
-      [userId],
-    );
-    routeContext.state.allowedActions = actions.map((item) => item.code);
-  }
-
-  async beforeRunRouteActions(server: IRpdServer, handlerContext: ActionHandlerContext): Promise<any> {
-    // Check permission
-    const { routerContext } = handlerContext;
-    const { routeConfig } = routerContext;
-    for (const actionConfig of routeConfig.actions) {
-      const permissionCheck = actionConfig.config?.permissionCheck;
-      if (permissionCheck) {
-        if (!isAccessAllowed(permissionCheck, routerContext.state.allowedActions || [])) {
-          throw new Error(`Your action of '${actionConfig.code}' is not permitted.`);
-        }
-      }
-    }
-  }
-}
-
-export default EntityAccessControlPlugin;
+import type { RpdApplicationConfig, RpdDataModelProperty } from "~/types";
+
+import {
+  IRpdServer,
+  RapidPlugin,
+  RpdConfigurationItemOptions,
+  RpdServerPluginConfigurableTargetOptions,
+  RpdServerPluginExtendingAbilities,
+} from "~/core/server";
+import { find, set } from "lodash";
+import { ActionHandlerContext } from "~/core/actionHandler";
+import { isAccessAllowed } from "~/utilities/accessControlUtility";
+import { RouteContext } from "~/core/routeContext";
+
+class EntityAccessControlPlugin implements RapidPlugin {
+  constructor() {}
+
+  get code(): string {
+    return "entityAccessControl";
+  }
+
+  get description(): string {
+    return "";
+  }
+
+  get extendingAbilities(): RpdServerPluginExtendingAbilities[] {
+    return [];
+  }
+
+  get configurableTargets(): RpdServerPluginConfigurableTargetOptions[] {
+    return [];
+  }
+
+  get configurations(): RpdConfigurationItemOptions[] {
+    return [];
+  }
+
+  async onLoadingApplication(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
+    const properties: RpdDataModelProperty[] = [
+      {
+        name: "permissionPolicies",
+        code: "permissionPolicies",
+        columnName: "permission_policies",
+        type: "json",
+      },
+    ];
+    server.appendModelProperties("model", properties);
+  }
+
+  async configureRoutes(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
+    const logger = server.getLogger();
+    logger.info("Configuring entity access checking policies...");
+
+    const routes = applicationConfig.routes;
+    for (const route of routes) {
+      const { actions } = route;
+      if (!actions) {
+        continue;
+      }
+
+      for (const action of route.actions) {
+        if (action.code === "findCollectionEntityById" || action.code === "findCollectionEntities" || action.code === "countCollectionEntities") {
+          const model = find(applicationConfig.models, (item) => item.singularCode === action.config.singularCode);
+          if (!model) {
+            continue;
+          }
+          const { permissionPolicies } = model;
+          if (!permissionPolicies) {
+            continue;
+          }
+          if (permissionPolicies.find) {
+            set(action, "config.permissionCheck", permissionPolicies.find);
+          }
+        } else if (action.code === "createCollectionEntity" || action.code === "createCollectionEntitiesBatch") {
+          const model = find(applicationConfig.models, (item) => item.singularCode === action.config.singularCode);
+          if (!model) {
+            continue;
+          }
+          const { permissionPolicies } = model;
+          if (!permissionPolicies) {
+            continue;
+          }
+          if (permissionPolicies.create) {
+            set(action, "config.permissionCheck", permissionPolicies.create);
+          }
+        } else if (action.code === "updateCollectionEntityById" || action.code === "addEntityRelations" || action.code === "removeEntityRelations") {
+          const model = find(applicationConfig.models, (item) => item.singularCode === action.config.singularCode);
+          if (!model) {
+            continue;
+          }
+          const { permissionPolicies } = model;
+          if (!permissionPolicies) {
+            continue;
+          }
+          if (permissionPolicies.update) {
+            set(action, "config.permissionCheck", permissionPolicies.update);
+          }
+        } else if (action.code === "deleteCollectionEntityById" || action.code === "deleteCollectionEntities") {
+          const model = find(applicationConfig.models, (item) => item.singularCode === action.config.singularCode);
+          if (!model) {
+            continue;
+          }
+          const { permissionPolicies } = model;
+          if (!permissionPolicies) {
+            continue;
+          }
+          if (permissionPolicies.delete) {
+            set(action, "config.permissionCheck", permissionPolicies.delete);
+          }
+        }
+      }
+    }
+  }
+
+  async onPrepareRouteContext(server: IRpdServer, routeContext: RouteContext) {
+    const userId = routeContext.state.userId;
+    if (!userId) {
+      return;
+    }
+
+    const actions = await server.queryDatabaseObject(
+      `select distinct a.* from sys_actions a
+      inner join oc_role_sys_action_links ra on a.id = ra.action_id
+      inner join oc_role_user_links ru on ru.role_id = ra.role_id
+      where ru.user_id = $1;`,
+      [userId],
+    );
+    routeContext.state.allowedActions = actions.map((item) => item.code);
+  }
+
+  async beforeRunRouteActions(server: IRpdServer, handlerContext: ActionHandlerContext): Promise<any> {
+    // Check permission
+    const { routerContext } = handlerContext;
+    const { routeConfig } = routerContext;
+    for (const actionConfig of routeConfig.actions) {
+      const permissionCheck = actionConfig.config?.permissionCheck;
+      if (permissionCheck) {
+        if (!isAccessAllowed(permissionCheck, routerContext.state.allowedActions || [])) {
+          throw new Error(`Your action of '${actionConfig.code}' is not permitted.`);
+        }
+      }
+    }
+  }
+}
+
+export default EntityAccessControlPlugin;

package/src/plugins/fileManage/FileManagePlugin.ts

@@ -1,52 +1,52 @@
-/**
- * File manager plugin
- */
-
-import { RpdApplicationConfig } from "~/types";
-
-import * as downloadDocumentActionHandler from "./actionHandlers/downloadDocument";
-import * as downloadFileActionHandler from "./actionHandlers/downloadFile";
-import * as uploadFileActionHandler from "./actionHandlers/uploadFile";
-import {
-  IRpdServer,
-  RapidPlugin,
-  RpdConfigurationItemOptions,
-  RpdServerPluginConfigurableTargetOptions,
-  RpdServerPluginExtendingAbilities,
-} from "~/core/server";
-
-import pluginRoutes from "./routes";
-
-class FileManager implements RapidPlugin {
-  get code(): string {
-    return "fileManager";
-  }
-
-  get description(): string {
-    return null;
-  }
-
-  get extendingAbilities(): RpdServerPluginExtendingAbilities[] {
-    return [];
-  }
-
-  get configurableTargets(): RpdServerPluginConfigurableTargetOptions[] {
-    return [];
-  }
-
-  get configurations(): RpdConfigurationItemOptions[] {
-    return [];
-  }
-
-  async registerActionHandlers(server: IRpdServer): Promise<any> {
-    server.registerActionHandler(this, downloadDocumentActionHandler);
-    server.registerActionHandler(this, downloadFileActionHandler);
-    server.registerActionHandler(this, uploadFileActionHandler);
-  }
-
-  async configureRoutes(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
-    server.appendApplicationConfig({ routes: pluginRoutes });
-  }
-}
-
-export default FileManager;
+/**
+ * File manager plugin
+ */
+
+import { RpdApplicationConfig } from "~/types";
+
+import * as downloadDocumentActionHandler from "./actionHandlers/downloadDocument";
+import * as downloadFileActionHandler from "./actionHandlers/downloadFile";
+import * as uploadFileActionHandler from "./actionHandlers/uploadFile";
+import {
+  IRpdServer,
+  RapidPlugin,
+  RpdConfigurationItemOptions,
+  RpdServerPluginConfigurableTargetOptions,
+  RpdServerPluginExtendingAbilities,
+} from "~/core/server";
+
+import pluginRoutes from "./routes";
+
+class FileManager implements RapidPlugin {
+  get code(): string {
+    return "fileManager";
+  }
+
+  get description(): string {
+    return null;
+  }
+
+  get extendingAbilities(): RpdServerPluginExtendingAbilities[] {
+    return [];
+  }
+
+  get configurableTargets(): RpdServerPluginConfigurableTargetOptions[] {
+    return [];
+  }
+
+  get configurations(): RpdConfigurationItemOptions[] {
+    return [];
+  }
+
+  async registerActionHandlers(server: IRpdServer): Promise<any> {
+    server.registerActionHandler(this, downloadDocumentActionHandler);
+    server.registerActionHandler(this, downloadFileActionHandler);
+    server.registerActionHandler(this, uploadFileActionHandler);
+  }
+
+  async configureRoutes(server: IRpdServer, applicationConfig: RpdApplicationConfig): Promise<any> {
+    server.appendApplicationConfig({ routes: pluginRoutes });
+  }
+}
+
+export default FileManager;

package/src/plugins/fileManage/actionHandlers/downloadDocument.ts

@@ -1,36 +1,36 @@
-import path from "path";
-import { ActionHandlerContext } from "~/core/actionHandler";
-import { RapidPlugin } from "~/core/server";
-import { readFile } from "~/utilities/fsUtility";
-
-export const code = "downloadDocument";
-
-export async function handler(plugin: RapidPlugin, ctx: ActionHandlerContext, options: any) {
-  const { server, applicationConfig, routerContext, input } = ctx;
-  const { request, response } = routerContext;
-
-  const documentDataAccessor = ctx.server.getDataAccessor({
-    singularCode: "ecm_document",
-  });
-  const storageDataAccessor = ctx.server.getDataAccessor({
-    singularCode: "ecm_storage_object",
-  });
-
-  const document = await documentDataAccessor.findById(input.documentId);
-  if (!document) {
-    ctx.output = { error: new Error("Document not found.") };
-    return;
-  }
-  const storageObject = await storageDataAccessor.findById(document.storage_object_id);
-  if (!storageObject) {
-    ctx.output = { error: new Error("Storage object not found.") };
-    return;
-  }
-
-  const fileKey = storageObject.key;
-  const filePathName = path.join(server.config.localFileStoragePath, fileKey);
-  const attachmentFileName = document.name;
-
-  response.body = await readFile(filePathName);
-  response.headers.set("Content-Disposition", `attachment; filename="${encodeURIComponent(attachmentFileName)}"`);
-}
+import path from "path";
+import { ActionHandlerContext } from "~/core/actionHandler";
+import { RapidPlugin } from "~/core/server";
+import { readFile } from "~/utilities/fsUtility";
+
+export const code = "downloadDocument";
+
+export async function handler(plugin: RapidPlugin, ctx: ActionHandlerContext, options: any) {
+  const { server, applicationConfig, routerContext, input } = ctx;
+  const { request, response } = routerContext;
+
+  const documentDataAccessor = ctx.server.getDataAccessor({
+    singularCode: "ecm_document",
+  });
+  const storageDataAccessor = ctx.server.getDataAccessor({
+    singularCode: "ecm_storage_object",
+  });
+
+  const document = await documentDataAccessor.findById(input.documentId);
+  if (!document) {
+    ctx.output = { error: new Error("Document not found.") };
+    return;
+  }
+  const storageObject = await storageDataAccessor.findById(document.storage_object_id);
+  if (!storageObject) {
+    ctx.output = { error: new Error("Storage object not found.") };
+    return;
+  }
+
+  const fileKey = storageObject.key;
+  const filePathName = path.join(server.config.localFileStoragePath, fileKey);
+  const attachmentFileName = document.name;
+
+  response.body = await readFile(filePathName);
+  response.headers.set("Content-Disposition", `attachment; filename="${encodeURIComponent(attachmentFileName)}"`);
+}

package/src/plugins/fileManage/actionHandlers/downloadFile.ts

@@ -1,44 +1,44 @@
-import path from "path";
-import { readFile } from "~/utilities/fsUtility";
-import { ActionHandlerContext } from "~/core/actionHandler";
-import { RapidPlugin } from "~/core/server";
-
-export type DownloadFileInput = {
-  fileId?: string;
-  fileKey?: string;
-  fileName?: string;
-  inline?: boolean;
-};
-
-export const code = "downloadFile";
-
-export async function handler(plugin: RapidPlugin, ctx: ActionHandlerContext, options: any) {
-  const { server, applicationConfig, routerContext } = ctx;
-  const { request, response } = routerContext;
-  //TODO: only public files can download by this handler
-
-  const input: DownloadFileInput = ctx.input;
-
-  let fileKey: string = input.fileKey;
-
-  if (!fileKey && input.fileId) {
-    const dataAccessor = ctx.server.getDataAccessor({
-      singularCode: "ecm_storage_object",
-    });
-
-    const storageObject = await dataAccessor.findById(input.fileId);
-    if (!storageObject) {
-      ctx.output = { error: new Error("Storage object not found.") };
-      return;
-    }
-
-    fileKey = storageObject.key;
-  }
-  const filePathName = path.join(server.config.localFileStoragePath, fileKey);
-  const attachmentFileName = input.fileName || path.basename(fileKey);
-
-  response.body = await readFile(filePathName);
-
-  const dispositionType = input.inline ? "inline" : "attachment";
-  response.headers.set("Content-Disposition", `${dispositionType}; filename="${encodeURIComponent(attachmentFileName)}"`);
-}
+import path from "path";
+import { readFile } from "~/utilities/fsUtility";
+import { ActionHandlerContext } from "~/core/actionHandler";
+import { RapidPlugin } from "~/core/server";
+
+export type DownloadFileInput = {
+  fileId?: string;
+  fileKey?: string;
+  fileName?: string;
+  inline?: boolean;
+};
+
+export const code = "downloadFile";
+
+export async function handler(plugin: RapidPlugin, ctx: ActionHandlerContext, options: any) {
+  const { server, applicationConfig, routerContext } = ctx;
+  const { request, response } = routerContext;
+  //TODO: only public files can download by this handler
+
+  const input: DownloadFileInput = ctx.input;
+
+  let fileKey: string = input.fileKey;
+
+  if (!fileKey && input.fileId) {
+    const dataAccessor = ctx.server.getDataAccessor({
+      singularCode: "ecm_storage_object",
+    });
+
+    const storageObject = await dataAccessor.findById(input.fileId);
+    if (!storageObject) {
+      ctx.output = { error: new Error("Storage object not found.") };
+      return;
+    }
+
+    fileKey = storageObject.key;
+  }
+  const filePathName = path.join(server.config.localFileStoragePath, fileKey);
+  const attachmentFileName = input.fileName || path.basename(fileKey);
+
+  response.body = await readFile(filePathName);
+
+  const dispositionType = input.inline ? "inline" : "attachment";
+  response.headers.set("Content-Disposition", `${dispositionType}; filename="${encodeURIComponent(attachmentFileName)}"`);
+}

package/src/plugins/fileManage/actionHandlers/uploadFile.ts

@@ -1,33 +1,33 @@
-import { v1 as uuidv1 } from "uuid";
-import { appendFile } from "~/utilities/fsUtility";
-import { ActionHandlerContext } from "~/core/actionHandler";
-import path from "path";
-import { isArray } from "lodash";
-import { RapidPlugin } from "~/core/server";
-
-export const code = "uploadFile";
-
-export async function handler(plugin: RapidPlugin, ctx: ActionHandlerContext, options: any) {
-  const { server, applicationConfig, routerContext, input } = ctx;
-  const { request, response } = routerContext;
-
-  let file: File | File[] | null = input.file || input.files;
-  if (isArray(file)) {
-    file = file[0];
-  }
-
-  if (!file) {
-    ctx.status = 400;
-    ctx.output = { error: "File not found in request body." };
-    return;
-  }
-
-  const extName = path.extname(file.name);
-  const fileKey = `${uuidv1()}${extName}`;
-  const filePathName = path.join(server.config.localFileStoragePath, fileKey);
-
-  const fileBuffer = await file.arrayBuffer();
-  await appendFile(filePathName, fileBuffer);
-
-  ctx.output = { ok: true, fileKey };
-}
+import { v1 as uuidv1 } from "uuid";
+import { appendFile } from "~/utilities/fsUtility";
+import { ActionHandlerContext } from "~/core/actionHandler";
+import path from "path";
+import { isArray } from "lodash";
+import { RapidPlugin } from "~/core/server";
+
+export const code = "uploadFile";
+
+export async function handler(plugin: RapidPlugin, ctx: ActionHandlerContext, options: any) {
+  const { server, applicationConfig, routerContext, input } = ctx;
+  const { request, response } = routerContext;
+
+  let file: File | File[] | null = input.file || input.files;
+  if (isArray(file)) {
+    file = file[0];
+  }
+
+  if (!file) {
+    ctx.status = 400;
+    ctx.output = { error: "File not found in request body." };
+    return;
+  }
+
+  const extName = path.extname(file.name);
+  const fileKey = `${uuidv1()}${extName}`;
+  const filePathName = path.join(server.config.localFileStoragePath, fileKey);
+
+  const fileBuffer = await file.arrayBuffer();
+  await appendFile(filePathName, fileBuffer);
+
+  ctx.output = { ok: true, fileKey };
+}

package/src/plugins/fileManage/routes/downloadDocument.ts

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