contentbase 0.4.0 → 0.4.2

package/dist/validator.d.ts

@@ -0,0 +1,10 @@
+import type { ModelDefinition, ValidationResult } from "./types";
+import type { Document } from "./document";
+/**
+ * Standalone validator that checks a document against a model definition's
+ * Zod schemas (both meta and section schemas).
+ *
+ * Can be used directly for validation without creating a full model instance.
+ */
+export declare function validateDocument(document: Document, definition: ModelDefinition): ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EAEf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,eAAe,GAC1B,gBAAgB,CAkDlB"}

package/dist/validator.js

@@ -0,0 +1,55 @@
+import { matchPatterns } from "./utils/match-pattern";
+/**
+ * Standalone validator that checks a document against a model definition's
+ * Zod schemas (both meta and section schemas).
+ *
+ * Can be used directly for validation without creating a full model instance.
+ */
+export function validateDocument(document, definition) {
+    const errors = [];
+    // Validate meta
+    const patternMeta = definition.pattern
+        ? matchPatterns(definition.pattern, document.id) ?? {}
+        : {};
+    const rawMeta = { ...(definition.defaults ?? {}), ...patternMeta, ...document.meta };
+    const metaResult = definition.meta.safeParse(rawMeta);
+    if (!metaResult.success) {
+        errors.push(...metaResult.error.issues);
+    }
+    // Validate title: require H1 heading unless titleOptional or meta.title exists
+    if (!definition.titleOptional) {
+        const hasMetaTitle = !!document.meta.title;
+        const hasH1 = !!document.astQuery.select("heading");
+        if (!hasMetaTitle && !hasH1) {
+            errors.push({
+                code: "custom",
+                path: ["title"],
+                message: `Document "${document.id}" is missing a title. Add an H1 heading or set meta.title.`,
+            });
+        }
+    }
+    // Validate sections
+    if (definition.sections) {
+        for (const [key, sd] of Object.entries(definition.sections)) {
+            const sectionDef = sd;
+            if (sectionDef.schema) {
+                const sectionQuery = document.querySection(sectionDef.heading);
+                const sectionData = sectionDef.extract(sectionQuery);
+                const sResult = sectionDef.schema.safeParse(sectionData);
+                if (!sResult.success) {
+                    for (const issue of sResult.error.issues) {
+                        errors.push({
+                            ...issue,
+                            path: ["sections", key, ...issue.path],
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAkB,EAClB,UAA2B;IAE3B,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,gBAAgB;IAChB,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO;QACpC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE;QACtD,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,OAAO,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IACrF,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,+EAA+E;IAC/E,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QAC3C,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,CAAC;gBACf,OAAO,EAAE,aAAa,QAAQ,CAAC,EAAE,4DAA4D;aAC9F,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5D,MAAM,UAAU,GAAG,EAAgC,CAAC;YACpD,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBACtB,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAC/D,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBACrD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;gBACzD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;oBACrB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;wBACzC,MAAM,CAAC,IAAI,CAAC;4BACV,GAAG,KAAK;4BACR,IAAI,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;yBACvC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contentbase",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "repository": "https://github.com/soederpop/contentbase",
   "website": "https://contentbase.soederpop.com",
   "type": "module",
@@ -11,8 +11,8 @@
     "contentbase": "./src/cli/index.ts"
   },
   "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
     "build": "find dist -name '*.d.ts' -o -name '*.d.ts.map' -o -name '*.js' -o -name '*.js.map' | xargs rm -f 2>/dev/null; tsc",
     "typecheck": "tsc --noEmit",
     "examples": "bun run scripts/examples/run-all.ts",

package/src/document.ts

@@ -17,24 +17,34 @@ import type { Root, Content, RootContent, Heading } from "mdast";
 import type { Collection } from "./collection";
 
 export interface DocumentOptions {
-  id: string;
+  /** Document id. Optional for standalone documents — derived from `path` or defaults to "untitled". */
+  id?: string;
   content: string;
   meta?: Record<string, unknown>;
-  collection: Collection;
+  /** Owning collection. Omit (or pass null) to create a standalone in-memory document. */
+  collection?: Collection | null;
+  /** Explicit file path. Used as-is by the `path` getter for standalone documents. */
+  path?: string;
   ast?: Root;
 }
 
 export class Document {
   readonly id: string;
-  readonly collection: Collection;
+  readonly collection: Collection | null;
 
   #content: string;
   #meta: Record<string, unknown>;
   #ast: Root | null;
+  #path: string | null;
 
   constructor(options: DocumentOptions) {
-    this.id = options.id;
-    this.collection = options.collection;
+    this.id =
+      options.id ??
+      (options.path
+        ? options.path.replace(/\.mdx?$/, "").split("/").filter(Boolean).pop()!
+        : "untitled");
+    this.collection = options.collection ?? null;
+    this.#path = options.path ?? null;
     this.#content = options.content;
     this.#meta = options.meta ?? {};
     this.#ast = options.ast ?? null;
@@ -68,15 +78,15 @@ export class Document {
   }
 
   get createdAt(): Date | undefined {
-    return this.collection.items.get(this.id)?.createdAt;
+    return this.collection?.items.get(this.id)?.createdAt;
   }
 
   get updatedAt(): Date | undefined {
-    return this.collection.items.get(this.id)?.updatedAt;
+    return this.collection?.items.get(this.id)?.updatedAt;
   }
 
   get size(): number | undefined {
-    return this.collection.items.get(this.id)?.size;
+    return this.collection?.items.get(this.id)?.size;
   }
 
   get rawContent(): string {
@@ -88,6 +98,8 @@ export class Document {
   }
 
   get path(): string {
+    if (this.#path) return this.#path;
+    if (!this.collection) return `${this.id}.md`;
     return this.collection.resolve(this.id) + ".md";
   }
 
@@ -512,6 +524,9 @@ export class Document {
   async save(
     options: { normalize?: boolean; extension?: string } = {}
   ): Promise<this> {
+    if (!this.collection) {
+      throw new Error("Cannot save a standalone document — it has no collection");
+    }
     if (options.normalize !== false) {
       this.normalizeHeadings();
     }
@@ -523,6 +538,9 @@ export class Document {
   }
 
   async reload(): Promise<this> {
+    if (!this.collection) {
+      throw new Error("Cannot reload a standalone document — it has no collection");
+    }
     const item = await this.collection.readItem(this.id);
     this.#content = item.content;
     this.#meta = item.meta;