magic-editor-x 1.0.0 → 1.1.0

package/README.md

@@ -387,6 +387,11 @@ export default () => ({
         allowedAdminRoles: ['strapi-super-admin'],
         allowedAdminUserIds: [],
       },
+
+      // API Response Settings
+      api: {
+        autoParseJSON: true, // Auto-parse JSON strings to objects in API responses
+      },
     },
   },
 });
@@ -478,6 +483,11 @@ interface MagicEditorXConfig {
   // Link Preview Settings
   linkPreviewTimeout?: number; // Milliseconds, default: 10000
   
+  // API Response Settings
+  api?: {
+    autoParseJSON: boolean; // Auto-parse JSON strings to objects, default: true
+  };
+  
   // Collaboration Settings
   collaboration?: {
     enabled: boolean; // Default: true
@@ -507,6 +517,76 @@ When adding the field in Content-Type Builder:
 
 ---
 
+## API Response Format
+
+### Automatic JSON Parsing
+
+Magic Editor X automatically transforms JSON string fields into structured objects in API responses for better developer experience.
+
+**Without auto-parsing (raw Strapi response):**
+```json
+{
+  "data": {
+    "id": 1,
+    "documentId": "abc123",
+    "editorX": "{\"time\":1699999999999,\"blocks\":[{\"id\":\"xyz\",\"type\":\"paragraph\",\"data\":{\"text\":\"Hello\"}}],\"version\":\"2.31.0\"}"
+  }
+}
+```
+
+**With auto-parsing (Magic Editor X middleware active):**
+```json
+{
+  "data": {
+    "id": 1,
+    "documentId": "abc123",
+    "editorX": {
+      "time": 1699999999999,
+      "blocks": [
+        {
+          "id": "xyz",
+          "type": "paragraph",
+          "data": {
+            "text": "Hello"
+          }
+        }
+      ],
+      "version": "2.31.0"
+    }
+  }
+}
+```
+
+**Configuration:**
+
+Auto-parsing is enabled by default. To disable it, add to `config/plugins.ts`:
+
+```typescript
+{
+  'magic-editor-x': {
+    config: {
+      api: {
+        autoParseJSON: false // Disable automatic JSON parsing
+      }
+    }
+  }
+}
+```
+
+**Manual Parsing (if auto-parse is disabled):**
+
+```javascript
+// Client-side parsing
+const response = await fetch('/api/articles/1');
+const data = await response.json();
+
+// Parse Editor.js field manually
+const editorContent = JSON.parse(data.data.editorX);
+console.log(editorContent.blocks); // Array of blocks
+```
+
+---
+
 ## API Reference
 
 ### Public API Endpoints

package/dist/server/index.js

@@ -77,6 +77,14 @@ var bootstrap$1 = async ({ strapi: strapi2 }) => {
     }
     await strapi2.plugin("magic-editor-x").service("realtimeService").initSocketServer();
     strapi2.log.info("[Magic Editor X] [SUCCESS] Realtime server started");
+    const pluginConfig = strapi2.config.get("plugin::magic-editor-x") || {};
+    const autoParseJSON = pluginConfig.api?.autoParseJSON !== false;
+    if (autoParseJSON) {
+      strapi2.server.use(strapi2.plugin("magic-editor-x").middleware("parse-editor-fields")());
+      strapi2.log.info("[Magic Editor X] [SUCCESS] Auto-parse middleware registered (api.autoParseJSON: true)");
+    } else {
+      strapi2.log.info("[Magic Editor X] [INFO] Auto-parse middleware disabled (api.autoParseJSON: false)");
+    }
   } catch (error) {
     strapi2.log.error("[Magic Editor X] [ERROR] Bootstrap failed:", error);
   }
@@ -143,6 +151,11 @@ var config$1 = {
       allowedOrigins: [],
       allowedAdminRoles: ["strapi-super-admin"],
       allowedAdminUserIds: []
+    },
+    // API Response Settings
+    api: {
+      autoParseJSON: true
+      // Automatically parse Editor.js JSON strings to objects in API responses
     }
   },
   validator: (config2) => {
@@ -923,7 +936,57 @@ var controllers$1 = {
   collaboration,
   license: license$1
 };
-var middlewares$1 = {};
+var parseEditorFields$1 = (config2, { strapi: strapi2 }) => {
+  return async (ctx, next) => {
+    await next();
+    if (ctx.method !== "GET" || ctx.status !== 200) {
+      return;
+    }
+    if (!ctx.body || typeof ctx.body !== "object") {
+      return;
+    }
+    try {
+      const parseEditorFields2 = (data) => {
+        if (!data || typeof data !== "object") {
+          return data;
+        }
+        if (Array.isArray(data)) {
+          return data.map(parseEditorFields2);
+        }
+        const parsed = {};
+        for (const [key, value] of Object.entries(data)) {
+          if (typeof value === "string" && value.startsWith("{") && value.includes('"blocks"')) {
+            try {
+              const parsedValue = JSON.parse(value);
+              if (parsedValue.blocks && Array.isArray(parsedValue.blocks)) {
+                parsed[key] = parsedValue;
+                continue;
+              }
+            } catch (e) {
+            }
+          }
+          if (value !== null && typeof value === "object") {
+            parsed[key] = parseEditorFields2(value);
+          } else {
+            parsed[key] = value;
+          }
+        }
+        return parsed;
+      };
+      if (ctx.body.data) {
+        ctx.body.data = parseEditorFields2(ctx.body.data);
+      } else {
+        ctx.body = parseEditorFields2(ctx.body);
+      }
+    } catch (error) {
+      strapi2.log.debug("[Magic Editor X] Failed to parse editor fields:", error.message);
+    }
+  };
+};
+const parseEditorFields = parseEditorFields$1;
+var middlewares$1 = {
+  "parse-editor-fields": parseEditorFields
+};
 var policies$1 = {};
 var admin$1 = {
   type: "admin",
@@ -1931,7 +1994,7 @@ var snapshotService$1 = ({ strapi: strapi2 }) => ({
   }
 });
 const name = "magic-editor-x";
-const version = "1.0.1";
+const version = "1.0.0";
 const description = "Advanced block-based editor for Strapi v5 with Editor.js, Media Library integration, and real-time collaboration support";
 const keywords = [
   "strapi",

package/dist/server/index.mjs

@@ -65,6 +65,14 @@ var bootstrap$1 = async ({ strapi: strapi2 }) => {
     }
     await strapi2.plugin("magic-editor-x").service("realtimeService").initSocketServer();
     strapi2.log.info("[Magic Editor X] [SUCCESS] Realtime server started");
+    const pluginConfig = strapi2.config.get("plugin::magic-editor-x") || {};
+    const autoParseJSON = pluginConfig.api?.autoParseJSON !== false;
+    if (autoParseJSON) {
+      strapi2.server.use(strapi2.plugin("magic-editor-x").middleware("parse-editor-fields")());
+      strapi2.log.info("[Magic Editor X] [SUCCESS] Auto-parse middleware registered (api.autoParseJSON: true)");
+    } else {
+      strapi2.log.info("[Magic Editor X] [INFO] Auto-parse middleware disabled (api.autoParseJSON: false)");
+    }
   } catch (error) {
     strapi2.log.error("[Magic Editor X] [ERROR] Bootstrap failed:", error);
   }
@@ -131,6 +139,11 @@ var config$1 = {
       allowedOrigins: [],
       allowedAdminRoles: ["strapi-super-admin"],
       allowedAdminUserIds: []
+    },
+    // API Response Settings
+    api: {
+      autoParseJSON: true
+      // Automatically parse Editor.js JSON strings to objects in API responses
     }
   },
   validator: (config2) => {
@@ -911,7 +924,57 @@ var controllers$1 = {
   collaboration,
   license: license$1
 };
-var middlewares$1 = {};
+var parseEditorFields$1 = (config2, { strapi: strapi2 }) => {
+  return async (ctx, next) => {
+    await next();
+    if (ctx.method !== "GET" || ctx.status !== 200) {
+      return;
+    }
+    if (!ctx.body || typeof ctx.body !== "object") {
+      return;
+    }
+    try {
+      const parseEditorFields2 = (data) => {
+        if (!data || typeof data !== "object") {
+          return data;
+        }
+        if (Array.isArray(data)) {
+          return data.map(parseEditorFields2);
+        }
+        const parsed = {};
+        for (const [key, value] of Object.entries(data)) {
+          if (typeof value === "string" && value.startsWith("{") && value.includes('"blocks"')) {
+            try {
+              const parsedValue = JSON.parse(value);
+              if (parsedValue.blocks && Array.isArray(parsedValue.blocks)) {
+                parsed[key] = parsedValue;
+                continue;
+              }
+            } catch (e) {
+            }
+          }
+          if (value !== null && typeof value === "object") {
+            parsed[key] = parseEditorFields2(value);
+          } else {
+            parsed[key] = value;
+          }
+        }
+        return parsed;
+      };
+      if (ctx.body.data) {
+        ctx.body.data = parseEditorFields2(ctx.body.data);
+      } else {
+        ctx.body = parseEditorFields2(ctx.body);
+      }
+    } catch (error) {
+      strapi2.log.debug("[Magic Editor X] Failed to parse editor fields:", error.message);
+    }
+  };
+};
+const parseEditorFields = parseEditorFields$1;
+var middlewares$1 = {
+  "parse-editor-fields": parseEditorFields
+};
 var policies$1 = {};
 var admin$1 = {
   type: "admin",
@@ -1919,7 +1982,7 @@ var snapshotService$1 = ({ strapi: strapi2 }) => ({
   }
 });
 const name = "magic-editor-x";
-const version = "1.0.1";
+const version = "1.0.0";
 const description = "Advanced block-based editor for Strapi v5 with Editor.js, Media Library integration, and real-time collaboration support";
 const keywords = [
   "strapi",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "magic-editor-x",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Advanced block-based editor for Strapi v5 with Editor.js, Media Library integration, and real-time collaboration support",
   "keywords": [
     "strapi",