@aurorah/wmcp 1.0.0

package/README.md

@@ -0,0 +1,71 @@
+# wMCP — Web Module Connection Protocol
+
+wMCP is a standardized protocol for connecting encapsulated web UI modules to host applications. Inspired by the Model Context Protocol (MCP) for AI/LLM tool integration, wMCP applies the same manifest-driven, capability-based architecture to the web frontend domain — enabling framework-agnostic modules to be plugged into host applications with clear security boundaries and AI-friendly integration patterns.
+
+**Status:** Prototype / Proof of Concept
+
+## Quick links
+
+| Document                                           | Description        |
+| -------------------------------------------------- | ------------------ |
+| [docs/CONCEPTS.md](docs/CONCEPTS.md)               | Core Concepts      |
+| [docs/SPECIFICATION.md](docs/SPECIFICATION.md)     | Full Specification |
+| [docs/MCP-COMPARISON.md](docs/MCP-COMPARISON.md)   | MCP Comparison     |
+| [docs/GETTING-STARTED.md](docs/GETTING-STARTED.md) | Getting Started    |
+
+## Project structure
+
+```
+wmcp-prototype/
+├── docs/                 # Specification and guides
+├── examples/             # Runnable example modules and hosts
+│   ├── counter/
+│   ├── rich-text-editor/
+│   ├── analytics-dashboard/
+│   ├── file-manager/
+│   ├── kanban-board/
+│   └── media-player/
+├── src/                  # Core protocol implementation (if present)
+└── package.json
+```
+
+## Quick start
+
+```bash
+npm install
+```
+
+```bash
+npx tsx examples/counter/host-app.ts
+```
+
+In another terminal:
+
+```bash
+npx tsx examples/counter/mock-server.ts
+```
+
+HTTP transport:
+
+```bash
+npx tsx examples/counter/host-app.ts --http
+```
+
+## Examples
+
+| Example               | Description                                              |
+| --------------------- | -------------------------------------------------------- |
+| `counter`             | Minimal getting-started                                  |
+| `rich-text-editor`    | Content CRUD, autosave, export                           |
+| `analytics-dashboard` | Queries, aggregation, live data streams                  |
+| `file-manager`        | File CRUD, upload/download, tree navigation              |
+| `kanban-board`        | Task management, drag-and-drop, real-time sync           |
+| `media-player`        | Playlist management, streaming playback, progress events |
+
+## Core concepts
+
+wMCP is organized around **manifests** (module discovery and metadata), **capabilities** (what a module can do), **events** (host ↔ module messaging), **config** (host-supplied settings), and **hints** (optional UX or integration guidance). See [docs/CONCEPTS.md](docs/CONCEPTS.md) for full detail.
+
+## License
+
+MIT

