@blinkk/root-cms 2.5.3 → 2.5.5

package/dist/cli.js

@@ -2,18 +2,22 @@ import {
   generateTypes
 } from "./chunk-KDXHFMIH.js";
 import {
-  getCmsPlugin
-} from "./chunk-XMR3KFP5.js";
+  RootCMSClient,
+  getCmsPlugin,
+  unmarshalData
+} from "./chunk-UEJ2UTTJ.js";
 import "./chunk-MLKGABMK.js";
 
 // cli/cli.ts
 import { Command } from "commander";
 import { bgGreen, black } from "kleur/colors";
 
-// cli/export.ts
+// cli/docs.ts
 import fs from "fs";
 import path from "path";
+import * as readline from "readline";
 import { loadRootConfig } from "@blinkk/root/node";
+import { Timestamp, GeoPoint } from "firebase-admin/firestore";
 
 // cli/utils.ts
 function parseFilters(filterStr) {
@@ -25,9 +29,9 @@ function parseFilters(filterStr) {
   const excludes = parts.filter((p) => p.startsWith("!")).map((p) => p.slice(1));
   return { includes, excludes };
 }
-function getPathStatus(path3, includes, excludes) {
+function getPathStatus(path4, includes, excludes) {
   for (const pattern of excludes) {
-    if (globMatch(path3, pattern)) {
+    if (globMatch(path4, pattern)) {
       return "EXCLUDE";
     }
   }
@@ -37,7 +41,7 @@ function getPathStatus(path3, includes, excludes) {
   let isIncluded = false;
   let shouldTraverse = false;
   for (const pattern of includes) {
-    const match = checkMatch(path3, pattern);
+    const match = checkMatch(path4, pattern);
     if (match === "FULL") {
       isIncluded = true;
     } else if (match === "PARTIAL") {
@@ -52,11 +56,11 @@ function getPathStatus(path3, includes, excludes) {
   }
   return "SKIP";
 }
-function globMatch(path3, pattern) {
-  return checkMatch(path3, pattern) === "FULL";
+function globMatch(path4, pattern) {
+  return checkMatch(path4, pattern) === "FULL";
 }
-function checkMatch(path3, pattern) {
-  const pathParts = path3.split("/");
+function checkMatch(path4, pattern) {
+  const pathParts = path4.split("/");
   const patternParts = pattern.split("/");
   if (matchSegments(pathParts, patternParts)) {
     return "FULL";
@@ -92,6 +96,25 @@ function matchSegments(pathParts, patternParts) {
   }
   return true;
 }
+function convertForExport(obj) {
+  if (obj === null || obj === void 0) {
+    return obj;
+  }
+  if (typeof obj === "object" && typeof obj.path === "string" && obj.constructor?.name === "DocumentReference") {
+    return { _referencePath: obj.path };
+  }
+  if (Array.isArray(obj)) {
+    return obj.map((item) => convertForExport(item));
+  }
+  if (typeof obj === "object") {
+    const converted = {};
+    for (const [key, value] of Object.entries(obj)) {
+      converted[key] = convertForExport(value);
+    }
+    return converted;
+  }
+  return obj;
+}
 function pLimit(concurrency) {
   const queue = [];
   let activeCount = 0;
@@ -117,10 +140,204 @@ function pLimit(concurrency) {
   };
 }
 
+// cli/docs.ts
+async function docsGet(docId, outputPath, options) {
+  const mode = validateMode(options.mode);
+  const rootDir = process.cwd();
+  const rootConfig = await loadRootConfig(rootDir, { command: "root-cms" });
+  const client = new RootCMSClient(rootConfig);
+  const { collection, slug } = parseDocId(docId);
+  const rawData = await client.getRawDoc(collection, slug, { mode });
+  if (!rawData) {
+    throw new Error(`doc not found: ${docId}`);
+  }
+  const data = options.raw ? rawData : unmarshalData(rawData);
+  const json = JSON.stringify(convertForExport(data), null, 2);
+  if (outputPath) {
+    const resolvedPath = path.resolve(outputPath);
+    const dir = path.dirname(resolvedPath);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(resolvedPath, json);
+    console.error(`Wrote ${docId} to ${resolvedPath}`);
+  } else {
+    process.stdout.write(json + "\n");
+  }
+}
+async function docsSet(docId, filepath, options) {
+  const mode = validateMode(options.mode);
+  const rootDir = process.cwd();
+  const rootConfig = await loadRootConfig(rootDir, { command: "root-cms" });
+  const client = new RootCMSClient(rootConfig);
+  const cmsPlugin = getCmsPlugin(rootConfig);
+  const db = cmsPlugin.getFirestore();
+  let jsonStr;
+  if (filepath) {
+    const filePath = path.resolve(filepath);
+    if (!fs.existsSync(filePath)) {
+      throw new Error(`file not found: ${filePath}`);
+    }
+    jsonStr = fs.readFileSync(filePath, "utf-8");
+  } else {
+    jsonStr = await readStdin();
+  }
+  const rawJson = JSON.parse(jsonStr);
+  const data = convertFirestoreTypes(rawJson, db);
+  const { collection, slug } = parseDocId(docId);
+  await client.setRawDoc(collection, slug, data, { mode });
+  console.log(`Updated ${docId} (${mode})`);
+}
+async function docsDownload(collectionId, outputDirArg, options) {
+  const mode = validateMode(options.mode);
+  const rootDir = process.cwd();
+  const rootConfig = await loadRootConfig(rootDir, { command: "root-cms" });
+  const client = new RootCMSClient(rootConfig);
+  const outputDir = path.resolve(
+    outputDirArg || path.join("dist", collectionId)
+  );
+  if (fs.existsSync(outputDir)) {
+    const entries = fs.readdirSync(outputDir);
+    if (entries.length > 0) {
+      const proceed = await promptYesNo(
+        `Output directory "${outputDir}" is not empty. Delete contents before downloading? (yes/no): `
+      );
+      if (!proceed) {
+        console.log("Download cancelled.");
+        return;
+      }
+      for (const entry of entries) {
+        fs.rmSync(path.join(outputDir, entry), { recursive: true, force: true });
+      }
+    }
+  } else {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+  const { docs } = await client.listDocs(collectionId, {
+    mode,
+    raw: true
+  });
+  if (docs.length === 0) {
+    console.log(`No docs found in collection "${collectionId}" (${mode}).`);
+    return;
+  }
+  for (const doc of docs) {
+    const slug = doc.slug || doc.id?.split("/")[1] || "unknown";
+    const data = convertForExport(doc);
+    const filePath = path.join(outputDir, `${slug}.json`);
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+  }
+  console.log(
+    `Downloaded ${docs.length} doc(s) from "${collectionId}" (${mode}) to ${outputDir}`
+  );
+}
+async function docsUpload(collectionId, dir, options) {
+  const mode = validateMode(options.mode);
+  const rootDir = process.cwd();
+  const rootConfig = await loadRootConfig(rootDir, { command: "root-cms" });
+  const client = new RootCMSClient(rootConfig);
+  const cmsPlugin = getCmsPlugin(rootConfig);
+  const db = cmsPlugin.getFirestore();
+  const inputDir = path.resolve(dir);
+  if (!fs.existsSync(inputDir)) {
+    throw new Error(`directory not found: ${inputDir}`);
+  }
+  const files = fs.readdirSync(inputDir).filter((f) => f.endsWith(".json"));
+  if (files.length === 0) {
+    console.log(`No JSON files found in ${inputDir}.`);
+    return;
+  }
+  let count = 0;
+  for (const file of files) {
+    const slug = path.basename(file, ".json");
+    const filePath = path.join(inputDir, file);
+    const rawJson = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    const data = convertFirestoreTypes(rawJson, db);
+    await client.setRawDoc(collectionId, slug, data, { mode });
+    count++;
+  }
+  console.log(
+    `Uploaded ${count} doc(s) to "${collectionId}" (${mode}) from ${inputDir}`
+  );
+}
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+}
+async function promptYesNo(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      const normalized = answer.trim().toLowerCase();
+      resolve(normalized === "yes" || normalized === "y");
+    });
+  });
+}
+function validateMode(mode) {
+  if (!mode || mode === "draft") {
+    return "draft";
+  }
+  if (mode === "published") {
+    return "published";
+  }
+  throw new Error(`invalid mode: "${mode}". Must be "draft" or "published".`);
+}
+function parseDocId(docId) {
+  const sepIndex = docId.indexOf("/");
+  if (sepIndex <= 0) {
+    throw new Error(
+      `invalid doc id: "${docId}". Expected format: <collection>/<slug>`
+    );
+  }
+  const collection = docId.slice(0, sepIndex);
+  const slug = docId.slice(sepIndex + 1);
+  if (!collection || !slug) {
+    throw new Error(
+      `invalid doc id: "${docId}". Expected format: <collection>/<slug>`
+    );
+  }
+  return { collection, slug };
+}
+function convertFirestoreTypes(obj, db) {
+  if (obj === null || obj === void 0) {
+    return obj;
+  }
+  if (typeof obj === "object" && "_seconds" in obj && "_nanoseconds" in obj && Object.keys(obj).length === 2) {
+    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);
+  }
+  if (typeof obj === "object" && "_referencePath" in obj && Object.keys(obj).length === 1) {
+    return db.doc(obj._referencePath);
+  }
+  if (Array.isArray(obj)) {
+    return obj.map((item) => convertFirestoreTypes(item, db));
+  }
+  if (typeof obj === "object") {
+    const converted = {};
+    for (const [key, value] of Object.entries(obj)) {
+      converted[key] = convertFirestoreTypes(value, db);
+    }
+    return converted;
+  }
+  return obj;
+}
+
 // cli/export.ts
+import fs2 from "fs";
+import path2 from "path";
+import { loadRootConfig as loadRootConfig2 } from "@blinkk/root/node";
 async function exportData(options) {
   const rootDir = process.cwd();
-  const rootConfig = await loadRootConfig(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";
@@ -149,15 +366,15 @@ async function exportData(options) {
     Filter: options.filter || "(none)"
   });
   console.log("");
-  if (!fs.existsSync(exportDir)) {
-    fs.mkdirSync(exportDir, { recursive: true });
+  if (!fs2.existsSync(exportDir)) {
+    fs2.mkdirSync(exportDir, { recursive: true });
   }
   if (!options.filter) {
     const projectDoc = await projectRef.get();
     if (projectDoc.exists) {
       const projectData = projectDoc.data();
-      const projectFilePath = path.join(exportDir, "__data.json");
-      fs.writeFileSync(
+      const projectFilePath = path2.join(exportDir, "__data.json");
+      fs2.writeFileSync(
         projectFilePath,
         JSON.stringify(convertForExport(projectData), null, 2)
       );
@@ -168,7 +385,7 @@ async function exportData(options) {
   for (const collectionType of collectionsToExport) {
     console.log(`Exporting ${collectionType}...`);
     const collectionPath = `Projects/${siteId}/${collectionType}`;
-    const collectionDir = path.join(exportDir, collectionType);
+    const collectionDir = path2.join(exportDir, collectionType);
     await exportCollection(
       db,
       collectionPath,
@@ -231,8 +448,8 @@ async function exportCollection(db, collectionPath, outputDir, displayName, rela
   console.log(`  - ${displayName}: ${stats.count} documents`);
 }
 async function exportCollectionRecursive(db, collectionPath, outputDir, stats, spinner, relativePath, includes, excludes, limit) {
-  if (!fs.existsSync(outputDir)) {
-    fs.mkdirSync(outputDir, { recursive: true });
+  if (!fs2.existsSync(outputDir)) {
+    fs2.mkdirSync(outputDir, { recursive: true });
   }
   const collection = db.collection(collectionPath);
   const refs = await limit(() => collection.listDocuments());
@@ -255,15 +472,15 @@ async function exportCollectionRecursive(db, collectionPath, outputDir, stats, s
         const docData = doc.data();
         let filePath;
         if (hasSubcollections) {
-          const docDir = path.join(outputDir, doc.id);
-          if (!fs.existsSync(docDir)) {
-            fs.mkdirSync(docDir, { recursive: true });
+          const docDir = path2.join(outputDir, doc.id);
+          if (!fs2.existsSync(docDir)) {
+            fs2.mkdirSync(docDir, { recursive: true });
           }
-          filePath = path.join(docDir, "__data.json");
+          filePath = path2.join(docDir, "__data.json");
         } else {
-          filePath = path.join(outputDir, `${doc.id}.json`);
+          filePath = path2.join(outputDir, `${doc.id}.json`);
         }
-        fs.writeFileSync(
+        fs2.writeFileSync(
           filePath,
           JSON.stringify(convertForExport(docData), null, 2)
         );
@@ -276,7 +493,7 @@ async function exportCollectionRecursive(db, collectionPath, outputDir, stats, s
         if (status === "SKIP" || status === "EXCLUDE") {
           continue;
         }
-        const subcollectionDir = path.join(outputDir, ref.id, subcollection.id);
+        const subcollectionDir = path2.join(outputDir, ref.id, subcollection.id);
         await exportCollectionRecursive(
           db,
           subcollection.path,
@@ -300,33 +517,14 @@ function formatTimestamp(date) {
   const minute = String(date.getMinutes()).padStart(2, "0");
   return `${year}${month}${day}t${hour}${minute}`;
 }
-function convertForExport(obj) {
-  if (obj === null || obj === void 0) {
-    return obj;
-  }
-  if (typeof obj === "object" && typeof obj.path === "string" && obj.constructor.name === "DocumentReference") {
-    return { _referencePath: obj.path };
-  }
-  if (Array.isArray(obj)) {
-    return obj.map((item) => convertForExport(item));
-  }
-  if (typeof obj === "object") {
-    const converted = {};
-    for (const [key, value] of Object.entries(obj)) {
-      converted[key] = convertForExport(value);
-    }
-    return converted;
-  }
-  return obj;
-}
 
 // cli/import.ts
-import fs2 from "fs";
-import path2 from "path";
-import * as readline from "readline";
-import { loadRootConfig as loadRootConfig2 } from "@blinkk/root/node";
+import fs3 from "fs";
+import path3 from "path";
+import * as readline2 from "readline";
+import { loadRootConfig as loadRootConfig3 } from "@blinkk/root/node";
 import cliProgress from "cli-progress";
-import { Timestamp, GeoPoint } from "firebase-admin/firestore";
+import { Timestamp as Timestamp2, GeoPoint as GeoPoint2 } from "firebase-admin/firestore";
 async function importData(options) {
   if (!options.dir) {
     throw new Error(
@@ -334,18 +532,18 @@ async function importData(options) {
     );
   }
   const importDir = options.dir;
-  if (!fs2.existsSync(importDir)) {
+  if (!fs3.existsSync(importDir)) {
     throw new Error(`Error: Directory not found: ${importDir}`);
   }
   const rootDir = process.cwd();
-  const rootConfig = await loadRootConfig2(rootDir, { command: "root-cms" });
+  const rootConfig = await loadRootConfig3(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 = fs2.readdirSync(importDir, { withFileTypes: true });
+  const entries = fs3.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) => {
@@ -361,8 +559,8 @@ async function importData(options) {
   }
   const summary = [];
   for (const collectionType of collectionsToImport) {
-    const collectionDir = path2.join(importDir, collectionType);
-    if (fs2.existsSync(collectionDir)) {
+    const collectionDir = path3.join(importDir, collectionType);
+    if (fs3.existsSync(collectionDir)) {
       const count = countJsonFilesRecursive(
         collectionDir,
         collectionType,
@@ -392,7 +590,7 @@ async function importData(options) {
   console.log("");
   console.table(tableData);
   console.log("");
-  const proceed = await promptYesNo("Proceed with import? (yes/no): ");
+  const proceed = await promptYesNo2("Proceed with import? (yes/no): ");
   if (!proceed) {
     console.log("Import cancelled.");
     return;
@@ -401,7 +599,7 @@ async function importData(options) {
   const limit = pLimit(10);
   for (const item of summary) {
     const collectionPath = `Projects/${siteId}/${item.collectionType}`;
-    const collectionDir = path2.join(importDir, item.collectionType);
+    const collectionDir = path3.join(importDir, item.collectionType);
     await importCollection(
       db,
       collectionPath,
@@ -414,11 +612,11 @@ async function importData(options) {
       limit
     );
   }
-  const projectFilePath = path2.join(importDir, "__data.json");
-  if (fs2.existsSync(projectFilePath)) {
+  const projectFilePath = path3.join(importDir, "__data.json");
+  if (fs3.existsSync(projectFilePath)) {
     console.log("Importing project document...");
-    const rawData = JSON.parse(fs2.readFileSync(projectFilePath, "utf-8"));
-    const projectData = convertFirestoreTypes(rawData, db);
+    const rawData = JSON.parse(fs3.readFileSync(projectFilePath, "utf-8"));
+    const projectData = convertFirestoreTypes2(rawData, db);
     const projectPath = `Projects/${siteId}`;
     await db.doc(projectPath).set(projectData, { merge: true });
     console.log("  - Project document updated");
@@ -427,14 +625,14 @@ async function importData(options) {
 }
 function countJsonFilesRecursive(dir, relativePath, includes, excludes) {
   let count = 0;
-  const entries = fs2.readdirSync(dir, { withFileTypes: true });
+  const entries = fs3.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(
-          path2.join(dir, entry.name),
+          path3.join(dir, entry.name),
           subRelativePath,
           includes,
           excludes
@@ -448,7 +646,7 @@ function countJsonFilesRecursive(dir, relativePath, includes, excludes) {
         }
         continue;
       }
-      const docId = path2.basename(entry.name, ".json");
+      const docId = path3.basename(entry.name, ".json");
       const docRelativePath = `${relativePath}/${docId}`;
       const status = getPathStatus(docRelativePath, includes, excludes);
       if (status !== "SKIP" && status !== "EXCLUDE") {
@@ -480,43 +678,43 @@ async function importCollection(db, collectionPath, inputDir, displayName, total
   progressBar.stop();
   console.log(`  - ${displayName}: ${totalDocs} documents`);
 }
-function convertFirestoreTypes(obj, db) {
+function convertFirestoreTypes2(obj, db) {
   if (obj === null || obj === void 0) {
     return obj;
   }
   if (typeof obj === "object" && "_seconds" in obj && "_nanoseconds" in obj && Object.keys(obj).length === 2) {
-    return new Timestamp(obj._seconds, obj._nanoseconds);
+    return new Timestamp2(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);
+    return new GeoPoint2(obj._latitude, obj._longitude);
   }
   if (typeof obj === "object" && "_referencePath" in obj && Object.keys(obj).length === 1) {
     return db.doc(obj._referencePath);
   }
   if (Array.isArray(obj)) {
-    return obj.map((item) => convertFirestoreTypes(item, db));
+    return obj.map((item) => convertFirestoreTypes2(item, db));
   }
   if (typeof obj === "object") {
     const converted = {};
     for (const [key, value] of Object.entries(obj)) {
-      converted[key] = convertFirestoreTypes(value, db);
+      converted[key] = convertFirestoreTypes2(value, db);
     }
     return converted;
   }
   return obj;
 }
 async function importCollectionRecursive(db, collectionPath, inputDir, progressBar, relativePath, includes, excludes, limit) {
-  if (!fs2.existsSync(inputDir)) {
+  if (!fs3.existsSync(inputDir)) {
     return;
   }
-  const entries = fs2.readdirSync(inputDir, { withFileTypes: true });
+  const entries = fs3.readdirSync(inputDir, { withFileTypes: true });
   await Promise.all(
     entries.map(async (entry) => {
       if (entry.isFile() && entry.name.endsWith(".json")) {
         const rawData = JSON.parse(
-          fs2.readFileSync(path2.join(inputDir, entry.name), "utf-8")
+          fs3.readFileSync(path3.join(inputDir, entry.name), "utf-8")
         );
-        const docData = convertFirestoreTypes(rawData, db);
+        const docData = convertFirestoreTypes2(rawData, db);
         if (entry.name === "__data.json") {
           const status = includes && excludes ? getPathStatus(relativePath || "", includes, excludes) : "INCLUDE";
           if (status === "INCLUDE") {
@@ -529,7 +727,7 @@ async function importCollectionRecursive(db, collectionPath, inputDir, progressB
             }
           }
         } else {
-          const docId = path2.basename(entry.name, ".json");
+          const docId = path3.basename(entry.name, ".json");
           const docRelativePath = relativePath ? `${relativePath}/${docId}` : docId;
           const status = includes && excludes ? getPathStatus(docRelativePath, includes, excludes) : "INCLUDE";
           if (status !== "SKIP" && status !== "EXCLUDE") {
@@ -547,7 +745,7 @@ async function importCollectionRecursive(db, collectionPath, inputDir, progressB
         }
       } else if (entry.isDirectory()) {
         const subCollectionPath = `${collectionPath}/${entry.name}`;
-        const subCollectionDir = path2.join(inputDir, entry.name);
+        const subCollectionDir = path3.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") {
@@ -566,8 +764,8 @@ async function importCollectionRecursive(db, collectionPath, inputDir, progressB
     })
   );
 }
-async function promptYesNo(question) {
-  const rl = readline.createInterface({
+async function promptYesNo2(question) {
+  const rl = readline2.createInterface({
     input: process.stdin,
     output: process.stdout
   });
@@ -581,7 +779,7 @@ async function promptYesNo(question) {
 }
 
 // cli/init-firebase.ts
-import { loadRootConfig as loadRootConfig3 } from "@blinkk/root/node";
+import { loadRootConfig as loadRootConfig4 } from "@blinkk/root/node";
 
 // core/security.ts
 import { initializeApp } from "firebase-admin/app";
@@ -659,7 +857,7 @@ async function applySecurityRules(projectId) {
 // cli/init-firebase.ts
 async function initFirebase(options) {
   const rootDir = process.cwd();
-  const rootConfig = await loadRootConfig3(rootDir, { command: "root-cms" });
+  const rootConfig = await loadRootConfig4(rootDir, { command: "root-cms" });
   const cmsPlugin = getCmsPlugin(rootConfig);
   const cmsPluginOptions = cmsPlugin.getConfig();
   const gcpProjectId = options.project || cmsPluginOptions.firebaseConfig.projectId;
@@ -733,11 +931,39 @@ var CliRunner = class {
       "--database <databaseId>",
       'firestore database id (overrides root config, default: "(default)")'
     ).option("--project <projectId>", "gcp project id (overrides root config)").action(importData);
+    program.command("docs.get <docId> [outputPath]").description(
+      "fetches a single doc and outputs it as JSON\n\nIf an output path is provided, writes to a file. Otherwise, writes to stdout.\n\nUsage examples:\n  $ root-cms docs.get Pages/home\n  $ root-cms docs.get Pages/home ./out/home.json\n  $ root-cms docs.get Pages/home --mode published\n  $ root-cms docs.get Pages/home | jq .fields"
+    ).option(
+      "--mode <mode>",
+      'doc mode: "draft" or "published" (default: "draft")'
+    ).option("--raw", "output raw firestore data without unmarshaling").action(docsGet);
+    program.command("docs.set <docId> [filepath]").description(
+      "updates a single doc from a JSON file or stdin\n\nIf a filepath is provided, reads from the file. Otherwise, reads from stdin.\n\nUsage examples:\n  $ root-cms docs.set Pages/home home.json\n  $ root-cms docs.set Pages/home home.json --mode published\n  $ cat data.json | root-cms docs.set Pages/home"
+    ).option(
+      "--mode <mode>",
+      'doc mode: "draft" or "published" (default: "draft")'
+    ).action(docsSet);
+    program.command("docs.download <collection> [outputDir]").description(
+      "downloads all docs in a collection to a local directory\n\nUsage examples:\n  $ root-cms docs.download Pages\n  $ root-cms docs.download Pages ./my-pages\n  $ root-cms docs.download Pages --mode published"
+    ).option(
+      "--mode <mode>",
+      'doc mode: "draft" or "published" (default: "draft")'
+    ).action(docsDownload);
+    program.command("docs.upload <collection> <dir>").description(
+      "uploads docs from a local directory to a collection\n\nUsage examples:\n  $ root-cms docs.upload Pages ./Pages\n  $ root-cms docs.upload Pages ./my-pages --mode published"
+    ).option(
+      "--mode <mode>",
+      'doc mode: "draft" or "published" (default: "draft")'
+    ).action(docsUpload);
     await program.parseAsync(argv);
   }
 };
 export {
   CliRunner,
+  docsDownload,
+  docsGet,
+  docsSet,
+  docsUpload,
   exportData,
   generateTypes,
   importData,

package/dist/{client-C1pZQL7M.d.ts → client-TgoRyFWJ.d.ts}

@@ -1,7 +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-BKfPP_s9.js';
+import { C as Collection } from './schema-Bht24XmU.js';
 
 /**
  * Supported Root AI models. Defaults to 'gemini-3-flash-preview'.
@@ -836,6 +836,10 @@ declare class RootCMSClient {
      * Verifies user exists in the ACL list.
      */
     userExistsInAcl(email: string): Promise<boolean>;
+    /**
+     * Lists action logs from the database.
+     */
+    listActions(options?: ListActionsOptions): Promise<Action[]>;
     logAction(action: string, options?: {
         by?: string;
         metadata?: any;

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import '@blinkk/root';
 import 'firebase-admin/app';
 import 'firebase-admin/firestore';
-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-C1pZQL7M.js';
-import './schema-BKfPP_s9.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-TgoRyFWJ.js';
+import './schema-Bht24XmU.js';

package/dist/client.js

@@ -12,7 +12,7 @@ import {
   translationsForLocale,
   unmarshalArray,
   unmarshalData
-} from "./chunk-XMR3KFP5.js";
+} from "./chunk-UEJ2UTTJ.js";
 import "./chunk-MLKGABMK.js";
 export {
   BatchRequest,