@bubblelab/bubble-core 0.1.112 → 0.1.113

package/dist/bubbles/service-bubble/salesforce/salesforce.utils.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Salesforce Bubble Utility Functions
+ *
+ * Helper functions for Salesforce API interactions and data formatting.
+ */
+/**
+ * Validate Salesforce ID format (15 or 18 character)
+ * @param id Salesforce record ID
+ * @returns Whether the ID is valid
+ */
+export declare function isValidSalesforceId(id: string): boolean;
+/**
+ * Convert 15-character Salesforce ID to 18-character ID
+ * @param id15 15-character Salesforce ID
+ * @returns 18-character Salesforce ID
+ */
+export declare function to18CharId(id15: string): string;
+/**
+ * Format Salesforce date to ISO string
+ * @param sfDate Salesforce date string (YYYY-MM-DD or ISO format)
+ * @returns ISO date string
+ */
+export declare function formatSalesforceDate(sfDate: string): string;
+/**
+ * Convert JavaScript Date to Salesforce date format
+ * @param date JavaScript Date object
+ * @returns Salesforce date string (YYYY-MM-DD)
+ */
+export declare function toSalesforceDate(date: Date): string;
+/**
+ * Escape SOQL special characters in a string
+ * @param value String to escape
+ * @returns Escaped string safe for SOQL
+ */
+export declare function escapeSoql(value: string): string;
+/**
+ * Build a SOQL query string
+ * @param sobjectType sObject API name
+ * @param fields Array of field names to select
+ * @param options Query options (where, orderBy, limit)
+ * @returns SOQL query string
+ */
+export declare function buildSoqlQuery(sobjectType: string, fields: string[], options?: {
+    where?: string;
+    orderBy?: string;
+    limit?: number;
+}): string;
+/**
+ * Enhance Salesforce API error messages with helpful hints
+ * @param error Original error message or object
+ * @param statusCode HTTP status code
+ * @returns Enhanced error message
+ */
+export declare function enhanceSalesforceErrorMessage(error: string | SalesforceErrorResponse[], statusCode?: number): string;
+/**
+ * Salesforce error response object
+ */
+export interface SalesforceErrorResponse {
+    message: string;
+    errorCode?: string;
+    fields?: string[];
+}
+/**
+ * Parse Salesforce API error response
+ * @param responseBody Response body from Salesforce API
+ * @returns Array of error objects or string error
+ */
+export declare function parseSalesforceError(responseBody: unknown): SalesforceErrorResponse[] | string;
+/**
+ * Get the instance URL from OAuth token response metadata
+ * @param instanceUrl Instance URL from OAuth response
+ * @returns Cleaned instance URL (without trailing slash)
+ */
+export declare function cleanInstanceUrl(instanceUrl: string): string;
+/**
+ * Get Salesforce API version
+ * @returns Current API version string
+ */
+export declare function getSalesforceApiVersion(): string;
+/**
+ * Build Salesforce REST API URL
+ * @param instanceUrl Salesforce instance URL
+ * @param endpoint API endpoint path
+ * @returns Full API URL
+ */
+export declare function buildApiUrl(instanceUrl: string, endpoint: string): string;
+//# sourceMappingURL=salesforce.utils.d.ts.map

package/dist/bubbles/service-bubble/salesforce/salesforce.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"salesforce.utils.d.ts","sourceRoot":"","sources":["../../../../src/bubbles/service-bubble/salesforce/salesforce.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmB/C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,MAAM,CAgBR;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,GAAG,uBAAuB,EAAE,EACzC,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CA8BR;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,OAAO,GACpB,uBAAuB,EAAE,GAAG,MAAM,CAepC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWzE"}

package/dist/bubbles/service-bubble/salesforce/salesforce.utils.js