package/dist/core/client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * WmcpClient — used inside the sub-module to call capabilities and emit events.
+ */
+import type { WmcpManifest, CapabilityHandler, EventCallback } from './types.js';
+export declare class WmcpClient {
+    readonly manifest: WmcpManifest;
+    private handlers;
+    private eventListeners;
+    private bound;
+    constructor(manifest: WmcpManifest);
+    /**
+     * Called by the host at mount time.
+     * Binds handler functions to each capability declared in the manifest.
+     * Throws WmcpBindError if a required capability is missing.
+     */
+    _bind(handlers: Record<string, CapabilityHandler>): void;
+    /**
+     * Invokes a request-mode capability.
+     */
+    call<T = unknown>(capability: string, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Invokes a stream-mode capability, returning an async generator.
+     */
+    stream<T = unknown>(capability: string, params?: Record<string, unknown>): AsyncGenerator<T>;
+    /**
+     * Checks if a capability has been bound (useful for optional capabilities).
+     */
+    has(capability: string): boolean;
+    /**
+     * Sub-module calls this to emit an event to the host.
+     */
+    emit(event: string, data: unknown): void;
+    /**
+     * Host subscribes to events from the sub-module.
+     * Returns an unsubscribe function.
+     */
+    _on(event: string, callback: EventCallback): () => void;
+    /**
+     * Cleans up all handlers and event listeners.
+     */
+    destroy(): void;
+    private ensureBound;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACd,MAAM,YAAY,CAAC;AAKpB,qBAAa,UAAU;IACrB,SAAgB,QAAQ,EAAE,YAAY,CAAC;IAEvC,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,KAAK,CAAS;gBAEV,QAAQ,EAAE,YAAY;IAIlC;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAiBxD;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC;IAeb;;OAEG;IACI,MAAM,CAAC,CAAC,GAAG,OAAO,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,cAAc,CAAC,CAAC,CAAC;IAuBpB;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAaxC;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAWvD;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,WAAW;CAOpB"}

package/dist/core/client.js

@@ -0,0 +1,122 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * WmcpClient — used inside the sub-module to call capabilities and emit events.
+ */
+import { WmcpError, WmcpBindError } from './errors.js';
+import { validateParams } from './validator.js';
+import { isAsyncIterable } from '../utils/stream.js';
+export class WmcpClient {
+    manifest;
+    handlers = new Map();
+    eventListeners = new Map();
+    bound = false;
+    constructor(manifest) {
+        this.manifest = manifest;
+    }
+    /**
+     * Called by the host at mount time.
+     * Binds handler functions to each capability declared in the manifest.
+     * Throws WmcpBindError if a required capability is missing.
+     */
+    _bind(handlers) {
+        for (const [name, cap] of Object.entries(this.manifest.capabilities)) {
+            if (!cap.optional && !handlers[name]) {
+                throw new WmcpBindError(name);
+            }
+        }
+        for (const [name, handler] of Object.entries(handlers)) {
+            if (!this.manifest.capabilities[name]) {
+                console.warn(`[wMCP] Binding unknown capability: "${name}" — not declared in manifest`);
+            }
+            this.handlers.set(name, handler);
+        }
+        this.bound = true;
+    }
+    /**
+     * Invokes a request-mode capability.
+     */
+    async call(capability, params = {}) {
+        this.ensureBound();
+        const handler = this.handlers.get(capability);
+        if (!handler) {
+            throw new WmcpError(`Capability not available: "${capability}"`);
+        }
+        const cap = this.manifest.capabilities[capability];
+        if (cap) {
+            validateParams(capability, cap, params);
+        }
+        return (await handler(params));
+    }
+    /**
+     * Invokes a stream-mode capability, returning an async generator.
+     */
+    async *stream(capability, params = {}) {
+        this.ensureBound();
+        const handler = this.handlers.get(capability);
+        if (!handler) {
+            throw new WmcpError(`Capability not available: "${capability}"`);
+        }
+        const cap = this.manifest.capabilities[capability];
+        if (cap) {
+            validateParams(capability, cap, params);
+        }
+        const result = handler(params);
+        if (isAsyncIterable(result)) {
+            for await (const chunk of result) {
+                yield chunk;
+            }
+        }
+        else {
+            yield (await result);
+        }
+    }
+    /**
+     * Checks if a capability has been bound (useful for optional capabilities).
+     */
+    has(capability) {
+        return this.handlers.has(capability);
+    }
+    /**
+     * Sub-module calls this to emit an event to the host.
+     */
+    emit(event, data) {
+        const listeners = this.eventListeners.get(event);
+        if (listeners) {
+            for (const cb of listeners) {
+                try {
+                    cb(data);
+                }
+                catch (err) {
+                    console.error(`[wMCP] Error in event listener for "${event}":`, err);
+                }
+            }
+        }
+    }
+    /**
+     * Host subscribes to events from the sub-module.
+     * Returns an unsubscribe function.
+     */
+    _on(event, callback) {
+        if (!this.eventListeners.has(event)) {
+            this.eventListeners.set(event, new Set());
+        }
+        this.eventListeners.get(event).add(callback);
+        return () => {
+            this.eventListeners.get(event)?.delete(callback);
+        };
+    }
+    /**
+     * Cleans up all handlers and event listeners.
+     */
+    destroy() {
+        this.handlers.clear();
+        this.eventListeners.clear();
+        this.bound = false;
+    }
+    ensureBound() {
+        if (!this.bound) {
+            throw new WmcpError('WmcpClient is not bound. The host must call _bind() before invoking capabilities.');
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"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"}

package/dist/core/errors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * Error classes
+ */
+export declare class WmcpError extends Error {
+    constructor(message: string);
+}
+/** Thrown when a required capability is not bound by the host */
+export declare class WmcpBindError extends WmcpError {
+    readonly capability: string;
+    constructor(capability: string);
+}
+/** Thrown when an HTTP-backed capability call fails */
+export declare class WmcpApiError extends WmcpError {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string);
+}
+/** Thrown when params or manifest fail validation */
+export declare class WmcpValidationError extends WmcpError {
+    readonly field: string;
+    constructor(field: string, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,iEAAiE;AACjE,qBAAa,aAAc,SAAQ,SAAS;IAC1C,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM;CAK/B;AAED,uDAAuD;AACvD,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAMzC;AAED,qDAAqD;AACrD,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK3C"}

package/dist/core/errors.js

@@ -0,0 +1,40 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * Error classes
+ */
+export class WmcpError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WmcpError';
+    }
+}
+/** Thrown when a required capability is not bound by the host */
+export class WmcpBindError extends WmcpError {
+    capability;
+    constructor(capability) {
+        super(`Missing handler for required capability: "${capability}"`);
+        this.name = 'WmcpBindError';
+        this.capability = capability;
+    }
+}
+/** Thrown when an HTTP-backed capability call fails */
+export class WmcpApiError extends WmcpError {
+    status;
+    body;
+    constructor(status, body) {
+        super(`API error ${status}: ${body}`);
+        this.name = 'WmcpApiError';
+        this.status = status;
+        this.body = body;
+    }
+}
+/** Thrown when params or manifest fail validation */
+export class WmcpValidationError extends WmcpError {
+    field;
+    constructor(field, message) {
+        super(`Validation error on "${field}": ${message}`);
+        this.name = 'WmcpValidationError';
+        this.field = field;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1B,UAAU,CAAS;IAEnC,YAAY,UAAkB;QAC5B,KAAK,CAAC,6CAA6C,UAAU,GAAG,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,uDAAuD;AACvD,MAAM,OAAO,YAAa,SAAQ,SAAS;IACzB,MAAM,CAAS;IACf,IAAI,CAAS;IAE7B,YAAY,MAAc,EAAE,IAAY;QACtC,KAAK,CAAC,aAAa,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,qDAAqD;AACrD,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChC,KAAK,CAAS;IAE9B,YAAY,KAAa,EAAE,OAAe;QACxC,KAAK,CAAC,wBAAwB,KAAK,MAAM,OAAO,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/core/host.d.ts

@@ -0,0 +1,49 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * WmcpHost — used inside the host application to bind capabilities and subscribe to events.
+ */
+import type { WmcpHostConfig, CapabilityBinding, CapabilityHandler, EventCallback } from './types.js';
+import { WmcpClient } from './client.js';
+export declare class WmcpHost {
+    private client;
+    private config;
+    private fetchFn;
+    private unsubscribes;
+    constructor(client: WmcpClient, config: WmcpHostConfig);
+    /**
+     * Binds capability implementations to the client.
+     *
+     * Each entry can be either:
+     * - A CapabilityAdapter object (CSR): resolved to HTTP fetch through the proxy
+     * - A CapabilityHandler function (SSR): called directly (e.g. Next.js server action with 'use server')
+     *
+     * This allows mixing CSR and SSR bindings per capability in a single call:
+     *
+     * ```ts
+     * host.connect({
+     *   'counter:get': getCounterServerAction,          // SSR — direct function
+     *   'counter:increment': {                           // CSR — HTTP adapter
+     *     resolve: (p) => ({ method: 'POST', path: '/counter/increment', body: p }),
+     *   },
+     * });
+     * ```
+     */
+    connect(bindings: Record<string, CapabilityBinding>): void;
+    /**
+     * Convenience: bind all handlers as direct functions (bypass HTTP adapter layer).
+     * Useful for in-memory / mock integrations where every capability is a function.
+     */
+    connectDirect(handlers: Record<string, CapabilityHandler>): void;
+    /**
+     * Subscribe to an event emitted by the sub-module.
+     * Returns an unsubscribe function.
+     */
+    on(event: string, callback: EventCallback): () => void;
+    /**
+     * Cleans up all event subscriptions.
+     */
+    destroy(): void;
+    private resolveHeaders;
+    private createHandler;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/core/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/core/host.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EACjB,iBAAiB,EAEjB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,YAAY,CAAyB;gBAEjC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc;IAMtD;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAc1D;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI;IAIhE;;;OAGG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAMtD;;OAEG;IACH,OAAO,IAAI,IAAI;YAOD,cAAc;YAQd,aAAa;CA8C5B"}

package/dist/core/host.js

@@ -0,0 +1,118 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * WmcpHost — used inside the host application to bind capabilities and subscribe to events.
+ */
+import { WmcpApiError } from './errors.js';
+import { parseSSE } from '../utils/stream.js';
+export class WmcpHost {
+    client;
+    config;
+    fetchFn;
+    unsubscribes = [];
+    constructor(client, config) {
+        this.client = client;
+        this.config = config;
+        this.fetchFn = config.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    /**
+     * Binds capability implementations to the client.
+     *
+     * Each entry can be either:
+     * - A CapabilityAdapter object (CSR): resolved to HTTP fetch through the proxy
+     * - A CapabilityHandler function (SSR): called directly (e.g. Next.js server action with 'use server')
+     *
+     * This allows mixing CSR and SSR bindings per capability in a single call:
+     *
+     * ```ts
+     * host.connect({
+     *   'counter:get': getCounterServerAction,          // SSR — direct function
+     *   'counter:increment': {                           // CSR — HTTP adapter
+     *     resolve: (p) => ({ method: 'POST', path: '/counter/increment', body: p }),
+     *   },
+     * });
+     * ```
+     */
+    connect(bindings) {
+        const handlers = {};
+        for (const [capability, binding] of Object.entries(bindings)) {
+            if (typeof binding === 'function') {
+                handlers[capability] = binding;
+            }
+            else {
+                handlers[capability] = (params) => this.createHandler(binding, params);
+            }
+        }
+        this.client._bind(handlers);
+    }
+    /**
+     * Convenience: bind all handlers as direct functions (bypass HTTP adapter layer).
+     * Useful for in-memory / mock integrations where every capability is a function.
+     */
+    connectDirect(handlers) {
+        this.client._bind(handlers);
+    }
+    /**
+     * Subscribe to an event emitted by the sub-module.
+     * Returns an unsubscribe function.
+     */
+    on(event, callback) {
+        const unsub = this.client._on(event, callback);
+        this.unsubscribes.push(unsub);
+        return unsub;
+    }
+    /**
+     * Cleans up all event subscriptions.
+     */
+    destroy() {
+        for (const unsub of this.unsubscribes) {
+            unsub();
+        }
+        this.unsubscribes = [];
+    }
+    async resolveHeaders(provider) {
+        if (!provider)
+            return {};
+        if (typeof provider === 'function') {
+            return await provider();
+        }
+        return provider;
+    }
+    async createHandler(adapter, params) {
+        const { method, path, body, query } = adapter.resolve(params);
+        let url = `${this.config.baseUrl}${path}`;
+        if (query) {
+            const qs = new URLSearchParams(query).toString();
+            if (qs)
+                url += `?${qs}`;
+        }
+        const resolved = await this.resolveHeaders(this.config.headers);
+        const headers = { ...resolved };
+        const init = { method, headers };
+        if (body !== undefined) {
+            if (body instanceof Blob || body instanceof ArrayBuffer) {
+                init.body = body;
+            }
+            else {
+                headers['Content-Type'] = 'application/json';
+                init.body = JSON.stringify(body);
+            }
+        }
+        const response = await this.fetchFn(url, init);
+        if (adapter.stream) {
+            return parseSSE(response);
+        }
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new WmcpApiError(response.status, errorBody);
+        }
+        const contentType = response.headers.get('Content-Type') ?? '';
+        if (contentType.includes('application/json')) {
+            return response.json();
+        }
+        if (contentType.includes('application/octet-stream') || contentType.includes('blob')) {
+            return response.blob();
+        }
+        return response.text();
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/core/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/core/host.ts"],"names":[],"mappings":"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"}

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * Package entry point
+ */
+export { WmcpClient } from './client.js';
+export { WmcpHost } from './host.js';
+export { validateManifest, validateParams } from './validator.js';
+export { WmcpError, WmcpBindError, WmcpApiError, WmcpValidationError, } from './errors.js';
+export { parseSSE, isAsyncIterable } from '../utils/stream.js';
+export type { WmcpManifest, WmcpModuleInfo, WmcpMountConfig, WmcpCapability, WmcpParamDef, WmcpTypeDef, WmcpHint, WmcpEvent, WmcpConfigParam, CapabilityHandler, CapabilityAdapter, CapabilityBinding, HeadersProvider, WmcpHostConfig, WmcpMountOptions, EventCallback, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE/D,YAAY,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,10 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * Package entry point
+ */
+export { WmcpClient } from './client.js';
+export { WmcpHost } from './host.js';
+export { validateManifest, validateParams } from './validator.js';
+export { WmcpError, WmcpBindError, WmcpApiError, WmcpValidationError, } from './errors.js';
+export { parseSSE, isAsyncIterable } from '../utils/stream.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * Core type definitions
+ */
+export interface WmcpManifest {
+    /** Protocol version (e.g. "1.0") */
+    wmcp: string;
+    /** Module identity */
+    module: WmcpModuleInfo;
+    /** How the module mounts into the DOM */
+    mount: WmcpMountConfig;
+    /** Capabilities the module requires from the host */
+    capabilities: Record<string, WmcpCapability>;
+    /** Events the module emits to the host */
+    events?: Record<string, WmcpEvent>;
+    /** Configuration the module accepts at mount time */
+    config?: Record<string, WmcpConfigParam>;
+}
+export interface WmcpModuleInfo {
+    /** Package name (e.g. "@aurorah/wmcp-rich-editor") */
+    name: string;
+    /** Semver version */
+    version: string;
+    /** Human-readable description */
+    description?: string;
+}
+export interface WmcpMountConfig {
+    /** Entry point file relative to package root */
+    entry: string;
+    /** CSS file to load */
+    styles?: string;
+    /** Default container element ID */
+    defaultElementId?: string;
+}
+export interface WmcpCapability {
+    /** Human-readable description (useful for AI and docs) */
+    description: string;
+    /** Whether this capability is optional. Default: false (required) */
+    optional?: boolean;
+    /** Request/response mode */
+    mode: 'request' | 'stream';
+    /** Parameter definitions */
+    params?: Record<string, WmcpParamDef>;
+    /** Return type definition */
+    returns?: WmcpTypeDef;
+    /** Hint for host adapter generation: suggested HTTP method + path template */
+    hint?: WmcpHint;
+}
+export interface WmcpParamDef {
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'blob';
+    required?: boolean;
+    description?: string;
+    enum?: unknown[];
+}
+export interface WmcpTypeDef {
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'void' | 'blob';
+    description?: string;
+}
+export interface WmcpHint {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+}
+export interface WmcpEvent {
+    /** Human-readable description */
+    description: string;
+    /** Data shape emitted with the event */
+    data: Record<string, WmcpTypeDef>;
+}
+export interface WmcpConfigParam {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    required?: boolean;
+    default?: unknown;
+    enum?: unknown[];
+    description?: string;
+}
+/** Handler function the host provides for a capability */
+export type CapabilityHandler = (params: Record<string, unknown>) => Promise<unknown> | AsyncIterable<unknown>;
+/** Callback for event subscriptions */
+export type EventCallback = (data: unknown) => void;
+/** Adapter definition used by WmcpHost to map capabilities to HTTP endpoints (CSR) */
+export interface CapabilityAdapter {
+    /** Resolves params into an HTTP request shape */
+    resolve: (params: Record<string, unknown>) => {
+        method: string;
+        path: string;
+        body?: unknown;
+        query?: Record<string, string>;
+    };
+    /** If true, the response is treated as an SSE stream */
+    stream?: boolean;
+}
+/**
+ * A capability binding can be either:
+ * - A CapabilityAdapter object (CSR: resolved to HTTP fetch through proxy)
+ * - A CapabilityHandler function (SSR: direct server action or in-memory handler)
+ *
+ * This allows mixing CSR and SSR bindings per capability in a single connect() call.
+ */
+export type CapabilityBinding = CapabilityAdapter | CapabilityHandler;
+/** Static headers or a sync/async function that returns headers per request */
+export type HeadersProvider = Record<string, string> | (() => Record<string, string>) | (() => Promise<Record<string, string>>);
+/** Configuration for WmcpHost */
+export interface WmcpHostConfig {
+    /** Base URL for API requests (e.g. "/api/v1" or "http://localhost:8000/api/v1") */
+    baseUrl: string;
+    /**
+     * Headers to inject into HTTP-backed capability requests.
+     * Can be a static object or a sync/async function for per-request headers
+     * (e.g. reading API keys from env, session cookies, or token refresh).
+     */
+    headers?: HeadersProvider;
+    /** Custom fetch implementation (defaults to globalThis.fetch) */
+    fetch?: typeof globalThis.fetch;
+}
+/** Mount options passed to the sub-module's mount function */
+export interface WmcpMountOptions {
+    /** Runtime configuration values */
+    config?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/types.js

@@ -0,0 +1,6 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * Core type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/core/validator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * Manifest and parameter validation
+ */
+import type { WmcpManifest, WmcpCapability } from './types.js';
+export declare function validateManifest(manifest: unknown): asserts manifest is WmcpManifest;
+/**
+ * Validates params against a capability's param definitions.
+ * Checks that all required params are present and have correct types.
+ */
+export declare function validateParams(capabilityName: string, capability: WmcpCapability, params: Record<string, unknown>): void;
+//# sourceMappingURL=validator.d.ts.map

package/dist/core/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/core/validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAK/D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,YAAY,CAwCpF;AAqBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAiCN"}

package/dist/core/validator.js

@@ -0,0 +1,77 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * Manifest and parameter validation
+ */
+import { WmcpValidationError } from './errors.js';
+const SUPPORTED_VERSIONS = ['1.0'];
+export function validateManifest(manifest) {
+    if (!manifest || typeof manifest !== 'object') {
+        throw new WmcpValidationError('manifest', 'Must be a non-null object');
+    }
+    const m = manifest;
+    if (typeof m.wmcp !== 'string' || !SUPPORTED_VERSIONS.includes(m.wmcp)) {
+        throw new WmcpValidationError('wmcp', `Must be one of: ${SUPPORTED_VERSIONS.join(', ')}. Got: "${m.wmcp}"`);
+    }
+    if (!m.module || typeof m.module !== 'object') {
+        throw new WmcpValidationError('module', 'Must be an object');
+    }
+    const mod = m.module;
+    if (typeof mod.name !== 'string' || !mod.name) {
+        throw new WmcpValidationError('module.name', 'Must be a non-empty string');
+    }
+    if (typeof mod.version !== 'string' || !mod.version) {
+        throw new WmcpValidationError('module.version', 'Must be a non-empty string');
+    }
+    if (!m.mount || typeof m.mount !== 'object') {
+        throw new WmcpValidationError('mount', 'Must be an object');
+    }
+    const mount = m.mount;
+    if (typeof mount.entry !== 'string' || !mount.entry) {
+        throw new WmcpValidationError('mount.entry', 'Must be a non-empty string');
+    }
+    if (!m.capabilities || typeof m.capabilities !== 'object') {
+        throw new WmcpValidationError('capabilities', 'Must be an object');
+    }
+    for (const [name, cap] of Object.entries(m.capabilities)) {
+        validateCapability(name, cap);
+    }
+}
+function validateCapability(name, cap) {
+    if (!cap || typeof cap !== 'object') {
+        throw new WmcpValidationError(`capabilities.${name}`, 'Must be an object');
+    }
+    const c = cap;
+    if (typeof c.description !== 'string') {
+        throw new WmcpValidationError(`capabilities.${name}.description`, 'Must be a string');
+    }
+    if (c.mode !== 'request' && c.mode !== 'stream') {
+        throw new WmcpValidationError(`capabilities.${name}.mode`, 'Must be "request" or "stream"');
+    }
+}
+/**
+ * Validates params against a capability's param definitions.
+ * Checks that all required params are present and have correct types.
+ */
+export function validateParams(capabilityName, capability, params) {
+    if (!capability.params)
+        return;
+    for (const [paramName, def] of Object.entries(capability.params)) {
+        const value = params[paramName];
+        if (def.required && (value === undefined || value === null)) {
+            throw new WmcpValidationError(`${capabilityName}.params.${paramName}`, 'Required parameter is missing');
+        }
+        if (value !== undefined && value !== null) {
+            const actualType = Array.isArray(value) ? 'array' : typeof value;
+            const allowedTypes = [def.type];
+            if (def.type === 'blob')
+                allowedTypes.push('object');
+            if (!allowedTypes.includes(actualType)) {
+                throw new WmcpValidationError(`${capabilityName}.params.${paramName}`, `Expected type "${def.type}", got "${actualType}"`);
+            }
+            if (def.enum && !def.enum.includes(value)) {
+                throw new WmcpValidationError(`${capabilityName}.params.${paramName}`, `Value must be one of: ${def.enum.join(', ')}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/core/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/core/validator.ts"],"names":[],"mappings":"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"}

package/dist/utils/stream.d.ts

@@ -0,0 +1,15 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * SSE / stream parsing helpers
+ */
+/**
+ * Parses an SSE (Server-Sent Events) response body into an async generator.
+ * Each `data:` line is JSON-parsed and yielded.
+ * Lines starting with `:` (comments) and empty lines are skipped.
+ */
+export declare function parseSSE(response: Response): AsyncGenerator<unknown>;
+/**
+ * Checks whether a value is an AsyncIterable.
+ */
+export declare function isAsyncIterable(value: unknown): value is AsyncIterable<unknown>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/utils/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,wBAAuB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAiD3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,CAM/E"}

package/dist/utils/stream.js

@@ -0,0 +1,67 @@
+/**
+ * wMCP — Web Module Connection Protocol
+ * SSE / stream parsing helpers
+ */
+/**
+ * Parses an SSE (Server-Sent Events) response body into an async generator.
+ * Each `data:` line is JSON-parsed and yielded.
+ * Lines starting with `:` (comments) and empty lines are skipped.
+ */
+export async function* parseSSE(response) {
+    const body = response.body;
+    if (!body) {
+        throw new Error('Response body is null — cannot parse SSE stream');
+    }
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split('\n');
+            buffer = lines.pop() ?? '';
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith(':'))
+                    continue;
+                if (trimmed.startsWith('data: ')) {
+                    const payload = trimmed.slice(6);
+                    if (payload === '[DONE]')
+                        return;
+                    try {
+                        yield JSON.parse(payload);
+                    }
+                    catch {
+                        yield payload;
+                    }
+                }
+            }
+        }
+        if (buffer.trim().startsWith('data: ')) {
+            const payload = buffer.trim().slice(6);
+            if (payload !== '[DONE]') {
+                try {
+                    yield JSON.parse(payload);
+                }
+                catch {
+                    yield payload;
+                }
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+/**
+ * Checks whether a value is an AsyncIterable.
+ */
+export function isAsyncIterable(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        Symbol.asyncIterator in value);
+}
+//# sourceMappingURL=stream.js.map

package/dist/utils/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAkB;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAElD,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACjC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACjC,IAAI,OAAO,KAAK,QAAQ;wBAAE,OAAO;oBAEjC,IAAI,CAAC;wBACH,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAC5B,CAAC;oBAAC,MAAM,CAAC;wBACP,MAAM,OAAO,CAAC;oBAChB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC5B,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,OAAO,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,aAAa,IAAK,KAAgB,CAC1C,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@aurorah/wmcp",
+  "version": "1.0.0",
+  "description": "Web Module Connection Protocol (wMCP) — a standardized protocol for connecting encapsulated web UI modules to host applications",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "example:counter": "npx tsx examples/counter/host-app.ts",
+    "example:counter:server": "npx tsx examples/counter/mock-server.ts"
+  },
+  "keywords": [
+    "wmcp",
+    "web-module-connection-protocol",
+    "module-protocol",
+    "micro-frontend",
+    "web-components",
+    "plugin-architecture"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}