@blinkk/root-cms 2.4.8 → 2.4.10

package/dist/cli.js

@@ -1,3 +1,11 @@
+import {
+  generateTypes
+} from "./chunk-RYF3UTHQ.js";
+import {
+  getCmsPlugin
+} from "./chunk-62EVNFXB.js";
+import "./chunk-MLKGABMK.js";
+
 // cli/cli.ts
 import { Command } from "commander";
 import { bgGreen, black } from "kleur/colors";
@@ -7,36 +15,6 @@ import fs from "fs";
 import path from "path";
 import { loadRootConfig } from "@blinkk/root/node";
 
-// core/client.ts
-import crypto from "crypto";
-import {
-  FieldValue as FieldValue2,
-  Timestamp as Timestamp2
-} from "firebase-admin/firestore";
-
-// core/translations-manager.ts
-import {
-  FieldValue,
-  Timestamp
-} from "firebase-admin/firestore";
-
-// shared/strings.ts
-import fnv from "fnv-plus";
-
-// core/translations-manager.ts
-var TRANSLATIONS_DB_PATH_FORMAT = "/Projects/{project}/TranslationsManager/{mode}/Translations";
-var TRANSLATIONS_LOCALE_DOC_DB_PATH_FORMAT = `${TRANSLATIONS_DB_PATH_FORMAT}/{id}:{locale}`;
-
-// core/client.ts
-function getCmsPlugin(rootConfig) {
-  const plugins = rootConfig.plugins || [];
-  const plugin = plugins.find((plugin2) => plugin2.name === "root-cms");
-  if (!plugin) {
-    throw new Error("could not find root-cms plugin config in root.config.ts");
-  }
-  return plugin;
-}
-
 // cli/utils.ts
 function parseFilters(filterStr) {
   if (!filterStr) {
@@ -47,9 +25,9 @@ function parseFilters(filterStr) {
   const excludes = parts.filter((p) => p.startsWith("!")).map((p) => p.slice(1));
   return { includes, excludes };
 }
-function getPathStatus(path4, includes, excludes) {
+function getPathStatus(path3, includes, excludes) {
   for (const pattern of excludes) {
-    if (globMatch(path4, pattern)) {
+    if (globMatch(path3, pattern)) {
       return "EXCLUDE";
     }
   }
@@ -59,7 +37,7 @@ function getPathStatus(path4, includes, excludes) {
   let isIncluded = false;
   let shouldTraverse = false;
   for (const pattern of includes) {
-    const match = checkMatch(path4, pattern);
+    const match = checkMatch(path3, pattern);
     if (match === "FULL") {
       isIncluded = true;
     } else if (match === "PARTIAL") {
@@ -74,11 +52,11 @@ function getPathStatus(path4, includes, excludes) {
   }
   return "SKIP";
 }
-function globMatch(path4, pattern) {
-  return checkMatch(path4, pattern) === "FULL";
+function globMatch(path3, pattern) {
+  return checkMatch(path3, pattern) === "FULL";
 }
-function checkMatch(path4, pattern) {
-  const pathParts = path4.split("/");
+function checkMatch(path3, pattern) {
+  const pathParts = path3.split("/");
   const patternParts = pattern.split("/");
   if (matchSegments(pathParts, patternParts)) {
     return "FULL";
@@ -342,311 +320,13 @@ function convertForExport(obj) {
   return obj;
 }
 
-// cli/generate-types.ts
-import { promises as fs2 } from "fs";
-import path2 from "path";
-import { fileURLToPath } from "url";
-import { loadRootConfig as loadRootConfig2, viteSsrLoadModule } from "@blinkk/root/node";
-import * as dom from "dts-dom";
-var __dirname = path2.dirname(fileURLToPath(import.meta.url));
-async function generateTypes() {
-  const rootDir = process.cwd();
-  const rootConfig = await loadRootConfig2(rootDir, { command: "root-cms" });
-  const modulePath = path2.resolve(__dirname, "./project.js");
-  const project = await viteSsrLoadModule(
-    rootConfig,
-    modulePath
-  );
-  const schemas = await project.getProjectSchemas();
-  const outputPath = path2.resolve(rootDir, "root-cms.d.ts");
-  await generateSchemaDts(outputPath, schemas);
-  console.log("saved root-cms.d.ts!");
-}
-var TEMPLATE = `/* eslint-disable */
-/** Root.js CMS types. This file is autogenerated. */
-
-export interface RootCMSFile {
-  src: string;
-  width?: number;
-  height?: number;
-  alt?: string;
-}
-
-export type RootCMSImage = RootCMSFile;
-
-export type RootCMSOneOf<T = any> = T;
-
-export type RootCMSOneOfOption<T, Base> = Base & {_type: T};
-
-export interface RootCMSRichTextBlock {
-  type: string;
-  data: any;
-}
-
-export interface RootCMSRichText {
-  blocks: RootCMSRichTextBlock[];
-}
-
-export interface RootCMSReference {
-  /** The id of the doc, e.g. "Pages/foo-bar". */
-  id: string;
-  /** The collection id of the doc, e.g. "Pages". */
-  collection: string;
-  /** The slug of the doc, e.g. "foo-bar". */
-  slug: string;
-}
-
-export interface RootCMSDoc<Fields extends {}> {
-  /** The id of the doc, e.g. "Pages/foo-bar". */
-  id: string;
-  /** The collection id of the doc, e.g. "Pages". */
-  collection: string;
-  /** The slug of the doc, e.g. "foo-bar". */
-  slug: string;
-  /** System-level metadata. */
-  sys: {
-    createdAt: number;
-    createdBy: string;
-    modifiedAt: number;
-    modifiedBy: string;
-    firstPublishedAt?: number;
-    firstPublishedBy?: string;
-    publishedAt?: number;
-    publishedBy?: string;
-    locales?: string[];
-  };
-  /** User-entered field values from the CMS. */
-  fields?: Fields;
-}`;
-var DtsFormatter = class {
-  constructor() {
-    /**
-     * Field types defined in either `.schema.ts` files or used by `oneOf()`
-     * fields.
-     */
-    this.fieldsTypes = {};
-    /**
-     * For `collections/*.schema.ts` files, output a corresponding "RootCMSDoc"
-     * type. For example, `collections/BlogPosts.schema.ts` would output a type
-     * called `BlogPostsDoc`.
-     */
-    this.docTypes = {};
-  }
-  /** Adds the types for a `.schema.ts` file to the `.d.ts` file. */
-  addSchemaFile(fileId, schema) {
-    const jsdoc = `Generated from \`${fileId}\`.`;
-    const typeId = alphanumeric(path2.parse(fileId).name.split(".")[0]);
-    const oneOfTypes = {};
-    const fieldsTypeId = `${typeId}Fields`;
-    const fieldsType = dom.create.interface(
-      fieldsTypeId,
-      dom.DeclarationFlags.Export
-    );
-    fieldsType.jsDocComment = jsdoc;
-    for (const field of schema.fields) {
-      if (!field.id) {
-        continue;
-      }
-      fieldsType.members.push(fieldProperty(field, { typeId, oneOfTypes }));
-    }
-    for (const oneOfTypeId in oneOfTypes) {
-      if (!this.fieldsTypes[fieldsTypeId]) {
-        this.fieldsTypes[oneOfTypeId] = oneOfTypes[oneOfTypeId];
-      }
-    }
-    this.fieldsTypes[fieldsTypeId] = fieldsType;
-    if (fileId.startsWith("/collections/")) {
-      const docTypeId = `${typeId}Doc`;
-      const baseType = dom.create.namedTypeReference("RootCMSDoc");
-      baseType.typeArguments.push(dom.create.namedTypeReference(fieldsTypeId));
-      const docType = dom.create.alias(
-        docTypeId,
-        baseType,
-        dom.DeclarationFlags.Export
-      );
-      docType.jsDocComment = jsdoc;
-      this.docTypes[docTypeId] = docType;
-    }
-  }
-  /** Generates the `.d.ts` output as a string. */
-  toString() {
-    const results = [TEMPLATE];
-    const sortedFieldsTypes = Object.keys(this.fieldsTypes).sort();
-    for (const fieldsTypeId of sortedFieldsTypes) {
-      const fieldsType = this.fieldsTypes[fieldsTypeId];
-      results.push(this.typeToString(fieldsType));
-      const docTypeId = this.fieldsTypeToDocType(fieldsTypeId);
-      const docType = this.docTypes[docTypeId];
-      if (docType) {
-        results.push(this.typeToString(docType));
-      }
-    }
-    const output = results.join("\n\n").replaceAll("/**  ", "/** ").replaceAll("  */", " */").replace(/\r\n|\r|\n/g, "\n") + "\n";
-    return output;
-  }
-  /**
-   * Converts "<Name>Fields" to "<Name>Doc".
-   */
-  fieldsTypeToDocType(fieldsTypeId) {
-    if (!fieldsTypeId.endsWith("Fields")) {
-      throw new Error(`"${fieldsTypeId}" should be suffixed with "Fields"`);
-    }
-    const name = fieldsTypeId.slice(0, -6);
-    return `${name}Doc`;
-  }
-  typeToString(type2) {
-    return this.reformatOutput(dom.emit(type2, { singleLineJsDocComments: true }));
-  }
-  /**
-   * Formats the output to Google style conventions, e.g. 2-space indents and
-   * single quote strings.
-   */
-  reformatOutput(input) {
-    const lines = input.trim().split("\n");
-    const results = [];
-    for (const line of lines) {
-      const convertedLine = line.replace(/ {4}/g, "  ").replaceAll('"', "'");
-      results.push(convertedLine);
-    }
-    return results.join("\n");
-  }
-};
-async function generateSchemaDts(outputPath, schemas) {
-  const dtsFormatter = new DtsFormatter();
-  for (const fileId in schemas) {
-    const schema = schemas[fileId];
-    dtsFormatter.addSchemaFile(fileId, schema);
-  }
-  const output = dtsFormatter.toString();
-  await fs2.writeFile(outputPath, output, "utf-8");
-}
-function fieldProperty(field, options) {
-  const prop = dom.create.property(
-    field.id,
-    fieldType(field, options),
-    dom.DeclarationFlags.Optional
-  );
-  const jsdoc = [];
-  if (field.label) {
-    if (field.help) {
-      jsdoc.push(`${field.label}. ${field.help}`);
-    } else {
-      jsdoc.push(field.label);
-    }
-  }
-  if (field.deprecated) {
-    jsdoc.push("@deprecated");
-  }
-  if (jsdoc.length > 0) {
-    prop.jsDocComment = jsdoc.join("\n");
-  }
-  return prop;
-}
-function fieldType(field, options) {
-  if (field.type === "array") {
-    return dom.type.array(fieldType(field.of, options));
-  }
-  if (field.type === "boolean") {
-    return dom.type.boolean;
-  }
-  if (field.type === "date") {
-    return dom.type.string;
-  }
-  if (field.type === "datetime") {
-    return dom.type.number;
-  }
-  if (field.type === "file") {
-    const fileType = dom.create.namedTypeReference("RootCMSFile");
-    return fileType;
-  }
-  if (field.type === "image") {
-    const imageType = dom.create.namedTypeReference("RootCMSImage");
-    return imageType;
-  }
-  if (field.type === "multiselect") {
-    return dom.type.array(dom.type.string);
-  }
-  if (field.type === "oneof") {
-    const oneOf = dom.create.namedTypeReference("RootCMSOneOf");
-    if (field.types && Array.isArray(field.types)) {
-      const unionTypes = [];
-      field.types.forEach((schema) => {
-        let typeName;
-        if (typeof schema === "string") {
-          typeName = schema;
-          return;
-        } else {
-          typeName = schema.name;
-        }
-        if (!typeName) {
-          return;
-        }
-        const cleanName = alphanumeric(typeName);
-        const oneOfTypeId = `${cleanName}Fields`;
-        if (typeof schema === "object" && !options.oneOfTypes[oneOfTypeId]) {
-          const oneOfTypeInterface = dom.create.interface(
-            oneOfTypeId,
-            dom.DeclarationFlags.Export
-          );
-          if (schema.description) {
-            oneOfTypeInterface.jsDocComment = schema.description;
-          }
-          const oneOfTypeFields = schema.fields || [];
-          oneOfTypeFields.forEach((f) => {
-            oneOfTypeInterface.members.push(fieldProperty(f, options));
-          });
-          options.oneOfTypes[oneOfTypeId] = oneOfTypeInterface;
-        }
-        const oneOfOption = dom.create.namedTypeReference("RootCMSOneOfOption");
-        oneOfOption.typeArguments = [
-          dom.type.stringLiteral(typeName),
-          dom.create.namedTypeReference(oneOfTypeId)
-        ];
-        unionTypes.push(oneOfOption);
-      });
-      if (unionTypes.length > 0) {
-        oneOf.typeArguments = [dom.create.union(unionTypes)];
-      }
-    }
-    return oneOf;
-  }
-  if (field.type === "reference") {
-    const referenceType = dom.create.namedTypeReference("RootCMSReference");
-    return referenceType;
-  }
-  if (field.type === "references") {
-    const referenceType = dom.create.namedTypeReference("RootCMSReference");
-    return dom.type.array(referenceType);
-  }
-  if (field.type === "richtext") {
-    const richtextType = dom.create.namedTypeReference("RootCMSRichText");
-    return richtextType;
-  }
-  if (field.type === "select") {
-    return dom.type.string;
-  }
-  if (field.type === "string") {
-    return dom.type.string;
-  }
-  if (field.type === "object") {
-    const subproperties = (field.fields || []).map(
-      (f) => fieldProperty(f, options)
-    );
-    return dom.create.objectType(subproperties);
-  }
-  return dom.type.unknown;
-}
-function alphanumeric(input) {
-  return input.replace(/[^a-zA-Z0-9]/g, "");
-}
-
 // cli/import.ts
-import fs3 from "fs";
-import path3 from "path";
+import fs2 from "fs";
+import path2 from "path";
 import * as readline from "readline";
-import { loadRootConfig as loadRootConfig3 } from "@blinkk/root/node";
+import { loadRootConfig as loadRootConfig2 } from "@blinkk/root/node";
 import cliProgress from "cli-progress";
-import { Timestamp as Timestamp3, GeoPoint } from "firebase-admin/firestore";
+import { Timestamp, GeoPoint } from "firebase-admin/firestore";
 async function importData(options) {
   if (!options.dir) {
     throw new Error(
@@ -654,18 +334,18 @@ async function importData(options) {
     );
   }
   const importDir = options.dir;
-  if (!fs3.existsSync(importDir)) {
+  if (!fs2.existsSync(importDir)) {
     throw new Error(`Error: Directory not found: ${importDir}`);
   }
   const rootDir = process.cwd();
-  const rootConfig = await loadRootConfig3(rootDir, { command: "root-cms" });
+  const rootConfig = await loadRootConfig2(rootDir, { command: "root-cms" });
   const cmsPlugin = getCmsPlugin(rootConfig);
   const cmsPluginOptions = cmsPlugin.getConfig();
   const siteId = options.site || cmsPluginOptions.id || "default";
   const databaseId = options.database || "(default)";
   const gcpProjectId = options.project || cmsPluginOptions.firebaseConfig?.projectId || "unknown";
   const db = cmsPlugin.getFirestore({ databaseId });
-  const entries = fs3.readdirSync(importDir, { withFileTypes: true });
+  const entries = fs2.readdirSync(importDir, { withFileTypes: true });
   const availableCollections = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
   const { includes, excludes } = parseFilters(options.filter);
   const collectionsToImport = availableCollections.filter((id) => {
@@ -681,8 +361,8 @@ async function importData(options) {
   }
   const summary = [];
   for (const collectionType of collectionsToImport) {
-    const collectionDir = path3.join(importDir, collectionType);
-    if (fs3.existsSync(collectionDir)) {
+    const collectionDir = path2.join(importDir, collectionType);
+    if (fs2.existsSync(collectionDir)) {
       const count = countJsonFilesRecursive(
         collectionDir,
         collectionType,
@@ -721,7 +401,7 @@ async function importData(options) {
   const limit = pLimit(10);
   for (const item of summary) {
     const collectionPath = `Projects/${siteId}/${item.collectionType}`;
-    const collectionDir = path3.join(importDir, item.collectionType);
+    const collectionDir = path2.join(importDir, item.collectionType);
     await importCollection(
       db,
       collectionPath,
@@ -734,10 +414,10 @@ async function importData(options) {
       limit
     );
   }
-  const projectFilePath = path3.join(importDir, "__data.json");
-  if (fs3.existsSync(projectFilePath)) {
+  const projectFilePath = path2.join(importDir, "__data.json");
+  if (fs2.existsSync(projectFilePath)) {
     console.log("Importing project document...");
-    const rawData = JSON.parse(fs3.readFileSync(projectFilePath, "utf-8"));
+    const rawData = JSON.parse(fs2.readFileSync(projectFilePath, "utf-8"));
     const projectData = convertFirestoreTypes(rawData, db);
     const projectPath = `Projects/${siteId}`;
     await db.doc(projectPath).set(projectData, { merge: true });
@@ -747,14 +427,14 @@ async function importData(options) {
 }
 function countJsonFilesRecursive(dir, relativePath, includes, excludes) {
   let count = 0;
-  const entries = fs3.readdirSync(dir, { withFileTypes: true });
+  const entries = fs2.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
     if (entry.isDirectory()) {
       const subRelativePath = `${relativePath}/${entry.name}`;
       const status = getPathStatus(subRelativePath, includes, excludes);
       if (status !== "SKIP" && status !== "EXCLUDE") {
         count += countJsonFilesRecursive(
-          path3.join(dir, entry.name),
+          path2.join(dir, entry.name),
           subRelativePath,
           includes,
           excludes
@@ -768,7 +448,7 @@ function countJsonFilesRecursive(dir, relativePath, includes, excludes) {
         }
         continue;
       }
-      const docId = path3.basename(entry.name, ".json");
+      const docId = path2.basename(entry.name, ".json");
       const docRelativePath = `${relativePath}/${docId}`;
       const status = getPathStatus(docRelativePath, includes, excludes);
       if (status !== "SKIP" && status !== "EXCLUDE") {
@@ -805,7 +485,7 @@ function convertFirestoreTypes(obj, db) {
     return obj;
   }
   if (typeof obj === "object" && "_seconds" in obj && "_nanoseconds" in obj && Object.keys(obj).length === 2) {
-    return new Timestamp3(obj._seconds, obj._nanoseconds);
+    return new Timestamp(obj._seconds, obj._nanoseconds);
   }
   if (typeof obj === "object" && "_latitude" in obj && "_longitude" in obj && Object.keys(obj).length === 2) {
     return new GeoPoint(obj._latitude, obj._longitude);
@@ -826,15 +506,15 @@ function convertFirestoreTypes(obj, db) {
   return obj;
 }
 async function importCollectionRecursive(db, collectionPath, inputDir, progressBar, relativePath, includes, excludes, limit) {
-  if (!fs3.existsSync(inputDir)) {
+  if (!fs2.existsSync(inputDir)) {
     return;
   }
-  const entries = fs3.readdirSync(inputDir, { withFileTypes: true });
+  const entries = fs2.readdirSync(inputDir, { withFileTypes: true });
   await Promise.all(
     entries.map(async (entry) => {
       if (entry.isFile() && entry.name.endsWith(".json")) {
         const rawData = JSON.parse(
-          fs3.readFileSync(path3.join(inputDir, entry.name), "utf-8")
+          fs2.readFileSync(path2.join(inputDir, entry.name), "utf-8")
         );
         const docData = convertFirestoreTypes(rawData, db);
         if (entry.name === "__data.json") {
@@ -849,7 +529,7 @@ async function importCollectionRecursive(db, collectionPath, inputDir, progressB
             }
           }
         } else {
-          const docId = path3.basename(entry.name, ".json");
+          const docId = path2.basename(entry.name, ".json");
           const docRelativePath = relativePath ? `${relativePath}/${docId}` : docId;
           const status = includes && excludes ? getPathStatus(docRelativePath, includes, excludes) : "INCLUDE";
           if (status !== "SKIP" && status !== "EXCLUDE") {
@@ -867,7 +547,7 @@ async function importCollectionRecursive(db, collectionPath, inputDir, progressB
         }
       } else if (entry.isDirectory()) {
         const subCollectionPath = `${collectionPath}/${entry.name}`;
-        const subCollectionDir = path3.join(inputDir, entry.name);
+        const subCollectionDir = path2.join(inputDir, entry.name);
         const subRelativePath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
         const status = includes && excludes ? getPathStatus(subRelativePath, includes, excludes) : "INCLUDE";
         if (status !== "SKIP" && status !== "EXCLUDE") {
@@ -901,7 +581,7 @@ async function promptYesNo(question) {
 }
 
 // cli/init-firebase.ts
-import { loadRootConfig as loadRootConfig4 } from "@blinkk/root/node";
+import { loadRootConfig as loadRootConfig3 } from "@blinkk/root/node";
 
 // core/security.ts
 import { initializeApp } from "firebase-admin/app";
@@ -921,11 +601,16 @@ service cloud.firestore {
 
       match /{collection}/{document=**} {
         allow write:
-          if isSignedIn() && userCanWrite();
+          if isSignedIn() && userCanPublish();
         allow read:
           if isSignedIn() && userCanRead();
       }
 
+      match /Collections/{collectionId}/Drafts/{document=**} {
+        allow write:
+          if isSignedIn() && userCanEdit();
+      }
+
       function isSignedIn() {
         return request.auth != null;
       }
@@ -938,16 +623,23 @@ service cloud.firestore {
         let roles = getRoles();
         let email = request.auth.token.email;
         let domain = '*@' + email.split('@')[1];
-        return (roles[email] in ['ADMIN', 'EDITOR', 'VIEWER']) || (roles[domain] in ['ADMIN', 'EDITOR', 'VIEWER']);
+        return (roles[email] in ['ADMIN', 'EDITOR', 'CONTRIBUTOR', 'VIEWER']) || (roles[domain] in ['ADMIN', 'EDITOR', 'CONTRIBUTOR', 'VIEWER']);
       }
 
-      function userCanWrite() {
+      function userCanPublish() {
         let roles = getRoles();
         let email = request.auth.token.email;
         let domain = '*@' + email.split('@')[1];
         return (roles[email] in ['ADMIN', 'EDITOR']) || (roles[domain] in ['ADMIN', 'EDITOR']);
       }
 
+      function userCanEdit() {
+        let roles = getRoles();
+        let email = request.auth.token.email;
+        let domain = '*@' + email.split('@')[1];
+        return (roles[email] in ['ADMIN', 'EDITOR', 'CONTRIBUTOR']) || (roles[domain] in ['ADMIN', 'EDITOR', 'CONTRIBUTOR']);
+      }
+
       function userIsAdmin() {
         let roles = getRoles();
         let email = request.auth.token.email;
@@ -967,7 +659,7 @@ async function applySecurityRules(projectId) {
 // cli/init-firebase.ts
 async function initFirebase(options) {
   const rootDir = process.cwd();
-  const rootConfig = await loadRootConfig4(rootDir, { command: "root-cms" });
+  const rootConfig = await loadRootConfig3(rootDir, { command: "root-cms" });
   const cmsPlugin = getCmsPlugin(rootConfig);
   const cmsPluginOptions = cmsPlugin.getConfig();
   const gcpProjectId = options.project || cmsPluginOptions.firebaseConfig.projectId;

package/dist/{client-pSzji9ZN.d.ts → client-PhodvL2Q.d.ts}

@@ -1,6 +1,7 @@
 import { Plugin, Request, RootConfig } from '@blinkk/root';
 import { App } from 'firebase-admin/app';
 import { Firestore, WriteBatch, Timestamp, Query } from 'firebase-admin/firestore';
+import { C as Collection } from './schema-Bux4PrV2.js';
 
 /**
  * Supported Root AI models. Defaults to 'gemini-3-flash-preview'.
@@ -385,7 +386,7 @@ interface Doc<Fields = any> {
     fields: Fields;
 }
 type DocMode = 'draft' | 'published';
-type UserRole = 'ADMIN' | 'EDITOR' | 'VIEWER';
+type UserRole = 'ADMIN' | 'EDITOR' | 'CONTRIBUTOR' | 'VIEWER';
 type HttpMethod = 'GET' | 'POST';
 interface DataSource {
     id: string;
@@ -436,6 +437,18 @@ interface SaveDraftOptions {
      * Email of user modifying the doc. If blank, defaults to `root-cms-client`.
      */
     modifiedBy?: string;
+    /**
+     * Whether to validate fieldsData against the collection schema before saving.
+     * If validation fails, an error will be thrown with details about the validation errors.
+     */
+    validate?: boolean;
+}
+interface UpdateDraftOptions {
+    /**
+     * Whether to validate the updated field against the collection schema.
+     * If validation fails, an error will be thrown with details about the validation errors.
+     */
+    validate?: boolean;
 }
 interface ListDocsOptions {
     mode: DocMode;
@@ -553,6 +566,11 @@ declare class RootCMSClient {
     dbDocRef(collectionId: string, slug: string, options: {
         mode: 'draft' | 'published';
     }): FirebaseFirestore.DocumentReference<FirebaseFirestore.DocumentData, FirebaseFirestore.DocumentData>;
+    /**
+     * Returns a collection's schema definition as defined in
+     * `/collections/<id>.schema.ts`.
+     */
+    getCollection(collectionId: string): Promise<Collection | null>;
     /**
      * Saves draft data to a doc.
      *
@@ -560,6 +578,18 @@ declare class RootCMSClient {
      * modify the sys-level attributes of the doc, use `setRawDoc()`.
      */
     saveDraftData(docId: string, fieldsData: any, options?: SaveDraftOptions): Promise<void>;
+    /**
+     * Updates a specific field path in a draft doc.
+     *
+     * This allows partial updates to nested fields without replacing the entire document.
+     * For example: `updateDraftData('Pages/home', 'hero.title', 'New Title')`
+     *
+     * @param docId - The document ID (e.g., 'Pages/home')
+     * @param path - JSON path to the field (e.g., 'hero.title' or 'content.0.text')
+     * @param fieldValue - The value to set at the specified path
+     * @param options - Update options including validation
+     */
+    updateDraftData(docId: string, path: string, fieldValue: any, options?: UpdateDraftOptions): Promise<void>;
     /**
      * Prefer `saveDraftData('Pages/foo', data)`. Only use this if you know what
      * you're doing.
@@ -896,4 +926,4 @@ declare class BatchResponse {
     private getTranslationsMap;
 }
 
-export { type CMSPlugin as $, type Action as A, type BatchRequestOptions as B, BatchResponse as C, type DocMode as D, type Locale as E, type SourceString as F, type GetDocOptions as G, type HttpMethod as H, type TranslatedString as I, type TranslationsDocMode as J, type TranslationsLocaleDocHashMap as K, type LoadTranslationsOptions as L, type TranslationsLocaleDocEntry as M, type MultiLocaleTranslationsMap as N, type SingleLocaleTranslationsMap as O, TranslationsManager as P, buildTranslationsDbPath as Q, RootCMSClient as R, type SetDocOptions as S, type TranslationsMap as T, type UserRole as U, buildTranslationsLocaleDocDbPath as V, type CMSBuiltInSidebarTool as W, type CMSUser as X, type CMSAIConfig as Y, type CMSSidebarTool as Z, type CMSPluginOptions as _, type LocaleTranslations as a, cmsPlugin as a0, type Doc as b, type DataSource as c, type DataSourceData as d, type DataSourceMode as e, type SaveDraftOptions as f, type ListDocsOptions as g, type GetCountOptions as h, type Translation as i, type Release as j, type ListActionsOptions as k, isRichTextData as l, getCmsPlugin as m, marshalData as n, normalizeData as o, type ArrayObject as p, marshalArray as q, unmarshalArray as r, translationsForLocale as s, toArrayObject as t, unmarshalData as u, parseDocId as v, type BatchRequestQuery as w, type BatchRequestQueryOptions as x, type TranslationsDoc as y, BatchRequest as z };
+export { type CMSPluginOptions as $, type Action as A, type BatchRequestOptions as B, BatchRequest as C, type DocMode as D, BatchResponse as E, type Locale as F, type GetDocOptions as G, type HttpMethod as H, type SourceString as I, type TranslatedString as J, type TranslationsDocMode as K, type LoadTranslationsOptions as L, type TranslationsLocaleDocHashMap as M, type TranslationsLocaleDocEntry as N, type MultiLocaleTranslationsMap as O, type SingleLocaleTranslationsMap as P, TranslationsManager as Q, RootCMSClient as R, type SetDocOptions as S, type TranslationsMap as T, type UserRole as U, buildTranslationsDbPath as V, buildTranslationsLocaleDocDbPath as W, type CMSBuiltInSidebarTool as X, type CMSUser as Y, type CMSAIConfig as Z, type CMSSidebarTool as _, type LocaleTranslations as a, type CMSPlugin as a0, cmsPlugin as a1, type Doc as b, type DataSource as c, type DataSourceData as d, type DataSourceMode as e, type SaveDraftOptions as f, type UpdateDraftOptions as g, type ListDocsOptions as h, type GetCountOptions as i, type Translation as j, type Release as k, type ListActionsOptions as l, isRichTextData as m, getCmsPlugin as n, marshalData as o, normalizeData as p, type ArrayObject as q, marshalArray as r, unmarshalArray as s, toArrayObject as t, unmarshalData as u, translationsForLocale as v, parseDocId as w, type BatchRequestQuery as x, type BatchRequestQueryOptions as y, type TranslationsDoc as z };

package/dist/client.d.ts

@@ -1,4 +1,5 @@
 import '@blinkk/root';
 import 'firebase-admin/app';
 import 'firebase-admin/firestore';
-export { A as Action, p as ArrayObject, z as BatchRequest, B as BatchRequestOptions, w as BatchRequestQuery, x as BatchRequestQueryOptions, C as BatchResponse, c as DataSource, d as DataSourceData, e as DataSourceMode, b as Doc, D as DocMode, h as GetCountOptions, G as GetDocOptions, H as HttpMethod, k as ListActionsOptions, g as ListDocsOptions, L as LoadTranslationsOptions, a as LocaleTranslations, j as Release, R as RootCMSClient, f as SaveDraftOptions, S as SetDocOptions, i as Translation, y as TranslationsDoc, T as TranslationsMap, U as UserRole, m as getCmsPlugin, l as isRichTextData, q as marshalArray, n as marshalData, o as normalizeData, v as parseDocId, t as toArrayObject, s as translationsForLocale, r as unmarshalArray, u as unmarshalData } from './client-pSzji9ZN.js';
+export { A as Action, q as ArrayObject, C as BatchRequest, B as BatchRequestOptions, x as BatchRequestQuery, y as BatchRequestQueryOptions, E as BatchResponse, c as DataSource, d as DataSourceData, e as DataSourceMode, b as Doc, D as DocMode, i as GetCountOptions, G as GetDocOptions, H as HttpMethod, l as ListActionsOptions, h as ListDocsOptions, L as LoadTranslationsOptions, a as LocaleTranslations, k as Release, R as RootCMSClient, f as SaveDraftOptions, S as SetDocOptions, j as Translation, z as TranslationsDoc, T as TranslationsMap, g as UpdateDraftOptions, U as UserRole, n as getCmsPlugin, m as isRichTextData, r as marshalArray, o as marshalData, p as normalizeData, w as parseDocId, t as toArrayObject, v as translationsForLocale, s as unmarshalArray, u as unmarshalData } from './client-PhodvL2Q.js';
+import './schema-Bux4PrV2.js';