@vivoa/plugin-sdk 0.6.5 → 0.6.7

package/dist/testing/index.js

@@ -0,0 +1,169 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/testing/index.ts
+var testing_exports = {};
+__export(testing_exports, {
+  createDispatchContext: () => createDispatchContext,
+  createMockHostApi: () => createMockHostApi
+});
+module.exports = __toCommonJS(testing_exports);
+
+// src/permissions.ts
+var PERMISSION_RE = /^([a-z0-9]+)\.([a-z0-9]+)(?::(.+))?$/i;
+function parsePermission(raw) {
+  const m = PERMISSION_RE.exec(raw);
+  if (!m) return null;
+  const [, domain, action, resource] = m;
+  return resource === void 0 ? { domain, action } : { domain, action, resource };
+}
+function isPermissionGranted(required, granted) {
+  return granted.some((g) => {
+    if (g.domain !== required.domain || g.action !== required.action) {
+      return false;
+    }
+    if (required.resource === void 0) return true;
+    return g.resource === "*" || g.resource === required.resource;
+  });
+}
+function checkPermissions(required, grantedRaw) {
+  const grantedParsed = grantedRaw.map(parsePermission).filter((p) => p !== null);
+  const granted = [];
+  const missing = [];
+  for (const raw of required) {
+    const parsed = parsePermission(raw);
+    if (parsed && isPermissionGranted(parsed, grantedParsed)) {
+      granted.push(raw);
+    } else {
+      missing.push(raw);
+    }
+  }
+  return { ok: missing.length === 0, granted, missing };
+}
+
+// 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 };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createDispatchContext,
+  createMockHostApi
+});

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.5",
+  "version": "0.6.7",
   "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,
@@ -34,6 +39,14 @@
     "registry": "https://registry.npmjs.org",
     "access": "public"
   },
+  "scripts": {
+    "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",
+    "prepublishOnly": "pnpm run typecheck && pnpm run test && pnpm run build"
+  },
   "dependencies": {
     "superstruct": "^2.0.2"
   },
@@ -42,12 +55,5 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.3",
     "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",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit -p tsconfig.json"
   }
-}
+}