@pitcher/canvas-ui 2025.12.19-83033 → 2025.12.22-211404-beta

package/lib/api/events/events.helpers.d.ts

@@ -1,7 +1,9 @@
 import { Event, MiniCanvas } from '../../../types/openapi';
 import { SfAccountMini, SfEvent, SfUser } from '../../types/sfdc';
 import { ComputedRef } from 'vue';
-export declare function getEventColor(pEvent: Event, sfEvent: SfEvent): string;
+export declare function extractFieldNamesFromCondition(condition: string): string[];
+export declare function evaluateIsExecutedCondition(condition: string | undefined, event: any): boolean;
+export declare function getEventColor(_pEvent: Event, sfEvent: SfEvent): string;
 export declare const minFutureDate: (date?: Date) => Date;
 export declare const minPastDate: (date?: Date) => Date;
 export declare const setDateTime: (date: number | Date) => number;

package/lib/apps/canvas-builder/composables/useCanvas.d.ts

@@ -4865,6 +4865,7 @@ export default function useCanvas(): {
         enable_recents?: boolean | undefined;
         enable_favorites?: boolean | undefined;
         enable_sync_file_filtering?: boolean | undefined;
+        enable_sfdc_sync?: boolean | undefined;
         time_format?: string | undefined;
         date_format?: string | undefined;
         is_file_expiration_mandatory?: boolean | undefined;
@@ -4907,6 +4908,7 @@ export default function useCanvas(): {
         enable_multipeer_connectivity?: boolean;
         enable_syncbox?: boolean;
         enable_sync_file_filtering?: boolean;
+        enable_sfdc_sync?: boolean;
         time_format?: string;
         date_format?: string;
         is_file_expiration_mandatory?: boolean;
@@ -5195,6 +5197,7 @@ export default function useCanvas(): {
         enable_recents?: boolean | undefined;
         enable_favorites?: boolean | undefined;
         enable_sync_file_filtering?: boolean | undefined;
+        enable_sfdc_sync?: boolean | undefined;
         time_format?: string | undefined;
         date_format?: string | undefined;
         is_file_expiration_mandatory?: boolean | undefined;
@@ -5517,6 +5520,7 @@ export default function useCanvas(): {
         readonly enable_recents?: boolean | undefined;
         readonly enable_favorites?: boolean | undefined;
         readonly enable_sync_file_filtering?: boolean | undefined;
+        readonly enable_sfdc_sync?: boolean | undefined;
         readonly time_format?: string | undefined;
         readonly date_format?: string | undefined;
         readonly is_file_expiration_mandatory?: boolean | undefined;
@@ -5838,6 +5842,7 @@ export default function useCanvas(): {
         readonly enable_recents?: boolean | undefined;
         readonly enable_favorites?: boolean | undefined;
         readonly enable_sync_file_filtering?: boolean | undefined;
+        readonly enable_sfdc_sync?: boolean | undefined;
         readonly time_format?: string | undefined;
         readonly date_format?: string | undefined;
         readonly is_file_expiration_mandatory?: boolean | undefined;

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 enable_sfdc_sync instance setting 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/main.lib.d.ts

@@ -137,6 +137,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';
@@ -196,6 +197,7 @@ 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/smart-store.util';
 export * from './util/app.util';
 export * from './utils/iframeInitialize';
 export * from './sdk/main';

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

@@ -233,6 +233,7 @@ 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>;
@@ -240,6 +241,7 @@ export declare function createHighLevelApi(options?: ApiOptions): {
     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>;
     getFolders(payload: import('../payload.types').FolderListRequest): Promise<import('../../main.lib').PaginatedFolderList>;
     getFolder(payload?: {
         id: import('../../main.lib').FolderRetrieve["id"];

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

@@ -1,6 +1,22 @@
-import { QueryPayload, CRMQueryPayload, UpsertCRMObjectsPayload, CRMSmartObjectValidationRulesPayload, CRMSmartObjectMetadataPayload, CRMSmartDeleteObjectsPayload, CRMCreatePayload, CRMUpsertPayload } from '../../payload.types';
+import { QueryPayload, CRMQueryPayload, UpsertCRMObjectsPayload, CRMSmartObjectValidationRulesPayload, CRMSmartObjectMetadataPayload, CRMSmartDeleteObjectsPayload, CRMCreatePayload, CRMUpsertPayload, CRMDescribePayload } 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 'enable_sfdc_sync' instance setting 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 setting 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 enable_sfdc_sync instance setting
+ * 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.
@@ -153,3 +169,23 @@ export declare function crmCreate(payload: CRMCreatePayload): Promise<any>;
  * })
  */
 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>;

package/lib/sdk/main.d.ts

@@ -304,6 +304,7 @@ export declare function useApi(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>;
@@ -311,6 +312,7 @@ export declare function useApi(options?: ApiOptions): {
     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>;
     getFolders(payload: import('./payload.types').FolderListRequest): Promise<import('../main.lib').PaginatedFolderList>;
     getFolder(payload?: {
         id: import('../main.lib').FolderRetrieve["id"];
@@ -589,6 +591,7 @@ export declare function useApi(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>;
@@ -596,6 +599,7 @@ export declare function useApi(options?: ApiOptions): {
         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>;
         getFolders(payload: import('./payload.types').FolderListRequest): Promise<import('../main.lib').PaginatedFolderList>;
         getFolder(payload?: {
             id: import('../main.lib').FolderRetrieve["id"];
@@ -810,6 +814,7 @@ export declare function useApi(options?: ApiOptions): {
     }): Promise<ArrayBuffer>;
     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>;
@@ -817,6 +822,7 @@ export declare function useApi(options?: ApiOptions): {
     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>;
     getFolders(payload: import('./payload.types').FolderListRequest): Promise<import('../main.lib').PaginatedFolderList>;
     getFolder(payload?: {
         id: import('../main.lib').FolderRetrieve["id"];

package/lib/sdk/payload.types.d.ts

@@ -404,3 +404,17 @@ export interface CRMUpsertPayload {
      */
     service?: CRMServiceType;
 }
+/**
+ * Payload for retrieving CRM object metadata/describe (Web only).
+ * Uses Salesforce REST API to fetch object metadata including fields and picklist values.
+ */
+export interface CRMDescribePayload {
+    /**
+     * The Salesforce object type to describe (e.g., 'Account', 'Contact', 'Opportunity').
+     */
+    sobject: string;
+    /**
+     * Optional name of the CRM service to use.
+     */
+    service?: CRMServiceType;
+}

package/lib/types/instanceSettings.types.d.ts

@@ -60,6 +60,7 @@ export type InstanceSettings = OrganizationSettings & {
     enable_multipeer_connectivity?: boolean;
     enable_syncbox?: boolean;
     enable_sync_file_filtering?: boolean;
+    enable_sfdc_sync?: boolean;
     time_format?: string;
     date_format?: string;
     is_file_expiration_mandatory?: boolean;

package/lib/types/sfdc.d.ts

@@ -59,6 +59,7 @@ export type SfEvent = {
     Type?: string;
     EventWhoIds?: string[];
     IsAllDayEvent?: boolean;
+    is_executed_condition?: string;
 };
 export type SfEventExtended = SfEvent & {
     contactName?: string;
@@ -108,6 +109,8 @@ export interface SfContactBasic {
     };
     callId?: string;
     PersonAccountId?: string;
+    AccountName?: string;
+    Account?: any;
 }
 export type EventsSfList = {
     done?: boolean;

package/lib/util/smart-store.util.d.ts

@@ -0,0 +1,40 @@
+/**
+ * SmartStore Smart SQL Query Utilities
+ *
+ * This module provides utilities for converting SOQL queries to SmartStore Smart SQL format
+ * for offline data access on iOS devices using Salesforce Mobile SDK.
+ */
+/**
+ * Comprehensive SOQL to SmartStore Smart Query converter
+ *
+ * Converts standard SOQL queries to SmartStore Smart SQL format for offline use on iOS.
+ * Handles SELECT, FROM, WHERE, ORDER BY, GROUP BY, HAVING, LIMIT, OFFSET,
+ * aggregate functions, and relationship fields.
+ *
+ * SmartStore stores denormalized data, so relationship fields are accessed directly
+ * within the soup using the full relationship path (e.g., Child_Account_vod__r.Name).
+ *
+ * @param soqlQuery - The SOQL query string to convert
+ * @returns The converted SmartStore Smart SQL query string
+ *
+ * @example
+ * // Simple query
+ * convertSoqlToSmartQuery('SELECT Id, Name FROM Account WHERE Active = true')
+ * // Returns: SELECT {Account:Id}, {Account:Name} FROM {Account} WHERE {Account:Active} = true
+ *
+ * @example
+ * // With relationship fields (denormalized access - no joins needed)
+ * convertSoqlToSmartQuery('SELECT Id, Child_Account_vod__r.Name FROM Child_Account_vod__c')
+ * // Returns: SELECT {Child_Account_vod__c:Id}, {Child_Account_vod__c:Child_Account_vod__r.Name} FROM {Child_Account_vod__c}
+ *
+ * @example
+ * // With aggregate functions
+ * convertSoqlToSmartQuery('SELECT COUNT(Id), Industry FROM Account GROUP BY Industry')
+ * // Returns: SELECT COUNT({Account:Id}), {Account:Industry} FROM {Account} GROUP BY {Account:Industry}
+ *
+ * @example
+ * // With ORDER BY and LIMIT
+ * convertSoqlToSmartQuery('SELECT Id, Name FROM Contact ORDER BY LastName ASC, FirstName DESC LIMIT 100')
+ * // Returns: SELECT {Contact:Id}, {Contact:Name} FROM {Contact} ORDER BY {Contact:LastName} ASC, {Contact:FirstName} DESC LIMIT 100
+ */
+export declare function convertSoqlToSmartQuery(soqlQuery: string): string;

package/lib/util/smart-store.util.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pitcher/canvas-ui",
-  "version": "2025.12.19-83033",
+  "version": "2025.12.22-211404-beta",
   "type": "module",
   "publishConfig": {
     "access": "public"