Generate OpenAPI yaml via jsonnet for easier maintainability.

docs/src/lib/delete.jsonnet

@@ -0,0 +1,28 @@
+{
+  parameters: [],
+  responses: {
+    '204': {
+      description: 'Success',
+    },
+    '404': {
+      description: 'File does not exist.',
+      content: {
+        'application/json': {
+          schema: {
+            '$ref': '#/components/schemas/Error',
+          },
+        },
+      },
+    },
+    '405': {
+      description: 'Your path references a directory instead of a file; this request method is valid only for updating files.\n',
+      content: {
+        'application/json': {
+          schema: {
+            '$ref': '#/components/schemas/Error',
+          },
+        },
+      },
+    },
+  },
+}

docs/src/lib/get.jsonnet

@@ -0,0 +1,24 @@
+{
+  parameters: [],
+  responses: {
+    '200': {
+      description: 'Success',
+      content: {
+        'text/markdown': {
+          schema: {
+            type: 'string',
+            example: '# This is my document\n\nsomething else here\n',
+          },
+        },
+        'application/vnd.olrapi.note+json': {
+          schema: {
+            '$ref': '#/components/schemas/NoteJson',
+          },
+        },
+      },
+    },
+    '404': {
+      description: 'File does not exist',
+    },
+  },
+}

docs/src/lib/patch.jsonnet

@@ -0,0 +1,95 @@
+{
+  parameters: [
+    {
+      name: 'Heading',
+      'in': 'header',
+      description: 'Name of heading relative to which you would like your content inserted.  May be a sequence of nested headers delimited by "::".\n',
+      required: true,
+      schema: {
+        type: 'string',
+      },
+    },
+    {
+      name: 'Content-Insertion-Position',
+      'in': 'header',
+      description: 'Position at which you would like your content inserted; valid options are "end" or "beginning".\n',
+      schema: {
+        type: 'string',
+        enum: [
+          'end',
+          'beginning',
+        ],
+        default: 'end',
+      },
+    },
+    {
+      name: 'Content-Insertion-Ignore-Newline',
+      'in': 'header',
+      description: 'Insert content before any newlines at end of header block.\n',
+      schema: {
+        type: 'string',
+        enum: [
+          true,
+          false,
+        ],
+        default: false,
+      },
+    },
+    {
+      name: 'Heading-Boundary',
+      'in': 'header',
+      description: 'Set the nested header delimiter to a different value. This is useful if "::" exists in one of the headers you are attempting to use.\n',
+      schema: {
+        type: 'string',
+        default: '::',
+      },
+    },
+  ],
+  requestBody: {
+    description: 'Content you would like to insert.',
+    required: true,
+    content: {
+      'text/markdown': {
+        schema: {
+          type: 'string',
+          example: '# This is my document\n\nsomething else here\n',
+        },
+      },
+    },
+  },
+  responses: {
+    '200': {
+      description: 'Success',
+    },
+    '400': {
+      description: 'Bad Request; see response message for details.',
+      content: {
+        'application/json': {
+          schema: {
+            '$ref': '#/components/schemas/Error',
+          },
+        },
+      },
+    },
+    '404': {
+      description: 'Does not exist',
+      content: {
+        'application/json': {
+          schema: {
+            '$ref': '#/components/schemas/Error',
+          },
+        },
+      },
+    },
+    '405': {
+      description: 'Your path references a directory instead of a file; this request method is valid only for updating files.\n',
+      content: {
+        'application/json': {
+          schema: {
+            '$ref': '#/components/schemas/Error',
+          },
+        },
+      },
+    },
+  },
+}

docs/src/lib/path.param.jsonnet

@@ -0,0 +1,10 @@
+{
+  name: 'filename',
+  'in': 'path',
+  description: 'Path to the relevant file (relative to your vault root).\n',
+  required: true,
+  schema: {
+    type: 'string',
+    format: 'path',
+  },
+}

docs/src/lib/period.param.jsonnet

@@ -0,0 +1,17 @@
+{
+  name: 'period',
+  'in': 'path',
+  description: 'The name of the period for which you would like to grab the current note.',
+  required: true,
+  schema: {
+    type: 'string',
+    enum: [
+      'daily',
+      'weekly',
+      'monthly',
+      'quarterly',
+      'yearly',
+    ],
+    default: 'daily',
+  },
+}

docs/src/lib/post.jsonnet

@@ -0,0 +1,40 @@
+{
+  parameters: [],
+  requestBody: {
+    description: 'Content you would like to append.',
+    required: true,
+    content: {
+      'text/markdown': {
+        schema: {
+          type: 'string',
+          example: '# This is my document\n\nsomething else here\n',
+        },
+      },
+    },
+  },
+  responses: {
+    '204': {
+      description: 'Success',
+    },
+    '400': {
+      description: 'Bad Request',
+      content: {
+        'application/json': {
+          schema: {
+            '$ref': '#/components/schemas/Error',
+          },
+        },
+      },
+    },
+    '405': {
+      description: 'Your path references a directory instead of a file; this request method is valid only for updating files.\n',
+      content: {
+        'application/json': {
+          schema: {
+            '$ref': '#/components/schemas/Error',
+          },
+        },
+      },
+    },
+  },
+}

docs/src/lib/put.jsonnet

@@ -0,0 +1,49 @@
+{
+  tags: [
+    'Active File',
+  ],
+  summary: 'Update the content of the active file open in Obsidian.\n',
+  parameters: [],
+  requestBody: {
+    description: 'Content of the file you would like to upload.',
+    required: true,
+    content: {
+      'text/markdown': {
+        schema: {
+          type: 'string',
+          example: '# This is my document\n\nsomething else here\n',
+        },
+      },
+      '*/*': {
+        schema: {
+          type: 'string',
+        },
+      },
+    },
+  },
+  responses: {
+    '204': {
+      description: 'Success',
+    },
+    '400': {
+      description: "Incoming file could not be processed.  Make sure you have specified a reasonable file name, and make sure you have set a reasonable 'Content-Type' header; if you are uploading a note, 'text/markdown' is likely the right choice.\n",
+      content: {
+        'application/json': {
+          schema: {
+            '$ref': '#/components/schemas/Error',
+          },
+        },
+      },
+    },
+    '405': {
+      description: 'Your path references a directory instead of a file; this request method is valid only for updating files.\n',
+      content: {
+        'application/json': {
+          schema: {
+            '$ref': '#/components/schemas/Error',
+          },
+        },
+      },
+    },
+  },
+}