@gpdoc/cli 1.8.0 → 1.8.1

package/lib/editor-preview.js

@@ -3,6 +3,7 @@ import { createServer } from 'node:http';
 import { readFile, rename, unlink, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 const {
+  createManagedDocument,
   readDocument,
   serializeManagedMarkdown,
   validateDocument,
@@ -102,11 +103,44 @@ function contentForSave(snapshot, content) {
   return content;
 }
 
+function isPlainObject(value) {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value)
+    && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+}
+
+// @spec CLI-040, CLI-042, CLI-043, CLI-044
+function metadataForSave(snapshot, metadata) {
+  if (!isPlainObject(metadata)) {
+    throw new EditorPreviewError('INVALID_INPUT', 'Front matter metadata must be an object.');
+  }
+  const currentMetadata = snapshot.document.managed
+    ? snapshot.document.metadata
+    : createManagedDocument(snapshot.document.title, snapshot.document.body);
+  const nextMetadata = {
+    ...currentMetadata,
+    ...metadata,
+    content: { document: snapshot.document.body },
+  };
+  return serializeManagedMarkdown(nextMetadata, snapshot.document.body);
+}
+
+function frontMatterFor(snapshot) {
+  const metadata = snapshot.document.managed
+    ? snapshot.document.metadata
+    : createManagedDocument(snapshot.document.title, snapshot.document.body);
+  return {
+    managed: snapshot.document.managed,
+    metadata,
+  };
+}
+
 // @spec CLI-032
 export async function startGPEditorPreview({ filePath, editorHtml }) {
   if (!editorHtml) throw new EditorPreviewError('EDITOR_PREVIEW_UNAVAILABLE', 'GPEditor preview assets are unavailable. Reinstall @gpdoc/cli.');
   const target = path.resolve(filePath);
-  const localEditorHtml = editorHtml.replace(/<\/head>/i, '<style>.share-action{display:none!important}</style></head>');
+  const localEditorHtml = editorHtml
+    .replace(/<html([^>]*)>/i, '<html$1 data-gpdoc-cli-editor>')
+    .replace(/<\/head>/i, '<style>.share-action{display:none!important}</style></head>');
   await readSnapshot(target);
   const token = crypto.randomBytes(32).toString('base64url');
   let origin = '';
@@ -116,6 +150,7 @@ export async function startGPEditorPreview({ filePath, editorHtml }) {
         const url = new URL(request.url || '/', origin || 'http://127.0.0.1');
         const editorPath = `/editor/${token}`;
         const apiPath = `/api/editor/${token}`;
+        const frontMatterPath = `${apiPath}/front-matter`;
         if (request.method === 'GET' && url.pathname === editorPath) {
           response.writeHead(200, {
             'Content-Type': 'text/html; charset=utf-8',
@@ -127,7 +162,7 @@ export async function startGPEditorPreview({ filePath, editorHtml }) {
           response.end(localEditorHtml);
           return;
         }
-        if (url.pathname !== apiPath && url.pathname !== `${apiPath}/save`) {
+        if (url.pathname !== apiPath && url.pathname !== `${apiPath}/save` && url.pathname !== frontMatterPath) {
           sendJson(response, 404, { error: { code: 'ROUTE_NOT_FOUND', message: 'The editor route was not found.' } });
           return;
         }
@@ -140,7 +175,12 @@ export async function startGPEditorPreview({ filePath, editorHtml }) {
           sendJson(response, 200, { editor });
           return;
         }
-        if (request.method !== 'POST' || url.pathname !== `${apiPath}/save`) {
+        if (request.method === 'GET' && url.pathname === frontMatterPath) {
+          const snapshot = await readSnapshot(target);
+          sendJson(response, 200, { frontMatter: frontMatterFor(snapshot) });
+          return;
+        }
+        if (request.method !== 'POST' || (url.pathname !== `${apiPath}/save` && url.pathname !== frontMatterPath)) {
           sendJson(response, 405, { error: { code: 'METHOD_NOT_ALLOWED', message: 'The editor operation does not support this method.' } });
           return;
         }
@@ -149,12 +189,16 @@ export async function startGPEditorPreview({ filePath, editorHtml }) {
           return;
         }
         const input = await readJson(request);
-        if (typeof input.content !== 'string') throw new EditorPreviewError('INVALID_INPUT', 'Editor content must be text.');
         const snapshot = await readSnapshot(target);
         if (String(input.expectedRevision || '') !== snapshot.editor.revision) {
           throw new EditorPreviewError('REVISION_CONFLICT', 'The local file changed. Reload the editor before saving.');
         }
-        const nextSource = contentForSave(snapshot, input.content);
+        const nextSource = url.pathname === frontMatterPath
+          ? metadataForSave(snapshot, input.metadata)
+          : (() => {
+            if (typeof input.content !== 'string') throw new EditorPreviewError('INVALID_INPUT', 'Editor content must be text.');
+            return contentForSave(snapshot, input.content);
+          })();
         const prospective = snapshotFor(target, nextSource);
         validateDocument(prospective.document);
         await atomicWrite(target, nextSource);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gpdoc/cli",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "type": "module",
   "description": "GPDoc command-line file conversion and validation tools",
   "repository": "https://github.com/repetere/gpdoc.git",