@peernova/cuneiform-sf 1.0.2 → 1.0.4-beta.8

package/lib/adapters/soql/cuneiform-query-builder.js

@@ -0,0 +1,559 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import { composeQuery, getField, } from '@jetstreamapp/soql-parser-js';
+/**
+ * Fluent query builder for constructing type-safe SOQL queries.
+ *
+ * This class wraps @jetstreamapp/soql-parser-js to provide a fluent API
+ * for building SOQL queries programmatically, replacing ad-hoc string
+ * concatenation patterns throughout the codebase.
+ *
+ * @example Simple query
+ * ```typescript
+ * const soql = new CuneiformQueryBuilder()
+ *   .select(['Id', 'Name', 'CreatedDate'])
+ *   .from('Account')
+ *   .where('Industry', '=', 'Technology')
+ *   .orderBy('Name', 'ASC')
+ *   .limit(50)
+ *   .toSOQL();
+ * ```
+ *
+ * @example Aggregate query
+ * ```typescript
+ * const soql = new CuneiformQueryBuilder()
+ *   .count()
+ *   .from('Account')
+ *   .toSOQL();
+ * // Result: SELECT COUNT() FROM Account
+ * ```
+ *
+ * @example Complex WHERE with IN clause
+ * ```typescript
+ * const soql = new CuneiformQueryBuilder()
+ *   .select(['Id', 'Name'])
+ *   .from('PermissionSetAssignment')
+ *   .where('AssigneeId', '=', userId)
+ *   .andWhereIn('PermissionSet.Name', ['CuneiformUser', 'CuneiformAdmin'])
+ *   .toSOQL();
+ * ```
+ */
+export class CuneiformQueryBuilder {
+    fields = [];
+    sObject = '';
+    conditions = [];
+    firstCondition;
+    orderByFields = [];
+    limitValue;
+    offsetValue;
+    groupByFields = [];
+    havingCondition;
+    isCountQuery = false;
+    /**
+     * Returns a new builder instance (for reuse patterns).
+     *
+     * @returns A new CuneiformQueryBuilder instance
+     */
+    static create() {
+        return new CuneiformQueryBuilder();
+    }
+    /**
+     * Escapes special characters in SOQL string values.
+     *
+     * @param value - The string value to escape
+     * @returns The escaped string
+     */
+    static escapeString(value) {
+        // Escape single quotes by doubling them (SOQL standard)
+        // Also escape backslashes
+        return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+    }
+    /**
+     * Creates a simple comparison condition.
+     */
+    static createCondition(field, operator, value) {
+        let formattedValue;
+        let literalType;
+        if (typeof value === 'string') {
+            formattedValue = `'${CuneiformQueryBuilder.escapeString(value)}'`;
+            literalType = 'STRING';
+        }
+        else if (typeof value === 'boolean') {
+            formattedValue = String(value).toUpperCase();
+            literalType = 'BOOLEAN';
+        }
+        else {
+            formattedValue = String(value);
+            literalType = 'INTEGER';
+        }
+        return {
+            field,
+            operator: operator,
+            value: formattedValue,
+            literalType,
+        };
+    }
+    /**
+     * Creates an IN or NOT IN condition.
+     */
+    static createInCondition(field, values, isNotIn) {
+        const formattedValues = values.map((v) => {
+            if (typeof v === 'string') {
+                return `'${CuneiformQueryBuilder.escapeString(v)}'`;
+            }
+            return String(v);
+        });
+        const literalType = typeof values[0] === 'string' ? 'STRING' : 'INTEGER';
+        return {
+            field,
+            operator: isNotIn ? 'NOT IN' : 'IN',
+            value: formattedValues,
+            literalType: values.map(() => literalType),
+        };
+    }
+    /**
+     * Specifies the fields to select in the query.
+     *
+     * @param fields - Array of field API names (supports relationship notation like 'Account.Name')
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.select(['Id', 'Name', 'Account.Name', 'CreatedDate'])
+     * ```
+     */
+    select(fields) {
+        this.fields = fields.map((field) => getField(field));
+        this.isCountQuery = false;
+        return this;
+    }
+    /**
+     * Creates a COUNT() aggregate query.
+     *
+     * When using count(), do not call select() as COUNT() replaces field selection.
+     *
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * const soql = builder.count().from('Account').toSOQL();
+     * // Result: SELECT COUNT() FROM Account
+     * ```
+     */
+    count() {
+        this.isCountQuery = true;
+        this.fields = [];
+        return this;
+    }
+    /**
+     * Specifies the sObject to query.
+     *
+     * @param objectName - The API name of the Salesforce object
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.from('Account')
+     * builder.from('Profiling_Definition__c')
+     * ```
+     */
+    from(objectName) {
+        this.sObject = objectName;
+        return this;
+    }
+    /**
+     * Adds a WHERE condition to the query.
+     *
+     * This is the initial WHERE condition. Use andWhere() or orWhere() to add additional conditions.
+     *
+     * @param field - The field API name
+     * @param operator - The comparison operator
+     * @param value - The value to compare against (automatically escaped for strings)
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.where('Industry', '=', 'Technology')
+     * builder.where('Amount', '>', 1000)
+     * builder.where('Name', 'LIKE', 'Acme%')
+     * ```
+     */
+    where(field, operator, value) {
+        this.firstCondition = CuneiformQueryBuilder.createCondition(field, operator, value);
+        this.conditions = [];
+        return this;
+    }
+    /**
+     * Adds an AND condition to the WHERE clause.
+     *
+     * @param field - The field API name
+     * @param operator - The comparison operator
+     * @param value - The value to compare against
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder
+     *   .where('Industry', '=', 'Technology')
+     *   .andWhere('IsActive', '=', true)
+     *   .andWhere('Revenue', '>', 1000000)
+     * ```
+     */
+    andWhere(field, operator, value) {
+        const condition = CuneiformQueryBuilder.createCondition(field, operator, value);
+        this.addCondition(condition, 'AND');
+        return this;
+    }
+    /**
+     * Adds an OR condition to the WHERE clause.
+     *
+     * @param field - The field API name
+     * @param operator - The comparison operator
+     * @param value - The value to compare against
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder
+     *   .where('Status', '=', 'Active')
+     *   .orWhere('Status', '=', 'Pending')
+     * ```
+     */
+    orWhere(field, operator, value) {
+        const condition = CuneiformQueryBuilder.createCondition(field, operator, value);
+        this.addCondition(condition, 'OR');
+        return this;
+    }
+    /**
+     * Adds an IN clause condition to the WHERE clause with AND logic.
+     *
+     * @param field - The field API name
+     * @param values - Array of values for the IN clause
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.andWhereIn('PermissionSet.Name', ['CuneiformUser', 'CuneiformAdmin'])
+     * // Generates: ... AND PermissionSet.Name IN ('CuneiformUser', 'CuneiformAdmin')
+     * ```
+     */
+    andWhereIn(field, values) {
+        const condition = CuneiformQueryBuilder.createInCondition(field, values, false);
+        this.addCondition(condition, 'AND');
+        return this;
+    }
+    /**
+     * Adds a NOT IN clause condition to the WHERE clause with AND logic.
+     *
+     * @param field - The field API name
+     * @param values - Array of values for the NOT IN clause
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.andWhereNotIn('Status', ['Complete', 'Failed', 'Cancelled'])
+     * // Generates: ... AND Status NOT IN ('Complete', 'Failed', 'Cancelled')
+     * ```
+     */
+    andWhereNotIn(field, values) {
+        const condition = CuneiformQueryBuilder.createInCondition(field, values, true);
+        this.addCondition(condition, 'AND');
+        return this;
+    }
+    /**
+     * Adds an IN clause condition to the WHERE clause with OR logic.
+     *
+     * @param field - The field API name
+     * @param values - Array of values for the IN clause
+     * @returns this for method chaining
+     */
+    orWhereIn(field, values) {
+        const condition = CuneiformQueryBuilder.createInCondition(field, values, false);
+        this.addCondition(condition, 'OR');
+        return this;
+    }
+    /**
+     * Adds a NULL check condition with AND logic.
+     *
+     * @param field - The field API name
+     * @param isNull - true for IS NULL, false for IS NOT NULL
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.andWhereNull('ParentId', true)  // ParentId = null
+     * builder.andWhereNull('Email', false)    // Email != null
+     * ```
+     */
+    andWhereNull(field, isNull = true) {
+        const condition = {
+            field,
+            operator: isNull ? '=' : '!=',
+            value: 'null',
+            literalType: 'NULL',
+        };
+        this.addCondition(condition, 'AND');
+        return this;
+    }
+    /**
+     * Adds a DATETIME literal condition with AND logic.
+     *
+     * DATETIME literals in SOQL are not quoted and follow the format:
+     * YYYY-MM-DDTHH:MM:SSZ (e.g., 2024-01-01T00:00:00Z)
+     *
+     * @param field - The field API name (typically CreatedDate, LastModifiedDate, etc.)
+     * @param operator - The comparison operator
+     * @param datetimeValue - ISO 8601 datetime string (e.g., '2024-01-01T00:00:00Z')
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder
+     *   .select(['Id'])
+     *   .from('Account')
+     *   .andWhereDatetime('CreatedDate', '>=', '2024-01-01T00:00:00Z')
+     *   .andWhereDatetime('CreatedDate', '<', '2025-01-01T00:00:00Z')
+     * ```
+     */
+    andWhereDatetime(field, operator, datetimeValue) {
+        const condition = {
+            field,
+            operator: operator,
+            value: datetimeValue,
+            literalType: 'DATETIME',
+        };
+        this.addCondition(condition, 'AND');
+        return this;
+    }
+    /**
+     * Adds a DATETIME literal as the initial WHERE condition.
+     *
+     * @param field - The field API name
+     * @param operator - The comparison operator
+     * @param datetimeValue - ISO 8601 datetime string
+     * @returns this for method chaining
+     */
+    whereDatetime(field, operator, datetimeValue) {
+        this.firstCondition = {
+            field,
+            operator: operator,
+            value: datetimeValue,
+            literalType: 'DATETIME',
+        };
+        this.conditions = [];
+        return this;
+    }
+    /**
+     * Adds an ORDER BY clause.
+     *
+     * @param field - The field API name to sort by
+     * @param order - Sort direction ('ASC' or 'DESC')
+     * @param nullsOrder - Optional null handling ('NULLS FIRST' or 'NULLS LAST')
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.orderBy('Name', 'ASC')
+     * builder.orderBy('CreatedDate', 'DESC', 'NULLS LAST')
+     * ```
+     */
+    orderBy(field, order = 'ASC', nullsOrder) {
+        const orderByClause = {
+            field,
+            order,
+        };
+        if (nullsOrder) {
+            orderByClause.nulls = nullsOrder === 'NULLS FIRST' ? 'FIRST' : 'LAST';
+        }
+        this.orderByFields.push(orderByClause);
+        return this;
+    }
+    /**
+     * Adds a LIMIT clause to the query.
+     *
+     * @param count - Maximum number of records to return
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.limit(50)
+     * ```
+     */
+    limit(count) {
+        this.limitValue = count;
+        return this;
+    }
+    /**
+     * Adds an OFFSET clause for pagination.
+     *
+     * @param count - Number of records to skip
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder.limit(50).offset(100)  // Skip first 100, return next 50
+     * ```
+     */
+    offset(count) {
+        if (count !== undefined && count > 0) {
+            this.offsetValue = count;
+        }
+        return this;
+    }
+    /**
+     * Adds a GROUP BY clause for aggregate queries.
+     *
+     * @param fields - Array of field API names to group by
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * const soql = builder
+     *   .select(['SobjectType'])
+     *   .from('RecordType')
+     *   .where('IsActive', '=', true)
+     *   .groupBy(['SobjectType'])
+     *   .toSOQL();
+     * ```
+     */
+    groupBy(fields) {
+        this.groupByFields = fields.map((f) => ({ field: f }));
+        return this;
+    }
+    /**
+     * Adds a HAVING clause for filtering grouped results.
+     *
+     * @param field - The aggregate function or field to filter on
+     * @param operator - The comparison operator
+     * @param value - The value to compare against
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * builder
+     *   .select(['Industry', 'COUNT(Id)'])
+     *   .from('Account')
+     *   .groupBy(['Industry'])
+     *   .having('COUNT(Id)', '>', 5)
+     * ```
+     */
+    having(field, operator, value) {
+        this.havingCondition = CuneiformQueryBuilder.createCondition(field, operator, value);
+        return this;
+    }
+    /**
+     * Generates the SOQL query string.
+     *
+     * @returns The complete SOQL query string
+     * @throws Error if required components (fields or sObject) are missing
+     *
+     * @example
+     * ```typescript
+     * const soql = builder
+     *   .select(['Id', 'Name'])
+     *   .from('Account')
+     *   .where('Industry', '=', 'Technology')
+     *   .toSOQL();
+     * // Returns: "SELECT Id, Name FROM Account WHERE Industry = 'Technology'"
+     * ```
+     */
+    toSOQL() {
+        this.validate();
+        const query = {
+            sObject: this.sObject,
+        };
+        // Handle COUNT() vs regular SELECT
+        if (this.isCountQuery) {
+            query.fields = [{ type: 'FieldFunctionExpression', functionName: 'COUNT', parameters: [], isAggregateFn: true }];
+        }
+        else {
+            query.fields = this.fields;
+        }
+        // Build WHERE clause
+        const whereClause = this.buildWhereClause();
+        if (whereClause) {
+            query.where = whereClause;
+        }
+        if (this.orderByFields.length > 0) {
+            query.orderBy = this.orderByFields;
+        }
+        if (this.limitValue !== undefined) {
+            query.limit = this.limitValue;
+        }
+        if (this.offsetValue !== undefined) {
+            query.offset = this.offsetValue;
+        }
+        if (this.groupByFields.length > 0) {
+            query.groupBy = this.groupByFields;
+        }
+        if (this.havingCondition) {
+            query.having = { left: this.havingCondition };
+        }
+        return composeQuery(query, { format: false });
+    }
+    /**
+     * Validates the query has required components.
+     */
+    validate() {
+        if (!this.sObject) {
+            throw new Error('Query must specify a sObject using from()');
+        }
+        if (!this.isCountQuery && this.fields.length === 0) {
+            throw new Error('Query must specify fields using select() or use count() for aggregate queries');
+        }
+    }
+    /**
+     * Adds a condition to the internal list.
+     */
+    addCondition(condition, operator) {
+        // If no first condition, make this the first
+        if (!this.firstCondition) {
+            this.firstCondition = condition;
+        }
+        else {
+            this.conditions.push({ condition, operator });
+        }
+    }
+    /**
+     * Builds the WHERE clause from accumulated conditions.
+     *
+     * The soql-parser-js library expects WHERE clauses in this format:
+     * A AND B AND C becomes:
+     * { left: A, operator: AND, right: { left: B, operator: AND, right: { left: C } } }
+     *
+     * We build from right to left to create the proper nesting structure.
+     */
+    buildWhereClause() {
+        if (!this.firstCondition) {
+            return undefined;
+        }
+        // If there are no additional conditions, just return the first one wrapped
+        if (this.conditions.length === 0) {
+            return { left: this.firstCondition };
+        }
+        // Build from right to left: start with the last condition
+        // and wrap it with previous conditions
+        let result = { left: this.conditions[this.conditions.length - 1].condition };
+        // Process conditions in reverse order (excluding the last one we already used)
+        for (let i = this.conditions.length - 2; i >= 0; i--) {
+            result = {
+                left: this.conditions[i].condition,
+                operator: this.conditions[i + 1].operator,
+                right: result,
+            };
+        }
+        // Finally wrap with the first condition using the first additional condition's operator
+        result = {
+            left: this.firstCondition,
+            operator: this.conditions[0].operator,
+            right: result,
+        };
+        return result;
+    }
+}
+//# sourceMappingURL=cuneiform-query-builder.js.map

