@pitcher/js-api 1.26.0-beta.9 → 1.26.1

package/lib/composables/useMetadataFilters.d.ts

@@ -1,5 +1,5 @@
 import { MetadataTemplateField, MetadataTemplateOption } from '../../types/openapi';
-export declare function getComponentNameByFilterType(type: string): "CSearchFilter" | "CSelectFilter" | "CDateRangeFilter";
+export declare function getComponentNameByFilterType(type: string): "CDateRangeFilter" | "CSelectFilter" | "CSearchFilter";
 export default function useMetadataFilters(t: (input: string) => string): {
     getBooleanOptions: (availableValues?: Array<string | boolean | number>) => {
         label: string;

package/lib/composables/useMetadataSearch.d.ts

@@ -11,7 +11,7 @@ interface UseMetadataSearchOptions {
     includeSearchTermAsOption?: boolean;
 }
 export default function useMetadataSearch(options?: UseMetadataSearchOptions): {
-    handleFetch: (searchTerm: string, entity: MetadataFilterRequest["entity"], { includeNameSearch, includeDraftValues, isSection, isTemplate, isBlock, key, ownerId, searchMode, threshold, fetchAllUnique, contentType, }?: {
+    handleFetch: (searchTerm: string, entity: MetadataFilterRequest["entity"], { includeNameSearch, includeDraftValues, isSection, isTemplate, isBlock, key, ownerId, searchMode, threshold, fetchAllUnique, contentType, tagsNotIn, and, }?: {
         includeNameSearch?: boolean;
         includeDraftValues?: boolean;
         isSection?: boolean;
@@ -23,8 +23,13 @@ export default function useMetadataSearch(options?: UseMetadataSearchOptions): {
         threshold?: number;
         fetchAllUnique?: boolean;
         contentType?: string[];
+        tagsNotIn?: string[];
+        and?: Array<{
+            key: string;
+            value: string;
+        }>;
     }) => Promise<StyledAutoCompleteOption[]>;
-    fetchUniqueValues: (entity: MetadataFilterRequest["entity"], { includeDraftValues, isSection, isTemplate, isBlock, key, ownerId, limit, and, }?: {
+    fetchUniqueValues: (entity: MetadataFilterRequest["entity"], { includeDraftValues, isSection, isTemplate, isBlock, key, ownerId, limit, and, tagsNotIn, }?: {
         includeDraftValues?: boolean;
         isSection?: boolean;
         isTemplate?: boolean;
@@ -36,6 +41,7 @@ export default function useMetadataSearch(options?: UseMetadataSearchOptions): {
             key: string;
             value: string;
         }>;
+        tagsNotIn?: string[];
     }) => Promise<MetadataUniqueValuesResponse>;
 };
 export {};

package/lib/composables/useMetadataTemplates.d.ts

@@ -242,5 +242,5 @@ export default function useMetadataTemplates(options?: UseMetadataTemplatesOptio
             email?: string | undefined;
         };
     } | null>;
-    processedMetadata: ComputedRef<Record<string, any>> | Ref<Record<string, any>, Record<string, any>>;
+    processedMetadata: Ref<Record<string, any>, Record<string, any>> | ComputedRef<Record<string, any>>;
 };

package/lib/composables/useSmartStore.d.ts

@@ -0,0 +1,25 @@
+import { Ref } from 'vue';
+import { PitcherEnv } from '../sdk/interfaces';
+/**
+ * Composable for SmartStore availability checks
+ *
+ * SmartStore is Salesforce Mobile SDK's local database for offline data access on iOS.
+ * It requires both iOS mode and the sfdc_offline_enabled LaunchDarkly flag to be enabled.
+ *
+ * @param env - Optional reactive environment object from app store (avoids redundant API calls)
+ *
+ * @example
+ * // With app store env (recommended - avoids API calls)
+ * const appStore = useAppStore()
+ * const { shouldUseSmartStore } = useSmartStore(appStore.env)
+ * const enabled = shouldUseSmartStore.value
+ *
+ * @example
+ * // Without env (for canvas-ui internal usage)
+ * const { generateTempSalesforceId } = useSmartStore()
+ * const tempId = generateTempSalesforceId('00U')
+ */
+export declare function useSmartStore(env?: Ref<PitcherEnv | null> | PitcherEnv | null): {
+    shouldUseSmartStore: import('vue').ComputedRef<boolean>;
+    generateTempSalesforceId: (objectPrefix: string) => string;
+};

package/lib/composables/useWindowEvents.d.ts

@@ -9,7 +9,7 @@ export type InactiveEventPayload = {
     file_id?: string;
     [key: string]: any;
 };
-export default function (track: (eventName: string, payload: any) => void, pitcherApi?: ReturnType<typeof usePitcherApi>): {
+export default function (track: (eventName: string, payload: any) => void, pitcherApi?: ReturnType<typeof usePitcherApi>, flushTrack?: (eventName: string, payload: any) => void): {
     registerInactiveEvent: ({ id, payload, enterEvent, exitEvent, type, }: {
         id: string;
         payload: InactiveEventPayload | ((type?: EventLifecycle) => InactiveEventPayload);

package/lib/main.lib.d.ts

@@ -19,6 +19,7 @@ export { default as CDropdown } from './components/CDropdown/CDropdown.vue';
 export { default as CErrorFullScreen } from './components/CError/CErrorFullScreen.vue';
 export { default as CFileThumbnail } from './components/CFileThumbnail/CFileThumbnail.vue';
 export { default as CFileAttributes } from './components/CFileAttributes/CFileAttributes.vue';
+export { default as CFolderTreeMultiPicker, type SelectedFolder, type PickerFolderNode } from './components/CFolderTreeMultiPicker/CFolderTreeMultiPicker.vue';
 export { default as CIcon, type Props as CIconProps } from './components/CIcon/CIcon.vue';
 export { default as CImage } from './components/CImage/CImage.vue';
 export { default as CInput } from './components/CInput/CInput.vue';
@@ -28,6 +29,12 @@ export { default as CProcessingOverlay } from './components/CProcessingOverlay/C
 export { default as CSearch } from './components/CSearch/CSearch.vue';
 export { default as CSearchOnClick } from './components/CSearch/CSearchOnClick.vue';
 export { default as CSearchOnClickWithSuggestions } from './components/CSearch/CSearchOnClickWithSuggestions.vue';
+export { default as CSideBar } from './components/CSideBar/CSideBar.vue';
+export { default as CSideBarDivider } from './components/CSideBar/CSideBarDivider.vue';
+export { default as CSideBarItem } from './components/CSideBar/CSideBarItem.vue';
+export { default as CSideBarLabel } from './components/CSideBar/CSideBarLabel.vue';
+export { default as CSideBarToggle } from './components/CSideBar/CSideBarToggle.vue';
+export type { NavItem } from './components/CSideBar/types';
 export { default as CSelect } from './components/CSelect/CSelect.vue';
 export { default as CTag } from './components/CTag/CTag.vue';
 export { default as CThemeEditor } from './components/CThemeEditor/CThemeEditor.vue';
@@ -77,6 +84,7 @@ export { default as CSavedCanvasesManagement } from './components/savedCanvases/
 export { default as CAssignedCanvasesManagement } from './components/assignedCanvases/CAssignedCanvasesManagement.vue';
 export { default as CAssignedCanvasesManagementToolbar } from './components/assignedCanvases/CAssignedCanvasesManagementToolbar.vue';
 export { default as useShareCanvas } from './components/savedCanvases/CSavedCanvasesManagementShareCanvas.use';
+export { getFreezeStatus, type FreezeStatus } from './components/savedCanvases/CSavedCanvasesManagement.use';
 export { default as CConfigEditor } from './components/CConfigEditor/CConfigEditor.vue';
 export { default as CTableInput } from './components/CTableInput/CTableInput.vue';
 export { default as CTableTag } from './components/CTableTag/CTableTag.vue';
@@ -88,6 +96,8 @@ export { default as CTable } from './components/CTable/CTable.vue';
 export { default as CEntitySelector } from './components/CEntitySelector/CEntitySelector.vue';
 export { default as CUsersGroupsAccessManage } from './components/CUsersGroupsAccessManage/CUsersGroupsAccessManage.vue';
 export { default as CFilesAccessManage } from './components/CFilesAccessManage/CFilesAccessManage.vue';
+export { default as CTemplateAccessManage } from './components/CTemplateAccessManage/CTemplateAccessManage.vue';
+export { default as CTemplateAccessInfo } from './components/CTemplateAccessInfo/CTemplateAccessInfo.vue';
 export { default as CGroupsAccessInfo } from './components/CGroupsAccessInfo/CGroupsAccessInfo.vue';
 export { default as CUsersAccessInfo } from './components/CUsersAccessInfo/CUsersAccessInfo.vue';
 export { default as CFilesAccessInfo } from './components/CFilesAccessInfo/CFilesAccessInfo.vue';
@@ -120,6 +130,7 @@ export { type CanvasBuilderProps, CanvasBuilderMode } from './apps/canvas-builde
 export { type FontAwesomeType } from './apps/canvas-builder/types/font-awesome.types';
 export { default as Browser } from './apps/browser/App.vue';
 export { type BrowserSectionType } from './apps/browser/stores/app';
+export type { BrowserAppProps, BrowserCustomFilterComponent } from './apps/browser/appTypes';
 export { default as ContentSelector } from './apps/content-selector/App.vue';
 export type { SelectedPage as ContentSelectorSelectedPage, SelectedFile as ContentSelectorSelectedFile, SelectedAsset as ContentSelectorSelectedAsset, SelectedExternalLink as ContentSelectorSelectedExternalLink, ContentSelectorSelectedItem, } from './apps/content-selector/stores/app';
 export { default as CanvasSelector } from './apps/canvas-selector/App.vue';
@@ -135,6 +146,7 @@ export * as agendaSelector from './apps/agenda-selector/export';
 export { default as useTheme } from './composables/useTheme';
 export { default as useThemeVars } from './composables/useThemeVars';
 export { default as useBindValidation } from './composables/useBindValidation';
+export { useSmartStore } from './composables/useSmartStore';
 export { default as useFileDisplayHelpers } from './composables/useFileDisplayHelpers';
 export { default as useFolderNameDescription } from './composables/useFolderNameDescription';
 export { default as useCanvasOverlay } from './composables/useCanvasOverlay';
@@ -142,8 +154,12 @@ export { default as useCollectionPlayerOverlay, type CollectionPlayerOverlay, }
 export { default as useInfiniteScroll } from './composables/useInfiniteScroll';
 export { default as useWindowEvents } from './composables/useWindowEvents';
 export { default as useConfirmation } from './composables/useConfirmation';
+export { default as useHomeCustomization } from './composables/useHomeCustomization';
+export { HomeCustomizeCog } from './components/HomeCustomizeCog';
+export { HomeCustomizePanel } from './components/HomeCustomizePanel';
+export { HomeCustomizeRow } from './components/HomeCustomizeRow';
+export { HomeCustomizeEmptyState } from './components/HomeCustomizeEmptyState';
 export { default as useLocation } from './composables/useLocation';
-export { default as useRecentFiles } from './composables/recentFiles.use';
 export { default as usePresentationHistory } from './composables/presentationHistory.use';
 export { default as useToast } from './composables/useToast';
 export { default as useSuggestedTags } from './composables/suggestedTags.use';
@@ -191,8 +207,12 @@ export * from './util/userAgents';
 export * from './util/pitcher-settings.util';
 export * from './util/eval';
 export * from './util/storage.util';
+export * from './util/handlebars';
 export * from './apps/collection-selector/utils/content-selector-adapter.util';
 export * from './util/soql.util.ts';
+export * from './util/sfdc.util';
+export * from './util/smart-store.util';
+export * from './util/app.util';
 export * from './utils/iframeInitialize';
 export * from './sdk/main';
 export * from './sdk/peer-connectivity';
@@ -208,7 +228,6 @@ export * from './types/users';
 export * from './types/canvases';
 export * from './types/canvasActions';
 export * from './types/canvasTheme';
-export * from './types/favorites';
 export * from './types/files';
 export * from './types/folder';
 export * from './types/file.types';
@@ -247,7 +266,6 @@ export * from './constants/appsDb.const';
 export * from './apps/canvas-builder/constants/theme.const';
 export * from './constants/roles.const';
 export type { RolePermissions } from './constants/roles.const';
-export * from './api/events/events.queries';
 export * from './api/users/users.queries';
 export * from './api/canvases/canvases.queries';
 export * from './api/events/events.helpers';

package/lib/sdk/api/HighLevelApi.d.ts

@@ -1,6 +1,6 @@
 import { LowLevelApi } from './LowLevelApi';
 import { PitcherEvent, ApiOptions } from '../interfaces';
-import * as modules from '@sdk/api/modules';
+import * as modules from './modules';
 /**
  * Creates a high-level API instance and caches it. Reterns a new instance only if new options are provided.
  */
@@ -131,10 +131,6 @@ export declare function createHighLevelApi(options?: ApiOptions): {
     }): Promise<import('../../main.lib').User>;
     isOffline(): Promise<boolean>;
     getLanguages(): Promise<modules.Language[]>;
-    getEvents(payload: Partial<import('../../main.lib').EventRequest>): Promise<import('../../main.lib').PaginatedData<import('../../main.lib').Event>>;
-    createEvent(payload: import('../../main.lib').EventRequest): Promise<import('../../main.lib').Event>;
-    updateEvent(payload: import('../../main.lib').PatchedEventRequest): Promise<import('../../main.lib').Event>;
-    deleteEvent(payload: Partial<import('../../main.lib').Event>): Promise<void>;
     getCanvases(payload: import('../../main.lib').GetCanvasesParams & {
         filters?: Record<string, any>;
         fields?: string;
@@ -166,7 +162,7 @@ export declare function createHighLevelApi(options?: ApiOptions): {
     }): Promise<import('../../main.lib').CanvasRecommendedFiles>;
     getCanvasTheme(payload: {
         canvas_id: import('../../main.lib').CanvasRetrieve["id"];
-    }): Promise<import('../../main.lib').CanvasThemeRetrieve>;
+    }): Promise<import('../../main.lib').CanvasThemeRetrieve | null>;
     unassignCanvasTheme(payload: {
         canvas_id: import('../../main.lib').CanvasRetrieve["id"];
     }): Promise<void>;
@@ -174,7 +170,6 @@ export declare function createHighLevelApi(options?: ApiOptions): {
         filters?: Record<string, any>;
         fields?: string;
     }): Promise<import('../../main.lib').PaginatedFileList>;
-    getRecentFiles(payload?: import('../payload.types').GetRecentFilesPayload): Promise<import('../../main.lib').File[]>;
     downloadFile(payload: {
         file_id: import('../../main.lib').File["id"];
     }): Promise<null>;
@@ -233,11 +228,17 @@ export declare function createHighLevelApi(options?: ApiOptions): {
     }): Promise<void>;
     query(payload: import('../payload.types').QueryPayload): Promise<any>;
     crmQuery(payload: import('../payload.types').CRMQueryPayload): Promise<any>;
+    crmQueryAdaptive(payload: import('../payload.types').CRMQueryPayload): Promise<any>;
     crmSmartQuery(payload: import('../payload.types').CRMQueryPayload): Promise<Array<any>>;
     crmSmartObjectMetadata(payload: import('../payload.types').CRMSmartObjectMetadataPayload): Promise<any>;
     crmSmartUpsertObjects(payload: import('../payload.types').UpsertCRMObjectsPayload): Promise<any>;
     crmSmartObjectValidationRules(payload: import('../payload.types').CRMSmartObjectValidationRulesPayload): Promise<any>;
+    crmSmartObjectLayout(payload: import('../payload.types').CRMSmartObjectLayoutPayload): Promise<any>;
     crmSmartDeleteObjects(payload: import('../payload.types').CRMSmartDeleteObjectsPayload): Promise<any>;
+    crmCreate(payload: import('../payload.types').CRMCreatePayload): Promise<any>;
+    crmUpsert(payload: import('../payload.types').CRMUpsertPayload): Promise<any>;
+    crmDescribe(payload: import('../payload.types').CRMDescribePayload): Promise<any>;
+    crmLayout(payload: import('../payload.types').CRMLayoutPayload): Promise<any>;
     getFolders(payload: import('../payload.types').FolderListRequest): Promise<import('../../main.lib').PaginatedFolderList>;
     getFolder(payload?: {
         id: import('../../main.lib').FolderRetrieve["id"];
@@ -262,11 +263,6 @@ export declare function createHighLevelApi(options?: ApiOptions): {
         parent_id?: string | null;
     }): Promise<import('../../main.lib').CoreFolderContentsRetrieve>;
     patchCoreFolder(id: string, payload: Partial<import('../../main.lib').CoreFolderRetrieve>): Promise<import('../../main.lib').CoreFolderContentsRetrieve>;
-    getFavorites(payload?: import('../../main.lib').GetFavoritesParams): Promise<import('../../main.lib').PaginatedFavoriteList>;
-    createFavorite(payload: import('../../main.lib').FavoriteCreateRequest): Promise<import('../../main.lib').Favorite>;
-    deleteFavorite(payload: {
-        favorite_id: import('../../main.lib').Favorite["id"];
-    }): Promise<void>;
     notify(payload: import('../payload.types').NotificationPayload): Promise<void>;
     track(payload: {
         event_name: string;

package/lib/sdk/api/modules/canvas.d.ts

@@ -83,7 +83,7 @@ export declare function getCanvasRecommendedFiles(payload: {
 }): Promise<CanvasRecommendedFiles>;
 export declare function getCanvasTheme(payload: {
     canvas_id: CanvasRetrieve['id'];
-}): Promise<CanvasThemeRetrieve>;
+}): Promise<CanvasThemeRetrieve | null>;
 export declare function unassignCanvasTheme(payload: {
     canvas_id: CanvasRetrieve['id'];
 }): Promise<void>;

package/lib/sdk/api/modules/files.d.ts

@@ -1,11 +1,10 @@
 import { File, FileRetrieve, PaginatedFileList, FileUpdateRequest, FileRevision } from '../../../../types/openapi';
-import { GetRecentFilesPayload, ListFilesPayload } from '../../payload.types';
+import { ListFilesPayload } from '../../payload.types';
 import { AllFileCreateRequest, DeviceFile } from '../../../types/files';
 export declare function getFiles(payload: ListFilesPayload & {
     filters?: Record<string, any>;
     fields?: string;
 }): Promise<PaginatedFileList>;
-export declare function getRecentFiles(payload?: GetRecentFilesPayload): Promise<File[]>;
 export declare function downloadFile(payload: {
     file_id: File['id'];
 }): Promise<null>;

package/lib/sdk/api/modules/index.d.ts

@@ -1,7 +1,6 @@
 export * from './open';
 export * from './env';
 export * from './languages';
-export * from './events';
 export * from './canvas';
 export * from './files';
 export * from './filesRevisions';
@@ -12,7 +11,6 @@ export * from './toast';
 export * from './query';
 export * from './folders';
 export * from './folders.core';
-export * from './favorites';
 export * from './notifications';
 export * from './track';
 export * from './metadataTemplates';

package/lib/sdk/api/modules/query.d.ts

@@ -1,6 +1,22 @@
-import { QueryPayload, CRMQueryPayload, UpsertCRMObjectsPayload, CRMSmartObjectValidationRulesPayload, CRMSmartObjectMetadataPayload, CRMSmartDeleteObjectsPayload } from '../../payload.types';
+import { QueryPayload, CRMQueryPayload, UpsertCRMObjectsPayload, CRMSmartObjectValidationRulesPayload, CRMSmartObjectMetadataPayload, CRMSmartObjectLayoutPayload, CRMSmartDeleteObjectsPayload, CRMCreatePayload, CRMUpsertPayload, CRMDescribePayload, CRMLayoutPayload } from '../../payload.types';
 export declare function query(payload: QueryPayload): Promise<any>;
 export declare function crmQuery(payload: CRMQueryPayload): Promise<any>;
+/**
+ * Executes a CRM query with automatic iOS/SmartStore adaptation.
+ *
+ * On iOS devices with the 'sfdc_offline_enabled' LaunchDarkly flag enabled,
+ * this function automatically converts SOQL queries to SmartStore Smart SQL format
+ * and uses the local SmartStore for offline data access.
+ * On other platforms or when the flag is disabled, it uses the standard CRM query API.
+ *
+ * @param {CRMQueryPayload} payload - The query payload containing the SOQL query string.
+ * @returns {Promise<any>} - Promise resolving with query results.
+ *
+ * @example
+ * // Works on all platforms - automatically adapts for iOS with sfdc_offline_enabled LD flag
+ * const result = await crmQueryAdaptive({ query: 'SELECT Id, Name FROM Account WHERE Active = true' })
+ */
+export declare function crmQueryAdaptive(payload: CRMQueryPayload): Promise<any>;
 /**
  * Executes a SmartStore query against local CRM data (iOS only).
  * Uses Salesforce Mobile SDK SmartStore query syntax.
@@ -88,6 +104,23 @@ export declare function crmSmartUpsertObjects(payload: UpsertCRMObjectsPayload):
  * api.crmSmartObjectValidationRules({ object: 'Contact' })
  */
 export declare function crmSmartObjectValidationRules(payload: CRMSmartObjectValidationRulesPayload): Promise<any>;
+/**
+ * Retrieves layout information for a CRM smart object (iOS only).
+ * Fetches object layout metadata from the Salesforce Mobile SDK cache.
+ *
+ * @param {CRMSmartObjectLayoutPayload} payload - The payload containing the object name and optional layout parameters.
+ * @returns {Promise<any>} - Promise resolving with the object layout metadata.
+ * @throws {Error} - Throws an error if the object name is not provided.
+ *
+ * @example
+ * // iOS only method to retrieve CRM object layout.
+ * api.crmSmartObjectLayout({ object: 'Account' })
+ *
+ * @example
+ * // Get layout with specific form factor and mode.
+ * api.crmSmartObjectLayout({ object: 'Account', form_factor: 'Large', mode: 'Edit' })
+ */
+export declare function crmSmartObjectLayout(payload: CRMSmartObjectLayoutPayload): Promise<any>;
 /**
  * Deletes CRM objects from local CRM data (iOS only).
  * Uses Salesforce Mobile SDK SmartStore to delete records.
@@ -113,3 +146,89 @@ export declare function crmSmartObjectValidationRules(payload: CRMSmartObjectVal
  * })
  */
 export declare function crmSmartDeleteObjects(payload: CRMSmartDeleteObjectsPayload): Promise<any>;
+/**
+ * Creates new records in CRM (Web only).
+ * Uses Salesforce REST API to create records.
+ *
+ * @param {CRMCreatePayload} payload - The create payload containing sobject type and records.
+ * @returns {Promise<any>} - Promise resolving with the result of the create operation.
+ * @throws {Error} - Throws an error if the payload is invalid.
+ *
+ * @example
+ * // Web only method to create CRM records.
+ * api.crmCreate({
+ *   sobject: 'Order__c',
+ *   records: [
+ *     { Account__c: '001xx000003DGbQAAW', Order_Date__c: '2024-01-15' },
+ *     { Account__c: '001xx000003DGbRABW', Order_Date__c: '2024-01-16' }
+ *   ]
+ * })
+ */
+export declare function crmCreate(payload: CRMCreatePayload): Promise<any>;
+/**
+ * Upserts records in CRM (Web only).
+ * Uses Salesforce REST API to insert or update records based on external ID.
+ * If a record with matching external ID exists, it will be updated; otherwise, a new record is created.
+ *
+ * @param {CRMUpsertPayload} payload - The upsert payload containing sobject type, records, and external ID field.
+ * @returns {Promise<any>} - Promise resolving with the result of the upsert operation.
+ * @throws {Error} - Throws an error if the payload is invalid.
+ *
+ * @example
+ * // Web only method to upsert CRM records.
+ * api.crmUpsert({
+ *   sobject: 'Order__c',
+ *   records: [
+ *     { External_Id__c: 'ORD-001', Account__c: '001xx000003DGbQAAW', Status__c: 'Submitted' },
+ *     { External_Id__c: 'ORD-002', Account__c: '001xx000003DGbRABW', Status__c: 'Draft' }
+ *   ],
+ *   external_id_field: 'External_Id__c'
+ * })
+ */
+export declare function crmUpsert(payload: CRMUpsertPayload): Promise<any>;
+/**
+ * Retrieves metadata/describe for a CRM object (Web only).
+ * Uses Salesforce REST API to fetch object metadata including fields and picklist values.
+ *
+ * @param {CRMDescribePayload} payload - The describe payload containing the sobject name.
+ * @returns {Promise<any>} - Promise resolving with the object metadata including fields and picklist values.
+ * @throws {Error} - Throws an error if the payload is invalid.
+ *
+ * @example
+ * // Web only method to get CRM object metadata.
+ * api.crmDescribe({ sobject: 'Account' })
+ *   .then(metadata => {
+ *     // Access fields
+ *     console.log(metadata.fields)
+ *     // Access picklist values for a specific field
+ *     const industryField = metadata.fields.find(f => f.name === 'Industry')
+ *     console.log(industryField.picklistValues)
+ *   })
+ */
+export declare function crmDescribe(payload: CRMDescribePayload): Promise<any>;
+/**
+ * Retrieves layout information for a CRM object (Web only).
+ * Uses Salesforce REST API to fetch object layout including sections, fields arrangement, and form factors.
+ *
+ * @param {CRMLayoutPayload} payload - The layout payload containing the sobject name and optional layout parameters.
+ * @returns {Promise<any>} - Promise resolving with the object layout information.
+ * @throws {Error} - Throws an error if the payload is invalid.
+ *
+ * @example
+ * // Web only method to get CRM object layout.
+ * api.crmLayout({ sobject: 'Account' })
+ *   .then(layout => {
+ *     // Access layout sections
+ *     console.log(layout.editLayoutSections)
+ *   })
+ *
+ * @example
+ * // Get layout with specific form factor, mode, and record type.
+ * api.crmLayout({
+ *   sobject: 'Account',
+ *   form_factor: 'Large',
+ *   mode: 'Edit',
+ *   record_type_id: '012xx0000004ABC'
+ * })
+ */
+export declare function crmLayout(payload: CRMLayoutPayload): Promise<any>;

package/lib/sdk/api/modules/ui/content.ui.d.ts

@@ -1,4 +1,4 @@
-import { UiSelectAgendaRequest, UiSelectAgendaResponse, UiSelectCollectionPlayerRequest, UiSelectCollectionPlayerResponse, UiSelectContentRequest, UiSelectContentResponse, UiOpenRequest, UiToastRequest, UiPreselectSfdcMeetingIdRequest, UiPreselectSfdcMeetingIdResponse } from './types.ui';
+import { UiSelectAgendaRequest, UiSelectAgendaResponse, UiSelectCollectionPlayerRequest, UiSelectCollectionPlayerResponse, UiSelectContentRequest, UiSelectContentResponse, UiOpenRequest, UiToastRequest, UiPreselectSfdcMeetingIdRequest, UiPreselectSfdcMeetingIdResponse, UiOpenGlobalPopupResponse } from './types.ui';
 /**
  * @hidden
  * @deprecated
@@ -84,3 +84,24 @@ export declare function selectCollectionContent(payload?: UiSelectCollectionPlay
  * ```
  */
 export declare function selectAgendaContent(payload?: UiSelectAgendaRequest): Promise<UiSelectAgendaResponse>;
+/**
+ * Opens a global popup app by name.
+ *
+ * @example
+ * const api = useApi()
+ * api.openGlobalPopup('my-popup-app')
+ * api.openGlobalPopup('my-popup-app', { customData: 'value' })
+ *
+ * @param appName - The name of the app to open (must have app_type: 'ui-global-popup')
+ * @param extraContext - Extra context to pass to the app
+ * @returns Promise with the result of the operation
+ */
+export declare function openGlobalPopup(appName: string, extraContext?: Record<string, any>): Promise<UiOpenGlobalPopupResponse>;
+/**
+ * Closes the currently open global popup app.
+ *
+ * @example
+ * const api = useApi()
+ * api.closeGlobalPopup()
+ */
+export declare function closeGlobalPopup(): Promise<void>;

package/lib/sdk/api/modules/ui/index.d.ts

@@ -113,6 +113,7 @@ declare function onAppUpdateData(handler: (data: UiAppUpdateDataPayload) => Prom
  */
 declare function uiBroadcast(payload: UiBroadcastRequest): Promise<void>;
 declare const _default: {
+    openSharingSettings(payload: import('./types.ui').UiOpenSharingSettingsRequest): Promise<import('./types.ui').UiOpenSharingSettingsResponse>;
     promptPia(payload: import('./types.ui').UiPromptPiaRequest): Promise<import('./types.ui').UiPromptPiaResponse>;
     completePostcall(payload: import('./types.ui').UiCompletePostcallRequest): Promise<void>;
     cancelMeeting(): Promise<void>;
@@ -155,6 +156,8 @@ declare const _default: {
     preselectSfdcMeetingId(payload: import('./types.ui').UiPreselectSfdcMeetingIdRequest): Promise<import('./types.ui').UiPreselectSfdcMeetingIdResponse>;
     selectCollectionContent(payload?: import('./types.ui').UiSelectCollectionPlayerRequest): Promise<import('./types.ui').UiSelectCollectionPlayerResponse>;
     selectAgendaContent(payload?: import('./types.ui').UiSelectAgendaRequest): Promise<import('./types.ui').UiSelectAgendaResponse>;
+    openGlobalPopup(appName: string, extraContext?: Record<string, any>): Promise<import('./types.ui').UiOpenGlobalPopupResponse>;
+    closeGlobalPopup(): Promise<void>;
     on: typeof on;
     onMeetingCanceled: typeof onMeetingCanceled;
     onCanvasUpdated: typeof onCanvasUpdated;

package/lib/sdk/api/modules/ui/sharing.ui.d.ts

@@ -0,0 +1,2 @@
+import { UiOpenSharingSettingsRequest, UiOpenSharingSettingsResponse } from './types.ui';
+export declare function openSharingSettings(payload: UiOpenSharingSettingsRequest): Promise<UiOpenSharingSettingsResponse>;

package/lib/sdk/api/modules/ui/types.ui.d.ts

@@ -43,6 +43,9 @@ export declare const UI_API_METHOD_TYPES: {
     readonly UI_APP_RESIZE: "ui_app_resize";
     readonly UI_CLOSE_CANVAS_SECTION_EXECUTION: "ui_close_canvas_section_execution";
     readonly UI_CLOSE_CANVAS_DRAWER: "ui_close_canvas_drawer";
+    readonly UI_OPEN_GLOBAL_POPUP: "ui_open_global_popup";
+    readonly UI_CLOSE_GLOBAL_POPUP: "ui_close_global_popup";
+    readonly UI_OPEN_SHARING_SETTINGS: "ui_open_sharing_settings";
 };
 export declare const UI_MESSAGE_TYPES: {
     readonly UI_MEETING_CANCELED: "ui_meeting_canceled";
@@ -319,3 +322,32 @@ export type UiPromptPiaResponseStreamedPayload = {
     /** Current chunk of the response */
     chunk: string;
 };
+export interface UiOpenGlobalPopupRequest {
+    /** Name of the app to open */
+    app_name: string;
+    /** Extra context to pass to the app */
+    extra_context?: Record<string, any>;
+}
+export interface UiOpenGlobalPopupResponse {
+    /** Whether the popup was successfully opened */
+    success: boolean;
+}
+export interface UiOpenSharingSettingsRequest {
+    files: Array<{
+        id: string;
+        name: string;
+        thumbnail_url?: string;
+        content_type?: string;
+    }>;
+    default_auth_strategy?: string;
+}
+export interface UiOpenSharingSettingsResponse {
+    user_action: 'confirmed' | 'cancelled';
+    settings?: {
+        auth_strategy: 'none' | 'any_email' | 'specified_emails' | 'specified_domains' | 'verified_emails' | 'verified_domains';
+        allowed_emails?: string[];
+        allowed_domains?: string[];
+        valid_until_days?: number | null;
+        allow_download?: boolean;
+    };
+}

package/lib/sdk/interfaces.d.ts

@@ -1,8 +1,7 @@
 import { Emitter } from './utils/eventEmitter';
-import { Favorite, File, User, CanvasRetrieve, CanvasSection } from '../../types/openapi';
+import { File, User, CanvasRetrieve, CanvasSection } from '../../types/openapi';
 import { PitcherOrg } from '../types/organization.types';
 import { PitcherInstance } from '../types/instance.types';
-import { PaginatedData } from '../types/paginatedData';
 import { LaunchDarklyEnv } from '../types/launchDarkly.types';
 import { CDP_EVENT_TYPE, CLIENT_TYPE } from '../constants/cdp.const';
 import { PeerConnectivityEvent } from './peer-connectivity';
@@ -58,8 +57,10 @@ export interface PitcherEnv {
         user: User;
         access_token: string;
         id_token: string;
+        impersonated_by?: string;
     };
     launch_darkly?: LaunchDarklyEnv;
+    permissions?: string[];
     client_type?: (typeof CLIENT_TYPE)[keyof typeof CLIENT_TYPE];
     crm_shape?: Record<string, any>;
     state?: {
@@ -106,6 +107,12 @@ export interface StartCallPitcherEvent {
         name: string;
     };
     contact_ids?: string[];
+    /**
+     * CRM meeting/event id. When provided, the host fetches the meeting through
+     * its own CRM provider so the meeting bar shows the proper subject/time
+     * instead of "Unscheduled".
+     */
+    meeting_id?: string;
     canvas_id?: string;
     edit_mode?: 'true' | 'false';
     post_action?: string;
@@ -117,6 +124,7 @@ export interface RouteChangedPitcherEvent {
 }
 export declare enum PitcherEventName {
     ENV_CHANGED = "env_changed",
+    ACCESS_TOKEN_RENEWED = "access_token_renewed",
     PHOTOS_CAPTURED = "photos_captured",
     GLOBAL_PHOTO_CAPTURED = "global_photo_captured",
     FILE_DOWNLOADED = "file_downloaded",
@@ -147,12 +155,12 @@ export declare enum PitcherEventName {
     ITEM_SHAREBOX_ADD_REQUESTED = "item_sharebox_add_requested",
     ITEM_SHAREBOX_ADD_COMPLETED = "item_sharebox_add_completed",
     SYNC_BADGE_VALUE_REPORTED = "sync_badge_value_reported",
+    SYNC_BOX_RESOLVE_ERROR_TAPPED = "sync_box_resolve_error_tapped",
     PEER_CONNECTIVITY_EVENT = "peer_connectivity_event"
 }
 export declare enum PitcherBroadcastedEventName {
     UI_SHOW_MODAL = "ui:show-modal",
     UI_HIDE_MODAL = "ui:hide-modal",
-    FAVORITES_CHANGED = "favorites:changed",
     FILE_DOWNLOAD = "file:download",
     CANVAS_NEXT_BUTTON_CLICKED = "canvas_next_button_clicked",// NOTE: This event is separate from `CANVAS_PAGE_NEXT_REQUESTED`
     CANVAS_PREVIOUS_BUTTON_CLICKED = "canvas_previous_button_clicked",// NOTE: This event is separate from `CANVAS_PAGE_PREVIOUS_REQUESTED`
@@ -337,6 +345,16 @@ export interface UpdateLocationOnGetRoutesResponse extends UpdateLocation {
 export type UpdateLocationPitcherEvent = UpdateLocationOnUnregister | UpdateLocationOnRestore | UpdateLocationOnUpdate | UpdateLocationOnRegister | UpdateLocationOnRestoreCompleted | UpdateLocationOnMounted | UpdateLocationOnGetRoutesRequest | UpdateLocationOnGetRoutesResponse;
 export interface PitcherEventMap {
     [PitcherEventName.ENV_CHANGED]: PitcherEnv;
+    /**
+     * The shell renewed the Pitcher access token. Apps that cached `env.pitcher.access_token`
+     * (instead of reading it lazily via `getEnv()`) should replace their copy with this one.
+     *
+     * @see web-only for now — Impact iOS does not emit this event yet; keep a pull fallback
+     * (`getEnv()` / `refreshAccessToken()`) for cross-platform apps.
+     */
+    [PitcherEventName.ACCESS_TOKEN_RENEWED]: {
+        access_token: string;
+    };
     /**
      * @see iOS-only
      */
@@ -444,12 +462,22 @@ export interface PitcherEventMap {
     [PitcherEventName.SYNC_BADGE_VALUE_REPORTED]: {
         count: number;
     };
+    /**
+     * @see iOS-only
+     * Fired when user taps "Fix" on a failed SFDC sync error in the Syncbox.
+     * The id may be a Salesforce ID, external ID, or locally-generated temp ID.
+     */
+    [PitcherEventName.SYNC_BOX_RESOLVE_ERROR_TAPPED]: {
+        /** Record ID that failed to sync (SF ID, external ID, or temp ID like PIT_...) */
+        id: string;
+        /** SFDC object/soup name (e.g. "Event", "Call2_vod__c") */
+        table_name: string;
+        /** Salesforce sync error message */
+        last_error: string;
+    };
     [PitcherEventName.PEER_CONNECTIVITY_EVENT]: PeerConnectivityEvent;
     [PitcherBroadcastedEventName.UI_SHOW_MODAL]: void;
     [PitcherBroadcastedEventName.UI_HIDE_MODAL]: void;
-    [PitcherBroadcastedEventName.FAVORITES_CHANGED]: {
-        body: PaginatedData<Favorite>;
-    };
     [PitcherBroadcastedEventName.FILE_DOWNLOAD]: {
         body: File['id'];
     };