@salesforce/sf-embedding-bridge 2.2.1-rc.7 → 2.2.2

package/dist/bootstrap-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-envelope.d.ts","sourceRoot":"","sources":["../src/bootstrap-envelope.ts"],"names":[],"mappings":"AAUA,OAAO,EAA2B,KAAK,iBAAiB,EAAiB,MAAM,mCAAmC,CAAC;AAEnH,MAAM,MAAM,kCAAkC,GACxC,eAAe,GACf,cAAc,GACd,oBAAoB,GACpB,kBAAkB,GAClB,sBAAsB,GACtB,oBAAoB,CAAC;AAE3B,MAAM,MAAM,iCAAiC,GACvC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,kCAAkC,CAAA;CAAE,CAAC;AAEhE,MAAM,WAAW,gCAAgC;IAC7C,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAClC,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;CAC5B;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAQ9E;AAED,kGAAkG;AAClG,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,gCAAgC,GAAG,iCAAiC,CAYpH"}

package/dist/bootstrap-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-listener.d.ts","sourceRoot":"","sources":["../src/bootstrap-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAiB,MAAM,mCAAmC,CAAC;AAKrG,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;CAC9B;AAED,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAE7D,qBAAa,qBAAsB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;gBAC5B,MAAM,EAAE,sBAAsB;CAK7C;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAkDrE"}

package/dist/bootstrap-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-session.d.ts","sourceRoot":"","sources":["../src/bootstrap-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA2B,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAIH,KAAK,YAAY,EACpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,KAAK,sBAAsB,EAA4B,MAAM,sBAAsB,CAAC;AAG7F,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,EAAE,sBAAsB,CAAC;CAC3C;AAED,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GAAG,SAAS,CAAC;AAEtE,qBAAa,mBAAoB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;gBAC1B,MAAM,EAAE,oBAAoB,EAAE,KAAK,CAAC,EAAE,OAAO;CAQ5D;AAED,MAAM,WAAW,uBAAuB;IACpC;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AA+BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,aAAa,CAAC,CA+B9F"}

package/dist/embedding-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-info.d.ts","sourceRoot":"","sources":["../src/embedding-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAKlE,oEAAoE;AACpE,eAAO,MAAM,cAAc,EAAE,QAG5B,CAAC"}

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,mBAAmB,EAG3B,MAAM,qBAAqB,CAAC;AAG7B,qFAAqF;AACrF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;CAGZ,CAAC;AAEX,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAExE,6IAA6I;AAC7I,wBAAgB,gBAAgB,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACL,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;CAClB,GACP,mBAAmB,CAKrB"}

package/dist/host-meta-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-meta-data.d.ts","sourceRoot":"","sources":["../src/host-meta-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAmCpE"}

package/dist/index.cjs.js

@@ -1,78 +1,8 @@
 'use strict';
 
+var sfEmbeddingContract = require('@salesforce/sf-embedding-contract');
 var jsonrpc = require('@salesforce/jsonrpc');
 
