me3-protocol 2.3.0 → 2.5.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;
@@ -79,6 +91,22 @@ export interface Me3BookingAvailability {
         sunday?: string[];
     };
 }
+/**
+ * Booking pricing configuration.
+ * Allows hosts to charge for meetings with a sliding scale pay-what-you-want model.
+ */
+export interface Me3BookingPricing {
+    /** Whether paid meetings are enabled */
+    enabled: boolean;
+    /** Suggested price amount in dollars (e.g., 50 for $50) */
+    suggestedAmount: number;
+    /** Currency code */
+    currency: "USD" | "GBP" | "EUR";
+    /** Minimum amount bookers can pay (always $5) */
+    minimumAmount: 5;
+    /** Whether to allow free meetings alongside paid ones */
+    allowFree: boolean;
+}
 /**
  * Booking/scheduling intent.
  * Declares that the person accepts meeting bookings.
@@ -98,6 +126,8 @@ export interface Me3IntentBook {
     url?: string;
     /** Availability windows - for native me3 booking */
     availability?: Me3BookingAvailability;
+    /** Pricing configuration for paid meetings (optional) */
+    pricing?: Me3BookingPricing;
 }
 /**
  * Intents object - declares what actions visitors/agents can take.
@@ -130,6 +160,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) {
@@ -485,6 +534,58 @@ function validateProfile(data) {
                             message: "Book intent requires either a URL (for external booking) or availability (for native booking)",
                         });
                     }
+                    // Validate pricing if present
+                    if (book.pricing !== undefined) {
+                        if (typeof book.pricing !== "object" || book.pricing === null) {
+                            errors.push({
+                                field: "intents.book.pricing",
+                                message: "Book pricing must be an object",
+                            });
+                        }
+                        else {
+                            const pricing = book.pricing;
+                            if (typeof pricing.enabled !== "boolean") {
+                                errors.push({
+                                    field: "intents.book.pricing.enabled",
+                                    message: "Pricing enabled must be a boolean",
+                                });
+                            }
+                            if (pricing.enabled) {
+                                if (typeof pricing.suggestedAmount !== "number") {
+                                    errors.push({
+                                        field: "intents.book.pricing.suggestedAmount",
+                                        message: "Suggested amount must be a number",
+                                    });
+                                }
+                                else if (pricing.suggestedAmount < 5) {
+                                    errors.push({
+                                        field: "intents.book.pricing.suggestedAmount",
+                                        message: "Suggested amount must be at least $5",
+                                    });
+                                }
+                                const validCurrencies = ["USD", "GBP", "EUR"];
+                                if (typeof pricing.currency !== "string" ||
+                                    !validCurrencies.includes(pricing.currency)) {
+                                    errors.push({
+                                        field: "intents.book.pricing.currency",
+                                        message: `Currency must be one of: ${validCurrencies.join(", ")}`,
+                                    });
+                                }
+                                if (pricing.minimumAmount !== 5) {
+                                    errors.push({
+                                        field: "intents.book.pricing.minimumAmount",
+                                        message: "Minimum amount must be 5",
+                                    });
+                                }
+                                if (typeof pricing.allowFree !== "boolean") {
+                                    errors.push({
+                                        field: "intents.book.pricing.allowFree",
+                                        message: "Allow free must be a boolean",
+                                    });
+                                }
+                            }
+                        }
+                    }
                 }
             }
         }

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.5.0",
   "description": "",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/schema.json

@@ -66,6 +66,46 @@
       ],
       "type": "object"
     },
+    "Me3BookingPricing": {
+      "additionalProperties": false,
+      "description": "Booking pricing configuration. Allows hosts to charge for meetings with a sliding scale pay-what-you-want model.",
+      "properties": {
+        "allowFree": {
+          "description": "Whether to allow free meetings alongside paid ones",
+          "type": "boolean"
+        },
+        "currency": {
+          "description": "Currency code",
+          "enum": [
+            "USD",
+            "GBP",
+            "EUR"
+          ],
+          "type": "string"
+        },
+        "enabled": {
+          "description": "Whether paid meetings are enabled",
+          "type": "boolean"
+        },
+        "minimumAmount": {
+          "const": 5,
+          "description": "Minimum amount bookers can pay (always $5)",
+          "type": "number"
+        },
+        "suggestedAmount": {
+          "description": "Suggested price amount in dollars (e.g., 50 for $50)",
+          "type": "number"
+        }
+      },
+      "required": [
+        "enabled",
+        "suggestedAmount",
+        "currency",
+        "minimumAmount",
+        "allowFree"
+      ],
+      "type": "object"
+    },
     "Me3Button": {
       "additionalProperties": false,
       "properties": {
@@ -149,6 +189,10 @@
           "description": "Whether booking is enabled",
           "type": "boolean"
         },
+        "pricing": {
+          "$ref": "#/definitions/Me3BookingPricing",
+          "description": "Pricing configuration for paid meetings (optional)"
+        },
         "provider": {
           "description": "Booking provider (e.g., \"cal.com\", \"calendly\") - for external providers",
           "type": "string"
@@ -282,6 +326,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 +418,13 @@
           },
           "type": "array"
         },
+        "posts": {
+          "description": "Blog posts (markdown)",
+          "items": {
+            "$ref": "#/definitions/Me3Post"
+          },
+          "type": "array"
+        },
         "version": {
           "description": "Protocol version",
           "type": "string"