feat: define dashboard model schema

src/lib/model/schema.test.ts

@@ -0,0 +1,63 @@
+import { describe, expect, it } from "vitest";
+import {
+  DASHBOARD_SCHEMA_VERSION,
+  dashboardDocumentJsonSchema,
+  validateDashboardDocument,
+} from ".";
+import {
+  dimensionLabDashboardFixture,
+  genericDashboardFixture,
+} from "./fixtures";
+
+describe("dashboard model validation", () => {
+  it("accepts the generic dashboard fixture", () => {
+    const result = validateDashboardDocument(genericDashboardFixture);
+
+    expect(result.valid).toBe(true);
+    if (result.valid) {
+      expect(result.data.schemaVersion).toBe(DASHBOARD_SCHEMA_VERSION);
+    }
+  });
+
+  it("accepts the Dimension Lab dashboard fixture", () => {
+    const result = validateDashboardDocument(dimensionLabDashboardFixture);
+
+    expect(result.valid).toBe(true);
+  });
+
+  it("rejects documents with an unsupported schema version", () => {
+    const invalid = {
+      ...genericDashboardFixture,
+      schemaVersion: "dashboard.v0",
+    };
+
+    const result = validateDashboardDocument(invalid);
+
+    expect(result.valid).toBe(false);
+    if (!result.valid) {
+      expect(result.errors.join(" ")).toContain("must be equal to constant");
+      expect(result.details.length).toBeGreaterThan(0);
+    }
+  });
+
+  it("returns actionable field paths for invalid documents", () => {
+    const invalid = JSON.parse(JSON.stringify(genericDashboardFixture));
+    delete invalid.metadata.title;
+    invalid.telemetry[0].severity = "fine";
+
+    const result = validateDashboardDocument(invalid);
+
+    expect(result.valid).toBe(false);
+    if (!result.valid) {
+      expect(result.errors.some((error) => error.includes("/metadata"))).toBe(true);
+      expect(result.errors.some((error) => error.includes("/telemetry/0/severity"))).toBe(true);
+    }
+  });
+
+  it("exports JSON Schema for external tool contracts", () => {
+    expect(dashboardDocumentJsonSchema.$id).toContain("dashboard-document.v1");
+    expect(dashboardDocumentJsonSchema.properties).toHaveProperty("schemaVersion");
+    expect(dashboardDocumentJsonSchema.properties).toHaveProperty("telemetry");
+    expect(dashboardDocumentJsonSchema.properties).toHaveProperty("serviceGroups");
+  });
+});