@crup/port 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CRUP contributors
+
+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/README.md

@@ -0,0 +1,212 @@
+# @crup/port
+
+[![npm version](https://img.shields.io/npm/v/%40crup%2Fport?color=1f8b4c)](https://www.npmjs.com/package/@crup/port)
+[![npm downloads](https://img.shields.io/npm/dm/%40crup%2Fport?color=0b7285)](https://www.npmjs.com/package/@crup/port)
+[![License](https://img.shields.io/github/license/crup/port?color=495057)](https://github.com/crup/port/blob/main/LICENSE)
+[![CI](https://github.com/crup/port/actions/workflows/ci.yml/badge.svg)](https://github.com/crup/port/actions/workflows/ci.yml)
+[![Docs](https://github.com/crup/port/actions/workflows/docs.yml/badge.svg)](https://github.com/crup/port/actions/workflows/docs.yml)
+
+Protocol-first iframe runtime for explicit host/child communication.
+
+`@crup/port` exists for the part of embedded app work that usually rots first: lifecycle, handshake timing, and message discipline. It gives the host page a small runtime for mounting an iframe, opening it inline or in a modal, enforcing origin checks, and exchanging request/response messages without ad hoc `postMessage` glue.
+
+Tags: `iframe` `postMessage` `embed` `protocol` `TypeScript` `runtime`
+
+Package: https://www.npmjs.com/package/@crup/port
+
+Live demo: https://crup.github.io/port/
+
+## Install
+
+```bash
+npm install @crup/port
+```
+
+```bash
+pnpm add @crup/port
+```
+
+```bash
+yarn add @crup/port
+```
+
+Import the host runtime from `@crup/port` and the child runtime from `@crup/port/child`.
+
+## Quick Links
+
+- npm package: https://www.npmjs.com/package/@crup/port
+- live demo: https://crup.github.io/port/
+- source: https://github.com/crup/port
+- issues: https://github.com/crup/port/issues
+
+## Why This Package Exists
+
+- Raw `postMessage` is low-level and easy to drift across products.
+- Iframe lifecycle bugs usually hide in timing and cleanup paths.
+- Cross-window integrations need explicit origin pinning and state transitions.
+- Small embed runtimes should stay tiny, predictable, and framework-agnostic.
+
+## Quick Start
+
+### Host
+
+```ts
+import { createPort } from '@crup/port';
+
+const port = createPort({
+  url: 'https://example.com/embed',
+  allowedOrigin: 'https://example.com',
+  target: '#embed-root',
+  mode: 'inline',
+  minHeight: 360,
+  maxHeight: 720
+});
+
+await port.mount();
+
+port.on('widget:loaded', (payload) => {
+  console.log('child event', payload);
+});
+
+const result = await port.call<{ ok: boolean }>('system:ping', {
+  requestedAt: Date.now()
+});
+
+console.log(result.ok);
+```
+
+### Child
+
+```ts
+import { createChildPort } from '@crup/port/child';
+
+const child = createChildPort({
+  allowedOrigin: 'https://host.example.com'
+});
+
+child.on('request:system:ping', (message) => {
+  const request = message as { messageId: string; payload?: unknown };
+
+  child.respond(request.messageId, {
+    ok: true,
+    receivedAt: Date.now()
+  });
+});
+
+child.emit('widget:loaded', { version: '1' });
+child.resize(document.body.scrollHeight);
+```
+
+## What You Get
+
+- Explicit lifecycle: `idle -> mounting -> mounted -> handshaking -> ready -> open -> closed -> destroyed`
+- Strict origin pinning on both host and child
+- Inline and modal host modes
+- Event emission plus request/response RPC
+- Child-driven height updates
+- Small ESM-first bundle built with `tsup`
+
+## API Surface
+
+### `createPort(config)`
+
+Host runtime with:
+
+- `mount()`
+- `open()`
+- `close()`
+- `destroy()`
+- `send(type, payload?)`
+- `call<T>(type, payload?)`
+- `on(type, handler)`
+- `off(type, handler)`
+- `update(partialConfig)`
+- `getState()`
+
+### `createChildPort(config?)`
+
+Child runtime with:
+
+- `ready()`
+- `emit(type, payload?)`
+- `on(type, handler)`
+- `respond(messageId, payload)`
+- `resize(height)`
+- `destroy()`
+
+### Message Shape
+
+```ts
+type PortMessage = {
+  protocol: 'crup.port';
+  version: '1';
+  instanceId: string;
+  messageId: string;
+  replyTo?: string;
+  kind: 'event' | 'request' | 'response' | 'error' | 'system';
+  type: string;
+  payload?: unknown;
+};
+```
+
+## Demo And Examples
+
+- Live GitHub Pages demo: https://crup.github.io/port/
+- Inline example: [`examples/host-inline.ts`](examples/host-inline.ts)
+- Modal example: [`examples/host-modal.ts`](examples/host-modal.ts)
+- Child example: [`examples/child-basic.ts`](examples/child-basic.ts)
+- Example overview: [`examples/README.md`](examples/README.md)
+
+## Documentation
+
+- Getting started: [`docs/getting-started.md`](docs/getting-started.md)
+- Protocol notes: [`docs/protocol.md`](docs/protocol.md)
+- Security guidance: [`docs/security.md`](docs/security.md)
+- Release process: [`docs/releasing.md`](docs/releasing.md)
+- Contributing: [`CONTRIBUTING.md`](CONTRIBUTING.md)
+
+## Local Development
+
+```bash
+pnpm install
+pnpm lint
+pnpm typecheck
+pnpm test
+pnpm build
+pnpm demo:dev
+```
+
+Useful scripts:
+
+- `pnpm docs:build` builds the GitHub Pages site into `demo-dist/`
+- `pnpm size` reports raw and gzip bundle sizes for `dist/`
+- `pnpm changeset` adds a release note entry when you want to track pending package notes
+- `pnpm readme:check` validates the README install and package links
+
+## Release Model
+
+- `ci.yml` validates lint, types, tests, package build, demo build, README checks, size output, and package packing.
+- `docs.yml` deploys the Vite demo to GitHub Pages at `https://crup.github.io/port/`.
+- `release.yml` is a guarded manual stable release workflow modeled on `crup/react-timer-hook`.
+- `prerelease.yml` publishes a manual alpha prerelease from the `next` branch.
+
+## Security
+
+This package helps with origin checks, but it cannot secure a weak embed strategy on its own. Always pin `allowedOrigin`, set restrictive iframe attributes, and validate application-level payloads. The practical guidance lives in [`docs/security.md`](docs/security.md).
+
+## OSS Baseline
+
+This repo ships with:
+
+- MIT license
+- Code of conduct
+- Contributing guide
+- Security policy
+- Issue and PR templates
+- Husky hooks
+- Changesets
+- GitHub Actions for CI, Pages, size reporting, and releases
+
+## License
+
+MIT, see [`LICENSE`](LICENSE).

package/dist/child.d.ts

@@ -0,0 +1,16 @@
+type EventHandler<T = unknown> = (payload: T) => void | Promise<void>;
+interface ChildPortConfig {
+    allowedOrigin?: string;
+}
+
+interface ChildPort {
+    ready(): void;
+    emit(type: string, payload?: unknown): void;
+    on(type: string, handler: EventHandler): void;
+    respond(messageId: string, payload: unknown): void;
+    resize(height: number): void;
+    destroy(): void;
+}
+declare function createChildPort(config?: ChildPortConfig): ChildPort;
+
+export { type ChildPort, createChildPort };

package/dist/child.mjs

@@ -0,0 +1,114 @@
+// src/emitter.ts
+var Emitter = class {
+  constructor() {
+    this.listeners = /* @__PURE__ */ new Map();
+  }
+  on(type, handler) {
+    const set = this.listeners.get(type) ?? /* @__PURE__ */ new Set();
+    set.add(handler);
+    this.listeners.set(type, set);
+  }
+  off(type, handler) {
+    this.listeners.get(type)?.delete(handler);
+  }
+  async emit(type, payload) {
+    const list = this.listeners.get(type);
+    if (!list) {
+      return;
+    }
+    await Promise.all([...list].map(async (handler) => handler(payload)));
+  }
+};
+
+// src/utils.ts
+var PROTOCOL = "crup.port";
+var VERSION = "1";
+function randomId(prefix = "msg") {
+  return `${prefix}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function isPortMessage(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const data = value;
+  return data.protocol === PROTOCOL && data.version === VERSION && typeof data.instanceId === "string" && typeof data.messageId === "string" && typeof data.kind === "string" && typeof data.type === "string";
+}
+
+// src/child.ts
+function createChildPort(config = {}) {
+  const emitter = new Emitter();
+  let instanceId = null;
+  let hostWindow = null;
+  let hostOrigin = config.allowedOrigin ?? null;
+  const listener = (event) => {
+    if (!isPortMessage(event.data)) {
+      return;
+    }
+    const message = event.data;
+    if (message.kind === "system" && message.type === "port:hello") {
+      instanceId = message.instanceId;
+      hostWindow = event.source;
+      hostOrigin = hostOrigin ?? event.origin;
+      if (hostOrigin !== event.origin) {
+        return;
+      }
+      ready();
+      return;
+    }
+    if (!instanceId || !hostWindow || message.instanceId !== instanceId) {
+      return;
+    }
+    if (event.source !== hostWindow || event.origin !== hostOrigin) {
+      return;
+    }
+    if (message.kind === "event") {
+      void emitter.emit(message.type, message.payload);
+      return;
+    }
+    if (message.kind === "request") {
+      void emitter.emit(`request:${message.type}`, message);
+    }
+  };
+  window.addEventListener("message", listener);
+  function post(message) {
+    if (!instanceId || !hostWindow || !hostOrigin) {
+      return;
+    }
+    hostWindow.postMessage(
+      {
+        protocol: PROTOCOL,
+        version: VERSION,
+        instanceId,
+        messageId: randomId(),
+        ...message
+      },
+      hostOrigin
+    );
+  }
+  function ready() {
+    post({ kind: "system", type: "port:ready" });
+  }
+  function emit(type, payload) {
+    post({ kind: "event", type, payload });
+  }
+  function on(type, handler) {
+    emitter.on(type, handler);
+  }
+  function respond(messageId, payload) {
+    post({ kind: "response", type: "port:response", payload, replyTo: messageId });
+  }
+  function resize(height) {
+    if (!Number.isFinite(height) || height < 0) {
+      return;
+    }
+    post({ kind: "event", type: "port:resize", payload: height });
+  }
+  function destroy() {
+    window.removeEventListener("message", listener);
+  }
+  return { ready, emit, on, respond, resize, destroy };
+}
+export {
+  createChildPort
+};
+//# sourceMappingURL=child.mjs.map

package/dist/child.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/emitter.ts","../src/utils.ts","../src/child.ts"],"sourcesContent":["import type { EventHandler } from './types';\n\nexport class Emitter {\n  private listeners = new Map<string, Set<EventHandler>>();\n\n  on(type: string, handler: EventHandler): void {\n    const set = this.listeners.get(type) ?? new Set<EventHandler>();\n    set.add(handler);\n    this.listeners.set(type, set);\n  }\n\n  off(type: string, handler: EventHandler): void {\n    this.listeners.get(type)?.delete(handler);\n  }\n\n  async emit(type: string, payload: unknown): Promise<void> {\n    const list = this.listeners.get(type);\n    if (!list) {\n      return;\n    }\n    await Promise.all([...list].map(async (handler) => handler(payload)));\n  }\n}\n","import type { PortMessage } from './types';\n\nexport const PROTOCOL = 'crup.port';\nexport const VERSION = '1';\n\nexport function randomId(prefix = 'msg'): string {\n  return `${prefix}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function isPortMessage(value: unknown): value is PortMessage {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  const data = value as Partial<PortMessage>;\n  return (\n    data.protocol === PROTOCOL &&\n    data.version === VERSION &&\n    typeof data.instanceId === 'string' &&\n    typeof data.messageId === 'string' &&\n    typeof data.kind === 'string' &&\n    typeof data.type === 'string'\n  );\n}\n","import { Emitter } from './emitter';\nimport type { ChildPortConfig, EventHandler, PortMessage } from './types';\nimport { isPortMessage, PROTOCOL, randomId, VERSION } from './utils';\n\nexport interface ChildPort {\n  ready(): void;\n  emit(type: string, payload?: unknown): void;\n  on(type: string, handler: EventHandler): void;\n  respond(messageId: string, payload: unknown): void;\n  resize(height: number): void;\n  destroy(): void;\n}\n\nexport function createChildPort(config: ChildPortConfig = {}): ChildPort {\n  const emitter = new Emitter();\n  let instanceId: string | null = null;\n  let hostWindow: Window | null = null;\n  let hostOrigin: string | null = config.allowedOrigin ?? null;\n\n  const listener = (event: MessageEvent): void => {\n    if (!isPortMessage(event.data)) {\n      return;\n    }\n\n    const message = event.data;\n\n    if (message.kind === 'system' && message.type === 'port:hello') {\n      instanceId = message.instanceId;\n      hostWindow = event.source as Window;\n      hostOrigin = hostOrigin ?? event.origin;\n\n      if (hostOrigin !== event.origin) {\n        return;\n      }\n\n      ready();\n      return;\n    }\n\n    if (!instanceId || !hostWindow || message.instanceId !== instanceId) {\n      return;\n    }\n\n    if (event.source !== hostWindow || event.origin !== hostOrigin) {\n      return;\n    }\n\n    if (message.kind === 'event') {\n      void emitter.emit(message.type, message.payload);\n      return;\n    }\n\n    if (message.kind === 'request') {\n      void emitter.emit(`request:${message.type}`, message);\n    }\n  };\n\n  window.addEventListener('message', listener);\n\n  function post(message: Pick<PortMessage, 'kind' | 'type' | 'payload' | 'replyTo'>): void {\n    if (!instanceId || !hostWindow || !hostOrigin) {\n      return;\n    }\n\n    hostWindow.postMessage(\n      {\n        protocol: PROTOCOL,\n        version: VERSION,\n        instanceId,\n        messageId: randomId(),\n        ...message\n      } satisfies PortMessage,\n      hostOrigin\n    );\n  }\n\n  function ready(): void {\n    post({ kind: 'system', type: 'port:ready' });\n  }\n\n  function emit(type: string, payload?: unknown): void {\n    post({ kind: 'event', type, payload });\n  }\n\n  function on(type: string, handler: EventHandler): void {\n    emitter.on(type, handler);\n  }\n\n  function respond(messageId: string, payload: unknown): void {\n    post({ kind: 'response', type: 'port:response', payload, replyTo: messageId });\n  }\n\n  function resize(height: number): void {\n    if (!Number.isFinite(height) || height < 0) {\n      return;\n    }\n    post({ kind: 'event', type: 'port:resize', payload: height });\n  }\n\n  function destroy(): void {\n    window.removeEventListener('message', listener);\n  }\n\n  return { ready, emit, on, respond, resize, destroy };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+type PortState = 'idle' | 'mounting' | 'mounted' | 'handshaking' | 'ready' | 'open' | 'closed' | 'destroyed';
+type PortErrorCode = 'INVALID_CONFIG' | 'INVALID_STATE' | 'IFRAME_LOAD_TIMEOUT' | 'HANDSHAKE_TIMEOUT' | 'CALL_TIMEOUT' | 'ORIGIN_MISMATCH' | 'MESSAGE_REJECTED' | 'PORT_DESTROYED';
+type MessageKind = 'event' | 'request' | 'response' | 'error' | 'system';
+interface PortMessage {
+    protocol: 'crup.port';
+    version: '1';
+    instanceId: string;
+    messageId: string;
+    replyTo?: string;
+    kind: MessageKind;
+    type: string;
+    payload?: unknown;
+}
+interface PortConfig {
+    url: string;
+    allowedOrigin: string;
+    target: string | HTMLElement;
+    mode?: 'inline' | 'modal';
+    handshakeTimeoutMs?: number;
+    callTimeoutMs?: number;
+    iframeLoadTimeoutMs?: number;
+    minHeight?: number;
+    maxHeight?: number;
+}
+type EventHandler<T = unknown> = (payload: T) => void | Promise<void>;
+
+interface Port {
+    mount(): Promise<void>;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    destroy(): void;
+    send(type: string, payload?: unknown): void;
+    call<T = unknown>(type: string, payload?: unknown): Promise<T>;
+    on(type: string, handler: EventHandler): void;
+    off(type: string, handler: EventHandler): void;
+    update(config: Partial<PortConfig>): void;
+    getState(): PortState;
+}
+declare function createPort(input: PortConfig): Port;
+
+declare class PortError extends Error {
+    readonly code: PortErrorCode;
+    constructor(code: PortErrorCode, message: string);
+}
+
+export { type Port, type PortConfig, PortError, type PortErrorCode, type PortMessage, type PortState, createPort };

package/dist/index.global.js

@@ -0,0 +1,365 @@
+"use strict";
+var CrupPort = (() => {
+  var __defProp = Object.defineProperty;
+  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+  var __getOwnPropNames = Object.getOwnPropertyNames;
+  var __hasOwnProp = Object.prototype.hasOwnProperty;
+  var __export = (target, all) => {
+    for (var name in all)
+      __defProp(target, name, { get: all[name], enumerable: true });
+  };
+  var __copyProps = (to, from, except, desc) => {
+    if (from && typeof from === "object" || typeof from === "function") {
+      for (let key of __getOwnPropNames(from))
+        if (!__hasOwnProp.call(to, key) && key !== except)
+          __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+    }
+    return to;
+  };
+  var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+  // src/index.ts
+  var src_exports = {};
+  __export(src_exports, {
+    PortError: () => PortError,
+    createPort: () => createPort
+  });
+
+  // src/emitter.ts
+  var Emitter = class {
+    constructor() {
+      this.listeners = /* @__PURE__ */ new Map();
+    }
+    on(type, handler) {
+      const set = this.listeners.get(type) ?? /* @__PURE__ */ new Set();
+      set.add(handler);
+      this.listeners.set(type, set);
+    }
+    off(type, handler) {
+      this.listeners.get(type)?.delete(handler);
+    }
+    async emit(type, payload) {
+      const list = this.listeners.get(type);
+      if (!list) {
+        return;
+      }
+      await Promise.all([...list].map(async (handler) => handler(payload)));
+    }
+  };
+
+  // src/errors.ts
+  var PortError = class extends Error {
+    constructor(code, message) {
+      super(message);
+      this.code = code;
+      this.name = "PortError";
+    }
+  };
+
+  // src/utils.ts
+  var PROTOCOL = "crup.port";
+  var VERSION = "1";
+  function randomId(prefix = "msg") {
+    return `${prefix}_${Math.random().toString(36).slice(2, 10)}`;
+  }
+  function isPortMessage(value) {
+    if (typeof value !== "object" || value === null) {
+      return false;
+    }
+    const data = value;
+    return data.protocol === PROTOCOL && data.version === VERSION && typeof data.instanceId === "string" && typeof data.messageId === "string" && typeof data.kind === "string" && typeof data.type === "string";
+  }
+
+  // src/host.ts
+  var DEFAULT_HANDSHAKE_TIMEOUT = 8e3;
+  var DEFAULT_CALL_TIMEOUT = 8e3;
+  var DEFAULT_IFRAME_LOAD_TIMEOUT = 8e3;
+  function createPort(input) {
+    validateConfig(input);
+    const config = {
+      ...input,
+      mode: input.mode ?? "inline",
+      handshakeTimeoutMs: input.handshakeTimeoutMs ?? DEFAULT_HANDSHAKE_TIMEOUT,
+      callTimeoutMs: input.callTimeoutMs ?? DEFAULT_CALL_TIMEOUT,
+      iframeLoadTimeoutMs: input.iframeLoadTimeoutMs ?? DEFAULT_IFRAME_LOAD_TIMEOUT,
+      minHeight: input.minHeight ?? 0,
+      maxHeight: input.maxHeight ?? Number.MAX_SAFE_INTEGER
+    };
+    const instanceId = randomId("port");
+    const emitter = new Emitter();
+    const pending = /* @__PURE__ */ new Map();
+    let state = "idle";
+    let iframe = null;
+    let targetNode = null;
+    let modalRoot = null;
+    const listener = (event) => {
+      if (!iframe?.contentWindow || event.source !== iframe.contentWindow) {
+        return;
+      }
+      if (event.origin !== config.allowedOrigin) {
+        return;
+      }
+      if (!isPortMessage(event.data)) {
+        return;
+      }
+      const msg = event.data;
+      if (msg.instanceId !== instanceId) {
+        return;
+      }
+      if (msg.kind === "system" && msg.type === "port:ready") {
+        if (state === "handshaking") {
+          state = "ready";
+        }
+        return;
+      }
+      if (msg.kind === "response" && msg.replyTo) {
+        const call2 = pending.get(msg.replyTo);
+        if (!call2) {
+          return;
+        }
+        clearTimeout(call2.timeout);
+        pending.delete(msg.replyTo);
+        call2.resolve(msg.payload);
+        return;
+      }
+      if (msg.kind === "error" && msg.replyTo) {
+        const call2 = pending.get(msg.replyTo);
+        if (!call2) {
+          return;
+        }
+        clearTimeout(call2.timeout);
+        pending.delete(msg.replyTo);
+        const reason = typeof msg.payload === "string" ? msg.payload : "Rejected";
+        call2.reject(new PortError("MESSAGE_REJECTED", reason));
+        return;
+      }
+      if (msg.kind === "event" && msg.type === "port:resize") {
+        applyResize(msg.payload);
+        return;
+      }
+      if (msg.kind === "event") {
+        void emitter.emit(msg.type, msg.payload);
+      }
+    };
+    window.addEventListener("message", listener);
+    function ensureState(valid, nextAction) {
+      if (!valid.includes(state)) {
+        throw new PortError("INVALID_STATE", `Cannot ${nextAction} from state ${state}`);
+      }
+    }
+    function resolveTarget(target) {
+      if (typeof target === "string") {
+        const node = document.querySelector(target);
+        if (!node) {
+          throw new PortError("INVALID_CONFIG", `Target ${target} was not found`);
+        }
+        return node;
+      }
+      return target;
+    }
+    async function mount() {
+      ensureState(["idle"], "mount");
+      state = "mounting";
+      targetNode = resolveTarget(config.target);
+      iframe = document.createElement("iframe");
+      iframe.src = config.url;
+      iframe.style.width = "100%";
+      iframe.style.border = "0";
+      iframe.style.display = config.mode === "modal" ? "none" : "block";
+      if (config.mode === "modal") {
+        modalRoot = document.createElement("div");
+        modalRoot.style.position = "fixed";
+        modalRoot.style.inset = "0";
+        modalRoot.style.background = "rgba(0,0,0,0.5)";
+        modalRoot.style.display = "none";
+        modalRoot.style.alignItems = "center";
+        modalRoot.style.justifyContent = "center";
+        const container = document.createElement("div");
+        container.style.width = "min(900px, 95vw)";
+        container.style.height = "min(85vh, 900px)";
+        container.style.background = "#fff";
+        container.style.borderRadius = "8px";
+        container.style.overflow = "hidden";
+        iframe.style.display = "block";
+        iframe.style.height = "100%";
+        container.append(iframe);
+        modalRoot.append(container);
+        targetNode.append(modalRoot);
+        modalRoot.addEventListener("click", (event) => {
+          if (event.target === modalRoot) {
+            void close();
+          }
+        });
+        window.addEventListener("keydown", (event) => {
+          if (event.key === "Escape" && state === "open") {
+            void close();
+          }
+        });
+      } else {
+        targetNode.append(iframe);
+      }
+      await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+          reject(new PortError("IFRAME_LOAD_TIMEOUT", "iframe did not load in time"));
+        }, config.iframeLoadTimeoutMs);
+        iframe?.addEventListener(
+          "load",
+          () => {
+            clearTimeout(timer);
+            resolve();
+          },
+          { once: true }
+        );
+      });
+      state = "mounted";
+      await handshake();
+    }
+    async function handshake() {
+      ensureState(["mounted"], "handshake");
+      if (!iframe?.contentWindow) {
+        throw new PortError("INVALID_STATE", "iframe is unavailable for handshake");
+      }
+      state = "handshaking";
+      post({ kind: "system", type: "port:hello" });
+      await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+          clearInterval(poll);
+          reject(new PortError("HANDSHAKE_TIMEOUT", "handshake timed out"));
+        }, config.handshakeTimeoutMs);
+        const poll = setInterval(() => {
+          if (state === "ready") {
+            clearTimeout(timer);
+            clearInterval(poll);
+            resolve();
+          }
+        }, 10);
+      });
+      if (config.mode === "inline") {
+        state = "open";
+      }
+    }
+    function open() {
+      ensureState(["ready", "closed"], "open");
+      if (config.mode !== "modal") {
+        state = "open";
+        return Promise.resolve();
+      }
+      if (!modalRoot) {
+        throw new PortError("INVALID_STATE", "modal root missing");
+      }
+      modalRoot.style.display = "flex";
+      state = "open";
+      return Promise.resolve();
+    }
+    function close() {
+      ensureState(["open"], "close");
+      if (config.mode === "modal" && modalRoot) {
+        modalRoot.style.display = "none";
+      }
+      state = "closed";
+      return Promise.resolve();
+    }
+    function destroy() {
+      if (state === "destroyed") {
+        return;
+      }
+      pending.forEach((entry) => {
+        clearTimeout(entry.timeout);
+        entry.reject(new PortError("PORT_DESTROYED", "Port has been destroyed"));
+      });
+      pending.clear();
+      window.removeEventListener("message", listener);
+      iframe?.remove();
+      modalRoot?.remove();
+      iframe = null;
+      modalRoot = null;
+      targetNode = null;
+      state = "destroyed";
+    }
+    function post(message) {
+      if (!iframe?.contentWindow) {
+        throw new PortError("INVALID_STATE", "iframe is not available");
+      }
+      const finalMessage = {
+        protocol: PROTOCOL,
+        version: VERSION,
+        instanceId,
+        messageId: randomId(),
+        ...message
+      };
+      iframe.contentWindow.postMessage(finalMessage, config.allowedOrigin);
+    }
+    function send(type, payload) {
+      if (state === "destroyed") {
+        throw new PortError("PORT_DESTROYED", "Port is destroyed");
+      }
+      ensureState(["ready", "open", "closed"], "send");
+      post({ kind: "event", type, payload });
+    }
+    function call(type, payload) {
+      if (state === "destroyed") {
+        return Promise.reject(new PortError("PORT_DESTROYED", "Port is destroyed"));
+      }
+      ensureState(["ready", "open", "closed"], "call");
+      const messageId = randomId();
+      const message = {
+        protocol: PROTOCOL,
+        version: VERSION,
+        instanceId,
+        messageId,
+        kind: "request",
+        type,
+        payload
+      };
+      iframe?.contentWindow?.postMessage(message, config.allowedOrigin);
+      return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+          pending.delete(messageId);
+          reject(new PortError("CALL_TIMEOUT", `${type} timed out`));
+        }, config.callTimeoutMs);
+        pending.set(messageId, { resolve, reject, timeout });
+      });
+    }
+    function on(type, handler) {
+      emitter.on(type, handler);
+    }
+    function off(type, handler) {
+      emitter.off(type, handler);
+    }
+    function update(next) {
+      Object.assign(config, next);
+    }
+    function getState() {
+      return state;
+    }
+    function applyResize(payload) {
+      if (!iframe) {
+        return;
+      }
+      if (typeof payload !== "number" || Number.isNaN(payload)) {
+        return;
+      }
+      const bounded = Math.max(config.minHeight, Math.min(config.maxHeight, payload));
+      iframe.style.height = `${bounded}px`;
+    }
+    return {
+      mount,
+      open,
+      close,
+      destroy,
+      send,
+      call,
+      on,
+      off,
+      update,
+      getState
+    };
+  }
+  function validateConfig(config) {
+    if (!config.url || !config.allowedOrigin || !config.target) {
+      throw new PortError("INVALID_CONFIG", "url, target, and allowedOrigin are required");
+    }
+  }
+  return __toCommonJS(src_exports);
+})();
+//# sourceMappingURL=index.global.js.map

