@pitcher/js-api 1.26.0 → 1.27.0

package/impact-js-api.spec.json

@@ -1,5 +1,5 @@
 {
-  "version": "19.203.1",
+  "version": "2026.6.2-101643",
   "methods": {
     "on": {
       "description": "Subscribe to a given event type by its key."
@@ -28,6 +28,9 @@
     "broadcast": {
       "description": "Broadcast an event to CatalogIQ."
     },
+    "broadcast_to_webviews": {
+      "description": "Broadcast an event to webviews only (iOS only)."
+    },
     "subscribe": {
       "description": "Subscribe to updates."
     },
@@ -70,36 +73,15 @@
     "update_my_user": {
       "description": ""
     },
-    "get_events": {
-      "description": ""
-    },
-    "create_event": {
-      "description": ""
-    },
-    "update_event": {
-      "description": ""
-    },
-    "delete_event": {
+    "is_offline": {
       "description": ""
     },
-    "get_favorites": {
-      "description": "Get a list of favorites"
-    },
-    "create_favorite": {
-      "description": "Create a favorite"
-    },
-    "delete_favorite": {
-      "description": "Delete a favorite"
-    },
     "submit_user_feedback": {
       "description": "Submit user feedback"
     },
     "get_files": {
       "description": ""
     },
-    "get_recent_files": {
-      "description": ""
-    },
     "download_file": {
       "description": ""
     },
@@ -124,6 +106,9 @@
     "select_device_file": {
       "description": "Dispatches iOS native file selector and returns the selected file."
     },
+    "delete_local_file": {
+      "description": "Deletes a local file on iOS devices from Pitcher Folders."
+    },
     "get_file_revisions": {
       "description": ""
     },
@@ -178,26 +163,38 @@
     "crm_query": {
       "description": ""
     },
+    "crm_query_adaptive": {
+      "description": "Executes a CRM query with automatic iOS/SmartStore adaptation."
+    },
     "crm_smart_query": {
-      "description": "Execute a SmartStore query against local CRM data. iOS only."
+      "description": "Executes a SmartStore query against local CRM data (iOS only)."
+    },
+    "crm_smart_object_metadata": {
+      "description": "Retrieves metadata for a CRM smart object (iOS only)."
     },
     "crm_smart_upsert_objects": {
-      "description": "Upsert CRM objects into local CRM data using SmartStore. iOS only."
+      "description": "Upserts CRM objects into local CRM data (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."
+      "description": "Retrieves validation rules for a CRM smart object (iOS only)."
     },
     "crm_smart_object_layout": {
-      "description": "Retrieve layout information for a CRM smart object. iOS only."
-    },
-    "crm_layout": {
-      "description": "Retrieve layout information for a CRM object. Web only."
+      "description": "Retrieves layout information for a CRM smart object (iOS only)."
     },
     "crm_smart_delete_objects": {
-      "description": "Delete CRM objects from local CRM data using SmartStore. iOS only."
+      "description": "Deletes CRM objects from local CRM data (iOS only)."
+    },
+    "crm_create": {
+      "description": "Creates new records in CRM (Web only)."
+    },
+    "crm_upsert": {
+      "description": "Upserts records in CRM (Web only)."
+    },
+    "crm_describe": {
+      "description": "Retrieves metadata/describe for a CRM object (Web only)."
+    },
+    "crm_layout": {
+      "description": "Retrieves layout information for a CRM object (Web only)."
     },
     "search": {
       "description": ""
@@ -205,6 +202,9 @@
     "share": {
       "description": "Dispatch iOS sharing dialog."
     },
+    "show_peer_session": {
+      "description": "Show peer session dialog with button coordinates, for local peer sharing feature."
+    },
     "trigger_non_files_sync": {
       "description": "Dispatches iOS only sync method for non-files."
     },
@@ -234,6 +234,9 @@
     },
     "open_web_view_always_on_top": {
       "description": ""
+    },
+    "show_syncbox": {
+      "description": ""
     }
   }
 }

package/js-api.esm.d.ts

@@ -1,2 +1 @@
-export * from './lib/sdk/main.umd-esm'
-export {}
+export * from './src/lib/sdk/main.umd-esm'

package/js-api.esm.js

@@ -33,7 +33,7 @@ var hasRequiredPostRobot$1;
 function requirePostRobot$1 () {
 	if (hasRequiredPostRobot$1) return postRobot$1.exports;
 	hasRequiredPostRobot$1 = 1;
-	(function (module, exports$1) {
+	(function (module, exports) {
 		!function(root, factory) {
 		    module.exports = factory() ;
 		}("undefined" != typeof self ? self : postRobot, (function() {
@@ -52,17 +52,17 @@ function requirePostRobot$1 () {
 		        }
 		        __webpack_require__.m = modules;
 		        __webpack_require__.c = installedModules;
-		        __webpack_require__.d = function(exports$1, name, getter) {
-		            __webpack_require__.o(exports$1, name) || Object.defineProperty(exports$1, name, {
+		        __webpack_require__.d = function(exports, name, getter) {
+		            __webpack_require__.o(exports, name) || Object.defineProperty(exports, name, {
 		                enumerable: true,
 		                get: getter
 		            });
 		        };
-		        __webpack_require__.r = function(exports$1) {
-		            "undefined" != typeof Symbol && Symbol.toStringTag && Object.defineProperty(exports$1, Symbol.toStringTag, {
+		        __webpack_require__.r = function(exports) {
+		            "undefined" != typeof Symbol && Symbol.toStringTag && Object.defineProperty(exports, Symbol.toStringTag, {
 		                value: "Module"
 		            });
-		            Object.defineProperty(exports$1, "__esModule", {
+		            Object.defineProperty(exports, "__esModule", {
 		                value: true
 		            });
 		        };
@@ -2380,6 +2380,125 @@ const index = /*#__PURE__*/_mergeNamespaces({
 	default: pr
 }, [postRobotExports]);
 
+function resolvePiaSearchMode(flag) {
+  if (flag?.mode === "off" || flag?.mode === "on_device" || flag?.mode === "online") return flag.mode;
+  if (flag?.enabled === true) return "online";
+  return "off";
+}
+
+const PIA_SEARCH_ROUTE = "/core/api/protected/pia-prepare/pia-search";
+const CAPABILITIES_TIMEOUT_MS = 3e3;
+const ON_DEVICE_MAX_TOKENS = 512;
+const WEB_CAPABILITIES = {
+  available: true,
+  offline: false,
+  runtime: "bedrock-online"
+};
+function withTimeout(promise, ms, label) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms);
+    promise.then(
+      (value) => {
+        clearTimeout(timer);
+        resolve(value);
+      },
+      (error) => {
+        clearTimeout(timer);
+        reject(error);
+      }
+    );
+  });
+}
+function normalizeOrigin(domain) {
+  return domain.startsWith("http") ? domain : `https://${domain}`;
+}
+function apiOriginFromEnv(env) {
+  const claimDomain = env?.pitcher?.token_claims?.["https://pitcher.com/claims/urls"]?.custom_domain;
+  if (typeof claimDomain === "string" && claimDomain.length > 0) return normalizeOrigin(claimDomain);
+  const orgDomain = env?.pitcher?.organization?.metadata?.custom_domain;
+  if (typeof orgDomain === "string" && orgDomain.length > 0) return normalizeOrigin(orgDomain);
+  throw new Error("piaSearchAnswer: no customer domain found in env (token_claims / organization metadata)");
+}
+function buildOnDevicePrompt(query, contextText) {
+  const context = typeof contextText === "string" && contextText.trim().length > 0 ? contextText.trim() : "No content context was provided.";
+  return `You are PIA, a sales content assistant. Answer the rep's question using ONLY the CONTEXT below — do not invent content that is not in it.
+
+CONTEXT:
+${context}
+
+QUESTION: ${query}
+
+Answer concisely in plain text. If the context does not contain the answer, say you could not find it in the available content.`;
+}
+async function aiGetCapabilities() {
+  const env = await highLevelApi.API.request("get_env");
+  if (env?.mode === "IOS") {
+    return highLevelApi.API.request("ai.get_capabilities");
+  }
+  return { ...WEB_CAPABILITIES };
+}
+function aiComplete(payload) {
+  if (!payload || typeof payload.prompt !== "string" || payload.prompt.trim() === "") {
+    return Promise.reject(new Error("prompt is required and must be a non-empty string"));
+  }
+  return highLevelApi.API.request("ai.complete", payload);
+}
+async function piaSearchAnswer(payload) {
+  if (!payload || typeof payload.query !== "string" || payload.query.trim() === "") {
+    return Promise.reject(new Error("query is required and must be a non-empty string"));
+  }
+  const env = await highLevelApi.API.request("get_env");
+  const mode = resolvePiaSearchMode(env?.launch_darkly?.enable_hub_pia_search);
+  if (mode === "off") {
+    throw new Error('pia_search_disabled: enable_hub_pia_search resolves to mode "off"');
+  }
+  if (mode === "on_device" && env?.mode === "IOS") {
+    try {
+      const capabilities = await withTimeout(
+        highLevelApi.API.request("ai.get_capabilities"),
+        CAPABILITIES_TIMEOUT_MS,
+        "ai.get_capabilities"
+      );
+      if (capabilities?.available) {
+        const completion = await aiComplete({
+          prompt: buildOnDevicePrompt(payload.query, payload.context_text),
+          max_tokens: payload.max_tokens ?? ON_DEVICE_MAX_TOKENS
+        });
+        return { answer: completion.text, source: "on_device" };
+      }
+    } catch (error) {
+      console.warn("[piaSearchAnswer] on-device path unavailable, falling back to online:", error);
+    }
+  }
+  const instanceId = payload.instance_id || env?.pitcher?.instance?.id;
+  if (!instanceId) {
+    throw new Error("piaSearchAnswer: instance_id could not be resolved from the payload or env");
+  }
+  const response = await fetch(`${apiOriginFromEnv(env)}${PIA_SEARCH_ROUTE}`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${env.pitcher.access_token}`
+    },
+    body: JSON.stringify({
+      query: payload.query,
+      instance_id: instanceId,
+      ...Array.isArray(payload.file_ids) && payload.file_ids.length > 0 && { file_ids: payload.file_ids }
+    })
+  });
+  if (!response.ok) {
+    throw new Error(`pia_search ${response.status}`);
+  }
+  const data = await response.json();
+  const output = data?.pia_search ?? {};
+  return {
+    answer: typeof output.answer === "string" ? output.answer : "",
+    cited_file_ids: Array.isArray(output.cited_file_ids) ? output.cited_file_ids : [],
+    ...output.confidence && { confidence: output.confidence },
+    source: "online"
+  };
+}
+
 function open$2(payload = {}) {
   return this.API.request("open", payload);
 }
@@ -2428,6 +2547,9 @@ function updateCanvasIndicators(payload) {
 function getCanvas$1(payload) {
   return this.API.request("get_canvas", payload);
 }
+function getSectionsByIds(payload) {
+  return this.API.request("get_canvas_sections_by_ids", payload);
+}
 function shareCanvas(payload) {
   return this.API.request("share_canvas", payload);
 }
@@ -2451,9 +2573,6 @@ function getFiles$1(payload) {
   }
   return this.API.request("get_files", p);
 }
-function getRecentFiles(payload) {
-  return this.API.request("get_recent_files", payload || {});
-}
 function downloadFile(payload) {
   return this.API.request("download_file", payload);
 }
@@ -3337,16 +3456,6 @@ function patchCoreFolder(id, payload) {
   });
 }
 
-function getFavorites(payload) {
-  return this.API.request("get_favorites", payload);
-}
-function createFavorite(payload) {
-  return this.API.request("create_favorite", payload);
-}
-function deleteFavorite(payload) {
-  return this.API.request("delete_favorite", payload);
-}
-
 function notify(payload) {
   if (!payload.type) {
     payload.type = "native";
@@ -3396,10 +3505,11 @@ function assignCanvasTheme(payload) {
 
 const modules = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	__proto__: null,
+	aiComplete,
+	aiGetCapabilities,
 	assignCanvasTheme,
 	close: close$2,
 	createCanvas: createCanvas$1,
-	createFavorite,
 	createFile,
 	createFolder,
 	crmCreate,
@@ -3415,7 +3525,6 @@ const modules = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	crmSmartUpsertObjects,
 	crmUpsert,
 	deleteCanvas,
-	deleteFavorite,
 	deleteFile,
 	deleteFolder,
 	deleteLocalFile,
@@ -3428,7 +3537,6 @@ const modules = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	getCanvases: getCanvases$1,
 	getCoreFolders,
 	getEnv: getEnv$2,
-	getFavorites,
 	getFile: getFile$2,
 	getFileRevisionData,
 	getFileRevisions,
@@ -3437,7 +3545,7 @@ const modules = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	getFolders,
 	getInstanceMetadataTemplates: getInstanceMetadataTemplates$1,
 	getLanguages,
-	getRecentFiles,
+	getSectionsByIds,
 	getThemes,
 	getUsers: getUsers$1,
 	isOffline,
@@ -3447,6 +3555,7 @@ const modules = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
 	openExternalUrl,
 	openWebViewAlwaysOnTop,
 	patchCoreFolder,
+	piaSearchAnswer,
 	query,
 	refreshAccessToken,
 	refreshServiceToken,
@@ -3544,6 +3653,7 @@ var PitcherResponseStatus = /* @__PURE__ */ ((PitcherResponseStatus2) => {
 })(PitcherResponseStatus || {});
 var PitcherEventName = /* @__PURE__ */ ((PitcherEventName2) => {
   PitcherEventName2["ENV_CHANGED"] = "env_changed";
+  PitcherEventName2["ACCESS_TOKEN_RENEWED"] = "access_token_renewed";
   PitcherEventName2["PHOTOS_CAPTURED"] = "photos_captured";
   PitcherEventName2["GLOBAL_PHOTO_CAPTURED"] = "global_photo_captured";
   PitcherEventName2["FILE_DOWNLOADED"] = "file_downloaded";
@@ -3581,7 +3691,6 @@ var PitcherEventName = /* @__PURE__ */ ((PitcherEventName2) => {
 var PitcherBroadcastedEventName = /* @__PURE__ */ ((PitcherBroadcastedEventName2) => {
   PitcherBroadcastedEventName2["UI_SHOW_MODAL"] = "ui:show-modal";
   PitcherBroadcastedEventName2["UI_HIDE_MODAL"] = "ui:hide-modal";
-  PitcherBroadcastedEventName2["FAVORITES_CHANGED"] = "favorites:changed";
   PitcherBroadcastedEventName2["FILE_DOWNLOAD"] = "file:download";
   PitcherBroadcastedEventName2["CANVAS_NEXT_BUTTON_CLICKED"] = "canvas_next_button_clicked";
   PitcherBroadcastedEventName2["CANVAS_PREVIOUS_BUTTON_CLICKED"] = "canvas_previous_button_clicked";
@@ -3594,6 +3703,7 @@ var PitcherExternalEventName = /* @__PURE__ */ ((PitcherExternalEventName2) => {
   PitcherExternalEventName2["CREATE_AND_OPEN_CANVAS"] = "create_and_open_canvas";
   PitcherExternalEventName2["OPEN_CANVAS"] = "open_canvas";
   PitcherExternalEventName2["START_CALL"] = "start_call";
+  PitcherExternalEventName2["SELECT_ACCOUNT"] = "select_account";
   return PitcherExternalEventName2;
 })(PitcherExternalEventName || {});
 
@@ -3924,6 +4034,20 @@ const onlineRestApiHandlers = {
     const res = await http.get(`/canvases/${params.id}`, { params: restParams });
     return res;
   },
+  // Lazy section loading companion: batch-hydrate section bodies for a canvas
+  // that was fetched as a shell (`?lazy_sections=true`). Hits the same Django
+  // /api/v1 base as get_canvas. Returns { sections: CanvasSection[] }.
+  get_canvas_sections_by_ids: async (params) => {
+    check();
+    const res = await http.post("/canvases/sections/by-ids", {
+      canvas_id: params.canvas_id,
+      section_ids: params.section_ids,
+      ...params.exclude_drafts !== void 0 && { exclude_drafts: params.exclude_drafts },
+      ...params.include_expired_files !== void 0 && { include_expired_files: params.include_expired_files },
+      ...params.include_pending_files !== void 0 && { include_pending_files: params.include_pending_files }
+    });
+    return res;
+  },
   create_canvas: async (params) => {
     check();
     const res = await http.post("/canvases", { ...params, instance_id: env.pitcher.instance.id });
@@ -4080,6 +4204,7 @@ class LowLevelApi extends EventEmitter {
         } else if (res.response.status === "error") {
           if (this.options.errorLogger) {
             this.options.errorLogger({
+              type: res.request.type,
               message: `Pitcher JS API call failure: ${res.request.type}`,
               js_api_response: JSON.stringify(truncateObject(res, 3, TRUNCATE_LENGTH_TRIGGER))
             });