Reorganize repo structure and standards references
This commit is contained in:
1 parent
3cb93a81be
commit
be2054274d
5885 files changed
+2588
-195
No files matched your search
+295
@@ -0,0 +1,295 @@
|
||||
import { describe, expect, test } from "vitest";
|
||||
import { manifestDeclaresCapability, parsePluginManifest, PluginManifestSchema } from "./manifest.js";
|
||||
|
||||
const hex64 = "0".repeat(64);
|
||||
const hex128 = "0".repeat(128);
|
||||
const settingsHtmlSha256 = "56a78618698dbd72399e9d07b4f12a9e7910cd4a1b7de41a2f90bd4a33ea338e";
|
||||
const settingsHtmlIntegrity = "sha256-VqeGGGmNvXI5np0HtPEqnnkQzUobfeQaL5C9SjPqM44=";
|
||||
|
||||
const validManifest = {
|
||||
schemaVersion: 1,
|
||||
id: "de.toolctrl.hello",
|
||||
version: "1.0.0",
|
||||
name: "Hello",
|
||||
entry: "plugin.wasm",
|
||||
wasmSha256: hex64,
|
||||
signature: hex128,
|
||||
signedBy: hex64,
|
||||
allowedHosts: ["api.example.com"],
|
||||
capabilities: [{ name: "log" as const }, { name: "http.outbound" as const, scope: { allowedHosts: ["api.example.com"] } }],
|
||||
hooks: [{ name: "onHello", export: "handleHello" }],
|
||||
};
|
||||
|
||||
describe("PluginManifestSchema", () => {
|
||||
test("accepts a well-formed manifest", () => {
|
||||
const parsed = PluginManifestSchema.safeParse(validManifest);
|
||||
expect(parsed.success).toBe(true);
|
||||
});
|
||||
|
||||
test("rejects reverse-DNS-shaped ids that have only one label", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({ ...validManifest, id: "hello" });
|
||||
expect(parsed.success).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects non-semver versions", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({ ...validManifest, version: "v1" });
|
||||
expect(parsed.success).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects unknown capability names (closed enum)", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
capabilities: [{ name: "filesystem.write" }],
|
||||
});
|
||||
expect(parsed.success).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects schemaVersion other than 1", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({ ...validManifest, schemaVersion: 2 });
|
||||
expect(parsed.success).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects signatures that are not 128 hex chars", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({ ...validManifest, signature: "abc" });
|
||||
expect(parsed.success).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects manifests with no hooks", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({ ...validManifest, hooks: [] });
|
||||
expect(parsed.success).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects unknown top-level fields (strict mode)", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({ ...validManifest, surpriseField: true });
|
||||
expect(parsed.success).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects hosts with a scheme prefix", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
allowedHosts: ["https://api.example.com"],
|
||||
});
|
||||
expect(parsed.success).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects localhost, IP, and private-ish outbound hosts", () => {
|
||||
for (const host of ["localhost", "api.localhost", "127.0.0.1", "service.local", "db.internal"]) {
|
||||
const parsed = PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
allowedHosts: [host],
|
||||
});
|
||||
expect(parsed.success, host).toBe(false);
|
||||
}
|
||||
});
|
||||
|
||||
test("rejects private-ish hosts inside capability scopes", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
capabilities: [{ name: "http.outbound", scope: { allowedHosts: ["127.0.0.1"] } }],
|
||||
});
|
||||
expect(parsed.success).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects duplicate and oversized top-level allowed host lists", () => {
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
allowedHosts: ["api.example.com", "api.example.com"],
|
||||
}).success
|
||||
).toBe(false);
|
||||
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
allowedHosts: Array.from({ length: 65 }, (_, index) => `api-${index}.example.com`),
|
||||
}).success
|
||||
).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects duplicate and oversized scoped allowed host lists", () => {
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
capabilities: [{ name: "http.outbound", scope: { allowedHosts: ["api.example.com", "api.example.com"] } }],
|
||||
}).success
|
||||
).toBe(false);
|
||||
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
capabilities: [{ name: "http.outbound", scope: { allowedHosts: Array.from({ length: 33 }, (_, index) => `api-${index}.example.com`) } }],
|
||||
}).success
|
||||
).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects duplicate and oversized capability declarations", () => {
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
capabilities: [{ name: "log" }, { name: "log" }],
|
||||
}).success
|
||||
).toBe(false);
|
||||
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
capabilities: Array.from({ length: 33 }, () => ({ name: "log" as const })),
|
||||
}).success
|
||||
).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects duplicate and oversized hook declarations", () => {
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
hooks: [
|
||||
{ name: "entity.created", export: "handleCreated" },
|
||||
{ name: "entity.created", export: "handleCreatedAgain" },
|
||||
],
|
||||
}).success
|
||||
).toBe(false);
|
||||
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
hooks: [
|
||||
{ name: "entity.created", export: "handleCreated" },
|
||||
{ name: "entity.updated", export: "handleCreated" },
|
||||
],
|
||||
}).success
|
||||
).toBe(false);
|
||||
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
hooks: Array.from({ length: 65 }, (_, index) => ({ name: `hook.${index}`, export: `handle${index}` })),
|
||||
}).success
|
||||
).toBe(false);
|
||||
});
|
||||
|
||||
// F-017 — host-version constraint fields are now schema-enforced.
|
||||
test("accepts optional minHostVersion / maxHostVersion when omitted", () => {
|
||||
const parsed = PluginManifestSchema.safeParse(validManifest);
|
||||
expect(parsed.success).toBe(true);
|
||||
if (parsed.success) {
|
||||
expect(parsed.data.minHostVersion).toBeUndefined();
|
||||
expect(parsed.data.maxHostVersion).toBeUndefined();
|
||||
}
|
||||
});
|
||||
|
||||
test("accepts well-formed minHostVersion / maxHostVersion SemVer values", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
minHostVersion: "1.0.0",
|
||||
maxHostVersion: "2.0.0-rc.1",
|
||||
});
|
||||
expect(parsed.success).toBe(true);
|
||||
if (parsed.success) {
|
||||
expect(parsed.data.minHostVersion).toBe("1.0.0");
|
||||
expect(parsed.data.maxHostVersion).toBe("2.0.0-rc.1");
|
||||
}
|
||||
});
|
||||
|
||||
test("rejects minHostVersion that is not loose-SemVer", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
minHostVersion: "v1",
|
||||
});
|
||||
expect(parsed.success).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects maxHostVersion that is not loose-SemVer", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
maxHostVersion: "latest",
|
||||
});
|
||||
expect(parsed.success).toBe(false);
|
||||
});
|
||||
|
||||
test("accepts an optional settings UI bundle entry", () => {
|
||||
const parsed = PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
ui: { settings: { entry: "settings/index.html", sha256: settingsHtmlSha256 } },
|
||||
});
|
||||
expect(parsed.success).toBe(true);
|
||||
if (parsed.success) {
|
||||
expect(parsed.data.ui?.settings?.entry).toBe("settings/index.html");
|
||||
expect(parsed.data.ui?.settings?.sha256).toBe(settingsHtmlSha256);
|
||||
}
|
||||
});
|
||||
|
||||
test("accepts settings UI SRI integrity and rejects missing or mismatched integrity metadata", () => {
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
ui: { settings: { entry: "settings/index.html", integrity: settingsHtmlIntegrity } },
|
||||
}).success
|
||||
).toBe(true);
|
||||
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
ui: { settings: { entry: "settings/index.html" } },
|
||||
}).success
|
||||
).toBe(false);
|
||||
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
ui: { settings: { entry: "settings/index.html", sha256: settingsHtmlSha256, integrity: `sha256-${"A".repeat(43)}=` } },
|
||||
}).success
|
||||
).toBe(false);
|
||||
});
|
||||
|
||||
test("rejects unsafe settings UI entries and unknown ui fields", () => {
|
||||
for (const entry of ["/settings.html", "../settings.html", "settings/../index.html", "https://example.com/settings.html", "settings\\index.html", "settings/index.js"]) {
|
||||
const parsed = PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
ui: { settings: { entry } },
|
||||
});
|
||||
expect(parsed.success, entry).toBe(false);
|
||||
}
|
||||
|
||||
expect(
|
||||
PluginManifestSchema.safeParse({
|
||||
...validManifest,
|
||||
ui: { settings: { entry: "settings.html", sha256: settingsHtmlSha256 }, surprise: true },
|
||||
}).success
|
||||
).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe("parsePluginManifest", () => {
|
||||
test("returns ok=true with the typed manifest on success", () => {
|
||||
const result = parsePluginManifest(validManifest);
|
||||
expect(result.ok).toBe(true);
|
||||
if (result.ok) {
|
||||
expect(result.manifest.id).toBe("de.toolctrl.hello");
|
||||
expect(result.manifest.capabilities).toHaveLength(2);
|
||||
}
|
||||
});
|
||||
|
||||
test("aggregates Zod issues without throwing", () => {
|
||||
const result = parsePluginManifest({ schemaVersion: 1 });
|
||||
expect(result.ok).toBe(false);
|
||||
if (!result.ok) {
|
||||
expect(result.issues.length).toBeGreaterThan(0);
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
describe("manifestDeclaresCapability", () => {
|
||||
test("returns true when the capability is in the list", () => {
|
||||
const result = parsePluginManifest(validManifest);
|
||||
if (!result.ok) throw new Error("fixture invalid");
|
||||
expect(manifestDeclaresCapability(result.manifest, "http.outbound")).toBe(true);
|
||||
expect(manifestDeclaresCapability(result.manifest, "log")).toBe(true);
|
||||
});
|
||||
|
||||
test("returns false when the capability is not declared", () => {
|
||||
const result = parsePluginManifest(validManifest);
|
||||
if (!result.ok) throw new Error("fixture invalid");
|
||||
expect(manifestDeclaresCapability(result.manifest, "db.write")).toBe(false);
|
||||
expect(manifestDeclaresCapability(result.manifest, "secret.read")).toBe(false);
|
||||
});
|
||||
});
|
||||
Reference in new issue
Block a user