webclaw-shared 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kuroko1t
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/message.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message.test.d.ts.map

package/dist/__tests__/message.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/message.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/message.test.js

@@ -0,0 +1,83 @@
+import { describe, it, expect } from 'vitest';
+import { createMessageId, createRequest, createResponse, createError, isBridgeMessage, } from '../message.js';
+describe('createMessageId', () => {
+    it('returns a non-empty string', () => {
+        const id = createMessageId();
+        expect(typeof id).toBe('string');
+        expect(id.length).toBeGreaterThan(0);
+    });
+    it('returns unique IDs', () => {
+        const ids = new Set(Array.from({ length: 100 }, () => createMessageId()));
+        expect(ids.size).toBe(100);
+    });
+});
+describe('createRequest', () => {
+    it('creates a request with correct type', () => {
+        const req = createRequest('ping');
+        expect(req.type).toBe('request');
+        expect(req.method).toBe('ping');
+        expect(req.id).toBeTruthy();
+        expect(req.timestamp).toBeGreaterThan(0);
+    });
+    it('includes payload', () => {
+        const req = createRequest('navigate', { url: 'https://example.com' });
+        expect(req.payload).toEqual({ url: 'https://example.com' });
+    });
+    it('defaults payload to empty object', () => {
+        const req = createRequest('ping');
+        expect(req.payload).toEqual({});
+    });
+});
+describe('createResponse', () => {
+    it('creates a response with correct type', () => {
+        const res = createResponse('req-123', 'ping', { pong: true });
+        expect(res.type).toBe('response');
+        expect(res.id).toBe('req-123');
+        expect(res.method).toBe('ping');
+        expect(res.payload).toEqual({ pong: true });
+    });
+});
+describe('createError', () => {
+    it('creates an error with correct structure', () => {
+        const err = createError('req-123', 'navigate', 'NOT_FOUND', 'Page not found');
+        expect(err.type).toBe('error');
+        expect(err.id).toBe('req-123');
+        expect(err.method).toBe('navigate');
+        expect(err.payload).toEqual({
+            code: 'NOT_FOUND',
+            message: 'Page not found',
+            details: undefined,
+        });
+    });
+    it('includes details when provided', () => {
+        const err = createError('req-123', 'navigate', 'ERR', 'fail', { extra: true });
+        expect(err.payload.details).toEqual({ extra: true });
+    });
+});
+describe('isBridgeMessage', () => {
+    it('returns true for valid bridge messages', () => {
+        expect(isBridgeMessage({
+            id: 'abc',
+            type: 'request',
+            method: 'ping',
+            payload: {},
+            timestamp: 123,
+        })).toBe(true);
+    });
+    it('returns false for null', () => {
+        expect(isBridgeMessage(null)).toBe(false);
+    });
+    it('returns false for non-object', () => {
+        expect(isBridgeMessage('string')).toBe(false);
+        expect(isBridgeMessage(42)).toBe(false);
+    });
+    it('returns false for missing fields', () => {
+        expect(isBridgeMessage({ id: 'abc' })).toBe(false);
+        expect(isBridgeMessage({ id: 'abc', type: 'request' })).toBe(false);
+        expect(isBridgeMessage({ id: 'abc', type: 'request', method: 'ping' })).toBe(false);
+    });
+    it('returns false for wrong field types', () => {
+        expect(isBridgeMessage({ id: 123, type: 'request', method: 'ping', timestamp: 0 })).toBe(false);
+    });
+});
+//# sourceMappingURL=message.test.js.map

package/dist/__tests__/message.test.js.map

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

package/dist/__tests__/ref.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ref.test.d.ts.map

package/dist/__tests__/ref.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/ref.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/ref.test.js

