@iteraai/inspector-protocol 0.1.0

package/README.md

@@ -0,0 +1,137 @@
+# `@iteraai/inspector-protocol`
+
+Protocol constants, message builders, validators, origin helpers, and security event constants for the Itera component inspector SDK.
+
+Use this package anywhere you need to speak the hosted editor protocol without pulling in the React runtime package: host/editor integrations, embedded message handlers, smoke fixtures, and protocol-aware tests.
+
+## Installation
+
+```bash
+npm install @iteraai/inspector-protocol
+```
+
+Before the first npm publish, use the workspace package or a packed tarball. The package name and import paths below are the supported public contract.
+
+## Public Surface
+
+| Import path                              | Purpose                                                                                              |
+| ---------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| `@iteraai/inspector-protocol`            | Root constants, protocol/security event constants, message builders, validators, and origin helpers. |
+| `@iteraai/inspector-protocol/types`      | Message envelope, payload, tree, props, and placeholder types.                                       |
+| `@iteraai/inspector-protocol/errors`     | Protocol error codes and error construction helpers.                                                 |
+| `@iteraai/inspector-protocol/validators` | `buildMessage`, `parseMessage`, and `isInspectorMessage`.                                            |
+| `@iteraai/inspector-protocol/origins`    | Origin normalization and iframe target-origin helpers.                                               |
+
+The root entrypoint also exports the current security event constants used by the React bridge runtime.
+
+## Current Protocol Contract
+
+Protocol constants:
+
+- `INSPECTOR_CHANNEL` is `itera-component-inspector`
+- `INSPECTOR_PROTOCOL_VERSION` is `1`
+- Serializable placeholders use the `__iteraType` discriminator
+
+Host-to-embedded message types:
+
+- `HELLO`
+- `REQUEST_TREE`
+- `REQUEST_NODE_PROPS`
+- `REQUEST_SNAPSHOT`
+- `HIGHLIGHT_NODE`
+- `CLEAR_HIGHLIGHT`
+- `PING`
+
+Embedded-to-host message types:
+
+- `READY`
+- `TREE_SNAPSHOT`
+- `TREE_DELTA`
+- `NODE_PROPS`
+- `SNAPSHOT`
+- `NODE_SELECTED`
+- `PONG`
+- `ERROR`
+
+The branded channel name and placeholder discriminator are preserved intentionally for compatibility with the current `Web` integration.
+
+## Quick Start
+
+```ts
+import {
+  buildMessage,
+  parseMessage,
+  type InspectorMessage,
+} from "@iteraai/inspector-protocol";
+
+const helloMessage: InspectorMessage<"HELLO"> = buildMessage(
+  "HELLO",
+  {
+    capabilities: ["tree", "props", "highlight"],
+    auth: {
+      sessionToken: "signed-session-token",
+      metadata: {
+        expiresAt: Math.floor(Date.now() / 1000) + 300,
+      },
+    },
+  },
+  {
+    requestId: "request-1",
+    sessionId: "session-1",
+  },
+);
+
+const iframe = document.querySelector("iframe");
+
+iframe?.contentWindow?.postMessage(
+  helloMessage,
+  "https://preview.customer-app.example",
+);
+
+window.addEventListener("message", (event) => {
+  const parsed = parseMessage(event.data, {
+    sourceOrigin: event.origin,
+    trustedOrigins: ["https://preview.customer-app.example"],
+  });
+
+  if (!parsed.ok) {
+    return;
+  }
+
+  if (parsed.message.type === "READY") {
+    console.log("Inspector handshake complete.");
+  }
+});
+```
+
+`requestId` and `sessionId` are envelope fields, not payload fields. The embedded bridge echoes them back in responses so the host can correlate request/response pairs.
+
+## Origin Requirements
+
+The protocol package does not decide which origins are trusted for your app, but it gives you the helpers needed to enforce that contract consistently.
+
+- Pass `sourceOrigin` and `trustedOrigins` to `parseMessage` when validating inbound messages from `postMessage`.
+- Trusted origins must match exact URL origins, including scheme and port.
+- Use `normalizeOrigin` when you start from a full URL and need the origin only.
+- Use `deriveTargetOriginFromIframeSrc` and `canHostSendToTargetOrigin` when the host needs to derive or verify the `postMessage` target origin for an iframe.
+
+If origin validation fails, `parseMessage` returns `ERR_INVALID_ORIGIN`.
+
+## Session Token Contract
+
+The protocol shape for secure handshakes is carried in `HELLO.payload.auth`.
+
+- `auth.sessionToken` is the required field used by secure embedded bridge integrations.
+- The current embedded bridge expects that token to be a non-empty string.
+- If `auth.metadata.expiresAt` is present and already expired, secure embedded bridges reject the handshake.
+- `metadata` fields such as `tokenType`, `issuer`, `audience`, `issuedAt`, `expiresAt`, and `nonce` are part of the public protocol shape.
+
+If you only need protocol parsing and message construction, this package does not enforce the token itself. Token validation happens in `@iteraai/react-component-inspector` when bridge security is enabled.
+
+## Placeholder And Error Behavior
+
+Customer-visible placeholder and error details are part of the protocol contract:
+
+- `serializablePlaceholderTypes` includes `redacted`, `dom-node`, `date`, `error`, `map`, `set`, and other non-JSON-native value markers.
+- `inspectorErrorCodes` includes origin, version, authorization, oversize-message, node-not-found, invalid-payload, and unknown-message-type failures.
+- `INSPECTOR_SECURITY_EVENT_NAME_MESSAGE_REJECTED` and related root exports document the current security event naming contract used by the bridge runtime.

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+export declare const inspectorErrorCodes: readonly ["ERR_INVALID_ORIGIN", "ERR_UNSUPPORTED_VERSION", "ERR_UNAUTHORIZED_SESSION", "ERR_SECURITY_POLICY_REJECTED", "ERR_OVERSIZE_MESSAGE", "ERR_NODE_NOT_FOUND", "ERR_INVALID_MESSAGE", "ERR_INVALID_PAYLOAD", "ERR_UNKNOWN_MESSAGE_TYPE"];
+export type InspectorErrorCode = (typeof inspectorErrorCodes)[number];
+export declare const inspectorOversizeRejectionReasons: readonly ["host-inbound-message-too-large", "embedded-inbound-message-too-large"];
+export type InspectorOversizeRejectionReason = (typeof inspectorOversizeRejectionReasons)[number];
+export type InspectorProtocolError = {
+    code: InspectorErrorCode;
+    message: string;
+    details?: string;
+};
+export declare const createInspectorProtocolError: (code: InspectorErrorCode, details?: string) => InspectorProtocolError;

package/dist/errors.js

