me3-protocol 1.0.0 → 2.1.0

package/README.md

@@ -4,23 +4,30 @@ The **me3 Protocol** (`me.json`) is a minimal standard for portable personal web
 
 It treats your online identity as a **"Digital Business Card"**—a single JSON file that makes you discoverable by both humans and AI agents, without locking you into a specific platform.
 
+## 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.
+
 ## 1. The Specification
 
 ### File Location & Discovery
+
 To be compliant, your `me.json` file must be hosted at one of the following locations (in order of priority):
 
 1.  **Primary**: `https://yourdomain.com/me.json`
 2.  **Fallback**: `https://yourdomain.com/.well-known/me`
 
 ### Transport & Security
-*   **HTTPS Only**: The file must be served over a secure connection.
-*   **CORS (Cross-Origin Resource Sharing)**: You **MUST** serve the file with the following header:
-    ```http
-    Access-Control-Allow-Origin: *
-    ```
-    **Why?** This ensures that AI agents running in browsers (e.g., Chrome extensions, web-based assistants) can read your identity file even if they are running on a different domain. Without this, your digital business card is invisible to the tools that help people find you.
+
+- **HTTPS Only**: The file must be served over a secure connection.
+- **CORS (Cross-Origin Resource Sharing)**: You **MUST** serve the file with the following header:
+  ```http
+  Access-Control-Allow-Origin: *
+  ```
+  **Why?** This ensures that AI agents running in browsers (e.g., Chrome extensions, web-based assistants) can read your identity file even if they are running on a different domain. Without this, your digital business card is invisible to the tools that help people find you.
 
 ### Content Type
+
 The file should be served with `application/json` content type.
 
 ## 2. The Schema
