@tinacms/graphql 1.4.34 → 1.4.35

package/dist/builder/index.d.ts

@@ -134,6 +134,20 @@ export declare class Builder {
      * @param collections
      */
     buildDeleteCollectionDocumentMutation: (collections: Collection<true>[]) => Promise<FieldDefinitionNode>;
+    /**
+     * ```graphql
+     * # ex.
+     * {
+     *   createFolder(folderName: $folderName, params: $params) {
+     *     id
+     *     data {...}
+     *   }
+     * }
+     * ```
+     *
+     * @param collections
+     */
+    buildCreateCollectionFolderMutation: () => Promise<FieldDefinitionNode>;
     /**
      * ```graphql
      * # ex.

package/dist/index.js

@@ -1685,6 +1685,25 @@ var Builder = class {
         type: astBuilder.TYPES.MultiCollectionDocument
       });
     };
+    this.buildCreateCollectionFolderMutation = async () => {
+      return astBuilder.FieldDefinition({
+        name: "createFolder",
+        args: [
+          astBuilder.InputValueDefinition({
+            name: "collection",
+            required: false,
+            type: astBuilder.TYPES.String
+          }),
+          astBuilder.InputValueDefinition({
+            name: "relativePath",
+            required: true,
+            type: astBuilder.TYPES.String
+          })
+        ],
+        required: true,
+        type: astBuilder.TYPES.MultiCollectionDocument
+      });
+    };
     this.collectionDocument = async (collection) => {
       const name = NAMER.queryName([collection.name]);
       const type = await this._buildCollectionDocumentType(collection);
@@ -2855,7 +2874,7 @@ var validateField = async (field) => {
 // package.json
 var package_default = {
   name: "@tinacms/graphql",
-  version: "1.4.34",
+  version: "1.4.35",
   main: "dist/index.js",
   module: "dist/index.mjs",
   typings: "dist/index.d.ts",
@@ -3095,6 +3114,9 @@ var _buildSchema = async (builder, tinaSchema) => {
   mutationTypeDefinitionFields.push(
     await builder.buildCreateCollectionDocumentMutation(collections)
   );
+  mutationTypeDefinitionFields.push(
+    await builder.buildCreateCollectionFolderMutation()
+  );
   await sequential(collections, async (collection) => {
     queryTypeDefinitionFields.push(await builder.collectionDocument(collection));
     if (collection.isAuthCollection) {
@@ -4877,6 +4899,7 @@ var Resolver = class {
       isMutation,
       isCreation,
       isDeletion,
+      isFolderCreation,
       isAddPendingDocument,
       isCollectionSpecific,
       isUpdateName
@@ -4900,7 +4923,10 @@ var Resolver = class {
         (yup3) => yup3.object({ relativePath: yup3.string().required() })
       );
       const collection = await this.tinaSchema.getCollection(collectionLookup);
-      const realPath = import_path3.default.join(collection == null ? void 0 : collection.path, args.relativePath);
+      let realPath = import_path3.default.join(collection == null ? void 0 : collection.path, args.relativePath);
+      if (isFolderCreation) {
+        realPath = `${realPath}/.gitkeep`;
+      }
       const alreadyExists = await this.database.documentExists(realPath);
       if (isMutation) {
         if (isCreation) {
@@ -4913,6 +4939,16 @@ var Resolver = class {
             args,
             isAddPendingDocument
           });
+        } else if (isFolderCreation) {
+          if (alreadyExists === true) {
+            throw new Error(`Unable to add folder, ${realPath} already exists`);
+          }
+          await this.database.put(
+            realPath,
+            { _is_tina_folder_placeholder: true },
+            collection.name
+          );
+          return this.getDocument(realPath);
         }
         if (!alreadyExists) {
           if (isDeletion) {
@@ -5475,7 +5511,8 @@ var resolve = async ({
                 NAMER.documentQueryName(),
                 "createDocument",
                 "updateDocument",
-                "deleteDocument"
+                "deleteDocument",
+                "createFolder"
               ].includes(info.fieldName)) {
                 const result2 = await resolver.resolveDocument({
                   args,
@@ -5483,6 +5520,7 @@ var resolve = async ({
                   isMutation,
                   isCreation,
                   isDeletion: info.fieldName === "deleteDocument",
+                  isFolderCreation: info.fieldName === "createFolder",
                   isUpdateName: Boolean((_a2 = args == null ? void 0 : args.params) == null ? void 0 : _a2.relativePath),
                   isAddPendingDocument: false,
                   isCollectionSpecific: false
@@ -5826,6 +5864,7 @@ var Database = class {
     this.put = async (filepath, data, collectionName) => {
       var _a, _b;
       await this.initLevel();
+      const isGitKeep = filepath.endsWith(".gitkeep");
       try {
         if (SYSTEM_FILES.includes(filepath)) {
           throw new Error(`Unexpected put for config file ${filepath}`);
@@ -5854,11 +5893,7 @@ var Database = class {
               );
             }
           }
-          const stringifiedFile = await this.stringifyFile(
-            filepath,
-            dataFields,
-            collection
-          );
+          const stringifiedFile = isGitKeep ? "" : await this.stringifyFile(filepath, dataFields, collection);
           if (!(collection == null ? void 0 : collection.isDetached)) {
             if (this.bridge) {
               await this.bridge.put(normalizedPath, stringifiedFile);

package/dist/index.mjs

@@ -1622,6 +1622,25 @@ var Builder = class {
         type: astBuilder.TYPES.MultiCollectionDocument
       });
     };
+    this.buildCreateCollectionFolderMutation = async () => {
+      return astBuilder.FieldDefinition({
+        name: "createFolder",
+        args: [
+          astBuilder.InputValueDefinition({
+            name: "collection",
+            required: false,
+            type: astBuilder.TYPES.String
+          }),
+          astBuilder.InputValueDefinition({
+            name: "relativePath",
+            required: true,
+            type: astBuilder.TYPES.String
+          })
+        ],
+        required: true,
+        type: astBuilder.TYPES.MultiCollectionDocument
+      });
+    };
     this.collectionDocument = async (collection) => {
       const name = NAMER.queryName([collection.name]);
       const type = await this._buildCollectionDocumentType(collection);
@@ -2788,7 +2807,7 @@ var validateField = async (field) => {
 // package.json
 var package_default = {
   name: "@tinacms/graphql",
-  version: "1.4.34",
+  version: "1.4.35",
   main: "dist/index.js",
   module: "dist/index.mjs",
   typings: "dist/index.d.ts",
@@ -3027,6 +3046,9 @@ var _buildSchema = async (builder, tinaSchema) => {
   mutationTypeDefinitionFields.push(
     await builder.buildCreateCollectionDocumentMutation(collections)
   );
+  mutationTypeDefinitionFields.push(
+    await builder.buildCreateCollectionFolderMutation()
+  );
   await sequential(collections, async (collection) => {
     queryTypeDefinitionFields.push(await builder.collectionDocument(collection));
     if (collection.isAuthCollection) {
@@ -4804,6 +4826,7 @@ var Resolver = class {
       isMutation,
       isCreation,
       isDeletion,
+      isFolderCreation,
       isAddPendingDocument,
       isCollectionSpecific,
       isUpdateName
@@ -4827,7 +4850,10 @@ var Resolver = class {
         (yup3) => yup3.object({ relativePath: yup3.string().required() })
       );
       const collection = await this.tinaSchema.getCollection(collectionLookup);
-      const realPath = path3.join(collection?.path, args.relativePath);
+      let realPath = path3.join(collection?.path, args.relativePath);
+      if (isFolderCreation) {
+        realPath = `${realPath}/.gitkeep`;
+      }
       const alreadyExists = await this.database.documentExists(realPath);
       if (isMutation) {
         if (isCreation) {
@@ -4840,6 +4866,16 @@ var Resolver = class {
             args,
             isAddPendingDocument
           });
+        } else if (isFolderCreation) {
+          if (alreadyExists === true) {
+            throw new Error(`Unable to add folder, ${realPath} already exists`);
+          }
+          await this.database.put(
+            realPath,
+            { _is_tina_folder_placeholder: true },
+            collection.name
+          );
+          return this.getDocument(realPath);
         }
         if (!alreadyExists) {
           if (isDeletion) {
@@ -5397,7 +5433,8 @@ var resolve = async ({
                 NAMER.documentQueryName(),
                 "createDocument",
                 "updateDocument",
-                "deleteDocument"
+                "deleteDocument",
+                "createFolder"
               ].includes(info.fieldName)) {
                 const result2 = await resolver.resolveDocument({
                   args,
@@ -5405,6 +5442,7 @@ var resolve = async ({
                   isMutation,
                   isCreation,
                   isDeletion: info.fieldName === "deleteDocument",
+                  isFolderCreation: info.fieldName === "createFolder",
                   isUpdateName: Boolean(args?.params?.relativePath),
                   isAddPendingDocument: false,
                   isCollectionSpecific: false
@@ -5747,6 +5785,7 @@ var Database = class {
     };
     this.put = async (filepath, data, collectionName) => {
       await this.initLevel();
+      const isGitKeep = filepath.endsWith(".gitkeep");
       try {
         if (SYSTEM_FILES.includes(filepath)) {
           throw new Error(`Unexpected put for config file ${filepath}`);
@@ -5775,11 +5814,7 @@ var Database = class {
               );
             }
           }
-          const stringifiedFile = await this.stringifyFile(
-            filepath,
-            dataFields,
-            collection
-          );
+          const stringifiedFile = isGitKeep ? "" : await this.stringifyFile(filepath, dataFields, collection);
           if (!collection?.isDetached) {
             if (this.bridge) {
               await this.bridge.put(normalizedPath, stringifiedFile);

package/dist/resolver/index.d.ts

@@ -52,7 +52,9 @@ export declare class Resolver {
     constructor(init: ResolverConfig);
     resolveCollection: (args: any, collectionName: string, hasDocuments?: boolean) => Promise<{
         fields: TinaField<true>[];
-        templates?: undefined;
+        templates?: undefined; /**
+         * createDocument, create<Collection>Document
+         */
         label?: string;
         name: string;
         path: string;
@@ -66,6 +68,9 @@ export declare class Resolver {
         ui?: import("@tinacms/schema-tools").UICollection<any, any, any>;
         defaultItem?: import("@tinacms/schema-tools").DefaultItem<Record<string, any>>;
         frontmatterFormat?: "json" | "yaml" | "toml";
+        /**
+         * For generic functions (like `createDocument()` and `updateDocument()`), `collection` is the top key of the `params`
+         */
         frontmatterDelimiters?: string | [string, string];
         match?: {
             include?: string;
@@ -94,6 +99,9 @@ export declare class Resolver {
         ui?: import("@tinacms/schema-tools").UICollection<any, any, any>;
         defaultItem?: import("@tinacms/schema-tools").DefaultItem<Record<string, any>>;
         frontmatterFormat?: "json" | "yaml" | "toml";
+        /**
+         * For generic functions (like `createDocument()` and `updateDocument()`), `collection` is the top key of the `params`
+         */
         frontmatterDelimiters?: string | [string, string];
         match?: {
             include?: string;
@@ -237,12 +245,13 @@ export declare class Resolver {
      * values are not eliminated from Tina when new values are saved
      */
     resolveLegacyValues: (oldDoc: any, collection: Collection<true>) => {};
-    resolveDocument: ({ args, collection: collectionName, isMutation, isCreation, isDeletion, isAddPendingDocument, isCollectionSpecific, isUpdateName, }: {
+    resolveDocument: ({ args, collection: collectionName, isMutation, isCreation, isDeletion, isFolderCreation, isAddPendingDocument, isCollectionSpecific, isUpdateName, }: {
         args: unknown;
         collection?: string;
         isMutation: boolean;
         isCreation?: boolean;
         isDeletion?: boolean;
+        isFolderCreation?: boolean;
         isAddPendingDocument?: boolean;
         isCollectionSpecific?: boolean;
         isUpdateName?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinacms/graphql",
-  "version": "1.4.34",
+  "version": "1.4.35",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "typings": "dist/index.d.ts",
@@ -24,8 +24,8 @@
   },
   "dependencies": {
     "@iarna/toml": "^2.2.5",
-    "@tinacms/mdx": "1.3.24",
-    "@tinacms/schema-tools": "1.4.15",
+    "@tinacms/mdx": "1.3.25",
+    "@tinacms/schema-tools": "1.4.16",
     "abstract-level": "^1.0.3",
     "body-parser": "^1.19.0",
     "cors": "^2.8.5",
@@ -58,8 +58,8 @@
     "directory": "packages/tina-graphql"
   },
   "devDependencies": {
-    "@tinacms/schema-tools": "1.4.15",
-    "@tinacms/scripts": "1.1.3",
+    "@tinacms/schema-tools": "1.4.16",
+    "@tinacms/scripts": "1.1.4",
     "@types/cors": "^2.8.7",
     "@types/estree": "^0.0.50",
     "@types/express": "^4.17.8",