@ensera/plugin-backend 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Request, Response, NextFunction } from 'express';
+import { Request, Response, NextFunction, Express } from 'express';
 
 /**
  * Plugin scope extracted from JWT token
@@ -373,4 +373,22 @@ declare function toDateString(date: string | Date | null | undefined): string |
  */
 declare function buildDateTime(dateValue: string | Date | null | undefined, timeValue: string | null | undefined, defaultHour?: number, defaultMinute?: number): Date | null;
 
-export { type BackendNotification, type JsonObject, type JsonValue, type NotificationAction, type NotificationApiPayload, type NotificationBulkApiPayload, type NotificationBulkResponse, type NotificationCancelResponse, type NotificationCapabilities, type NotificationOptions, type NotificationPublishResponse, type NotificationPublisher, type NotificationPublisherConfig, type NotificationTypeConfig, type PluginAuthOptions, type PluginContext, PluginError, type PluginErrorResponse, type PluginScope, type RequestWithContext, type ScheduleOptions, assertPluginScope, buildDateTime, calculateScheduleTime, createNotificationPublisher, forbidClientInstanceId, formatTime, getPluginScope, isPastDate, pluginAuth, pluginErrorHandler, requireFeature, requirePermission, requireTabView, requireTaskScope, resolveEffectiveInstanceId, toDateString, withInstanceOnly, withInstanceScope, withUserAndInstance };
+declare function withCoreServiceToken(handler: (req: Request, res: Response, next: NextFunction) => unknown): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+
+type CoreRequestContext = {
+    workspaceId: string;
+    spaceId: string;
+    userId: string;
+    taskScopeId?: string;
+    requestId: string;
+};
+type CommandHandler = (input: Record<string, unknown>, context: CoreRequestContext) => Promise<unknown>;
+type CommandRegistry = {
+    register: (name: string, handler: CommandHandler) => void;
+    get: (name: string) => CommandHandler | undefined;
+    list: () => string[];
+};
+declare function createCommandRegistry(): CommandRegistry;
+declare function createCoreRouter(app: Express, registry: CommandRegistry): void;
+
+export { type BackendNotification, type CommandHandler, type CommandRegistry, type CoreRequestContext, type JsonObject, type JsonValue, type NotificationAction, type NotificationApiPayload, type NotificationBulkApiPayload, type NotificationBulkResponse, type NotificationCancelResponse, type NotificationCapabilities, type NotificationOptions, type NotificationPublishResponse, type NotificationPublisher, type NotificationPublisherConfig, type NotificationTypeConfig, type PluginAuthOptions, type PluginContext, PluginError, type PluginErrorResponse, type PluginScope, type RequestWithContext, type ScheduleOptions, assertPluginScope, buildDateTime, calculateScheduleTime, createCommandRegistry, createCoreRouter, createNotificationPublisher, forbidClientInstanceId, formatTime, getPluginScope, isPastDate, pluginAuth, pluginErrorHandler, requireFeature, requirePermission, requireTabView, requireTaskScope, resolveEffectiveInstanceId, toDateString, withCoreServiceToken, withInstanceOnly, withInstanceScope, withUserAndInstance };

package/dist/index.js

@@ -657,11 +657,107 @@ function buildDateTime(dateValue, timeValue, defaultHour = 9, defaultMinute = 0)
   if (isNaN(result.getTime())) return null;
   return result;
 }
