@tinacms/graphql 0.0.0-d524599-20241117111320 → 0.0.0-d6f7570-20250523032937

package/dist/index.js

@@ -17,14 +17,18 @@ 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
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   AuditFileSystemBridge: () => AuditFileSystemBridge,
   Database: () => Database,
   FilesystemBridge: () => FilesystemBridge,
@@ -58,7 +62,7 @@ __export(src_exports, {
   transformDocument: () => transformDocument,
   transformDocumentIntoPayload: () => transformDocumentIntoPayload
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/build.ts
 var import_graphql2 = require("graphql");
@@ -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: {
@@ -197,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
@@ -420,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: ({
@@ -432,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: {
@@ -528,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];
@@ -1028,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) => {
@@ -1072,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("");
 };
@@ -1447,13 +1435,12 @@ var checkPasswordHash = async ({
   return true;
 };
 var mapUserFields = (collectable, prefix = []) => {
-  var _a, _b, _c, _d, _e;
   const results = [];
-  const passwordFields = ((_a = collectable.fields) == null ? void 0 : _a.filter((field) => field.type === "password")) || [];
+  const passwordFields = collectable.fields?.filter((field) => field.type === "password") || [];
   if (passwordFields.length > 1) {
     throw new Error("Only one password field is allowed");
   }
-  const idFields = ((_b = collectable.fields) == null ? void 0 : _b.filter((field) => field.uid)) || [];
+  const idFields = collectable.fields?.filter((field) => field.uid) || [];
   if (idFields.length > 1) {
     throw new Error("Only one uid field is allowed");
   }
@@ -1461,11 +1448,11 @@ var mapUserFields = (collectable, prefix = []) => {
     results.push({
       path: prefix,
       collectable,
-      idFieldName: (_c = idFields[0]) == null ? void 0 : _c.name,
-      passwordFieldName: (_d = passwordFields[0]) == null ? void 0 : _d.name
+      idFieldName: idFields[0]?.name,
+      passwordFieldName: passwordFields[0]?.name
     });
   }
-  (_e = collectable.fields) == null ? void 0 : _e.forEach((field) => {
+  collectable.fields?.forEach((field) => {
     if (field.type === "object" && field.fields) {
       results.push(...mapUserFields(field, [...prefix, field.name]));
     }
@@ -1485,6 +1472,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";
@@ -1555,6 +1555,19 @@ var Builder = class {
         required: true
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   getCollections {
+     *     name
+     *     documents {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collections
+     */
     this.buildMultiCollectionDefinition = async (collections) => {
       const name = "collections";
       const typeName = "Collection";
@@ -1565,6 +1578,17 @@ var Builder = class {
         required: true
       });
     };
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   node(id: $id) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     */
     this.multiNodeDocument = async () => {
       const name = "node";
       const args = [
@@ -1585,6 +1609,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 = [
@@ -1610,6 +1647,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",
@@ -1634,6 +1684,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",
@@ -1661,6 +1724,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",
@@ -1688,6 +1764,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",
@@ -1707,6 +1796,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",
@@ -1726,6 +1828,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);
@@ -1786,6 +1901,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 TinaCloud collection
+     */
     this.collectionFragment = async (collection) => {
       const name = NAMER.dataTypeName(collection.namespace);
       const fragmentName = NAMER.fragmentName(collection.namespace);
@@ -1799,14 +1928,27 @@ 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 = [];
       selections.push({
         name: { kind: "Name", value: "__typename" },
         kind: "Field"
       });
-      if (((_a = collection.fields) == null ? void 0 : _a.length) > 0) {
+      if (collection.fields?.length > 0) {
         await sequential(collection.fields, async (x) => {
           const field = await this._buildFieldNodeForFragments(x, depth);
           selections.push(field);
@@ -1821,7 +1963,6 @@ var Builder = class {
       return selections;
     };
     this._buildFieldNodeForFragments = async (field, depth) => {
-      var _a, _b;
       switch (field.type) {
         case "string":
         case "image":
@@ -1854,7 +1995,7 @@ var Builder = class {
             selections: filterSelections([passwordValue, passwordChangeRequired])
           });
         case "object":
-          if (((_a = field.fields) == null ? void 0 : _a.length) > 0) {
+          if (field.fields?.length > 0) {
             const selections2 = [];
             await sequential(field.fields, async (item) => {
               const field2 = await this._buildFieldNodeForFragments(item, depth);
@@ -1867,7 +2008,7 @@ var Builder = class {
                 ...filterSelections(selections2)
               ]
             });
-          } else if (((_b = field.templates) == null ? void 0 : _b.length) > 0) {
+          } else if (field.templates?.length > 0) {
             const selections2 = [];
             await sequential(field.templates, async (tem) => {
               if (typeof tem === "object") {
@@ -1882,9 +2023,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;
           }
@@ -1916,6 +2057,7 @@ var Builder = class {
             name: field.name,
             selections: [
               ...selections,
+              // This is ... on Document { id }
               {
                 kind: "InlineFragment",
                 typeCondition: {
@@ -1946,6 +2088,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),
@@ -1965,6 +2120,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),
@@ -1984,6 +2152,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({
@@ -1999,6 +2183,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);
@@ -2482,7 +2670,7 @@ var Builder = class {
         this.addToLookupMap({
           type: name,
           resolveType: "unionData",
-          collection: collection == null ? void 0 : collection.name,
+          collection: collection?.name,
           typeMap
         });
         return astBuilder.UnionTypeDefinition({ name, types });
@@ -2503,6 +2691,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)
               });
@@ -2691,8 +2880,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
+    config?.tinaSchema.schema?.config?.client?.referenceDepth ?? 2;
     this.tinaSchema = config.tinaSchema;
     this.lookupMap = {};
   }
@@ -2703,8 +2892,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)
@@ -2738,12 +2926,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",
@@ -2756,7 +2945,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(
@@ -2765,7 +2954,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
@@ -2781,20 +2970,18 @@ var validationCollectionsPathAndMatch = (collections) => {
     return;
   }
   const noMatchCollections = collections.filter((x) => {
-    return typeof (x == null ? void 0 : x.match) === "undefined";
+    return typeof x?.match === "undefined";
   }).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."
     );
   }
   const hasMatchAndPath = collections.filter((x) => {
     return typeof x.path !== "undefined" && typeof x.match !== "undefined";
   }).map(
-    (x) => {
-      var _a, _b;
-      return `${x.path}|${((_a = x == null ? void 0 : x.match) == null ? void 0 : _a.exclude) || ""}|${((_b = x == null ? void 0 : x.match) == null ? void 0 : _b.include) || ""}|${x.format || "md"}`;
-    }
+    (x) => `${x.path}|${x?.match?.exclude || ""}|${x?.match?.include || ""}|${x.format || "md"}`
   );
   if (hasMatchAndPath.length !== new Set(hasMatchAndPath).size) {
     throw new Error(
@@ -2818,7 +3005,7 @@ var validationCollectionsPathAndMatch = (collections) => {
       );
     }
     const matches = collectionsArr.map(
-      (x) => typeof (x == null ? void 0 : x.match) === "object" ? JSON.stringify(x.match) : ""
+      (x) => typeof x?.match === "object" ? JSON.stringify(x.match) : ""
     );
     if (matches.length === new Set(matches).size) {
       return;
@@ -2896,7 +3083,7 @@ var validateField = async (field) => {
 // package.json
 var package_default = {
   name: "@tinacms/graphql",
-  version: "1.5.7",
+  version: "1.5.17",
   main: "dist/index.js",
   module: "dist/index.mjs",
   typings: "dist/index.d.ts",
@@ -2922,9 +3109,8 @@ var package_default = {
     types: "pnpm tsc",
     build: "tinacms-scripts build",
     docs: "pnpm typedoc",
-    serve: "pnpm nodemon dist/server.js",
-    test: "jest",
-    "test-watch": "jest --watch"
+    test: "vitest run",
+    "test-watch": "vitest"
   },
   dependencies: {
     "@iarna/toml": "^2.2.5",
@@ -2932,12 +3118,12 @@ var package_default = {
     "@tinacms/schema-tools": "workspace:*",
     "abstract-level": "^1.0.4",
     "date-fns": "^2.30.0",
-    "fast-glob": "^3.3.2",
-    "fs-extra": "^11.2.0",
+    "fast-glob": "^3.3.3",
+    "fs-extra": "^11.3.0",
     "glob-parent": "^6.0.2",
     graphql: "15.8.0",
     "gray-matter": "^4.0.3",
-    "isomorphic-git": "^1.27.1",
+    "isomorphic-git": "^1.29.0",
     "js-sha1": "^0.6.0",
     "js-yaml": "^3.14.1",
     "jsonpath-plus": "10.1.0",
@@ -2947,7 +3133,7 @@ var package_default = {
     "many-level": "^2.0.0",
     micromatch: "4.0.8",
     "normalize-path": "^3.0.0",
-    "readable-stream": "^4.5.2",
+    "readable-stream": "^4.7.0",
     scmp: "^2.1.0",
     yup: "^0.32.11"
   },
@@ -2965,24 +3151,22 @@ 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.9.0",
+    "@types/node": "^22.13.1",
     "@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.3"
+    typescript: "^5.7.3",
+    vite: "^4.5.9",
+    vitest: "^0.32.4",
+    zod: "^3.24.2"
   }
 };
 
@@ -2997,7 +3181,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,
@@ -3053,6 +3237,7 @@ var _buildFragments = async (builder, tinaSchema) => {
   const fragDoc = {
     kind: "Document",
     definitions: (0, import_lodash3.default)(
+      // @ts-ignore
       extractInlineTypes(fragmentDefinitionsFields),
       (node) => node.name.value
     )
@@ -3063,7 +3248,6 @@ var _buildQueries = async (builder, tinaSchema) => {
   const operationsDefinitions = [];
   const collections = tinaSchema.getCollections();
   await sequential(collections, async (collection) => {
-    var _a, _b, _c;
     const queryName = NAMER.queryName(collection.namespace);
     const queryListName = NAMER.generateQueryListName(collection.namespace);
     const queryFilterTypeName = NAMER.dataFilterTypeName(collection.namespace);
@@ -3076,8 +3260,9 @@ 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")
+          tinaSchema.config?.meta?.flags?.find((x) => x === "experimentalData")
         )
       })
     );
@@ -3085,6 +3270,7 @@ var _buildQueries = async (builder, tinaSchema) => {
   const queryDoc = {
     kind: "Document",
     definitions: (0, import_lodash3.default)(
+      // @ts-ignore
       extractInlineTypes(operationsDefinitions),
       (node) => node.name.value
     )
@@ -3136,7 +3322,9 @@ var _buildSchema = async (builder, tinaSchema) => {
     await builder.buildCreateCollectionFolderMutation()
   );
   await sequential(collections, async (collection) => {
-    queryTypeDefinitionFields.push(await builder.collectionDocument(collection));
+    queryTypeDefinitionFields.push(
+      await builder.collectionDocument(collection)
+    );
     if (collection.isAuthCollection) {
       queryTypeDefinitionFields.push(
         await builder.authenticationCollectionDocument(collection)
@@ -3173,6 +3361,7 @@ var _buildSchema = async (builder, tinaSchema) => {
   return {
     kind: "Document",
     definitions: (0, import_lodash3.default)(
+      // @ts-ignore
       extractInlineTypes(definitions),
       (node) => node.name.value
     )
@@ -3377,8 +3566,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
           );
@@ -3406,8 +3594,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}`;
         });
@@ -3425,10 +3612,8 @@ var cleanUpSlashes = (path7) => {
   return "";
 };
 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 (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")
+  if (!schema.config?.media?.tina) return false;
+  if (typeof schema.config?.media?.tina?.publicFolder !== "string" && typeof schema.config?.media?.tina?.mediaRoot !== "string")
     return false;
   return true;
 };
@@ -3454,7 +3639,9 @@ var LevelProxyHandler = {
       throw new Error(`The property, ${property.toString()}, doesn't exist`);
     }
     if (typeof target[property] !== "function") {
-      throw new Error(`The property, ${property.toString()}, is not a function`);
+      throw new Error(
+        `The property, ${property.toString()}, is not a function`
+      );
     }
     if (property === "get") {
       return async (...args) => {
@@ -3471,6 +3658,7 @@ var LevelProxyHandler = {
     } else if (property === "sublevel") {
       return (...args) => {
         return new Proxy(
+          // eslint-disable-next-line prefer-spread
           target[property].apply(target, args),
           LevelProxyHandler
         );
@@ -3493,7 +3681,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"));
 
@@ -3532,22 +3720,20 @@ var replaceNameOverrides = (template, obj) => {
   }
 };
 function isBlockField(field) {
-  var _a;
-  return field && field.type === "object" && ((_a = field.templates) == null ? void 0 : _a.length) > 0;
+  return field && field.type === "object" && field.templates?.length > 0;
 }
 var _replaceNameOverrides = (fields, obj) => {
   const output = {};
   Object.keys(obj).forEach((key) => {
     const field = fields.find(
-      (fieldWithMatchingAlias) => ((fieldWithMatchingAlias == null ? void 0 : fieldWithMatchingAlias.nameOverride) || (fieldWithMatchingAlias == null ? void 0 : fieldWithMatchingAlias.name)) === key
+      (fieldWithMatchingAlias) => (fieldWithMatchingAlias?.nameOverride || fieldWithMatchingAlias?.name) === key
     );
-    output[(field == null ? void 0 : field.name) || key] = (field == null ? void 0 : field.type) == "object" ? replaceNameOverrides(field, obj[key]) : obj[key];
+    output[field?.name || key] = field?.type == "object" ? replaceNameOverrides(field, obj[key]) : obj[key];
   });
   return output;
 };
 var getTemplateForData = (field, data) => {
-  var _a;
-  if ((_a = field.templates) == null ? void 0 : _a.length) {
+  if (field.templates?.length) {
     const templateKey = "_template";
     if (data[templateKey]) {
       const result = field.templates.find(
@@ -3605,8 +3791,8 @@ var _applyNameOverrides = (fields, obj) => {
   const output = {};
   Object.keys(obj).forEach((key) => {
     const field = fields.find((field2) => field2.name === key);
-    const outputKey = (field == null ? void 0 : field.nameOverride) || key;
-    output[outputKey] = (field == null ? void 0 : field.type) === "object" ? applyNameOverrides(field, obj[key]) : obj[key];
+    const outputKey = field?.nameOverride || key;
+    output[outputKey] = field?.type === "object" ? applyNameOverrides(field, obj[key]) : obj[key];
   });
   return output;
 };
@@ -3619,7 +3805,6 @@ var matterEngines = {
   }
 };
 var stringifyFile = (content, format, keepTemplateKey, markdownParseConfig) => {
-  var _a, _b;
   const {
     _relativePath,
     _keepTemplateKey,
@@ -3643,9 +3828,9 @@ var stringifyFile = (content, format, keepTemplateKey, markdownParseConfig) => {
 ${$_body}`,
         strippedContent,
         {
-          language: (_a = markdownParseConfig == null ? void 0 : markdownParseConfig.frontmatterFormat) != null ? _a : "yaml",
+          language: markdownParseConfig?.frontmatterFormat ?? "yaml",
           engines: matterEngines,
-          delimiters: (_b = markdownParseConfig == null ? void 0 : markdownParseConfig.frontmatterDelimiters) != null ? _b : "---"
+          delimiters: markdownParseConfig?.frontmatterDelimiters ?? "---"
         }
       );
       return ok;
@@ -3661,15 +3846,14 @@ ${$_body}`,
   }
 };
 var parseFile = (content, format, yupSchema, markdownParseConfig) => {
-  var _a, _b;
   try {
     switch (format) {
       case ".markdown":
       case ".mdx":
       case ".md":
         const contentJSON = (0, import_gray_matter.default)(content || "", {
-          language: (_a = markdownParseConfig == null ? void 0 : markdownParseConfig.frontmatterFormat) != null ? _a : "yaml",
-          delimiters: (_b = markdownParseConfig == null ? void 0 : markdownParseConfig.frontmatterDelimiters) != null ? _b : "---",
+          language: markdownParseConfig?.frontmatterFormat ?? "yaml",
+          delimiters: markdownParseConfig?.frontmatterDelimiters ?? "---",
           engines: matterEngines
         });
         const markdownData = {
@@ -3706,7 +3890,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 });
@@ -3768,7 +3952,7 @@ var transformDocument = (filepath, contentObject, tinaSchema) => {
     ),
     template: void 0
   } : tinaSchema.getCollectionAndTemplateByFullPath(filepath, templateName);
-  const field = template == null ? void 0 : template.fields.find((field2) => {
+  const field = template?.fields.find((field2) => {
     if (field2.type === "string" || field2.type === "rich-text") {
       if (field2.isBody) {
         return true;
@@ -3788,7 +3972,7 @@ var transformDocument = (filepath, contentObject, tinaSchema) => {
     ...data,
     _collection: collection.name,
     _keepTemplateKey: !!collection.templates,
-    _template: (template == null ? void 0 : template.namespace) ? lastItem(template == null ? void 0 : template.namespace) : void 0,
+    _template: template?.namespace ? lastItem(template?.namespace) : void 0,
     _relativePath: filepath.replace(collection.path, "").replace(/^\/|\/$/g, ""),
     _id: filepath
   };
@@ -3797,10 +3981,10 @@ function hasOwnProperty(obj, prop) {
   return obj.hasOwnProperty(prop);
 }
 var getTemplateForFile = (templateInfo, data) => {
-  if ((templateInfo == null ? void 0 : templateInfo.type) === "object") {
+  if (templateInfo?.type === "object") {
     return templateInfo.template;
   }
-  if ((templateInfo == null ? void 0 : templateInfo.type) === "union") {
+  if (templateInfo?.type === "union") {
     if (hasOwnProperty(data, "_template")) {
       const template = templateInfo.templates.find(
         (t) => lastItem(t.namespace) === data._template
@@ -3818,14 +4002,14 @@ 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),
     (yup3) => yup3.object({}),
     {
-      frontmatterDelimiters: collection == null ? void 0 : collection.frontmatterDelimiters,
-      frontmatterFormat: collection == null ? void 0 : collection.frontmatterFormat
+      frontmatterDelimiters: collection?.frontmatterDelimiters,
+      frontmatterFormat: collection?.frontmatterFormat
     }
   );
   const template = getTemplateForFile(templateInfo, data);
@@ -3840,6 +4024,9 @@ var loadAndParseWithAliases = async (bridge, filepath, collection, templateInfo)
 
 // src/database/datalayer.ts
 var DEFAULT_COLLECTION_SORT_KEY = "__filepath__";
+var REFS_COLLECTIONS_SORT_KEY = "__refs__";
+var REFS_REFERENCE_FIELD = "__tina_ref__";
+var REFS_PATH_FIELD = "__tina_ref_path__";
 var DEFAULT_NUMERIC_LPAD = 4;
 var applyPadding = (input, pad) => {
   if (pad) {
@@ -4297,7 +4484,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 = "";
     }
@@ -4310,7 +4497,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("/");
@@ -4349,6 +4536,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: {}
           });
@@ -4412,6 +4600,57 @@ var makeIndexOpsForDocument = (filepath, collection, indexDefinitions, data, opT
   }
   return result;
 };
+var makeRefOpsForDocument = (filepath, collection, references, data, opType, level) => {
+  const result = [];
+  if (collection) {
+    for (const [c, referencePaths] of Object.entries(references || {})) {
+      if (!referencePaths.length) {
+        continue;
+      }
+      const collectionSublevel = level.sublevel(c, SUBLEVEL_OPTIONS);
+      const refSublevel = collectionSublevel.sublevel(
+        REFS_COLLECTIONS_SORT_KEY,
+        SUBLEVEL_OPTIONS
+      );
+      const references2 = {};
+      for (const path7 of referencePaths) {
+        const ref = (0, import_jsonpath_plus.JSONPath)({ path: path7, json: data });
+        if (!ref) {
+          continue;
+        }
+        if (Array.isArray(ref)) {
+          for (const r of ref) {
+            if (!r) {
+              continue;
+            }
+            if (references2[r]) {
+              references2[r].push(path7);
+            } else {
+              references2[r] = [path7];
+            }
+          }
+        } else {
+          if (references2[ref]) {
+            references2[ref].push(path7);
+          } else {
+            references2[ref] = [path7];
+          }
+        }
+      }
+      for (const ref of Object.keys(references2)) {
+        for (const path7 of references2[ref]) {
+          result.push({
+            type: opType,
+            key: `${ref}${INDEX_KEY_FIELD_SEPARATOR}${path7}${INDEX_KEY_FIELD_SEPARATOR}${filepath}`,
+            sublevel: refSublevel,
+            value: opType === "put" ? {} : void 0
+          });
+        }
+      }
+    }
+  }
+  return result;
+};
 var makeStringEscaper = (regex, replacement) => {
   return (input) => {
     if (Array.isArray(input)) {
@@ -4437,7 +4676,6 @@ var createResolver = (args) => {
   return new Resolver(args);
 };
 var resolveFieldData = async ({ namespace, ...field }, rawData, accumulator, tinaSchema, config, isAudit) => {
-  var _a, _b;
   if (!rawData) {
     return void 0;
   }
@@ -4464,7 +4702,8 @@ var resolveFieldData = async ({ namespace, ...field }, rawData, accumulator, tin
     case "password":
       accumulator[field.name] = {
         value: void 0,
-        passwordChangeRequired: (_a = value["passwordChangeRequired"]) != null ? _a : false
+        // never resolve the password hash
+        passwordChangeRequired: value["passwordChangeRequired"] ?? false
       };
       break;
     case "image":
@@ -4480,11 +4719,11 @@ var resolveFieldData = async ({ namespace, ...field }, rawData, accumulator, tin
         field,
         (value2) => resolveMediaRelativeToCloud(value2, config, tinaSchema.schema)
       );
-      if (((_b = tree == null ? void 0 : tree.children[0]) == null ? void 0 : _b.type) === "invalid_markdown") {
+      if (tree?.children[0]?.type === "invalid_markdown") {
         if (isAudit) {
-          const invalidNode = tree == null ? void 0 : tree.children[0];
+          const invalidNode = tree?.children[0];
           throw new import_graphql3.GraphQLError(
-            `${invalidNode == null ? void 0 : invalidNode.message}${invalidNode.position ? ` at line ${invalidNode.position.start.line}, column ${invalidNode.position.start.column}` : ""}`
+            `${invalidNode?.message}${invalidNode.position ? ` at line ${invalidNode.position.start.line}, column ${invalidNode.position.start.column}` : ""}`
           );
         }
       }
@@ -4597,11 +4836,11 @@ var transformDocumentIntoPayload = async (fullPath, rawData, tinaSchema, config,
       });
     }
     const titleField = template.fields.find((x) => {
-      if (x.type === "string" && (x == null ? void 0 : x.isTitle)) {
+      if (x.type === "string" && x?.isTitle) {
         return true;
       }
     });
-    const titleFieldName = titleField == null ? void 0 : titleField.name;
+    const titleFieldName = titleField?.name;
     const title = data[titleFieldName || " "] || null;
     return {
       __typename: collection.fields ? NAMER.documentTypeName(collection.namespace) : NAMER.documentTypeName(template.namespace),
@@ -4632,24 +4871,33 @@ var transformDocumentIntoPayload = async (fullPath, rawData, tinaSchema, config,
     throw e;
   }
 };
-var updateObjectWithJsonPath = (obj, path7, newValue) => {
+var updateObjectWithJsonPath = (obj, path7, oldValue, newValue) => {
+  let updated = false;
   if (!path7.includes(".") && !path7.includes("[")) {
-    if (path7 in obj) {
+    if (path7 in obj && obj[path7] === oldValue) {
       obj[path7] = newValue;
+      updated = true;
     }
-    return obj;
-  }
-  const parentPath = path7.replace(/\.[^.]+$/, "");
-  const keyToUpdate = path7.match(/[^.]+$/)[0];
-  const parents = (0, import_jsonpath_plus2.JSONPath)({ path: parentPath, json: obj, resultType: "value" });
+    return { object: obj, updated };
+  }
+  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;
+        if (parent[keyToUpdate] === oldValue) {
+          parent[keyToUpdate] = newValue;
+          updated = true;
+        }
       }
     });
   }
-  return obj;
+  return { object: obj, updated };
 };
 var Resolver = class {
   constructor(init) {
@@ -4658,6 +4906,7 @@ var Resolver = class {
       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
@@ -4665,7 +4914,9 @@ var Resolver = class {
     };
     this.getRaw = async (fullPath) => {
       if (typeof fullPath !== "string") {
-        throw new Error(`fullPath must be of type string for getDocument request`);
+        throw new Error(
+          `fullPath must be of type string for getDocument request`
+        );
       }
       return this.database.get(fullPath);
     };
@@ -4694,10 +4945,12 @@ var Resolver = class {
     };
     this.getDocument = async (fullPath, opts = {}) => {
       if (typeof fullPath !== "string") {
-        throw new Error(`fullPath must be of type string for getDocument request`);
+        throw new Error(
+          `fullPath must be of type string for getDocument request`
+        );
       }
       const rawData = await this.getRaw(fullPath);
-      const hasReferences = (opts == null ? void 0 : opts.checkReferences) ? await this.hasReferences(fullPath, opts.collection) : void 0;
+      const hasReferences = opts?.checkReferences ? await this.hasReferences(fullPath, opts.collection) : void 0;
       return transformDocumentIntoPayload(
         fullPath,
         rawData,
@@ -4709,7 +4962,9 @@ var Resolver = class {
     };
     this.deleteDocument = async (fullPath) => {
       if (typeof fullPath !== "string") {
-        throw new Error(`fullPath must be of type string for getDocument request`);
+        throw new Error(
+          `fullPath must be of type string for getDocument request`
+        );
       }
       await this.database.delete(fullPath);
     };
@@ -4735,16 +4990,18 @@ var Resolver = class {
                 return this.buildFieldMutations(
                   item,
                   objectTemplate,
-                  idField && existingData && (existingData == null ? void 0 : existingData.find(
+                  idField && existingData && existingData?.find(
                     (d) => d[idField.name] === item[idField.name]
-                  ))
+                  )
                 );
               }
             )
           );
         } 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
           );
@@ -4756,6 +5013,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}`
                 );
               }
@@ -4764,16 +5022,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
               };
             })
@@ -4781,6 +5042,7 @@ var Resolver = class {
         } else {
           if (typeof fieldValue === "string") {
             throw new Error(
+              //@ts-ignore
               `Expected object for template value for field ${field.name}`
             );
           }
@@ -4789,16 +5051,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
           };
         }
@@ -4838,6 +5103,7 @@ var Resolver = class {
         return this.getDocument(realPath);
       }
       const params = await this.buildObjectMutations(
+        // @ts-ignore
         args.params[collection.name],
         collection
       );
@@ -4852,7 +5118,7 @@ var Resolver = class {
       isCollectionSpecific
     }) => {
       const doc = await this.getDocument(realPath);
-      const oldDoc = this.resolveLegacyValues((doc == null ? void 0 : doc._rawData) || {}, collection);
+      const oldDoc = this.resolveLegacyValues(doc?._rawData || {}, collection);
       if (isAddPendingDocument === true) {
         const templateInfo = this.tinaSchema.getTemplatesForCollectable(collection);
         const params2 = this.buildParams(args);
@@ -4862,7 +5128,7 @@ var Resolver = class {
               const values = await this.buildFieldMutations(
                 params2,
                 templateInfo.template,
-                doc == null ? void 0 : doc._rawData
+                doc?._rawData
               );
               await this.database.put(
                 realPath,
@@ -4883,9 +5149,10 @@ var Resolver = class {
                 const 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
+                    doc?._rawData
                   ),
                   _template: lastItem(template.namespace)
                 };
@@ -4896,17 +5163,25 @@ var Resolver = class {
         return this.getDocument(realPath);
       }
       const params = await this.buildObjectMutations(
+        //@ts-ignore
         isCollectionSpecific ? args.params : args.params[collection.name],
         collection,
-        doc == null ? void 0 : doc._rawData
+        doc?._rawData
+      );
+      await this.database.put(
+        realPath,
+        { ...oldDoc, ...params },
+        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]) => {
-        var _a;
         const reservedKeys = [
           "$_body",
           "_collection",
@@ -4919,7 +5194,7 @@ var Resolver = class {
           return;
         }
         if (oldDoc._template && collection.templates) {
-          const template = (_a = collection.templates) == null ? void 0 : _a.find(
+          const template = collection.templates?.find(
             ({ name }) => name === oldDoc._template
           );
           if (template) {
@@ -4966,7 +5241,7 @@ var Resolver = class {
         (yup3) => yup3.object({ relativePath: yup3.string().required() })
       );
       const collection = await this.tinaSchema.getCollection(collectionLookup);
-      let realPath = import_path3.default.join(collection == null ? void 0 : collection.path, args.relativePath);
+      let realPath = import_path3.default.join(collection?.path, args.relativePath);
       if (isFolderCreation) {
         realPath = `${realPath}/.gitkeep.${collection.format || "md"}`;
       }
@@ -5010,17 +5285,35 @@ var Resolver = class {
           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(
+            for (const [collection2, docsWithRefs] of Object.entries(collRefs)) {
+              for (const [pathToDocWithRef, referencePaths] of Object.entries(
+                docsWithRefs
+              )) {
+                let refDoc = await this.getRaw(pathToDocWithRef);
+                let hasUpdate = false;
+                for (const path7 of referencePaths) {
+                  const { object: object2, updated } = updateObjectWithJsonPath(
                     refDoc,
-                    ref.path.join("."),
+                    path7,
+                    realPath,
                     null
                   );
+                  refDoc = object2;
+                  hasUpdate = updated || hasUpdate;
+                }
+                if (hasUpdate) {
+                  const collectionWithRef = this.tinaSchema.getCollectionByFullPath(pathToDocWithRef);
+                  if (!collectionWithRef) {
+                    throw new Error(
+                      `Unable to find collection for ${pathToDocWithRef}`
+                    );
+                  }
+                  await this.database.put(
+                    pathToDocWithRef,
+                    refDoc,
+                    collectionWithRef.name
+                  );
                 }
-                await this.database.put(refPath, refDoc, collection2);
               }
             }
           }
@@ -5032,34 +5325,57 @@ var Resolver = class {
             (yup3) => yup3.object({ params: yup3.object().required() })
           );
           assertShape(
-            args == null ? void 0 : args.params,
+            args?.params,
             (yup3) => yup3.object({ relativePath: yup3.string().required() })
           );
           const doc = await this.getDocument(realPath);
           const newRealPath = import_path3.default.join(
-            collection == null ? void 0 : collection.path,
+            collection?.path,
             args.params.relativePath
           );
+          if (newRealPath === realPath) {
+            return doc;
+          }
           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("."),
+          for (const [collection2, docsWithRefs] of Object.entries(collRefs)) {
+            for (const [pathToDocWithRef, referencePaths] of Object.entries(
+              docsWithRefs
+            )) {
+              let docWithRef = await this.getRaw(pathToDocWithRef);
+              let hasUpdate = false;
+              for (const path7 of referencePaths) {
+                const { object: object2, updated } = updateObjectWithJsonPath(
+                  docWithRef,
+                  path7,
+                  realPath,
                   newRealPath
                 );
+                docWithRef = object2;
+                hasUpdate = updated || hasUpdate;
+              }
+              if (hasUpdate) {
+                const collectionWithRef = this.tinaSchema.getCollectionByFullPath(pathToDocWithRef);
+                if (!collectionWithRef) {
+                  throw new Error(
+                    `Unable to find collection for ${pathToDocWithRef}`
+                  );
+                }
+                await this.database.put(
+                  pathToDocWithRef,
+                  docWithRef,
+                  collectionWithRef.name
+                );
               }
-              await this.database.put(refPath, refDoc, collection2);
             }
           }
           return this.getDocument(newRealPath);
         }
         if (alreadyExists === false) {
-          throw new Error(`Unable to update document, ${realPath} does not exist`);
+          throw new Error(
+            `Unable to update document, ${realPath} does not exist`
+          );
         }
         return this.updateResolveDocument({
           collection,
@@ -5109,6 +5425,7 @@ var Resolver = class {
           },
           collection: referencedCollection,
           hydrator: (path7) => path7
+          // just return the path
         }
       );
       const { edges } = resolvedCollectionConnection;
@@ -5176,82 +5493,83 @@ 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;
-          }
+      await this.database.query(
+        {
+          collection: c.name,
+          filterChain: makeFilterChain({
+            conditions: [
+              {
+                filterPath: REFS_REFERENCE_FIELD,
+                filterExpression: {
+                  _type: "string",
+                  _list: false,
+                  eq: id
+                }
+              }
+            ]
+          }),
+          sort: REFS_COLLECTIONS_SORT_KEY
+        },
+        (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 a map of references to 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] = [];
+      await this.database.query(
+        {
+          collection: c.name,
+          filterChain: makeFilterChain({
+            conditions: [
+              {
+                filterPath: REFS_REFERENCE_FIELD,
+                filterExpression: {
+                  _type: "string",
+                  _list: false,
+                  eq: id
+                }
               }
-              references[collection][refId].push({
-                path: ref.path,
-                field: ref.field
-              });
-              return refId;
-            }
-          );
+            ]
+          }),
+          sort: REFS_COLLECTIONS_SORT_KEY
+        },
+        (refId, rawItem) => {
+          if (!references[c.name]) {
+            references[c.name] = {};
+          }
+          if (!references[c.name][refId]) {
+            references[c.name][refId] = [];
+          }
+          const referencePath = rawItem?.[REFS_PATH_FIELD];
+          if (referencePath) {
+            references[c.name][refId].push(referencePath);
+          }
+          return refId;
         }
-      }
+      );
       return references;
     };
     this.buildFieldMutations = async (fieldParams, template, existingData) => {
-      var _a;
       const accum = {};
       for (const passwordField of template.fields.filter(
         (f) => f.type === "password"
@@ -5294,7 +5612,7 @@ var Resolver = class {
             accum[fieldName] = await this.buildObjectMutations(
               fieldValue,
               field,
-              existingData == null ? void 0 : existingData[fieldName]
+              existingData?.[fieldName]
             );
             break;
           case "password":
@@ -5313,7 +5631,7 @@ var Resolver = class {
             } else {
               accum[fieldName] = {
                 ...fieldValue,
-                value: (_a = existingData == null ? void 0 : existingData[fieldName]) == null ? void 0 : _a["value"]
+                value: existingData?.[fieldName]?.["value"]
               };
             }
             break;
@@ -5337,6 +5655,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(
@@ -5427,9 +5766,8 @@ var resolve = async ({
   isAudit,
   ctxUser
 }) => {
-  var _a;
   try {
-    const verboseValue = verbose != null ? verbose : true;
+    const verboseValue = verbose ?? true;
     const graphQLSchemaAst = await database.getGraphQLSchema();
     if (!graphQLSchemaAst) {
       throw new import_graphql5.GraphQLError("GraphQL schema not found");
@@ -5437,8 +5775,11 @@ 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,
-      flags: (_a = tinaConfig == null ? void 0 : tinaConfig.meta) == null ? void 0 : _a.flags
+      // @ts-ignore
+      flags: tinaConfig?.meta?.flags
     });
     const resolver = createResolver({
       config,
@@ -5454,8 +5795,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") {
@@ -5464,7 +5804,6 @@ var resolve = async ({
         throw new Error(`Unable to find lookup key for ${namedType}`);
       },
       fieldResolver: async (source = {}, _args = {}, _context, info) => {
-        var _a2, _b, _c, _d;
         try {
           const args = JSON.parse(JSON.stringify(_args));
           const returnType = (0, import_graphql5.getNamedType)(info.returnType).toString();
@@ -5481,8 +5820,7 @@ var resolve = async ({
               );
               const hasDocuments2 = collectionNode2.selectionSet.selections.find(
                 (x) => {
-                  var _a3;
-                  return ((_a3 = x == null ? void 0 : x.name) == null ? void 0 : _a3.value) === "documents";
+                  return x?.name?.value === "documents";
                 }
               );
               return tinaSchema.getCollections().map((collection) => {
@@ -5498,8 +5836,7 @@ var resolve = async ({
             );
             const hasDocuments = collectionNode.selectionSet.selections.find(
               (x) => {
-                var _a3;
-                return ((_a3 = x == null ? void 0 : x.name) == null ? void 0 : _a3.value) === "documents";
+                return x?.name?.value === "documents";
               }
             );
             return resolver.resolveCollection(
@@ -5518,7 +5855,7 @@ var resolve = async ({
             }
           }
           if (info.fieldName === "authenticate" || info.fieldName === "authorize") {
-            const sub = args.sub || (ctxUser == null ? void 0 : ctxUser.sub);
+            const sub = args.sub || ctxUser?.sub;
             const collection = tinaSchema.getCollections().find((c) => c.isAuthCollection);
             if (!collection) {
               throw new Error("Auth collection not found");
@@ -5566,7 +5903,7 @@ var resolve = async ({
             return user;
           }
           if (info.fieldName === "updatePassword") {
-            if (!(ctxUser == null ? void 0 : ctxUser.sub)) {
+            if (!ctxUser?.sub) {
               throw new Error("Not authorized");
             }
             if (!args.password) {
@@ -5607,11 +5944,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],
@@ -5634,6 +5973,9 @@ var resolve = async ({
           }
           const isCreation = lookup[info.fieldName] === "create";
           switch (lookup.resolveType) {
+            /**
+             * `node(id: $id)`
+             */
             case "nodeDocument":
               assertShape(
                 args,
@@ -5644,7 +5986,7 @@ var resolve = async ({
               if (typeof value === "string" && value !== "") {
                 return resolver.getDocument(value);
               }
-              if ((args == null ? void 0 : args.collection) && info.fieldName === "addPendingDocument") {
+              if (args?.collection && info.fieldName === "addPendingDocument") {
                 return resolver.resolveDocument({
                   args: { ...args, params: {} },
                   collection: args.collection,
@@ -5665,15 +6007,19 @@ 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),
+                  isUpdateName: Boolean(args?.params?.relativePath),
                   isAddPendingDocument: false,
                   isCollectionSpecific: false
                 });
                 return result;
               }
               return value;
+            /**
+             * eg `getMovieDocument.data.actors`
+             */
             case "multiCollectionDocumentList":
               if (Array.isArray(value)) {
                 return {
@@ -5683,9 +6029,17 @@ var resolve = async ({
                   })
                 };
               }
-              if (info.fieldName === "documents" && (value == null ? void 0 : value.collection) && (value == null ? void 0 : value.hasDocuments)) {
+              if (info.fieldName === "documents" && value?.collection && 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?.filter !== "undefined" && args?.filter !== null && // 2. Make sure that the collection name exists
+                  // @ts-ignore
+                  typeof value?.collection?.name === "string" && // 3. Make sure that the collection name is in the filter and is not undefined
+                  // @ts-ignore
+                  Object.keys(args.filter).includes(value?.collection?.name) && // @ts-ignore
+                  typeof args.filter[value?.collection?.name] !== "undefined"
+                ) {
                   filter = args.filter[value.collection.name];
                 }
                 return resolver.resolveCollectionConnection({
@@ -5693,12 +6047,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;
@@ -5713,11 +6075,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) {
@@ -5782,8 +6165,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;
@@ -5793,15 +6175,15 @@ var TinaLevelClient = class extends import_many_level.ManyLevelGuest {
 };
 
 // src/database/index.ts
-var import_node_path = __toESM(require("path"));
+var import_node_path = __toESM(require("node:path"));
 var import_graphql6 = require("graphql");
 var import_micromatch2 = __toESM(require("micromatch"));
 var import_js_sha12 = __toESM(require("js-sha1"));
 var import_lodash5 = __toESM(require("lodash.set"));
 var createLocalDatabase = (config) => {
-  const level = new TinaLevelClient(config == null ? void 0 : config.port);
+  const level = new TinaLevelClient(config?.port);
   level.openConnection();
-  const fsBridge = new FilesystemBridge((config == null ? void 0 : config.rootPath) || process.cwd());
+  const fsBridge = new FilesystemBridge(config?.rootPath || process.cwd());
   return new Database({
     bridge: fsBridge,
     ...config || {},
@@ -5874,7 +6256,7 @@ var Database = class {
         );
       }
       const metadata = await metadataLevel.get(`metadata_${key}`);
-      return metadata == null ? void 0 : metadata.value;
+      return metadata?.value;
     };
     this.setMetadata = async (key, value) => {
       await this.initLevel();
@@ -5896,14 +6278,14 @@ var Database = class {
         let level = this.contentLevel;
         if (this.appLevel) {
           collection = await this.collectionForPath(filepath);
-          if (collection == null ? void 0 : collection.isDetached) {
+          if (collection?.isDetached) {
             level = this.appLevel.sublevel(collection.name, SUBLEVEL_OPTIONS);
           }
         }
         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}`);
         }
@@ -5927,9 +6309,10 @@ var Database = class {
         collection
       );
       const indexDefinitions = await this.getIndexDefinitions(this.contentLevel);
-      const collectionIndexDefinitions = indexDefinitions == null ? void 0 : indexDefinitions[collection.name];
-      const normalizedPath = (0, import_schema_tools3.normalizePath)(filepath);
-      if (!(collection == null ? void 0 : collection.isDetached)) {
+      const collectionIndexDefinitions = indexDefinitions?.[collection.name];
+      const collectionReferences = (await this.getCollectionReferences())?.[collection.name];
+      const normalizedPath = (0, import_schema_tools4.normalizePath)(filepath);
+      if (!collection?.isDetached) {
         if (this.bridge) {
           await this.bridge.put(normalizedPath, stringifiedFile);
         }
@@ -5947,7 +6330,7 @@ var Database = class {
         }
       }
       let level = this.contentLevel;
-      if (collection == null ? void 0 : collection.isDetached) {
+      if (collection?.isDetached) {
         level = this.appLevel.sublevel(collection.name, SUBLEVEL_OPTIONS);
       }
       const folderTreeBuilder = new FolderTreeBuilder();
@@ -5956,17 +6339,26 @@ var Database = class {
       let delOps = [];
       if (!isGitKeep(normalizedPath, collection)) {
         putOps = [
+          ...makeRefOpsForDocument(
+            normalizedPath,
+            collection?.name,
+            collectionReferences,
+            dataFields,
+            "put",
+            level
+          ),
           ...makeIndexOpsForDocument(
             normalizedPath,
-            collection == null ? void 0 : collection.name,
+            collection?.name,
             collectionIndexDefinitions,
             dataFields,
             "put",
             level
           ),
+          // folder indices
           ...makeIndexOpsForDocument(
             normalizedPath,
-            `${collection == null ? void 0 : collection.name}_${folderKey}`,
+            `${collection?.name}_${folderKey}`,
             collectionIndexDefinitions,
             dataFields,
             "put",
@@ -5978,17 +6370,26 @@ var Database = class {
           SUBLEVEL_OPTIONS
         ).get(normalizedPath);
         delOps = existingItem ? [
+          ...makeRefOpsForDocument(
+            normalizedPath,
+            collection?.name,
+            collectionReferences,
+            existingItem,
+            "del",
+            level
+          ),
           ...makeIndexOpsForDocument(
             normalizedPath,
-            collection == null ? void 0 : collection.name,
+            collection?.name,
             collectionIndexDefinitions,
             existingItem,
             "del",
             level
           ),
+          // folder indices
           ...makeIndexOpsForDocument(
             normalizedPath,
-            `${collection == null ? void 0 : collection.name}_${folderKey}`,
+            `${collection?.name}_${folderKey}`,
             collectionIndexDefinitions,
             existingItem,
             "del",
@@ -6012,7 +6413,6 @@ var Database = class {
       await level.batch(ops);
     };
     this.put = async (filepath, data, collectionName) => {
-      var _a, _b;
       await this.initLevel();
       try {
         if (SYSTEM_FILES.includes(filepath)) {
@@ -6023,15 +6423,16 @@ var Database = class {
             const indexDefinitions = await this.getIndexDefinitions(
               this.contentLevel
             );
-            collectionIndexDefinitions = indexDefinitions == null ? void 0 : indexDefinitions[collectionName];
+            collectionIndexDefinitions = indexDefinitions?.[collectionName];
           }
-          const normalizedPath = (0, import_schema_tools3.normalizePath)(filepath);
+          const collectionReferences = (await this.getCollectionReferences())?.[collectionName];
+          const normalizedPath = (0, import_schema_tools4.normalizePath)(filepath);
           const dataFields = await this.formatBodyOnPayload(filepath, data);
           const collection = await this.collectionForPath(filepath);
           if (!collection) {
             throw new import_graphql6.GraphQLError(`Unable to find collection for ${filepath}.`);
           }
-          if (((_a = collection.match) == null ? void 0 : _a.exclude) || ((_b = collection.match) == null ? void 0 : _b.include)) {
+          if (collection.match?.exclude || collection.match?.include) {
             const matches = this.tinaSchema.getMatches({ collection });
             const match = import_micromatch2.default.isMatch(filepath, matches);
             if (!match) {
@@ -6045,7 +6446,7 @@ var Database = class {
           const stringifiedFile = filepath.endsWith(
             `.gitkeep.${collection.format || "md"}`
           ) ? "" : await this.stringifyFile(filepath, dataFields, collection);
-          if (!(collection == null ? void 0 : collection.isDetached)) {
+          if (!collection?.isDetached) {
             if (this.bridge) {
               await this.bridge.put(normalizedPath, stringifiedFile);
             }
@@ -6067,11 +6468,19 @@ var Database = class {
             filepath,
             collection.path || ""
           );
-          const level = (collection == null ? void 0 : collection.isDetached) ? this.appLevel.sublevel(collection == null ? void 0 : collection.name, SUBLEVEL_OPTIONS) : this.contentLevel;
+          const level = collection?.isDetached ? this.appLevel.sublevel(collection?.name, SUBLEVEL_OPTIONS) : this.contentLevel;
           let putOps = [];
           let delOps = [];
           if (!isGitKeep(normalizedPath, collection)) {
             putOps = [
+              ...makeRefOpsForDocument(
+                normalizedPath,
+                collectionName,
+                collectionReferences,
+                dataFields,
+                "put",
+                level
+              ),
               ...makeIndexOpsForDocument(
                 normalizedPath,
                 collectionName,
@@ -6080,9 +6489,10 @@ var Database = class {
                 "put",
                 level
               ),
+              // folder indices
               ...makeIndexOpsForDocument(
                 normalizedPath,
-                `${collection == null ? void 0 : collection.name}_${folderKey}`,
+                `${collection?.name}_${folderKey}`,
                 collectionIndexDefinitions,
                 dataFields,
                 "put",
@@ -6094,6 +6504,14 @@ var Database = class {
               SUBLEVEL_OPTIONS
             ).get(normalizedPath);
             delOps = existingItem ? [
+              ...makeRefOpsForDocument(
+                normalizedPath,
+                collectionName,
+                collectionReferences,
+                existingItem,
+                "del",
+                level
+              ),
               ...makeIndexOpsForDocument(
                 normalizedPath,
                 collectionName,
@@ -6102,9 +6520,10 @@ var Database = class {
                 "del",
                 level
               ),
+              // folder indices
               ...makeIndexOpsForDocument(
                 normalizedPath,
-                `${collection == null ? void 0 : collection.name}_${folderKey}`,
+                `${collection?.name}_${folderKey}`,
                 collectionIndexDefinitions,
                 existingItem,
                 "del",
@@ -6179,9 +6598,10 @@ var Database = class {
         aliasedData,
         extension,
         writeTemplateKey,
+        //templateInfo.type === 'union',
         {
-          frontmatterFormat: collection == null ? void 0 : collection.frontmatterFormat,
-          frontmatterDelimiters: collection == null ? void 0 : collection.frontmatterDelimiters
+          frontmatterFormat: collection?.frontmatterFormat,
+          frontmatterDelimiters: collection?.frontmatterDelimiters
         }
       );
     };
@@ -6196,7 +6616,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) {
@@ -6209,7 +6629,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(
@@ -6217,11 +6637,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);
@@ -6229,7 +6650,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(
@@ -6245,7 +6666,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`)
           )}`
         );
@@ -6253,6 +6674,22 @@ var Database = class {
       this.tinaSchema = await createSchema({ schema });
       return this.tinaSchema;
     };
+    this.getCollectionReferences = async (level) => {
+      if (this.collectionReferences) {
+        return this.collectionReferences;
+      }
+      const result = {};
+      const schema = await this.getSchema(level || this.contentLevel);
+      const collections = schema.getCollections();
+      for (const collection of collections) {
+        const collectionReferences = this.tinaSchema.findReferencesFromCollection(
+          collection.name
+        );
+        result[collection.name] = collectionReferences;
+      }
+      this.collectionReferences = result;
+      return result;
+    };
     this.getIndexDefinitions = async (level) => {
       if (!this.collectionIndexDefinitions) {
         await new Promise(async (resolve2, reject) => {
@@ -6262,10 +6699,53 @@ var Database = class {
             const collections = schema.getCollections();
             for (const collection of collections) {
               const indexDefinitions = {
-                [DEFAULT_COLLECTION_SORT_KEY]: { fields: [] }
+                [DEFAULT_COLLECTION_SORT_KEY]: { fields: [] },
+                // provide a default sort key which is the file sort
+                // pseudo-index for the collection's references
+                [REFS_COLLECTIONS_SORT_KEY]: {
+                  fields: [
+                    {
+                      name: REFS_REFERENCE_FIELD,
+                      type: "string",
+                      list: false
+                    },
+                    {
+                      name: REFS_PATH_FIELD,
+                      type: "string",
+                      list: false
+                    }
+                  ]
+                }
               };
-              if (collection.fields) {
-                for (const field of collection.fields) {
+              let fields = [];
+              if (collection.templates) {
+                const templateFieldMap = {};
+                const conflictedFields = /* @__PURE__ */ new Set();
+                for (const template of collection.templates) {
+                  for (const field of template.fields) {
+                    if (!templateFieldMap[field.name]) {
+                      templateFieldMap[field.name] = field;
+                    } else {
+                      if (templateFieldMap[field.name].type !== field.type) {
+                        console.warn(
+                          `Field ${field.name} has conflicting types in templates - skipping index`
+                        );
+                        conflictedFields.add(field.name);
+                      }
+                    }
+                  }
+                }
+                for (const conflictedField in conflictedFields) {
+                  delete templateFieldMap[conflictedField];
+                }
+                for (const field of Object.values(templateFieldMap)) {
+                  fields.push(field);
+                }
+              } else if (collection.fields) {
+                fields = collection.fields;
+              }
+              if (fields) {
+                for (const field of fields) {
                   if (field.indexed !== void 0 && field.indexed === false || field.type === "object") {
                     continue;
                   }
@@ -6290,8 +6770,8 @@ var Database = class {
                       );
                       return {
                         name: indexField.name,
-                        type: field == null ? void 0 : field.type,
-                        list: !!(field == null ? void 0 : field.list)
+                        type: field?.type,
+                        list: !!field?.list
                       };
                     })
                   };
@@ -6317,7 +6797,6 @@ var Database = class {
       return true;
     };
     this.query = async (queryOptions, hydrator) => {
-      var _a;
       await this.initLevel();
       const {
         first,
@@ -6345,14 +6824,14 @@ var Database = class {
       const allIndexDefinitions = await this.getIndexDefinitions(
         this.contentLevel
       );
-      const indexDefinitions = allIndexDefinitions == null ? void 0 : allIndexDefinitions[collection.name];
+      const indexDefinitions = allIndexDefinitions?.[collection.name];
       if (!indexDefinitions) {
         throw new Error(`No indexDefinitions for collection ${collection.name}`);
       }
       const filterChain = coerceFilterChainOperands(rawFilterChain);
-      const indexDefinition = sort && (indexDefinitions == null ? void 0 : indexDefinitions[sort]);
+      const indexDefinition = sort && indexDefinitions?.[sort];
       const filterSuffixes = indexDefinition && makeFilterSuffixes(filterChain, indexDefinition);
-      const level = (collection == null ? void 0 : collection.isDetached) ? this.appLevel.sublevel(collection == null ? void 0 : collection.name, SUBLEVEL_OPTIONS) : this.contentLevel;
+      const level = collection?.isDetached ? this.appLevel.sublevel(collection?.name, SUBLEVEL_OPTIONS) : this.contentLevel;
       const rootLevel = level.sublevel(
         CONTENT_ROOT_PREFIX,
         SUBLEVEL_OPTIONS
@@ -6362,17 +6841,17 @@ var Database = class {
         SUBLEVEL_OPTIONS
       ).sublevel(sort, SUBLEVEL_OPTIONS) : rootLevel;
       if (!query.gt && !query.gte) {
-        query.gte = (filterSuffixes == null ? void 0 : filterSuffixes.left) ? filterSuffixes.left : "";
+        query.gte = filterSuffixes?.left ? filterSuffixes.left : "";
       }
       if (!query.lt && !query.lte) {
-        query.lte = (filterSuffixes == null ? void 0 : filterSuffixes.right) ? `${filterSuffixes.right}\uFFFF` : "\uFFFF";
+        query.lte = filterSuffixes?.right ? `${filterSuffixes.right}\uFFFF` : "\uFFFF";
       }
       let edges = [];
       let startKey = "";
       let endKey = "";
       let hasPreviousPage = false;
       let hasNextPage = false;
-      const fieldsPattern = ((_a = indexDefinition == null ? void 0 : indexDefinition.fields) == null ? void 0 : _a.length) ? `${indexDefinition.fields.map((p) => `(?<${p.name}>.+)${INDEX_KEY_FIELD_SEPARATOR}`).join("")}` : "";
+      const fieldsPattern = indexDefinition?.fields?.length ? `${indexDefinition.fields.map((p) => `(?<${p.name}>.+)${INDEX_KEY_FIELD_SEPARATOR}`).join("")}` : "";
       const valuesRegex = indexDefinition ? new RegExp(`^${fieldsPattern}(?<_filepath_>.+)`) : new RegExp(`^(?<_filepath_>.+)`);
       const itemFilter = makeFilter({ filterChain });
       const iterator = sublevel.iterator(query);
@@ -6414,29 +6893,36 @@ var Database = class {
         }
         startKey = startKey || key || "";
         endKey = key || "";
-        edges = [...edges, { cursor: key, path: filepath }];
+        edges = [...edges, { cursor: key, path: filepath, value: itemRecord }];
       }
       return {
-        edges: await sequential(edges, async (edge) => {
-          try {
-            const node = await hydrator(edge.path);
-            return {
-              node,
-              cursor: btoa(edge.cursor)
-            };
-          } catch (error) {
-            console.log(error);
-            if (error instanceof Error && (!edge.path.includes(".tina/__generated__/_graphql.json") || !edge.path.includes("tina/__generated__/_graphql.json"))) {
-              throw new TinaQueryError({
-                originalError: error,
-                file: edge.path,
-                collection: collection.name,
-                stack: error.stack
-              });
+        edges: await sequential(
+          edges,
+          async ({
+            cursor,
+            path: path7,
+            value
+          }) => {
+            try {
+              const node = await hydrator(path7, value);
+              return {
+                node,
+                cursor: btoa(cursor)
+              };
+            } catch (error) {
+              console.log(error);
+              if (error instanceof Error && (!path7.includes(".tina/__generated__/_graphql.json") || !path7.includes("tina/__generated__/_graphql.json"))) {
+                throw new TinaQueryError({
+                  originalError: error,
+                  file: path7,
+                  collection: collection.name,
+                  stack: error.stack
+                });
+              }
+              throw error;
             }
-            throw error;
           }
-        }),
+        ),
         pageInfo: {
           hasPreviousPage,
           hasNextPage,
@@ -6461,7 +6947,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")
                 )
               )
@@ -6486,15 +6972,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(
@@ -6560,13 +7046,14 @@ var Database = class {
           documentPaths,
           async (collection, documentPaths2) => {
             if (collection && !collection.isDetached) {
-              await _indexContent(
-                this,
-                this.contentLevel,
-                documentPaths2,
+              await _indexContent({
+                database: this,
+                level: this.contentLevel,
+                documentPaths: documentPaths2,
                 enqueueOps,
-                collection
-              );
+                collection,
+                isPartialReindex: true
+              });
             }
           }
         );
@@ -6582,17 +7069,18 @@ var Database = class {
         throw new Error(`No collection found for path: ${filepath}`);
       }
       const indexDefinitions = await this.getIndexDefinitions(this.contentLevel);
-      const collectionIndexDefinitions = indexDefinitions == null ? void 0 : indexDefinitions[collection.name];
+      const collectionReferences = (await this.getCollectionReferences())?.[collection.name];
+      const collectionIndexDefinitions = indexDefinitions?.[collection.name];
       let level = this.contentLevel;
-      if (collection == null ? void 0 : collection.isDetached) {
-        level = this.appLevel.sublevel(collection == null ? void 0 : collection.name, SUBLEVEL_OPTIONS);
+      if (collection?.isDetached) {
+        level = this.appLevel.sublevel(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(
@@ -6600,16 +7088,25 @@ var Database = class {
           collection.path || ""
         );
         await this.contentLevel.batch([
+          ...makeRefOpsForDocument(
+            normalizedPath,
+            collection.name,
+            collectionReferences,
+            item,
+            "del",
+            level
+          ),
           ...makeIndexOpsForDocument(
-            filepath,
+            normalizedPath,
             collection.name,
             collectionIndexDefinitions,
             item,
             "del",
             level
           ),
+          // folder indices
           ...makeIndexOpsForDocument(
-            filepath,
+            normalizedPath,
             `${collection.name}_${folderKey}`,
             collectionIndexDefinitions,
             item,
@@ -6618,17 +7115,17 @@ var Database = class {
           ),
           {
             type: "del",
-            key: itemKey,
+            key: normalizedPath,
             sublevel: rootSublevel
           }
         ]);
       }
-      if (!(collection == null ? void 0 : collection.isDetached)) {
+      if (!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}`,
@@ -6663,20 +7160,26 @@ var Database = class {
             );
             const doc = await level2.keys({ limit: 1 }).next();
             if (!doc) {
-              await _indexContent(
-                this,
-                level2,
-                contentPaths,
+              await _indexContent({
+                database: this,
+                level: level2,
+                documentPaths: contentPaths,
                 enqueueOps,
                 collection,
-                userFields.map((field) => [
+                passwordFields: userFields.map((field) => [
                   ...field.path,
                   field.passwordFieldName
                 ])
-              );
+              });
             }
           } else {
-            await _indexContent(this, level, contentPaths, enqueueOps, collection);
+            await _indexContent({
+              database: this,
+              level,
+              documentPaths: contentPaths,
+              enqueueOps,
+              collection
+            });
           }
         }
       );
@@ -6712,7 +7215,7 @@ var Database = class {
       );
     }
     const metadata = await metadataLevel.get("metadata");
-    return metadata == null ? void 0 : metadata.version;
+    return metadata?.version;
   }
   async initLevel() {
     if (this.contentLevel) {
@@ -6762,6 +7265,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;
@@ -6795,7 +7301,7 @@ var hashPasswordVisitor = async (node, path7) => {
 };
 var visitNodes = async (node, path7, callback) => {
   const [currentLevel, ...remainingLevels] = path7;
-  if (!(remainingLevels == null ? void 0 : remainingLevels.length)) {
+  if (!remainingLevels?.length) {
     return callback(node, path7);
   }
   if (Array.isArray(node[currentLevel])) {
@@ -6811,18 +7317,27 @@ var hashPasswordValues = async (data, passwordFields) => Promise.all(
     async (passwordField) => visitNodes(data, passwordField, hashPasswordVisitor)
   )
 );
-var isGitKeep = (filepath, collection) => filepath.endsWith(`.gitkeep.${(collection == null ? void 0 : collection.format) || "md"}`);
-var _indexContent = async (database, level, documentPaths, enqueueOps, collection, passwordFields) => {
+var isGitKeep = (filepath, collection) => filepath.endsWith(`.gitkeep.${collection?.format || "md"}`);
+var _indexContent = async ({
+  database,
+  level,
+  documentPaths,
+  enqueueOps,
+  collection,
+  passwordFields,
+  isPartialReindex
+}) => {
   let collectionIndexDefinitions;
   let collectionPath;
   if (collection) {
     const indexDefinitions = await database.getIndexDefinitions(level);
-    collectionIndexDefinitions = indexDefinitions == null ? void 0 : indexDefinitions[collection.name];
+    collectionIndexDefinitions = indexDefinitions?.[collection.name];
     if (!collectionIndexDefinitions) {
       throw new Error(`No indexDefinitions for collection ${collection.name}`);
     }
     collectionPath = collection.path;
   }
+  const collectionReferences = (await database.getCollectionReferences())?.[collection?.name];
   const tinaSchema = await database.getSchema();
   let templateInfo = null;
   if (collection) {
@@ -6840,27 +7355,77 @@ var _indexContent = async (database, level, documentPaths, enqueueOps, collectio
       if (!aliasedData) {
         return;
       }
-      if (passwordFields == null ? void 0 : passwordFields.length) {
+      if (passwordFields?.length) {
         await hashPasswordValues(aliasedData, passwordFields);
       }
-      const normalizedPath = (0, import_schema_tools3.normalizePath)(filepath);
+      const normalizedPath = (0, import_schema_tools4.normalizePath)(filepath);
+      const rootSublevel = level.sublevel(
+        CONTENT_ROOT_PREFIX,
+        SUBLEVEL_OPTIONS
+      );
       const folderKey = folderTreeBuilder.update(
         normalizedPath,
         collectionPath || ""
       );
+      if (isPartialReindex) {
+        const item = await rootSublevel.get(normalizedPath);
+        if (item) {
+          await database.contentLevel.batch([
+            ...makeRefOpsForDocument(
+              normalizedPath,
+              collection?.name,
+              collectionReferences,
+              item,
+              "del",
+              level
+            ),
+            ...makeIndexOpsForDocument(
+              normalizedPath,
+              collection.name,
+              collectionIndexDefinitions,
+              item,
+              "del",
+              level
+            ),
+            // folder indices
+            ...makeIndexOpsForDocument(
+              normalizedPath,
+              `${collection.name}_${folderKey}`,
+              collectionIndexDefinitions,
+              item,
+              "del",
+              level
+            ),
+            {
+              type: "del",
+              key: normalizedPath,
+              sublevel: rootSublevel
+            }
+          ]);
+        }
+      }
       if (!isGitKeep(filepath, collection)) {
         await enqueueOps([
+          ...makeRefOpsForDocument(
+            normalizedPath,
+            collection?.name,
+            collectionReferences,
+            aliasedData,
+            "put",
+            level
+          ),
           ...makeIndexOpsForDocument(
             normalizedPath,
-            collection == null ? void 0 : collection.name,
+            collection?.name,
             collectionIndexDefinitions,
             aliasedData,
             "put",
             level
           ),
+          // folder indexes
           ...makeIndexOpsForDocument(
             normalizedPath,
-            `${collection == null ? void 0 : collection.name}_${folderKey}`,
+            `${collection?.name}_${folderKey}`,
             collectionIndexDefinitions,
             aliasedData,
             "put",
@@ -6881,7 +7446,7 @@ var _indexContent = async (database, level, documentPaths, enqueueOps, collectio
       throw new TinaFetchError(`Unable to seed ${filepath}`, {
         originalError: error,
         file: filepath,
-        collection: collection == null ? void 0 : collection.name,
+        collection: collection?.name,
         stack: error.stack
       });
     }
@@ -6907,11 +7472,12 @@ var _deleteIndexContent = async (database, documentPaths, enqueueOps, collection
     const indexDefinitions = await database.getIndexDefinitions(
       database.contentLevel
     );
-    collectionIndexDefinitions = indexDefinitions == null ? void 0 : indexDefinitions[collection.name];
+    collectionIndexDefinitions = indexDefinitions?.[collection.name];
     if (!collectionIndexDefinitions) {
       throw new Error(`No indexDefinitions for collection ${collection.name}`);
     }
   }
+  const collectionReferences = (await database.getCollectionReferences())?.[collection?.name];
   const tinaSchema = await database.getSchema();
   let templateInfo = null;
   if (collection) {
@@ -6923,18 +7489,26 @@ 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(
         itemKey,
-        (collection == null ? void 0 : collection.path) || ""
+        collection?.path || ""
       );
       const aliasedData = templateInfo ? replaceNameOverrides(
         getTemplateForFile(templateInfo, item),
         item
       ) : item;
       await enqueueOps([
+        ...makeRefOpsForDocument(
+          itemKey,
+          collection?.name,
+          collectionReferences,
+          aliasedData,
+          "del",
+          database.contentLevel
+        ),
         ...makeIndexOpsForDocument(
           itemKey,
           collection.name,
@@ -6943,9 +7517,10 @@ var _deleteIndexContent = async (database, documentPaths, enqueueOps, collection
           "del",
           database.contentLevel
         ),
+        // folder indexes
         ...makeIndexOpsForDocument(
           itemKey,
-          `${collection == null ? void 0 : collection.name}_${folderKey}`,
+          `${collection?.name}_${folderKey}`,
           collectionIndexDefinitions,
           aliasedData,
           "del",
@@ -7009,14 +7584,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)) {
@@ -7030,12 +7605,12 @@ var getChangedFiles = async ({
           }
         }
       }
-      if (await (B == null ? void 0 : B.type()) === "tree") {
+      if (await B?.type() === "tree") {
         return;
       }
       if (matches) {
-        const oidA = await (A == null ? void 0 : A.oid());
-        const oidB = await (B == null ? void 0 : B.oid());
+        const oidA = await A?.oid();
+        const oidB = await B?.oid();
         if (oidA !== oidB) {
           if (oidA === void 0) {
             results.added.push(relativePath);
@@ -7063,8 +7638,8 @@ var import_path5 = __toESM(require("path"));
 var import_normalize_path = __toESM(require("normalize-path"));
 var FilesystemBridge = class {
   constructor(rootPath, outputPath) {
-    this.rootPath = rootPath || "";
-    this.outputPath = outputPath || rootPath;
+    this.rootPath = import_path5.default.resolve(rootPath);
+    this.outputPath = outputPath ? import_path5.default.resolve(outputPath) : this.rootPath;
   }
   async glob(pattern, extension) {
     const basePath = import_path5.default.join(this.outputPath, ...pattern.split("/"));
@@ -7076,19 +7651,19 @@ var FilesystemBridge = class {
       }
     );
     const posixRootPath = (0, import_normalize_path.default)(this.outputPath);
-    return items.map((item) => {
-      return item.replace(posixRootPath, "").replace(/^\/|\/$/g, "");
-    });
+    return items.map(
+      (item) => item.substring(posixRootPath.length).replace(/^\/|\/$/g, "")
+    );
   }
   async delete(filepath) {
     await import_fs_extra2.default.remove(import_path5.default.join(this.outputPath, filepath));
   }
   async get(filepath) {
-    return import_fs_extra2.default.readFileSync(import_path5.default.join(this.outputPath, filepath)).toString();
+    return (await import_fs_extra2.default.readFile(import_path5.default.join(this.outputPath, filepath))).toString();
   }
   async put(filepath, data, basePathOverride) {
     const basePath = basePathOverride || this.outputPath;
-    await import_fs_extra2.default.outputFileSync(import_path5.default.join(basePath, filepath), data);
+    await import_fs_extra2.default.outputFile(import_path5.default.join(basePath, filepath), data);
   }
 };
 var AuditFileSystemBridge = class extends FilesystemBridge {
@@ -7158,17 +7733,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,
@@ -7201,6 +7785,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({
@@ -7231,6 +7824,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];
@@ -7286,6 +7890,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,
@@ -7298,6 +7909,7 @@ var IsomorphicBridge = class {
           })
         ],
         message: this.commitMessage,
+        // TODO these should be configurable
         author: this.getAuthor(),
         committer: this.getCommitter()
       }
@@ -7536,5 +8148,5 @@ var buildSchema = async (config, flags) => {
   transformDocument,
   transformDocumentIntoPayload
 });
-//! Replaces _.flattenDeep()
 //! Replaces _.get()
+//! Replaces _.flattenDeep()