@@ -0,0 +1,68 @@
+import { describe, it, expect } from 'vitest';
+import { encodeRef, decodeRef, isValidRef, createRefCounter } from '../ref.js';
+describe('encodeRef', () => {
+    it('encodes index 1 as @e1', () => {
+        expect(encodeRef(1)).toBe('@e1');
+    });
+    it('encodes large indices', () => {
+        expect(encodeRef(999)).toBe('@e999');
+    });
+    it('throws for index 0', () => {
+        expect(() => encodeRef(0)).toThrow('Ref index must be >= 1');
+    });
+    it('throws for negative index', () => {
+        expect(() => encodeRef(-1)).toThrow('Ref index must be >= 1');
+    });
+});
+describe('decodeRef', () => {
+    it('decodes @e1 to 1', () => {
+        expect(decodeRef('@e1')).toBe(1);
+    });
+    it('decodes @e999 to 999', () => {
+        expect(decodeRef('@e999')).toBe(999);
+    });
+    it('returns null for invalid ref', () => {
+        expect(decodeRef('invalid')).toBeNull();
+    });
+    it('returns null for empty string', () => {
+        expect(decodeRef('')).toBeNull();
+    });
+    it('returns null for partial ref', () => {
+        expect(decodeRef('@e')).toBeNull();
+    });
+    it('returns null for wrong prefix', () => {
+        expect(decodeRef('@f1')).toBeNull();
+    });
+});
+describe('isValidRef', () => {
+    it('returns true for valid refs', () => {
+        expect(isValidRef('@e1')).toBe(true);
+        expect(isValidRef('@e42')).toBe(true);
+        expect(isValidRef('@e100')).toBe(true);
+    });
+    it('returns false for invalid refs', () => {
+        expect(isValidRef('')).toBe(false);
+        expect(isValidRef('@e')).toBe(false);
+        expect(isValidRef('e1')).toBe(false);
+        expect(isValidRef('@f1')).toBe(false);
+        expect(isValidRef('@e1x')).toBe(false);
+    });
+});
+describe('createRefCounter', () => {
+    it('generates sequential refs', () => {
+        const counter = createRefCounter();
+        expect(counter.next()).toBe('@e1');
+        expect(counter.next()).toBe('@e2');
+        expect(counter.next()).toBe('@e3');
+    });
+    it('tracks count', () => {
+        const counter = createRefCounter();
+        expect(counter.count()).toBe(0);
+        counter.next();
+        expect(counter.count()).toBe(1);
+        counter.next();
+        counter.next();
+        expect(counter.count()).toBe(3);
+    });
+});
+//# sourceMappingURL=ref.test.js.map

package/dist/__tests__/ref.test.js.map

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

package/dist/__tests__/schemas.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schemas.test.d.ts.map

package/dist/__tests__/schemas.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schemas.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/schemas.test.js

