@blinkk/root-cms 2.4.9 → 2.4.10

package/dist/chunk-MLKGABMK.js

@@ -0,0 +1,9 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export {
+  __export
+};

package/dist/chunk-RYF3UTHQ.js

@@ -0,0 +1,302 @@
+// cli/generate-types.ts
+import { promises as fs } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { loadRootConfig, viteSsrLoadModule } from "@blinkk/root/node";
+import * as dom from "dts-dom";
+var __dirname = path.dirname(fileURLToPath(import.meta.url));
+async function generateTypes() {
+  const rootDir = process.cwd();
+  const rootConfig = await loadRootConfig(rootDir, { command: "root-cms" });
+  const modulePath = path.resolve(__dirname, "./project.js");
+  const project = await viteSsrLoadModule(
+    rootConfig,
+    modulePath
+  );
+  const schemas = await project.getProjectSchemas();
+  const outputPath = path.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(path.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 fs.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, "");
+}
+
+export {
+  generateTypes,
+  generateSchemaDts
+};

package/dist/chunk-SI44FG3H.js

@@ -0,0 +1,136 @@
+import {
+  RootCMSClient,
+  getCmsPlugin
+} from "./chunk-62EVNFXB.js";
+
+// core/versions.ts
+import path from "path";
+import { Timestamp } from "firebase-admin/firestore";
+import glob from "tiny-glob";
+var DOCUMENT_SAVE_OFFSET = 5 * 60 * 1e3;
+var VersionsService = class {
+  constructor(rootConfig) {
+    this.rootConfig = rootConfig;
+    const cmsPlugin = getCmsPlugin(rootConfig);
+    const cmsPluginOptions = cmsPlugin.getConfig();
+    const projectId = cmsPluginOptions.id || "default";
+    this.projectId = projectId;
+    this.db = cmsPlugin.getFirestore();
+  }
+  /**
+   * Saves a version of all documents that have been edited since the last run.
+   */
+  async saveVersions() {
+    const lastRun = await this.getLastRun();
+    const lastRunWithOffset = lastRun === 0 ? lastRun : lastRun - DOCUMENT_SAVE_OFFSET;
+    const changedDocs = await this.getDocsModifiedAfter(lastRunWithOffset);
+    const now = Timestamp.now().toMillis();
+    const versions = changedDocs.filter((doc) => {
+      const modifiedAt = doc.sys.modifiedAt.toMillis();
+      return modifiedAt <= now - DOCUMENT_SAVE_OFFSET;
+    });
+    if (versions.length > 0) {
+      this.saveVersionsToFirestore(versions);
+    }
+    this.saveLastRun(now);
+  }
+  async saveVersionsToFirestore(versions) {
+    const batch = this.db.batch();
+    versions.forEach((version) => {
+      if (!version.collection || !version.slug || !version.sys?.modifiedAt) {
+        return;
+      }
+      const modifiedAtMillis = version.sys.modifiedAt.toMillis();
+      const versionPath = `Projects/${this.projectId}/Collections/${version.collection}/Drafts/${version.slug}/Versions/${modifiedAtMillis}`;
+      console.log(versionPath);
+      const versionRef = this.db.doc(versionPath);
+      batch.set(versionRef, version);
+    });
+    await batch.commit();
+    console.log(`versions: saved ${versions.length} versions`);
+  }
+  /**
+   * Returns the last time (in millis) saveVersions() was run, or 0 if has
+   * never been run.
+   */
+  async getLastRun() {
+    const projectDocRef = this.db.collection("Projects").doc(this.projectId);
+    const projectDoc = await projectDocRef.get();
+    if (projectDoc.exists) {
+      const data = projectDoc.data() || {};
+      const ts = data.versionsLastRun;
+      if (ts) {
+        return ts.toMillis();
+      }
+    }
+    return 0;
+  }
+  /**
+   * Saves {versionLastRun: <timestamp>} to the Projects/<projectId> doc.
+   */
+  async saveLastRun(millis) {
+    const ts = Timestamp.fromMillis(millis);
+    const projectDocRef = this.db.collection("Projects").doc(this.projectId);
+    await projectDocRef.set({ versionsLastRun: ts }, { merge: true });
+  }
+  /**
+   * Returns a list of all docs that were edited after a certain time.
+   */
+  async getDocsModifiedAfter(millis) {
+    const ts = Timestamp.fromMillis(millis);
+    const results = [];
+    const collectionIds = await this.listCollections();
+    for (const collectionId of collectionIds) {
+      const collectionPath = `Projects/${this.projectId}/Collections/${collectionId}/Drafts`;
+      const query = this.db.collection(collectionPath).where("sys.modifiedAt", ">=", ts);
+      const querySnapshot = await query.get();
+      querySnapshot.forEach((doc) => {
+        results.push(doc.data());
+      });
+    }
+    return results;
+  }
+  /**
+   * Returns a list of collection ids for the Root project.
+   */
+  async listCollections() {
+    const collectionIds = [];
+    const collectionFileNames = await glob("*.schema.ts", {
+      cwd: path.join(this.rootConfig.rootDir, "collections")
+    });
+    collectionFileNames.forEach((filename) => {
+      collectionIds.push(filename.slice(0, -10));
+    });
+    return collectionIds;
+  }
+};
+
+// core/cron.ts
+async function runCronJobs(rootConfig) {
+  await Promise.all([
+    runCronJob("publishScheduledDocs", runPublishScheduledDocs, rootConfig),
+    runCronJob("saveVersions", runSaveVersions, rootConfig)
+  ]);
+}
+async function runCronJob(name, fn, ...args) {
+  try {
+    await fn(...args);
+  } catch (err) {
+    console.log(`cron failed: ${name}`);
+    console.error(String(err.stack || err));
+    throw err;
+  }
+}
+async function runPublishScheduledDocs(rootConfig) {
+  const cmsClient = new RootCMSClient(rootConfig);
+  await cmsClient.publishScheduledDocs();
+  await cmsClient.publishScheduledReleases();
+}
+async function runSaveVersions(rootConfig) {
+  const service = new VersionsService(rootConfig);
+  await service.saveVersions();
+}
+
+export {
+  runCronJobs
+};

