me3-protocol 2.0.0 → 2.1.0

package/README.md

@@ -6,7 +6,7 @@ It treats your online identity as a **"Digital Business Card"**—a single JSON
 
 ## Why it exists (brief)
 
-People increasingly ask AI to *find* a person (to hire, collaborate with, or learn from). Scraping arbitrary personal sites is a failure mode for agents: it’s brittle, slow, and ambiguous. `me.json` is a small, predictable identity endpoint that makes discovery and summarization reliable.
+People increasingly ask AI to _find_ a person (to hire, collaborate with, or learn from). Scraping arbitrary personal sites is a failure mode for agents: it’s brittle, slow, and ambiguous. `me.json` is a small, predictable identity endpoint that makes discovery and summarization reliable.
 
 ## 1. The Specification
 
@@ -36,18 +36,19 @@ Your `me.json` defines who you are and where to find you. It is strictly typed t
 
 ### Core Structure (`Me3Profile`)
 
-| Field     | Type     | Required | Description                                       |
-| :-------- | :------- | :------- | :------------------------------------------------ |
-| `version` | `string` | **Yes**  | Protocol version (currently "0.1").               |
-| `name`    | `string` | **Yes**  | Your display name.                                |
-| `handle`  | `string` | No       | Your preferred username/handle.                   |
-| `bio`     | `string` | No       | Short bio (max 500 chars).                        |
-| `avatar`  | `string` | No       | URL to your profile picture.                      |
-| `banner`  | `string` | No       | URL to a header/banner image.                     |
-| `location`| `string` | No       | Freeform location string (e.g. "Remote").         |
-| `links`   | `object` | No       | Social links (website, github, twitter, etc.).    |
-| `buttons` | `array`  | No       | Primary actions (e.g., "Book Call", "Subscribe"). |
-| `pages`   | `array`  | No       | Custom content pages.                             |
+| Field      | Type     | Required | Description                                       |
+| :--------- | :------- | :------- | :------------------------------------------------ |
+| `version`  | `string` | **Yes**  | Protocol version (currently "0.1").               |
+| `name`     | `string` | **Yes**  | Your display name.                                |
+| `handle`   | `string` | No       | Your preferred username/handle.                   |
+| `bio`      | `string` | No       | Short bio (max 500 chars).                        |
+| `avatar`   | `string` | No       | URL to your profile picture.                      |
+| `banner`   | `string` | No       | URL to a header/banner image.                     |
+| `location` | `string` | No       | Freeform location string (e.g. "Remote").         |
+| `links`    | `object` | No       | Social links (website, github, twitter, etc.).    |
+| `buttons`  | `array`  | No       | Primary actions (e.g., "Book Call", "Subscribe"). |
+| `pages`    | `array`  | No       | Custom content pages.                             |
+| `footer`   | `object` | No       | Custom footer config (or `false` to hide).        |
 
 ### Examples
 

package/dist/index.d.ts

@@ -35,6 +35,18 @@ export interface Me3Button {
     /** Optional icon (emoji or icon identifier) */
     icon?: string;
 }
+export interface Me3FooterLink {
+    /** Link text */
+    text: string;
+    /** URL to open when clicked */
+    url: string;
+}
+export interface Me3Footer {
+    /** Custom footer text (e.g. "Built by Jane") */
+    text?: string;
+    /** Optional custom footer link */
+    link?: Me3FooterLink;
+}
 export interface Me3Profile {
     /** Protocol version */
     version: string;
@@ -56,6 +68,12 @@ export interface Me3Profile {
     buttons?: Me3Button[];
     /** Custom pages (markdown) */
     pages?: Me3Page[];
+    /**
+     * Custom footer configuration.
+     * - `undefined`: default footer behavior (renderer-defined)
+     * - `false`: hide footer (renderer may restrict this to Pro tiers)
+     */
+    footer?: Me3Footer | false;
 }
 export interface ValidationError {
     field: string;

package/dist/index.js

@@ -19,6 +19,8 @@ const MAX_BUTTONS = 3;
 const MAX_BUTTON_TEXT_LENGTH = 30;
 const VALID_BUTTON_STYLES = ["primary", "secondary", "outline"];
 const URL_REGEX = /^https?:\/\/.+/i;
+const MAX_FOOTER_TEXT_LENGTH = 200;
+const MAX_FOOTER_LINK_TEXT_LENGTH = 60;
 /**
  * Validate a me3 profile object
  */
@@ -167,6 +169,58 @@ function validateProfile(data) {
             });
         }
     }
