@vivoa/plugin-sdk 0.6.3 → 0.6.6

package/dist/testing/index.mjs

@@ -0,0 +1,113 @@
+import {
+  checkPermissions
+} from "../chunk-DGJZW46B.mjs";
+
+// src/testing/mock-host.ts
+var DEFAULT_RESPONSE = { status: 200, headers: {}, body: {} };
+function createMockHostApi(opts = {}) {
+  const calls = {
+    "http.request": [],
+    "secrets.get": [],
+    "storage.getUrl": [],
+    "storage.put": [],
+    "sequence.next": [],
+    "host.on": []
+  };
+  const registered = [];
+  const handlers = /* @__PURE__ */ new Map();
+  const seqState = new Map(
+    Object.entries(opts.sequences ?? {})
+  );
+  const enforce = (required) => {
+    if (!opts.grantedPermissions) return;
+    const check = checkPermissions([required], opts.grantedPermissions);
+    if (!check.ok) {
+      throw new Error(
+        `MockHostApi: permission denied \u2014 plugin needs "${required}" but it is not in grantedPermissions. Declare it in your manifest.`
+      );
+    }
+  };
+  const noop = () => {
+  };
+  const logger = {
+    debug: noop,
+    info: noop,
+    warn: noop,
+    error: noop
+  };
+  const http = {
+    // async so a denied-permission throw surfaces as a rejected promise, not a
+    // synchronous throw — matches the real host's async port contract.
+    request: async (req) => {
+      const hostname = safeHostname(req.url);
+      enforce(`http.outbound:${hostname}`);
+      calls["http.request"].push(req);
+      return opts.httpResponses?.[req.url] ?? Object.entries(opts.httpResponses ?? {}).find(
+        ([k]) => req.url.includes(k)
+      )?.[1] ?? DEFAULT_RESPONSE;
+    }
+  };
+  const secrets = {
+    get: async (key) => {
+      enforce(`secrets.read:${key}`);
+      calls["secrets.get"].push(key);
+      return opts.secrets?.[key];
+    }
+  };
+  const storage = {
+    getUrl: (key) => {
+      calls["storage.getUrl"].push(key);
+      return Promise.resolve(`mock://storage/${key}`);
+    },
+    put: (key, body) => {
+      calls["storage.put"].push({ key, body });
+      return Promise.resolve();
+    }
+  };
+  const sequence = {
+    next: (scope) => {
+      calls["sequence.next"].push(scope);
+      const current = seqState.get(scope) ?? 0;
+      const next = current + 1;
+      seqState.set(scope, next);
+      return Promise.resolve(next);
+    }
+  };
+  const host = {
+    logger,
+    http,
+    secrets,
+    storage,
+    sequence,
+    calls,
+    registered,
+    handlers,
+    on: (event, handler) => {
+      calls["host.on"].push(event);
+      const list = handlers.get(event) ?? [];
+      list.push(handler);
+      handlers.set(event, list);
+    },
+    registerCapability: (cap) => {
+      registered.push(cap);
+    },
+    emit: async (event, payload) => {
+      for (const h of handlers.get(event) ?? []) await h(payload);
+    }
+  };
+  return host;
+}
+function safeHostname(url) {
+  try {
+    return new URL(url).hostname;
+  } catch {
+    return url;
+  }
+}
+function createDispatchContext(config = {}, overrides = {}) {
+  return { config, ...overrides };
+}
+export {
+  createDispatchContext,
+  createMockHostApi
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vivoa/plugin-sdk",
-  "version": "0.6.3",
+  "version": "0.6.6",
   "description": "Public contracts for Vivoa plugins (types, DI tokens, config + setup-layout validators)",
   "license": "MIT",
   "author": "Vivoa",
@@ -24,6 +24,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.mjs",
+      "require": "./dist/testing/index.js"
     }
   },
   "sideEffects": false,
@@ -44,8 +49,8 @@
     "vitest": "^2.1.8"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean --target node18",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch --target node18",
+    "build": "tsup src/index.ts src/testing/index.ts --format cjs,esm --dts --clean --target node18",
+    "dev": "tsup src/index.ts src/testing/index.ts --format cjs,esm --dts --watch --target node18",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit -p tsconfig.json"