postMessage
Made Simple

import { Parley, SYSTEM_EVENTS } from 'parley-js';

// Create instance with security config
const parley = Parley.create({
    allowedOrigins: ['https://child.example.com'],
    timeout: 5000,
});

// Register message handler
parley.on<{ user: string }>('hello', (payload, respond) => {
    console.log(`Hello from ${payload.user}!`);
    respond({ greeting: `Welcome!` });
});

// Connect to iframe
const iframe = document.querySelector('#child');
await parley.connect(iframe, 'child');

// Send message and get response
const response = await parley.send(
    'calculate',
    { data: [1, 2, 3] },
    { targetId: 'child' }
);

import { Parley, SYSTEM_EVENTS } from 'parley-js';

// Create instance
const parley = Parley.create({
    allowedOrigins: ['https://parent.example.com'],
});

// Handle calculation requests
parley.on<{ data: number[] }>('calculate', (payload, respond) => {
    const sum = payload.data.reduce((a, b) => a + b, 0);
    respond({ result: sum });
});

// Connect to parent window
await parley.connect(window.parent, 'parent');

// Listen for system events
parley.onSystem(SYSTEM_EVENTS.CONNECTED, (event) => {
    console.log('Connected to:', event.targetId);
});