+    // Footer (optional)
+    if (profile.footer !== undefined) {
+        if (profile.footer === false) {
+            // ok (renderer may enforce tier restrictions)
+        }
+        else if (typeof profile.footer !== "object" || profile.footer === null) {
+            errors.push({
+                field: "footer",
+                message: "Footer must be an object or false",
+            });
+        }
+        else {
+            const footer = profile.footer;
+            if (footer.text !== undefined) {
+                if (typeof footer.text !== "string") {
+                    errors.push({ field: "footer.text", message: "Footer text must be a string" });
+                }
+                else if (footer.text.length > MAX_FOOTER_TEXT_LENGTH) {
+                    errors.push({
+                        field: "footer.text",
+                        message: `Footer text must be ${MAX_FOOTER_TEXT_LENGTH} characters or less`,
+                    });
+                }
+            }
+            if (footer.link !== undefined) {
+                if (typeof footer.link !== "object" || footer.link === null) {
+                    errors.push({ field: "footer.link", message: "Footer link must be an object" });
+                }
+                else {
+                    const link = footer.link;
+                    if (!link.text || typeof link.text !== "string") {
+                        errors.push({ field: "footer.link.text", message: "Footer link text is required" });
+                    }
+                    else if (link.text.length > MAX_FOOTER_LINK_TEXT_LENGTH) {
+                        errors.push({
+                            field: "footer.link.text",
+                            message: `Footer link text must be ${MAX_FOOTER_LINK_TEXT_LENGTH} characters or less`,
+                        });
+                    }
+                    if (!link.url || typeof link.url !== "string") {
+                        errors.push({ field: "footer.link.url", message: "Footer link URL is required" });
+                    }
+                    else if (!URL_REGEX.test(link.url)) {
+                        errors.push({
+                            field: "footer.link.url",
+                            message: "Footer link URL must be a valid URL starting with http:// or https://",
+                        });
+                    }
+                }
+            }
+        }
+    }
     // Pages (optional)
     if (profile.pages !== undefined) {
         if (!Array.isArray(profile.pages)) {

package/examples/full.json

@@ -1,26 +1,26 @@
 {
   "version": "0.1",
-  "name": "Kieran Butler",
-  "handle": "kieran",
-  "location": "Austin, TX",
-  "bio": "Intuitive. Coach. Coder. Creative. Building Soulink.",
-  "avatar": "https://api.dicebear.com/7.x/avataaars/svg?seed=kieran",
+  "name": "Example Name",
+  "handle": "example",
+  "location": "City, Country",
+  "bio": "Short example bio describing what this person does.",
+  "avatar": "https://api.dicebear.com/7.x/avataaars/svg?seed=example",
   "banner": "https://images.unsplash.com/photo-1519681393784-d120267933ba?w=1200&h=400&fit=crop",
   "links": {
-    "website": "https://kieranbutler.com",
-    "github": "kieranbutler",
-    "soulink": "kieran"
+    "website": "https://example.com",
+    "github": "example",
+    "soulink": "example"
   },
   "buttons": [
     {
-      "text": "Book a Discovery Call",
-      "url": "https://cal.com/kieran",
+      "text": "Primary Call To Action",
+      "url": "https://cal.com/example",
       "style": "primary",
       "icon": "📅"
     },
     {
-      "text": "Buy me a coffee",
-      "url": "https://buymeacoffee.com/kieran",
+      "text": "Secondary Action",
+      "url": "https://buymeacoffee.com/example",
       "style": "secondary",
       "icon": "☕"
     }

package/package.json

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

package/schema.json

@@ -33,6 +33,38 @@
       ],
       "type": "object"
     },
+    "Me3Footer": {
+      "additionalProperties": false,
+      "properties": {
+        "link": {
+          "$ref": "#/definitions/Me3FooterLink",
+          "description": "Optional custom footer link"
+        },
+        "text": {
+          "description": "Custom footer text (e.g. \"Built by Jane\")",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "Me3FooterLink": {
+      "additionalProperties": false,
+      "properties": {
+        "text": {
+          "description": "Link text",
+          "type": "string"
+        },
+        "url": {
+          "description": "URL to open when clicked",
+          "type": "string"
+        }
+      },
+      "required": [
+        "text",
+        "url"
+      ],
+      "type": "object"
+    },
     "Me3Links": {
       "additionalProperties": {
         "anyOf": [
@@ -123,6 +155,18 @@
           },
           "type": "array"
         },
+        "footer": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Me3Footer"
+            },
+            {
+              "const": false,
+              "type": "boolean"
+            }
+          ],
+          "description": "Custom footer configuration.\n- `undefined`: default footer behavior (renderer-defined)\n- `false`: hide footer (renderer may restrict this to Pro tiers)"
+        },
         "handle": {
           "description": "Username/handle",
           "type": "string"