@@ -0,0 +1,181 @@
+/**
+ * Salesforce Bubble Utility Functions
+ *
+ * Helper functions for Salesforce API interactions and data formatting.
+ */
+/**
+ * Validate Salesforce ID format (15 or 18 character)
+ * @param id Salesforce record ID
+ * @returns Whether the ID is valid
+ */
+export function isValidSalesforceId(id) {
+    // Salesforce IDs are either 15-character (case-sensitive) or 18-character (case-insensitive)
+    return /^[a-zA-Z0-9]{15}$|^[a-zA-Z0-9]{18}$/.test(id);
+}
+/**
+ * Convert 15-character Salesforce ID to 18-character ID
+ * @param id15 15-character Salesforce ID
+ * @returns 18-character Salesforce ID
+ */
+export function to18CharId(id15) {
+    if (id15.length === 18)
+        return id15;
+    if (id15.length !== 15) {
+        throw new Error('Invalid Salesforce ID: must be 15 or 18 characters');
+    }
+    const suffix = [];
+    for (let i = 0; i < 3; i++) {
+        let flags = 0;
+        for (let j = 0; j < 5; j++) {
+            const char = id15.charAt(i * 5 + j);
+            if (char >= 'A' && char <= 'Z') {
+                flags += 1 << j;
+            }
+        }
+        suffix.push('ABCDEFGHIJKLMNOPQRSTUVWXYZ012345'.charAt(flags));
+    }
+    return id15 + suffix.join('');
+}
+/**
+ * Format Salesforce date to ISO string
+ * @param sfDate Salesforce date string (YYYY-MM-DD or ISO format)
+ * @returns ISO date string
+ */
+export function formatSalesforceDate(sfDate) {
+    // If already ISO format, return as-is
+    if (sfDate.includes('T')) {
+        return sfDate;
+    }
+    // Convert YYYY-MM-DD to ISO
+    return new Date(sfDate + 'T00:00:00.000Z').toISOString();
+}
+/**
+ * Convert JavaScript Date to Salesforce date format
+ * @param date JavaScript Date object
+ * @returns Salesforce date string (YYYY-MM-DD)
+ */
+export function toSalesforceDate(date) {
+    return date.toISOString().split('T')[0];
+}
+/**
+ * Escape SOQL special characters in a string
+ * @param value String to escape
+ * @returns Escaped string safe for SOQL
+ */
+export function escapeSoql(value) {
+    // Escape single quotes, backslashes, and other special characters
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/'/g, "\\'")
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t');
+}
+/**
+ * Build a SOQL query string
+ * @param sobjectType sObject API name
+ * @param fields Array of field names to select
+ * @param options Query options (where, orderBy, limit)
+ * @returns SOQL query string
+ */
+export function buildSoqlQuery(sobjectType, fields, options) {
+    let query = `SELECT ${fields.join(', ')} FROM ${sobjectType}`;
+    if (options?.where) {
+        query += ` WHERE ${options.where}`;
+    }
+    if (options?.orderBy) {
+        query += ` ORDER BY ${options.orderBy}`;
+    }
+    if (options?.limit) {
+        query += ` LIMIT ${options.limit}`;
+    }
+    return query;
+}
+/**
+ * Enhance Salesforce API error messages with helpful hints
+ * @param error Original error message or object
+ * @param statusCode HTTP status code
+ * @returns Enhanced error message
+ */
+export function enhanceSalesforceErrorMessage(error, statusCode) {
+    // Handle array of Salesforce error objects
+    if (Array.isArray(error)) {
+        const messages = error.map((e) => {
+            let msg = e.message;
+            if (e.errorCode) {
+                msg = `[${e.errorCode}] ${msg}`;
+            }
+            if (e.fields && e.fields.length > 0) {
+                msg += ` (Fields: ${e.fields.join(', ')})`;
+            }
+            return msg;
+        });
+        return messages.join('; ');
+    }
+    // Handle string error
+    let errorMsg = error;
+    if (statusCode === 401) {
+        errorMsg += '\n\nHint: Your Salesforce access token may be expired. Try refreshing your OAuth credentials.';
+    }
+    else if (statusCode === 403) {
+        errorMsg += '\n\nHint: You may not have permission to access this resource. Check your Salesforce profile permissions.';
+    }
+    else if (statusCode === 404) {
+        errorMsg += '\n\nHint: The requested resource was not found. Check that the ID or object type is correct.';
+    }
+    else if (statusCode === 400) {
+        errorMsg += '\n\nHint: The request was malformed. Check your field names and data types.';
+    }
+    return errorMsg;
+}
+/**
+ * Parse Salesforce API error response
+ * @param responseBody Response body from Salesforce API
+ * @returns Array of error objects or string error
+ */
+export function parseSalesforceError(responseBody) {
+    if (Array.isArray(responseBody)) {
+        return responseBody;
+    }
+    if (typeof responseBody === 'string') {
+        return responseBody;
+    }
+    if (typeof responseBody === 'object' &&
+        responseBody !== null &&
+        'message' in responseBody) {
+        return [responseBody];
+    }
+    return 'Unknown Salesforce API error';
+}
+/**
+ * Get the instance URL from OAuth token response metadata
+ * @param instanceUrl Instance URL from OAuth response
+ * @returns Cleaned instance URL (without trailing slash)
+ */
+export function cleanInstanceUrl(instanceUrl) {
+    return instanceUrl.replace(/\/$/, '');
+}
+/**
+ * Get Salesforce API version
+ * @returns Current API version string
+ */
+export function getSalesforceApiVersion() {
+    return 'v59.0'; // Winter '24 release - current stable version
+}
+/**
+ * Build Salesforce REST API URL
+ * @param instanceUrl Salesforce instance URL
+ * @param endpoint API endpoint path
+ * @returns Full API URL
+ */
+export function buildApiUrl(instanceUrl, endpoint) {
+    const cleanedInstance = cleanInstanceUrl(instanceUrl);
+    const version = getSalesforceApiVersion();
+    // Handle endpoints that already include the services path
+    if (endpoint.startsWith('/services/')) {
+        return `${cleanedInstance}${endpoint}`;
+    }
+    // Standard data API endpoints
+    return `${cleanedInstance}/services/data/${version}${endpoint}`;
+}
+//# sourceMappingURL=salesforce.utils.js.map

package/dist/bubbles/service-bubble/salesforce/salesforce.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"salesforce.utils.js","sourceRoot":"","sources":["../../../../src/bubbles/service-bubble/salesforce/salesforce.utils.ts"],"names":[],"mappings":"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"}