package/dist/index.global.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/emitter.ts","../src/errors.ts","../src/utils.ts","../src/host.ts"],"sourcesContent":["export { createPort } from './host';\nexport { PortError } from './errors';\nexport type { Port } from './host';\nexport type { PortConfig, PortErrorCode, PortMessage, PortState } from './types';\n","import type { EventHandler } from './types';\n\nexport class Emitter {\n  private listeners = new Map<string, Set<EventHandler>>();\n\n  on(type: string, handler: EventHandler): void {\n    const set = this.listeners.get(type) ?? new Set<EventHandler>();\n    set.add(handler);\n    this.listeners.set(type, set);\n  }\n\n  off(type: string, handler: EventHandler): void {\n    this.listeners.get(type)?.delete(handler);\n  }\n\n  async emit(type: string, payload: unknown): Promise<void> {\n    const list = this.listeners.get(type);\n    if (!list) {\n      return;\n    }\n    await Promise.all([...list].map(async (handler) => handler(payload)));\n  }\n}\n","import type { PortErrorCode } from './types';\n\nexport class PortError extends Error {\n  readonly code: PortErrorCode;\n\n  constructor(code: PortErrorCode, message: string) {\n    super(message);\n    this.code = code;\n    this.name = 'PortError';\n  }\n}\n","import type { PortMessage } from './types';\n\nexport const PROTOCOL = 'crup.port';\nexport const VERSION = '1';\n\nexport function randomId(prefix = 'msg'): string {\n  return `${prefix}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function isPortMessage(value: unknown): value is PortMessage {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  const data = value as Partial<PortMessage>;\n  return (\n    data.protocol === PROTOCOL &&\n    data.version === VERSION &&\n    typeof data.instanceId === 'string' &&\n    typeof data.messageId === 'string' &&\n    typeof data.kind === 'string' &&\n    typeof data.type === 'string'\n  );\n}\n","import { Emitter } from './emitter';\nimport { PortError } from './errors';\nimport type { EventHandler, PortConfig, PortMessage, PortState } from './types';\nimport { isPortMessage, PROTOCOL, randomId, VERSION } from './utils';\n\ninterface PendingCall {\n  resolve: (value: unknown) => void;\n  reject: (reason?: unknown) => void;\n  timeout: ReturnType<typeof setTimeout>;\n}\n\nconst DEFAULT_HANDSHAKE_TIMEOUT = 8_000;\nconst DEFAULT_CALL_TIMEOUT = 8_000;\nconst DEFAULT_IFRAME_LOAD_TIMEOUT = 8_000;\n\nexport interface Port {\n  mount(): Promise<void>;\n  open(): Promise<void>;\n  close(): Promise<void>;\n  destroy(): void;\n  send(type: string, payload?: unknown): void;\n  call<T = unknown>(type: string, payload?: unknown): Promise<T>;\n  on(type: string, handler: EventHandler): void;\n  off(type: string, handler: EventHandler): void;\n  update(config: Partial<PortConfig>): void;\n  getState(): PortState;\n}\n\nexport function createPort(input: PortConfig): Port {\n  validateConfig(input);\n\n  const config: Required<\n    Pick<PortConfig, 'mode' | 'handshakeTimeoutMs' | 'callTimeoutMs' | 'iframeLoadTimeoutMs' | 'minHeight' | 'maxHeight'>\n  > &\n    PortConfig = {\n    ...input,\n    mode: input.mode ?? 'inline',\n    handshakeTimeoutMs: input.handshakeTimeoutMs ?? DEFAULT_HANDSHAKE_TIMEOUT,\n    callTimeoutMs: input.callTimeoutMs ?? DEFAULT_CALL_TIMEOUT,\n    iframeLoadTimeoutMs: input.iframeLoadTimeoutMs ?? DEFAULT_IFRAME_LOAD_TIMEOUT,\n    minHeight: input.minHeight ?? 0,\n    maxHeight: input.maxHeight ?? Number.MAX_SAFE_INTEGER\n  };\n\n  const instanceId = randomId('port');\n  const emitter = new Emitter();\n  const pending = new Map<string, PendingCall>();\n  let state: PortState = 'idle';\n  let iframe: HTMLIFrameElement | null = null;\n  let targetNode: HTMLElement | null = null;\n  let modalRoot: HTMLDivElement | null = null;\n\n  const listener = (event: MessageEvent): void => {\n    if (!iframe?.contentWindow || event.source !== iframe.contentWindow) {\n      return;\n    }\n\n    if (event.origin !== config.allowedOrigin) {\n      return;\n    }\n\n    if (!isPortMessage(event.data)) {\n      return;\n    }\n\n    const msg = event.data;\n    if (msg.instanceId !== instanceId) {\n      return;\n    }\n\n    if (msg.kind === 'system' && msg.type === 'port:ready') {\n      if (state === 'handshaking') {\n        state = 'ready';\n      }\n      return;\n    }\n\n    if (msg.kind === 'response' && msg.replyTo) {\n      const call = pending.get(msg.replyTo);\n      if (!call) {\n        return;\n      }\n      clearTimeout(call.timeout);\n      pending.delete(msg.replyTo);\n      call.resolve(msg.payload);\n      return;\n    }\n\n    if (msg.kind === 'error' && msg.replyTo) {\n      const call = pending.get(msg.replyTo);\n      if (!call) {\n        return;\n      }\n      clearTimeout(call.timeout);\n      pending.delete(msg.replyTo);\n      const reason = typeof msg.payload === 'string' ? msg.payload : 'Rejected';\n      call.reject(new PortError('MESSAGE_REJECTED', reason));\n      return;\n    }\n\n    if (msg.kind === 'event' && msg.type === 'port:resize') {\n      applyResize(msg.payload);\n      return;\n    }\n\n    if (msg.kind === 'event') {\n      void emitter.emit(msg.type, msg.payload);\n    }\n  };\n\n  window.addEventListener('message', listener);\n\n  function ensureState(valid: PortState[], nextAction: string): void {\n    if (!valid.includes(state)) {\n      throw new PortError('INVALID_STATE', `Cannot ${nextAction} from state ${state}`);\n    }\n  }\n\n  function resolveTarget(target: PortConfig['target']): HTMLElement {\n    if (typeof target === 'string') {\n      const node = document.querySelector<HTMLElement>(target);\n      if (!node) {\n        throw new PortError('INVALID_CONFIG', `Target ${target} was not found`);\n      }\n      return node;\n    }\n    return target;\n  }\n\n  async function mount(): Promise<void> {\n    ensureState(['idle'], 'mount');\n    state = 'mounting';\n\n    targetNode = resolveTarget(config.target);\n    iframe = document.createElement('iframe');\n    iframe.src = config.url;\n    iframe.style.width = '100%';\n    iframe.style.border = '0';\n    iframe.style.display = config.mode === 'modal' ? 'none' : 'block';\n\n    if (config.mode === 'modal') {\n      modalRoot = document.createElement('div');\n      modalRoot.style.position = 'fixed';\n      modalRoot.style.inset = '0';\n      modalRoot.style.background = 'rgba(0,0,0,0.5)';\n      modalRoot.style.display = 'none';\n      modalRoot.style.alignItems = 'center';\n      modalRoot.style.justifyContent = 'center';\n\n      const container = document.createElement('div');\n      container.style.width = 'min(900px, 95vw)';\n      container.style.height = 'min(85vh, 900px)';\n      container.style.background = '#fff';\n      container.style.borderRadius = '8px';\n      container.style.overflow = 'hidden';\n      iframe.style.display = 'block';\n      iframe.style.height = '100%';\n\n      container.append(iframe);\n      modalRoot.append(container);\n      targetNode.append(modalRoot);\n\n      modalRoot.addEventListener('click', (event) => {\n        if (event.target === modalRoot) {\n          void close();\n        }\n      });\n\n      window.addEventListener('keydown', (event) => {\n        if (event.key === 'Escape' && state === 'open') {\n          void close();\n        }\n      });\n    } else {\n      targetNode.append(iframe);\n    }\n\n    await new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(new PortError('IFRAME_LOAD_TIMEOUT', 'iframe did not load in time'));\n      }, config.iframeLoadTimeoutMs);\n\n      iframe?.addEventListener(\n        'load',\n        () => {\n          clearTimeout(timer);\n          resolve();\n        },\n        { once: true }\n      );\n    });\n\n    state = 'mounted';\n    await handshake();\n  }\n\n  async function handshake(): Promise<void> {\n    ensureState(['mounted'], 'handshake');\n    if (!iframe?.contentWindow) {\n      throw new PortError('INVALID_STATE', 'iframe is unavailable for handshake');\n    }\n\n    state = 'handshaking';\n    post({ kind: 'system', type: 'port:hello' });\n\n    await new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        clearInterval(poll);\n        reject(new PortError('HANDSHAKE_TIMEOUT', 'handshake timed out'));\n      }, config.handshakeTimeoutMs);\n\n      const poll = setInterval(() => {\n        if (state === 'ready') {\n          clearTimeout(timer);\n          clearInterval(poll);\n          resolve();\n        }\n      }, 10);\n    });\n\n    if (config.mode === 'inline') {\n      state = 'open';\n    }\n  }\n\n  function open(): Promise<void> {\n    ensureState(['ready', 'closed'], 'open');\n    if (config.mode !== 'modal') {\n      state = 'open';\n      return Promise.resolve();\n    }\n    if (!modalRoot) {\n      throw new PortError('INVALID_STATE', 'modal root missing');\n    }\n    modalRoot.style.display = 'flex';\n    state = 'open';\n    return Promise.resolve();\n  }\n\n  function close(): Promise<void> {\n    ensureState(['open'], 'close');\n    if (config.mode === 'modal' && modalRoot) {\n      modalRoot.style.display = 'none';\n    }\n    state = 'closed';\n    return Promise.resolve();\n  }\n\n  function destroy(): void {\n    if (state === 'destroyed') {\n      return;\n    }\n\n    pending.forEach((entry) => {\n      clearTimeout(entry.timeout);\n      entry.reject(new PortError('PORT_DESTROYED', 'Port has been destroyed'));\n    });\n    pending.clear();\n\n    window.removeEventListener('message', listener);\n    iframe?.remove();\n    modalRoot?.remove();\n    iframe = null;\n    modalRoot = null;\n    targetNode = null;\n    state = 'destroyed';\n  }\n\n  function post(message: Pick<PortMessage, 'kind' | 'type' | 'payload' | 'replyTo'>): void {\n    if (!iframe?.contentWindow) {\n      throw new PortError('INVALID_STATE', 'iframe is not available');\n    }\n\n    const finalMessage: PortMessage = {\n      protocol: PROTOCOL,\n      version: VERSION,\n      instanceId,\n      messageId: randomId(),\n      ...message\n    };\n\n    iframe.contentWindow.postMessage(finalMessage, config.allowedOrigin);\n  }\n\n  function send(type: string, payload?: unknown): void {\n    if (state === 'destroyed') {\n      throw new PortError('PORT_DESTROYED', 'Port is destroyed');\n    }\n\n    ensureState(['ready', 'open', 'closed'], 'send');\n    post({ kind: 'event', type, payload });\n  }\n\n  function call<T = unknown>(type: string, payload?: unknown): Promise<T> {\n    if (state === 'destroyed') {\n      return Promise.reject(new PortError('PORT_DESTROYED', 'Port is destroyed'));\n    }\n\n    ensureState(['ready', 'open', 'closed'], 'call');\n\n    const messageId = randomId();\n    const message: PortMessage = {\n      protocol: PROTOCOL,\n      version: VERSION,\n      instanceId,\n      messageId,\n      kind: 'request',\n      type,\n      payload\n    };\n\n    iframe?.contentWindow?.postMessage(message, config.allowedOrigin);\n\n    return new Promise<T>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        pending.delete(messageId);\n        reject(new PortError('CALL_TIMEOUT', `${type} timed out`));\n      }, config.callTimeoutMs);\n\n      pending.set(messageId, { resolve: resolve as (value: unknown) => void, reject, timeout });\n    });\n  }\n\n  function on(type: string, handler: EventHandler): void {\n    emitter.on(type, handler);\n  }\n\n  function off(type: string, handler: EventHandler): void {\n    emitter.off(type, handler);\n  }\n\n  function update(next: Partial<PortConfig>): void {\n    Object.assign(config, next);\n  }\n\n  function getState(): PortState {\n    return state;\n  }\n\n  function applyResize(payload: unknown): void {\n    if (!iframe) {\n      return;\n    }\n    if (typeof payload !== 'number' || Number.isNaN(payload)) {\n      return;\n    }\n\n    const bounded = Math.max(config.minHeight, Math.min(config.maxHeight, payload));\n    iframe.style.height = `${bounded}px`;\n  }\n\n  return {\n    mount,\n    open,\n    close,\n    destroy,\n    send,\n    call,\n    on,\n    off,\n    update,\n    getState\n  };\n}\n\nfunction validateConfig(config: PortConfig): void {\n  if (!config.url || !config.allowedOrigin || !config.target) {\n    throw new PortError('INVALID_CONFIG', 'url, target, and allowedOrigin are required');\n  }\n}\n"],"mappings":"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","names":["call"]}

package/dist/index.mjs

@@ -0,0 +1,340 @@
+// src/emitter.ts
+var Emitter = class {
+  constructor() {
+    this.listeners = /* @__PURE__ */ new Map();
+  }
+  on(type, handler) {
+    const set = this.listeners.get(type) ?? /* @__PURE__ */ new Set();
+    set.add(handler);
+    this.listeners.set(type, set);
+  }
+  off(type, handler) {
+    this.listeners.get(type)?.delete(handler);
+  }
+  async emit(type, payload) {
+    const list = this.listeners.get(type);
+    if (!list) {
+      return;
+    }
+    await Promise.all([...list].map(async (handler) => handler(payload)));
+  }
+};
+
+// src/errors.ts
+var PortError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "PortError";
+  }
+};
+
+// src/utils.ts
+var PROTOCOL = "crup.port";
+var VERSION = "1";
+function randomId(prefix = "msg") {
+  return `${prefix}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function isPortMessage(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const data = value;
+  return data.protocol === PROTOCOL && data.version === VERSION && typeof data.instanceId === "string" && typeof data.messageId === "string" && typeof data.kind === "string" && typeof data.type === "string";
+}
+
+// src/host.ts
+var DEFAULT_HANDSHAKE_TIMEOUT = 8e3;
+var DEFAULT_CALL_TIMEOUT = 8e3;
+var DEFAULT_IFRAME_LOAD_TIMEOUT = 8e3;
+function createPort(input) {
+  validateConfig(input);
+  const config = {
+    ...input,
+    mode: input.mode ?? "inline",
+    handshakeTimeoutMs: input.handshakeTimeoutMs ?? DEFAULT_HANDSHAKE_TIMEOUT,
+    callTimeoutMs: input.callTimeoutMs ?? DEFAULT_CALL_TIMEOUT,
+    iframeLoadTimeoutMs: input.iframeLoadTimeoutMs ?? DEFAULT_IFRAME_LOAD_TIMEOUT,
+    minHeight: input.minHeight ?? 0,
+    maxHeight: input.maxHeight ?? Number.MAX_SAFE_INTEGER
+  };
+  const instanceId = randomId("port");
+  const emitter = new Emitter();
+  const pending = /* @__PURE__ */ new Map();
+  let state = "idle";
+  let iframe = null;
+  let targetNode = null;
+  let modalRoot = null;
+  const listener = (event) => {
+    if (!iframe?.contentWindow || event.source !== iframe.contentWindow) {
+      return;
+    }
+    if (event.origin !== config.allowedOrigin) {
+      return;
+    }
+    if (!isPortMessage(event.data)) {
+      return;
+    }
+    const msg = event.data;
+    if (msg.instanceId !== instanceId) {
+      return;
+    }
+    if (msg.kind === "system" && msg.type === "port:ready") {
+      if (state === "handshaking") {
+        state = "ready";
+      }
+      return;
+    }
+    if (msg.kind === "response" && msg.replyTo) {
+      const call2 = pending.get(msg.replyTo);
+      if (!call2) {
+        return;
+      }
+      clearTimeout(call2.timeout);
+      pending.delete(msg.replyTo);
+      call2.resolve(msg.payload);
+      return;
+    }
+    if (msg.kind === "error" && msg.replyTo) {
+      const call2 = pending.get(msg.replyTo);
+      if (!call2) {
+        return;
+      }
+      clearTimeout(call2.timeout);
+      pending.delete(msg.replyTo);
+      const reason = typeof msg.payload === "string" ? msg.payload : "Rejected";
+      call2.reject(new PortError("MESSAGE_REJECTED", reason));
+      return;
+    }
+    if (msg.kind === "event" && msg.type === "port:resize") {
+      applyResize(msg.payload);
+      return;
+    }
+    if (msg.kind === "event") {
+      void emitter.emit(msg.type, msg.payload);
+    }
+  };
+  window.addEventListener("message", listener);
+  function ensureState(valid, nextAction) {
+    if (!valid.includes(state)) {
+      throw new PortError("INVALID_STATE", `Cannot ${nextAction} from state ${state}`);
+    }
+  }
+  function resolveTarget(target) {
+    if (typeof target === "string") {
+      const node = document.querySelector(target);
+      if (!node) {
+        throw new PortError("INVALID_CONFIG", `Target ${target} was not found`);
+      }
+      return node;
+    }
+    return target;
+  }
+  async function mount() {
+    ensureState(["idle"], "mount");
+    state = "mounting";
+    targetNode = resolveTarget(config.target);
+    iframe = document.createElement("iframe");
+    iframe.src = config.url;
+    iframe.style.width = "100%";
+    iframe.style.border = "0";
+    iframe.style.display = config.mode === "modal" ? "none" : "block";
+    if (config.mode === "modal") {
+      modalRoot = document.createElement("div");
+      modalRoot.style.position = "fixed";
+      modalRoot.style.inset = "0";
+      modalRoot.style.background = "rgba(0,0,0,0.5)";
+      modalRoot.style.display = "none";
+      modalRoot.style.alignItems = "center";
+      modalRoot.style.justifyContent = "center";
+      const container = document.createElement("div");
+      container.style.width = "min(900px, 95vw)";
+      container.style.height = "min(85vh, 900px)";
+      container.style.background = "#fff";
+      container.style.borderRadius = "8px";
+      container.style.overflow = "hidden";
+      iframe.style.display = "block";
+      iframe.style.height = "100%";
+      container.append(iframe);
+      modalRoot.append(container);
+      targetNode.append(modalRoot);
+      modalRoot.addEventListener("click", (event) => {
+        if (event.target === modalRoot) {
+          void close();
+        }
+      });
+      window.addEventListener("keydown", (event) => {
+        if (event.key === "Escape" && state === "open") {
+          void close();
+        }
+      });
+    } else {
+      targetNode.append(iframe);
+    }
+    await new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        reject(new PortError("IFRAME_LOAD_TIMEOUT", "iframe did not load in time"));
+      }, config.iframeLoadTimeoutMs);
+      iframe?.addEventListener(
+        "load",
+        () => {
+          clearTimeout(timer);
+          resolve();
+        },
+        { once: true }
+      );
+    });
+    state = "mounted";
+    await handshake();
+  }
+  async function handshake() {
+    ensureState(["mounted"], "handshake");
+    if (!iframe?.contentWindow) {
+      throw new PortError("INVALID_STATE", "iframe is unavailable for handshake");
+    }
+    state = "handshaking";
+    post({ kind: "system", type: "port:hello" });
+    await new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        clearInterval(poll);
+        reject(new PortError("HANDSHAKE_TIMEOUT", "handshake timed out"));
+      }, config.handshakeTimeoutMs);
+      const poll = setInterval(() => {
+        if (state === "ready") {
+          clearTimeout(timer);
+          clearInterval(poll);
+          resolve();
+        }
+      }, 10);
+    });
+    if (config.mode === "inline") {
+      state = "open";
+    }
+  }
+  function open() {
+    ensureState(["ready", "closed"], "open");
+    if (config.mode !== "modal") {
+      state = "open";
+      return Promise.resolve();
+    }
+    if (!modalRoot) {
+      throw new PortError("INVALID_STATE", "modal root missing");
+    }
+    modalRoot.style.display = "flex";
+    state = "open";
+    return Promise.resolve();
+  }
+  function close() {
+    ensureState(["open"], "close");
+    if (config.mode === "modal" && modalRoot) {
+      modalRoot.style.display = "none";
+    }
+    state = "closed";
+    return Promise.resolve();
+  }
+  function destroy() {
+    if (state === "destroyed") {
+      return;
+    }
+    pending.forEach((entry) => {
+      clearTimeout(entry.timeout);
+      entry.reject(new PortError("PORT_DESTROYED", "Port has been destroyed"));
+    });
+    pending.clear();
+    window.removeEventListener("message", listener);
+    iframe?.remove();
+    modalRoot?.remove();
+    iframe = null;
+    modalRoot = null;
+    targetNode = null;
+    state = "destroyed";
+  }
+  function post(message) {
+    if (!iframe?.contentWindow) {
+      throw new PortError("INVALID_STATE", "iframe is not available");
+    }
+    const finalMessage = {
+      protocol: PROTOCOL,
+      version: VERSION,
+      instanceId,
+      messageId: randomId(),
+      ...message
+    };
+    iframe.contentWindow.postMessage(finalMessage, config.allowedOrigin);
+  }
+  function send(type, payload) {
+    if (state === "destroyed") {
+      throw new PortError("PORT_DESTROYED", "Port is destroyed");
+    }
+    ensureState(["ready", "open", "closed"], "send");
+    post({ kind: "event", type, payload });
+  }
+  function call(type, payload) {
+    if (state === "destroyed") {
+      return Promise.reject(new PortError("PORT_DESTROYED", "Port is destroyed"));
+    }
+    ensureState(["ready", "open", "closed"], "call");
+    const messageId = randomId();
+    const message = {
+      protocol: PROTOCOL,
+      version: VERSION,
+      instanceId,
+      messageId,
+      kind: "request",
+      type,
+      payload
+    };
+    iframe?.contentWindow?.postMessage(message, config.allowedOrigin);
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        pending.delete(messageId);
+        reject(new PortError("CALL_TIMEOUT", `${type} timed out`));
+      }, config.callTimeoutMs);
+      pending.set(messageId, { resolve, reject, timeout });
+    });
+  }
+  function on(type, handler) {
+    emitter.on(type, handler);
+  }
+  function off(type, handler) {
+    emitter.off(type, handler);
+  }
+  function update(next) {
+    Object.assign(config, next);
+  }
+  function getState() {
+    return state;
+  }
+  function applyResize(payload) {
+    if (!iframe) {
+      return;
+    }
+    if (typeof payload !== "number" || Number.isNaN(payload)) {
+      return;
+    }
+    const bounded = Math.max(config.minHeight, Math.min(config.maxHeight, payload));
+    iframe.style.height = `${bounded}px`;
+  }
+  return {
+    mount,
+    open,
+    close,
+    destroy,
+    send,
+    call,
+    on,
+    off,
+    update,
+    getState
+  };
+}
+function validateConfig(config) {
+  if (!config.url || !config.allowedOrigin || !config.target) {
+    throw new PortError("INVALID_CONFIG", "url, target, and allowedOrigin are required");
+  }
+}
+export {
+  PortError,
+  createPort
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/emitter.ts","../src/errors.ts","../src/utils.ts","../src/host.ts"],"sourcesContent":["import type { EventHandler } from './types';\n\nexport class Emitter {\n  private listeners = new Map<string, Set<EventHandler>>();\n\n  on(type: string, handler: EventHandler): void {\n    const set = this.listeners.get(type) ?? new Set<EventHandler>();\n    set.add(handler);\n    this.listeners.set(type, set);\n  }\n\n  off(type: string, handler: EventHandler): void {\n    this.listeners.get(type)?.delete(handler);\n  }\n\n  async emit(type: string, payload: unknown): Promise<void> {\n    const list = this.listeners.get(type);\n    if (!list) {\n      return;\n    }\n    await Promise.all([...list].map(async (handler) => handler(payload)));\n  }\n}\n","import type { PortErrorCode } from './types';\n\nexport class PortError extends Error {\n  readonly code: PortErrorCode;\n\n  constructor(code: PortErrorCode, message: string) {\n    super(message);\n    this.code = code;\n    this.name = 'PortError';\n  }\n}\n","import type { PortMessage } from './types';\n\nexport const PROTOCOL = 'crup.port';\nexport const VERSION = '1';\n\nexport function randomId(prefix = 'msg'): string {\n  return `${prefix}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function isPortMessage(value: unknown): value is PortMessage {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  const data = value as Partial<PortMessage>;\n  return (\n    data.protocol === PROTOCOL &&\n    data.version === VERSION &&\n    typeof data.instanceId === 'string' &&\n    typeof data.messageId === 'string' &&\n    typeof data.kind === 'string' &&\n    typeof data.type === 'string'\n  );\n}\n","import { Emitter } from './emitter';\nimport { PortError } from './errors';\nimport type { EventHandler, PortConfig, PortMessage, PortState } from './types';\nimport { isPortMessage, PROTOCOL, randomId, VERSION } from './utils';\n\ninterface PendingCall {\n  resolve: (value: unknown) => void;\n  reject: (reason?: unknown) => void;\n  timeout: ReturnType<typeof setTimeout>;\n}\n\nconst DEFAULT_HANDSHAKE_TIMEOUT = 8_000;\nconst DEFAULT_CALL_TIMEOUT = 8_000;\nconst DEFAULT_IFRAME_LOAD_TIMEOUT = 8_000;\n\nexport interface Port {\n  mount(): Promise<void>;\n  open(): Promise<void>;\n  close(): Promise<void>;\n  destroy(): void;\n  send(type: string, payload?: unknown): void;\n  call<T = unknown>(type: string, payload?: unknown): Promise<T>;\n  on(type: string, handler: EventHandler): void;\n  off(type: string, handler: EventHandler): void;\n  update(config: Partial<PortConfig>): void;\n  getState(): PortState;\n}\n\nexport function createPort(input: PortConfig): Port {\n  validateConfig(input);\n\n  const config: Required<\n    Pick<PortConfig, 'mode' | 'handshakeTimeoutMs' | 'callTimeoutMs' | 'iframeLoadTimeoutMs' | 'minHeight' | 'maxHeight'>\n  > &\n    PortConfig = {\n    ...input,\n    mode: input.mode ?? 'inline',\n    handshakeTimeoutMs: input.handshakeTimeoutMs ?? DEFAULT_HANDSHAKE_TIMEOUT,\n    callTimeoutMs: input.callTimeoutMs ?? DEFAULT_CALL_TIMEOUT,\n    iframeLoadTimeoutMs: input.iframeLoadTimeoutMs ?? DEFAULT_IFRAME_LOAD_TIMEOUT,\n    minHeight: input.minHeight ?? 0,\n    maxHeight: input.maxHeight ?? Number.MAX_SAFE_INTEGER\n  };\n\n  const instanceId = randomId('port');\n  const emitter = new Emitter();\n  const pending = new Map<string, PendingCall>();\n  let state: PortState = 'idle';\n  let iframe: HTMLIFrameElement | null = null;\n  let targetNode: HTMLElement | null = null;\n  let modalRoot: HTMLDivElement | null = null;\n\n  const listener = (event: MessageEvent): void => {\n    if (!iframe?.contentWindow || event.source !== iframe.contentWindow) {\n      return;\n    }\n\n    if (event.origin !== config.allowedOrigin) {\n      return;\n    }\n\n    if (!isPortMessage(event.data)) {\n      return;\n    }\n\n    const msg = event.data;\n    if (msg.instanceId !== instanceId) {\n      return;\n    }\n\n    if (msg.kind === 'system' && msg.type === 'port:ready') {\n      if (state === 'handshaking') {\n        state = 'ready';\n      }\n      return;\n    }\n\n    if (msg.kind === 'response' && msg.replyTo) {\n      const call = pending.get(msg.replyTo);\n      if (!call) {\n        return;\n      }\n      clearTimeout(call.timeout);\n      pending.delete(msg.replyTo);\n      call.resolve(msg.payload);\n      return;\n    }\n\n    if (msg.kind === 'error' && msg.replyTo) {\n      const call = pending.get(msg.replyTo);\n      if (!call) {\n        return;\n      }\n      clearTimeout(call.timeout);\n      pending.delete(msg.replyTo);\n      const reason = typeof msg.payload === 'string' ? msg.payload : 'Rejected';\n      call.reject(new PortError('MESSAGE_REJECTED', reason));\n      return;\n    }\n\n    if (msg.kind === 'event' && msg.type === 'port:resize') {\n      applyResize(msg.payload);\n      return;\n    }\n\n    if (msg.kind === 'event') {\n      void emitter.emit(msg.type, msg.payload);\n    }\n  };\n\n  window.addEventListener('message', listener);\n\n  function ensureState(valid: PortState[], nextAction: string): void {\n    if (!valid.includes(state)) {\n      throw new PortError('INVALID_STATE', `Cannot ${nextAction} from state ${state}`);\n    }\n  }\n\n  function resolveTarget(target: PortConfig['target']): HTMLElement {\n    if (typeof target === 'string') {\n      const node = document.querySelector<HTMLElement>(target);\n      if (!node) {\n        throw new PortError('INVALID_CONFIG', `Target ${target} was not found`);\n      }\n      return node;\n    }\n    return target;\n  }\n\n  async function mount(): Promise<void> {\n    ensureState(['idle'], 'mount');\n    state = 'mounting';\n\n    targetNode = resolveTarget(config.target);\n    iframe = document.createElement('iframe');\n    iframe.src = config.url;\n    iframe.style.width = '100%';\n    iframe.style.border = '0';\n    iframe.style.display = config.mode === 'modal' ? 'none' : 'block';\n\n    if (config.mode === 'modal') {\n      modalRoot = document.createElement('div');\n      modalRoot.style.position = 'fixed';\n      modalRoot.style.inset = '0';\n      modalRoot.style.background = 'rgba(0,0,0,0.5)';\n      modalRoot.style.display = 'none';\n      modalRoot.style.alignItems = 'center';\n      modalRoot.style.justifyContent = 'center';\n\n      const container = document.createElement('div');\n      container.style.width = 'min(900px, 95vw)';\n      container.style.height = 'min(85vh, 900px)';\n      container.style.background = '#fff';\n      container.style.borderRadius = '8px';\n      container.style.overflow = 'hidden';\n      iframe.style.display = 'block';\n      iframe.style.height = '100%';\n\n      container.append(iframe);\n      modalRoot.append(container);\n      targetNode.append(modalRoot);\n\n      modalRoot.addEventListener('click', (event) => {\n        if (event.target === modalRoot) {\n          void close();\n        }\n      });\n\n      window.addEventListener('keydown', (event) => {\n        if (event.key === 'Escape' && state === 'open') {\n          void close();\n        }\n      });\n    } else {\n      targetNode.append(iframe);\n    }\n\n    await new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(new PortError('IFRAME_LOAD_TIMEOUT', 'iframe did not load in time'));\n      }, config.iframeLoadTimeoutMs);\n\n      iframe?.addEventListener(\n        'load',\n        () => {\n          clearTimeout(timer);\n          resolve();\n        },\n        { once: true }\n      );\n    });\n\n    state = 'mounted';\n    await handshake();\n  }\n\n  async function handshake(): Promise<void> {\n    ensureState(['mounted'], 'handshake');\n    if (!iframe?.contentWindow) {\n      throw new PortError('INVALID_STATE', 'iframe is unavailable for handshake');\n    }\n\n    state = 'handshaking';\n    post({ kind: 'system', type: 'port:hello' });\n\n    await new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        clearInterval(poll);\n        reject(new PortError('HANDSHAKE_TIMEOUT', 'handshake timed out'));\n      }, config.handshakeTimeoutMs);\n\n      const poll = setInterval(() => {\n        if (state === 'ready') {\n          clearTimeout(timer);\n          clearInterval(poll);\n          resolve();\n        }\n      }, 10);\n    });\n\n    if (config.mode === 'inline') {\n      state = 'open';\n    }\n  }\n\n  function open(): Promise<void> {\n    ensureState(['ready', 'closed'], 'open');\n    if (config.mode !== 'modal') {\n      state = 'open';\n      return Promise.resolve();\n    }\n    if (!modalRoot) {\n      throw new PortError('INVALID_STATE', 'modal root missing');\n    }\n    modalRoot.style.display = 'flex';\n    state = 'open';\n    return Promise.resolve();\n  }\n\n  function close(): Promise<void> {\n    ensureState(['open'], 'close');\n    if (config.mode === 'modal' && modalRoot) {\n      modalRoot.style.display = 'none';\n    }\n    state = 'closed';\n    return Promise.resolve();\n  }\n\n  function destroy(): void {\n    if (state === 'destroyed') {\n      return;\n    }\n\n    pending.forEach((entry) => {\n      clearTimeout(entry.timeout);\n      entry.reject(new PortError('PORT_DESTROYED', 'Port has been destroyed'));\n    });\n    pending.clear();\n\n    window.removeEventListener('message', listener);\n    iframe?.remove();\n    modalRoot?.remove();\n    iframe = null;\n    modalRoot = null;\n    targetNode = null;\n    state = 'destroyed';\n  }\n\n  function post(message: Pick<PortMessage, 'kind' | 'type' | 'payload' | 'replyTo'>): void {\n    if (!iframe?.contentWindow) {\n      throw new PortError('INVALID_STATE', 'iframe is not available');\n    }\n\n    const finalMessage: PortMessage = {\n      protocol: PROTOCOL,\n      version: VERSION,\n      instanceId,\n      messageId: randomId(),\n      ...message\n    };\n\n    iframe.contentWindow.postMessage(finalMessage, config.allowedOrigin);\n  }\n\n  function send(type: string, payload?: unknown): void {\n    if (state === 'destroyed') {\n      throw new PortError('PORT_DESTROYED', 'Port is destroyed');\n    }\n\n    ensureState(['ready', 'open', 'closed'], 'send');\n    post({ kind: 'event', type, payload });\n  }\n\n  function call<T = unknown>(type: string, payload?: unknown): Promise<T> {\n    if (state === 'destroyed') {\n      return Promise.reject(new PortError('PORT_DESTROYED', 'Port is destroyed'));\n    }\n\n    ensureState(['ready', 'open', 'closed'], 'call');\n\n    const messageId = randomId();\n    const message: PortMessage = {\n      protocol: PROTOCOL,\n      version: VERSION,\n      instanceId,\n      messageId,\n      kind: 'request',\n      type,\n      payload\n    };\n\n    iframe?.contentWindow?.postMessage(message, config.allowedOrigin);\n\n    return new Promise<T>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        pending.delete(messageId);\n        reject(new PortError('CALL_TIMEOUT', `${type} timed out`));\n      }, config.callTimeoutMs);\n\n      pending.set(messageId, { resolve: resolve as (value: unknown) => void, reject, timeout });\n    });\n  }\n\n  function on(type: string, handler: EventHandler): void {\n    emitter.on(type, handler);\n  }\n\n  function off(type: string, handler: EventHandler): void {\n    emitter.off(type, handler);\n  }\n\n  function update(next: Partial<PortConfig>): void {\n    Object.assign(config, next);\n  }\n\n  function getState(): PortState {\n    return state;\n  }\n\n  function applyResize(payload: unknown): void {\n    if (!iframe) {\n      return;\n    }\n    if (typeof payload !== 'number' || Number.isNaN(payload)) {\n      return;\n    }\n\n    const bounded = Math.max(config.minHeight, Math.min(config.maxHeight, payload));\n    iframe.style.height = `${bounded}px`;\n  }\n\n  return {\n    mount,\n    open,\n    close,\n    destroy,\n    send,\n    call,\n    on,\n    off,\n    update,\n    getState\n  };\n}\n\nfunction validateConfig(config: PortConfig): void {\n  if (!config.url || !config.allowedOrigin || !config.target) {\n    throw new PortError('INVALID_CONFIG', 'url, target, and allowedOrigin are required');\n  }\n}\n"],"mappings":"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","names":["call"]}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@crup/port",
+  "version": "0.1.1",
+  "description": "A lightweight protocol-first iframe runtime for building secure host/child embeds with explicit lifecycle and messaging.",
+  "homepage": "https://crup.github.io/port/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/crup/port.git"
+  },
+  "bugs": {
+    "url": "https://github.com/crup/port/issues"
+  },
+  "author": "Rajender Joshi <connect@rajender.pro>",
+  "keywords": [
+    "iframe",
+    "iframe-runtime",
+    "postmessage",
+    "embed",
+    "protocol",
+    "messaging",
+    "rpc",
+    "cross-origin",
+    "widget",
+    "sdk",
+    "typescript",
+    "browser",
+    "runtime"
+  ],
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./child": {
+      "types": "./dist/child.d.ts",
+      "import": "./dist/child.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.7",
+    "@eslint/js": "^9.25.1",
+    "@types/node": "^24.5.2",
+    "eslint": "^9.25.1",
+    "globals": "^16.0.0",
+    "husky": "^9.1.7",
+    "jsdom": "^25.0.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "typescript-eslint": "^8.31.1",
+    "vite": "^7.1.10",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "demo:dev": "vite --config vite.demo.config.ts --host",
+    "demo:build": "vite build --config vite.demo.config.ts",
+    "demo:preview": "vite preview --config vite.demo.config.ts",
+    "docs:dev": "pnpm demo:dev",
+    "docs:build": "pnpm demo:build",
+    "docs:preview": "pnpm demo:preview",
+    "lint": "eslint .",
+    "check": "pnpm lint && pnpm typecheck && pnpm test && pnpm build",
+    "test:coverage": "vitest run --coverage",
+    "readme:check": "node scripts/check-readme.mjs",
+    "size": "node scripts/size-report.mjs",
+    "size:json": "node scripts/size-report.mjs --json",
+    "changeset": "changeset",
+    "release": "changeset publish",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "examples": "echo \"Open examples/ for host/child integration snippets\""
+  }
+}