@tinacms/graphql 0.0.0-c8b1d84-20241003015733 → 0.0.0-cef656e-20250119001929

package/dist/index.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -130,6 +134,15 @@ var SysFieldDefinition = {
   selectionSet: {
     kind: "SelectionSet",
     selections: [
+      // {
+      //   kind: 'Field' as const,
+      //   name: {
+      //     kind: 'Name' as const,
+      //     value: 'title',
+      //   },
+      //   arguments: [],
+      //   directives: [],
+      // },
       {
         kind: "Field",
         name: {
@@ -148,6 +161,15 @@ var SysFieldDefinition = {
         arguments: [],
         directives: []
       },
+      {
+        kind: "Field",
+        name: {
+          kind: "Name",
+          value: "hasReferences"
+        },
+        arguments: [],
+        directives: []
+      },
       {
         kind: "Field",
         name: {
@@ -188,6 +210,10 @@ var SysFieldDefinition = {
   }
 };
 var astBuilder = {
+  /**
+   * `FormFieldBuilder` acts as a shortcut to building an entire `ObjectTypeDefinition`, we use this
+   * because all Tina field objects share a common set of fields ('name', 'label', 'component')
+   */
   FormFieldBuilder: ({
     name,
     additionalFields
@@ -411,6 +437,8 @@ var astBuilder = {
       kind: "Name",
       value: name
     },
+    // @ts-ignore FIXME; this is being handled properly but we're lying to
+    // ts and then fixing it in the `extractInlineTypes` function
     fields
   }),
   UnionTypeDefinition: ({
@@ -423,6 +451,8 @@ var astBuilder = {
       value: name
     },
     directives: [],
+    // @ts-ignore FIXME; this is being handled properly but we're lying to
+    // ts and then fixing it in the `extractInlineTypes` function
     types: types.map((name2) => ({
       kind: "NamedType",
       name: {
@@ -519,8 +549,11 @@ var astBuilder = {
         string: "String",
         boolean: "Boolean",
         number: "Float",
+        // FIXME - needs to be float or int
         datetime: "String",
+        // FIXME
         image: "String",
+        // FIXME
         text: "String"
       };
       return scalars[type];
@@ -1019,8 +1052,7 @@ var astBuilder = {
   }
 };
 var capitalize = (s) => {
-  if (typeof s !== "string")
-    return "";
+  if (typeof s !== "string") return "";
   return s.charAt(0).toUpperCase() + s.slice(1);
 };
 var extractInlineTypes = (item) => {
@@ -1063,41 +1095,6 @@ function* walk(maybeNode, visited = /* @__PURE__ */ new WeakSet()) {
   yield maybeNode;
   visited.add(maybeNode);
 }
-function addNamespaceToSchema(maybeNode, namespace = []) {
-  if (typeof maybeNode === "string") {
-    return maybeNode;
-  }
-  if (typeof maybeNode === "boolean") {
-    return maybeNode;
-  }
-  const newNode = maybeNode;
-  const keys = Object.keys(maybeNode);
-  Object.values(maybeNode).map((m, index) => {
-    const key = keys[index];
-    if (Array.isArray(m)) {
-      newNode[key] = m.map((element) => {
-        if (!element) {
-          return;
-        }
-        if (!element.hasOwnProperty("name")) {
-          return element;
-        }
-        const value = element.name || element.value;
-        return addNamespaceToSchema(element, [...namespace, value]);
-      });
-    } else {
-      if (!m) {
-        return;
-      }
-      if (!m.hasOwnProperty("name")) {
-        newNode[key] = m;
-      } else {
-        newNode[key] = addNamespaceToSchema(m, [...namespace, m.name]);
-      }
-    }
-  });
-  return { ...newNode, namespace };
-}
 var generateNamespacedFieldName = (names, suffix = "") => {
   return (suffix ? [...names, suffix] : names).map(capitalize).join("");
 };
@@ -1257,6 +1254,11 @@ var scalarDefinitions = [
         required: true,
         type: astBuilder.TYPES.String
       }),
+      astBuilder.FieldDefinition({
+        name: "hasReferences",
+        required: false,
+        type: astBuilder.TYPES.Boolean
+      }),
       astBuilder.FieldDefinition({
         name: "breadcrumbs",
         required: true,
@@ -1471,6 +1473,19 @@ var Builder = class {
     this.addToLookupMap = (lookup) => {
       this.lookupMap[lookup.type] = lookup;
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   getCollection(collection: $collection) {
+     *     name
+     *     documents {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collections
+     */
     this.buildCollectionDefinition = async (collections) => {
       const name = "collection";
       const typeName = "Collection";
@@ -1541,6 +1556,19 @@ var Builder = class {
         required: true
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   getCollections {
+     *     name
+     *     documents {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collections
+     */
     this.buildMultiCollectionDefinition = async (collections) => {
       const name = "collections";
       const typeName = "Collection";
@@ -1551,6 +1579,17 @@ var Builder = class {
         required: true
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   node(id: $id) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     */
     this.multiNodeDocument = async () => {
       const name = "node";
       const args = [
@@ -1571,6 +1610,19 @@ var Builder = class {
         required: true
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   getDocument(collection: $collection, relativePath: $relativePath) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collections
+     */
     this.multiCollectionDocument = async (collections) => {
       const name = "document";
       const args = [
@@ -1596,6 +1648,19 @@ var Builder = class {
         required: true
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   addPendingDocument(collection: $collection, relativePath: $relativePath, params: $params) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collections
+     */
     this.addMultiCollectionDocumentMutation = async () => {
       return astBuilder.FieldDefinition({
         name: "addPendingDocument",
@@ -1620,6 +1685,19 @@ var Builder = class {
         type: astBuilder.TYPES.MultiCollectionDocument
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   createDocument(relativePath: $relativePath, params: $params) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collections
+     */
     this.buildCreateCollectionDocumentMutation = async (collections) => {
       return astBuilder.FieldDefinition({
         name: "createDocument",
@@ -1647,6 +1725,19 @@ var Builder = class {
         type: astBuilder.TYPES.MultiCollectionDocument
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   updateDocument(relativePath: $relativePath, params: $params) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collections
+     */
     this.buildUpdateCollectionDocumentMutation = async (collections) => {
       return astBuilder.FieldDefinition({
         name: "updateDocument",
@@ -1674,6 +1765,19 @@ var Builder = class {
         type: astBuilder.TYPES.MultiCollectionDocument
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   deleteDocument(relativePath: $relativePath, params: $params) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collections
+     */
     this.buildDeleteCollectionDocumentMutation = async (collections) => {
       return astBuilder.FieldDefinition({
         name: "deleteDocument",
@@ -1693,6 +1797,19 @@ var Builder = class {
         type: astBuilder.TYPES.MultiCollectionDocument
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   createFolder(folderName: $folderName, params: $params) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collections
+     */
     this.buildCreateCollectionFolderMutation = async () => {
       return astBuilder.FieldDefinition({
         name: "createFolder",
@@ -1712,6 +1829,19 @@ var Builder = class {
         type: astBuilder.TYPES.MultiCollectionDocument
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   getPostDocument(relativePath: $relativePath) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collection
+     */
     this.collectionDocument = async (collection) => {
       const name = NAMER.queryName([collection.name]);
       const type = await this._buildCollectionDocumentType(collection);
@@ -1772,6 +1902,20 @@ var Builder = class {
       const args = [];
       return astBuilder.FieldDefinition({ type, name, args, required: false });
     };
+    /**
+     * Turns a collection into a fragment that gets updated on build. This fragment does not resolve references
+     * ```graphql
+     * # ex.
+     * fragment AuthorsParts on Authors {
+     *   name
+     *   avatar
+     *   ...
+     * }
+     * ```
+     *
+     * @public
+     * @param collection a Tina Cloud collection
+     */
     this.collectionFragment = async (collection) => {
       const name = NAMER.dataTypeName(collection.namespace);
       const fragmentName = NAMER.fragmentName(collection.namespace);
@@ -1785,6 +1929,20 @@ var Builder = class {
         selections: filterSelections(selections)
       });
     };
+    /**
+     * Given a collection this function returns its selections set. For example for Post this would return
+     *
+     * "
+     * body
+     * title
+     * ... on Author {
+     *   name
+     *   heroImg
+     * }
+     *
+     * But in the AST format
+     *
+     * */
     this._getCollectionFragmentSelections = async (collection, depth) => {
       var _a;
       const selections = [];
@@ -1868,9 +2026,9 @@ var Builder = class {
               ]
             });
           }
+        // TODO: Should we throw here?
         case "reference":
-          if (depth >= this.maxDepth)
-            return false;
+          if (depth >= this.maxDepth) return false;
           if (!("collections" in field)) {
             return false;
           }
@@ -1902,6 +2060,7 @@ var Builder = class {
             name: field.name,
             selections: [
               ...selections,
+              // This is ... on Document { id }
               {
                 kind: "InlineFragment",
                 typeCondition: {
@@ -1932,6 +2091,19 @@ var Builder = class {
           });
       }
     };
+    /**
+     * ```graphql
+     * # ex.
+     * mutation {
+     *   updatePostDocument(relativePath: $relativePath, params: $params) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collection
+     */
     this.updateCollectionDocumentMutation = async (collection) => {
       return astBuilder.FieldDefinition({
         type: await this._buildCollectionDocumentType(collection),
@@ -1951,6 +2123,19 @@ var Builder = class {
         ]
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * mutation {
+     *   createPostDocument(relativePath: $relativePath, params: $params) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collection
+     */
     this.createCollectionDocumentMutation = async (collection) => {
       return astBuilder.FieldDefinition({
         type: await this._buildCollectionDocumentType(collection),
@@ -1970,6 +2155,22 @@ var Builder = class {
         ]
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   getPostList(first: 10) {
+     *     edges {
+     *       node {
+     *         id
+     *       }
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * @param collection
+     */
     this.collectionDocumentList = async (collection) => {
       const connectionName = NAMER.referenceConnectionType(collection.namespace);
       this.addToLookupMap({
@@ -1985,6 +2186,10 @@ var Builder = class {
         collection
       });
     };
+    /**
+     * GraphQL type definitions which remain unchanged regardless
+     * of the supplied Tina schema. Ex. "node" interface
+     */
     this.buildStaticDefinitions = () => staticDefinitions;
     this._buildCollectionDocumentType = async (collection, suffix = "", extraFields = [], extraInterfaces = []) => {
       const documentTypeName = NAMER.documentTypeName(collection.namespace);
@@ -2489,6 +2694,7 @@ var Builder = class {
             name: NAMER.dataFilterTypeName(namespace),
             fields: await sequential(collections, async (collection2) => {
               return astBuilder.InputValueDefinition({
+                // @ts-ignore
                 name: collection2.name,
                 type: NAMER.dataFilterTypeName(collection2.namespace)
               });
@@ -2678,7 +2884,8 @@ Visit https://tina.io/docs/errors/ui-not-supported/ for more information
       });
     };
     var _a, _b, _c, _d;
-    this.maxDepth = (_d = (_c = (_b = (_a = config == null ? void 0 : config.tinaSchema.schema) == null ? void 0 : _a.config) == null ? void 0 : _b.client) == null ? void 0 : _c.referenceDepth) != null ? _d : 2;
+    this.maxDepth = // @ts-ignore
+    (_d = (_c = (_b = (_a = config == null ? void 0 : config.tinaSchema.schema) == null ? void 0 : _a.config) == null ? void 0 : _b.client) == null ? void 0 : _c.referenceDepth) != null ? _d : 2;
     this.tinaSchema = config.tinaSchema;
     this.lookupMap = {};
   }
@@ -2689,8 +2896,7 @@ Visit https://tina.io/docs/errors/ui-not-supported/ for more information
       selections.push(field);
     });
     const filteredSelections = filterSelections(selections);
-    if (!filteredSelections.length)
-      return false;
+    if (!filteredSelections.length) return false;
     return astBuilder.InlineFragmentDefinition({
       selections: filteredSelections,
       name: NAMER.dataTypeName(template.namespace)
@@ -2724,12 +2930,13 @@ var filterSelections = (arr) => {
 };
 
 // src/schema/createSchema.ts
-var import_schema_tools2 = require("@tinacms/schema-tools");
+var import_schema_tools3 = require("@tinacms/schema-tools");
 
 // src/schema/validate.ts
+var import_schema_tools = require("@tinacms/schema-tools");
 var import_lodash2 = __toESM(require("lodash.clonedeep"));
 var yup2 = __toESM(require("yup"));
-var import_schema_tools = require("@tinacms/schema-tools");
+var import_schema_tools2 = require("@tinacms/schema-tools");
 var FIELD_TYPES = [
   "string",
   "number",
@@ -2742,7 +2949,7 @@ var FIELD_TYPES = [
   "password"
 ];
 var validateSchema = async (schema) => {
-  const schema2 = addNamespaceToSchema(
+  const schema2 = (0, import_schema_tools.addNamespaceToSchema)(
     (0, import_lodash2.default)(schema)
   );
   const collections = await sequential(
@@ -2751,7 +2958,7 @@ var validateSchema = async (schema) => {
   );
   validationCollectionsPathAndMatch(collections);
   if (schema2.config) {
-    const config = (0, import_schema_tools.validateTinaCloudSchemaConfig)(schema2.config);
+    const config = (0, import_schema_tools2.validateTinaCloudSchemaConfig)(schema2.config);
     return {
       collections,
       config
@@ -2771,6 +2978,7 @@ var validationCollectionsPathAndMatch = (collections) => {
   }).map((x) => `${x.path}${x.format || "md"}`);
   if (noMatchCollections.length !== new Set(noMatchCollections).size) {
     throw new Error(
+      // TODO: add a link to the docs
       "Two collections without match can not have the same `path`. Please make the `path` unique or add a matches property to the collection."
     );
   }
@@ -2882,7 +3090,7 @@ var validateField = async (field) => {
 // package.json
 var package_default = {
   name: "@tinacms/graphql",
-  version: "1.5.4",
+  version: "1.5.10",
   main: "dist/index.js",
   module: "dist/index.mjs",
   typings: "dist/index.d.ts",
@@ -2909,8 +3117,7 @@ var package_default = {
     build: "tinacms-scripts build",
     docs: "pnpm typedoc",
     serve: "pnpm nodemon dist/server.js",
-    test: "jest",
-    "test-watch": "jest --watch"
+    test: "vitest"
   },
   dependencies: {
     "@iarna/toml": "^2.2.5",
@@ -2926,7 +3133,7 @@ var package_default = {
     "isomorphic-git": "^1.27.1",
     "js-sha1": "^0.6.0",
     "js-yaml": "^3.14.1",
-    "jsonpath-plus": "^6.0.1",
+    "jsonpath-plus": "10.1.0",
     "lodash.clonedeep": "^4.5.0",
     "lodash.set": "^4.3.2",
     "lodash.uniqby": "^4.7.0",
@@ -2951,24 +3158,23 @@ var package_default = {
     "@types/estree": "^0.0.50",
     "@types/express": "^4.17.21",
     "@types/fs-extra": "^9.0.13",
-    "@types/jest": "^26.0.24",
     "@types/js-yaml": "^3.12.10",
     "@types/lodash.camelcase": "^4.3.9",
     "@types/lodash.upperfirst": "^4.3.9",
     "@types/lru-cache": "^5.1.1",
     "@types/mdast": "^3.0.15",
     "@types/micromatch": "^4.0.9",
-    "@types/node": "^22.7.4",
+    "@types/node": "^22.9.0",
     "@types/normalize-path": "^3.0.2",
     "@types/ws": "^7.4.7",
     "@types/yup": "^0.29.14",
-    jest: "^29.7.0",
-    "jest-diff": "^29.7.0",
     "jest-file-snapshot": "^0.5.0",
-    "jest-matcher-utils": "^29.7.0",
     "memory-level": "^1.0.0",
     nodemon: "3.1.4",
-    typescript: "^5.6.2"
+    typescript: "^5.6.3",
+    vite: "^4.3.9",
+    vitest: "^0.32.2",
+    zod: "^3.23.8"
   }
 };
 
@@ -2983,7 +3189,7 @@ var createSchema = async ({
   if (flags && flags.length > 0) {
     meta["flags"] = flags;
   }
-  return new import_schema_tools2.TinaSchema({
+  return new import_schema_tools3.TinaSchema({
     version: {
       fullVersion: package_default.version,
       major,
@@ -3039,6 +3245,7 @@ var _buildFragments = async (builder, tinaSchema) => {
   const fragDoc = {
     kind: "Document",
     definitions: (0, import_lodash3.default)(
+      // @ts-ignore
       extractInlineTypes(fragmentDefinitionsFields),
       (node) => node.name.value
     )
@@ -3062,6 +3269,7 @@ var _buildQueries = async (builder, tinaSchema) => {
         fragName,
         queryName: queryListName,
         filterType: queryFilterTypeName,
+        // look for flag to see if the data layer is enabled
         dataLayer: Boolean(
           (_c = (_b = (_a = tinaSchema.config) == null ? void 0 : _a.meta) == null ? void 0 : _b.flags) == null ? void 0 : _c.find((x) => x === "experimentalData")
         )
@@ -3071,6 +3279,7 @@ var _buildQueries = async (builder, tinaSchema) => {
   const queryDoc = {
     kind: "Document",
     definitions: (0, import_lodash3.default)(
+      // @ts-ignore
       extractInlineTypes(operationsDefinitions),
       (node) => node.name.value
     )
@@ -3159,6 +3368,7 @@ var _buildSchema = async (builder, tinaSchema) => {
   return {
     kind: "Document",
     definitions: (0, import_lodash3.default)(
+      // @ts-ignore
       extractInlineTypes(definitions),
       (node) => node.name.value
     )
@@ -3175,6 +3385,9 @@ var import_isValid = __toESM(require("date-fns/isValid/index.js"));
 // src/mdx/index.ts
 var import_mdx = require("@tinacms/mdx");
 
+// src/resolver/index.ts
+var import_jsonpath_plus2 = require("jsonpath-plus");
+
 // src/resolver/error.ts
 var TinaGraphQLError = class extends Error {
   constructor(message, extensions) {
@@ -3360,8 +3573,7 @@ var resolveMediaCloudToRelative = (value, config = { useRelativeMedia: true }, s
       }
       if (Array.isArray(value)) {
         return value.map((v) => {
-          if (!v || typeof v !== "string")
-            return v;
+          if (!v || typeof v !== "string") return v;
           const cleanMediaRoot = cleanUpSlashes(
             schema.config.media.tina.mediaRoot
           );
@@ -3389,8 +3601,7 @@ var resolveMediaRelativeToCloud = (value, config = { useRelativeMedia: true }, s
       }
       if (Array.isArray(value)) {
         return value.map((v) => {
-          if (!v || typeof v !== "string")
-            return v;
+          if (!v || typeof v !== "string") return v;
           const strippedValue = v.replace(cleanMediaRoot, "");
           return `https://${config.assetsHost}/${config.clientId}${strippedValue}`;
         });
@@ -3409,8 +3620,7 @@ var cleanUpSlashes = (path7) => {
 };
 var hasTinaMediaConfig = (schema) => {
   var _a, _b, _c, _d, _e, _f, _g, _h;
-  if (!((_b = (_a = schema.config) == null ? void 0 : _a.media) == null ? void 0 : _b.tina))
-    return false;
+  if (!((_b = (_a = schema.config) == null ? void 0 : _a.media) == null ? void 0 : _b.tina)) return false;
   if (typeof ((_e = (_d = (_c = schema.config) == null ? void 0 : _c.media) == null ? void 0 : _d.tina) == null ? void 0 : _e.publicFolder) !== "string" && typeof ((_h = (_g = (_f = schema.config) == null ? void 0 : _f.media) == null ? void 0 : _g.tina) == null ? void 0 : _h.mediaRoot) !== "string")
     return false;
   return true;
@@ -3454,6 +3664,7 @@ var LevelProxyHandler = {
     } else if (property === "sublevel") {
       return (...args) => {
         return new Proxy(
+          // eslint-disable-next-line prefer-spread
           target[property].apply(target, args),
           LevelProxyHandler
         );
@@ -3476,7 +3687,7 @@ var import_path2 = __toESM(require("path"));
 var import_toml = __toESM(require("@iarna/toml"));
 var import_js_yaml = __toESM(require("js-yaml"));
 var import_gray_matter = __toESM(require("gray-matter"));
-var import_schema_tools3 = require("@tinacms/schema-tools");
+var import_schema_tools4 = require("@tinacms/schema-tools");
 var import_micromatch = __toESM(require("micromatch"));
 var import_path = __toESM(require("path"));
 
@@ -3689,7 +3900,7 @@ var scanAllContent = async (tinaSchema, bridge, callback) => {
   const filesSeen = /* @__PURE__ */ new Map();
   const duplicateFiles = /* @__PURE__ */ new Set();
   await sequential(tinaSchema.getCollections(), async (collection) => {
-    const normalPath = (0, import_schema_tools3.normalizePath)(collection.path);
+    const normalPath = (0, import_schema_tools4.normalizePath)(collection.path);
     const format = collection.format || "md";
     const documentPaths = await bridge.glob(normalPath, format);
     const matches = tinaSchema.getMatches({ collection });
@@ -3801,7 +4012,7 @@ var getTemplateForFile = (templateInfo, data) => {
   throw new Error(`Unable to determine template`);
 };
 var loadAndParseWithAliases = async (bridge, filepath, collection, templateInfo) => {
-  const dataString = await bridge.get((0, import_schema_tools3.normalizePath)(filepath));
+  const dataString = await bridge.get((0, import_schema_tools4.normalizePath)(filepath));
   const data = parseFile(
     dataString,
     import_path.default.extname(filepath),
@@ -4280,7 +4491,7 @@ var FolderTreeBuilder = class {
     return this._tree;
   }
   update(documentPath, collectionPath) {
-    let folderPath = import_path2.default.dirname((0, import_schema_tools3.normalizePath)(documentPath));
+    let folderPath = import_path2.default.dirname((0, import_schema_tools4.normalizePath)(documentPath));
     if (folderPath === ".") {
       folderPath = "";
     }
@@ -4293,7 +4504,7 @@ var FolderTreeBuilder = class {
       if (!this._tree[current2]) {
         this._tree[current2] = /* @__PURE__ */ new Set();
       }
-      this._tree[current2].add((0, import_schema_tools3.normalizePath)(import_path2.default.join(current2, part)));
+      this._tree[current2].add((0, import_schema_tools4.normalizePath)(import_path2.default.join(current2, part)));
       parent.push(part);
     });
     const current = parent.join("/");
@@ -4332,6 +4543,7 @@ var makeFolderOpsForCollection = (folderTree, collection, indexDefinitions, opTy
           result.push({
             type: opType,
             key: `${collection.path}/${subFolderKey}.${collection.format}`,
+            // replace the root with the collection path
             sublevel: indexSublevel,
             value: {}
           });
@@ -4419,8 +4631,17 @@ var stringEscaper = makeStringEscaper(
 var createResolver = (args) => {
   return new Resolver(args);
 };
-var resolveFieldData = async ({ namespace, ...field }, rawData, accumulator, tinaSchema, config, isAudit) => {
+var resolveFieldData = async (args) => {
   var _a, _b;
+  const {
+    field: { namespace, ...field },
+    rawData,
+    accumulator,
+    tinaSchema,
+    config,
+    isAudit,
+    context
+  } = args;
   if (!rawData) {
     return void 0;
   }
@@ -4447,6 +4668,7 @@ var resolveFieldData = async ({ namespace, ...field }, rawData, accumulator, tin
     case "password":
       accumulator[field.name] = {
         value: void 0,
+        // never resolve the password hash
         passwordChangeRequired: (_a = value["passwordChangeRequired"]) != null ? _a : false
       };
       break;
@@ -4459,9 +4681,11 @@ var resolveFieldData = async ({ namespace, ...field }, rawData, accumulator, tin
       break;
     case "rich-text":
       const tree = (0, import_mdx.parseMDX)(
+        // @ts-ignore value is unknown
         value,
         field,
-        (value2) => resolveMediaRelativeToCloud(value2, config, tinaSchema.schema)
+        (value2) => resolveMediaRelativeToCloud(value2, config, tinaSchema.schema),
+        context
       );
       if (((_b = tree == null ? void 0 : tree.children[0]) == null ? void 0 : _b.type) === "invalid_markdown") {
         if (isAudit) {
@@ -4492,14 +4716,15 @@ var resolveFieldData = async ({ namespace, ...field }, rawData, accumulator, tin
           });
           const payload = {};
           await sequential(template.fields, async (field2) => {
-            await resolveFieldData(
-              field2,
-              item,
-              payload,
+            await resolveFieldData({
+              field: field2,
+              rawData: item,
+              accumulator: payload,
               tinaSchema,
               config,
-              isAudit
-            );
+              isAudit,
+              context
+            });
           });
           const isUnion = !!field.templates;
           return isUnion ? {
@@ -4520,14 +4745,15 @@ var resolveFieldData = async ({ namespace, ...field }, rawData, accumulator, tin
         });
         const payload = {};
         await sequential(template.fields, async (field2) => {
-          await resolveFieldData(
-            field2,
-            value,
-            payload,
+          await resolveFieldData({
+            field: field2,
+            rawData: value,
+            accumulator: payload,
             tinaSchema,
             config,
-            isAudit
-          );
+            isAudit,
+            context
+          });
         });
         const isUnion = !!field.templates;
         accumulator[field.name] = isUnion ? {
@@ -4541,7 +4767,8 @@ var resolveFieldData = async ({ namespace, ...field }, rawData, accumulator, tin
   }
   return accumulator;
 };
-var transformDocumentIntoPayload = async (fullPath, rawData, tinaSchema, config, isAudit) => {
+var transformDocumentIntoPayload = async (args) => {
+  const { fullPath, rawData, tinaSchema, config, isAudit, context } = args;
   const collection = tinaSchema.getCollection(rawData._collection);
   try {
     const template = tinaSchema.getTemplateForData({
@@ -4561,14 +4788,15 @@ var transformDocumentIntoPayload = async (fullPath, rawData, tinaSchema, config,
     };
     try {
       await sequential(template.fields, async (field) => {
-        return resolveFieldData(
+        return resolveFieldData({
           field,
           rawData,
-          data,
+          accumulator: data,
           tinaSchema,
           config,
-          isAudit
-        );
+          isAudit,
+          context
+        });
       });
     } catch (e) {
       throw new TinaParseDocumentError({
@@ -4595,6 +4823,7 @@ var transformDocumentIntoPayload = async (fullPath, rawData, tinaSchema, config,
         basename,
         filename,
         extension,
+        hasReferences: args.hasReferences,
         path: fullPath,
         relativePath,
         breadcrumbs,
@@ -4614,13 +4843,34 @@ var transformDocumentIntoPayload = async (fullPath, rawData, tinaSchema, config,
     throw e;
   }
 };
+var updateObjectWithJsonPath = (obj, path7, newValue) => {
+  if (!path7.includes(".") && !path7.includes("[")) {
+    if (path7 in obj) {
+      obj[path7] = newValue;
+    }
+    return obj;
+  }
+  const parentPath = path7.replace(/\.[^.]+$/, "");
+  const keyToUpdate = path7.match(/[^.]+$/)[0];
+  const parents = (0, import_jsonpath_plus2.JSONPath)({ path: parentPath, json: obj, resultType: "value" });
+  if (parents.length > 0) {
+    parents.forEach((parent) => {
+      if (parent && typeof parent === "object" && keyToUpdate in parent) {
+        parent[keyToUpdate] = newValue;
+      }
+    });
+  }
+  return obj;
+};
 var Resolver = class {
   constructor(init) {
     this.init = init;
+    this.context = {};
     this.resolveCollection = async (args, collectionName, hasDocuments) => {
       const collection = this.tinaSchema.getCollection(collectionName);
       const extraFields = {};
       return {
+        // return the collection and hasDocuments to resolve documents at a lower level
         documents: { collection, hasDocuments },
         ...collection,
         ...extraFields
@@ -4646,27 +4896,33 @@ var Resolver = class {
           path: rawData["__folderPath"]
         };
       } else {
-        return transformDocumentIntoPayload(
+        this.context = { ...rawData };
+        return transformDocumentIntoPayload({
           fullPath,
           rawData,
-          this.tinaSchema,
-          this.config,
-          this.isAudit
-        );
+          tinaSchema: this.tinaSchema,
+          config: this.config,
+          isAudit: this.isAudit,
+          context: this.context
+        });
       }
     };
-    this.getDocument = async (fullPath) => {
+    this.getDocument = async (fullPath, opts = {}) => {
       if (typeof fullPath !== "string") {
         throw new Error(`fullPath must be of type string for getDocument request`);
       }
       const rawData = await this.getRaw(fullPath);
-      return transformDocumentIntoPayload(
+      this.context = { ...rawData };
+      const hasReferences = (opts == null ? void 0 : opts.checkReferences) ? await this.hasReferences(fullPath, opts.collection) : void 0;
+      return transformDocumentIntoPayload({
         fullPath,
         rawData,
-        this.tinaSchema,
-        this.config,
-        this.isAudit
-      );
+        tinaSchema: this.tinaSchema,
+        config: this.config,
+        isAudit: this.isAudit,
+        context: this.context,
+        hasReferences
+      });
     };
     this.deleteDocument = async (fullPath) => {
       if (typeof fullPath !== "string") {
@@ -4705,7 +4961,9 @@ var Resolver = class {
           );
         } else {
           return this.buildFieldMutations(
+            // @ts-ignore FIXME Argument of type 'string | object' is not assignable to parameter of type '{ [fieldName: string]: string | object | (string | object)[]; }'
             fieldValue,
+            //@ts-ignore
             objectTemplate,
             existingData
           );
@@ -4717,6 +4975,7 @@ var Resolver = class {
             fieldValue.map(async (item) => {
               if (typeof item === "string") {
                 throw new Error(
+                  //@ts-ignore
                   `Expected object for template value for field ${field.name}`
                 );
               }
@@ -4725,16 +4984,19 @@ var Resolver = class {
               });
               const [templateName] = Object.entries(item)[0];
               const template = templates.find(
+                //@ts-ignore
                 (template2) => template2.name === templateName
               );
               if (!template) {
                 throw new Error(`Expected to find template ${templateName}`);
               }
               return {
+                // @ts-ignore FIXME Argument of type 'unknown' is not assignable to parameter of type '{ [fieldName: string]: string | { [key: string]: unknown; } | (string | { [key: string]: unknown; })[]; }'
                 ...await this.buildFieldMutations(
                   item[template.name],
                   template
                 ),
+                //@ts-ignore
                 _template: template.name
               };
             })
@@ -4742,6 +5004,7 @@ var Resolver = class {
         } else {
           if (typeof fieldValue === "string") {
             throw new Error(
+              //@ts-ignore
               `Expected object for template value for field ${field.name}`
             );
           }
@@ -4750,16 +5013,19 @@ var Resolver = class {
           });
           const [templateName] = Object.entries(fieldValue)[0];
           const template = templates.find(
+            //@ts-ignore
             (template2) => template2.name === templateName
           );
           if (!template) {
             throw new Error(`Expected to find template ${templateName}`);
           }
           return {
+            // @ts-ignore FIXME Argument of type 'unknown' is not assignable to parameter of type '{ [fieldName: string]: string | { [key: string]: unknown; } | (string | { [key: string]: unknown; })[]; }'
             ...await this.buildFieldMutations(
               fieldValue[template.name],
               template
             ),
+            //@ts-ignore
             _template: template.name
           };
         }
@@ -4799,6 +5065,7 @@ var Resolver = class {
         return this.getDocument(realPath);
       }
       const params = await this.buildObjectMutations(
+        // @ts-ignore
         args.params[collection.name],
         collection
       );
@@ -4812,58 +5079,68 @@ var Resolver = class {
       isAddPendingDocument,
       isCollectionSpecific
     }) => {
+      var _a;
       const doc = await this.getDocument(realPath);
       const oldDoc = this.resolveLegacyValues((doc == null ? void 0 : doc._rawData) || {}, collection);
+      let values;
       if (isAddPendingDocument === true) {
         const templateInfo = this.tinaSchema.getTemplatesForCollectable(collection);
-        const params2 = this.buildParams(args);
+        const params = this.buildParams(args);
         switch (templateInfo.type) {
           case "object":
-            if (params2) {
-              const values = await this.buildFieldMutations(
-                params2,
+            if (params) {
+              const mutationValues = await this.buildFieldMutations(
+                params,
                 templateInfo.template,
                 doc == null ? void 0 : doc._rawData
               );
-              await this.database.put(
-                realPath,
-                { ...oldDoc, ...values },
-                collection.name
-              );
+              values = { ...oldDoc, ...mutationValues };
             }
             break;
-          case "union":
+          case "union": {
             await sequential(templateInfo.templates, async (template) => {
-              const templateParams = params2[lastItem(template.namespace)];
+              const templateParams = params[lastItem(template.namespace)];
               if (templateParams) {
                 if (typeof templateParams === "string") {
                   throw new Error(
                     `Expected to find an object for template params, but got string`
                   );
                 }
-                const values = {
+                values = {
                   ...oldDoc,
                   ...await this.buildFieldMutations(
+                    // @ts-ignore FIXME: failing on unknown, which we don't need to know because it's recursive
                     templateParams,
                     template,
                     doc == null ? void 0 : doc._rawData
                   ),
                   _template: lastItem(template.namespace)
                 };
-                await this.database.put(realPath, values, collection.name);
               }
             });
+          }
         }
-        return this.getDocument(realPath);
+      } else {
+        const params = await this.buildObjectMutations(
+          //@ts-expect-error FIXME: Argument of type 'unknown' is not assignable to parameter of type 'FieldParams'
+          isCollectionSpecific ? args.params : args.params[collection.name],
+          collection,
+          doc == null ? void 0 : doc._rawData
+        );
+        values = { ...oldDoc, ...params };
       }
-      const params = await this.buildObjectMutations(
-        isCollectionSpecific ? args.params : args.params[collection.name],
-        collection,
-        doc == null ? void 0 : doc._rawData
+      const _tinaEmbeds = ((_a = this.context) == null ? void 0 : _a._tinaEmbeds) ? { _tinaEmbeds: this.context._tinaEmbeds } : {};
+      await this.database.put(
+        realPath,
+        { ...values, ..._tinaEmbeds },
+        collection.name
       );
-      await this.database.put(realPath, { ...oldDoc, ...params }, collection.name);
       return this.getDocument(realPath);
     };
+    /**
+     * Returns top-level fields which are not defined in the collection, so their
+     * values are not eliminated from Tina when new values are saved
+     */
     this.resolveLegacyValues = (oldDoc, collection) => {
       const legacyValues = {};
       Object.entries(oldDoc).forEach(([key, value]) => {
@@ -4969,6 +5246,22 @@ var Resolver = class {
         if (isDeletion) {
           const doc = await this.getDocument(realPath);
           await this.deleteDocument(realPath);
+          if (await this.hasReferences(realPath, collection)) {
+            const collRefs = await this.findReferences(realPath, collection);
+            for (const [collection2, refFields] of Object.entries(collRefs)) {
+              for (const [refPath, refs] of Object.entries(refFields)) {
+                let refDoc = await this.getRaw(refPath);
+                for (const ref of refs) {
+                  refDoc = updateObjectWithJsonPath(
+                    refDoc,
+                    ref.path.join("."),
+                    null
+                  );
+                }
+                await this.database.put(refPath, refDoc, collection2);
+              }
+            }
+          }
           return doc;
         }
         if (isUpdateName) {
@@ -4987,6 +5280,20 @@ var Resolver = class {
           );
           await this.database.put(newRealPath, doc._rawData, collection.name);
           await this.deleteDocument(realPath);
+          const collRefs = await this.findReferences(realPath, collection);
+          for (const [collection2, refFields] of Object.entries(collRefs)) {
+            for (const [refPath, refs] of Object.entries(refFields)) {
+              let refDoc = await this.getRaw(refPath);
+              for (const ref of refs) {
+                refDoc = updateObjectWithJsonPath(
+                  refDoc,
+                  ref.path.join("."),
+                  newRealPath
+                );
+              }
+              await this.database.put(refPath, refDoc, collection2);
+            }
+          }
           return this.getDocument(newRealPath);
         }
         if (alreadyExists === false) {
@@ -5000,7 +5307,10 @@ var Resolver = class {
           isCollectionSpecific
         });
       } else {
-        return this.getDocument(realPath);
+        return this.getDocument(realPath, {
+          collection,
+          checkReferences: true
+        });
       }
     };
     this.resolveCollectionConnections = async ({ ids }) => {
@@ -5037,6 +5347,7 @@ var Resolver = class {
           },
           collection: referencedCollection,
           hydrator: (path7) => path7
+          // just return the path
         }
       );
       const { edges } = resolvedCollectionConnection;
@@ -5104,6 +5415,92 @@ var Resolver = class {
         }
       };
     };
+    /**
+     * Checks if a document has references to it
+     * @param id  The id of the document to check for references
+     * @param c The collection to check for references
+     * @returns true if the document has references, false otherwise
+     */
+    this.hasReferences = async (id, c) => {
+      let count = 0;
+      const deepRefs = this.tinaSchema.findReferences(c.name);
+      for (const [collection, refs] of Object.entries(deepRefs)) {
+        for (const ref of refs) {
+          await this.database.query(
+            {
+              collection,
+              filterChain: makeFilterChain({
+                conditions: [
+                  {
+                    filterPath: ref.path.join("."),
+                    filterExpression: {
+                      _type: "reference",
+                      _list: false,
+                      eq: id
+                    }
+                  }
+                ]
+              }),
+              sort: ref.field.name
+            },
+            (refId) => {
+              count++;
+              return refId;
+            }
+          );
+          if (count) {
+            return true;
+          }
+        }
+      }
+      return false;
+    };
+    /**
+     * Finds references to a document
+     * @param id the id of the document to find references to
+     * @param c the collection to find references in
+     * @returns references to the document in the form of a map of collection names to a list of fields that reference the document
+     */
+    this.findReferences = async (id, c) => {
+      const references = {};
+      const deepRefs = this.tinaSchema.findReferences(c.name);
+      for (const [collection, refs] of Object.entries(deepRefs)) {
+        for (const ref of refs) {
+          await this.database.query(
+            {
+              collection,
+              filterChain: makeFilterChain({
+                conditions: [
+                  {
+                    filterPath: ref.path.join("."),
+                    filterExpression: {
+                      _type: "reference",
+                      _list: false,
+                      eq: id
+                    }
+                  }
+                ]
+              }),
+              sort: ref.field.name
+            },
+            (refId) => {
+              if (!references[collection]) {
+                references[collection] = {};
+              }
+              if (!references[collection][refId]) {
+                references[collection][refId] = [];
+              }
+              references[collection][refId].push({
+                path: ref.path,
+                field: ref.field
+              });
+              return refId;
+            }
+          );
+        }
+      }
+      return references;
+    };
     this.buildFieldMutations = async (fieldParams, template, existingData) => {
       var _a;
       const accum = {};
@@ -5173,13 +5570,15 @@ var Resolver = class {
             break;
           case "rich-text":
             accum[fieldName] = (0, import_mdx.stringifyMDX)(
+              // @ts-ignore
               fieldValue,
               field,
               (fieldValue2) => resolveMediaCloudToRelative(
                 fieldValue2,
                 this.config,
                 this.tinaSchema.schema
-              )
+              ),
+              this.context
             );
             break;
           case "reference":
@@ -5191,6 +5590,27 @@ var Resolver = class {
       }
       return accum;
     };
+    /**
+     * A mutation looks nearly identical between updateDocument:
+     * ```graphql
+     * updateDocument(collection: $collection,relativePath: $path, params: {
+     *   post: {
+     *     title: "Hello, World"
+     *   }
+     * })`
+     * ```
+     * and `updatePostDocument`:
+     * ```graphql
+     * updatePostDocument(relativePath: $path, params: {
+     *   title: "Hello, World"
+     * })
+     * ```
+     * The problem here is that we don't know whether the payload came from `updateDocument`
+     * or `updatePostDocument` (we could, but for now it's easier not to pipe those details through),
+     * But we do know that when given a `args.collection` value, we can assume that
+     * this was a `updateDocument` request, and thus - should grab the data
+     * from the corresponding field name in the key
+     */
     this.buildParams = (args) => {
       try {
         assertShape(
@@ -5291,7 +5711,10 @@ var resolve = async ({
     const graphQLSchema = (0, import_graphql5.buildASTSchema)(graphQLSchemaAst);
     const tinaConfig = await database.getTinaSchema();
     const tinaSchema = await createSchema({
+      // TODO: please update all the types to import from @tinacms/schema-tools
+      // @ts-ignore
       schema: tinaConfig,
+      // @ts-ignore
       flags: (_a = tinaConfig == null ? void 0 : tinaConfig.meta) == null ? void 0 : _a.flags
     });
     const resolver = createResolver({
@@ -5308,8 +5731,7 @@ var resolve = async ({
         database
       },
       typeResolver: async (source, _args, info) => {
-        if (source.__typename)
-          return source.__typename;
+        if (source.__typename) return source.__typename;
         const namedType = (0, import_graphql5.getNamedType)(info.returnType).toString();
         const lookup = await database.getLookup(namedType);
         if (lookup.resolveType === "unionData") {
@@ -5461,11 +5883,13 @@ var resolve = async ({
             (0, import_lodash4.default)(
               params,
               userField.path.slice(1),
+              // remove _rawData from users path
               users.map((u) => {
                 if (user[idFieldName] === u[idFieldName]) {
                   return user;
                 }
                 return {
+                  // don't overwrite other users' passwords
                   ...u,
                   [passwordFieldName]: {
                     ...u[passwordFieldName],
@@ -5488,6 +5912,9 @@ var resolve = async ({
           }
           const isCreation = lookup[info.fieldName] === "create";
           switch (lookup.resolveType) {
+            /**
+             * `node(id: $id)`
+             */
             case "nodeDocument":
               assertShape(
                 args,
@@ -5519,6 +5946,7 @@ var resolve = async ({
                   collection: args.collection,
                   isMutation,
                   isCreation,
+                  // Right now this is the only case for deletion
                   isDeletion: info.fieldName === "deleteDocument",
                   isFolderCreation: info.fieldName === "createFolder",
                   isUpdateName: Boolean((_a2 = args == null ? void 0 : args.params) == null ? void 0 : _a2.relativePath),
@@ -5528,6 +5956,9 @@ var resolve = async ({
                 return result;
               }
               return value;
+            /**
+             * eg `getMovieDocument.data.actors`
+             */
             case "multiCollectionDocumentList":
               if (Array.isArray(value)) {
                 return {
@@ -5539,7 +5970,15 @@ var resolve = async ({
               }
               if (info.fieldName === "documents" && (value == null ? void 0 : value.collection) && (value == null ? void 0 : value.hasDocuments)) {
                 let filter = args.filter;
-                if (typeof (args == null ? void 0 : args.filter) !== "undefined" && (args == null ? void 0 : args.filter) !== null && typeof ((_b = value == null ? void 0 : value.collection) == null ? void 0 : _b.name) === "string" && Object.keys(args.filter).includes((_c = value == null ? void 0 : value.collection) == null ? void 0 : _c.name) && typeof args.filter[(_d = value == null ? void 0 : value.collection) == null ? void 0 : _d.name] !== "undefined") {
+                if (
+                  // 1. Make sure that the filter exists
+                  typeof (args == null ? void 0 : args.filter) !== "undefined" && (args == null ? void 0 : args.filter) !== null && // 2. Make sure that the collection name exists
+                  // @ts-ignore
+                  typeof ((_b = value == null ? void 0 : value.collection) == null ? void 0 : _b.name) === "string" && // 3. Make sure that the collection name is in the filter and is not undefined
+                  // @ts-ignore
+                  Object.keys(args.filter).includes((_c = value == null ? void 0 : value.collection) == null ? void 0 : _c.name) && // @ts-ignore
+                  typeof args.filter[(_d = value == null ? void 0 : value.collection) == null ? void 0 : _d.name] !== "undefined"
+                ) {
                   filter = args.filter[value.collection.name];
                 }
                 return resolver.resolveCollectionConnection({
@@ -5547,12 +5986,20 @@ var resolve = async ({
                     ...args,
                     filter
                   },
+                  // @ts-ignore
                   collection: value.collection
                 });
               }
               throw new Error(
                 `Expected an array for result of ${info.fieldName} at ${info.path}`
               );
+            /**
+             * Collections-specific getter
+             * eg. `getPostDocument`/`createPostDocument`/`updatePostDocument`
+             *
+             * if coming from a query result
+             * the field will be `node`
+             */
             case "collectionDocument": {
               if (value) {
                 return value;
@@ -5567,11 +6014,32 @@ var resolve = async ({
               });
               return result;
             }
+            /**
+             * Collections-specific list getter
+             * eg. `getPageList`
+             */
             case "collectionDocumentList":
               return resolver.resolveCollectionConnection({
                 args,
                 collection: tinaSchema.getCollection(lookup.collection)
               });
+            /**
+             * A polymorphic data set, it can be from a document's data
+             * of any nested object which can be one of many shapes
+             *
+             * ```graphql
+             * getPostDocument(relativePath: $relativePath) {
+             *   data {...} <- this part
+             * }
+             * ```
+             * ```graphql
+             * getBlockDocument(relativePath: $relativePath) {
+             *   data {
+             *     blocks {...} <- or this part
+             *   }
+             * }
+             * ```
+             */
             case "unionData":
               if (!value) {
                 if (args.relativePath) {
@@ -5636,8 +6104,7 @@ var TinaLevelClient = class extends import_many_level.ManyLevelGuest {
     this.port = port || 9e3;
   }
   openConnection() {
-    if (this._connected)
-      return;
+    if (this._connected) return;
     const socket = (0, import_net.connect)(this.port);
     (0, import_readable_stream.pipeline)(socket, this.createRpcStream(), socket, () => {
       this._connected = false;
@@ -5757,7 +6224,7 @@ var Database = class {
         const contentObject = await level.sublevel(
           CONTENT_ROOT_PREFIX,
           SUBLEVEL_OPTIONS
-        ).get((0, import_schema_tools3.normalizePath)(filepath));
+        ).get((0, import_schema_tools4.normalizePath)(filepath));
         if (!contentObject) {
           throw new NotFoundError(`Unable to find record ${filepath}`);
         }
@@ -5782,7 +6249,7 @@ var Database = class {
       );
       const indexDefinitions = await this.getIndexDefinitions(this.contentLevel);
       const collectionIndexDefinitions = indexDefinitions == null ? void 0 : indexDefinitions[collection.name];
-      const normalizedPath = (0, import_schema_tools3.normalizePath)(filepath);
+      const normalizedPath = (0, import_schema_tools4.normalizePath)(filepath);
       if (!(collection == null ? void 0 : collection.isDetached)) {
         if (this.bridge) {
           await this.bridge.put(normalizedPath, stringifiedFile);
@@ -5818,6 +6285,7 @@ var Database = class {
             "put",
             level
           ),
+          // folder indices
           ...makeIndexOpsForDocument(
             normalizedPath,
             `${collection == null ? void 0 : collection.name}_${folderKey}`,
@@ -5840,6 +6308,7 @@ var Database = class {
             "del",
             level
           ),
+          // folder indices
           ...makeIndexOpsForDocument(
             normalizedPath,
             `${collection == null ? void 0 : collection.name}_${folderKey}`,
@@ -5879,7 +6348,7 @@ var Database = class {
             );
             collectionIndexDefinitions = indexDefinitions == null ? void 0 : indexDefinitions[collectionName];
           }
-          const normalizedPath = (0, import_schema_tools3.normalizePath)(filepath);
+          const normalizedPath = (0, import_schema_tools4.normalizePath)(filepath);
           const dataFields = await this.formatBodyOnPayload(filepath, data);
           const collection = await this.collectionForPath(filepath);
           if (!collection) {
@@ -5934,6 +6403,7 @@ var Database = class {
                 "put",
                 level
               ),
+              // folder indices
               ...makeIndexOpsForDocument(
                 normalizedPath,
                 `${collection == null ? void 0 : collection.name}_${folderKey}`,
@@ -5956,6 +6426,7 @@ var Database = class {
                 "del",
                 level
               ),
+              // folder indices
               ...makeIndexOpsForDocument(
                 normalizedPath,
                 `${collection == null ? void 0 : collection.name}_${folderKey}`,
@@ -6033,6 +6504,7 @@ var Database = class {
         aliasedData,
         extension,
         writeTemplateKey,
+        //templateInfo.type === 'union',
         {
           frontmatterFormat: collection == null ? void 0 : collection.frontmatterFormat,
           frontmatterDelimiters: collection == null ? void 0 : collection.frontmatterDelimiters
@@ -6050,7 +6522,7 @@ var Database = class {
     };
     this.getLookup = async (returnType) => {
       await this.initLevel();
-      const lookupPath = (0, import_schema_tools3.normalizePath)(
+      const lookupPath = (0, import_schema_tools4.normalizePath)(
         import_node_path.default.join(this.getGeneratedFolder(), `_lookup.json`)
       );
       if (!this._lookup) {
@@ -6063,7 +6535,7 @@ var Database = class {
     };
     this.getGraphQLSchema = async () => {
       await this.initLevel();
-      const graphqlPath = (0, import_schema_tools3.normalizePath)(
+      const graphqlPath = (0, import_schema_tools4.normalizePath)(
         import_node_path.default.join(this.getGeneratedFolder(), `_graphql.json`)
       );
       return await this.contentLevel.sublevel(
@@ -6071,11 +6543,12 @@ var Database = class {
         SUBLEVEL_OPTIONS
       ).get(graphqlPath);
     };
+    //TODO - is there a reason why the database fetches some config with "bridge.get", and some with "store.get"?
     this.getGraphQLSchemaFromBridge = async () => {
       if (!this.bridge) {
         throw new Error(`No bridge configured`);
       }
-      const graphqlPath = (0, import_schema_tools3.normalizePath)(
+      const graphqlPath = (0, import_schema_tools4.normalizePath)(
         import_node_path.default.join(this.getGeneratedFolder(), `_graphql.json`)
       );
       const _graphql = await this.bridge.get(graphqlPath);
@@ -6083,7 +6556,7 @@ var Database = class {
     };
     this.getTinaSchema = async (level) => {
       await this.initLevel();
-      const schemaPath = (0, import_schema_tools3.normalizePath)(
+      const schemaPath = (0, import_schema_tools4.normalizePath)(
         import_node_path.default.join(this.getGeneratedFolder(), `_schema.json`)
       );
       return await (level || this.contentLevel).sublevel(
@@ -6099,7 +6572,7 @@ var Database = class {
       const schema = existingSchema || await this.getTinaSchema(level || this.contentLevel);
       if (!schema) {
         throw new Error(
-          `Unable to get schema from level db: ${(0, import_schema_tools3.normalizePath)(
+          `Unable to get schema from level db: ${(0, import_schema_tools4.normalizePath)(
             import_node_path.default.join(this.getGeneratedFolder(), `_schema.json`)
           )}`
         );
@@ -6117,6 +6590,7 @@ var Database = class {
             for (const collection of collections) {
               const indexDefinitions = {
                 [DEFAULT_COLLECTION_SORT_KEY]: { fields: [] }
+                // provide a default sort key which is the file sort
               };
               if (collection.fields) {
                 for (const field of collection.fields) {
@@ -6315,7 +6789,7 @@ var Database = class {
           try {
             lookup = lookupFromLockFile || JSON.parse(
               await this.bridge.get(
-                (0, import_schema_tools3.normalizePath)(
+                (0, import_schema_tools4.normalizePath)(
                   import_node_path.default.join(this.getGeneratedFolder(), "_lookup.json")
                 )
               )
@@ -6340,15 +6814,15 @@ var Database = class {
           }
           const contentRootLevel = nextLevel.sublevel(CONTENT_ROOT_PREFIX, SUBLEVEL_OPTIONS);
           await contentRootLevel.put(
-            (0, import_schema_tools3.normalizePath)(import_node_path.default.join(this.getGeneratedFolder(), "_graphql.json")),
+            (0, import_schema_tools4.normalizePath)(import_node_path.default.join(this.getGeneratedFolder(), "_graphql.json")),
             graphQLSchema
           );
           await contentRootLevel.put(
-            (0, import_schema_tools3.normalizePath)(import_node_path.default.join(this.getGeneratedFolder(), "_schema.json")),
+            (0, import_schema_tools4.normalizePath)(import_node_path.default.join(this.getGeneratedFolder(), "_schema.json")),
             tinaSchema.schema
           );
           await contentRootLevel.put(
-            (0, import_schema_tools3.normalizePath)(import_node_path.default.join(this.getGeneratedFolder(), "_lookup.json")),
+            (0, import_schema_tools4.normalizePath)(import_node_path.default.join(this.getGeneratedFolder(), "_lookup.json")),
             lookup
           );
           const result = await this._indexAllContent(
@@ -6441,12 +6915,12 @@ var Database = class {
       if (collection == null ? void 0 : collection.isDetached) {
         level = this.appLevel.sublevel(collection == null ? void 0 : collection.name, SUBLEVEL_OPTIONS);
       }
-      const itemKey = (0, import_schema_tools3.normalizePath)(filepath);
+      const normalizedPath = (0, import_schema_tools4.normalizePath)(filepath);
       const rootSublevel = level.sublevel(
         CONTENT_ROOT_PREFIX,
         SUBLEVEL_OPTIONS
       );
-      const item = await rootSublevel.get(itemKey);
+      const item = await rootSublevel.get(normalizedPath);
       if (item) {
         const folderTreeBuilder = new FolderTreeBuilder();
         const folderKey = folderTreeBuilder.update(
@@ -6455,15 +6929,16 @@ var Database = class {
         );
         await this.contentLevel.batch([
           ...makeIndexOpsForDocument(
-            filepath,
+            normalizedPath,
             collection.name,
             collectionIndexDefinitions,
             item,
             "del",
             level
           ),
+          // folder indices
           ...makeIndexOpsForDocument(
-            filepath,
+            normalizedPath,
             `${collection.name}_${folderKey}`,
             collectionIndexDefinitions,
             item,
@@ -6472,17 +6947,17 @@ var Database = class {
           ),
           {
             type: "del",
-            key: itemKey,
+            key: normalizedPath,
             sublevel: rootSublevel
           }
         ]);
       }
       if (!(collection == null ? void 0 : collection.isDetached)) {
         if (this.bridge) {
-          await this.bridge.delete((0, import_schema_tools3.normalizePath)(filepath));
+          await this.bridge.delete(normalizedPath);
         }
         try {
-          await this.onDelete((0, import_schema_tools3.normalizePath)(filepath));
+          await this.onDelete(normalizedPath);
         } catch (e) {
           throw new import_graphql6.GraphQLError(
             `Error running onDelete hook for ${filepath}: ${e}`,
@@ -6616,6 +7091,9 @@ var Database = class {
       info: templateInfo
     };
   }
+  /**
+   * Clears the internal cache of the tinaSchema and the lookup file. This allows the state to be reset
+   */
   clearCache() {
     this.tinaSchema = null;
     this._lookup = null;
@@ -6697,7 +7175,7 @@ var _indexContent = async (database, level, documentPaths, enqueueOps, collectio
       if (passwordFields == null ? void 0 : passwordFields.length) {
         await hashPasswordValues(aliasedData, passwordFields);
       }
-      const normalizedPath = (0, import_schema_tools3.normalizePath)(filepath);
+      const normalizedPath = (0, import_schema_tools4.normalizePath)(filepath);
       const folderKey = folderTreeBuilder.update(
         normalizedPath,
         collectionPath || ""
@@ -6712,6 +7190,7 @@ var _indexContent = async (database, level, documentPaths, enqueueOps, collectio
             "put",
             level
           ),
+          // folder indexes
           ...makeIndexOpsForDocument(
             normalizedPath,
             `${collection == null ? void 0 : collection.name}_${folderKey}`,
@@ -6777,7 +7256,7 @@ var _deleteIndexContent = async (database, documentPaths, enqueueOps, collection
   );
   const folderTreeBuilder = new FolderTreeBuilder();
   await sequential(documentPaths, async (filepath) => {
-    const itemKey = (0, import_schema_tools3.normalizePath)(filepath);
+    const itemKey = (0, import_schema_tools4.normalizePath)(filepath);
     const item = await rootLevel.get(itemKey);
     if (item) {
       const folderKey = folderTreeBuilder.update(
@@ -6797,6 +7276,7 @@ var _deleteIndexContent = async (database, documentPaths, enqueueOps, collection
           "del",
           database.contentLevel
         ),
+        // folder indexes
         ...makeIndexOpsForDocument(
           itemKey,
           `${collection == null ? void 0 : collection.name}_${folderKey}`,
@@ -6863,14 +7343,14 @@ var getChangedFiles = async ({
   const rootDir = await findGitRoot(dir);
   let pathPrefix = "";
   if (rootDir !== dir) {
-    pathPrefix = (0, import_schema_tools3.normalizePath)(dir.substring(rootDir.length + 1));
+    pathPrefix = (0, import_schema_tools4.normalizePath)(dir.substring(rootDir.length + 1));
   }
   await import_isomorphic_git.default.walk({
     fs: fs4,
     dir: rootDir,
     trees: [import_isomorphic_git.default.TREE({ ref: from }), import_isomorphic_git.default.TREE({ ref: to })],
     map: async function(filename, [A, B]) {
-      const relativePath = (0, import_schema_tools3.normalizePath)(filename).substring(pathPrefix.length);
+      const relativePath = (0, import_schema_tools4.normalizePath)(filename).substring(pathPrefix.length);
       let matches = false;
       for (const [key, matcher] of Object.entries(pathFilter)) {
         if (relativePath.startsWith(key)) {
@@ -7012,17 +7492,26 @@ var IsomorphicBridge = class {
   getAuthor() {
     return {
       ...this.author,
-      timestamp: Math.round(new Date().getTime() / 1e3),
+      timestamp: Math.round((/* @__PURE__ */ new Date()).getTime() / 1e3),
       timezoneOffset: 0
     };
   }
   getCommitter() {
     return {
       ...this.committer,
-      timestamp: Math.round(new Date().getTime() / 1e3),
+      timestamp: Math.round((/* @__PURE__ */ new Date()).getTime() / 1e3),
       timezoneOffset: 0
     };
   }
+  /**
+   * Recursively populate paths matching `pattern` for the given `entry`
+   *
+   * @param pattern - pattern to filter paths by
+   * @param entry - TreeEntry to start building list from
+   * @param path - base path
+   * @param results
+   * @private
+   */
   async listEntries({
     pattern,
     entry,
@@ -7055,6 +7544,15 @@ var IsomorphicBridge = class {
       });
     }
   }
+  /**
+   * For the specified path, returns an object with an array containing the parts of the path (pathParts)
+   * and an array containing the WalkerEntry objects for the path parts (pathEntries). Any null elements in the
+   * pathEntries are placeholders for non-existent entries.
+   *
+   * @param path - path being resolved
+   * @param ref - ref to resolve path entries for
+   * @private
+   */
   async resolvePathEntries(path7, ref) {
     let pathParts = path7.split("/");
     const result = await import_isomorphic_git2.default.walk({
@@ -7085,6 +7583,17 @@ var IsomorphicBridge = class {
     }
     return { pathParts, pathEntries };
   }
+  /**
+   * Updates tree entry and associated parent tree entries
+   *
+   * @param existingOid - the existing OID
+   * @param updatedOid - the updated OID
+   * @param path - the path of the entry being updated
+   * @param type - the type of the entry being updated (blob or tree)
+   * @param pathEntries - parent path entries
+   * @param pathParts - parent path parts
+   * @private
+   */
   async updateTreeHierarchy(existingOid, updatedOid, path7, type, pathEntries, pathParts) {
     const lastIdx = pathEntries.length - 1;
     const parentEntry = pathEntries[lastIdx];
@@ -7140,6 +7649,13 @@ var IsomorphicBridge = class {
       );
     }
   }
+  /**
+   * Creates a commit for the specified tree and updates the specified ref to point to the commit
+   *
+   * @param treeSha - sha of the new tree
+   * @param ref - the ref that should be updated
+   * @private
+   */
   async commitTree(treeSha, ref) {
     const commitSha = await import_isomorphic_git2.default.writeCommit({
       ...this.isomorphicConfig,
@@ -7152,6 +7668,7 @@ var IsomorphicBridge = class {
           })
         ],
         message: this.commitMessage,
+        // TODO these should be configurable
         author: this.getAuthor(),
         committer: this.getCommitter()
       }
@@ -7390,5 +7907,5 @@ var buildSchema = async (config, flags) => {
   transformDocument,
   transformDocumentIntoPayload
 });
-//! Replaces _.flattenDeep()
 //! Replaces _.get()
+//! Replaces _.flattenDeep()