package/dist/chunk-Y65VGJLE.js

@@ -0,0 +1,193 @@
+// package.json
+var package_default = {
+  name: "@blinkk/root-cms",
+  version: "2.4.10",
+  author: "s@blinkk.com",
+  license: "MIT",
+  engines: {
+    node: ">=16.0.0"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/blinkk/rootjs.git",
+    directory: "packages/root-cms"
+  },
+  files: [
+    "dist/**/*"
+  ],
+  bin: {
+    "root-cms": "./bin/root-cms.js"
+  },
+  type: "module",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/core.d.ts",
+      import: "./dist/core.js"
+    },
+    "./client": {
+      types: "./dist/client.d.ts",
+      import: "./dist/client.js"
+    },
+    "./core": {
+      types: "./dist/core.d.ts",
+      import: "./dist/core.js"
+    },
+    "./functions": {
+      types: "./dist/functions.d.ts",
+      import: "./dist/functions.js"
+    },
+    "./plugin": {
+      types: "./dist/plugin.d.ts",
+      import: "./dist/plugin.js"
+    },
+    "./project": {
+      types: "./dist/project.d.ts",
+      import: "./dist/project.js"
+    },
+    "./richtext": {
+      types: "./dist/richtext.d.ts",
+      import: "./dist/richtext.js"
+    }
+  },
+  scripts: {
+    build: 'rm -rf dist && concurrently -n "core,signin,ui" npm:build:core npm:build:signin npm:build:ui',
+    "build:core": "tsup-node --config=./core/tsup.config.ts",
+    "//": "NOTE: esbuild is used here because tsup doesn't currently support aliases.",
+    "build:ui": "esbuild ui/ui.tsx --bundle --minify --alias:react=@preact/compat --alias:react-dom=@preact/compat --tsconfig=ui/tsconfig.json --outdir=dist/ui --legal-comments=external",
+    "build:signin": "esbuild signin/signin.tsx --bundle --minify --tsconfig=signin/tsconfig.json --outdir=dist/ui --legal-comments=external",
+    dev: 'rm -rf dist && concurrently -k -n "core,ui" npm:dev:core npm:dev:signin npm:dev:ui',
+    "dev:core": "pnpm build:core --watch",
+    "dev:signin": "pnpm build:signin --watch",
+    "dev:ui": "pnpm build:ui --watch",
+    test: "pnpm build && firebase emulators:exec 'vitest run --exclude=**/*.visual.test.tsx'",
+    "test:visual": "vitest run --config=vitest.config.visual.ts",
+    "test:watch": "pnpm build && firebase emulators:exec 'vitest'"
+  },
+  dependencies: {
+    "@ag-grid-community/client-side-row-model": "32.3.9",
+    "@ag-grid-community/core": "32.3.9",
+    "@ag-grid-community/react": "32.3.9",
+    "@ag-grid-community/styles": "32.3.9",
+    "@genkit-ai/ai": "1.26.0",
+    "@genkit-ai/core": "1.26.0",
+    "@genkit-ai/google-genai": "1.26.0",
+    "@google-cloud/firestore": "7.11.3",
+    "@hello-pangea/dnd": "18.0.1",
+    "@types/cli-progress": "3.11.6",
+    "body-parser": "1.20.2",
+    "cli-progress": "3.12.0",
+    commander: "11.0.0",
+    "csv-parse": "5.5.2",
+    "csv-stringify": "6.4.4",
+    "date-fns": "4.1.0",
+    "date-fns-tz": "3.2.0",
+    diff: "8.0.2",
+    "dts-dom": "3.7.0",
+    "fnv-plus": "1.3.1",
+    genkit: "1.26.0",
+    jsonwebtoken: "9.0.2",
+    kleur: "4.1.5",
+    "react-easy-crop": "5.5.6",
+    sirv: "2.0.3",
+    "tiny-glob": "0.2.9"
+  },
+  "//": "NOTE(stevenle): due to compat issues with mantine and preact, mantine is pinned to v4.2.12",
+  devDependencies: {
+    "@babel/core": "7.17.9",
+    "@blinkk/root": "workspace:*",
+    "@editorjs/editorjs": "2.30.8",
+    "@editorjs/header": "2.8.8",
+    "@editorjs/image": "2.10.2",
+    "@editorjs/list": "2.0.6",
+    "@editorjs/nested-list": "1.4.3",
+    "@editorjs/raw": "2.5.1",
+    "@editorjs/table": "2.4.4",
+    "@editorjs/underline": "1.2.1",
+    "@emotion/react": "11.10.5",
+    "@firebase/app-compat": "0.5.2",
+    "@firebase/app-types": "0.9.3",
+    "@firebase/rules-unit-testing": "5.0.0",
+    "@lexical/code": "0.33.1",
+    "@lexical/html": "0.33.1",
+    "@lexical/link": "0.33.1",
+    "@lexical/list": "0.33.1",
+    "@lexical/markdown": "0.33.1",
+    "@lexical/react": "0.33.1",
+    "@lexical/rich-text": "0.33.1",
+    "@lexical/selection": "0.33.1",
+    "@lexical/table": "0.33.1",
+    "@lexical/utils": "0.33.1",
+    "@mantine/core": "4.2.12",
+    "@mantine/hooks": "4.2.12",
+    "@mantine/modals": "4.2.12",
+    "@mantine/notifications": "4.2.12",
+    "@mantine/spotlight": "4.2.12",
+    "@preact/compat": "18.3.1",
+    "@tabler/icons-preact": "3.35.0",
+    "@testing-library/preact": "3.2.4",
+    "@testing-library/user-event": "14.6.1",
+    "@types/body-parser": "1.19.3",
+    "@types/fnv-plus": "1.3.2",
+    "@types/gapi": "0.0.47",
+    "@types/gapi.client.drive-v3": "0.0.4",
+    "@types/gapi.client.sheets-v4": "0.0.4",
+    "@types/google.accounts": "0.0.14",
+    "@types/jsonwebtoken": "9.0.1",
+    "@types/node": "24.3.1",
+    "@vitest/browser": "4.0.10",
+    "@vitest/browser-playwright": "4.0.10",
+    concurrently: "7.6.0",
+    esbuild: "0.25.9",
+    firebase: "12.2.1",
+    "firebase-admin": "13.5.0",
+    "firebase-functions": "6.4.0",
+    "firebase-tools": "14.15.2",
+    "highlight.js": "11.6.0",
+    jsdom: "27.2.0",
+    "json-diff-kit": "1.0.29",
+    lexical: "0.33.1",
+    marked: "9.1.1",
+    "mdast-util-from-markdown": "2.0.1",
+    "mdast-util-gfm": "3.0.0",
+    "micromark-extension-gfm": "3.0.0",
+    playwright: "1.56.1",
+    preact: "10.27.1",
+    "preact-render-to-string": "6.6.1",
+    "preact-router": "4.1.2",
+    react: "npm:@preact/compat@18.3.1",
+    "react-dom": "npm:@preact/compat@18.3.1",
+    "react-json-view-compare": "2.0.2",
+    tsup: "8.5.0",
+    typescript: "5.9.2",
+    vite: "7.1.4",
+    vitest: "4.0.10",
+    yjs: "13.6.27"
+  },
+  peerDependencies: {
+    "@blinkk/root": "2.4.10",
+    "firebase-admin": ">=11",
+    "firebase-functions": ">=4",
+    preact: ">=10",
+    "preact-render-to-string": ">=5"
+  },
+  peerDependenciesMeta: {
+    "firebase-functions": {
+      optional: true
+    }
+  }
+};
+
+// core/server-version.ts
+var SERVER_STARTUP_TS = String(Math.floor((/* @__PURE__ */ new Date()).getTime() / 1e3));
+function getServerVersion() {
+  if (process.env.NODE_ENV === "development") {
+    return SERVER_STARTUP_TS;
+  }
+  return package_default?.version || "root-3.0.0";
+}
+
+export {
+  getServerVersion
+};