me3-protocol 2.4.0 → 2.6.0

package/dist/index.d.ts

@@ -59,6 +59,14 @@ export interface Me3Footer {
     /** Optional custom footer link */
     link?: Me3FooterLink;
 }
+export interface Me3Verification {
+    /** Whether the author is a verified human */
+    verified: boolean;
+    /** The domain used for verification */
+    verifiedDomain?: string;
+    /** When verification occurred (ISO timestamp) */
+    verifiedAt?: string;
+}
 /**
  * Newsletter subscription intent.
  * When enabled, the site accepts email subscriptions via POST /api/subscribe
@@ -91,6 +99,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.
@@ -110,6 +134,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.
@@ -155,6 +181,10 @@ export interface Me3Profile {
      * This is the API contract for interacting with the person.
      */
     intents?: Me3Intents;
+    /**
+     * Human verification status (populated from account, not editable per-site)
+     */
+    verification?: Me3Verification;
 }
 export interface ValidationError {
     field: string;

package/dist/index.js

@@ -534,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "me3-protocol",
-  "version": "2.4.0",
+  "version": "2.6.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"
@@ -381,6 +425,10 @@
           },
           "type": "array"
         },
+        "verification": {
+          "$ref": "#/definitions/Me3Verification",
+          "description": "Human verification status (populated from account, not editable per-site)"
+        },
         "version": {
           "description": "Protocol version",
           "type": "string"
@@ -391,6 +439,27 @@
         "name"
       ],
       "type": "object"
+    },
+    "Me3Verification": {
+      "additionalProperties": false,
+      "properties": {
+        "verified": {
+          "description": "Whether the author is a verified human",
+          "type": "boolean"
+        },
+        "verifiedAt": {
+          "description": "When verification occurred (ISO timestamp)",
+          "type": "string"
+        },
+        "verifiedDomain": {
+          "description": "The domain used for verification",
+          "type": "string"
+        }
+      },
+      "required": [
+        "verified"
+      ],
+      "type": "object"
     }
   }
 }