@snokam/mcp-api 0.29.1 → 0.31.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "0.29.1",
+  "version": "0.31.0",
   "description": "MCP server exposing Snokam backend APIs as tools for Claude Code and other MCP clients",
   "type": "module",
   "bin": {

package/specs/production/sanity.json

@@ -31664,6 +31664,79 @@
         ],
         "type": "object"
       },
+      "BackupResult": {
+        "properties": {
+          "dataset": {
+            "type": "string"
+          },
+          "container": {
+            "type": "string"
+          },
+          "blobUrl": {
+            "type": "string"
+          },
+          "blobPath": {
+            "type": "string"
+          },
+          "sizeBytes": {
+            "type": "number",
+            "format": "double"
+          },
+          "startedAt": {
+            "type": "string"
+          },
+          "completedAt": {
+            "type": "string"
+          },
+          "assetCount": {
+            "type": "number",
+            "format": "double",
+            "description": "Number of asset binaries downloaded. 0 when `includeAssets` is false."
+          },
+          "assetBytes": {
+            "type": "number",
+            "format": "double",
+            "description": "Total bytes across asset binaries. 0 when `includeAssets` is false."
+          },
+          "assetFailures": {
+            "type": "number",
+            "format": "double",
+            "description": "Number of asset downloads that failed and were skipped."
+          }
+        },
+        "required": [
+          "dataset",
+          "container",
+          "blobUrl",
+          "blobPath",
+          "sizeBytes",
+          "startedAt",
+          "completedAt",
+          "assetCount",
+          "assetBytes",
+          "assetFailures"
+        ],
+        "type": "object",
+        "additionalProperties": true
+      },
+      "CreateBackupRequest": {
+        "properties": {
+          "dataset": {
+            "type": "string",
+            "description": "Sanity dataset to back up. Defaults to the configured dataset."
+          },
+          "container": {
+            "type": "string",
+            "description": "Blob container name. Defaults to \"sanity-backups\"."
+          },
+          "includeAssets": {
+            "type": "boolean",
+            "description": "When true, also download every `sanity.imageAsset` / `sanity.fileAsset`\nbinary referenced in the export and store it under `<prefix>/assets/`.\nDefault false — the daily cron stays cheap and skips this."
+          }
+        },
+        "type": "object",
+        "additionalProperties": true
+      },
       "GetArticlesBySlugOrIdResult": {
         "properties": {
           "nextArticle": {
@@ -51070,6 +51143,45 @@
         }
       }
     },
+    "/v1.0/backups": {
+      "post": {
+        "operationId": "CreateBackup",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BackupResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Stream the Sanity dataset export (NDJSON) into a gzipped blob in\nAzure Blob Storage. With `includeAssets: true` also downloads each\nreferenced image/file binary into `<prefix>/assets/`. Returns\nmetadata about the resulting blobs.",
+        "tags": [
+          "Backups"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateBackupRequest"
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1.0/articles": {
       "post": {
         "operationId": "CreateArticle",

package/specs/test/sanity.json

@@ -31664,6 +31664,79 @@
         ],
         "type": "object"
       },
+      "BackupResult": {
+        "properties": {
+          "dataset": {
+            "type": "string"
+          },
+          "container": {
+            "type": "string"
+          },
+          "blobUrl": {
+            "type": "string"
+          },
+          "blobPath": {
+            "type": "string"
+          },
+          "sizeBytes": {
+            "type": "number",
+            "format": "double"
+          },
+          "startedAt": {
+            "type": "string"
+          },
+          "completedAt": {
+            "type": "string"
+          },
+          "assetCount": {
+            "type": "number",
+            "format": "double",
+            "description": "Number of asset binaries downloaded. 0 when `includeAssets` is false."
+          },
+          "assetBytes": {
+            "type": "number",
+            "format": "double",
+            "description": "Total bytes across asset binaries. 0 when `includeAssets` is false."
+          },
+          "assetFailures": {
+            "type": "number",
+            "format": "double",
+            "description": "Number of asset downloads that failed and were skipped."
+          }
+        },
+        "required": [
+          "dataset",
+          "container",
+          "blobUrl",
+          "blobPath",
+          "sizeBytes",
+          "startedAt",
+          "completedAt",
+          "assetCount",
+          "assetBytes",
+          "assetFailures"
+        ],
+        "type": "object",
+        "additionalProperties": true
+      },
+      "CreateBackupRequest": {
+        "properties": {
+          "dataset": {
+            "type": "string",
+            "description": "Sanity dataset to back up. Defaults to the configured dataset."
+          },
+          "container": {
+            "type": "string",
+            "description": "Blob container name. Defaults to \"sanity-backups\"."
+          },
+          "includeAssets": {
+            "type": "boolean",
+            "description": "When true, also download every `sanity.imageAsset` / `sanity.fileAsset`\nbinary referenced in the export and store it under `<prefix>/assets/`.\nDefault false — the daily cron stays cheap and skips this."
+          }
+        },
+        "type": "object",
+        "additionalProperties": true
+      },
       "GetArticlesBySlugOrIdResult": {
         "properties": {
           "nextArticle": {
@@ -51070,6 +51143,45 @@
         }
       }
     },
+    "/v1.0/backups": {
+      "post": {
+        "operationId": "CreateBackup",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BackupResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Stream the Sanity dataset export (NDJSON) into a gzipped blob in\nAzure Blob Storage. With `includeAssets: true` also downloads each\nreferenced image/file binary into `<prefix>/assets/`. Returns\nmetadata about the resulting blobs.",
+        "tags": [
+          "Backups"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateBackupRequest"
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1.0/articles": {
       "post": {
         "operationId": "CreateArticle",