contentbase 0.0.1

package/test/section.test.ts

@@ -0,0 +1,99 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { section } from "../src/section";
+import { Collection } from "../src/collection";
+import { createModelInstance } from "../src/model-instance";
+import { createTestCollection } from "./helpers";
+import { Story } from "./fixtures/sdlc/models";
+import { z } from "zod";
+import { toString } from "mdast-util-to-string";
+
+describe("section helper", () => {
+  it("creates a SectionDefinition with heading and extract", () => {
+    const sd = section("My Section", {
+      extract: (q) => q.selectAll("listItem"),
+    });
+    expect(sd.heading).toBe("My Section");
+    expect(sd.extract).toBeDefined();
+  });
+
+  it("stores optional schema", () => {
+    const schema = z.array(z.string());
+    const sd = section("Items", {
+      extract: (q) =>
+        q.selectAll("listItem").map((n) => toString(n)),
+      schema,
+    });
+    expect(sd.schema).toBe(schema);
+  });
+
+  it("extract receives AstQuery scoped to section content only", async () => {
+    const collection = await createTestCollection();
+    const doc = collection.document(
+      "stories/authentication/a-user-should-be-able-to-register"
+    );
+    const instance = createModelInstance(doc, Story, collection);
+
+    // acceptanceCriteria should only contain items from that section
+    const criteria = instance.sections.acceptanceCriteria;
+    expect(criteria.length).toBe(4);
+    expect(criteria[0]).toContain("signup form");
+  });
+
+  it("section data is lazily computed", async () => {
+    const collection = await createTestCollection();
+    const doc = collection.document(
+      "stories/authentication/a-user-should-be-able-to-register"
+    );
+
+    let extractCalled = 0;
+    const TestModel = {
+      name: "Test",
+      prefix: "test",
+      meta: z.object({}).passthrough(),
+      schema: z.object({}).passthrough(),
+      sections: {
+        items: section("Acceptance Criteria", {
+          extract: (q) => {
+            extractCalled++;
+            return q.selectAll("listItem").map((n) => toString(n));
+          },
+        }),
+      },
+      relationships: {},
+      computed: {},
+    } as any;
+
+    const instance = createModelInstance(doc, TestModel, collection);
+    expect(extractCalled).toBe(0); // Not yet accessed
+    const _items = instance.sections.items;
+    expect(extractCalled).toBe(1); // Now extracted
+    const _items2 = instance.sections.items;
+    expect(extractCalled).toBe(1); // Cached
+  });
+
+  it("missing section returns empty data", async () => {
+    const collection = await createTestCollection();
+    const doc = collection.createDocument({
+      id: "test/no-section",
+      content: "# Just a title\n\nSome content.\n",
+    });
+
+    const TestModel = {
+      name: "Test",
+      prefix: "test",
+      meta: z.object({}).passthrough(),
+      schema: z.object({}).passthrough(),
+      sections: {
+        missing: section("Nonexistent Section", {
+          extract: (q) => q.selectAll("listItem").map((n) => toString(n)),
+        }),
+      },
+      relationships: {},
+      computed: {},
+    } as any;
+
+    const instance = createModelInstance(doc, TestModel, collection);
+    // Should not crash, just return empty
+    expect(instance.sections.missing).toEqual([]);
+  });
+});

package/test/validator.test.ts

@@ -0,0 +1,62 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { validateDocument } from "../src/validator";
+import { Collection } from "../src/collection";
+import { createTestCollection } from "./helpers";
+import { Epic, Story } from "./fixtures/sdlc/models";
+
+describe("validateDocument", () => {
+  let collection: Collection;
+
+  beforeEach(async () => {
+    collection = await createTestCollection();
+  });
+
+  it("returns valid for good meta", () => {
+    const doc = collection.document("epics/authentication");
+    const result = validateDocument(doc, Epic);
+    expect(result.valid).toBe(true);
+    expect(result.errors.length).toBe(0);
+  });
+
+  it("returns errors for invalid meta", () => {
+    const doc = collection.createDocument({
+      id: "test/bad",
+      content: "# Bad\n",
+      meta: { status: "BOGUS" },
+    });
+    const result = validateDocument(doc, Epic);
+    expect(result.valid).toBe(false);
+    expect(result.errors.length).toBeGreaterThan(0);
+  });
+
+  it("applies defaults before validation", () => {
+    const doc = collection.createDocument({
+      id: "test/defaults",
+      content: "# Defaults\n",
+      meta: {},
+    });
+    const result = validateDocument(doc, Epic);
+    expect(result.valid).toBe(true);
+  });
+
+  it("validates sections when schema is present", () => {
+    const doc = collection.document(
+      "stories/authentication/a-user-should-be-able-to-register"
+    );
+    const result = validateDocument(doc, Story);
+    expect(result.valid).toBe(true);
+  });
+
+  it("section validation errors include section key in path", () => {
+    const doc = collection.createDocument({
+      id: "test/bad-section",
+      content: "# Bad\n\n## Acceptance Criteria\n\nNo list items here.\n",
+      meta: { status: "created" },
+    });
+    const result = validateDocument(doc, Story);
+    // acceptanceCriteria extracts listItems; paragraph text won't produce any
+    // The schema is z.array(z.string()) which allows empty arrays
+    // so this should actually pass - the extract returns []
+    expect(result.valid).toBe(true);
+  });
+});

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "types": ["bun-types"],
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist", "test"]
+}

package/vitest.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  resolve: {
+    extensions: [".ts", ".js", ".mjs"],
+  },
+  test: {
+    globals: true,
+    include: ["test/**/*.test.ts"],
+  },
+});