-// Bootstrap envelope vocabulary. Spec: EMBEDDING-PROTOCOL.md §3.1, §3.1.1,
-// MC-7/MC-8/MC-10 in §2.2.
-/** Wire identifier for this protocol. Carried verbatim on every bootstrap envelope. */
-const PROTOCOL_NAME = "sf-embedding";
-/** Discriminator for the host → embedding bootstrap envelope. */
-const BOOTSTRAP_ENVELOPE_TYPE = "sf-embedding.bootstrap";
-/** Discriminator for the embedding → host content-free heartbeat. */
-const HEARTBEAT_TYPE = "sf-embedding/ready";
-/**
- * Discriminator for the embedding → host fail-closed shutdown signal
- * (e.g., duplicate-transfer detection). Posted via window-level postMessage,
- * not over the JSON-RPC port.
- */
-const SHUTDOWN_TYPE = "sf-embedding/shutdown";
-
-// sf-embedding protocol-specific JSON-RPC error codes. Spec §8.2.
-//
-// Standard JSON-RPC codes (-32700, -32600..-32603) and transport-level codes
-// (PORT_CLOSED, SERIALIZATION_FAILURE, REQUEST_TIMEOUT, BACKPRESSURE,
-// REQUEST_CANCELLED) live in `@salesforce/jsonrpc`'s
-// `StandardErrorCode` and are NOT re-exported here. Consumers that need the
-// merged vocabulary compose them at the call site.
-/** sf-embedding protocol-specific error codes (§8.2 numeric assignments). */
-const SfEmbeddingErrorCode = {
-    /** Method exists at selected version but is not granted (§6.5). */
-    CAPABILITY_NOT_ALLOWED: -32010,
-    /** In-flight request gated on a capability that was just revoked (§6.6). */
-    CAPABILITY_REVOKED: -32011,
-    /** Frame arrived before the required handshake step completed (§5.2, §4.2). */
-    NOT_INITIALIZED: -32012,
-    /** Embedding's protocol version is not supported by the host (§4.2, §3.1.2). */
-    PROTOCOL_VERSION_MISMATCH: -32013,
-    /** Frame's origin does not match the bound peer origin (§3.1). */
-    ORIGIN_MISMATCH: -32014,
-    /** Catch-all — duplicate ui/select-version, duplicate ui/discover-capabilities, etc. */
-    PROTOCOL_VIOLATION: -32020,
-    /** Embedding observed a second valid bootstrap envelope and shut down (§3.1.2). */
-    BOOTSTRAP_DUPLICATE_TRANSFER: -32023,
-};
-/**
- * Codes that are non-retryable by default (§8.4). Consumers building error
- * payloads SHOULD set `retryable: false` automatically for these.
- */
-const NON_RETRYABLE_CODES = new Set([
-    SfEmbeddingErrorCode.CAPABILITY_NOT_ALLOWED,
-    SfEmbeddingErrorCode.CAPABILITY_REVOKED,
-    SfEmbeddingErrorCode.ORIGIN_MISMATCH,
-]);
-
-// Host LWC reserved DOM event names and detail shapes. Spec §12.3.
-//
-// These are dispatched by the host LWC on its own element so application
-// code on the page can react. The embedding never observes them.
-/** Event names the host LWC dispatches on its own element. Reserved by the protocol. */
-const HostLwcEvent = {
-    /** Synchronous with `ui/discover-capabilities` response; session reaches READY. */
-    READY: "sf-embedding.component.ready",
-    /** Misconfiguration, bootstrap failure, embedding-reported fatal, or protocol violation. */
-    ERROR: "sf-embedding.component.error",
-};
-
-// Host-supplied iframe URL metadata (per ADR 0029). Spec §3.1, MC-8/MC-10.
-/** URL query-parameter name carrying the JSON-encoded `HostMetaData`. */
-const HOST_META_DATA_PARAM = "hostMetaData";
-
-// JSON-RPC method names on the wire today.
-/** Host announces session identity to the embedding over the port. */
-const HOST_INITIALIZED_METHOD = "ui/notifications/host-initialized";
-/** Embedding acknowledges receipt of `host-initialized`. Fire-and-forget. */
-const EMBEDDING_INITIALIZED_METHOD = "ui/notifications/embedding-initialized";
-
 // Bootstrap envelope validator for the iframe (embedding) side of the
 // sf-embedding handshake.
 //
