@pitcher/js-api 1.26.0-beta.1 → 1.26.0-beta.11

package/impact-js-api.spec.json

@@ -178,6 +178,21 @@
     "crm_query": {
       "description": ""
     },
+    "crm_smart_query": {
+      "description": "Execute a SmartStore query against local CRM data. iOS only."
+    },
+    "crm_smart_upsert_objects": {
+      "description": "Upsert CRM objects into local CRM data using SmartStore. iOS only."
+    },
+    "crm_smart_object_validation_rules": {
+      "description": "Retrieve validation rules for a CRM smart object. iOS only."
+    },
+    "crm_smart_object_metadata": {
+      "description": "Retrieve metadata for a CRM smart object. iOS only."
+    },
+    "crm_smart_delete_objects": {
+      "description": "Delete CRM objects from local CRM data using SmartStore. iOS only."
+    },
     "search": {
       "description": ""
     },

package/js-api.esm.js

@@ -2470,8 +2470,13 @@ function getRecentFiles(payload) {
 function downloadFile(payload) {
   return this.API.request("download_file", payload);
 }
-function getAppConfig$1(payload) {
-  return this.API.request("get_app_config", payload);
+function getAppConfig$2(payload) {
+  let fileId;
+  if (!payload?.app_name && typeof window !== "undefined" && window.location.href.startsWith("file://")) {
+    const match = window.location.href.match(/pitcher(?:%20|\s+)folders\/files\/([^/]+)\//i);
+    fileId = match?.[1];
+  }
+  return fileId ? this.API.request("get_file", { file_id: fileId }).then((file) => file?.metadata ?? {}) : this.API.request("get_app_config", payload);
 }
 function getFile$2(payload) {
   const { id, file_id } = payload;
@@ -2492,6 +2497,9 @@ function createFile(payload) {
 function selectDeviceFile() {
   return this.API.request("select_device_file");
 }
+function deleteLocalFile(payload) {
+  return this.API.request("delete_local_file", payload);
+}
 
 function getFileRevisions(payload) {
   const { id, file_id } = payload;
@@ -2529,6 +2537,153 @@ function query(payload) {
 function crmQuery(payload) {
   return highLevelApi.API.request("crm_query", payload);
 }
+function crmSmartQuery(payload) {
+  const query2 = payload.query;
+  if (!query2 || typeof query2 !== "string") {
+    return Promise.reject(new Error("Query is required and must be a string"));
+  }
+  const smartStorePattern = /\{[^}]+:[^}]+\}/;
+  if (!smartStorePattern.test(query2.trim())) {
+    return Promise.reject(
+      new Error(
+        "Invalid SmartStore query syntax. SmartStore queries must use curly braces syntax: {SoupName:FieldName}"
+      )
+    );
+  }
+  return highLevelApi.API.request("crm_smart_query", payload);
+}
+function crmSmartObjectMetadata(payload) {
+  if (!payload) {
+    return Promise.reject(new Error("Payload is required"));
+  }
+  const objectName = payload.object;
+  if (!objectName || typeof objectName !== "string" || objectName.trim() === "") {
+    return Promise.reject(new Error("Object name is required and must be a non-empty string"));
+  }
+  return highLevelApi.API.request("crm_smart_object_metadata", payload);
+}
+function crmSmartUpsertObjects(payload) {
+  if (!payload || !payload.objects || !Array.isArray(payload.objects)) {
+    return Promise.reject(new Error("Payload must contain an array of objects"));
+  }
+  if (payload.objects.length === 0) {
+    return Promise.reject(new Error("Objects array cannot be empty"));
+  }
+  for (const obj of payload.objects) {
+    if (!obj) {
+      return Promise.reject(new Error("Objects array cannot contain null or undefined elements"));
+    }
+    if (!obj.table_name || typeof obj.table_name !== "string" || obj.table_name.trim() === "") {
+      return Promise.reject(new Error("Each object must have a valid non-empty table_name"));
+    }
+    if (obj.external_id_path !== void 0) {
+      if (typeof obj.external_id_path !== "string" || obj.external_id_path.trim() === "") {
+        return Promise.reject(
+          new Error(
+            `Object for table ${obj.table_name} has invalid external_id_path. It must be a non-empty string or undefined.`
+          )
+        );
+      }
+    }
+    if (!obj.objects || !Array.isArray(obj.objects) || obj.objects.length === 0) {
+      return Promise.reject(new Error(`Object for table ${obj.table_name} must have a non-empty objects array`));
+    }
+    for (let i = 0; i < obj.objects.length; i++) {
+      const record = obj.objects[i];
+      if (!record || typeof record !== "object" || Array.isArray(record)) {
+        return Promise.reject(
+          new Error(
+            `Object for table ${obj.table_name} contains invalid element at index ${i}. All records must be valid objects, not null, undefined, or arrays.`
+          )
+        );
+      }
+    }
+  }
+  return highLevelApi.API.request("crm_smart_upsert_objects", payload);
+}
+function crmSmartObjectValidationRules(payload) {
+  if (!payload) {
+    return Promise.reject(new Error("Payload is required"));
+  }
+  const objectName = payload.object;
+  if (!objectName || typeof objectName !== "string" || objectName.trim() === "") {
+    return Promise.reject(new Error("Object name is required and must be a non-empty string"));
+  }
+  return highLevelApi.API.request("crm_smart_object_validation_rules", payload);
+}
+function crmSmartDeleteObjects(payload) {
+  if (!payload || !payload.objects || !Array.isArray(payload.objects)) {
+    return Promise.reject(new Error("Payload must contain an array of objects"));
+  }
+  if (payload.objects.length === 0) {
+    return Promise.reject(new Error("Objects array cannot be empty"));
+  }
+  for (const obj of payload.objects) {
+    if (!obj) {
+      return Promise.reject(new Error("Objects array cannot contain null or undefined elements"));
+    }
+    if (!obj.table_name || typeof obj.table_name !== "string" || obj.table_name.trim() === "") {
+      return Promise.reject(new Error("Each object must have a valid non-empty table_name"));
+    }
+    if (!obj.ids || !Array.isArray(obj.ids) || obj.ids.length === 0) {
+      return Promise.reject(new Error(`Object for table ${obj.table_name} must have a non-empty ids array`));
+    }
+    for (let i = 0; i < obj.ids.length; i++) {
+      const id = obj.ids[i];
+      if (!id || typeof id !== "string" || id.trim() === "") {
+        return Promise.reject(
+          new Error(
+            `Object for table ${obj.table_name} contains invalid id at index ${i}. All IDs must be non-empty strings.`
+          )
+        );
+      }
+    }
+  }
+  return highLevelApi.API.request("crm_smart_delete_objects", payload);
+}
+function crmCreate(payload) {
+  if (!payload) {
+    return Promise.reject(new Error("Payload is required"));
+  }
+  if (!payload.sobject || typeof payload.sobject !== "string" || payload.sobject.trim() === "") {
+    return Promise.reject(new Error("sobject is required and must be a non-empty string"));
+  }
+  if (!payload.records || !Array.isArray(payload.records) || payload.records.length === 0) {
+    return Promise.reject(new Error("records is required and must be a non-empty array"));
+  }
+  for (let i = 0; i < payload.records.length; i++) {
+    const record = payload.records[i];
+    if (!record || typeof record !== "object" || Array.isArray(record)) {
+      return Promise.reject(
+        new Error(`records contains invalid element at index ${i}. All records must be valid objects.`)
+      );
+    }
+  }
+  return highLevelApi.API.request("crm_create", payload);
+}
+function crmUpsert(payload) {
+  if (!payload) {
+    return Promise.reject(new Error("Payload is required"));
+  }
+  if (!payload.sobject || typeof payload.sobject !== "string" || payload.sobject.trim() === "") {
+    return Promise.reject(new Error("sobject is required and must be a non-empty string"));
+  }
+  if (!payload.records || !Array.isArray(payload.records) || payload.records.length === 0) {
+    return Promise.reject(new Error("records is required and must be a non-empty array"));
+  }
+  if (!payload.external_id_field || typeof payload.external_id_field !== "string" || payload.external_id_field.trim() === "") {
+    return Promise.reject(new Error("external_id_field is required and must be a non-empty string"));
+  }
+  for (let i = 0; i < payload.records.length; i++) {
+    const record = payload.records[i];
+    if (!record || typeof record !== "object" || Array.isArray(record)) {
+      return Promise.reject(
+        new Error(`records contains invalid element at index ${i}. All records must be valid objects.`)
+      );
+    }
+  }
+  return highLevelApi.API.request("crm_upsert", payload);
+}
 
 function getFolders(payload) {
   return this.API.request("get_folders", payload);
@@ -2598,6 +2753,9 @@ function close$2() {
 function openWebViewAlwaysOnTop(payload) {
   return this.API.request("open_web_view_always_on_top", payload);
 }
+function showSyncbox(payload) {
+  return this.API.request("show_syncbox", payload);
+}
 
 async function share(payload) {
   return this.API.request("share", payload);
@@ -2622,15 +2780,23 @@ const modules = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	createFavorite,
 	createFile,
 	createFolder,
+	crmCreate,
 	crmQuery,
+	crmSmartDeleteObjects,
+	crmSmartObjectMetadata,
+	crmSmartObjectValidationRules,
+	crmSmartQuery,
+	crmSmartUpsertObjects,
+	crmUpsert,
 	deleteCanvas,
 	deleteEvent,
 	deleteFavorite,
 	deleteFile,
 	deleteFolder,
+	deleteLocalFile,
 	downloadFile,
 	fetchDocumentInfo,
-	getAppConfig: getAppConfig$1,
+	getAppConfig: getAppConfig$2,
 	getCanvas: getCanvas$1,
 	getCanvasRecommendedFiles,
 	getCanvasTheme,
@@ -2666,6 +2832,7 @@ const modules = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	share,
 	shareCanvas,
 	showPeerSession,
+	showSyncbox,
 	submitUserFeedback,
 	toast: toast$2,
 	track,
@@ -2734,10 +2901,7 @@ function rng() {
 const randomUUID = typeof crypto !== 'undefined' && crypto.randomUUID && crypto.randomUUID.bind(crypto);
 const native = { randomUUID };
 
-function v4(options, buf, offset) {
-    if (native.randomUUID && true && !options) {
-        return native.randomUUID();
-    }
+function _v4(options, buf, offset) {
     options = options || {};
     const rnds = options.random ?? options.rng?.() ?? rng();
     if (rnds.length < 16) {
@@ -2747,6 +2911,12 @@ function v4(options, buf, offset) {
     rnds[8] = (rnds[8] & 0x3f) | 0x80;
     return unsafeStringify(rnds);
 }
+function v4(options, buf, offset) {
+    if (native.randomUUID && true && !options) {
+        return native.randomUUID();
+    }
+    return _v4(options);
+}
 
 const PITCHER_EVENT = "PITCHER_EVENT";
 var PitcherMessageType = /* @__PURE__ */ ((PitcherMessageType2) => {
@@ -2762,6 +2932,7 @@ var PitcherResponseStatus = /* @__PURE__ */ ((PitcherResponseStatus2) => {
 var PitcherEventName = /* @__PURE__ */ ((PitcherEventName2) => {
   PitcherEventName2["ENV_CHANGED"] = "env_changed";
   PitcherEventName2["PHOTOS_CAPTURED"] = "photos_captured";
+  PitcherEventName2["GLOBAL_PHOTO_CAPTURED"] = "global_photo_captured";
   PitcherEventName2["FILE_DOWNLOADED"] = "file_downloaded";
   PitcherEventName2["FILE_UPLOAD_PROGRESS"] = "file_upload_progress";
   PitcherEventName2["UPDATE_LOCATION"] = "update_location";
@@ -2784,6 +2955,13 @@ var PitcherEventName = /* @__PURE__ */ ((PitcherEventName2) => {
   PitcherEventName2["CANVAS_PAGE_PREVIOUS_REQUESTED"] = "canvas_page_previous_requested";
   PitcherEventName2["CANVAS_OPEN_REQUESTED"] = "canvas_open_requested";
   PitcherEventName2["CANVAS_CLOSE_REQUESTED"] = "canvas_close_requested";
+  PitcherEventName2["ROUTE_CHANGE_REQUESTED"] = "route_change_requested";
+  PitcherEventName2["ITEM_SHAREBOX_STATUS_REQUESTED"] = "item_sharebox_status_requested";
+  PitcherEventName2["ITEM_SHAREBOX_STATUS_UPDATED"] = "item_sharebox_status_updated";
+  PitcherEventName2["ITEM_SHAREBOX_ADD_REQUESTED"] = "item_sharebox_add_requested";
+  PitcherEventName2["ITEM_SHAREBOX_ADD_COMPLETED"] = "item_sharebox_add_completed";
+  PitcherEventName2["SYNC_BADGE_VALUE_REPORTED"] = "sync_badge_value_reported";
+  PitcherEventName2["PEER_CONNECTIVITY_EVENT"] = "peer_connectivity_event";
   return PitcherEventName2;
 })(PitcherEventName || {});
 var PitcherBroadcastedEventName = /* @__PURE__ */ ((PitcherBroadcastedEventName2) => {
@@ -2795,6 +2973,7 @@ var PitcherBroadcastedEventName = /* @__PURE__ */ ((PitcherBroadcastedEventName2
   PitcherBroadcastedEventName2["CANVAS_PREVIOUS_BUTTON_CLICKED"] = "canvas_previous_button_clicked";
   PitcherBroadcastedEventName2["CANVAS_OPENED"] = "canvas_opened";
   PitcherBroadcastedEventName2["CANVAS_CLOSED"] = "canvas_closed";
+  PitcherBroadcastedEventName2["ROUTE_CHANGED"] = "route_changed";
   return PitcherBroadcastedEventName2;
 })(PitcherBroadcastedEventName || {});
 var PitcherExternalEventName = /* @__PURE__ */ ((PitcherExternalEventName2) => {
@@ -2815,6 +2994,9 @@ function assert(exp, message) {
 const defaultSkipKeys = [
   "id__in",
   "tags__in",
+  "tags__not_in",
+  "template__id",
+  "template__id__in",
   "modified_at__gtr",
   "created_at__gtr",
   "end_at__lt",
@@ -3154,6 +3336,32 @@ const onlineRestApiHandlers = {
     const { canvas_id, ...restParams } = params;
     const res = await http.get(`/canvases/${canvas_id}/recommended_files`, { params: restParams });
     return res;
+  },
+  get_collaborations: async (params) => {
+    check();
+    const res = await http.get("/collaborations", { params: pickNonNullish(params) });
+    return res;
+  },
+  create_collaboration: async (params) => {
+    check();
+    const res = await http.post("/collaborations", params);
+    return res;
+  },
+  delete_collaboration: async (params) => {
+    check();
+    const { collaboration_id } = params;
+    const res = await http.delete(`/collaborations/${collaboration_id}`);
+    return res;
+  },
+  get_instance_memberships: async (params) => {
+    check();
+    const res = await http.get("/instance-memberships", { params: pickNonNullish(params) });
+    return res;
+  },
+  get_content_distribution_groups: async (params) => {
+    check();
+    const res = await http.get("/content-distribution-groups", { params: pickNonNullish(params) });
+    return res;
   }
 };
 
@@ -3171,6 +3379,15 @@ function getTopPitcherWindow(current = window) {
 }
 
 const TRUNCATE_LENGTH_TRIGGER = 10;
+const RAW_PAYLOAD_METHODS = [
+  "crm_create",
+  "crm_upsert",
+  "crm_smart_query",
+  "crm_smart_object_metadata",
+  "crm_smart_object_validation_rules",
+  "crm_smart_upsert_objects",
+  "crm_smart_delete_objects"
+];
 function updateOnlineHandlersEnv(env) {
   env && setEnv(env);
 }
@@ -3236,7 +3453,8 @@ class LowLevelApi extends EventEmitter {
           throw new Error("unsupported response status");
         }
       };
-      const payload = cloneDeep(snakeCaseKeys(body));
+      const shouldSkipSnakeCase = RAW_PAYLOAD_METHODS.includes(type);
+      const payload = shouldSkipSnakeCase ? cloneDeep(body) : cloneDeep(snakeCaseKeys(body));
       this.callbacks[id] = {
         dispatched_at: Date.now(),
         type,
@@ -3380,6 +3598,24 @@ function createHighLevelApi(options) {
      *   })
      */
     broadcast: (event) => API.request("broadcast", event),
+    /**
+     * Broadcast an event to webviews only (iOS only).
+     * @param {PitcherEvent} event - The event to broadcast.
+     *
+     * @example
+     * usePitcherApi()
+     *   .broadcastToWebviews({
+     *     type: "canvas_updated",
+     *     body: { context: { myContextProperty: 'test' } },
+     *   })
+     *   .then(function (result) {
+     *     useUi().toast({
+     *       message: "Canvas Populated.",
+     *       type: "info",
+     *     })
+     *   })
+     */
+    broadcastToWebviews: (event) => API.request("broadcast_to_webviews", event),
     /**
      * Subscribe to updates.
      *
@@ -3412,6 +3648,7 @@ const UI_API_METHOD_TYPES = {
   UI_UPDATE_CANVAS: "ui_update_canvas",
   UI_PRINT_CANVAS: "ui_print_canvas",
   UI_OPEN_CANVAS_OVERLAY: "ui_open_canvas_overlay",
+  UI_OPEN_COLLECTION_PLAYER_OVERLAY: "ui_open_collection_player_overlay",
   UI_SELECT_COLLECTION_PLAYER_CONTENT: "ui_select_collection_player_content",
   UI_SELECT_AGENDA_CONTENT: "ui_select_agenda_content",
   UI_UPDATE_LOCATION: "ui_update_location",
@@ -3560,6 +3797,10 @@ async function openCanvasOverlay$1(payload) {
   const pr = await usePostRobot();
   await pr.send(window.parent, UI_API_METHOD_TYPES.UI_OPEN_CANVAS_OVERLAY, payload);
 }
+async function openCollectionPlayerOverlay$1(payload) {
+  const pr = await usePostRobot();
+  await pr.send(window.parent, UI_API_METHOD_TYPES.UI_OPEN_COLLECTION_PLAYER_OVERLAY, payload);
+}
 async function selectCanvases$1(payload = {}) {
   const pr = await usePostRobot();
   const response = await pr.send(window.parent, UI_API_METHOD_TYPES.UI_SELECT_CANVASES, payload);
@@ -3576,6 +3817,7 @@ const canvasUi = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	closeCanvasDrawer,
 	closeCanvasSectionExecution,
 	openCanvasOverlay: openCanvasOverlay$1,
+	openCollectionPlayerOverlay: openCollectionPlayerOverlay$1,
 	printCanvas,
 	selectCanvases: selectCanvases$1,
 	updateCanvas: updateCanvas$1
@@ -3703,6 +3945,7 @@ const ADMIN_API_METHOD_TYPES = {
   GET_CANVAS: "admin_get_canvas",
   GET_CANVASES: "admin_get_canvases",
   OPEN_CANVAS_OVERLAY: "admin_open_canvas_overlay",
+  OPEN_COLLECTION_PLAYER_OVERLAY: "admin_open_collection_player_overlay",
   GET_ENV: "admin_get_env",
   GET_FILE: "admin_get_file",
   OPEN: "admin_open_file_overlay",
@@ -3764,6 +4007,10 @@ async function openCanvasOverlay(payload) {
   const pr = await usePostRobot();
   await pr.send(window.parent, ADMIN_API_METHOD_TYPES.OPEN_CANVAS_OVERLAY, payload);
 }
+async function openCollectionPlayerOverlay(payload) {
+  const pr = await usePostRobot();
+  await pr.send(window.parent, ADMIN_API_METHOD_TYPES.OPEN_COLLECTION_PLAYER_OVERLAY, payload);
+}
 async function selectCanvases(payload = {}) {
   const pr = await usePostRobot();
   const response = await pr.send(window.parent, ADMIN_API_METHOD_TYPES.SELECT_CANVASES, payload);
@@ -3776,6 +4023,7 @@ const canvasAdmin = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.definePropert
 	getCanvas,
 	getCanvases,
 	openCanvasOverlay,
+	openCollectionPlayerOverlay,
 	selectCanvases,
 	updateCanvas
 }, Symbol.toStringTag, { value: 'Module' }));
@@ -3791,7 +4039,7 @@ const metadataTemplatesAdmin = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.de
 	getInstanceMetadataTemplates
 }, Symbol.toStringTag, { value: 'Module' }));
 
-async function getAppConfig(payload) {
+async function getAppConfig$1(payload) {
   const pr = await usePostRobot();
   const response = await pr.send(window.parent, ADMIN_API_METHOD_TYPES.GET_APP_CONFIG, payload);
   return response.data;
@@ -3818,7 +4066,7 @@ async function close$1() {
 const filesAdmin = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	__proto__: null,
 	close: close$1,
-	getAppConfig,
+	getAppConfig: getAppConfig$1,
 	getFile: getFile$1,
 	getFiles,
 	open
@@ -3890,6 +4138,7 @@ const DSR_API_TYPES = {
 const DSR_API_METHOD_TYPES = {
   GET_ENV: "dsr_get_env",
   GET_FILE: "dsr_get_file",
+  GET_APP_CONFIG: "dsr_get_app_config",
   CLOSE: "dsr_close",
   DSR_EMBEDDABLE_READY: "dsr_embeddable_ready"
 };
@@ -3925,10 +4174,16 @@ async function getFile(payload) {
   const response = await pr.send(window.parent, DSR_API_METHOD_TYPES.GET_FILE, payload);
   return response.data;
 }
+async function getAppConfig(payload) {
+  const pr = await usePostRobot();
+  const response = await pr.send(window.parent, DSR_API_METHOD_TYPES.GET_APP_CONFIG, payload ?? {});
+  return response.data;
+}
 
 const filesDsr = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	__proto__: null,
 	close,
+	getAppConfig,
 	getFile
 }, Symbol.toStringTag, { value: 'Module' }));
 
@@ -3944,6 +4199,179 @@ const dsr = {
   ...filesDsr
 };
 
+const PEER_CONNECTIVITY_EVENT = "peer_connectivity_event";
+const PeerConnectivityActions = {
+  CANVAS_PAGE_NEXT: "canvas.navigate.next",
+  CANVAS_PAGE_PREVIOUS: "canvas.navigate.previous",
+  CANVAS_OPEN: "canvas.open",
+  CANVAS_CLOSE: "canvas.close",
+  ROUTE_CHANGE: "route.change",
+  FILE_OPEN: "file.open",
+  FILE_CLOSE: "file.close",
+  BROWSER_FOLDER_OPEN: "browser.folder.open"
+};
+const DEFAULT_PEER_CONNECTIVITY_VERSION = 1;
+const PEER_CONNECTIVITY_HANDLER_MATCH_ALL = "*";
+
+const handlers = /* @__PURE__ */ new Map();
+let unsubscribeNativeListener = null;
+let peerConnectivitySupportPromise = null;
+function generateCorrelationId() {
+  const cryptoApi = globalThis.crypto;
+  if (cryptoApi?.randomUUID) {
+    return cryptoApi.randomUUID();
+  }
+  return `peer-${Date.now().toString(16)}-${Math.random().toString(16).slice(2)}`;
+}
+function normalizeEventPayload(payload, defaults) {
+  const metadata = payload.metadata ?? {};
+  const normalized = {
+    version: payload.version ?? defaults?.version ?? DEFAULT_PEER_CONNECTIVITY_VERSION,
+    action: payload.action,
+    context: payload.context ?? defaults?.context,
+    data: payload.data ?? defaults?.data,
+    metadata: {
+      correlationId: metadata.correlationId ?? defaults?.metadata?.correlationId ?? generateCorrelationId(),
+      source: metadata.source ?? defaults?.metadata?.source ?? "web",
+      timestamp: metadata.timestamp ?? defaults?.metadata?.timestamp ?? Date.now(),
+      extras: {
+        ...defaults?.metadata?.extras ?? {},
+        ...metadata.extras ?? {}
+      }
+    }
+  };
+  return normalized;
+}
+function addHandler(action, handler) {
+  const key = action || PEER_CONNECTIVITY_HANDLER_MATCH_ALL;
+  const handlerSet = handlers.get(key) ?? /* @__PURE__ */ new Set();
+  handlerSet.add(handler);
+  handlers.set(key, handlerSet);
+}
+function removeHandler(action, handler) {
+  const handlerSet = handlers.get(action);
+  if (!handlerSet) {
+    return;
+  }
+  handlerSet.delete(handler);
+  if (!handlerSet.size) {
+    handlers.delete(action);
+  }
+  if (!handlers.size) {
+    teardownNativeListener();
+  }
+}
+async function ensureNativeListener() {
+  if (unsubscribeNativeListener) {
+    return;
+  }
+  const api = usePitcherApi();
+  const listener = (event) => {
+    try {
+      const normalized = normalizeEventPayload(event, {
+        metadata: {
+          correlationId: generateCorrelationId(),
+          source: "native",
+          timestamp: Date.now(),
+          extras: {}
+        }
+      });
+      dispatchEvent(normalized);
+    } catch (error) {
+      console.error("[peer-connectivity] Failed to handle native event:", error);
+    }
+  };
+  api.on(PitcherEventName.PEER_CONNECTIVITY_EVENT, listener);
+  unsubscribeNativeListener = () => {
+    api.off(PitcherEventName.PEER_CONNECTIVITY_EVENT, listener);
+    unsubscribeNativeListener = null;
+  };
+}
+function teardownNativeListener() {
+  if (unsubscribeNativeListener) {
+    unsubscribeNativeListener();
+    unsubscribeNativeListener = null;
+  }
+}
+function dispatchEvent(event) {
+  const specificHandlers = handlers.get(event.action);
+  const wildcardHandlers = handlers.get(PEER_CONNECTIVITY_HANDLER_MATCH_ALL);
+  if (!specificHandlers && !wildcardHandlers) {
+    return;
+  }
+  const payload = Object.freeze(event);
+  specificHandlers?.forEach((handler) => {
+    try {
+      handler(payload);
+    } catch (error) {
+      console.error(`[peer-connectivity] Handler error for action "${event.action}":`, error);
+    }
+  });
+  wildcardHandlers?.forEach((handler) => {
+    try {
+      handler(payload);
+    } catch (error) {
+      console.error("[peer-connectivity] Handler error for wildcard action:", error);
+    }
+  });
+}
+async function isPeerConnectivitySupported() {
+  if (!peerConnectivitySupportPromise) {
+    const api = usePitcherApi();
+    peerConnectivitySupportPromise = api.getEnv().then((env) => env.mode === "IOS").catch((error) => {
+      console.error("[peer-connectivity] Failed to determine environment support:", error);
+      return false;
+    });
+  }
+  return peerConnectivitySupportPromise;
+}
+function normalizeActions(actionOrActions) {
+  return Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions];
+}
+function registerPeerConnectivityHandler(actionOrActions, handler) {
+  normalizeActions(actionOrActions).forEach((action) => {
+    addHandler(action, handler);
+  });
+  ensureNativeListener().catch((error) => {
+    console.error("[peer-connectivity] Failed to register native listener:", error);
+  });
+  return () => {
+    normalizeActions(actionOrActions).forEach((action) => {
+      removeHandler(action, handler);
+    });
+  };
+}
+async function sendPeerConnectivityEvent(payload, options) {
+  if (!payload?.action) {
+    console.warn("[peer-connectivity] Attempted to send an event without action");
+    return;
+  }
+  if (options?.isFeatureEnabled === false) {
+    return;
+  }
+  const isSupported = await isPeerConnectivitySupported();
+  if (!isSupported) {
+    return;
+  }
+  const api = usePitcherApi();
+  const normalizedPayload = normalizeEventPayload(payload, {
+    metadata: {
+      correlationId: generateCorrelationId(),
+      source: "web",
+      timestamp: Date.now(),
+      extras: {}
+    }
+  });
+  try {
+    await api.broadcast({
+      type: PitcherEventName.PEER_CONNECTIVITY_EVENT,
+      body: normalizedPayload
+    });
+  } catch (error) {
+    console.error("[peer-connectivity] Failed to send event:", error);
+  }
+}
+
 let highLevelApi;
 let prevOptions;
 function usePitcherApi(options) {
@@ -3989,7 +4417,7 @@ function useApi(options) {
     case "admin":
       return useAdmin();
     case "dsr":
-      return useDsr();
+      return { ...useDsr(), broadcast: usePitcherApi().broadcast };
     case "impact":
       return usePitcherApi(options);
     // first level (slotty and custom UIs)
@@ -4000,5 +4428,5 @@ function useApi(options) {
 
 window.postRobot = pr;
 
-export { ADMIN_API_METHOD_TYPES, ADMIN_API_TYPES, ADMIN_MESSAGE, ADMIN_MESSAGE_TYPES, DSR_API_METHOD_TYPES, DSR_API_TYPES, DSR_MESSAGE, DSR_MESSAGE_TYPES, PITCHER_EVENT, PitcherBroadcastedEventName, PitcherEventName, PitcherExternalEventName, PitcherMessageType, PitcherResponseStatus, UI_API_METHOD_TYPES, UI_MESSAGE, UI_MESSAGE_TYPES, UI_NATIVE_MESSAGE_TYPES, getAvailableApis, highLevelApi, useAdmin, useApi, useDsr, usePitcherApi, useUi };
+export { ADMIN_API_METHOD_TYPES, ADMIN_API_TYPES, ADMIN_MESSAGE, ADMIN_MESSAGE_TYPES, DEFAULT_PEER_CONNECTIVITY_VERSION, DSR_API_METHOD_TYPES, DSR_API_TYPES, DSR_MESSAGE, DSR_MESSAGE_TYPES, PEER_CONNECTIVITY_EVENT, PEER_CONNECTIVITY_HANDLER_MATCH_ALL, PITCHER_EVENT, PeerConnectivityActions, PitcherBroadcastedEventName, PitcherEventName, PitcherExternalEventName, PitcherMessageType, PitcherResponseStatus, UI_API_METHOD_TYPES, UI_MESSAGE, UI_MESSAGE_TYPES, UI_NATIVE_MESSAGE_TYPES, getAvailableApis, highLevelApi, registerPeerConnectivityHandler, sendPeerConnectivityEvent, useAdmin, useApi, useDsr, usePitcherApi, useUi };
 //# sourceMappingURL=js-api.esm.js.map