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

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/services/template-engine.service.ts","../src/services/plugin-loader.service.ts","../src/services/capability.service.ts","../src/controllers/debug.controller.ts","../src/controllers/webhook.controller.ts","../src/capability.module.ts"],"sourcesContent":["export * from './interfaces';\nexport * from './services';\nexport * from './controllers';\nexport * from './capability.module';\n","import { Injectable } from '@nestjs/common';\n\n@Injectable()\nexport class TemplateEngineService {\n  private readonly TEMPLATE_REGEX = /^\\{\\{input\\.(.+)\\}\\}$/;\n\n  resolve(template: unknown, input: Record<string, unknown>): unknown {\n    if (typeof template === 'string') {\n      return this.resolveString(template, input);\n    }\n\n    if (Array.isArray(template)) {\n      return template.map(item => this.resolve(item, input));\n    }\n\n    if (template !== null && typeof template === 'object') {\n      return this.resolveObject(template as Record<string, unknown>, input);\n    }\n\n    return template;\n  }\n\n  private resolveString(template: string, input: Record<string, unknown>): unknown {\n    const match = template.match(this.TEMPLATE_REGEX);\n    if (!match) {\n      return template;\n    }\n\n    const path = match[1];\n    return this.getValueByPath(input, path);\n  }\n\n  private resolveObject(\n    template: Record<string, unknown>,\n    input: Record<string, unknown>,\n  ): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n\n    for (const [key, value] of Object.entries(template)) {\n      result[key] = this.resolve(value, input);\n    }\n\n    return result;\n  }\n\n  private getValueByPath(obj: Record<string, unknown>, path: string): unknown {\n    const keys = path.split('.');\n    let current: unknown = obj;\n\n    for (const key of keys) {\n      if (current === null || current === undefined) {\n        return undefined;\n      }\n      current = (current as Record<string, unknown>)[key];\n    }\n\n    return current;\n  }\n}\n","import { Injectable, Logger } from '@nestjs/common';\nimport type { PluginInstance, PluginPackage } from '../interfaces';\n\nexport class PluginNotFoundError extends Error {\n  constructor(pluginID: string) {\n    super(`Plugin not found: ${pluginID}`);\n    this.name = 'PluginNotFoundError';\n  }\n}\n\nexport class PluginLoadError extends Error {\n  constructor(pluginID: string, reason: string) {\n    super(`Failed to load plugin ${pluginID}: ${reason}`);\n    this.name = 'PluginLoadError';\n  }\n}\n\n@Injectable()\nexport class PluginLoaderService {\n  private readonly logger = new Logger(PluginLoaderService.name);\n  private readonly pluginInstances = new Map<string, PluginInstance>();\n\n  loadPlugin(pluginID: string): PluginInstance {\n    const cached = this.pluginInstances.get(pluginID);\n    if (cached) {\n      this.logger.debug(`Using cached plugin instance: ${pluginID}`);\n      return cached;\n    }\n\n    this.logger.log(`Loading plugin: ${pluginID}`);\n\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      const pluginPackage = require(pluginID) as PluginPackage;\n\n      if (typeof pluginPackage.create !== 'function') {\n        throw new PluginLoadError(pluginID, 'Plugin does not export create() function');\n      }\n\n      const instance = pluginPackage.create();\n      this.pluginInstances.set(pluginID, instance);\n\n      this.logger.log(`Plugin loaded successfully: ${pluginID}`);\n      return instance;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === 'MODULE_NOT_FOUND') {\n        throw new PluginNotFoundError(pluginID);\n      }\n      throw new PluginLoadError(\n        pluginID,\n        error instanceof Error ? error.message : String(error),\n      );\n    }\n  }\n\n  isPluginInstalled(pluginID: string): boolean {\n    try {\n      require.resolve(pluginID);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  clearCache(pluginID?: string): void {\n    if (pluginID) {\n      this.pluginInstances.delete(pluginID);\n      this.logger.log(`Cleared cache for plugin: ${pluginID}`);\n    } else {\n      this.pluginInstances.clear();\n      this.logger.log('Cleared all plugin caches');\n    }\n  }\n}\n","import { Injectable, Logger, Inject, OnModuleInit } from '@nestjs/common';\nimport {\n  RequestContextService,\n  PLATFORM_HTTP_CLIENT,\n  type PlatformHttpClient,\n} from '@lark-apaas/nestjs-common';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type { CapabilityConfig, PluginActionContext, UserContext } from '../interfaces';\nimport { PluginLoaderService } from './plugin-loader.service';\nimport { TemplateEngineService } from './template-engine.service';\n\nexport class CapabilityNotFoundError extends Error {\n  constructor(capabilityId: string) {\n    super(`Capability not found: ${capabilityId}`);\n    this.name = 'CapabilityNotFoundError';\n  }\n}\n\nexport class ActionNotFoundError extends Error {\n  constructor(pluginID: string, actionName: string) {\n    super(`Action '${actionName}' not found in plugin ${pluginID}`);\n    this.name = 'ActionNotFoundError';\n  }\n}\n\nexport interface CapabilityExecutor {\n  call(actionName: string, input: unknown, context?: Partial<PluginActionContext>): Promise<unknown>;\n}\n\nexport interface CapabilityModuleOptions {\n  capabilitiesDir?: string;\n}\n\n@Injectable()\nexport class CapabilityService implements OnModuleInit {\n  private readonly logger = new Logger(CapabilityService.name);\n  private readonly capabilities = new Map<string, CapabilityConfig>();\n  private capabilitiesDir: string;\n\n  constructor(\n    private readonly requestContextService: RequestContextService,\n    @Inject(PLATFORM_HTTP_CLIENT) private readonly httpClient: PlatformHttpClient,\n    private readonly pluginLoaderService: PluginLoaderService,\n    private readonly templateEngineService: TemplateEngineService,\n  ) {\n    this.capabilitiesDir = path.join(process.cwd(), 'server/capabilities');\n  }\n\n  setCapabilitiesDir(dir: string): void {\n    this.capabilitiesDir = dir;\n  }\n\n  async onModuleInit(): Promise<void> {\n    await this.loadCapabilities();\n  }\n\n  private async loadCapabilities(): Promise<void> {\n    this.logger.log(`Loading capabilities from ${this.capabilitiesDir}`);\n\n    if (!fs.existsSync(this.capabilitiesDir)) {\n      this.logger.warn(`Capabilities directory not found: ${this.capabilitiesDir}`);\n      return;\n    }\n\n    const files = fs.readdirSync(this.capabilitiesDir).filter(f => f.endsWith('.json'));\n\n    for (const file of files) {\n      try {\n        const filePath = path.join(this.capabilitiesDir, file);\n        const content = fs.readFileSync(filePath, 'utf-8');\n        const config = JSON.parse(content) as CapabilityConfig;\n\n        if (!config.id) {\n          this.logger.warn(`Skipping capability without id: ${file}`);\n          continue;\n        }\n\n        this.capabilities.set(config.id, config);\n        this.logger.log(`Loaded capability: ${config.id} (${config.name})`);\n      } catch (error) {\n        this.logger.error(`Failed to load capability from ${file}:`, error);\n      }\n    }\n\n    this.logger.log(`Loaded ${this.capabilities.size} capabilities`);\n  }\n\n  listCapabilities(): CapabilityConfig[] {\n    return Array.from(this.capabilities.values());\n  }\n\n  getCapability(capabilityId: string): CapabilityConfig | null {\n    return this.capabilities.get(capabilityId) ?? null;\n  }\n\n  load(capabilityId: string): CapabilityExecutor {\n    const config = this.capabilities.get(capabilityId);\n    if (!config) {\n      throw new CapabilityNotFoundError(capabilityId);\n    }\n\n    return {\n      call: async (\n        actionName: string,\n        input: unknown,\n        contextOverride?: Partial<PluginActionContext>,\n      ) => {\n        return this.execute(config, actionName, input, contextOverride);\n      },\n    };\n  }\n\n  private async execute(\n    config: CapabilityConfig,\n    actionName: string,\n    input: unknown,\n    contextOverride?: Partial<PluginActionContext>,\n  ): Promise<unknown> {\n    const startTime = Date.now();\n\n    try {\n      const pluginInstance = this.pluginLoaderService.loadPlugin(config.pluginID);\n\n      if (!pluginInstance.hasAction(actionName)) {\n        throw new ActionNotFoundError(config.pluginID, actionName);\n      }\n\n      const resolvedParams = this.templateEngineService.resolve(\n        config.formValue,\n        input as Record<string, unknown>,\n      );\n\n      const context = this.buildActionContext(contextOverride);\n\n      this.logger.log({\n        message: 'Executing capability',\n        capabilityId: config.id,\n        action: actionName,\n        pluginID: config.pluginID,\n      });\n\n      const result = await pluginInstance.run(actionName, context, resolvedParams);\n\n      this.logger.log({\n        message: 'Capability executed successfully',\n        capabilityId: config.id,\n        action: actionName,\n        duration: Date.now() - startTime,\n      });\n\n      return result;\n    } catch (error) {\n      this.logger.error({\n        message: 'Capability execution failed',\n        capabilityId: config.id,\n        action: actionName,\n        error: error instanceof Error ? error.message : String(error),\n        duration: Date.now() - startTime,\n      });\n      throw error;\n    }\n  }\n\n  private buildActionContext(override?: Partial<PluginActionContext>): PluginActionContext {\n    return {\n      logger: this.logger,\n      httpClient: this.httpClient,\n      userContext: override?.userContext ?? this.getUserContext(),\n    };\n  }\n\n  private getUserContext(): UserContext {\n    const ctx = this.requestContextService.getContext();\n    return {\n      userId: ctx?.userId ?? '',\n      tenantId: ctx?.tenantId ?? '',\n    };\n  }\n}\n","import {\n  Controller,\n  Post,\n  Get,\n  Param,\n  Body,\n  HttpException,\n  HttpStatus,\n} from '@nestjs/common';\nimport {\n  CapabilityService,\n  CapabilityNotFoundError,\n  ActionNotFoundError,\n} from '../services/capability.service';\nimport { PluginNotFoundError } from '../services/plugin-loader.service';\nimport { TemplateEngineService } from '../services/template-engine.service';\n\ninterface ExecuteRequestBody {\n  action: string;\n  params: Record<string, unknown>;\n}\n\ninterface DebugResponse {\n  code: number;\n  message: string;\n  data: unknown;\n  debug?: {\n    capabilityConfig: unknown;\n    resolvedParams: unknown;\n    duration: number;\n    pluginID: string;\n  };\n}\n\ninterface ListResponse {\n  code: number;\n  message: string;\n  data: Array<{\n    id: string;\n    name: string;\n    pluginID: string;\n    pluginVersion: string;\n  }>;\n}\n\n@Controller('__innerapi__/capability')\nexport class DebugController {\n  constructor(\n    private readonly capabilityService: CapabilityService,\n    private readonly templateEngineService: TemplateEngineService,\n  ) {}\n\n  @Get('list')\n  list(): ListResponse {\n    const capabilities = this.capabilityService.listCapabilities();\n\n    return {\n      code: 0,\n      message: 'success',\n      data: capabilities.map(c => ({\n        id: c.id,\n        name: c.name,\n        pluginID: c.pluginID,\n        pluginVersion: c.pluginVersion,\n      })),\n    };\n  }\n\n  @Post('debug/:capability_id')\n  async debug(\n    @Param('capability_id') capabilityId: string,\n    @Body() body: ExecuteRequestBody,\n  ): Promise<DebugResponse> {\n    const startTime = Date.now();\n\n    const config = this.capabilityService.getCapability(capabilityId);\n    if (!config) {\n      throw new HttpException(\n        {\n          code: 1,\n          message: `Capability not found: ${capabilityId}`,\n          error: 'CAPABILITY_NOT_FOUND',\n        },\n        HttpStatus.NOT_FOUND,\n      );\n    }\n\n    const resolvedParams = this.templateEngineService.resolve(\n      config.formValue,\n      body.params,\n    );\n\n    try {\n      const result = await this.capabilityService\n        .load(capabilityId)\n        .call(body.action, body.params);\n\n      return {\n        code: 0,\n        message: 'success',\n        data: result,\n        debug: {\n          capabilityConfig: config,\n          resolvedParams,\n          duration: Date.now() - startTime,\n          pluginID: config.pluginID,\n        },\n      };\n    } catch (error) {\n      const duration = Date.now() - startTime;\n\n      if (error instanceof CapabilityNotFoundError) {\n        throw new HttpException(\n          {\n            code: 1,\n            message: error.message,\n            error: 'CAPABILITY_NOT_FOUND',\n            debug: { duration },\n          },\n          HttpStatus.NOT_FOUND,\n        );\n      }\n\n      if (error instanceof PluginNotFoundError) {\n        throw new HttpException(\n          {\n            code: 1,\n            message: error.message,\n            error: 'PLUGIN_NOT_FOUND',\n            debug: { duration, pluginID: config.pluginID },\n          },\n          HttpStatus.INTERNAL_SERVER_ERROR,\n        );\n      }\n\n      if (error instanceof ActionNotFoundError) {\n        throw new HttpException(\n          {\n            code: 1,\n            message: error.message,\n            error: 'ACTION_NOT_FOUND',\n            debug: { duration, pluginID: config.pluginID },\n          },\n          HttpStatus.BAD_REQUEST,\n        );\n      }\n\n      throw new HttpException(\n        {\n          code: 1,\n          message: error instanceof Error ? error.message : String(error),\n          error: 'EXECUTION_ERROR',\n          debug: {\n            duration,\n            pluginID: config.pluginID,\n            resolvedParams,\n          },\n        },\n        HttpStatus.INTERNAL_SERVER_ERROR,\n      );\n    }\n  }\n}\n","import {\n  Controller,\n  Post,\n  Param,\n  Body,\n  HttpException,\n  HttpStatus,\n} from '@nestjs/common';\nimport {\n  CapabilityService,\n  CapabilityNotFoundError,\n  ActionNotFoundError,\n} from '../services/capability.service';\nimport { PluginNotFoundError } from '../services/plugin-loader.service';\n\ninterface ExecuteRequestBody {\n  action: string;\n  params: Record<string, unknown>;\n}\n\ninterface ExecuteResponse {\n  code: number;\n  message: string;\n  data: unknown;\n}\n\n@Controller('api/capability')\nexport class WebhookController {\n  constructor(private readonly capabilityService: CapabilityService) {}\n\n  @Post(':capability_id')\n  async execute(\n    @Param('capability_id') capabilityId: string,\n    @Body() body: ExecuteRequestBody,\n  ): Promise<ExecuteResponse> {\n    try {\n      const result = await this.capabilityService\n        .load(capabilityId)\n        .call(body.action, body.params);\n\n      return {\n        code: 0,\n        message: 'success',\n        data: result,\n      };\n    } catch (error) {\n      if (error instanceof CapabilityNotFoundError) {\n        throw new HttpException(\n          {\n            code: 1,\n            message: error.message,\n            error: 'CAPABILITY_NOT_FOUND',\n          },\n          HttpStatus.NOT_FOUND,\n        );\n      }\n\n      if (error instanceof PluginNotFoundError) {\n        throw new HttpException(\n          {\n            code: 1,\n            message: error.message,\n            error: 'PLUGIN_NOT_FOUND',\n          },\n          HttpStatus.INTERNAL_SERVER_ERROR,\n        );\n      }\n\n      if (error instanceof ActionNotFoundError) {\n        throw new HttpException(\n          {\n            code: 1,\n            message: error.message,\n            error: 'ACTION_NOT_FOUND',\n          },\n          HttpStatus.BAD_REQUEST,\n        );\n      }\n\n      throw new HttpException(\n        {\n          code: 1,\n          message: error instanceof Error ? error.message : String(error),\n          error: 'EXECUTION_ERROR',\n        },\n        HttpStatus.INTERNAL_SERVER_ERROR,\n      );\n    }\n  }\n}\n","import { Module, DynamicModule, Type } from '@nestjs/common';\nimport {\n  RequestContextService,\n  PLATFORM_HTTP_CLIENT,\n} from '@lark-apaas/nestjs-common';\nimport { DebugController, WebhookController } from './controllers';\nimport {\n  CapabilityService,\n  PluginLoaderService,\n  TemplateEngineService,\n  type CapabilityModuleOptions,\n} from './services';\n\nconst CAPABILITY_OPTIONS = Symbol('CAPABILITY_OPTIONS');\n\nconst isDevelopment = process.env.NODE_ENV === 'development';\n\nfunction getControllers(): Type[] {\n  const controllers: Type[] = [WebhookController];\n  if (isDevelopment) {\n    controllers.push(DebugController);\n  }\n  return controllers;\n}\n\n@Module({\n  controllers: getControllers(),\n  providers: [CapabilityService, PluginLoaderService, TemplateEngineService],\n  exports: [CapabilityService],\n})\nexport class CapabilityModule {\n  static forRoot(options?: CapabilityModuleOptions): DynamicModule {\n    return {\n      module: CapabilityModule,\n      controllers: getControllers(),\n      providers: [\n        {\n          provide: CAPABILITY_OPTIONS,\n          useValue: options ?? {},\n        },\n        {\n          provide: CapabilityService,\n          useFactory: (\n            requestContextService: RequestContextService,\n            httpClient: any,\n            pluginLoader: PluginLoaderService,\n            templateEngine: TemplateEngineService,\n            moduleOptions: CapabilityModuleOptions,\n          ) => {\n            const service = new CapabilityService(\n              requestContextService,\n              httpClient,\n              pluginLoader,\n              templateEngine,\n            );\n            if (moduleOptions?.capabilitiesDir) {\n              service.setCapabilitiesDir(moduleOptions.capabilitiesDir);\n            }\n            return service;\n          },\n          inject: [\n            RequestContextService,\n            PLATFORM_HTTP_CLIENT,\n            PluginLoaderService,\n            TemplateEngineService,\n            CAPABILITY_OPTIONS,\n          ],\n        },\n        PluginLoaderService,\n        TemplateEngineService,\n      ],\n      exports: [CapabilityService],\n    };\n  }\n}\n"],"mappings":"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","names":["TemplateEngineService","TEMPLATE_REGEX","resolve","template","input","resolveString","Array","isArray","map","item","resolveObject","match","path","getValueByPath","result","key","value","Object","entries","obj","keys","split","current","undefined","import_common","PluginNotFoundError","Error","pluginID","name","PluginLoadError","reason","PluginLoaderService","logger","Logger","pluginInstances","Map","loadPlugin","cached","get","debug","log","pluginPackage","require","create","instance","set","error","code","message","String","isPluginInstalled","resolve","clearCache","delete","clear","import_common","CapabilityNotFoundError","Error","capabilityId","name","ActionNotFoundError","pluginID","actionName","CapabilityService","logger","Logger","capabilities","Map","capabilitiesDir","requestContextService","httpClient","pluginLoaderService","templateEngineService","join","process","cwd","setCapabilitiesDir","dir","onModuleInit","loadCapabilities","log","existsSync","warn","files","readdirSync","filter","f","endsWith","file","filePath","content","readFileSync","config","JSON","parse","id","set","error","size","listCapabilities","Array","from","values","getCapability","get","load","call","input","contextOverride","execute","startTime","Date","now","pluginInstance","loadPlugin","hasAction","resolvedParams","resolve","formValue","context","buildActionContext","message","action","result","run","duration","String","override","userContext","getUserContext","ctx","getContext","userId","tenantId","import_common","DebugController","capabilityService","templateEngineService","list","capabilities","listCapabilities","code","message","data","map","c","id","name","pluginID","pluginVersion","debug","capabilityId","body","startTime","Date","now","config","getCapability","HttpException","error","HttpStatus","NOT_FOUND","resolvedParams","resolve","formValue","params","result","load","call","action","capabilityConfig","duration","CapabilityNotFoundError","PluginNotFoundError","INTERNAL_SERVER_ERROR","ActionNotFoundError","BAD_REQUEST","Error","String","import_common","WebhookController","capabilityService","execute","capabilityId","body","result","load","call","action","params","code","message","data","error","CapabilityNotFoundError","HttpException","HttpStatus","NOT_FOUND","PluginNotFoundError","INTERNAL_SERVER_ERROR","ActionNotFoundError","BAD_REQUEST","Error","String","import_common","import_nestjs_common","CAPABILITY_OPTIONS","Symbol","isDevelopment","process","env","NODE_ENV","getControllers","controllers","WebhookController","push","DebugController","CapabilityModule","forRoot","options","module","providers","provide","useValue","CapabilityService","useFactory","requestContextService","httpClient","pluginLoader","templateEngine","moduleOptions","service","capabilitiesDir","setCapabilitiesDir","inject","RequestContextService","PLATFORM_HTTP_CLIENT","PluginLoaderService","TemplateEngineService","exports"]}

package/dist/index.d.cts

@@ -0,0 +1,156 @@
+import { Logger, OnModuleInit, DynamicModule } from '@nestjs/common';
+import { PlatformHttpClient, RequestContextService } from '@lark-apaas/nestjs-common';
+import { ZodSchema } from 'zod';
+
+interface UserContext {
+    userId: string;
+    tenantId: string;
+}
+interface PluginActionContext {
+    logger: Logger;
+    httpClient: PlatformHttpClient;
+    userContext: UserContext;
+}
+
+interface ActionSchema {
+    input: ZodSchema | ((config: unknown) => ZodSchema);
+    output?: ZodSchema | ((input: unknown, config: unknown) => ZodSchema);
+}
+interface PluginInstance {
+    run(actionName: string, context: PluginActionContext, input: unknown): Promise<unknown>;
+    hasAction(actionName: string): boolean;
+    getActionSchema(actionName: string): ActionSchema | null;
+    getInputSchema(actionName: string, config?: unknown): ZodSchema | undefined;
+    getOutputSchema(actionName: string, input: unknown, config?: unknown): ZodSchema | undefined;
+    listActions(): string[];
+}
+interface PluginPackage {
+    create(): PluginInstance;
+}
+
+interface JSONSchema {
+    type?: string;
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema;
+    [key: string]: unknown;
+}
+interface CapabilityConfig {
+    id: string;
+    pluginID: string;
+    pluginVersion: string;
+    name: string;
+    description: string;
+    paramsSchema: JSONSchema;
+    formValue: Record<string, unknown>;
+    createdAt: number;
+    updatedAt: number;
+}
+
+declare class TemplateEngineService {
+    private readonly TEMPLATE_REGEX;
+    resolve(template: unknown, input: Record<string, unknown>): unknown;
+    private resolveString;
+    private resolveObject;
+    private getValueByPath;
+}
+
+declare class PluginNotFoundError extends Error {
+    constructor(pluginID: string);
+}
+declare class PluginLoadError extends Error {
+    constructor(pluginID: string, reason: string);
+}
+declare class PluginLoaderService {
+    private readonly logger;
+    private readonly pluginInstances;
+    loadPlugin(pluginID: string): PluginInstance;
+    isPluginInstalled(pluginID: string): boolean;
+    clearCache(pluginID?: string): void;
+}
+
+declare class CapabilityNotFoundError extends Error {
+    constructor(capabilityId: string);
+}
+declare class ActionNotFoundError extends Error {
+    constructor(pluginID: string, actionName: string);
+}
+interface CapabilityExecutor {
+    call(actionName: string, input: unknown, context?: Partial<PluginActionContext>): Promise<unknown>;
+}
+interface CapabilityModuleOptions {
+    capabilitiesDir?: string;
+}
+declare class CapabilityService implements OnModuleInit {
+    private readonly requestContextService;
+    private readonly httpClient;
+    private readonly pluginLoaderService;
+    private readonly templateEngineService;
+    private readonly logger;
+    private readonly capabilities;
+    private capabilitiesDir;
+    constructor(requestContextService: RequestContextService, httpClient: PlatformHttpClient, pluginLoaderService: PluginLoaderService, templateEngineService: TemplateEngineService);
+    setCapabilitiesDir(dir: string): void;
+    onModuleInit(): Promise<void>;
+    private loadCapabilities;
+    listCapabilities(): CapabilityConfig[];
+    getCapability(capabilityId: string): CapabilityConfig | null;
+    load(capabilityId: string): CapabilityExecutor;
+    private execute;
+    private buildActionContext;
+    private getUserContext;
+}
+
+interface ExecuteRequestBody$1 {
+    action: string;
+    params: Record<string, unknown>;
+}
+interface DebugResponse {
+    code: number;
+    message: string;
+    data: unknown;
+    debug?: {
+        capabilityConfig: unknown;
+        resolvedParams: unknown;
+        duration: number;
+        pluginID: string;
+    };
+}
+interface ListResponse {
+    code: number;
+    message: string;
+    data: Array<{
+        id: string;
+        name: string;
+        pluginID: string;
+        pluginVersion: string;
+    }>;
+}
+declare class DebugController {
+    private readonly capabilityService;
+    private readonly templateEngineService;
+    constructor(capabilityService: CapabilityService, templateEngineService: TemplateEngineService);
+    list(): ListResponse;
+    debug(capabilityId: string, body: ExecuteRequestBody$1): Promise<DebugResponse>;
+}
+
+interface ExecuteRequestBody {
+    action: string;
+    params: Record<string, unknown>;
+}
+interface ExecuteResponse {
+    code: number;
+    message: string;
+    data: unknown;
+}
+declare class WebhookController {
+    private readonly capabilityService;
+    constructor(capabilityService: CapabilityService);
+    execute(capabilityId: string, body: ExecuteRequestBody): Promise<ExecuteResponse>;
+}
+
+declare class CapabilityModule {
+    static forRoot(options?: CapabilityModuleOptions): DynamicModule;
+}
+
+export { ActionNotFoundError, type ActionSchema, type CapabilityConfig, type CapabilityExecutor, CapabilityModule, type CapabilityModuleOptions, CapabilityNotFoundError, CapabilityService, DebugController, type JSONSchema, type PluginActionContext, type PluginInstance, PluginLoadError, PluginLoaderService, PluginNotFoundError, type PluginPackage, TemplateEngineService, type UserContext, WebhookController };

package/dist/index.d.ts

@@ -0,0 +1,156 @@
+import { Logger, OnModuleInit, DynamicModule } from '@nestjs/common';
+import { PlatformHttpClient, RequestContextService } from '@lark-apaas/nestjs-common';
+import { ZodSchema } from 'zod';
+
+interface UserContext {
+    userId: string;
+    tenantId: string;
+}
+interface PluginActionContext {
+    logger: Logger;
+    httpClient: PlatformHttpClient;
+    userContext: UserContext;
+}
+
+interface ActionSchema {
+    input: ZodSchema | ((config: unknown) => ZodSchema);
+    output?: ZodSchema | ((input: unknown, config: unknown) => ZodSchema);
+}
+interface PluginInstance {
+    run(actionName: string, context: PluginActionContext, input: unknown): Promise<unknown>;
+    hasAction(actionName: string): boolean;
+    getActionSchema(actionName: string): ActionSchema | null;
+    getInputSchema(actionName: string, config?: unknown): ZodSchema | undefined;
+    getOutputSchema(actionName: string, input: unknown, config?: unknown): ZodSchema | undefined;
+    listActions(): string[];
+}
+interface PluginPackage {
+    create(): PluginInstance;
+}
+
+interface JSONSchema {
+    type?: string;
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema;
+    [key: string]: unknown;
+}
+interface CapabilityConfig {
+    id: string;
+    pluginID: string;
+    pluginVersion: string;
+    name: string;
+    description: string;
+    paramsSchema: JSONSchema;
+    formValue: Record<string, unknown>;
+    createdAt: number;
+    updatedAt: number;
+}
+
+declare class TemplateEngineService {
+    private readonly TEMPLATE_REGEX;
+    resolve(template: unknown, input: Record<string, unknown>): unknown;
+    private resolveString;
+    private resolveObject;
+    private getValueByPath;
+}
+
+declare class PluginNotFoundError extends Error {
+    constructor(pluginID: string);
+}
+declare class PluginLoadError extends Error {
+    constructor(pluginID: string, reason: string);
+}
+declare class PluginLoaderService {
+    private readonly logger;
+    private readonly pluginInstances;
+    loadPlugin(pluginID: string): PluginInstance;
+    isPluginInstalled(pluginID: string): boolean;
+    clearCache(pluginID?: string): void;
+}
+
+declare class CapabilityNotFoundError extends Error {
+    constructor(capabilityId: string);
+}
+declare class ActionNotFoundError extends Error {
+    constructor(pluginID: string, actionName: string);
+}
+interface CapabilityExecutor {
+    call(actionName: string, input: unknown, context?: Partial<PluginActionContext>): Promise<unknown>;
+}
+interface CapabilityModuleOptions {
+    capabilitiesDir?: string;
+}
+declare class CapabilityService implements OnModuleInit {
+    private readonly requestContextService;
+    private readonly httpClient;
+    private readonly pluginLoaderService;
+    private readonly templateEngineService;
+    private readonly logger;
+    private readonly capabilities;
+    private capabilitiesDir;
+    constructor(requestContextService: RequestContextService, httpClient: PlatformHttpClient, pluginLoaderService: PluginLoaderService, templateEngineService: TemplateEngineService);
+    setCapabilitiesDir(dir: string): void;
+    onModuleInit(): Promise<void>;
+    private loadCapabilities;
+    listCapabilities(): CapabilityConfig[];
+    getCapability(capabilityId: string): CapabilityConfig | null;
+    load(capabilityId: string): CapabilityExecutor;
+    private execute;
+    private buildActionContext;
+    private getUserContext;
+}
+
+interface ExecuteRequestBody$1 {
+    action: string;
+    params: Record<string, unknown>;
+}
+interface DebugResponse {
+    code: number;
+    message: string;
+    data: unknown;
+    debug?: {
+        capabilityConfig: unknown;
+        resolvedParams: unknown;
+        duration: number;
+        pluginID: string;
+    };
+}
+interface ListResponse {
+    code: number;
+    message: string;
+    data: Array<{
+        id: string;
+        name: string;
+        pluginID: string;
+        pluginVersion: string;
+    }>;
+}
+declare class DebugController {
+    private readonly capabilityService;
+    private readonly templateEngineService;
+    constructor(capabilityService: CapabilityService, templateEngineService: TemplateEngineService);
+    list(): ListResponse;
+    debug(capabilityId: string, body: ExecuteRequestBody$1): Promise<DebugResponse>;
+}
+
+interface ExecuteRequestBody {
+    action: string;
+    params: Record<string, unknown>;
+}
+interface ExecuteResponse {
+    code: number;
+    message: string;
+    data: unknown;
+}
+declare class WebhookController {
+    private readonly capabilityService;
+    constructor(capabilityService: CapabilityService);
+    execute(capabilityId: string, body: ExecuteRequestBody): Promise<ExecuteResponse>;
+}
+
+declare class CapabilityModule {
+    static forRoot(options?: CapabilityModuleOptions): DynamicModule;
+}
+
+export { ActionNotFoundError, type ActionSchema, type CapabilityConfig, type CapabilityExecutor, CapabilityModule, type CapabilityModuleOptions, CapabilityNotFoundError, CapabilityService, DebugController, type JSONSchema, type PluginActionContext, type PluginInstance, PluginLoadError, PluginLoaderService, PluginNotFoundError, type PluginPackage, TemplateEngineService, type UserContext, WebhookController };