me3-protocol 2.3.0 → 2.4.0

package/dist/index.d.ts

@@ -14,6 +14,18 @@ export interface Me3Page {
     /** Whether to show in navigation */
     visible: boolean;
 }
+export interface Me3Post {
+    /** URL-friendly identifier */
+    slug: string;
+    /** Display name for listing */
+    title: string;
+    /** Path to markdown file (relative to me.json) */
+    file: string;
+    /** ISO publish date (optional) */
+    publishedAt?: string;
+    /** Short excerpt for archive/listing (optional) */
+    excerpt?: string;
+}
 export interface Me3Links {
     website?: string;
     github?: string;
@@ -130,6 +142,8 @@ export interface Me3Profile {
     buttons?: Me3Button[];
     /** Custom pages (markdown) */
     pages?: Me3Page[];
+    /** Blog posts (markdown) */
+    posts?: Me3Post[];
     /**
      * Custom footer configuration.
      * - `undefined`: default footer behavior (renderer-defined)

package/dist/index.js

@@ -277,6 +277,55 @@ function validateProfile(data) {
             });
         }
     }
+    // Posts (optional)
+    if (profile.posts !== undefined) {
+        const posts = profile.posts;
+        if (!Array.isArray(posts)) {
+            errors.push({ field: "posts", message: "Posts must be an array" });
+        }
+        else {
+            posts.forEach((post, index) => {
+                if (!post || typeof post !== "object") {
+                    errors.push({
+                        field: `posts[${index}]`,
+                        message: "Post must be an object",
+                    });
+                    return;
+                }
+                if (!post.slug || typeof post.slug !== "string") {
+                    errors.push({
+                        field: `posts[${index}].slug`,
+                        message: "Post slug is required",
+                    });
+                }
+                if (!post.title || typeof post.title !== "string") {
+                    errors.push({
+                        field: `posts[${index}].title`,
+                        message: "Post title is required",
+                    });
+                }
+                if (!post.file || typeof post.file !== "string") {
+                    errors.push({
+                        field: `posts[${index}].file`,
+                        message: "Post file is required",
+                    });
+                }
+                if (post.publishedAt !== undefined &&
+                    typeof post.publishedAt !== "string") {
+                    errors.push({
+                        field: `posts[${index}].publishedAt`,
+                        message: "Post publishedAt must be a string",
+                    });
+                }
+                if (post.excerpt !== undefined && typeof post.excerpt !== "string") {
+                    errors.push({
+                        field: `posts[${index}].excerpt`,
+                        message: "Post excerpt must be a string",
+                    });
+                }
+            });
+        }
+    }
     // Intents (optional)
     if (profile.intents !== undefined) {
         if (typeof profile.intents !== "object" || profile.intents === null) {

package/examples/full.json

@@ -28,6 +28,15 @@
   "pages": [
     { "slug": "about", "title": "About", "file": "about.md", "visible": true }
   ],
+  "posts": [
+    {
+      "slug": "hello-world",
+      "title": "Hello World",
+      "file": "blog/hello-world.md",
+      "publishedAt": "2026-01-29T12:00:00.000Z",
+      "excerpt": "A short welcome post for the blog."
+    }
+  ],
   "intents": {
     "subscribe": {
       "enabled": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "me3-protocol",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/schema.json

@@ -282,6 +282,37 @@
       ],
       "type": "object"
     },
+    "Me3Post": {
+      "additionalProperties": false,
+      "properties": {
+        "excerpt": {
+          "description": "Short excerpt for archive/listing (optional)",
+          "type": "string"
+        },
+        "file": {
+          "description": "Path to markdown file (relative to me.json)",
+          "type": "string"
+        },
+        "publishedAt": {
+          "description": "ISO publish date (optional)",
+          "type": "string"
+        },
+        "slug": {
+          "description": "URL-friendly identifier",
+          "type": "string"
+        },
+        "title": {
+          "description": "Display name for listing",
+          "type": "string"
+        }
+      },
+      "required": [
+        "slug",
+        "title",
+        "file"
+      ],
+      "type": "object"
+    },
     "Me3Profile": {
       "additionalProperties": false,
       "properties": {
@@ -343,6 +374,13 @@
           },
           "type": "array"
         },
+        "posts": {
+          "description": "Blog posts (markdown)",
+          "items": {
+            "$ref": "#/definitions/Me3Post"
+          },
+          "type": "array"
+        },
         "version": {
           "description": "Protocol version",
           "type": "string"