@@ -29,19 +36,23 @@ 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. |
-| `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
 
-### Example
+Minimal:
 
 ```json
 {
@@ -49,6 +60,7 @@ Your `me.json` defines who you are and where to find you. It is strictly typed t
   "name": "Jane Doe",
   "handle": "janedoe",
   "bio": "Building the open web. Creative Director at Studio X.",
+  "location": "Berlin, Germany",
   "avatar": "https://example.com/jane.jpg",
   "links": {
     "website": "https://janedoe.com",
@@ -65,15 +77,25 @@ Your `me.json` defines who you are and where to find you. It is strictly typed t
 }
 ```
 
+More complete examples live in [`examples/`](./examples/), including [`examples/simple.json`](./examples/simple.json) and [`examples/full.json`](./examples/full.json).
+
 ## 3. What it is NOT
 
-*   **NOT Authentication**: `me.json` is public data. It does not handle logins, passwords, or private keys.
-*   **NOT a Social Network**: There is no "feed", no "likes", and no central server. You own your data.
-*   **NOT a Platform**: You can host this file on GitHub Pages, Vercel, WordPress, or your own server.
+- **NOT Authentication**: `me.json` is public data. It does not handle logins, passwords, or private keys.
+- **NOT a Social Network**: There is no "feed", no "likes", and no central server. You own your data.
+- **NOT a Platform**: You can host this file on GitHub Pages, Vercel, WordPress, or your own server.
+- **NOT Reputation / Ranking**: No scoring, ranking, endorsements, verification, or algorithmic ordering.
+
+## 4. Guardrails & versioning
+
+- **Current version**: `0.1` (see `version` field). Validators in this repo currently require `version === "0.1"`.
+- **Backwards compatibility**: `0.1` is intended to stay stable. Changes should be additive and conservative.
+- **Extensions**: top-level fields are intentionally strict. If you need custom keys, prefer placing them under `links` (e.g. `"links": { "mastodon": "...", "custom": "..." }`) until the protocol defines a first-class place for extensions.
 
-## 4. Usage
+## 5. Usage
 
 ### For Developers
+
 You can use this package to validate `me.json` files in your applications.
 
 ```bash
@@ -81,18 +103,19 @@ npm install me3-protocol
 ```
 
 ```typescript
-import { validateProfile, parseMe3Json } from 'me3-protocol'
+import { validateProfile, parseMe3Json } from "me3-protocol";
 
 // Validate an object
-const result = validateProfile(myProfileData)
+const result = validateProfile(myProfileData);
 
 // Parse and validate a string
-const result = parseMe3Json(jsonString)
+const result = parseMe3Json(jsonString);
 
 if (!result.valid) {
-  console.error(result.errors)
+  console.error(result.errors);
 }
 ```
 
 ### JSON Schema
+
 A standard JSON Schema is available in [schema.json](./schema.json) for non-TypeScript implementations.

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+/**
+ * me3 Protocol v0.1
+ *
+ * A protocol for portable personal websites.
+ * Your site lives in a single me.json file that you can take anywhere.
+ */
+export interface Me3Page {
+    /** URL-friendly identifier */
+    slug: string;
+    /** Display name for navigation */
+    title: string;
+    /** Path to markdown file (relative to me.json) */
+    file: string;
+    /** Whether to show in navigation */
+    visible: boolean;
+}
+export interface Me3Links {
+    website?: string;
+    github?: string;
+    twitter?: string;
+    linkedin?: string;
+    instagram?: string;
+    youtube?: string;
+    tiktok?: string;
+    email?: string;
+    [key: string]: string | undefined;
+}
+export interface Me3Button {
+    /** Button text (max 30 chars) */
+    text: string;
+    /** URL to open when clicked */
+    url: string;
+    /** Button style */
+    style?: "primary" | "secondary" | "outline";
+    /** 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;
+    /** Display name (required) */
+    name: string;
+    /** Username/handle */
+    handle?: string;
+    /** Freeform location string (e.g. "Remote", "Berlin, Germany") */
+    location?: string;
+    /** Short bio */
+    bio?: string;
+    /** Avatar URL (absolute or relative) */
+    avatar?: string;
+    /** Banner/header image URL */
+    banner?: string;
+    /** Social and external links */
+    links?: Me3Links;
+    /** Call-to-action buttons (max 3) */
+    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;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    profile?: Me3Profile;
+}
+/**
+ * Validate a me3 profile object
+ */
+export declare function validateProfile(data: unknown): ValidationResult;
+/**
+ * Parse and validate a me.json string
+ */
+export declare function parseMe3Json(jsonString: string): ValidationResult;
+export declare const ME3_VERSION = "0.1";
+export declare const ME3_FILENAME = "me.json";

package/dist/index.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * me3 Protocol v0.1
+ *
+ * A protocol for portable personal websites.
+ * Your site lives in a single me.json file that you can take anywhere.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ME3_FILENAME = exports.ME3_VERSION = void 0;
+exports.validateProfile = validateProfile;
+exports.parseMe3Json = parseMe3Json;
+const CURRENT_VERSION = "0.1";
+const MAX_NAME_LENGTH = 100;
+const MAX_BIO_LENGTH = 500;
+const MAX_HANDLE_LENGTH = 30;
+const HANDLE_REGEX = /^[a-z0-9_-]+$/i;
+const MAX_LOCATION_LENGTH = 100;
+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
+ */
+function validateProfile(data) {
+    const errors = [];
+    if (!data || typeof data !== "object") {
+        return {
+            valid: false,
+            errors: [{ field: "root", message: "Profile must be an object" }],
+        };
+    }
+    const profile = data;
+    // Version (required)
+    if (!profile.version || typeof profile.version !== "string") {
+        errors.push({ field: "version", message: "Version is required" });
+    }
+    else if (profile.version !== CURRENT_VERSION) {
+        errors.push({
+            field: "version",
+            message: `Unsupported version. Expected ${CURRENT_VERSION}`,
+        });
+    }
+    // Name (required)
+    if (!profile.name || typeof profile.name !== "string") {
+        errors.push({ field: "name", message: "Name is required" });
+    }
+    else if (profile.name.length > MAX_NAME_LENGTH) {
+        errors.push({
+            field: "name",
+            message: `Name must be ${MAX_NAME_LENGTH} characters or less`,
+        });
+    }
+    // Handle (optional)
+    if (profile.handle !== undefined) {
+        if (typeof profile.handle !== "string") {
+            errors.push({ field: "handle", message: "Handle must be a string" });
+        }
+        else if (profile.handle.length > MAX_HANDLE_LENGTH) {
+            errors.push({
+                field: "handle",
+                message: `Handle must be ${MAX_HANDLE_LENGTH} characters or less`,
+            });
+        }
+        else if (!HANDLE_REGEX.test(profile.handle)) {
+            errors.push({
+                field: "handle",
+                message: "Handle can only contain letters, numbers, underscores, and hyphens",
+            });
+        }
+    }
+    // Location (optional)
+    if (profile.location !== undefined) {
+        if (typeof profile.location !== "string") {
+            errors.push({ field: "location", message: "Location must be a string" });
+        }
+        else if (profile.location.length > MAX_LOCATION_LENGTH) {
+            errors.push({
+                field: "location",
+                message: `Location must be ${MAX_LOCATION_LENGTH} characters or less`,
+            });
+        }
+    }
+    // Bio (optional)
+    if (profile.bio !== undefined) {
+        if (typeof profile.bio !== "string") {
+            errors.push({ field: "bio", message: "Bio must be a string" });
+        }
+        else if (profile.bio.length > MAX_BIO_LENGTH) {
+            errors.push({
+                field: "bio",
+                message: `Bio must be ${MAX_BIO_LENGTH} characters or less`,
+            });
+        }
+    }
+    // Avatar (optional)
+    if (profile.avatar !== undefined && typeof profile.avatar !== "string") {
+        errors.push({ field: "avatar", message: "Avatar must be a string URL" });
+    }
+    // Banner (optional)
+    if (profile.banner !== undefined && typeof profile.banner !== "string") {
+        errors.push({ field: "banner", message: "Banner must be a string URL" });
+    }
+    // Links (optional)
+    if (profile.links !== undefined) {
+        if (typeof profile.links !== "object" || profile.links === null) {
+            errors.push({ field: "links", message: "Links must be an object" });
+        }
+    }
+    // Buttons (optional)
+    if (profile.buttons !== undefined) {
+        if (!Array.isArray(profile.buttons)) {
+            errors.push({ field: "buttons", message: "Buttons must be an array" });
+        }
+        else {
+            if (profile.buttons.length > MAX_BUTTONS) {
+                errors.push({
+                    field: "buttons",
+                    message: `Maximum ${MAX_BUTTONS} buttons allowed`,
+                });
+            }
+            profile.buttons.forEach((button, index) => {
+                if (!button || typeof button !== "object") {
+                    errors.push({
+                        field: `buttons[${index}]`,
+                        message: "Button must be an object",
+                    });
+                    return;
+                }
+                if (!button.text || typeof button.text !== "string") {
+                    errors.push({
+                        field: `buttons[${index}].text`,
+                        message: "Button text is required",
+                    });
+                }
+                else if (button.text.length > MAX_BUTTON_TEXT_LENGTH) {
+                    errors.push({
+                        field: `buttons[${index}].text`,
+                        message: `Button text must be ${MAX_BUTTON_TEXT_LENGTH} characters or less`,
+                    });
+                }
+                if (!button.url || typeof button.url !== "string") {
+                    errors.push({
+                        field: `buttons[${index}].url`,
+                        message: "Button URL is required",
+                    });
+                }
+                else if (!URL_REGEX.test(button.url)) {
+                    errors.push({
+                        field: `buttons[${index}].url`,
+                        message: "Button URL must be a valid URL starting with http:// or https://",
+                    });
+                }
+                if (button.style !== undefined &&
+                    !VALID_BUTTON_STYLES.includes(button.style)) {
+                    errors.push({
+                        field: `buttons[${index}].style`,
+                        message: `Button style must be one of: ${VALID_BUTTON_STYLES.join(", ")}`,
+                    });
+                }
+                if (button.icon !== undefined && typeof button.icon !== "string") {
+                    errors.push({
+                        field: `buttons[${index}].icon`,
+                        message: "Button icon must be a string",
+                    });
+                }
+            });
+        }
+    }
+    // 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)) {
+            errors.push({ field: "pages", message: "Pages must be an array" });
+        }
+        else {
+            profile.pages.forEach((page, index) => {
+                if (!page || typeof page !== "object") {
+                    errors.push({
+                        field: `pages[${index}]`,
+                        message: "Page must be an object",
+                    });
+                    return;
+                }
+                if (!page.slug || typeof page.slug !== "string") {
+                    errors.push({
+                        field: `pages[${index}].slug`,
+                        message: "Page slug is required",
+                    });
+                }
+                if (!page.title || typeof page.title !== "string") {
+                    errors.push({
+                        field: `pages[${index}].title`,
+                        message: "Page title is required",
+                    });
+                }
+                if (!page.file || typeof page.file !== "string") {
+                    errors.push({
+                        field: `pages[${index}].file`,
+                        message: "Page file is required",
+                    });
+                }
+                if (typeof page.visible !== "boolean") {
+                    errors.push({
+                        field: `pages[${index}].visible`,
+                        message: "Page visible must be a boolean",
+                    });
+                }
+            });
+        }
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors };
+    }
+    return {
+        valid: true,
+        errors: [],
+        profile: profile,
+    };
+}
+/**
+ * Parse and validate a me.json string
+ */
+function parseMe3Json(jsonString) {
+    try {
+        const data = JSON.parse(jsonString);
+        return validateProfile(data);
+    }
+    catch (e) {
+        return {
+            valid: false,
+            errors: [{ field: "root", message: "Invalid JSON" }],
+        };
+    }
+}
+exports.ME3_VERSION = CURRENT_VERSION;
+exports.ME3_FILENAME = "me.json";

package/examples/full.json

@@ -1,18 +1,29 @@
 {
   "version": "0.1",
-  "name": "Kieran Butler",
-  "handle": "kieran",
-  "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", "style": "primary", "icon": "📅" },
-    { "text": "Buy me a coffee", "url": "https://buymeacoffee.com/kieran", "style": "secondary", "icon": "☕" }
+    {
+      "text": "Primary Call To Action",
+      "url": "https://cal.com/example",
+      "style": "primary",
+      "icon": "📅"
+    },
+    {
+      "text": "Secondary Action",
+      "url": "https://buymeacoffee.com/example",
+      "style": "secondary",
+      "icon": "☕"
+    }
   ],
   "pages": [
     { "slug": "about", "title": "About", "file": "about.md", "visible": true }

package/examples/simple.json

@@ -2,6 +2,7 @@
   "version": "0.1",
   "name": "Jane Doe",
   "handle": "janedoe",
+  "location": "Remote",
   "bio": "Minimalist example.",
   "links": {
     "twitter": "janedoe"

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "me3-protocol",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "description": "",
-  "main": "index.js",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "schema.json",
+    "README.md",
+    "examples"
+  ],
   "scripts": {
     "build": "tsc",
     "generate-schema": "ts-json-schema-generator --path 'src/index.ts' --type 'Me3Profile' --out 'schema.json' --no-type-check",
@@ -11,6 +18,8 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
       "default": "./dist/index.js"
     }
   },

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"
@@ -131,6 +175,10 @@
           "$ref": "#/definitions/Me3Links",
           "description": "Social and external links"
         },
+        "location": {
+          "description": "Freeform location string (e.g. \"Remote\", \"Berlin, Germany\")",
+          "type": "string"
+        },
         "name": {
           "description": "Display name (required)",
           "type": "string"
@@ -142,10 +190,6 @@
           },
           "type": "array"
         },
-        "theme": {
-          "description": "Theme identifier (for future use)",
-          "type": "string"
-        },
         "version": {
           "description": "Protocol version",
           "type": "string"

package/src/index.ts

@@ -1,246 +0,0 @@
-/**
- * me3 Protocol v0.1
- * 
- * A protocol for portable personal websites.
- * Your site lives in a single me.json file that you can take anywhere.
- */
-
-// ============================================================================
-// Types
-// ============================================================================
-
-export interface Me3Page {
-  /** URL-friendly identifier */
-  slug: string
-  /** Display name for navigation */
-  title: string
-  /** Path to markdown file (relative to me.json) */
-  file: string
-  /** Whether to show in navigation */
-  visible: boolean
-}
-
-export interface Me3Links {
-  website?: string
-  github?: string
-  twitter?: string
-  linkedin?: string
-  instagram?: string
-  youtube?: string
-  tiktok?: string
-  email?: string
-  [key: string]: string | undefined
-}
-
-export interface Me3Button {
-  /** Button text (max 30 chars) */
-  text: string
-  /** URL to open when clicked */
-  url: string
-  /** Button style */
-  style?: 'primary' | 'secondary' | 'outline'
-  /** Optional icon (emoji or icon identifier) */
-  icon?: string
-}
-
-export interface Me3Profile {
-  /** Protocol version */
-  version: string
-  /** Display name (required) */
-  name: string
-  /** Username/handle */
-  handle?: string
-  /** Short bio */
-  bio?: string
-  /** Avatar URL (absolute or relative) */
-  avatar?: string
-  /** Banner/header image URL */
-  banner?: string
-  /** Social and external links */
-  links?: Me3Links
-  /** Call-to-action buttons (max 3) */
-  buttons?: Me3Button[]
-  /** Custom pages (markdown) */
-  pages?: Me3Page[]
-  /** Theme identifier (for future use) */
-  theme?: string
-}
-
-// ============================================================================
-// Validation
-// ============================================================================
-
-export interface ValidationError {
-  field: string
-  message: string
-}
-
-export interface ValidationResult {
-  valid: boolean
-  errors: ValidationError[]
-  profile?: Me3Profile
-}
-
-const CURRENT_VERSION = '0.1'
-const MAX_NAME_LENGTH = 100
-const MAX_BIO_LENGTH = 500
-const MAX_HANDLE_LENGTH = 30
-const HANDLE_REGEX = /^[a-z0-9_-]+$/i
-const MAX_BUTTONS = 3
-const MAX_BUTTON_TEXT_LENGTH = 30
-const VALID_BUTTON_STYLES = ['primary', 'secondary', 'outline']
-const URL_REGEX = /^https?:\/\/.+/i
-
-/**
- * Validate a me3 profile object
- */
-export function validateProfile(data: unknown): ValidationResult {
-  const errors: ValidationError[] = []
-
-  if (!data || typeof data !== 'object') {
-    return {
-      valid: false,
-      errors: [{ field: 'root', message: 'Profile must be an object' }],
-    }
-  }
-
-  const profile = data as Record<string, unknown>
-
-  // Version (required)
-  if (!profile.version || typeof profile.version !== 'string') {
-    errors.push({ field: 'version', message: 'Version is required' })
-  } else if (profile.version !== CURRENT_VERSION) {
-    errors.push({ field: 'version', message: `Unsupported version. Expected ${CURRENT_VERSION}` })
-  }
-
-  // Name (required)
-  if (!profile.name || typeof profile.name !== 'string') {
-    errors.push({ field: 'name', message: 'Name is required' })
-  } else if (profile.name.length > MAX_NAME_LENGTH) {
-    errors.push({ field: 'name', message: `Name must be ${MAX_NAME_LENGTH} characters or less` })
-  }
-
-  // Handle (optional)
-  if (profile.handle !== undefined) {
-    if (typeof profile.handle !== 'string') {
-      errors.push({ field: 'handle', message: 'Handle must be a string' })
-    } else if (profile.handle.length > MAX_HANDLE_LENGTH) {
-      errors.push({ field: 'handle', message: `Handle must be ${MAX_HANDLE_LENGTH} characters or less` })
-    } else if (!HANDLE_REGEX.test(profile.handle)) {
-      errors.push({ field: 'handle', message: 'Handle can only contain letters, numbers, underscores, and hyphens' })
-    }
-  }
-
-  // Bio (optional)
-  if (profile.bio !== undefined) {
-    if (typeof profile.bio !== 'string') {
-      errors.push({ field: 'bio', message: 'Bio must be a string' })
-    } else if (profile.bio.length > MAX_BIO_LENGTH) {
-      errors.push({ field: 'bio', message: `Bio must be ${MAX_BIO_LENGTH} characters or less` })
-    }
-  }
-
-  // Avatar (optional)
-  if (profile.avatar !== undefined && typeof profile.avatar !== 'string') {
-    errors.push({ field: 'avatar', message: 'Avatar must be a string URL' })
-  }
-
-  // Banner (optional)
-  if (profile.banner !== undefined && typeof profile.banner !== 'string') {
-    errors.push({ field: 'banner', message: 'Banner must be a string URL' })
-  }
-
-  // Links (optional)
-  if (profile.links !== undefined) {
-    if (typeof profile.links !== 'object' || profile.links === null) {
-      errors.push({ field: 'links', message: 'Links must be an object' })
-    }
-  }
-
-  // Buttons (optional)
-  if (profile.buttons !== undefined) {
-    if (!Array.isArray(profile.buttons)) {
-      errors.push({ field: 'buttons', message: 'Buttons must be an array' })
-    } else {
-      if (profile.buttons.length > MAX_BUTTONS) {
-        errors.push({ field: 'buttons', message: `Maximum ${MAX_BUTTONS} buttons allowed` })
-      }
-      profile.buttons.forEach((button, index) => {
-        if (!button || typeof button !== 'object') {
-          errors.push({ field: `buttons[${index}]`, message: 'Button must be an object' })
-          return
-        }
-        if (!button.text || typeof button.text !== 'string') {
-          errors.push({ field: `buttons[${index}].text`, message: 'Button text is required' })
-        } else if (button.text.length > MAX_BUTTON_TEXT_LENGTH) {
-          errors.push({ field: `buttons[${index}].text`, message: `Button text must be ${MAX_BUTTON_TEXT_LENGTH} characters or less` })
-        }
-        if (!button.url || typeof button.url !== 'string') {
-          errors.push({ field: `buttons[${index}].url`, message: 'Button URL is required' })
-        } else if (!URL_REGEX.test(button.url)) {
-          errors.push({ field: `buttons[${index}].url`, message: 'Button URL must be a valid URL starting with http:// or https://' })
-        }
-        if (button.style !== undefined && !VALID_BUTTON_STYLES.includes(button.style)) {
-          errors.push({ field: `buttons[${index}].style`, message: `Button style must be one of: ${VALID_BUTTON_STYLES.join(', ')}` })
-        }
-        if (button.icon !== undefined && typeof button.icon !== 'string') {
-          errors.push({ field: `buttons[${index}].icon`, message: 'Button icon must be a string' })
-        }
-      })
-    }
-  }
-
-  // Pages (optional)
-  if (profile.pages !== undefined) {
-    if (!Array.isArray(profile.pages)) {
-      errors.push({ field: 'pages', message: 'Pages must be an array' })
-    } else {
-      profile.pages.forEach((page, index) => {
-        if (!page || typeof page !== 'object') {
-          errors.push({ field: `pages[${index}]`, message: 'Page must be an object' })
-          return
-        }
-        if (!page.slug || typeof page.slug !== 'string') {
-          errors.push({ field: `pages[${index}].slug`, message: 'Page slug is required' })
-        }
-        if (!page.title || typeof page.title !== 'string') {
-          errors.push({ field: `pages[${index}].title`, message: 'Page title is required' })
-        }
-        if (!page.file || typeof page.file !== 'string') {
-          errors.push({ field: `pages[${index}].file`, message: 'Page file is required' })
-        }
-        if (typeof page.visible !== 'boolean') {
-          errors.push({ field: `pages[${index}].visible`, message: 'Page visible must be a boolean' })
-        }
-      })
-    }
-  }
-
-  if (errors.length > 0) {
-    return { valid: false, errors }
-  }
-
-  return {
-    valid: true,
-    errors: [],
-    profile: profile as unknown as Me3Profile,
-  }
-}
-
-/**
- * Parse and validate a me.json string
- */
-export function parseMe3Json(jsonString: string): ValidationResult {
-  try {
-    const data = JSON.parse(jsonString)
-    return validateProfile(data)
-  } catch (e) {
-    return {
-      valid: false,
-      errors: [{ field: 'root', message: 'Invalid JSON' }],
-    }
-  }
-}
-
-export const ME3_VERSION = CURRENT_VERSION
-export const ME3_FILENAME = 'me.json'

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "CommonJS",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "outDir": "./dist",
-    "declaration": true
-  },
-  "include": ["src/**/*"]
-}