package/lib/adapters/soql/cuneiform-query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cuneiform-query-builder.js","sourceRoot":"","sources":["../../../src/adapters/soql/cuneiform-query-builder.ts"],"names":[],"mappings":"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"}

package/lib/adapters/soql/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SOQL query adapter for Salesforce data queries.
+ *
+ * Provides the SoqlQueryAdapter for executing SOQL queries with
+ * automatic pagination, chunking, and queryAll support.
+ *
+ * Also provides CuneiformQueryBuilder for programmatic SOQL construction.
+ *
+ * @module adapters/soql
+ */
+export { SoqlQueryAdapter, type ISoqlQueryAdapter, type SoqlQueryAdapterConfig } from './soql-query-adapter.js';
+export { DEFAULT_CHUNK_SIZE, type ChunkOptions, type QueryResult } from './types.js';
+export { CuneiformQueryBuilder, type ICuneiformQueryBuilder, type SortOrder, type ComparisonOperator, type LogicalOperator, type NullsOrder, } from './cuneiform-query-builder.js';

package/lib/adapters/soql/index.js

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+/**
+ * SOQL query adapter for Salesforce data queries.
+ *
+ * Provides the SoqlQueryAdapter for executing SOQL queries with
+ * automatic pagination, chunking, and queryAll support.
+ *
+ * Also provides CuneiformQueryBuilder for programmatic SOQL construction.
+ *
+ * @module adapters/soql
+ */
+export { SoqlQueryAdapter } from './soql-query-adapter.js';
+export { DEFAULT_CHUNK_SIZE } from './types.js';
+export { CuneiformQueryBuilder, } from './cuneiform-query-builder.js';
+//# sourceMappingURL=index.js.map

package/lib/adapters/soql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/soql/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAuD,MAAM,yBAAyB,CAAC;AAChH,OAAO,EAAE,kBAAkB,EAAuC,MAAM,YAAY,CAAC;AACrF,OAAO,EACL,qBAAqB,GAMtB,MAAM,8BAA8B,CAAC"}