2026-04-06 09:00:47 +00:00
|
|
|
// Phase C Step 9 — manifest + loader tests.
|
|
|
|
|
//
|
|
|
|
|
// These tests cover the default-build code path (no wazero). They confirm:
|
|
|
|
|
// - the JSON manifest parses and validates,
|
|
|
|
|
// - the loader walks a directory and surfaces well-formed plugins,
|
|
|
|
|
// - the registry persists discovered plugins into a PluginStore,
|
|
|
|
|
// - per-capability gating refuses calls when the manifest didn't grant them.
|
|
|
|
|
//
|
|
|
|
|
// Wazero-specific tests live in sandbox_wazero_test.go and only run with the
|
|
|
|
|
// `wazero` build tag.
|
|
|
|
|
package plugin
|
|
|
|
|
|
|
|
|
|
import (
|
|
|
|
|
"context"
|
|
|
|
|
"os"
|
|
|
|
|
"path/filepath"
|
|
|
|
|
"testing"
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
func TestParseManifestRoundTrip(t *testing.T) {
|
|
|
|
|
raw := []byte(`{
|
|
|
|
|
"name": "hello",
|
|
|
|
|
"version": "0.1.0",
|
|
|
|
|
"entrypoint": "hello.wasm",
|
|
|
|
|
"permissions": ["commands", "storage"],
|
|
|
|
|
"resources": {"max_memory_mb": 16, "cpu_budget_ms": 50}
|
|
|
|
|
}`)
|
|
|
|
|
m, err := ParseManifest(raw)
|
|
|
|
|
if err != nil {
|
|
|
|
|
t.Fatalf("ParseManifest: %v", err)
|
|
|
|
|
}
|
|
|
|
|
if m.Name != "hello" || m.Version != "0.1.0" {
|
|
|
|
|
t.Fatalf("unexpected manifest fields: %+v", m)
|
|
|
|
|
}
|
|
|
|
|
if !m.HasCapability(CapCommands) {
|
|
|
|
|
t.Fatal("expected commands capability")
|
|
|
|
|
}
|
|
|
|
|
if m.HasCapability(CapHTTP) {
|
|
|
|
|
t.Fatal("did not expect http capability")
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
func TestParseManifestRejectsBadEntrypoint(t *testing.T) {
|
|
|
|
|
cases := map[string]string{
|
|
|
|
|
"missing entrypoint": `{"name":"x","version":"1","entrypoint":""}`,
|
|
|
|
|
"non-wasm entrypoint": `{"name":"x","version":"1","entrypoint":"x.so"}`,
|
|
|
|
|
"unknown capability": `{"name":"x","version":"1","entrypoint":"x.wasm","permissions":["badperm"]}`,
|
|
|
|
|
"missing version": `{"name":"x","entrypoint":"x.wasm"}`,
|
|
|
|
|
"missing name": `{"version":"1","entrypoint":"x.wasm"}`,
|
|
|
|
|
}
|
|
|
|
|
for label, body := range cases {
|
|
|
|
|
t.Run(label, func(t *testing.T) {
|
|
|
|
|
if _, err := ParseManifest([]byte(body)); err == nil {
|
|
|
|
|
t.Fatalf("expected error for %s", label)
|
|
|
|
|
}
|
|
|
|
|
})
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
func TestScanPluginDirectoryHandlesMissing(t *testing.T) {
|
|
|
|
|
got, err := scanPluginDirectory(filepath.Join(t.TempDir(), "does-not-exist"))
|
|
|
|
|
if err != nil {
|
|
|
|
|
t.Fatalf("scanPluginDirectory: %v", err)
|
|
|
|
|
}
|
|
|
|
|
if len(got) != 0 {
|
|
|
|
|
t.Fatalf("expected empty result, got %d", len(got))
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
func TestScanPluginDirectoryParsesValidPlugin(t *testing.T) {
|
|
|
|
|
dir := t.TempDir()
|
|
|
|
|
pluginDir := filepath.Join(dir, "hello")
|
|
|
|
|
if err := os.MkdirAll(pluginDir, 0o755); err != nil {
|
|
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
|
|
|
|
manifest := `{"name":"hello","version":"0.1.0","entrypoint":"hello.wasm","permissions":["storage"]}`
|
|
|
|
|
if err := os.WriteFile(filepath.Join(pluginDir, "plugin.json"), []byte(manifest), 0o644); err != nil {
|
|
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
|
|
|
|
if err := os.WriteFile(filepath.Join(pluginDir, "hello.wasm"), []byte("\x00asm\x01\x00\x00\x00"), 0o644); err != nil {
|
|
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
|
|
|
|
got, err := scanPluginDirectory(dir)
|
|
|
|
|
if err != nil {
|
|
|
|
|
t.Fatalf("scanPluginDirectory: %v", err)
|
|
|
|
|
}
|
|
|
|
|
if len(got) != 1 || got[0].Manifest.Name != "hello" {
|
|
|
|
|
t.Fatalf("unexpected scan result: %+v", got)
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
func TestRegistryInstallFromDisk(t *testing.T) {
|
|
|
|
|
dir := t.TempDir()
|
|
|
|
|
pluginDir := filepath.Join(dir, "hello")
|
|
|
|
|
_ = os.MkdirAll(pluginDir, 0o755)
|
|
|
|
|
_ = os.WriteFile(filepath.Join(pluginDir, "plugin.json"),
|
|
|
|
|
[]byte(`{"name":"hello","version":"0.1.0","entrypoint":"hello.wasm","permissions":["storage"]}`),
|
|
|
|
|
0o644)
|
|
|
|
|
_ = os.WriteFile(filepath.Join(pluginDir, "hello.wasm"), []byte("\x00asm\x01\x00\x00\x00"), 0o644)
|
|
|
|
|
|
2026-07-19 16:33:58 +00:00
|
|
|
mem := openPluginTestDB(t)
|
2026-04-06 09:00:47 +00:00
|
|
|
reg, err := NewRegistry(Config{Directory: dir, Store: mem})
|
|
|
|
|
if err != nil {
|
|
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
|
|
|
|
if err := reg.LoadAll(context.Background()); err != nil {
|
|
|
|
|
t.Fatalf("LoadAll: %v", err)
|
|
|
|
|
}
|
|
|
|
|
rows, err := mem.ListPlugins(context.Background())
|
|
|
|
|
if err != nil {
|
|
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
|
|
|
|
if len(rows) != 1 || rows[0].Name != "hello" {
|
|
|
|
|
t.Fatalf("expected hello plugin row, got %+v", rows)
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
func TestStorageGatedByCapability(t *testing.T) {
|
2026-07-19 16:33:58 +00:00
|
|
|
mem := openPluginTestDB(t)
|
2026-04-06 09:00:47 +00:00
|
|
|
reg, err := NewRegistry(Config{Store: mem})
|
|
|
|
|
if err != nil {
|
|
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
|
|
|
|
inst := &Instance{
|
|
|
|
|
ID: 1,
|
|
|
|
|
Manifest: &Manifest{Name: "x", Permissions: []string{}},
|
|
|
|
|
}
|
|
|
|
|
if err := reg.StoragePut(context.Background(), inst, "k", []byte("v")); err == nil {
|
|
|
|
|
t.Fatal("expected ErrCapabilityNotGranted")
|
|
|
|
|
}
|
|
|
|
|
inst.Manifest.Permissions = []string{string(CapStorage)}
|
|
|
|
|
// Pre-create the plugin row so the KV foreign-key-equivalent succeeds.
|
|
|
|
|
if _, err := mem.InstallPlugin(context.Background(), "x", "0.1", "{}"); err != nil {
|
|
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
|
|
|
|
if err := reg.StoragePut(context.Background(), inst, "k", []byte("v")); err != nil {
|
|
|
|
|
t.Fatalf("StoragePut: %v", err)
|
|
|
|
|
}
|
|
|
|
|
got, err := reg.StorageGet(context.Background(), inst, "k")
|
|
|
|
|
if err != nil {
|
|
|
|
|
t.Fatalf("StorageGet: %v", err)
|
|
|
|
|
}
|
|
|
|
|
if string(got) != "v" {
|
|
|
|
|
t.Fatalf("expected v, got %q", got)
|
|
|
|
|
}
|
|
|
|
|
}
|
2026-07-19 08:52:31 +02:00
|
|
|
|
|
|
|
|
// TestReinstallRebindsCommands locks the W2-3 fix: an in-place upgrade
|
|
|
|
|
// replaces the *Instance, so stale command bindings must be cleared on
|
|
|
|
|
// reinstall and ownership compared by plugin identity — the same plugin can
|
|
|
|
|
// re-bind its own commands while a different plugin still cannot hijack them.
|
|
|
|
|
func TestReinstallRebindsCommands(t *testing.T) {
|
2026-07-19 16:33:58 +00:00
|
|
|
mem := openPluginTestDB(t)
|
2026-07-19 08:52:31 +02:00
|
|
|
reg, err := NewRegistry(Config{Directory: t.TempDir(), Store: mem})
|
|
|
|
|
if err != nil {
|
|
|
|
|
t.Fatalf("NewRegistry: %v", err)
|
|
|
|
|
}
|
|
|
|
|
t.Cleanup(func() { _ = reg.Close(context.Background()) })
|
|
|
|
|
|
|
|
|
|
ctx := context.Background()
|
2026-07-20 14:10:02 +02:00
|
|
|
manifest, err := ParseManifest([]byte(`{"name":"upgrader","version":"0.1.0","entrypoint":"p.wasm","permissions":["commands"],"commands":[{"name":"greet"}]}`))
|
2026-07-19 08:52:31 +02:00
|
|
|
if err != nil {
|
|
|
|
|
t.Fatalf("ParseManifest: %v", err)
|
|
|
|
|
}
|
|
|
|
|
if err := reg.installFromDisk(ctx, foundPlugin{Manifest: manifest, WASMPath: "p.wasm"}); err != nil {
|
|
|
|
|
t.Fatalf("install v1: %v", err)
|
|
|
|
|
}
|
|
|
|
|
reg.mu.RLock()
|
|
|
|
|
v1 := reg.byName["upgrader"]
|
|
|
|
|
reg.mu.RUnlock()
|
|
|
|
|
if err := reg.RegisterCommand("greet", v1); err != nil {
|
|
|
|
|
t.Fatalf("RegisterCommand v1: %v", err)
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// In-place upgrade: same plugin name, fresh instance.
|
2026-07-20 14:10:02 +02:00
|
|
|
manifest2, err := ParseManifest([]byte(`{"name":"upgrader","version":"0.2.0","entrypoint":"p.wasm","permissions":["commands"],"commands":[{"name":"greet"}]}`))
|
2026-07-19 08:52:31 +02:00
|
|
|
if err != nil {
|
|
|
|
|
t.Fatalf("ParseManifest v2: %v", err)
|
|
|
|
|
}
|
|
|
|
|
if err := reg.installFromDisk(ctx, foundPlugin{Manifest: manifest2, WASMPath: "p.wasm"}); err != nil {
|
|
|
|
|
t.Fatalf("install v2: %v", err)
|
|
|
|
|
}
|
|
|
|
|
reg.mu.RLock()
|
|
|
|
|
v2 := reg.byName["upgrader"]
|
|
|
|
|
_, stillBound := reg.commands["greet"]
|
|
|
|
|
reg.mu.RUnlock()
|
|
|
|
|
if v2 == v1 {
|
|
|
|
|
t.Fatal("reinstall should produce a fresh instance")
|
|
|
|
|
}
|
|
|
|
|
if stillBound {
|
|
|
|
|
t.Fatal("stale command binding survived reinstall")
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// The upgraded plugin re-binds its own command.
|
|
|
|
|
if err := reg.RegisterCommand("greet", v2); err != nil {
|
|
|
|
|
t.Fatalf("RegisterCommand after upgrade: %v", err)
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// A different plugin still cannot hijack an owned command.
|
2026-07-20 14:10:02 +02:00
|
|
|
other, err := ParseManifest([]byte(`{"name":"other","version":"0.1.0","entrypoint":"o.wasm","permissions":["commands"],"commands":[{"name":"greet"}]}`))
|
2026-07-19 08:52:31 +02:00
|
|
|
if err != nil {
|
|
|
|
|
t.Fatalf("ParseManifest other: %v", err)
|
|
|
|
|
}
|
|
|
|
|
if err := reg.installFromDisk(ctx, foundPlugin{Manifest: other, WASMPath: "o.wasm"}); err != nil {
|
|
|
|
|
t.Fatalf("install other: %v", err)
|
|
|
|
|
}
|
|
|
|
|
reg.mu.RLock()
|
|
|
|
|
otherInst := reg.byName["other"]
|
|
|
|
|
reg.mu.RUnlock()
|
|
|
|
|
if err := reg.RegisterCommand("greet", otherInst); err == nil {
|
|
|
|
|
t.Fatal("cross-plugin hijack must still be refused")
|
|
|
|
|
}
|
|
|
|
|
}
|