@@ -0,0 +1,171 @@
+import { describe, it, expect } from 'vitest';
+import { bridgeMessageSchema, bridgeErrorPayloadSchema, chunkedMessageSchema, navigateToSchema, pageSnapshotSchema, clickSchema, typeTextSchema, selectOptionSchema, listWebMCPToolsSchema, invokeWebMCPToolSchema, screenshotSchema, } from '../schemas.js';
+describe('bridgeMessageSchema', () => {
+    it('accepts valid message', () => {
+        const result = bridgeMessageSchema.safeParse({
+            id: 'abc-123',
+            type: 'request',
+            method: 'ping',
+            payload: {},
+            timestamp: Date.now(),
+        });
+        expect(result.success).toBe(true);
+    });
+    it('rejects empty id', () => {
+        const result = bridgeMessageSchema.safeParse({
+            id: '',
+            type: 'request',
+            method: 'ping',
+            payload: {},
+            timestamp: Date.now(),
+        });
+        expect(result.success).toBe(false);
+    });
+    it('rejects invalid type', () => {
+        const result = bridgeMessageSchema.safeParse({
+            id: 'abc',
+            type: 'invalid',
+            method: 'ping',
+            payload: {},
+            timestamp: Date.now(),
+        });
+        expect(result.success).toBe(false);
+    });
+});
+describe('navigateToSchema', () => {
+    it('accepts valid URL', () => {
+        const result = navigateToSchema.safeParse({ url: 'https://example.com' });
+        expect(result.success).toBe(true);
+    });
+    it('rejects invalid URL', () => {
+        const result = navigateToSchema.safeParse({ url: 'not-a-url' });
+        expect(result.success).toBe(false);
+    });
+    it('accepts optional tabId', () => {
+        const result = navigateToSchema.safeParse({ url: 'https://example.com', tabId: 1 });
+        expect(result.success).toBe(true);
+    });
+});
+describe('clickSchema', () => {
+    it('accepts valid ref', () => {
+        const result = clickSchema.safeParse({ ref: '@e1', snapshotId: 'snap-123' });
+        expect(result.success).toBe(true);
+    });
+    it('rejects invalid ref format', () => {
+        const result = clickSchema.safeParse({ ref: 'invalid', snapshotId: 'snap-123' });
+        expect(result.success).toBe(false);
+    });
+    it('rejects empty snapshotId', () => {
+        const result = clickSchema.safeParse({ ref: '@e1', snapshotId: '' });
+        expect(result.success).toBe(false);
+    });
+});
+describe('typeTextSchema', () => {
+    it('accepts valid input', () => {
+        const result = typeTextSchema.safeParse({
+            ref: '@e5',
+            text: 'hello',
+            snapshotId: 'snap-1',
+        });
+        expect(result.success).toBe(true);
+    });
+    it('accepts clearFirst option', () => {
+        const result = typeTextSchema.safeParse({
+            ref: '@e5',
+            text: 'hello',
+            snapshotId: 'snap-1',
+            clearFirst: false,
+        });
+        expect(result.success).toBe(true);
+    });
+});
+describe('selectOptionSchema', () => {
+    it('accepts valid input', () => {
+        const result = selectOptionSchema.safeParse({
+            ref: '@e3',
+            value: 'option1',
+            snapshotId: 'snap-1',
+        });
+        expect(result.success).toBe(true);
+    });
+});
+describe('invokeWebMCPToolSchema', () => {
+    it('accepts valid input', () => {
+        const result = invokeWebMCPToolSchema.safeParse({
+            toolName: 'add_todo',
+            args: { text: 'Buy milk' },
+        });
+        expect(result.success).toBe(true);
+    });
+    it('rejects empty toolName', () => {
+        const result = invokeWebMCPToolSchema.safeParse({
+            toolName: '',
+            args: {},
+        });
+        expect(result.success).toBe(false);
+    });
+});
+describe('screenshotSchema', () => {
+    it('accepts empty object', () => {
+        const result = screenshotSchema.safeParse({});
+        expect(result.success).toBe(true);
+    });
+    it('accepts optional params', () => {
+        const result = screenshotSchema.safeParse({ tabId: 1, fullPage: true });
+        expect(result.success).toBe(true);
+    });
+});
+describe('pageSnapshotSchema', () => {
+    it('accepts empty object', () => {
+        const result = pageSnapshotSchema.safeParse({});
+        expect(result.success).toBe(true);
+    });
+    it('rejects negative maxTokens', () => {
+        const result = pageSnapshotSchema.safeParse({ maxTokens: -1 });
+        expect(result.success).toBe(false);
+    });
+});
+describe('listWebMCPToolsSchema', () => {
+    it('accepts empty object', () => {
+        const result = listWebMCPToolsSchema.safeParse({});
+        expect(result.success).toBe(true);
+    });
+});
+describe('chunkedMessageSchema', () => {
+    it('accepts valid chunked message', () => {
+        const result = chunkedMessageSchema.safeParse({
+            id: 'msg-1',
+            chunkIndex: 0,
+            totalChunks: 3,
+            data: 'base64data',
+        });
+        expect(result.success).toBe(true);
+    });
+    it('rejects negative chunkIndex', () => {
+        const result = chunkedMessageSchema.safeParse({
+            id: 'msg-1',
+            chunkIndex: -1,
+            totalChunks: 3,
+            data: 'data',
+        });
+        expect(result.success).toBe(false);
+    });
+});
+describe('bridgeErrorPayloadSchema', () => {
+    it('accepts valid error payload', () => {
+        const result = bridgeErrorPayloadSchema.safeParse({
+            code: 'NOT_FOUND',
+            message: 'Page not found',
+        });
+        expect(result.success).toBe(true);
+    });
+    it('accepts optional details', () => {
+        const result = bridgeErrorPayloadSchema.safeParse({
+            code: 'ERR',
+            message: 'fail',
+            details: { extra: true },
+        });
+        expect(result.success).toBe(true);
+    });
+});
+//# sourceMappingURL=schemas.test.js.map

package/dist/__tests__/schemas.test.js.map

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

package/dist/__tests__/snapshot-formatter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snapshot-formatter.test.d.ts.map

package/dist/__tests__/snapshot-formatter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-formatter.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/snapshot-formatter.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/snapshot-formatter.test.js