@@ -0,0 +1,40 @@
+const R = [
+  "ERR_INVALID_ORIGIN",
+  "ERR_UNSUPPORTED_VERSION",
+  "ERR_UNAUTHORIZED_SESSION",
+  "ERR_SECURITY_POLICY_REJECTED",
+  "ERR_OVERSIZE_MESSAGE",
+  "ERR_NODE_NOT_FOUND",
+  "ERR_INVALID_MESSAGE",
+  "ERR_INVALID_PAYLOAD",
+  "ERR_UNKNOWN_MESSAGE_TYPE"
+], t = [
+  "host-inbound-message-too-large",
+  "embedded-inbound-message-too-large"
+], E = {
+  ERR_INVALID_ORIGIN: "Message origin is not trusted.",
+  ERR_UNSUPPORTED_VERSION: "Protocol version is not supported.",
+  ERR_UNAUTHORIZED_SESSION: "Inspector session is not authorized.",
+  ERR_SECURITY_POLICY_REJECTED: "Message was rejected by inspector security policy.",
+  ERR_OVERSIZE_MESSAGE: "Message exceeds the allowed inspector size limit.",
+  ERR_NODE_NOT_FOUND: "Requested node was not found.",
+  ERR_INVALID_MESSAGE: "Message does not match protocol envelope.",
+  ERR_INVALID_PAYLOAD: "Message payload does not match type contract.",
+  ERR_UNKNOWN_MESSAGE_TYPE: "Message type is not recognized by protocol v1."
+}, _ = (e, o) => {
+  const s = E[e];
+  return o === void 0 ? {
+    code: e,
+    message: s
+  } : {
+    code: e,
+    message: `${s} ${o}`,
+    details: o
+  };
+};
+export {
+  _ as createInspectorProtocolError,
+  R as inspectorErrorCodes,
+  t as inspectorOversizeRejectionReasons
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sources":["../src/errors.ts"],"sourcesContent":["export const inspectorErrorCodes = [\n  'ERR_INVALID_ORIGIN',\n  'ERR_UNSUPPORTED_VERSION',\n  'ERR_UNAUTHORIZED_SESSION',\n  'ERR_SECURITY_POLICY_REJECTED',\n  'ERR_OVERSIZE_MESSAGE',\n  'ERR_NODE_NOT_FOUND',\n  'ERR_INVALID_MESSAGE',\n  'ERR_INVALID_PAYLOAD',\n  'ERR_UNKNOWN_MESSAGE_TYPE',\n] as const;\n\nexport type InspectorErrorCode = (typeof inspectorErrorCodes)[number];\n\nexport const inspectorOversizeRejectionReasons = [\n  'host-inbound-message-too-large',\n  'embedded-inbound-message-too-large',\n] as const;\n\nexport type InspectorOversizeRejectionReason =\n  (typeof inspectorOversizeRejectionReasons)[number];\n\nexport type InspectorProtocolError = {\n  code: InspectorErrorCode;\n  message: string;\n  details?: string;\n};\n\nconst inspectorErrorMessages: Record<InspectorErrorCode, string> = {\n  ERR_INVALID_ORIGIN: 'Message origin is not trusted.',\n  ERR_UNSUPPORTED_VERSION: 'Protocol version is not supported.',\n  ERR_UNAUTHORIZED_SESSION: 'Inspector session is not authorized.',\n  ERR_SECURITY_POLICY_REJECTED:\n    'Message was rejected by inspector security policy.',\n  ERR_OVERSIZE_MESSAGE: 'Message exceeds the allowed inspector size limit.',\n  ERR_NODE_NOT_FOUND: 'Requested node was not found.',\n  ERR_INVALID_MESSAGE: 'Message does not match protocol envelope.',\n  ERR_INVALID_PAYLOAD: 'Message payload does not match type contract.',\n  ERR_UNKNOWN_MESSAGE_TYPE: 'Message type is not recognized by protocol v1.',\n};\n\nexport const createInspectorProtocolError = (\n  code: InspectorErrorCode,\n  details?: string,\n): InspectorProtocolError => {\n  const baseMessage = inspectorErrorMessages[code];\n\n  if (details === undefined) {\n    return {\n      code,\n      message: baseMessage,\n    };\n  }\n\n  return {\n    code,\n    message: `${baseMessage} ${details}`,\n    details,\n  };\n};\n"],"names":["inspectorErrorCodes","inspectorOversizeRejectionReasons","inspectorErrorMessages","createInspectorProtocolError","code","details","baseMessage"],"mappings":"AAAO,MAAMA,IAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAIaC,IAAoC;AAAA,EAC/C;AAAA,EACA;AACF,GAWMC,IAA6D;AAAA,EACjE,oBAAoB;AAAA,EACpB,yBAAyB;AAAA,EACzB,0BAA0B;AAAA,EAC1B,8BACE;AAAA,EACF,sBAAsB;AAAA,EACtB,oBAAoB;AAAA,EACpB,qBAAqB;AAAA,EACrB,qBAAqB;AAAA,EACrB,0BAA0B;AAC5B,GAEaC,IAA+B,CAC1CC,GACAC,MAC2B;AAC3B,QAAMC,IAAcJ,EAAuBE,CAAI;AAE/C,SAAIC,MAAY,SACP;AAAA,IACL,MAAAD;AAAA,IACA,SAASE;AAAA,EAAA,IAIN;AAAA,IACL,MAAAF;AAAA,IACA,SAAS,GAAGE,CAAW,IAAID,CAAO;AAAA,IAClC,SAAAA;AAAA,EAAA;AAEJ;"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './errors';
+export * from './origins';
+export * from './securityEvents';
+export * from './types';
+export * from './validators';

package/dist/index.js

@@ -0,0 +1,37 @@
+import { createInspectorProtocolError as c, inspectorErrorCodes as E, inspectorOversizeRejectionReasons as d } from "./errors.js";
+import { canHostSendToTargetOrigin as p, deriveTargetOriginFromIframeSrc as u, isOriginTrusted as R, normalizeOrigin as S } from "./origins.js";
+import { INSPECTOR_CHANNEL as m, INSPECTOR_PROTOCOL_VERSION as O, embeddedToHostMessageTypes as _, hostToEmbeddedMessageTypes as C, serializablePlaceholderTypes as N } from "./types.js";
+import { buildMessage as l, isInspectorMessage as y, parseMessage as z } from "./validators.js";
+const o = 1, e = "itera.inspector.security.message_rejected", s = [
+  e
+], i = [
+  "inbound-message-oversize",
+  "unauthorized-missing-auth",
+  "unauthorized-invalid-token",
+  "unauthorized-expired-token",
+  "security-policy-rejected",
+  "unknown-rejection-reason"
+], n = (r) => "inbound-message-oversize";
+export {
+  m as INSPECTOR_CHANNEL,
+  O as INSPECTOR_PROTOCOL_VERSION,
+  e as INSPECTOR_SECURITY_EVENT_NAME_MESSAGE_REJECTED,
+  o as INSPECTOR_SECURITY_EVENT_SCHEMA_VERSION,
+  l as buildMessage,
+  p as canHostSendToTargetOrigin,
+  c as createInspectorProtocolError,
+  u as deriveTargetOriginFromIframeSrc,
+  _ as embeddedToHostMessageTypes,
+  C as hostToEmbeddedMessageTypes,
+  E as inspectorErrorCodes,
+  d as inspectorOversizeRejectionReasons,
+  s as inspectorSecurityEventNames,
+  i as inspectorSecurityReasonCodes,
+  y as isInspectorMessage,
+  R as isOriginTrusted,
+  n as mapOversizeRejectionReasonToSecurityReasonCode,
+  S as normalizeOrigin,
+  z as parseMessage,
+  N as serializablePlaceholderTypes
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/securityEvents.ts"],"sourcesContent":["import type { InspectorOversizeRejectionReason } from './errors';\n\nexport const INSPECTOR_SECURITY_EVENT_SCHEMA_VERSION = 1 as const;\n\nexport const INSPECTOR_SECURITY_EVENT_NAME_MESSAGE_REJECTED =\n  'itera.inspector.security.message_rejected';\n\nexport const inspectorSecurityEventNames = [\n  INSPECTOR_SECURITY_EVENT_NAME_MESSAGE_REJECTED,\n] as const;\n\nexport type InspectorSecurityEventName =\n  (typeof inspectorSecurityEventNames)[number];\n\nexport const inspectorSecurityReasonCodes = [\n  'inbound-message-oversize',\n  'unauthorized-missing-auth',\n  'unauthorized-invalid-token',\n  'unauthorized-expired-token',\n  'security-policy-rejected',\n  'unknown-rejection-reason',\n] as const;\n\nexport type InspectorSecurityReasonCode =\n  (typeof inspectorSecurityReasonCodes)[number];\n\nexport const mapOversizeRejectionReasonToSecurityReasonCode = (\n  _reason: InspectorOversizeRejectionReason,\n): InspectorSecurityReasonCode => {\n  return 'inbound-message-oversize';\n};\n"],"names":["INSPECTOR_SECURITY_EVENT_SCHEMA_VERSION","INSPECTOR_SECURITY_EVENT_NAME_MESSAGE_REJECTED","inspectorSecurityEventNames","inspectorSecurityReasonCodes","mapOversizeRejectionReasonToSecurityReasonCode","_reason"],"mappings":";;;;AAEO,MAAMA,IAA0C,GAE1CC,IACX,6CAEWC,IAA8B;AAAA,EACzCD;AACF,GAKaE,IAA+B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKaC,IAAiD,CAC5DC,MAEO;"}

package/dist/origins.d.ts

@@ -0,0 +1,4 @@
+export declare const normalizeOrigin: (originOrUrl: string) => string | undefined;
+export declare const deriveTargetOriginFromIframeSrc: (iframeSrc: string) => string | undefined;
+export declare const isOriginTrusted: (origin: string, allowlist: readonly string[]) => boolean;
+export declare const canHostSendToTargetOrigin: (iframeSrc: string, targetOrigin: string) => boolean;

package/dist/origins.js

@@ -0,0 +1,20 @@
+const i = (r) => {
+  try {
+    return new URL(r).origin;
+  } catch {
+    return;
+  }
+}, c = (r) => i(r), o = (r) => i(r), s = (r, e) => {
+  const n = i(r);
+  return n === void 0 ? !1 : e.map((t) => i(t)).filter((t) => t !== void 0).includes(n);
+}, a = (r, e) => {
+  const n = o(r);
+  return n === void 0 ? !1 : n === i(e);
+};
+export {
+  a as canHostSendToTargetOrigin,
+  o as deriveTargetOriginFromIframeSrc,
+  s as isOriginTrusted,
+  c as normalizeOrigin
+};
+//# sourceMappingURL=origins.js.map

package/dist/origins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"origins.js","sources":["../src/origins.ts"],"sourcesContent":["const toOrigin = (rawOrigin: string): string | undefined => {\n  try {\n    return new URL(rawOrigin).origin;\n  } catch {\n    return undefined;\n  }\n};\n\nexport const normalizeOrigin = (originOrUrl: string): string | undefined => {\n  return toOrigin(originOrUrl);\n};\n\nexport const deriveTargetOriginFromIframeSrc = (\n  iframeSrc: string,\n): string | undefined => {\n  return toOrigin(iframeSrc);\n};\n\nexport const isOriginTrusted = (\n  origin: string,\n  allowlist: readonly string[],\n): boolean => {\n  const normalizedOrigin = toOrigin(origin);\n\n  if (normalizedOrigin === undefined) {\n    return false;\n  }\n\n  return allowlist\n    .map((item) => toOrigin(item))\n    .filter((item): item is string => item !== undefined)\n    .includes(normalizedOrigin);\n};\n\nexport const canHostSendToTargetOrigin = (\n  iframeSrc: string,\n  targetOrigin: string,\n): boolean => {\n  const expectedTargetOrigin = deriveTargetOriginFromIframeSrc(iframeSrc);\n\n  if (expectedTargetOrigin === undefined) {\n    return false;\n  }\n\n  return expectedTargetOrigin === toOrigin(targetOrigin);\n};\n"],"names":["toOrigin","rawOrigin","normalizeOrigin","originOrUrl","deriveTargetOriginFromIframeSrc","iframeSrc","isOriginTrusted","origin","allowlist","normalizedOrigin","item","canHostSendToTargetOrigin","targetOrigin","expectedTargetOrigin"],"mappings":"AAAA,MAAMA,IAAW,CAACC,MAA0C;AAC1D,MAAI;AACF,WAAO,IAAI,IAAIA,CAAS,EAAE;AAAA,EAC5B,QAAQ;AACN;AAAA,EACF;AACF,GAEaC,IAAkB,CAACC,MACvBH,EAASG,CAAW,GAGhBC,IAAkC,CAC7CC,MAEOL,EAASK,CAAS,GAGdC,IAAkB,CAC7BC,GACAC,MACY;AACZ,QAAMC,IAAmBT,EAASO,CAAM;AAExC,SAAIE,MAAqB,SAChB,KAGFD,EACJ,IAAI,CAACE,MAASV,EAASU,CAAI,CAAC,EAC5B,OAAO,CAACA,MAAyBA,MAAS,MAAS,EACnD,SAASD,CAAgB;AAC9B,GAEaE,IAA4B,CACvCN,GACAO,MACY;AACZ,QAAMC,IAAuBT,EAAgCC,CAAS;AAEtE,SAAIQ,MAAyB,SACpB,KAGFA,MAAyBb,EAASY,CAAY;AACvD;"}

package/dist/securityEvents.d.ts

@@ -0,0 +1,8 @@
+import { InspectorOversizeRejectionReason } from './errors';
+export declare const INSPECTOR_SECURITY_EVENT_SCHEMA_VERSION: 1;
+export declare const INSPECTOR_SECURITY_EVENT_NAME_MESSAGE_REJECTED = "itera.inspector.security.message_rejected";
+export declare const inspectorSecurityEventNames: readonly ["itera.inspector.security.message_rejected"];
+export type InspectorSecurityEventName = (typeof inspectorSecurityEventNames)[number];
+export declare const inspectorSecurityReasonCodes: readonly ["inbound-message-oversize", "unauthorized-missing-auth", "unauthorized-invalid-token", "unauthorized-expired-token", "security-policy-rejected", "unknown-rejection-reason"];
+export type InspectorSecurityReasonCode = (typeof inspectorSecurityReasonCodes)[number];
+export declare const mapOversizeRejectionReasonToSecurityReasonCode: (_reason: InspectorOversizeRejectionReason) => InspectorSecurityReasonCode;

package/dist/types.d.ts

@@ -0,0 +1,159 @@
+import { InspectorErrorCode } from './errors';
+export declare const INSPECTOR_CHANNEL = "itera-component-inspector";
+export declare const INSPECTOR_PROTOCOL_VERSION = 1;
+export type InspectorChannel = typeof INSPECTOR_CHANNEL;
+export type InspectorProtocolVersion = typeof INSPECTOR_PROTOCOL_VERSION;
+export declare const hostToEmbeddedMessageTypes: readonly ["HELLO", "REQUEST_TREE", "REQUEST_NODE_PROPS", "REQUEST_SNAPSHOT", "HIGHLIGHT_NODE", "CLEAR_HIGHLIGHT", "PING"];
+export type HostToEmbeddedMessageType = (typeof hostToEmbeddedMessageTypes)[number];
+export declare const embeddedToHostMessageTypes: readonly ["READY", "TREE_SNAPSHOT", "TREE_DELTA", "NODE_PROPS", "SNAPSHOT", "NODE_SELECTED", "PONG", "ERROR"];
+export type EmbeddedToHostMessageType = (typeof embeddedToHostMessageTypes)[number];
+export type InspectorMessageType = HostToEmbeddedMessageType | EmbeddedToHostMessageType;
+export type TreeNodeSource = {
+    file: string;
+    line: number;
+    column?: number;
+};
+export type TreeNode = {
+    id: string;
+    displayName: string;
+    parentId: string | null;
+    childrenIds: string[];
+    source?: TreeNodeSource;
+    key?: string;
+    tags?: string[];
+};
+export declare const serializablePlaceholderTypes: readonly ["undefined", "function", "symbol", "bigint", "date", "regexp", "map", "set", "error", "dom-node", "redacted", "unserializable"];
+export type SerializablePlaceholderType = (typeof serializablePlaceholderTypes)[number];
+export type SerializablePlaceholder = {
+    __iteraType: SerializablePlaceholderType;
+    preview?: string;
+};
+export type SerializableScalar = string | number | boolean | null;
+export type SerializableObject = {
+    [key: string]: SerializableValue;
+};
+export type SerializableValue = SerializableScalar | SerializableValue[] | SerializableObject | SerializablePlaceholder;
+export type NodePropsMeta = {
+    truncated?: boolean;
+    droppedKeys?: string[];
+    redactedCount?: number;
+    redactedPaths?: string[];
+};
+export type NodeProps = {
+    nodeId: string;
+    props: Record<string, SerializableValue>;
+    meta: NodePropsMeta;
+};
+export type HelloPayload = {
+    capabilities?: string[];
+    auth?: HelloAuthPayload;
+};
+export type HelloAuthPayload = {
+    sessionToken: string;
+    metadata?: HelloAuthMetadata;
+};
+export type HelloAuthMetadata = {
+    tokenType?: string;
+    issuer?: string;
+    audience?: string | string[];
+    issuedAt?: number;
+    expiresAt?: number;
+    nonce?: string;
+};
+export type RequestTreePayload = {
+    includeSource?: boolean;
+};
+export type RequestNodePropsPayload = {
+    nodeId: string;
+};
+export type RequestSnapshotPayload = {
+    includeTree?: boolean;
+    includeHtml?: boolean;
+};
+export type HighlightNodePayload = {
+    nodeId: string;
+};
+export type PingPayload = {
+    sentAt?: number;
+};
+export type ReadyPayload = {
+    capabilities?: string[];
+};
+export type TreeSnapshotPayload = {
+    nodes: TreeNode[];
+    rootIds: string[];
+    meta?: TreeSnapshotMeta;
+};
+export type TreeSnapshotMeta = {
+    truncated?: boolean;
+    totalNodeCount?: number;
+    includedNodeCount?: number;
+    truncatedNodeCount?: number;
+};
+export type TreeDeltaPayload = {
+    addedNodes: TreeNode[];
+    updatedNodes: TreeNode[];
+    removedNodeIds: string[];
+};
+export type NodeSelectedPayload = {
+    nodeId: string;
+};
+export type SnapshotPayload = {
+    capture: Blob;
+    captureMimeType: string;
+    width: number;
+    height: number;
+    capturedAt: number;
+    treeSnapshot: TreeSnapshotPayload;
+    html?: string;
+    htmlTruncated?: boolean;
+};
+export type PongPayload = {
+    sentAt?: number;
+};
+export type ErrorPayload = {
+    code: InspectorErrorCode;
+    message: string;
+    details?: Record<string, SerializableValue>;
+};
+export type HostToEmbeddedPayloadByType = {
+    HELLO: HelloPayload;
+    REQUEST_TREE: RequestTreePayload;
+    REQUEST_NODE_PROPS: RequestNodePropsPayload;
+    REQUEST_SNAPSHOT: RequestSnapshotPayload;
+    HIGHLIGHT_NODE: HighlightNodePayload;
+    CLEAR_HIGHLIGHT: undefined;
+    PING: PingPayload;
+};
+export type EmbeddedToHostPayloadByType = {
+    READY: ReadyPayload;
+    TREE_SNAPSHOT: TreeSnapshotPayload;
+    TREE_DELTA: TreeDeltaPayload;
+    NODE_PROPS: NodeProps;
+    SNAPSHOT: SnapshotPayload;
+    NODE_SELECTED: NodeSelectedPayload;
+    PONG: PongPayload;
+    ERROR: ErrorPayload;
+};
+export type InspectorPayloadByType = HostToEmbeddedPayloadByType & EmbeddedToHostPayloadByType;
+export type InspectorMessageEnvelope<TType extends InspectorMessageType, TPayload> = {
+    channel: InspectorChannel;
+    version: InspectorProtocolVersion;
+    type: TType;
+    requestId?: string;
+    sessionId?: string;
+} & (TPayload extends undefined ? {
+    payload?: undefined;
+} : {
+    payload: TPayload;
+});
+export type InspectorMessage<TType extends InspectorMessageType> = InspectorMessageEnvelope<TType, InspectorPayloadByType[TType]>;
+export type AnyInspectorMessage = {
+    [Type in InspectorMessageType]: InspectorMessage<Type>;
+}[InspectorMessageType];
+export type HostToEmbeddedMessage = {
+    [Type in HostToEmbeddedMessageType]: InspectorMessage<Type>;
+}[HostToEmbeddedMessageType];
+export type EmbeddedToHostMessage = {
+    [Type in EmbeddedToHostMessageType]: InspectorMessage<Type>;
+}[EmbeddedToHostMessageType];

package/dist/types.js

@@ -0,0 +1,39 @@
+const e = "itera-component-inspector", E = 1, T = [
+  "HELLO",
+  "REQUEST_TREE",
+  "REQUEST_NODE_PROPS",
+  "REQUEST_SNAPSHOT",
+  "HIGHLIGHT_NODE",
+  "CLEAR_HIGHLIGHT",
+  "PING"
+], o = [
+  "READY",
+  "TREE_SNAPSHOT",
+  "TREE_DELTA",
+  "NODE_PROPS",
+  "SNAPSHOT",
+  "NODE_SELECTED",
+  "PONG",
+  "ERROR"
+], s = [
+  "undefined",
+  "function",
+  "symbol",
+  "bigint",
+  "date",
+  "regexp",
+  "map",
+  "set",
+  "error",
+  "dom-node",
+  "redacted",
+  "unserializable"
+];
+export {
+  e as INSPECTOR_CHANNEL,
+  E as INSPECTOR_PROTOCOL_VERSION,
+  o as embeddedToHostMessageTypes,
+  T as hostToEmbeddedMessageTypes,
+  s as serializablePlaceholderTypes
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../src/types.ts"],"sourcesContent":["import type { InspectorErrorCode } from './errors';\n\nexport const INSPECTOR_CHANNEL = 'itera-component-inspector';\nexport const INSPECTOR_PROTOCOL_VERSION = 1;\n\nexport type InspectorChannel = typeof INSPECTOR_CHANNEL;\nexport type InspectorProtocolVersion = typeof INSPECTOR_PROTOCOL_VERSION;\n\nexport const hostToEmbeddedMessageTypes = [\n  'HELLO',\n  'REQUEST_TREE',\n  'REQUEST_NODE_PROPS',\n  'REQUEST_SNAPSHOT',\n  'HIGHLIGHT_NODE',\n  'CLEAR_HIGHLIGHT',\n  'PING',\n] as const;\n\nexport type HostToEmbeddedMessageType =\n  (typeof hostToEmbeddedMessageTypes)[number];\n\nexport const embeddedToHostMessageTypes = [\n  'READY',\n  'TREE_SNAPSHOT',\n  'TREE_DELTA',\n  'NODE_PROPS',\n  'SNAPSHOT',\n  'NODE_SELECTED',\n  'PONG',\n  'ERROR',\n] as const;\n\nexport type EmbeddedToHostMessageType =\n  (typeof embeddedToHostMessageTypes)[number];\n\nexport type InspectorMessageType =\n  | HostToEmbeddedMessageType\n  | EmbeddedToHostMessageType;\n\nexport type TreeNodeSource = {\n  file: string;\n  line: number;\n  column?: number;\n};\n\nexport type TreeNode = {\n  id: string;\n  displayName: string;\n  parentId: string | null;\n  childrenIds: string[];\n  source?: TreeNodeSource;\n  key?: string;\n  tags?: string[];\n};\n\nexport const serializablePlaceholderTypes = [\n  'undefined',\n  'function',\n  'symbol',\n  'bigint',\n  'date',\n  'regexp',\n  'map',\n  'set',\n  'error',\n  'dom-node',\n  'redacted',\n  'unserializable',\n] as const;\n\nexport type SerializablePlaceholderType =\n  (typeof serializablePlaceholderTypes)[number];\n\nexport type SerializablePlaceholder = {\n  __iteraType: SerializablePlaceholderType;\n  preview?: string;\n};\n\nexport type SerializableScalar = string | number | boolean | null;\n\nexport type SerializableObject = {\n  [key: string]: SerializableValue;\n};\n\nexport type SerializableValue =\n  | SerializableScalar\n  | SerializableValue[]\n  | SerializableObject\n  | SerializablePlaceholder;\n\nexport type NodePropsMeta = {\n  truncated?: boolean;\n  droppedKeys?: string[];\n  redactedCount?: number;\n  redactedPaths?: string[];\n};\n\nexport type NodeProps = {\n  nodeId: string;\n  props: Record<string, SerializableValue>;\n  meta: NodePropsMeta;\n};\n\nexport type HelloPayload = {\n  capabilities?: string[];\n  auth?: HelloAuthPayload;\n};\n\nexport type HelloAuthPayload = {\n  sessionToken: string;\n  metadata?: HelloAuthMetadata;\n};\n\nexport type HelloAuthMetadata = {\n  tokenType?: string;\n  issuer?: string;\n  audience?: string | string[];\n  issuedAt?: number;\n  expiresAt?: number;\n  nonce?: string;\n};\n\nexport type RequestTreePayload = {\n  includeSource?: boolean;\n};\n\nexport type RequestNodePropsPayload = {\n  nodeId: string;\n};\n\nexport type RequestSnapshotPayload = {\n  includeTree?: boolean;\n  includeHtml?: boolean;\n};\n\nexport type HighlightNodePayload = {\n  nodeId: string;\n};\n\nexport type PingPayload = {\n  sentAt?: number;\n};\n\nexport type ReadyPayload = {\n  capabilities?: string[];\n};\n\nexport type TreeSnapshotPayload = {\n  nodes: TreeNode[];\n  rootIds: string[];\n  meta?: TreeSnapshotMeta;\n};\n\nexport type TreeSnapshotMeta = {\n  truncated?: boolean;\n  totalNodeCount?: number;\n  includedNodeCount?: number;\n  truncatedNodeCount?: number;\n};\n\nexport type TreeDeltaPayload = {\n  addedNodes: TreeNode[];\n  updatedNodes: TreeNode[];\n  removedNodeIds: string[];\n};\n\nexport type NodeSelectedPayload = {\n  nodeId: string;\n};\n\nexport type SnapshotPayload = {\n  capture: Blob;\n  captureMimeType: string;\n  width: number;\n  height: number;\n  capturedAt: number;\n  treeSnapshot: TreeSnapshotPayload;\n  html?: string;\n  htmlTruncated?: boolean;\n};\n\nexport type PongPayload = {\n  sentAt?: number;\n};\n\nexport type ErrorPayload = {\n  code: InspectorErrorCode;\n  message: string;\n  details?: Record<string, SerializableValue>;\n};\n\nexport type HostToEmbeddedPayloadByType = {\n  HELLO: HelloPayload;\n  REQUEST_TREE: RequestTreePayload;\n  REQUEST_NODE_PROPS: RequestNodePropsPayload;\n  REQUEST_SNAPSHOT: RequestSnapshotPayload;\n  HIGHLIGHT_NODE: HighlightNodePayload;\n  CLEAR_HIGHLIGHT: undefined;\n  PING: PingPayload;\n};\n\nexport type EmbeddedToHostPayloadByType = {\n  READY: ReadyPayload;\n  TREE_SNAPSHOT: TreeSnapshotPayload;\n  TREE_DELTA: TreeDeltaPayload;\n  NODE_PROPS: NodeProps;\n  SNAPSHOT: SnapshotPayload;\n  NODE_SELECTED: NodeSelectedPayload;\n  PONG: PongPayload;\n  ERROR: ErrorPayload;\n};\n\nexport type InspectorPayloadByType =\n  HostToEmbeddedPayloadByType & EmbeddedToHostPayloadByType;\n\nexport type InspectorMessageEnvelope<\n  TType extends InspectorMessageType,\n  TPayload,\n> = {\n  channel: InspectorChannel;\n  version: InspectorProtocolVersion;\n  type: TType;\n  requestId?: string;\n  sessionId?: string;\n} & (TPayload extends undefined ? { payload?: undefined } : { payload: TPayload });\n\nexport type InspectorMessage<TType extends InspectorMessageType> =\n  InspectorMessageEnvelope<TType, InspectorPayloadByType[TType]>;\n\nexport type AnyInspectorMessage = {\n  [Type in InspectorMessageType]: InspectorMessage<Type>;\n}[InspectorMessageType];\n\nexport type HostToEmbeddedMessage = {\n  [Type in HostToEmbeddedMessageType]: InspectorMessage<Type>;\n}[HostToEmbeddedMessageType];\n\nexport type EmbeddedToHostMessage = {\n  [Type in EmbeddedToHostMessageType]: InspectorMessage<Type>;\n}[EmbeddedToHostMessageType];\n"],"names":["INSPECTOR_CHANNEL","INSPECTOR_PROTOCOL_VERSION","hostToEmbeddedMessageTypes","embeddedToHostMessageTypes","serializablePlaceholderTypes"],"mappings":"AAEO,MAAMA,IAAoB,6BACpBC,IAA6B,GAK7BC,IAA6B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKaC,IAA6B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAyBaC,IAA+B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;"}

package/dist/validators.d.ts

@@ -0,0 +1,22 @@
+import { InspectorProtocolError } from './errors';
+import { AnyInspectorMessage, InspectorMessage, InspectorMessageType, InspectorPayloadByType } from './types';
+export type BuildMessageOptions = {
+    requestId?: string;
+    sessionId?: string;
+};
+export type ParseMessageOptions = {
+    sourceOrigin?: string;
+    trustedOrigins?: readonly string[];
+    expectedOrigin?: string;
+    supportedVersion?: number;
+};
+export type ParseMessageResult = {
+    ok: true;
+    message: AnyInspectorMessage;
+} | {
+    ok: false;
+    error: InspectorProtocolError;
+};
+export declare const buildMessage: <Type extends InspectorMessageType>(type: Type, payload: InspectorPayloadByType[Type], options?: BuildMessageOptions) => InspectorMessage<Type>;
+export declare const parseMessage: (raw: unknown, options?: ParseMessageOptions) => ParseMessageResult;
+export declare const isInspectorMessage: (raw: unknown) => raw is AnyInspectorMessage;

package/dist/validators.js

@@ -0,0 +1,188 @@
+import { createInspectorProtocolError as n, inspectorErrorCodes as a } from "./errors.js";
+import { normalizeOrigin as I, isOriginTrusted as p } from "./origins.js";
+import { INSPECTOR_PROTOCOL_VERSION as A, INSPECTOR_CHANNEL as R, hostToEmbeddedMessageTypes as b, embeddedToHostMessageTypes as O, serializablePlaceholderTypes as S } from "./types.js";
+const _ = /* @__PURE__ */ new Set([
+  ...b,
+  ...O
+]), i = (e) => typeof e == "object" && e !== null && !Array.isArray(e), s = (e) => Array.isArray(e) && e.every((r) => typeof r == "string"), y = (e) => typeof e == "string" || s(e), d = (e) => typeof e == "number" && Number.isInteger(e) && e >= 0, m = (e) => typeof e == "number" && Number.isInteger(e) && e > 0, T = (e) => typeof e == "number" && Number.isFinite(e), h = (e) => !(!i(e) || e.tokenType !== void 0 && typeof e.tokenType != "string" || e.issuer !== void 0 && typeof e.issuer != "string" || e.audience !== void 0 && !y(e.audience) || e.issuedAt !== void 0 && typeof e.issuedAt != "number" || e.expiresAt !== void 0 && typeof e.expiresAt != "number" || e.nonce !== void 0 && typeof e.nonce != "string"), P = (e) => !(!i(e) || typeof e.sessionToken != "string" || e.metadata !== void 0 && !h(e.metadata)), L = (e) => !(typeof e.__iteraType != "string" || !S.includes(
+  e.__iteraType
+) || e.preview !== void 0 && typeof e.preview != "string"), u = (e, r = 0) => r > 12 ? !1 : e === null || ["string", "number", "boolean"].includes(typeof e) ? !0 : Array.isArray(e) ? e.every((t) => u(t, r + 1)) : i(e) ? L(e) ? !0 : Object.values(e).every(
+  (t) => u(t, r + 1)
+) : !1, c = (e) => !(!i(e) || typeof e.id != "string" || typeof e.displayName != "string" || !Array.isArray(e.childrenIds) || !e.childrenIds.every((r) => typeof r == "string") || e.parentId !== null && typeof e.parentId != "string" || e.source !== void 0 && (!i(e.source) || typeof e.source.file != "string" || typeof e.source.line != "number" || e.source.column !== void 0 && typeof e.source.column != "number") || e.key !== void 0 && typeof e.key != "string" || e.tags !== void 0 && !s(e.tags)), D = (e) => !(!i(e) || typeof e.nodeId != "string" || !i(e.props) || !Object.values(e.props).every((r) => u(r)) || !i(e.meta) || e.meta.truncated !== void 0 && typeof e.meta.truncated != "boolean" || e.meta.droppedKeys !== void 0 && !s(e.meta.droppedKeys) || e.meta.redactedCount !== void 0 && !d(e.meta.redactedCount) || e.meta.redactedPaths !== void 0 && !s(e.meta.redactedPaths)), M = (e) => !(!i(e) || e.truncated !== void 0 && typeof e.truncated != "boolean" || e.totalNodeCount !== void 0 && !d(e.totalNodeCount) || e.includedNodeCount !== void 0 && !d(e.includedNodeCount) || e.truncatedNodeCount !== void 0 && !d(e.truncatedNodeCount)), N = (e) => i(e) && Array.isArray(e.nodes) && e.nodes.every((r) => c(r)) && s(e.rootIds) && (e.meta === void 0 || M(e.meta)), G = (e) => typeof Blob < "u" && e instanceof Blob, H = (e) => e === "CLEAR_HIGHLIGHT", k = (e, r) => {
+  switch (e) {
+    case "HELLO":
+      return r === void 0 ? !0 : i(r) && (r.capabilities === void 0 || s(r.capabilities)) && (r.auth === void 0 || P(r.auth));
+    case "READY":
+      return r === void 0 ? !0 : i(r) && (r.capabilities === void 0 || s(r.capabilities));
+    case "REQUEST_TREE":
+      return r === void 0 ? !0 : i(r) && (r.includeSource === void 0 || typeof r.includeSource == "boolean");
+    case "REQUEST_SNAPSHOT":
+      return r === void 0 ? !0 : i(r) && (r.includeTree === void 0 || typeof r.includeTree == "boolean") && (r.includeHtml === void 0 || typeof r.includeHtml == "boolean");
+    case "REQUEST_NODE_PROPS":
+    case "HIGHLIGHT_NODE":
+    case "NODE_SELECTED":
+      return i(r) && typeof r.nodeId == "string";
+    case "CLEAR_HIGHLIGHT":
+      return r === void 0;
+    case "PING":
+    case "PONG":
+      return r === void 0 ? !0 : i(r) && (r.sentAt === void 0 || typeof r.sentAt == "number");
+    case "TREE_SNAPSHOT":
+      return N(r);
+    case "TREE_DELTA":
+      return i(r) && Array.isArray(r.addedNodes) && r.addedNodes.every((t) => c(t)) && Array.isArray(r.updatedNodes) && r.updatedNodes.every((t) => c(t)) && s(r.removedNodeIds);
+    case "NODE_PROPS":
+      return D(r);
+    case "SNAPSHOT":
+      return i(r) && G(r.capture) && typeof r.captureMimeType == "string" && m(r.width) && m(r.height) && T(r.capturedAt) && r.capturedAt >= 0 && N(r.treeSnapshot) && (r.html === void 0 || typeof r.html == "string") && (r.htmlTruncated === void 0 || typeof r.htmlTruncated == "boolean");
+    case "ERROR":
+      return i(r) && typeof r.code == "string" && a.includes(r.code) && typeof r.message == "string" && (r.details === void 0 || i(r.details) && Object.values(r.details).every(
+        (t) => u(t)
+      ));
+  }
+}, V = (e) => {
+  if (typeof e == "string")
+    try {
+      const r = JSON.parse(e);
+      return i(r) ? r : void 0;
+    } catch {
+      return;
+    }
+  if (i(e))
+    return e;
+}, l = (e) => {
+  if (e.sourceOrigin === void 0)
+    return;
+  const r = I(e.sourceOrigin);
+  if (r === void 0)
+    return n(
+      "ERR_INVALID_ORIGIN",
+      `Source origin ${e.sourceOrigin} is not a valid URL origin.`
+    );
+  if (e.expectedOrigin !== void 0) {
+    const t = I(e.expectedOrigin);
+    if (t === void 0)
+      return n(
+        "ERR_INVALID_ORIGIN",
+        `Expected origin ${e.expectedOrigin} is not a valid URL origin.`
+      );
+    if (r !== t)
+      return n(
+        "ERR_INVALID_ORIGIN",
+        `Expected ${t} but received ${r}.`
+      );
+  }
+  if (e.trustedOrigins !== void 0 && !p(r, e.trustedOrigins))
+    return n(
+      "ERR_INVALID_ORIGIN",
+      `Origin ${r} is not in host allowlist.`
+    );
+}, U = (e, r, t = {}) => {
+  const o = {
+    channel: R,
+    version: A,
+    type: e,
+    requestId: t.requestId,
+    sessionId: t.sessionId
+  };
+  return r === void 0 ? o : {
+    ...o,
+    payload: r
+  };
+}, C = (e, r = {}) => {
+  const t = V(e);
+  if (t === void 0)
+    return {
+      ok: !1,
+      error: n(
+        "ERR_INVALID_MESSAGE",
+        "Incoming message must be an object or JSON string object."
+      )
+    };
+  const o = l(r);
+  if (o !== void 0)
+    return {
+      ok: !1,
+      error: o
+    };
+  if (t.channel !== R)
+    return {
+      ok: !1,
+      error: n(
+        "ERR_INVALID_MESSAGE",
+        `Invalid channel ${String(t.channel)}.`
+      )
+    };
+  if (typeof t.version != "number")
+    return {
+      ok: !1,
+      error: n(
+        "ERR_INVALID_MESSAGE",
+        "Message version must be a number."
+      )
+    };
+  const g = r.supportedVersion ?? A;
+  if (t.version !== g)
+    return {
+      ok: !1,
+      error: n(
+        "ERR_UNSUPPORTED_VERSION",
+        `Expected version ${g} but received ${t.version}.`
+      )
+    };
+  if (typeof t.type != "string")
+    return {
+      ok: !1,
+      error: n(
+        "ERR_INVALID_MESSAGE",
+        "Message type must be a string."
+      )
+    };
+  if (!_.has(t.type))
+    return {
+      ok: !1,
+      error: n(
+        "ERR_UNKNOWN_MESSAGE_TYPE",
+        `Message type ${t.type} is not part of protocol v1.`
+      )
+    };
+  if (t.requestId !== void 0 && typeof t.requestId != "string")
+    return {
+      ok: !1,
+      error: n(
+        "ERR_INVALID_MESSAGE",
+        "requestId must be a string when provided."
+      )
+    };
+  if (t.sessionId !== void 0 && typeof t.sessionId != "string")
+    return {
+      ok: !1,
+      error: n(
+        "ERR_INVALID_MESSAGE",
+        "sessionId must be a string when provided."
+      )
+    };
+  const f = t.type, E = t.payload;
+  return H(f) && E !== void 0 ? {
+    ok: !1,
+    error: n(
+      "ERR_INVALID_PAYLOAD",
+      `${f} does not accept a payload.`
+    )
+  } : k(f, E) ? {
+    ok: !0,
+    message: t
+  } : {
+    ok: !1,
+    error: n(
+      "ERR_INVALID_PAYLOAD",
+      `Payload does not satisfy ${f} contract.`
+    )
+  };
+}, j = (e) => C(e).ok;
+export {
+  U as buildMessage,
+  j as isInspectorMessage,
+  C as parseMessage
+};
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sources":["../src/validators.ts"],"sourcesContent":["import {\n  createInspectorProtocolError,\n  type InspectorProtocolError,\n  inspectorErrorCodes,\n} from './errors';\nimport { isOriginTrusted, normalizeOrigin } from './origins';\nimport {\n  embeddedToHostMessageTypes,\n  hostToEmbeddedMessageTypes,\n  INSPECTOR_CHANNEL,\n  INSPECTOR_PROTOCOL_VERSION,\n  serializablePlaceholderTypes,\n  type AnyInspectorMessage,\n  type InspectorMessage,\n  type InspectorMessageType,\n  type InspectorPayloadByType,\n  type HelloAuthPayload,\n  type NodeProps,\n  type SerializablePlaceholder,\n  type SerializableValue,\n  type TreeNode,\n} from './types';\n\ntype RawMessage = Record<string, unknown>;\n\nexport type BuildMessageOptions = {\n  requestId?: string;\n  sessionId?: string;\n};\n\nexport type ParseMessageOptions = {\n  sourceOrigin?: string;\n  trustedOrigins?: readonly string[];\n  expectedOrigin?: string;\n  supportedVersion?: number;\n};\n\nexport type ParseMessageResult =\n  | {\n      ok: true;\n      message: AnyInspectorMessage;\n    }\n  | {\n      ok: false;\n      error: InspectorProtocolError;\n    };\n\nconst validMessageTypes = new Set<string>([\n  ...hostToEmbeddedMessageTypes,\n  ...embeddedToHostMessageTypes,\n]);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n};\n\nconst isStringArray = (value: unknown): value is string[] => {\n  return Array.isArray(value) && value.every((item) => typeof item === 'string');\n};\n\nconst isStringOrStringArray = (\n  value: unknown,\n): value is string | string[] => {\n  return typeof value === 'string' || isStringArray(value);\n};\n\nconst isNonNegativeInteger = (value: unknown): value is number => {\n  return typeof value === 'number' && Number.isInteger(value) && value >= 0;\n};\n\nconst isPositiveInteger = (value: unknown): value is number => {\n  return typeof value === 'number' && Number.isInteger(value) && value > 0;\n};\n\nconst isFiniteNumber = (value: unknown): value is number => {\n  return typeof value === 'number' && Number.isFinite(value);\n};\n\nconst isHelloAuthMetadata = (value: unknown): boolean => {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  if (\n    value.tokenType !== undefined &&\n    typeof value.tokenType !== 'string'\n  ) {\n    return false;\n  }\n\n  if (\n    value.issuer !== undefined &&\n    typeof value.issuer !== 'string'\n  ) {\n    return false;\n  }\n\n  if (\n    value.audience !== undefined &&\n    !isStringOrStringArray(value.audience)\n  ) {\n    return false;\n  }\n\n  if (\n    value.issuedAt !== undefined &&\n    typeof value.issuedAt !== 'number'\n  ) {\n    return false;\n  }\n\n  if (\n    value.expiresAt !== undefined &&\n    typeof value.expiresAt !== 'number'\n  ) {\n    return false;\n  }\n\n  if (\n    value.nonce !== undefined &&\n    typeof value.nonce !== 'string'\n  ) {\n    return false;\n  }\n\n  return true;\n};\n\nconst isHelloAuthPayload = (value: unknown): value is HelloAuthPayload => {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  if (typeof value.sessionToken !== 'string') {\n    return false;\n  }\n\n  if (\n    value.metadata !== undefined &&\n    !isHelloAuthMetadata(value.metadata)\n  ) {\n    return false;\n  }\n\n  return true;\n};\n\nconst isSerializablePlaceholder = (\n  value: Record<string, unknown>,\n): value is SerializablePlaceholder => {\n  if (typeof value.__iteraType !== 'string') {\n    return false;\n  }\n\n  if (\n    !(serializablePlaceholderTypes as readonly string[]).includes(\n      value.__iteraType,\n    )\n  ) {\n    return false;\n  }\n\n  if (\n    value.preview !== undefined &&\n    typeof value.preview !== 'string'\n  ) {\n    return false;\n  }\n\n  return true;\n};\n\nconst isSerializableValue = (\n  value: unknown,\n  depth = 0,\n): value is SerializableValue => {\n  if (depth > 12) {\n    return false;\n  }\n\n  if (value === null) {\n    return true;\n  }\n\n  if (['string', 'number', 'boolean'].includes(typeof value)) {\n    return true;\n  }\n\n  if (Array.isArray(value)) {\n    return value.every((entry) => isSerializableValue(entry, depth + 1));\n  }\n\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  if (isSerializablePlaceholder(value)) {\n    return true;\n  }\n\n  return Object.values(value).every((entry) =>\n    isSerializableValue(entry, depth + 1),\n  );\n};\n\nconst isTreeNode = (value: unknown): value is TreeNode => {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  if (\n    typeof value.id !== 'string' ||\n    typeof value.displayName !== 'string' ||\n    !Array.isArray(value.childrenIds) ||\n    !value.childrenIds.every((item) => typeof item === 'string')\n  ) {\n    return false;\n  }\n\n  if (value.parentId !== null && typeof value.parentId !== 'string') {\n    return false;\n  }\n\n  if (value.source !== undefined) {\n    if (!isRecord(value.source)) {\n      return false;\n    }\n\n    if (\n      typeof value.source.file !== 'string' ||\n      typeof value.source.line !== 'number'\n    ) {\n      return false;\n    }\n\n    if (\n      value.source.column !== undefined &&\n      typeof value.source.column !== 'number'\n    ) {\n      return false;\n    }\n  }\n\n  if (value.key !== undefined && typeof value.key !== 'string') {\n    return false;\n  }\n\n  if (value.tags !== undefined && !isStringArray(value.tags)) {\n    return false;\n  }\n\n  return true;\n};\n\nconst isNodeProps = (value: unknown): value is NodeProps => {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  if (typeof value.nodeId !== 'string') {\n    return false;\n  }\n\n  if (!isRecord(value.props)) {\n    return false;\n  }\n\n  if (!Object.values(value.props).every((entry) => isSerializableValue(entry))) {\n    return false;\n  }\n\n  if (!isRecord(value.meta)) {\n    return false;\n  }\n\n  if (\n    value.meta.truncated !== undefined &&\n    typeof value.meta.truncated !== 'boolean'\n  ) {\n    return false;\n  }\n\n  if (value.meta.droppedKeys !== undefined && !isStringArray(value.meta.droppedKeys)) {\n    return false;\n  }\n\n  if (\n    value.meta.redactedCount !== undefined &&\n    !isNonNegativeInteger(value.meta.redactedCount)\n  ) {\n    return false;\n  }\n\n  if (\n    value.meta.redactedPaths !== undefined &&\n    !isStringArray(value.meta.redactedPaths)\n  ) {\n    return false;\n  }\n\n  return true;\n};\n\nconst isTreeSnapshotMeta = (value: unknown): boolean => {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  if (\n    value.truncated !== undefined &&\n    typeof value.truncated !== 'boolean'\n  ) {\n    return false;\n  }\n\n  if (\n    value.totalNodeCount !== undefined &&\n    !isNonNegativeInteger(value.totalNodeCount)\n  ) {\n    return false;\n  }\n\n  if (\n    value.includedNodeCount !== undefined &&\n    !isNonNegativeInteger(value.includedNodeCount)\n  ) {\n    return false;\n  }\n\n  if (\n    value.truncatedNodeCount !== undefined &&\n    !isNonNegativeInteger(value.truncatedNodeCount)\n  ) {\n    return false;\n  }\n\n  return true;\n};\n\nconst isTreeSnapshotPayload = (value: unknown): boolean => {\n  return (\n    isRecord(value) &&\n    Array.isArray(value.nodes) &&\n    value.nodes.every((node) => isTreeNode(node)) &&\n    isStringArray(value.rootIds) &&\n    (value.meta === undefined || isTreeSnapshotMeta(value.meta))\n  );\n};\n\nconst isBlobValue = (value: unknown): value is Blob => {\n  return typeof Blob !== 'undefined' && value instanceof Blob;\n};\n\nconst expectsNoPayload = (type: InspectorMessageType): boolean => {\n  return type === 'CLEAR_HIGHLIGHT';\n};\n\nconst validatePayloadByType = (\n  type: InspectorMessageType,\n  payload: unknown,\n): boolean => {\n  switch (type) {\n    case 'HELLO': {\n      if (payload === undefined) {\n        return true;\n      }\n\n      return (\n        isRecord(payload) &&\n        (payload.capabilities === undefined ||\n          isStringArray(payload.capabilities)) &&\n        (payload.auth === undefined || isHelloAuthPayload(payload.auth))\n      );\n    }\n\n    case 'READY': {\n      if (payload === undefined) {\n        return true;\n      }\n\n      return isRecord(payload) &&\n        (payload.capabilities === undefined || isStringArray(payload.capabilities));\n    }\n\n    case 'REQUEST_TREE': {\n      if (payload === undefined) {\n        return true;\n      }\n\n      return (\n        isRecord(payload) &&\n        (payload.includeSource === undefined ||\n          typeof payload.includeSource === 'boolean')\n      );\n    }\n\n    case 'REQUEST_SNAPSHOT': {\n      if (payload === undefined) {\n        return true;\n      }\n\n      return (\n        isRecord(payload) &&\n        (payload.includeTree === undefined ||\n          typeof payload.includeTree === 'boolean') &&\n        (payload.includeHtml === undefined ||\n          typeof payload.includeHtml === 'boolean')\n      );\n    }\n\n    case 'REQUEST_NODE_PROPS':\n    case 'HIGHLIGHT_NODE':\n    case 'NODE_SELECTED': {\n      return isRecord(payload) && typeof payload.nodeId === 'string';\n    }\n\n    case 'CLEAR_HIGHLIGHT': {\n      return payload === undefined;\n    }\n\n    case 'PING':\n    case 'PONG': {\n      if (payload === undefined) {\n        return true;\n      }\n\n      return isRecord(payload) &&\n        (payload.sentAt === undefined || typeof payload.sentAt === 'number');\n    }\n\n    case 'TREE_SNAPSHOT': {\n      return isTreeSnapshotPayload(payload);\n    }\n\n    case 'TREE_DELTA': {\n      return (\n        isRecord(payload) &&\n        Array.isArray(payload.addedNodes) &&\n        payload.addedNodes.every((node) => isTreeNode(node)) &&\n        Array.isArray(payload.updatedNodes) &&\n        payload.updatedNodes.every((node) => isTreeNode(node)) &&\n        isStringArray(payload.removedNodeIds)\n      );\n    }\n\n    case 'NODE_PROPS': {\n      return isNodeProps(payload);\n    }\n\n    case 'SNAPSHOT': {\n      return (\n        isRecord(payload) &&\n        isBlobValue(payload.capture) &&\n        typeof payload.captureMimeType === 'string' &&\n        isPositiveInteger(payload.width) &&\n        isPositiveInteger(payload.height) &&\n        isFiniteNumber(payload.capturedAt) &&\n        payload.capturedAt >= 0 &&\n        isTreeSnapshotPayload(payload.treeSnapshot) &&\n        (payload.html === undefined || typeof payload.html === 'string') &&\n        (payload.htmlTruncated === undefined ||\n          typeof payload.htmlTruncated === 'boolean')\n      );\n    }\n\n    case 'ERROR': {\n      return (\n        isRecord(payload) &&\n        typeof payload.code === 'string' &&\n        (inspectorErrorCodes as readonly string[]).includes(payload.code) &&\n        typeof payload.message === 'string' &&\n        (payload.details === undefined ||\n          (isRecord(payload.details) &&\n            Object.values(payload.details).every((value) =>\n              isSerializableValue(value),\n            )))\n      );\n    }\n  }\n};\n\nconst toRawMessage = (raw: unknown): RawMessage | undefined => {\n  if (typeof raw === 'string') {\n    try {\n      const parsed = JSON.parse(raw) as unknown;\n\n      if (!isRecord(parsed)) {\n        return undefined;\n      }\n\n      return parsed;\n    } catch {\n      return undefined;\n    }\n  }\n\n  if (!isRecord(raw)) {\n    return undefined;\n  }\n\n  return raw;\n};\n\nconst validateOrigin = (\n  options: ParseMessageOptions,\n): InspectorProtocolError | undefined => {\n  if (options.sourceOrigin === undefined) {\n    return undefined;\n  }\n\n  const normalizedSourceOrigin = normalizeOrigin(options.sourceOrigin);\n\n  if (normalizedSourceOrigin === undefined) {\n    return createInspectorProtocolError(\n      'ERR_INVALID_ORIGIN',\n      `Source origin ${options.sourceOrigin} is not a valid URL origin.`,\n    );\n  }\n\n  if (\n    options.expectedOrigin !== undefined\n  ) {\n    const normalizedExpectedOrigin = normalizeOrigin(options.expectedOrigin);\n\n    if (normalizedExpectedOrigin === undefined) {\n      return createInspectorProtocolError(\n        'ERR_INVALID_ORIGIN',\n        `Expected origin ${options.expectedOrigin} is not a valid URL origin.`,\n      );\n    }\n\n    if (normalizedSourceOrigin !== normalizedExpectedOrigin) {\n      return createInspectorProtocolError(\n        'ERR_INVALID_ORIGIN',\n        `Expected ${normalizedExpectedOrigin} but received ${normalizedSourceOrigin}.`,\n      );\n    }\n  }\n\n  if (\n    options.trustedOrigins !== undefined &&\n    !isOriginTrusted(normalizedSourceOrigin, options.trustedOrigins)\n  ) {\n    return createInspectorProtocolError(\n      'ERR_INVALID_ORIGIN',\n      `Origin ${normalizedSourceOrigin} is not in host allowlist.`,\n    );\n  }\n\n  return undefined;\n};\n\nexport const buildMessage = <Type extends InspectorMessageType>(\n  type: Type,\n  payload: InspectorPayloadByType[Type],\n  options: BuildMessageOptions = {},\n): InspectorMessage<Type> => {\n  const baseEnvelope = {\n    channel: INSPECTOR_CHANNEL,\n    version: INSPECTOR_PROTOCOL_VERSION,\n    type,\n    requestId: options.requestId,\n    sessionId: options.sessionId,\n  };\n\n  if (payload === undefined) {\n    return baseEnvelope as unknown as InspectorMessage<Type>;\n  }\n\n  return {\n    ...baseEnvelope,\n    payload,\n  } as unknown as InspectorMessage<Type>;\n};\n\nexport const parseMessage = (\n  raw: unknown,\n  options: ParseMessageOptions = {},\n): ParseMessageResult => {\n  const parsedMessage = toRawMessage(raw);\n\n  if (parsedMessage === undefined) {\n    return {\n      ok: false,\n      error: createInspectorProtocolError(\n        'ERR_INVALID_MESSAGE',\n        'Incoming message must be an object or JSON string object.',\n      ),\n    };\n  }\n\n  const originError = validateOrigin(options);\n\n  if (originError !== undefined) {\n    return {\n      ok: false,\n      error: originError,\n    };\n  }\n\n  if (parsedMessage.channel !== INSPECTOR_CHANNEL) {\n    return {\n      ok: false,\n      error: createInspectorProtocolError(\n        'ERR_INVALID_MESSAGE',\n        `Invalid channel ${String(parsedMessage.channel)}.`,\n      ),\n    };\n  }\n\n  if (typeof parsedMessage.version !== 'number') {\n    return {\n      ok: false,\n      error: createInspectorProtocolError(\n        'ERR_INVALID_MESSAGE',\n        'Message version must be a number.',\n      ),\n    };\n  }\n\n  const supportedVersion =\n    options.supportedVersion ?? INSPECTOR_PROTOCOL_VERSION;\n\n  if (parsedMessage.version !== supportedVersion) {\n    return {\n      ok: false,\n      error: createInspectorProtocolError(\n        'ERR_UNSUPPORTED_VERSION',\n        `Expected version ${supportedVersion} but received ${parsedMessage.version}.`,\n      ),\n    };\n  }\n\n  if (typeof parsedMessage.type !== 'string') {\n    return {\n      ok: false,\n      error: createInspectorProtocolError(\n        'ERR_INVALID_MESSAGE',\n        'Message type must be a string.',\n      ),\n    };\n  }\n\n  if (!validMessageTypes.has(parsedMessage.type)) {\n    return {\n      ok: false,\n      error: createInspectorProtocolError(\n        'ERR_UNKNOWN_MESSAGE_TYPE',\n        `Message type ${parsedMessage.type} is not part of protocol v1.`,\n      ),\n    };\n  }\n\n  if (\n    parsedMessage.requestId !== undefined &&\n    typeof parsedMessage.requestId !== 'string'\n  ) {\n    return {\n      ok: false,\n      error: createInspectorProtocolError(\n        'ERR_INVALID_MESSAGE',\n        'requestId must be a string when provided.',\n      ),\n    };\n  }\n\n  if (\n    parsedMessage.sessionId !== undefined &&\n    typeof parsedMessage.sessionId !== 'string'\n  ) {\n    return {\n      ok: false,\n      error: createInspectorProtocolError(\n        'ERR_INVALID_MESSAGE',\n        'sessionId must be a string when provided.',\n      ),\n    };\n  }\n\n  const messageType = parsedMessage.type as InspectorMessageType;\n  const payload = parsedMessage.payload;\n\n  if (expectsNoPayload(messageType) && payload !== undefined) {\n    return {\n      ok: false,\n      error: createInspectorProtocolError(\n        'ERR_INVALID_PAYLOAD',\n        `${messageType} does not accept a payload.`,\n      ),\n    };\n  }\n\n  if (!validatePayloadByType(messageType, payload)) {\n    return {\n      ok: false,\n      error: createInspectorProtocolError(\n        'ERR_INVALID_PAYLOAD',\n        `Payload does not satisfy ${messageType} contract.`,\n      ),\n    };\n  }\n\n  return {\n    ok: true,\n    message: parsedMessage as AnyInspectorMessage,\n  };\n};\n\nexport const isInspectorMessage = (raw: unknown): raw is AnyInspectorMessage => {\n  return parseMessage(raw).ok;\n};\n"],"names":["validMessageTypes","hostToEmbeddedMessageTypes","embeddedToHostMessageTypes","isRecord","value","isStringArray","item","isStringOrStringArray","isNonNegativeInteger","isPositiveInteger","isFiniteNumber","isHelloAuthMetadata","isHelloAuthPayload","isSerializablePlaceholder","serializablePlaceholderTypes","isSerializableValue","depth","entry","isTreeNode","isNodeProps","isTreeSnapshotMeta","isTreeSnapshotPayload","node","isBlobValue","expectsNoPayload","type","validatePayloadByType","payload","inspectorErrorCodes","toRawMessage","raw","parsed","validateOrigin","options","normalizedSourceOrigin","normalizeOrigin","createInspectorProtocolError","normalizedExpectedOrigin","isOriginTrusted","buildMessage","baseEnvelope","INSPECTOR_CHANNEL","INSPECTOR_PROTOCOL_VERSION","parseMessage","parsedMessage","originError","supportedVersion","messageType","isInspectorMessage"],"mappings":"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"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@iteraai/inspector-protocol",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "description": "Protocol constants, message builders, and validators for the Itera component inspector SDK.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js"
+    },
+    "./validators": {
+      "types": "./dist/validators.d.ts",
+      "import": "./dist/validators.js"
+    },
+    "./origins": {
+      "types": "./dist/origins.d.ts",
+      "import": "./dist/origins.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iteraai/component-inspector.git",
+    "directory": "packages/inspector-protocol"
+  },
+  "bugs": {
+    "url": "https://github.com/iteraai/component-inspector/issues"
+  },
+  "homepage": "https://github.com/iteraai/component-inspector/tree/main/packages/inspector-protocol#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "prepack": "npm run build",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "lint": "eslint . --fix",
+    "lint:ci": "eslint . --max-warnings=0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.19.0",
+    "@stylistic/eslint-plugin-ts": "^4.2.0",
+    "@types/node": "^22.13.1",
+    "eslint": "^9.20.1",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-unicorn": "^58.0.0",
+    "globals": "^15.14.0",
+    "typescript": "~5.6.2",
+    "typescript-eslint": "^8.23.0",
+    "vite": "^6.0.5",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^3.0.8"
+  }
+}