@pitcher/canvas-ui 2025.12.19-075910-beta → 2025.12.19-090420-beta

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,7 +241,6 @@ 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, CRMDescribePayload } from '../../payload.types';
+import { QueryPayload, CRMQueryPayload, UpsertCRMObjectsPayload, CRMSmartObjectValidationRulesPayload, CRMSmartObjectMetadataPayload, CRMSmartDeleteObjectsPayload, CRMCreatePayload, CRMUpsertPayload } 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,23 +169,3 @@ 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,7 +312,6 @@ 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"];
@@ -590,6 +590,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>;
@@ -597,7 +598,6 @@ 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"];
@@ -812,6 +812,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>;
@@ -819,7 +820,6 @@ 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,17 +404,3 @@ 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/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/locale/de.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": null,
         "products": null,
-        "productTemplates": null,
         "saved": null,
         "templates": null
       },

package/locale/el.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": "Μπλοκ",
         "products": "Προϊόντα",
-        "productTemplates": "Πρότυπα προϊόντων",
         "saved": "Αποθηκευμένα",
         "templates": "Πρότυπα"
       },

package/locale/en.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": "Blocks",
         "products": "Products",
-        "productTemplates": "Product Templates",
         "saved": "Saved",
         "templates": "Templates"
       },

package/locale/es.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": "Bloques",
         "products": "Productos",
-        "productTemplates": "Plantillas de productos",
         "saved": "Guardados",
         "templates": "Plantillas"
       },

package/locale/fr.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": "Blocs",
         "products": "Produits",
-        "productTemplates": "Modèles de produits",
         "saved": "Sauvegardés",
         "templates": "Modèles"
       },

package/locale/it.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": "Blocchi",
         "products": "Prodotti",
-        "productTemplates": "Modelli di prodotti",
         "saved": "Salvati",
         "templates": "Modelli"
       },

package/locale/ja.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": "ブロック",
         "products": "プロダクト",
-        "productTemplates": "プロダクトテンプレート",
         "saved": "保存済み",
         "templates": "テンプレート"
       },

package/locale/nl.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": "Blocks",
         "products": "Products",
-        "productTemplates": "Product Templates",
         "saved": "Saved",
         "templates": "Templates"
       },

package/locale/pl.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": null,
         "products": null,
-        "productTemplates": null,
         "saved": null,
         "templates": null
       },

package/locale/pt-br.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": "Bloco",
         "products": "Produtos",
-        "productTemplates": "Modelos de produtos",
         "saved": "Saved",
         "templates": "Modelos"
       },

package/locale/pt.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": "Blocks",
         "products": "Products",
-        "productTemplates": "Product Templates",
         "saved": "Saved",
         "templates": "Templates"
       },

package/locale/th.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": "บล็อก",
         "products": "ผลิตภัณฑ์",
-        "productTemplates": "ส่วนประกอบผลิตภัณฑ์",
         "saved": "บันทึกแล้ว",
         "templates": "เทมเพลต"
       },

package/locale/tr.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": null,
         "products": null,
-        "productTemplates": null,
         "saved": null,
         "templates": null
       },

package/locale/zh.json

@@ -414,7 +414,6 @@
       "canvasFilters": {
         "blocks": "模块",
         "products": "产品",
-        "productTemplates": "产品模板",
         "saved": "已保存",
         "templates": "模板"
       },

package/package.json

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