@port-labs/plugins-sdk 0.0.1

package/README.md

@@ -0,0 +1,208 @@
+# `@port-labs/plugins-sdk`
+
+TypeScript/JavaScript SDK for **Port custom plugins** running inside the Port web app (usually in an iframe). For **React**, use **`usePortPluginData`** from **`@port-labs/plugins-sdk/react`**. For **other stacks**, the same host context is available via a small **subscribe / snapshot** store and synchronous **getters**. The package also helps merge dashboard page filters into Port entity-search queries (`mergePageFilters`).
+
+## Install
+
+```bash
+npm install @port-labs/plugins-sdk
+```
+
+```bash
+yarn add @port-labs/plugins-sdk
+```
+
+```bash
+pnpm add @port-labs/plugins-sdk
+```
+
+**Optional peer:** **react** ≥ 18 — only required if you import `@port-labs/plugins-sdk/react`.
+
+**Node:** use an LTS version compatible with your bundler; this package declares `engines.node` ≥ 22.
+
+## What it does
+
+1. Listens for messages from the Port host (`PORT_TOKEN`, `PLUGIN_DATA`).
+2. When embedded in an iframe, asks the parent once for a token (`REQUEST_PORT_TOKEN`).
+3. Exposes the latest host payload through **`usePortPluginData`** (React) or **getters** and **`subscribe` + `getSnapshot`** (Vue, Svelte, Solid, vanilla JS, etc.).
+4. Provides **`mergePageFilters`** to combine your widget’s entity-search body with the page’s filter rules.
+
+## Host protocol
+
+Your plugin and the Port UI must agree on these messages:
+
+| Direction     | `event.data.type`    | Payload / role                          |
+| ------------- | -------------------- | --------------------------------------- |
+| Plugin → host | `REQUEST_PORT_TOKEN` | Ask the host for a JWT for Port API calls. |
+| Host → plugin | `PORT_TOKEN`         | `{ token: string }`                     |
+| Host → plugin | `PLUGIN_DATA`        | `{ params, page, user, entity, baseUrl, theme? }` |
+
+**Getters** expose: `params`, `page`, `user`, `entity`, `theme` (via `getParams()`, `getPage()`, …), plus `getToken()` and `getPortApiBaseUrl()` (same data as `PLUGIN_DATA` plus the token). Call **`applyThemeCss()`** to inject the host theme stylesheet (see [Theming and CSS variables](#theming-and-css-variables)).
+
+## Usage
+
+### React
+
+Install **`react` ≥ 18**, then import from **`@port-labs/plugins-sdk/react`**:
+
+```bash
+npm install react
+```
+
+```tsx
+import { usePortPluginData } from '@port-labs/plugins-sdk/react';
+
+function MyPlugin() {
+	const { portToken, portApiBaseUrl, page, user, entity, params } = usePortPluginData();
+
+	if (!portToken) return <p>Waiting for host…</p>;
+
+	return (
+		<pre>{JSON.stringify({ page, user, entity, params }, null, 2)}</pre>
+	);
+}
+```
+
+To match the Port UI colors, opt in to host theme CSS with **`applyThemeCss`** from the same hook (see [Theming and CSS variables](#theming-and-css-variables)).
+
+### Other frameworks (store + getters)
+
+The same host data is available without React. Call **`initPortPluginMessaging()`** once early if you want (getters and `subscribe` call it automatically). Use **`subscribe(listener)`** to re-run when the host sends new data; read state with **`getSnapshot()`**. **`getServerSnapshot()`** is for SSR (empty static snapshot).
+
+```ts
+import {
+	getSnapshot,
+	getToken,
+	subscribe,
+	type PluginHostState,
+} from '@port-labs/plugins-sdk';
+
+function bindHostToView(update: (state: PluginHostState) => void) {
+	const unsub = subscribe(() => update(getSnapshot()));
+	update(getSnapshot());
+	return unsub;
+}
+```
+
+Synchronous reads anywhere (no extra listeners):
+
+```ts
+import { getToken, getPortApiBaseUrl } from '@port-labs/plugins-sdk';
+
+async function callPortSearch(body: unknown) {
+	const token = getToken();
+	const base = getPortApiBaseUrl();
+	if (!token || !base) throw new Error('Plugin not ready');
+	// …
+}
+```
+
+### Merging page filters with a widget search query
+
+Use `mergePageFilters` so results respect both the widget query and the dashboard page filters (`page.pageFilters`). Types such as `EntitiesQuery`, `PageQuery`, and `Blueprint` are exported from this package for typing your query and blueprint objects.
+
+```ts
+import { getPage, mergePageFilters, type Blueprint, type EntitiesQuery } from '@port-labs/plugins-sdk';
+
+const widgetQuery: EntitiesQuery = {
+	combinator: 'and',
+	rules: [/* your rules */],
+};
+
+const merged = mergePageFilters(widgetQuery, getPage()?.pageFilters, blueprint as Blueprint);
+```
+
+`mergeWidgetQueryWithPageQuery` is an alias for `mergePageFilters`. The constant `DASHBOARD_FILTERS_META_BLUEPRINT` identifies dashboard-wide filter rules in page filter arrays.
+
+## Theming and CSS variables
+
+The host can send a **`theme`** object on **`PLUGIN_DATA`**:
+
+```ts
+type Theme = {
+	mode: string;
+	css: string; // `:root { --background-primary: ...; --text-high: ...; }`
+};
+```
+
+The SDK stores this on **`theme`** in the snapshot and from **`usePortPluginData()`**. To opt in to applying the host theme CSS, call **`applyThemeCss()`** (from the main package or via the hook):
+
+```tsx
+import { useEffect } from 'react';
+import { usePortPluginData } from '@port-labs/plugins-sdk/react';
+
+function MyPlugin() {
+	const { applyThemeCss } = usePortPluginData();
+
+	useEffect(() => {
+		applyThemeCss();
+	}, [applyThemeCss]); // `applyThemeCss` identity updates when host `theme.css` changes
+
+	// …
+}
+```
+
+Vanilla / non-React:
+
+```ts
+import { applyThemeCss, subscribe } from '@port-labs/plugins-sdk';
+
+subscribe(() => {
+	applyThemeCss();
+});
+applyThemeCss();
+```
+
+This injects a `<style id="port-plugin-theme">` tag with the theme’s `css` into `document.head`. If the host omits theme or `css`, that element is removed.
+
+In your own CSS, consume variables with safe fallbacks, for example:
+
+```css
+body {
+	background: rgb(var(--primary, 245, 247, 250));
+	color: var(--text-high, #1a1a2e);
+}
+
+.plugin-container {
+	background: var(--background-primary, #fff);
+}
+
+.data-row {
+	background: var(--background-contrast, #fff);
+	border-color: var(--border-contrast-medium, #e2e8f0);
+}
+```
+
+Common variables you can reuse include (non-exhaustive):
+
+- **`--background-primary`**: main surface/background color
+- **`--background-dim`** / **`--background-dim-transparent`**: softer backgrounds and cards
+- **`--background-contrast`**: high-contrast surface
+- **`--text-high`** / **`--text-medium`** / **`--text-low`**: primary, secondary, and subtle text
+- **`--border-medium`** / **`--border-contrast-medium`**: border colors
+- **`--primary`**: RGB triple for the primary color, used via `rgb(var(--primary))`
+
+## API overview
+
+### React entry (`@port-labs/plugins-sdk/react`)
+
+| Export | Description |
+| ------ | ----------- |
+| `usePortPluginData` | Hook backed by `useSyncExternalStore` over the same store as the main entry. Includes `theme` and `applyThemeCss` (identity updates when `theme.css` changes so `useEffect(..., [applyThemeCss])` reapplies styles). |
+| Types | Re-exported for convenience: `Theme`, `PluginHostState`, `Page`, `User`, `Entity`, `Params` (same as the main entry). |
+
+### Main entry (`@port-labs/plugins-sdk`)
+
+| Export | Description |
+| ------ | ----------- |
+| `getToken`, `getUser`, `getEntity`, `getPage`, `getParams`, `getPortApiBaseUrl`, `getTheme` | Read the current snapshot. |
+| `applyThemeCss` | Apply or clear host theme CSS in `document.head` (`#port-plugin-theme`). |
+| `initPortPluginMessaging` | Ensures the listener is registered (also run automatically by getters and `subscribe`). |
+| `subscribe`, `getSnapshot`, `getServerSnapshot` | Framework-agnostic reactive core (`subscribe` notifies; `getSnapshot` reads). |
+| `mergePageFilters` | AND-merge widget `EntitiesQuery` with page filters and blueprint rules. |
+| `mergeWidgetQueryWithPageQuery` | Alias for `mergePageFilters`. |
+| Types | Host context: `Page`, `User`, `Entity`, `Params`, `Theme`, `PluginHostState`. Search/blueprint: `EntitiesQuery`, `PageQuery`, `Blueprint`, `AnyEntitiesQueryRule`, `PluginParamType`, `PluginParamValue`, … |
+
+## License
+
+ISC

package/dist/entitySearchTypes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Entity search / page-filter types aligned with Port’s entities search API.
+ * Kept structural so published `.d.ts` does not depend on private Port packages.
+ */
+/** One rule in a query; Port uses many discriminated variants—this shape accepts all of them. */
+export type AnyEntitiesQueryRule = Record<string, unknown>;
+export type EntitiesQuery = {
+    combinator: 'and' | 'or';
+    rules: (AnyEntitiesQueryRule | EntitiesQuery)[];
+};
+export type PageQuery = {
+    combinator: 'and';
+    rules: AnyEntitiesQueryRule[];
+    blueprint?: string;
+};
+/** Fields read by `mergePageFilters`; a full Port blueprint satisfies this type. */
+export type Blueprint = {
+    identifier: string;
+    ownership?: unknown;
+};
+//# sourceMappingURL=entitySearchTypes.d.ts.map

package/dist/entitySearchTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitySearchTypes.d.ts","sourceRoot":"","sources":["../src/entitySearchTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iGAAiG;AACjG,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG;IAC3B,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,CAAC,oBAAoB,GAAG,aAAa,CAAC,EAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,UAAU,EAAE,KAAK,CAAC;IAClB,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,SAAS,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC"}

package/dist/entitySearchTypes.js

@@ -0,0 +1,6 @@
+/**
+ * Entity search / page-filter types aligned with Port’s entities search API.
+ * Kept structural so published `.d.ts` does not depend on private Port packages.
+ */
+export {};
+//# sourceMappingURL=entitySearchTypes.js.map

package/dist/entitySearchTypes.js.map

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

package/dist/hostEntity.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `PLUGIN_DATA.entity` shape aligned with Port’s entity API (changelog fields included).
+ */
+export type EntityRelations = Record<string, string | string[] | null>;
+export type EntityScorecard = {
+    rules: {
+        identifier: string;
+        status: 'SUCCESS' | 'FAILURE';
+        level: string;
+        ruleResults: Array<{
+            result: boolean;
+            condition?: unknown;
+        }>;
+    }[];
+    level: string;
+};
+export type Entity = {
+    _id?: string;
+    identifier: string;
+    title?: string;
+    team?: string[];
+    icon?: string;
+    blueprint: string;
+    properties: Record<string, unknown>;
+    relations?: EntityRelations;
+    scorecards?: Record<string, EntityScorecard>;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+//# sourceMappingURL=hostEntity.d.ts.map

package/dist/hostEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostEntity.d.ts","sourceRoot":"","sources":["../src/hostEntity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,KAAK,CAAC;YAClB,MAAM,EAAE,OAAO,CAAC;YAChB,SAAS,CAAC,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;KACH,EAAE,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CAChB,CAAC"}

package/dist/hostEntity.js

@@ -0,0 +1,5 @@
+/**
+ * `PLUGIN_DATA.entity` shape aligned with Port’s entity API (changelog fields included).
+ */
+export {};
+//# sourceMappingURL=hostEntity.js.map

package/dist/hostEntity.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { PluginData, PluginHostPage, PluginHostTheme, PluginUser } from '@port-labs/common-types';
+export type { PluginParamType, PluginParamValue } from '@port-labs/common-types';
+export type { AnyEntitiesQueryRule, Blueprint, EntitiesQuery, PageQuery } from '@port-labs/common-types/apis/port-api';
+export type { Entity, Page, Params, PluginHostState, Theme, User } from './types.js';
+export { DASHBOARD_FILTERS_META_BLUEPRINT, mergePageFilters, mergeWidgetQueryWithPageQuery } from './mergePageFilters.js';
+export { applyThemeCss, getEntity, getPage, getParams, getPortApiBaseUrl, getServerSnapshot, getSnapshot, getTheme, getToken, getUser, initPortPluginMessaging, subscribe, } from './pluginHostMessaging.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,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACvG,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACjF,YAAY,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AACvH,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,gCAAgC,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAC1H,OAAO,EACN,aAAa,EACb,SAAS,EACT,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,uBAAuB,EACvB,SAAS,GACT,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { DASHBOARD_FILTERS_META_BLUEPRINT, mergePageFilters, mergeWidgetQueryWithPageQuery } from './mergePageFilters.js';
+export { applyThemeCss, getEntity, getPage, getParams, getPortApiBaseUrl, getServerSnapshot, getSnapshot, getTheme, getToken, getUser, initPortPluginMessaging, subscribe, } from './pluginHostMessaging.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":"AAIA,OAAO,EAAE,gCAAgC,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAC1H,OAAO,EACN,aAAa,EACb,SAAS,EACT,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,uBAAuB,EACvB,SAAS,GACT,MAAM,0BAA0B,CAAC"}

package/dist/mergePageFilters.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Merges widget entity-search queries with Port page filters passed from the host.
+ * Types match `@port-labs/common-types/apis/port-api` (same contract as the Port frontend helper).
+ */
+import type { Blueprint, EntitiesQuery, PageQuery } from '@port-labs/common-types/apis/port-api';
+export declare const DASHBOARD_FILTERS_META_BLUEPRINT = "dashboard-filters-meta-blueprint";
+/**
+ * Combines `widgetQuery` (the widget’s search body for POST /v1/entities/search) with the
+ * page filters applied on the Port page that hosts the plugin. Those filters usually come from
+ * `PLUGIN_DATA.page.pageFilters` as `pageQuery`. The result AND-combines the widget query with
+ * the relevant page rules so results respect both the widget and the page context. Page rules
+ * are narrowed by blueprint (and dashboard-wide filters); if the blueprint has no `ownership`
+ * field, `$team` rules from the page are dropped.
+ */
+export declare function mergePageFilters(widgetQuery: EntitiesQuery, pageQuery?: PageQuery[], blueprint?: Blueprint): EntitiesQuery;
+export declare const mergeWidgetQueryWithPageQuery: typeof mergePageFilters;
+//# sourceMappingURL=mergePageFilters.d.ts.map

package/dist/mergePageFilters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergePageFilters.d.ts","sourceRoot":"","sources":["../src/mergePageFilters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAEjG,eAAO,MAAM,gCAAgC,qCAAqC,CAAC;AAEnF;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,aAAa,CAyB1H;AAED,eAAO,MAAM,6BAA6B,yBAAmB,CAAC"}

package/dist/mergePageFilters.js

@@ -0,0 +1,32 @@
+export const DASHBOARD_FILTERS_META_BLUEPRINT = 'dashboard-filters-meta-blueprint';
+/**
+ * Combines `widgetQuery` (the widget’s search body for POST /v1/entities/search) with the
+ * page filters applied on the Port page that hosts the plugin. Those filters usually come from
+ * `PLUGIN_DATA.page.pageFilters` as `pageQuery`. The result AND-combines the widget query with
+ * the relevant page rules so results respect both the widget and the page context. Page rules
+ * are narrowed by blueprint (and dashboard-wide filters); if the blueprint has no `ownership`
+ * field, `$team` rules from the page are dropped.
+ */
+export function mergePageFilters(widgetQuery, pageQuery, blueprint) {
+    if (!pageQuery || pageQuery.length === 0)
+        return widgetQuery;
+    const relevantPageQueriesRules = pageQuery
+        .filter((query) => query.blueprint === blueprint?.identifier ||
+        query.blueprint === DASHBOARD_FILTERS_META_BLUEPRINT ||
+        query.blueprint === undefined)
+        .flatMap((query) => query.rules);
+    if (relevantPageQueriesRules.length === 0)
+        return widgetQuery;
+    if (!blueprint || !('ownership' in blueprint)) {
+        return {
+            combinator: 'and',
+            rules: [widgetQuery, ...relevantPageQueriesRules.filter((rule) => !('property' in rule && rule.property === '$team'))],
+        };
+    }
+    return {
+        combinator: 'and',
+        rules: [widgetQuery, ...relevantPageQueriesRules],
+    };
+}
+export const mergeWidgetQueryWithPageQuery = mergePageFilters;
+//# sourceMappingURL=mergePageFilters.js.map

package/dist/mergePageFilters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergePageFilters.js","sourceRoot":"","sources":["../src/mergePageFilters.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,gCAAgC,GAAG,kCAAkC,CAAC;AAEnF;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAA0B,EAAE,SAAuB,EAAE,SAAqB;IAC1G,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAE7D,MAAM,wBAAwB,GAAG,SAAS;SACxC,MAAM,CACN,CAAC,KAAK,EAAE,EAAE,CACT,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,UAAU;QACzC,KAAK,CAAC,SAAS,KAAK,gCAAgC;QACpD,KAAK,CAAC,SAAS,KAAK,SAAS,CAC9B;SACA,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAElC,IAAI,wBAAwB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAE9D,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC,EAAE,CAAC;QAC/C,OAAO;YACN,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,CAAC,WAAW,EAAE,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC;SAC9F,CAAC;IAC3B,CAAC;IAED,OAAO;QACN,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,CAAC,WAAW,EAAE,GAAG,wBAAwB,CAAC;KACzB,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,MAAM,6BAA6B,GAAG,gBAAgB,CAAC"}

package/dist/pluginHostMessaging.d.ts

@@ -0,0 +1,24 @@
+import type { Entity, Page, Params, PluginHostState, Theme, User } from './types.js';
+/**
+ * Ensures a single `window` message listener is registered and requests a token from the host
+ * when embedded in an iframe (once per page load). Safe to call multiple times; helps when the
+ * host mounts the plugin twice (e.g. React Strict Mode) without missing the token.
+ */
+export declare function initPortPluginMessaging(): void;
+export declare function subscribe(listener: () => void): () => void;
+export declare function getSnapshot(): PluginHostState;
+export declare function getServerSnapshot(): PluginHostState;
+export declare function getToken(): string | null;
+export declare function getUser(): User | undefined;
+export declare function getEntity(): Entity | undefined;
+export declare function getPage(): Page | undefined;
+export declare function getParams(): Params;
+export declare function getPortApiBaseUrl(): string | null;
+export declare function getTheme(): Theme | undefined;
+/**
+ * Injects or updates a `<style id="port-plugin-theme">` in `document.head` using the latest
+ * `theme.css` from the host. Removes that element when there is no theme or no `css`. No-op on
+ * the server.
+ */
+export declare function applyThemeCss(): void;
+//# sourceMappingURL=pluginHostMessaging.d.ts.map

package/dist/pluginHostMessaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginHostMessaging.d.ts","sourceRoot":"","sources":["../src/pluginHostMessaging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AA2DrF;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAW9C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAM1D;AAED,wBAAgB,WAAW,IAAI,eAAe,CAG7C;AAID,wBAAgB,iBAAiB,IAAI,eAAe,CAEnD;AAED,wBAAgB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAGxC;AAED,wBAAgB,OAAO,IAAI,IAAI,GAAG,SAAS,CAG1C;AAED,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAG9C;AAED,wBAAgB,OAAO,IAAI,IAAI,GAAG,SAAS,CAG1C;AAED,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAGjD;AAED,wBAAgB,QAAQ,IAAI,KAAK,GAAG,SAAS,CAG5C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAiBpC"}

package/dist/pluginHostMessaging.js

@@ -0,0 +1,132 @@
+const THEME_STYLE_ELEMENT_ID = 'port-plugin-theme';
+const initialState = {
+    params: {},
+    page: undefined,
+    user: undefined,
+    entity: undefined,
+    theme: undefined,
+    token: null,
+    portApiBaseUrl: null,
+};
+function parseTheme(value) {
+    if (value === null || typeof value !== 'object') {
+        return undefined;
+    }
+    const record = value;
+    if (typeof record.mode !== 'string' || typeof record.css !== 'string') {
+        return undefined;
+    }
+    return { mode: record.mode, css: record.css };
+}
+let state = initialState;
+const listeners = new Set();
+let listening = false;
+let requestedPortToken = false;
+function notify() {
+    for (const listener of listeners) {
+        listener();
+    }
+}
+function setState(partial) {
+    state = { ...state, ...partial };
+    notify();
+}
+function onMessage(event) {
+    if (event.data?.type === 'PORT_TOKEN') {
+        setState({ token: event.data.token ?? null });
+        return;
+    }
+    if (event.data?.type === 'PLUGIN_DATA') {
+        setState({
+            params: (event.data.params ?? {}),
+            page: (event.data.page ?? {}),
+            user: (event.data.user ?? undefined),
+            entity: (event.data.entity ?? undefined),
+            theme: parseTheme(event.data.theme),
+            portApiBaseUrl: event.data.baseUrl ?? null,
+        });
+    }
+}
+/**
+ * Ensures a single `window` message listener is registered and requests a token from the host
+ * when embedded in an iframe (once per page load). Safe to call multiple times; helps when the
+ * host mounts the plugin twice (e.g. React Strict Mode) without missing the token.
+ */
+export function initPortPluginMessaging() {
+    if (typeof window === 'undefined' || listening) {
+        return;
+    }
+    listening = true;
+    window.addEventListener('message', onMessage);
+    if (window.parent !== window && !requestedPortToken) {
+        requestedPortToken = true;
+        window.parent.postMessage({ type: 'REQUEST_PORT_TOKEN' }, '*');
+    }
+}
+export function subscribe(listener) {
+    initPortPluginMessaging();
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+export function getSnapshot() {
+    initPortPluginMessaging();
+    return state;
+}
+const serverSnapshot = { ...initialState };
+export function getServerSnapshot() {
+    return serverSnapshot;
+}
+export function getToken() {
+    initPortPluginMessaging();
+    return state.token;
+}
+export function getUser() {
+    initPortPluginMessaging();
+    return state.user;
+}
+export function getEntity() {
+    initPortPluginMessaging();
+    return state.entity;
+}
+export function getPage() {
+    initPortPluginMessaging();
+    return state.page;
+}
+export function getParams() {
+    initPortPluginMessaging();
+    return state.params;
+}
+export function getPortApiBaseUrl() {
+    initPortPluginMessaging();
+    return state.portApiBaseUrl;
+}
+export function getTheme() {
+    initPortPluginMessaging();
+    return state.theme;
+}
+/**
+ * Injects or updates a `<style id="port-plugin-theme">` in `document.head` using the latest
+ * `theme.css` from the host. Removes that element when there is no theme or no `css`. No-op on
+ * the server.
+ */
+export function applyThemeCss() {
+    initPortPluginMessaging();
+    if (typeof document === 'undefined') {
+        return;
+    }
+    const css = state.theme?.css;
+    const existing = document.getElementById(THEME_STYLE_ELEMENT_ID);
+    if (!css) {
+        existing?.remove();
+        return;
+    }
+    const styleEl = existing ?? document.createElement('style');
+    styleEl.id = THEME_STYLE_ELEMENT_ID;
+    styleEl.textContent = css;
+    if (!existing) {
+        document.head.appendChild(styleEl);
+    }
+}
+//# sourceMappingURL=pluginHostMessaging.js.map

package/dist/pluginHostMessaging.js.map

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

package/dist/pluginParams.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Plugin widget parameter typing (same contract as Port’s `PLUGIN_DATA.params`).
+ * Literal union matches `@port-labs/common-consts` `PLUGIN_PARAM_TYPES`.
+ */
+export type PluginParamType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'blueprint';
+export type PluginParamValue = string | number | boolean | unknown[] | Record<string, unknown>;
+/** Values on `PLUGIN_DATA.params`. */
+export type Params = Record<string, {
+    type: PluginParamType;
+    value: PluginParamValue | undefined;
+}>;
+//# sourceMappingURL=pluginParams.d.ts.map

package/dist/pluginParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginParams.d.ts","sourceRoot":"","sources":["../src/pluginParams.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEjG,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/F,sCAAsC;AACtC,MAAM,MAAM,MAAM,GAAG,MAAM,CAC1B,MAAM,EACN;IACC,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACpC,CACD,CAAC"}

package/dist/pluginParams.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pluginParams.js.map

package/dist/pluginParams.js.map

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

package/dist/react/usePortPluginData.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Subscribes to host `postMessage` data (token, PLUGIN_DATA). Uses one shared listener for the
+ * whole app; safe to call from multiple components.
+ */
+export declare function usePortPluginData(): {
+    params: import("@port-labs/common-types").ExtendedCustomWidgetParamValues;
+    page: import("@port-labs/common-types").PluginHostPage | undefined;
+    user: import("@port-labs/common-types").PluginUser | undefined;
+    entity: import("@port-labs/common-types/apis/port-api").Entity | undefined;
+    theme: import("@port-labs/common-types").PluginHostTheme | undefined;
+    portToken: string | null;
+    portApiBaseUrl: string | null;
+    applyThemeCss: () => void;
+};
+//# sourceMappingURL=usePortPluginData.d.ts.map

package/dist/react/usePortPluginData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePortPluginData.d.ts","sourceRoot":"","sources":["../../src/react/usePortPluginData.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,iBAAiB;;;;;;;;;EAgBhC"}

package/dist/react/usePortPluginData.js

@@ -0,0 +1,24 @@
+import { useCallback, useSyncExternalStore } from 'react';
+import { applyThemeCss, getServerSnapshot, getSnapshot, subscribe } from '../pluginHostMessaging.js';
+/**
+ * Subscribes to host `postMessage` data (token, PLUGIN_DATA). Uses one shared listener for the
+ * whole app; safe to call from multiple components.
+ */
+export function usePortPluginData() {
+    const snapshot = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+    const themeCss = snapshot.theme?.css;
+    const applyHostThemeCss = useCallback(() => {
+        applyThemeCss();
+    }, [themeCss]);
+    return {
+        params: snapshot.params,
+        page: snapshot.page,
+        user: snapshot.user,
+        entity: snapshot.entity,
+        theme: snapshot.theme,
+        portToken: snapshot.token,
+        portApiBaseUrl: snapshot.portApiBaseUrl,
+        applyThemeCss: applyHostThemeCss,
+    };
+}
+//# sourceMappingURL=usePortPluginData.js.map

package/dist/react/usePortPluginData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePortPluginData.js","sourceRoot":"","sources":["../../src/react/usePortPluginData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAErG;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAChC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;IACrC,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAG,EAAE;QAC1C,aAAa,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IACf,OAAO;QACN,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,SAAS,EAAE,QAAQ,CAAC,KAAK;QACzB,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,aAAa,EAAE,iBAAiB;KAChC,CAAC;AACH,CAAC"}

package/dist/react.d.ts

@@ -0,0 +1,7 @@
+/**
+ * React integration for `@port-labs/plugins-sdk`.
+ * Requires `react` ≥ 18 as a peer dependency when you import this entry.
+ */
+export type { Entity, Page, Params, PluginHostState, Theme, User } from './types.js';
+export { usePortPluginData } from './react/usePortPluginData.js';
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/react.js

@@ -0,0 +1,2 @@
+export { usePortPluginData } from './react/usePortPluginData.js';
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Host bridge types: canonical definitions live in `@port-labs/common-types` (`src/plugin.ts`).
+ * This module re-exports them under the shorter names used by the SDK API.
+ */
+export type { Entity } from '@port-labs/common-types/apis/port-api';
+export type { PluginHostState, PluginHostPage as Page, PluginHostTheme as Theme, PluginUser as User, } from '@port-labs/common-types';
+export type { ExtendedCustomWidgetParamValues as Params } from '@port-labs/common-types';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AACpE,YAAY,EACX,eAAe,EACf,cAAc,IAAI,IAAI,EACtB,eAAe,IAAI,KAAK,EACxB,UAAU,IAAI,IAAI,GAClB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,+BAA+B,IAAI,MAAM,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+	"name": "@port-labs/plugins-sdk",
+	"packageManager": "yarn@4.12.0",
+	"version": "0.0.1",
+	"description": "Framework-agnostic SDK for Port embedded plugins (postMessage host bridge, page filter merge); optional React helpers under /react",
+	"license": "ISC",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		},
+		"./react": {
+			"types": "./dist/react.d.ts",
+			"default": "./dist/react.js"
+		},
+		"./package.json": "./package.json"
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsc --build tsconfig.json",
+		"lint": "oxlint --type-aware --quiet ./src",
+		"lint:fix": "oxlint --type-aware --fix ./src",
+		"format": "prettier . --check --ignore-path ../../.prettierignore",
+		"format:fix": "prettier . --write --log-level=warn --ignore-path ../../.prettierignore",
+		"test": "echo \"No tests yet\" && exit 0"
+	},
+	"peerDependencies": {
+		"react": ">=18.0.0"
+	},
+	"peerDependenciesMeta": {
+		"react": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@port-labs/common-types": "workspace:*",
+		"@types/react": "^19.0.0",
+		"oxlint": "catalog:lint",
+		"prettier": "^3.4.2",
+		"react": "^19.0.0",
+		"typescript": "^5.8.0"
+	},
+	"engines": {
+		"node": ">=22.0.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}