@@ -0,0 +1,73 @@
+import { describe, it, expect } from 'vitest';
+import { formatSnapshot, estimateTokens } from '../snapshot-formatter.js';
+describe('formatSnapshot', () => {
+    it('formats a simple node', () => {
+        const node = { role: 'page', name: 'Test Page' };
+        expect(formatSnapshot(node)).toBe('[page "Test Page"]');
+    });
+    it('formats a node with ref', () => {
+        const node = { role: 'button', ref: '@e1', name: 'Submit' };
+        expect(formatSnapshot(node)).toBe('[@e1 button "Submit"]');
+    });
+    it('formats a node with value', () => {
+        const node = { role: 'textbox', ref: '@e2', name: 'Email', value: 'test@test.com' };
+        expect(formatSnapshot(node)).toBe('[@e2 textbox "Email"] test@test.com');
+    });
+    it('formats checked state', () => {
+        const node = { role: 'checkbox', ref: '@e3', checked: true };
+        expect(formatSnapshot(node)).toBe('[@e3 checkbox] (checked)');
+    });
+    it('formats unchecked state', () => {
+        const node = { role: 'checkbox', ref: '@e3', checked: false };
+        expect(formatSnapshot(node)).toBe('[@e3 checkbox] (unchecked)');
+    });
+    it('formats disabled state', () => {
+        const node = { role: 'button', ref: '@e4', name: 'Disabled', disabled: true };
+        expect(formatSnapshot(node)).toBe('[@e4 button "Disabled"] (disabled)');
+    });
+    it('formats nested tree', () => {
+        const tree = {
+            role: 'page',
+            name: 'Test',
+            children: [
+                {
+                    role: 'nav',
+                    children: [
+                        { role: 'link', ref: '@e1', name: 'Home' },
+                        { role: 'link', ref: '@e2', name: 'About' },
+                    ],
+                },
+                {
+                    role: 'main',
+                    children: [
+                        { role: 'button', ref: '@e3', name: 'Click me' },
+                    ],
+                },
+            ],
+        };
+        const result = formatSnapshot(tree);
+        const lines = result.split('\n');
+        expect(lines[0]).toBe('[page "Test"]');
+        expect(lines[1]).toBe('  [nav]');
+        expect(lines[2]).toBe('    [@e1 link "Home"]');
+        expect(lines[3]).toBe('    [@e2 link "About"]');
+        expect(lines[4]).toBe('  [main]');
+        expect(lines[5]).toBe('    [@e3 button "Click me"]');
+    });
+});
+describe('estimateTokens', () => {
+    it('estimates tokens for short text', () => {
+        expect(estimateTokens('hello')).toBe(2); // ceil(5/4) = 2
+    });
+    it('estimates tokens for empty string', () => {
+        expect(estimateTokens('')).toBe(0);
+    });
+    it('estimates tokens for longer text', () => {
+        const text = 'a'.repeat(100);
+        expect(estimateTokens(text)).toBe(25); // 100/4
+    });
+    it('rounds up', () => {
+        expect(estimateTokens('abc')).toBe(1); // ceil(3/4) = 1
+    });
+});
+//# sourceMappingURL=snapshot-formatter.test.js.map

package/dist/__tests__/snapshot-formatter.test.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared constants for WebClaw.
+ */
+/** Native Messaging host name (must match manifest) */
+export declare const NATIVE_MESSAGING_HOST = "com.webclaw.bridge";
+/** Extension ID placeholder (set during build/install) */
+export declare const EXTENSION_ID_PLACEHOLDER = "WEBCLAW_EXTENSION_ID";
+/** Maximum Native Messaging payload size (1MB) */
+export declare const NATIVE_MESSAGING_MAX_SIZE: number;
+/** Service Worker keepalive interval in ms (25 seconds, under 30s limit) */
+export declare const KEEPALIVE_INTERVAL_MS = 25000;
+/** Default snapshot token budget */
+export declare const DEFAULT_SNAPSHOT_MAX_TOKENS = 4000;
+/** Content script ↔ page context message channel */
+export declare const PAGE_BRIDGE_CHANNEL = "webclaw-page-bridge";
+/** Side panel message type prefix */
+export declare const SIDE_PANEL_PREFIX = "webclaw-sidepanel";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAE1D,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,QAAc,CAAC;AAErD,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,oCAAoC;AACpC,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,sBAAsB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,18 @@
+/**
+ * Shared constants for WebClaw.
+ */
+/** Native Messaging host name (must match manifest) */
+export const NATIVE_MESSAGING_HOST = 'com.webclaw.bridge';
+/** Extension ID placeholder (set during build/install) */
+export const EXTENSION_ID_PLACEHOLDER = 'WEBCLAW_EXTENSION_ID';
+/** Maximum Native Messaging payload size (1MB) */
+export const NATIVE_MESSAGING_MAX_SIZE = 1024 * 1024;
+/** Service Worker keepalive interval in ms (25 seconds, under 30s limit) */
+export const KEEPALIVE_INTERVAL_MS = 25_000;
+/** Default snapshot token budget */
+export const DEFAULT_SNAPSHOT_MAX_TOKENS = 4000;
+/** Content script ↔ page context message channel */
+export const PAGE_BRIDGE_CHANNEL = 'webclaw-page-bridge';
+/** Side panel message type prefix */
+export const SIDE_PANEL_PREFIX = 'webclaw-sidepanel';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAE1D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAE/D,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,IAAI,CAAC;AAErD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE5C,oCAAoC;AACpC,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEhD,oDAAoD;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,qCAAqC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types/index.js';
+export * from './ref.js';
+export * from './schemas.js';
+export * from './constants.js';
+export * from './message.js';
+export * from './snapshot-formatter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './types/index.js';
+export * from './ref.js';
+export * from './schemas.js';
+export * from './constants.js';
+export * from './message.js';
+export * from './snapshot-formatter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}

