@nominalso/vibe-host 0.0.1

package/LICENSE

@@ -0,0 +1,10 @@
+Copyright © 2026 Nominal. All rights reserved.
+
+This software and its source code are proprietary and confidential.
+The packages published from this repository are marked "UNLICENSED": no
+license or right to use, copy, modify, distribute, or create derivative
+works is granted except under a separate written agreement with Nominal.
+
+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.

package/README.md

@@ -0,0 +1,39 @@
+# @nominalso/vibe-host
+
+Host-side SDK for embedding **Nominal Vibe Apps**. Used by the Nominal app (nom-ui) to receive requests from an
+embedded Vibe App over a typed `postMessage` protocol and dispatch them to Nominal APIs. The host ships a
+**complete, type-checked handler map** covering every protocol operation — you only supply a `clientConfig`
+pointing at the Nominal API, and the SDK wires up and dispatches all operations for you.
+
+## Install
+
+```sh
+npm install @nominalso/vibe-host
+```
+
+## Usage
+
+```tsx
+import { VibeAppHost } from '@nominalso/vibe-host'
+
+const host = new VibeAppHost({
+  trustedOrigins: ['https://my-vibe-app.lovable.app'],
+  appBasePath: `/${tenant}/${subsidiary}/apps/${slug}`,
+  getContext: () => ({ tenant, subsidiaryId, subsidiaries, user, lastClosedPeriodSlug }),
+  // Points the built-in handler map at the Nominal API (e.g. nom-ui's proxy route).
+  // The SDK provides handlers for every protocol operation out of the box.
+  clientConfig: { baseUrl: '/api/proxy', stripApiPrefix: true },
+})
+
+// Start listening before the iframe loads, then push context on its `load` event.
+const unmount = host.mount()
+// host.pushContextTo(iframe.contentWindow)
+```
+
+The iframe side is [`@nominalso/vibe-bridge`](https://www.npmjs.com/package/@nominalso/vibe-bridge). See the
+[repository](https://github.com/nominalso/vibe-apps-sdk#readme) for the full protocol, architecture, and the
+SSR / iframe-mounting notes.
+
+## License
+
+UNLICENSED — proprietary. © Nominal. All rights reserved.