+
+// src/withCoreServiceToken.ts
+function withCoreServiceToken(handler) {
+  return async function coreServiceTokenWrapped(req, res, next) {
+    try {
+      const authHeader = req.headers.authorization;
+      const token = authHeader?.startsWith("Bearer ") ? authHeader.slice(7) : null;
+      const expected = process.env.CORE_SERVICE_TOKEN?.trim();
+      if (!expected) {
+        throw new PluginError({
+          status: 500,
+          code: "CORE_SERVICE_TOKEN_NOT_CONFIGURED",
+          message: "CORE_SERVICE_TOKEN is not set in environment"
+        });
+      }
+      if (!token || token !== expected) {
+        throw new PluginError({
+          status: 401,
+          code: "INVALID_CORE_SERVICE_TOKEN",
+          message: "Unauthorized: invalid or missing Core service token"
+        });
+      }
+      await handler(req, res, next);
+    } catch (e) {
+      next(e);
+    }
+  };
+}
+
+// src/createCommandRegistry.ts
+function createCommandRegistry() {
+  const registry = /* @__PURE__ */ new Map();
+  return {
+    register(name, handler) {
+      if (!name || typeof handler !== "function") {
+        throw new Error(
+          "createCommandRegistry: name and handler are required"
+        );
+      }
+      registry.set(name, handler);
+    },
+    get(name) {
+      return registry.get(name);
+    },
+    list() {
+      return Array.from(registry.keys());
+    }
+  };
+}
+function createCoreRouter(app, registry) {
+  app.post(
+    "/api/core/execute",
+    withCoreServiceToken(async (req, res) => {
+      const { command, input, context } = req.body ?? {};
+      if (!command || typeof command !== "string") {
+        return res.status(400).json({
+          success: false,
+          error: "MISSING_COMMAND",
+          message: "Request body must include a command string"
+        });
+      }
+      if (!context?.workspaceId || !context?.userId) {
+        return res.status(400).json({
+          success: false,
+          error: "MISSING_CONTEXT",
+          message: "Request context must include workspaceId and userId"
+        });
+      }
+      const handler = registry.get(command);
+      if (!handler) {
+        return res.status(404).json({
+          success: false,
+          error: "UNKNOWN_COMMAND",
+          message: `Command '${command}' is not registered`,
+          available: registry.list()
+        });
+      }
+      try {
+        const result = await handler(
+          input ?? {},
+          context
+        );
+        return res.json({ success: true, data: result });
+      } catch (err) {
+        console.error(`[CoreRouter] Command '${command}' failed:`, err);
+        return res.status(500).json({
+          success: false,
+          error: "COMMAND_FAILED",
+          message: err?.message ?? "Internal error"
+        });
+      }
+    })
+  );
+}
 export {
   PluginError,
   assertPluginScope,
   buildDateTime,
   calculateScheduleTime,
+  createCommandRegistry,
+  createCoreRouter,
   createNotificationPublisher,
   forbidClientInstanceId,
   formatTime,
@@ -675,6 +771,7 @@ export {
   requireTaskScope,
   resolveEffectiveInstanceId,
   toDateString,
+  withCoreServiceToken,
   withInstanceOnly,
   withInstanceScope,
   withUserAndInstance

package/package.json

@@ -1,54 +1,54 @@
-{
-  "name": "@ensera/plugin-backend",
-  "version": "1.0.0",
-  "description": "Runtime backend SDK for Ensera plugins.",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "sideEffects": false,
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean --target es2022 --outDir dist",
-    "dev": "tsup src/index.ts --format esm --dts --watch --target es2022 --outDir dist",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "prepublishOnly": "npm run build && npm run typecheck"
-  },
-  "keywords": [
-    "ensera",
-    "backend",
-    "sdk",
-    "plugin",
-    "express"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "jsonwebtoken": "^9.0.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.0",
-    "@types/jsonwebtoken": "^9.0.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.0.0",
-    "jsonwebtoken": "^9.0.0"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "peerDependencies": {
-    "express": "^4.18.0",
-    "jsonwebtoken": "^9.0.0"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./package.json": "./package.json"
-  }
-}
+{
+  "name": "@ensera/plugin-backend",
+  "version": "1.1.0",
+  "description": "Runtime backend SDK for Ensera plugins.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean --target es2022 --outDir dist",
+    "dev": "tsup src/index.ts --format esm --dts --watch --target es2022 --outDir dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build && npm run typecheck"
+  },
+  "keywords": [
+    "ensera",
+    "backend",
+    "sdk",
+    "plugin",
+    "express"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "jsonwebtoken": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.0",
+    "@types/jsonwebtoken": "^9.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "jsonwebtoken": "^9.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0",
+    "jsonwebtoken": "^9.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  }
+}