package/dist/message.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Message construction utilities.
+ */
+import type { BridgeMessage, BridgeRequest, BridgeResponse, BridgeError, BridgeMethod } from './types/bridge.js';
+/** Create a unique message ID */
+export declare function createMessageId(): string;
+/** Create a bridge request message */
+export declare function createRequest(method: BridgeMethod, payload?: unknown): BridgeRequest;
+/** Create a bridge response message */
+export declare function createResponse(requestId: string, method: string, payload?: unknown): BridgeResponse;
+/** Create a bridge error message */
+export declare function createError(requestId: string, method: string, code: string, message: string, details?: unknown): BridgeError;
+/** Type guard for bridge messages */
+export declare function isBridgeMessage(obj: unknown): obj is BridgeMessage;
+//# sourceMappingURL=message.d.ts.map

package/dist/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B,iCAAiC;AACjC,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAED,sCAAsC;AACtC,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,OAAY,GACpB,aAAa,CAQf;AAED,uCAAuC;AACvC,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAY,GACpB,cAAc,CAQhB;AAED,oCAAoC;AACpC,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,GAChB,WAAW,CAQb;AAED,qCAAqC;AACrC,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CASlE"}

package/dist/message.js

@@ -0,0 +1,49 @@
+/** Create a unique message ID */
+export function createMessageId() {
+    // Use globalThis.crypto.randomUUID (available in Node 19+ and modern browsers)
+    if (typeof globalThis.crypto?.randomUUID === 'function') {
+        return globalThis.crypto.randomUUID();
+    }
+    return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}
+/** Create a bridge request message */
+export function createRequest(method, payload = {}) {
+    return {
+        id: createMessageId(),
+        type: 'request',
+        method,
+        payload,
+        timestamp: Date.now(),
+    };
+}
+/** Create a bridge response message */
+export function createResponse(requestId, method, payload = {}) {
+    return {
+        id: requestId,
+        type: 'response',
+        method,
+        payload,
+        timestamp: Date.now(),
+    };
+}
+/** Create a bridge error message */
+export function createError(requestId, method, code, message, details) {
+    return {
+        id: requestId,
+        type: 'error',
+        method,
+        payload: { code, message, details },
+        timestamp: Date.now(),
+    };
+}
+/** Type guard for bridge messages */
+export function isBridgeMessage(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const msg = obj;
+    return (typeof msg.id === 'string' &&
+        typeof msg.type === 'string' &&
+        typeof msg.method === 'string' &&
+        typeof msg.timestamp === 'number');
+}
+//# sourceMappingURL=message.js.map

package/dist/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAWA,iCAAiC;AACjC,MAAM,UAAU,eAAe;IAC7B,+EAA+E;IAC/E,IAAI,OAAO,UAAU,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU,EAAE,CAAC;QACxD,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,aAAa,CAC3B,MAAoB,EACpB,UAAmB,EAAE;IAErB,OAAO;QACL,EAAE,EAAE,eAAe,EAAE;QACrB,IAAI,EAAE,SAAS;QACf,MAAM;QACN,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,MAAc,EACd,UAAmB,EAAE;IAErB,OAAO;QACL,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,UAAU;QAChB,MAAM;QACN,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,WAAW,CACzB,SAAiB,EACjB,MAAc,EACd,IAAY,EACZ,OAAe,EACf,OAAiB;IAEjB,OAAO;QACL,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,OAAO;QACb,MAAM;QACN,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;QACnC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,OAAO,CACL,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ;QAC1B,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAClC,CAAC;AACJ,CAAC"}