@lark-apaas/nestjs-capability 0.0.1-alpha.0

package/dist/index.js

@@ -0,0 +1,620 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/services/template-engine.service.ts
+import { Injectable } from "@nestjs/common";
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+var TemplateEngineService = class {
+  static {
+    __name(this, "TemplateEngineService");
+  }
+  TEMPLATE_REGEX = /^\{\{input\.(.+)\}\}$/;
+  resolve(template, input) {
+    if (typeof template === "string") {
+      return this.resolveString(template, input);
+    }
+    if (Array.isArray(template)) {
+      return template.map((item) => this.resolve(item, input));
+    }
+    if (template !== null && typeof template === "object") {
+      return this.resolveObject(template, input);
+    }
+    return template;
+  }
+  resolveString(template, input) {
+    const match = template.match(this.TEMPLATE_REGEX);
+    if (!match) {
+      return template;
+    }
+    const path2 = match[1];
+    return this.getValueByPath(input, path2);
+  }
+  resolveObject(template, input) {
+    const result = {};
+    for (const [key, value] of Object.entries(template)) {
+      result[key] = this.resolve(value, input);
+    }
+    return result;
+  }
+  getValueByPath(obj, path2) {
+    const keys = path2.split(".");
+    let current = obj;
+    for (const key of keys) {
+      if (current === null || current === void 0) {
+        return void 0;
+      }
+      current = current[key];
+    }
+    return current;
+  }
+};
+TemplateEngineService = _ts_decorate([
+  Injectable()
+], TemplateEngineService);
+
+// src/services/plugin-loader.service.ts
+import { Injectable as Injectable2, Logger } from "@nestjs/common";
+function _ts_decorate2(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate2, "_ts_decorate");
+var PluginNotFoundError = class extends Error {
+  static {
+    __name(this, "PluginNotFoundError");
+  }
+  constructor(pluginID) {
+    super(`Plugin not found: ${pluginID}`);
+    this.name = "PluginNotFoundError";
+  }
+};
+var PluginLoadError = class extends Error {
+  static {
+    __name(this, "PluginLoadError");
+  }
+  constructor(pluginID, reason) {
+    super(`Failed to load plugin ${pluginID}: ${reason}`);
+    this.name = "PluginLoadError";
+  }
+};
+var PluginLoaderService = class _PluginLoaderService {
+  static {
+    __name(this, "PluginLoaderService");
+  }
+  logger = new Logger(_PluginLoaderService.name);
+  pluginInstances = /* @__PURE__ */ new Map();
+  loadPlugin(pluginID) {
+    const cached = this.pluginInstances.get(pluginID);
+    if (cached) {
+      this.logger.debug(`Using cached plugin instance: ${pluginID}`);
+      return cached;
+    }
+    this.logger.log(`Loading plugin: ${pluginID}`);
+    try {
+      const pluginPackage = __require(pluginID);
+      if (typeof pluginPackage.create !== "function") {
+        throw new PluginLoadError(pluginID, "Plugin does not export create() function");
+      }
+      const instance = pluginPackage.create();
+      this.pluginInstances.set(pluginID, instance);
+      this.logger.log(`Plugin loaded successfully: ${pluginID}`);
+      return instance;
+    } catch (error) {
+      if (error.code === "MODULE_NOT_FOUND") {
+        throw new PluginNotFoundError(pluginID);
+      }
+      throw new PluginLoadError(pluginID, error instanceof Error ? error.message : String(error));
+    }
+  }
+  isPluginInstalled(pluginID) {
+    try {
+      __require.resolve(pluginID);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  clearCache(pluginID) {
+    if (pluginID) {
+      this.pluginInstances.delete(pluginID);
+      this.logger.log(`Cleared cache for plugin: ${pluginID}`);
+    } else {
+      this.pluginInstances.clear();
+      this.logger.log("Cleared all plugin caches");
+    }
+  }
+};
+PluginLoaderService = _ts_decorate2([
+  Injectable2()
+], PluginLoaderService);
+
+// src/services/capability.service.ts
+import { Injectable as Injectable3, Logger as Logger2, Inject } from "@nestjs/common";
+import { RequestContextService, PLATFORM_HTTP_CLIENT } from "@lark-apaas/nestjs-common";
+import * as fs from "fs";
+import * as path from "path";
+function _ts_decorate3(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate3, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+function _ts_param(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param, "_ts_param");
+var CapabilityNotFoundError = class extends Error {
+  static {
+    __name(this, "CapabilityNotFoundError");
+  }
+  constructor(capabilityId) {
+    super(`Capability not found: ${capabilityId}`);
+    this.name = "CapabilityNotFoundError";
+  }
+};
+var ActionNotFoundError = class extends Error {
+  static {
+    __name(this, "ActionNotFoundError");
+  }
+  constructor(pluginID, actionName) {
+    super(`Action '${actionName}' not found in plugin ${pluginID}`);
+    this.name = "ActionNotFoundError";
+  }
+};
+var CapabilityService = class _CapabilityService {
+  static {
+    __name(this, "CapabilityService");
+  }
+  requestContextService;
+  httpClient;
+  pluginLoaderService;
+  templateEngineService;
+  logger = new Logger2(_CapabilityService.name);
+  capabilities = /* @__PURE__ */ new Map();
+  capabilitiesDir;
+  constructor(requestContextService, httpClient, pluginLoaderService, templateEngineService) {
+    this.requestContextService = requestContextService;
+    this.httpClient = httpClient;
+    this.pluginLoaderService = pluginLoaderService;
+    this.templateEngineService = templateEngineService;
+    this.capabilitiesDir = path.join(process.cwd(), "server/capabilities");
+  }
+  setCapabilitiesDir(dir) {
+    this.capabilitiesDir = dir;
+  }
+  async onModuleInit() {
+    await this.loadCapabilities();
+  }
+  async loadCapabilities() {
+    this.logger.log(`Loading capabilities from ${this.capabilitiesDir}`);
+    if (!fs.existsSync(this.capabilitiesDir)) {
+      this.logger.warn(`Capabilities directory not found: ${this.capabilitiesDir}`);
+      return;
+    }
+    const files = fs.readdirSync(this.capabilitiesDir).filter((f) => f.endsWith(".json"));
+    for (const file of files) {
+      try {
+        const filePath = path.join(this.capabilitiesDir, file);
+        const content = fs.readFileSync(filePath, "utf-8");
+        const config = JSON.parse(content);
+        if (!config.id) {
+          this.logger.warn(`Skipping capability without id: ${file}`);
+          continue;
+        }
+        this.capabilities.set(config.id, config);
+        this.logger.log(`Loaded capability: ${config.id} (${config.name})`);
+      } catch (error) {
+        this.logger.error(`Failed to load capability from ${file}:`, error);
+      }
+    }
+    this.logger.log(`Loaded ${this.capabilities.size} capabilities`);
+  }
+  listCapabilities() {
+    return Array.from(this.capabilities.values());
+  }
+  getCapability(capabilityId) {
+    return this.capabilities.get(capabilityId) ?? null;
+  }
+  load(capabilityId) {
+    const config = this.capabilities.get(capabilityId);
+    if (!config) {
+      throw new CapabilityNotFoundError(capabilityId);
+    }
+    return {
+      call: /* @__PURE__ */ __name(async (actionName, input, contextOverride) => {
+        return this.execute(config, actionName, input, contextOverride);
+      }, "call")
+    };
+  }
+  async execute(config, actionName, input, contextOverride) {
+    const startTime = Date.now();
+    try {
+      const pluginInstance = this.pluginLoaderService.loadPlugin(config.pluginID);
+      if (!pluginInstance.hasAction(actionName)) {
+        throw new ActionNotFoundError(config.pluginID, actionName);
+      }
+      const resolvedParams = this.templateEngineService.resolve(config.formValue, input);
+      const context = this.buildActionContext(contextOverride);
+      this.logger.log({
+        message: "Executing capability",
+        capabilityId: config.id,
+        action: actionName,
+        pluginID: config.pluginID
+      });
+      const result = await pluginInstance.run(actionName, context, resolvedParams);
+      this.logger.log({
+        message: "Capability executed successfully",
+        capabilityId: config.id,
+        action: actionName,
+        duration: Date.now() - startTime
+      });
+      return result;
+    } catch (error) {
+      this.logger.error({
+        message: "Capability execution failed",
+        capabilityId: config.id,
+        action: actionName,
+        error: error instanceof Error ? error.message : String(error),
+        duration: Date.now() - startTime
+      });
+      throw error;
+    }
+  }
+  buildActionContext(override) {
+    return {
+      logger: this.logger,
+      httpClient: this.httpClient,
+      userContext: override?.userContext ?? this.getUserContext()
+    };
+  }
+  getUserContext() {
+    const ctx = this.requestContextService.getContext();
+    return {
+      userId: ctx?.userId ?? "",
+      tenantId: ctx?.tenantId ?? ""
+    };
+  }
+};
+CapabilityService = _ts_decorate3([
+  Injectable3(),
+  _ts_param(1, Inject(PLATFORM_HTTP_CLIENT)),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof RequestContextService === "undefined" ? Object : RequestContextService,
+    typeof PlatformHttpClient === "undefined" ? Object : PlatformHttpClient,
+    typeof PluginLoaderService === "undefined" ? Object : PluginLoaderService,
+    typeof TemplateEngineService === "undefined" ? Object : TemplateEngineService
+  ])
+], CapabilityService);
+
+// src/controllers/debug.controller.ts
+import { Controller, Post, Get, Param, Body, HttpException, HttpStatus } from "@nestjs/common";
+function _ts_decorate4(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate4, "_ts_decorate");
+function _ts_metadata2(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata2, "_ts_metadata");
+function _ts_param2(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param2, "_ts_param");
+var DebugController = class {
+  static {
+    __name(this, "DebugController");
+  }
+  capabilityService;
+  templateEngineService;
+  constructor(capabilityService, templateEngineService) {
+    this.capabilityService = capabilityService;
+    this.templateEngineService = templateEngineService;
+  }
+  list() {
+    const capabilities = this.capabilityService.listCapabilities();
+    return {
+      code: 0,
+      message: "success",
+      data: capabilities.map((c) => ({
+        id: c.id,
+        name: c.name,
+        pluginID: c.pluginID,
+        pluginVersion: c.pluginVersion
+      }))
+    };
+  }
+  async debug(capabilityId, body) {
+    const startTime = Date.now();
+    const config = this.capabilityService.getCapability(capabilityId);
+    if (!config) {
+      throw new HttpException({
+        code: 1,
+        message: `Capability not found: ${capabilityId}`,
+        error: "CAPABILITY_NOT_FOUND"
+      }, HttpStatus.NOT_FOUND);
+    }
+    const resolvedParams = this.templateEngineService.resolve(config.formValue, body.params);
+    try {
+      const result = await this.capabilityService.load(capabilityId).call(body.action, body.params);
+      return {
+        code: 0,
+        message: "success",
+        data: result,
+        debug: {
+          capabilityConfig: config,
+          resolvedParams,
+          duration: Date.now() - startTime,
+          pluginID: config.pluginID
+        }
+      };
+    } catch (error) {
+      const duration = Date.now() - startTime;
+      if (error instanceof CapabilityNotFoundError) {
+        throw new HttpException({
+          code: 1,
+          message: error.message,
+          error: "CAPABILITY_NOT_FOUND",
+          debug: {
+            duration
+          }
+        }, HttpStatus.NOT_FOUND);
+      }
+      if (error instanceof PluginNotFoundError) {
+        throw new HttpException({
+          code: 1,
+          message: error.message,
+          error: "PLUGIN_NOT_FOUND",
+          debug: {
+            duration,
+            pluginID: config.pluginID
+          }
+        }, HttpStatus.INTERNAL_SERVER_ERROR);
+      }
+      if (error instanceof ActionNotFoundError) {
+        throw new HttpException({
+          code: 1,
+          message: error.message,
+          error: "ACTION_NOT_FOUND",
+          debug: {
+            duration,
+            pluginID: config.pluginID
+          }
+        }, HttpStatus.BAD_REQUEST);
+      }
+      throw new HttpException({
+        code: 1,
+        message: error instanceof Error ? error.message : String(error),
+        error: "EXECUTION_ERROR",
+        debug: {
+          duration,
+          pluginID: config.pluginID,
+          resolvedParams
+        }
+      }, HttpStatus.INTERNAL_SERVER_ERROR);
+    }
+  }
+};
+_ts_decorate4([
+  Get("list"),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", []),
+  _ts_metadata2("design:returntype", typeof ListResponse === "undefined" ? Object : ListResponse)
+], DebugController.prototype, "list", null);
+_ts_decorate4([
+  Post("debug/:capability_id"),
+  _ts_param2(0, Param("capability_id")),
+  _ts_param2(1, Body()),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    String,
+    typeof ExecuteRequestBody === "undefined" ? Object : ExecuteRequestBody
+  ]),
+  _ts_metadata2("design:returntype", Promise)
+], DebugController.prototype, "debug", null);
+DebugController = _ts_decorate4([
+  Controller("__innerapi__/capability"),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    typeof CapabilityService === "undefined" ? Object : CapabilityService,
+    typeof TemplateEngineService === "undefined" ? Object : TemplateEngineService
+  ])
+], DebugController);
+
+// src/controllers/webhook.controller.ts
+import { Controller as Controller2, Post as Post2, Param as Param2, Body as Body2, HttpException as HttpException2, HttpStatus as HttpStatus2 } from "@nestjs/common";
+function _ts_decorate5(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate5, "_ts_decorate");
+function _ts_metadata3(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata3, "_ts_metadata");
+function _ts_param3(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param3, "_ts_param");
+var WebhookController = class {
+  static {
+    __name(this, "WebhookController");
+  }
+  capabilityService;
+  constructor(capabilityService) {
+    this.capabilityService = capabilityService;
+  }
+  async execute(capabilityId, body) {
+    try {
+      const result = await this.capabilityService.load(capabilityId).call(body.action, body.params);
+      return {
+        code: 0,
+        message: "success",
+        data: result
+      };
+    } catch (error) {
+      if (error instanceof CapabilityNotFoundError) {
+        throw new HttpException2({
+          code: 1,
+          message: error.message,
+          error: "CAPABILITY_NOT_FOUND"
+        }, HttpStatus2.NOT_FOUND);
+      }
+      if (error instanceof PluginNotFoundError) {
+        throw new HttpException2({
+          code: 1,
+          message: error.message,
+          error: "PLUGIN_NOT_FOUND"
+        }, HttpStatus2.INTERNAL_SERVER_ERROR);
+      }
+      if (error instanceof ActionNotFoundError) {
+        throw new HttpException2({
+          code: 1,
+          message: error.message,
+          error: "ACTION_NOT_FOUND"
+        }, HttpStatus2.BAD_REQUEST);
+      }
+      throw new HttpException2({
+        code: 1,
+        message: error instanceof Error ? error.message : String(error),
+        error: "EXECUTION_ERROR"
+      }, HttpStatus2.INTERNAL_SERVER_ERROR);
+    }
+  }
+};
+_ts_decorate5([
+  Post2(":capability_id"),
+  _ts_param3(0, Param2("capability_id")),
+  _ts_param3(1, Body2()),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
+    String,
+    typeof ExecuteRequestBody === "undefined" ? Object : ExecuteRequestBody
+  ]),
+  _ts_metadata3("design:returntype", Promise)
+], WebhookController.prototype, "execute", null);
+WebhookController = _ts_decorate5([
+  Controller2("api/capability"),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
+    typeof CapabilityService === "undefined" ? Object : CapabilityService
+  ])
+], WebhookController);
+
+// src/capability.module.ts
+import { Module } from "@nestjs/common";
+import { RequestContextService as RequestContextService2, PLATFORM_HTTP_CLIENT as PLATFORM_HTTP_CLIENT2 } from "@lark-apaas/nestjs-common";
+function _ts_decorate6(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate6, "_ts_decorate");
+var CAPABILITY_OPTIONS = /* @__PURE__ */ Symbol("CAPABILITY_OPTIONS");
+var isDevelopment = process.env.NODE_ENV === "development";
+function getControllers() {
+  const controllers = [
+    WebhookController
+  ];
+  if (isDevelopment) {
+    controllers.push(DebugController);
+  }
+  return controllers;
+}
+__name(getControllers, "getControllers");
+var CapabilityModule = class _CapabilityModule {
+  static {
+    __name(this, "CapabilityModule");
+  }
+  static forRoot(options) {
+    return {
+      module: _CapabilityModule,
+      controllers: getControllers(),
+      providers: [
+        {
+          provide: CAPABILITY_OPTIONS,
+          useValue: options ?? {}
+        },
+        {
+          provide: CapabilityService,
+          useFactory: /* @__PURE__ */ __name((requestContextService, httpClient, pluginLoader, templateEngine, moduleOptions) => {
+            const service = new CapabilityService(requestContextService, httpClient, pluginLoader, templateEngine);
+            if (moduleOptions?.capabilitiesDir) {
+              service.setCapabilitiesDir(moduleOptions.capabilitiesDir);
+            }
+            return service;
+          }, "useFactory"),
+          inject: [
+            RequestContextService2,
+            PLATFORM_HTTP_CLIENT2,
+            PluginLoaderService,
+            TemplateEngineService,
+            CAPABILITY_OPTIONS
+          ]
+        },
+        PluginLoaderService,
+        TemplateEngineService
+      ],
+      exports: [
+        CapabilityService
+      ]
+    };
+  }
+};
+CapabilityModule = _ts_decorate6([
+  Module({
+    controllers: getControllers(),
+    providers: [
+      CapabilityService,
+      PluginLoaderService,
+      TemplateEngineService
+    ],
+    exports: [
+      CapabilityService
+    ]
+  })
+], CapabilityModule);
+export {
+  ActionNotFoundError,
+  CapabilityModule,
+  CapabilityNotFoundError,
+  CapabilityService,
+  DebugController,
+  PluginLoadError,
+  PluginLoaderService,
+  PluginNotFoundError,
+  TemplateEngineService,
+  WebhookController
+};
+//# sourceMappingURL=index.js.map