@pitcher/canvas-ui 2025.12.16-082908-beta → 2025.12.16-085511-beta

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

@@ -238,6 +238,8 @@ export declare function createHighLevelApi(options?: ApiOptions): {
     crmSmartUpsertObjects(payload: import('../payload.types').UpsertCRMObjectsPayload): Promise<any>;
     crmSmartObjectValidationRules(payload: import('../payload.types').CRMSmartObjectValidationRulesPayload): 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>;
     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,4 +1,4 @@
-import { QueryPayload, CRMQueryPayload, UpsertCRMObjectsPayload, CRMSmartObjectValidationRulesPayload, CRMSmartObjectMetadataPayload, CRMSmartDeleteObjectsPayload } 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>;
 /**
@@ -113,3 +113,43 @@ 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>;

package/lib/sdk/main.d.ts

@@ -309,6 +309,8 @@ export declare function useApi(options?: ApiOptions): {
     crmSmartUpsertObjects(payload: import('./payload.types').UpsertCRMObjectsPayload): Promise<any>;
     crmSmartObjectValidationRules(payload: import('./payload.types').CRMSmartObjectValidationRulesPayload): 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>;
     getFolders(payload: import('./payload.types').FolderListRequest): Promise<import('../main.lib').PaginatedFolderList>;
     getFolder(payload?: {
         id: import('../main.lib').FolderRetrieve["id"];
@@ -592,6 +594,8 @@ export declare function useApi(options?: ApiOptions): {
         crmSmartUpsertObjects(payload: import('./payload.types').UpsertCRMObjectsPayload): Promise<any>;
         crmSmartObjectValidationRules(payload: import('./payload.types').CRMSmartObjectValidationRulesPayload): 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>;
         getFolders(payload: import('./payload.types').FolderListRequest): Promise<import('../main.lib').PaginatedFolderList>;
         getFolder(payload?: {
             id: import('../main.lib').FolderRetrieve["id"];
@@ -811,6 +815,8 @@ export declare function useApi(options?: ApiOptions): {
     crmSmartUpsertObjects(payload: import('./payload.types').UpsertCRMObjectsPayload): Promise<any>;
     crmSmartObjectValidationRules(payload: import('./payload.types').CRMSmartObjectValidationRulesPayload): 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>;
     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

@@ -361,3 +361,46 @@ export interface CRMSmartDeleteObjectsPayload {
      */
     objects: CRMDeleteObject[];
 }
+/**
+ * Payload for creating CRM records (Web only).
+ * Uses Salesforce REST API to create records.
+ */
+export interface CRMCreatePayload {
+    /**
+     * The Salesforce object type (e.g., 'Account', 'Contact', 'Order__c').
+     */
+    sobject: string;
+    /**
+     * Array of records to create. Each record is a key-value map of field names to values.
+     * Field names should use Salesforce API names (e.g., 'Account__c', 'Order_Date__c').
+     */
+    records: Array<Record<string, unknown>>;
+    /**
+     * Optional name of the CRM service to use.
+     */
+    service?: CRMServiceType;
+}
+/**
+ * Payload for upserting CRM records (Web only).
+ * Uses Salesforce REST API to insert or update records based on external ID.
+ */
+export interface CRMUpsertPayload {
+    /**
+     * The Salesforce object type (e.g., 'Account', 'Contact', 'Order__c').
+     */
+    sobject: string;
+    /**
+     * Array of records to upsert. Each record is a key-value map of field names to values.
+     * Field names should use Salesforce API names (e.g., 'Account__c', 'Order_Date__c').
+     */
+    records: Array<Record<string, unknown>>;
+    /**
+     * The external ID field used to match existing records for update.
+     * If a record with matching external ID exists, it will be updated; otherwise, a new record is created.
+     */
+    external_id_field: string;
+    /**
+     * Optional name of the CRM service to use.
+     */
+    service?: CRMServiceType;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pitcher/canvas-ui",
-  "version": "2025.12.16-082908-beta",
+  "version": "2025.12.16-085511-beta",
   "type": "module",
   "publishConfig": {
     "access": "public"