@@ -87,9 +17,9 @@ function isBootstrapEnvelope(value) {
     if (typeof value !== "object" || value === null || Array.isArray(value))
         return false;
     const v = value;
-    if (v.type !== BOOTSTRAP_ENVELOPE_TYPE)
+    if (v.type !== sfEmbeddingContract.BOOTSTRAP_ENVELOPE_TYPE)
         return false;
-    if (v.protocol !== PROTOCOL_NAME)
+    if (v.protocol !== sfEmbeddingContract.PROTOCOL_NAME)
         return false;
     if (typeof v.instanceId !== "string" || v.instanceId.length === 0)
         return false;
@@ -129,7 +59,7 @@ function readHostMetaData(search) {
     catch {
         return null;
     }
-    const raw = params.get(HOST_META_DATA_PARAM);
+    const raw = params.get(sfEmbeddingContract.HOST_META_DATA_PARAM);
     if (!raw)
         return null;
     let parsed;
@@ -190,7 +120,7 @@ function installBootstrapListener() {
             if (!result.ok) {
                 if (result.reason === "DUPLICATE_TRANSFER") {
                     try {
-                        window.parent.postMessage({ type: SHUTDOWN_TYPE, reason: "DUPLICATE_PORT_TRANSFER" }, meta.hostAppOrigin);
+                        window.parent.postMessage({ type: sfEmbeddingContract.SHUTDOWN_TYPE, reason: "DUPLICATE_PORT_TRANSFER" }, meta.hostAppOrigin);
                     }
                     catch {
                         // ignore
@@ -206,7 +136,7 @@ function installBootstrapListener() {
         };
         window.addEventListener("message", handler);
         try {
-            window.parent.postMessage({ type: HEARTBEAT_TYPE, instanceId: meta.instanceId }, meta.hostAppOrigin);
+            window.parent.postMessage({ type: sfEmbeddingContract.HEARTBEAT_TYPE, instanceId: meta.instanceId }, meta.hostAppOrigin);
         }
         catch {
             // ignore
@@ -217,7 +147,7 @@ function installBootstrapListener() {
 /** Identity emitted on `ui/notifications/embedding-initialized`. */
 const EMBEDDING_INFO = {
     name: "@salesforce/sf-embedding-bridge",
-    version: "2.2.1-rc.7",
+    version: "2.2.2",
 };
 
 class SessionFailureError extends Error {
@@ -234,7 +164,7 @@ class SessionFailureError extends Error {
 class SessionClient extends jsonrpc.JsonRpcClient {
     waitForHostInitialized() {
         return new Promise((resolve) => {
-            this.registerNotificationHandler(HOST_INITIALIZED_METHOD, (params) => {
+            this.registerNotificationHandler(sfEmbeddingContract.HOST_INITIALIZED_METHOD, (params) => {
                 const payload = params && typeof params === "object" && !Array.isArray(params)
                     ? params
                     : {};
@@ -244,7 +174,7 @@ class SessionClient extends jsonrpc.JsonRpcClient {
     }
     sendInitializedNotification() {
         const params = { embeddingInfo: EMBEDDING_INFO };
-        this.sendNotification(EMBEDDING_INITIALIZED_METHOD, params);
+        this.sendNotification(sfEmbeddingContract.EMBEDDING_INITIALIZED_METHOD, params);
     }
 }
 function rejectOnAbort(signal) {
@@ -301,29 +231,19 @@ function bootstrapSession(options = {}) {
 /** Combined error vocabulary: standard + transport-level + sf-embedding-specific. */
 const ErrorCode = {
     ...jsonrpc.StandardErrorCode,
-    ...SfEmbeddingErrorCode,
+    ...sfEmbeddingContract.SfEmbeddingErrorCode,
 };
 /** Builds a JSON-RPC error payload with sf-embedding-specific retryable defaults; falls through to @salesforce/jsonrpc for codes it owns. */
 function makeJsonRpcError(code, options = {}) {
-    if (NON_RETRYABLE_CODES.has(code) && options.retryable === undefined) {
+    if (sfEmbeddingContract.NON_RETRYABLE_CODES.has(code) && options.retryable === undefined) {
         return jsonrpc.makeJsonRpcError(code, { ...options, retryable: false });
     }
     return jsonrpc.makeJsonRpcError(code, options);
 }
 
-exports.BOOTSTRAP_ENVELOPE_TYPE = BOOTSTRAP_ENVELOPE_TYPE;
 exports.BootstrapFailureError = BootstrapFailureError;
-exports.EMBEDDING_INITIALIZED_METHOD = EMBEDDING_INITIALIZED_METHOD;
 exports.ErrorCode = ErrorCode;
-exports.HEARTBEAT_TYPE = HEARTBEAT_TYPE;
-exports.HOST_INITIALIZED_METHOD = HOST_INITIALIZED_METHOD;
-exports.HOST_META_DATA_PARAM = HOST_META_DATA_PARAM;
-exports.HostLwcEvent = HostLwcEvent;
-exports.NON_RETRYABLE_CODES = NON_RETRYABLE_CODES;
-exports.PROTOCOL_NAME = PROTOCOL_NAME;
-exports.SHUTDOWN_TYPE = SHUTDOWN_TYPE;
 exports.SessionFailureError = SessionFailureError;
-exports.SfEmbeddingErrorCode = SfEmbeddingErrorCode;
 exports.bootstrapSession = bootstrapSession;
 exports.isBootstrapEnvelope = isBootstrapEnvelope;
 exports.makeJsonRpcError = makeJsonRpcError;

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/bootstrap-envelope.ts","../src/host-meta-data.ts","../src/bootstrap-listener.ts","../src/embedding-info.ts","../src/bootstrap-session.ts","../src/errors.ts"],"sourcesContent":[null,null,null,null,null,null],"names":["BOOTSTRAP_ENVELOPE_TYPE","PROTOCOL_NAME","HOST_META_DATA_PARAM","SHUTDOWN_TYPE","HEARTBEAT_TYPE","JsonRpcClient","HOST_INITIALIZED_METHOD","EMBEDDING_INITIALIZED_METHOD","MessageChannelTransport","StandardErrorCode","SfEmbeddingErrorCode","NON_RETRYABLE_CODES","makeStandardError"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,128 +1,5 @@
-/** Wire identifier for this protocol. Carried verbatim on every bootstrap envelope. */
-declare const PROTOCOL_NAME: "sf-embedding";
-/** Discriminator for the host → embedding bootstrap envelope. */
-declare const BOOTSTRAP_ENVELOPE_TYPE: "sf-embedding.bootstrap";
-/** Discriminator for the embedding → host content-free heartbeat. */
-declare const HEARTBEAT_TYPE: "sf-embedding/ready";
-/**
- * Discriminator for the embedding → host fail-closed shutdown signal
- * (e.g., duplicate-transfer detection). Posted via window-level postMessage,
- * not over the JSON-RPC port.
- */
-declare const SHUTDOWN_TYPE: "sf-embedding/shutdown";
-/** Bootstrap envelope the host transfers to the embedding alongside `port1`. */
-interface BootstrapEnvelope {
-    type: typeof BOOTSTRAP_ENVELOPE_TYPE;
-    protocol: typeof PROTOCOL_NAME;
-    /** Host-minted; byte-for-byte identical to `hostMetaData.instanceId` (MC-10). */
-    instanceId: string;
-    /** Origins the host expects its wrapper chrome to load on; embedding reverse-checks. */
-    allowedOrigins: string[];
-}
-/** Heartbeat the embedding posts to `window.parent` before the port is transferred. */
-interface HeartbeatEnvelope {
-    type: typeof HEARTBEAT_TYPE;
-    /** Mirrors the URL-supplied `hostMetaData.instanceId`; binds the heartbeat to this iframe instance. */
-    instanceId: string;
-}
-/** Embedding-initiated fail-closed shutdown payload (sibling-race detected, etc.). */
-interface ShutdownEnvelope {
-    type: typeof SHUTDOWN_TYPE;
-    /** Free-form; common values: `"DUPLICATE_PORT_TRANSFER"`. */
-    reason?: string;
-}
-
-/** sf-embedding protocol-specific error codes (§8.2 numeric assignments). */
-declare const SfEmbeddingErrorCode: {
-    /** Method exists at selected version but is not granted (§6.5). */
-    readonly CAPABILITY_NOT_ALLOWED: -32010;
-    /** In-flight request gated on a capability that was just revoked (§6.6). */
-    readonly CAPABILITY_REVOKED: -32011;
-    /** Frame arrived before the required handshake step completed (§5.2, §4.2). */
-    readonly NOT_INITIALIZED: -32012;
-    /** Embedding's protocol version is not supported by the host (§4.2, §3.1.2). */
-    readonly PROTOCOL_VERSION_MISMATCH: -32013;
-    /** Frame's origin does not match the bound peer origin (§3.1). */
-    readonly ORIGIN_MISMATCH: -32014;
-    /** Catch-all — duplicate ui/select-version, duplicate ui/discover-capabilities, etc. */
-    readonly PROTOCOL_VIOLATION: -32020;
-    /** Embedding observed a second valid bootstrap envelope and shut down (§3.1.2). */
-    readonly BOOTSTRAP_DUPLICATE_TRANSFER: -32023;
-};
-/** Numeric type of any value in `SfEmbeddingErrorCode`. */
-type SfEmbeddingErrorCodeValue = (typeof SfEmbeddingErrorCode)[keyof typeof SfEmbeddingErrorCode];
-/**
- * Codes that are non-retryable by default (§8.4). Consumers building error
- * payloads SHOULD set `retryable: false` automatically for these.
- */
-declare const NON_RETRYABLE_CODES: ReadonlySet<number>;
-
-/** Event names the host LWC dispatches on its own element. Reserved by the protocol. */
-declare const HostLwcEvent: {
-    /** Synchronous with `ui/discover-capabilities` response; session reaches READY. */
-    readonly READY: "sf-embedding.component.ready";
-    /** Misconfiguration, bootstrap failure, embedding-reported fatal, or protocol violation. */
-    readonly ERROR: "sf-embedding.component.error";
-};
-/** Type-level union of the reserved event names. */
-type HostLwcEventName = (typeof HostLwcEvent)[keyof typeof HostLwcEvent];
-/** Detail of `sf-embedding.component.ready`. */
-interface HostReadyEventDetail {
-    instanceId: string;
-}
-/** Detail of `sf-embedding.component.error` (§12.3). */
-interface HostErrorEventDetail {
-    instanceId?: string;
-    /** Failure category — drives consumer reaction. */
-    phase: "configuration" | "bootstrap" | "session";
-    /** ErrorCode constant or a configuration-error string (e.g. `"SAME_ORIGIN_SRC"`). */
-    code: string;
-    message: string;
-    /**
-     * Whether remount is plausibly fruitful (per spec §12.3).
-     * `true` — transient failures where a fresh attempt may succeed: bootstrap
-     *   handshake timeout, embedding-reported runtime error.
-     * `false` — fix the underlying problem first: configuration errors
-     *   (same-origin src, allow-scripts stripped, malformed src) and protocol
-     *   violations (duplicate port transfer).
-     */
-    retryable: boolean;
-    cause?: unknown;
-}
-
-/** URL query-parameter name carrying the JSON-encoded `HostMetaData`. */
-declare const HOST_META_DATA_PARAM: "hostMetaData";
-/**
- * Shape of the JSON-encoded `hostMetaData` query parameter on the iframe URL.
- *
- * The host MUST write this onto `iframe.src` when assigning it; the embedding
- * MUST read it before emitting the heartbeat. `hostAppOrigin` is the trust
- * root for the embedding's inbound bootstrap envelope (MC-8). `instanceId`
- * binds the inbound bootstrap envelope to this iframe instance (MC-10).
- */
-interface HostMetaData {
-    hostAppOrigin: string;
-    instanceId: string;
-}
-
-/** Host announces session identity to the embedding over the port. */
-declare const HOST_INITIALIZED_METHOD: "ui/notifications/host-initialized";
-/** Embedding acknowledges receipt of `host-initialized`. Fire-and-forget. */
-declare const EMBEDDING_INITIALIZED_METHOD: "ui/notifications/embedding-initialized";
-/** Identity of the host or embedding product. */
-interface PeerInfo {
-    name: string;
-    version: string;
-}
-/** Params for `ui/notifications/host-initialized`. */
-interface HostInitializedParams {
-    instanceId: string;
-    hostInfo: PeerInfo;
-}
-/** Params for `ui/notifications/embedding-initialized`. */
-interface EmbeddingInitializedParams {
-    embeddingInfo: PeerInfo;
-}
+import { BootstrapEnvelope, HostMetaData } from '@salesforce/sf-embedding-contract';
+import { JsonRpcClient, JsonRpcErrorPayload } from '@salesforce/jsonrpc';
 
 type BootstrapEnvelopeValidationFailure = "INVALID_SHAPE" | "WRONG_SOURCE" | "ORIGIN_NOT_ALLOWED" | "WRONG_PORT_COUNT" | "INSTANCE_ID_MISMATCH" | "DUPLICATE_TRANSFER";
 type BootstrapEnvelopeValidationResult = {
@@ -154,168 +31,6 @@ declare class BootstrapFailureError extends Error {
     constructor(reason: BootstrapFailureReason);
 }
 
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
-/**
- * Abstract transport for a JSON-RPC 2.0 client.
- *
- * A `Transport` is a bidirectional, structured-message pipe. The
- * `JsonRpcClient` uses it to send JSON-RPC messages (`post`) and subscribe
- * to inbound ones (`onMessage`). The transport itself is agnostic to the
- * JSON-RPC framing — it simply moves `unknown` payloads between two
- * endpoints.
- *
- * Concrete transports plug into the same shape:
- *   - `WindowPostMessageTransport` (window.parent.postMessage; used by
- *     MCP Apps)
- *   - `MessageChannelTransport` (a transferred `MessagePort`; used by
- *     sf-embedding and any future surface that bootstraps with a
- *     dedicated channel)
- */
-interface Transport {
-    /**
-     * Deliver a single structured message to the peer. Implementations MUST
-     * NOT throw on transient conditions (closed port, missing parent
-     * window, etc.) — drop the message silently instead, matching the
-     * prior `window.parent?.postMessage` behaviour.
-     */
-    post(message: unknown): void;
-    /**
-     * Subscribe to inbound structured messages from the peer. The callback
-     * receives the already-unwrapped message payload (never a
-     * `MessageEvent`).
-     *
-     * @returns an unsubscribe function that removes this listener.
-     */
-    onMessage(callback: (message: unknown) => void): () => void;
-}
-
-/**
- * Base class for JSON-RPC 2.0 clients.
- *
- * This class provides core JSON-RPC client functionality for any cross-realm
- * surface that speaks JSON-RPC 2.0 (MCP Apps, sf-embedding, future
- * surfaces). It handles request/response correlation, message validation,
- * and notification dispatch.
- *
- * The transport layer is pluggable via the `Transport` interface and is
- * REQUIRED at construction. There is no default transport — wildcard-targeted
- * `window.postMessage` is structurally unsafe, so callers must construct a
- * transport with an explicit origin (`WindowPostMessageTransport`) or a
- * port-bound transport (`MessageChannelTransport`).
- *
- * Subclasses should extend this class and use the protected `request()`
- * method to send JSON-RPC requests to the peer.
- *
- * @example
- * export class MCPAppsViewSDK extends JsonRpcClient implements ViewSDK {
- *   async displayAlert(options: AlertOptions): Promise<void> {
- *     await this.request("ui/message", {
- *       role: "user",
- *       content: { type: "text", text: options.message }
- *     });
- *   }
- * }
- *
- * @example
- * // Injecting a transport (window.parent.postMessage to a known origin).
- * class MyClient extends JsonRpcClient {
- *   constructor(targetOrigin: string) {
- *     super(new WindowPostMessageTransport(targetOrigin));
- *   }
- * }
- */
-declare class JsonRpcClient {
-    private nextRequestId;
-    private pending;
-    private notificationHandlers;
-    private readonly transport;
-    /**
-     * Construct a JSON-RPC client bound to the given transport.
-     *
-     * @param transport - the transport to use.
-     */
-    constructor(transport: Transport);
-    /**
-     * Register a handler for a specific JSON-RPC notification method.
-     *
-     * Subclasses can register handlers to process specific notification
-     * types. When a notification with the registered method is received,
-     * the handler will be invoked with the notification params.
-     *
-     * @param method - The notification method to handle (e.g.
-     *   "ui/notifications/host-context-changed")
-     * @param handler - Callback function to process the notification params
-     *
-     * @example
-     * this.registerNotificationHandler("ui/notifications/host-context-changed", (params) => {
-     *   this.handleHostContextChanged(params);
-     * });
-     */
-    protected registerNotificationHandler(method: string, handler: (params: unknown) => void): void;
-    /**
-     * Handle inbound JSON-RPC messages from the transport.
-     *
-     * Processes both responses (for requests) and notifications.
-     * Non-JSON-RPC payloads are silently ignored so that a shared transport
-     * can be used for multiple protocols without cross-talk.
-     */
-    private onMessage;
-    /**
-     * Send a JSON-RPC request to the peer.
-     *
-     * @param method - The JSON-RPC method name
-     * @param params - The method parameters
-     * @returns Promise that resolves with the result or rejects with error
-     *
-     * @example
-     * const result = await this.request("ui/message", {
-     *   role: "user",
-     *   content: { type: "text", text: "Hello" }
-     * });
-     */
-    protected request<TParams = unknown, TResult = unknown>(method: string, params: TParams): Promise<TResult>;
-    /**
-     * Send a JSON-RPC notification to the peer.
-     *
-     * Notifications are one-way messages that do not expect a response.
-     * Use notifications for:
-     * - Informing the host of state changes
-     * - Fire-and-forget operations
-     * - Events that don't require confirmation
-     *
-     * Use request() instead when you need:
-     * - A response from the host
-     * - Confirmation of success/failure
-     * - Return values from the operation
-     *
-     * @param method - The JSON-RPC method name
-     * @param params - Optional method parameters
-     *
-     * @example
-     * this.sendNotification("ui/notifications/size-changed", {
-     *   width: 800,
-     *   height: 600
-     * });
-     */
-    protected sendNotification<TParams = unknown>(method: string, params?: TParams): void;
-}
-
-/** Structure of the `data` field on a JSON-RPC error payload. */
-interface JsonRpcErrorData {
-    retryable?: boolean;
-    details?: Record<string, unknown>;
-}
-/** Shape of a JSON-RPC error payload (the value under `error` on an error response). */
-interface JsonRpcErrorPayload {
-    code: number;
-    message?: string;
-    data?: JsonRpcErrorData;
-}
-
 type HostInitializedPayload = Record<string, unknown>;
 interface SessionHandle {
     client: JsonRpcClient;
@@ -378,5 +93,5 @@ declare function makeJsonRpcError(code: number, options?: {
  */
 declare function readHostMetaData(search: string): HostMetaData | null;
 
-export { BOOTSTRAP_ENVELOPE_TYPE, BootstrapFailureError, EMBEDDING_INITIALIZED_METHOD, ErrorCode, HEARTBEAT_TYPE, HOST_INITIALIZED_METHOD, HOST_META_DATA_PARAM, HostLwcEvent, NON_RETRYABLE_CODES, PROTOCOL_NAME, SHUTDOWN_TYPE, SessionFailureError, SfEmbeddingErrorCode, bootstrapSession, isBootstrapEnvelope, makeJsonRpcError, readHostMetaData, validateBootstrapEnvelope };
-export type { BootstrapEnvelope, BootstrapEnvelopeValidationFailure, BootstrapEnvelopeValidationInput, BootstrapEnvelopeValidationResult, BootstrapFailureReason, BootstrapSessionOptions, EmbeddingInitializedParams, ErrorCodeValue, HeartbeatEnvelope, HostErrorEventDetail, HostInitializedParams, HostInitializedPayload, HostLwcEventName, HostMetaData, HostReadyEventDetail, PeerInfo, SessionFailureReason, SessionHandle, SfEmbeddingErrorCodeValue, ShutdownEnvelope };
+export { BootstrapFailureError, ErrorCode, SessionFailureError, bootstrapSession, isBootstrapEnvelope, makeJsonRpcError, readHostMetaData, validateBootstrapEnvelope };
+export type { BootstrapEnvelopeValidationFailure, BootstrapEnvelopeValidationInput, BootstrapEnvelopeValidationResult, BootstrapFailureReason, BootstrapSessionOptions, ErrorCodeValue, HostInitializedPayload, SessionFailureReason, SessionHandle };

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACH,KAAK,kCAAkC,EACvC,KAAK,gCAAgC,EACrC,KAAK,iCAAiC,EACtC,mBAAmB,EACnB,yBAAyB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EACH,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,aAAa,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.esm.js

@@ -1,76 +1,6 @@
+import { BOOTSTRAP_ENVELOPE_TYPE, PROTOCOL_NAME, HOST_META_DATA_PARAM, HEARTBEAT_TYPE, SHUTDOWN_TYPE, HOST_INITIALIZED_METHOD, EMBEDDING_INITIALIZED_METHOD, SfEmbeddingErrorCode, NON_RETRYABLE_CODES } from '@salesforce/sf-embedding-contract';
 import { MessageChannelTransport, JsonRpcClient, StandardErrorCode, makeJsonRpcError as makeJsonRpcError$1 } from '@salesforce/jsonrpc';
 
-// Bootstrap envelope vocabulary. Spec: EMBEDDING-PROTOCOL.md §3.1, §3.1.1,
-// MC-7/MC-8/MC-10 in §2.2.
-/** Wire identifier for this protocol. Carried verbatim on every bootstrap envelope. */
-const PROTOCOL_NAME = "sf-embedding";
-/** Discriminator for the host → embedding bootstrap envelope. */
-const BOOTSTRAP_ENVELOPE_TYPE = "sf-embedding.bootstrap";
-/** Discriminator for the embedding → host content-free heartbeat. */
-const HEARTBEAT_TYPE = "sf-embedding/ready";
-/**
- * Discriminator for the embedding → host fail-closed shutdown signal
- * (e.g., duplicate-transfer detection). Posted via window-level postMessage,
- * not over the JSON-RPC port.
- */
-const SHUTDOWN_TYPE = "sf-embedding/shutdown";
-
-// sf-embedding protocol-specific JSON-RPC error codes. Spec §8.2.
-//
-// Standard JSON-RPC codes (-32700, -32600..-32603) and transport-level codes
-// (PORT_CLOSED, SERIALIZATION_FAILURE, REQUEST_TIMEOUT, BACKPRESSURE,
-// REQUEST_CANCELLED) live in `@salesforce/jsonrpc`'s
-// `StandardErrorCode` and are NOT re-exported here. Consumers that need the
-// merged vocabulary compose them at the call site.
-/** sf-embedding protocol-specific error codes (§8.2 numeric assignments). */
-const SfEmbeddingErrorCode = {
-    /** Method exists at selected version but is not granted (§6.5). */
-    CAPABILITY_NOT_ALLOWED: -32010,
-    /** In-flight request gated on a capability that was just revoked (§6.6). */
-    CAPABILITY_REVOKED: -32011,
-    /** Frame arrived before the required handshake step completed (§5.2, §4.2). */
-    NOT_INITIALIZED: -32012,
-    /** Embedding's protocol version is not supported by the host (§4.2, §3.1.2). */
-    PROTOCOL_VERSION_MISMATCH: -32013,
-    /** Frame's origin does not match the bound peer origin (§3.1). */
-    ORIGIN_MISMATCH: -32014,
-    /** Catch-all — duplicate ui/select-version, duplicate ui/discover-capabilities, etc. */
-    PROTOCOL_VIOLATION: -32020,
-    /** Embedding observed a second valid bootstrap envelope and shut down (§3.1.2). */
-    BOOTSTRAP_DUPLICATE_TRANSFER: -32023,
-};
-/**
- * Codes that are non-retryable by default (§8.4). Consumers building error
- * payloads SHOULD set `retryable: false` automatically for these.
- */
-const NON_RETRYABLE_CODES = new Set([
-    SfEmbeddingErrorCode.CAPABILITY_NOT_ALLOWED,
-    SfEmbeddingErrorCode.CAPABILITY_REVOKED,
-    SfEmbeddingErrorCode.ORIGIN_MISMATCH,
-]);
-
-// Host LWC reserved DOM event names and detail shapes. Spec §12.3.
-//
-// These are dispatched by the host LWC on its own element so application
-// code on the page can react. The embedding never observes them.
-/** Event names the host LWC dispatches on its own element. Reserved by the protocol. */
-const HostLwcEvent = {
-    /** Synchronous with `ui/discover-capabilities` response; session reaches READY. */
-    READY: "sf-embedding.component.ready",
-    /** Misconfiguration, bootstrap failure, embedding-reported fatal, or protocol violation. */
-    ERROR: "sf-embedding.component.error",
-};
-
-// Host-supplied iframe URL metadata (per ADR 0029). Spec §3.1, MC-8/MC-10.
-/** URL query-parameter name carrying the JSON-encoded `HostMetaData`. */
-const HOST_META_DATA_PARAM = "hostMetaData";
-
-// JSON-RPC method names on the wire today.
-/** Host announces session identity to the embedding over the port. */
-const HOST_INITIALIZED_METHOD = "ui/notifications/host-initialized";
-/** Embedding acknowledges receipt of `host-initialized`. Fire-and-forget. */
-const EMBEDDING_INITIALIZED_METHOD = "ui/notifications/embedding-initialized";
-
 // Bootstrap envelope validator for the iframe (embedding) side of the
 // sf-embedding handshake.
 //
@@ -215,7 +145,7 @@ function installBootstrapListener() {
 /** Identity emitted on `ui/notifications/embedding-initialized`. */
 const EMBEDDING_INFO = {
     name: "@salesforce/sf-embedding-bridge",
-    version: "2.2.1-rc.7",
+    version: "2.2.2",
 };
 
 class SessionFailureError extends Error {
@@ -309,5 +239,5 @@ function makeJsonRpcError(code, options = {}) {
     return makeJsonRpcError$1(code, options);
 }
 
-export { BOOTSTRAP_ENVELOPE_TYPE, BootstrapFailureError, EMBEDDING_INITIALIZED_METHOD, ErrorCode, HEARTBEAT_TYPE, HOST_INITIALIZED_METHOD, HOST_META_DATA_PARAM, HostLwcEvent, NON_RETRYABLE_CODES, PROTOCOL_NAME, SHUTDOWN_TYPE, SessionFailureError, SfEmbeddingErrorCode, bootstrapSession, isBootstrapEnvelope, makeJsonRpcError, readHostMetaData, validateBootstrapEnvelope };
+export { BootstrapFailureError, ErrorCode, SessionFailureError, bootstrapSession, isBootstrapEnvelope, makeJsonRpcError, readHostMetaData, validateBootstrapEnvelope };
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/bootstrap-envelope.ts","../src/host-meta-data.ts","../src/bootstrap-listener.ts","../src/embedding-info.ts","../src/bootstrap-session.ts","../src/errors.ts"],"sourcesContent":[null,null,null,null,null,null],"names":["makeStandardError"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/sf-embedding-bridge",
-    "version": "2.2.1-rc.7",
+    "version": "2.2.2",
     "private": false,
     "description": "JSON-RPC 2.0 bridge for the sf-embedding host ↔ embedding protocol",
     "license": "SEE LICENSE IN LICENSE.txt",
@@ -21,17 +21,11 @@
         "test": "jest --passWithNoTests"
     },
     "dependencies": {
+        "@salesforce/sf-embedding-contract": "2.2.2",
         "@salesforce/jsonrpc": "^9.13.0"
     },
-    "devDependencies": {
-        "@salesforce/sf-embedding-contract": "2.2.1-rc.7"
-    },
     "files": [
         "dist/",
-        "!dist/__tests__/",
-        "!dist/__mocks__/",
-        "!dist/*.test.js",
-        "!dist/*.map",
         "README.md",
         "LICENSE.txt"
     ],