@jsforce/jsforce-node 3.10.4 → 3.10.6

package/README.md

@@ -55,6 +55,9 @@ See [license](LICENSE) (MIT License).
 
 ## Notes
 
+### SOAP Login API Deprecation Notice
+The SOAP login() API will be retired in Summer '27 (API version 65.0). If you are using the `loginBySoap` method, please migrate to OAuth 2.0 Username-Password Flow instead. For more information, see [Salesforce Release Notes](https://help.salesforce.com/s/articleView?id=release-notes.rn_api_upcoming_retirement_258rn.htm&release=258&type=5).
+
 If you have any questions first file it on [issues](https://github.com/jsforce/jsforce/issues) before contacting authors via e-mail.
 
 ## How to build/run tests:

package/lib/VERSION.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "3.10.4";
+declare const _default: "3.10.6";
 export default _default;

package/lib/VERSION.js

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = '3.10.4';
+exports.default = '3.10.6';

package/lib/api/analytics.d.ts

@@ -150,7 +150,7 @@ export declare class Analytics<S extends Schema> {
     /**
      * Get recent report list
      */
-    reports(): import("../util/promise").StreamPromise<ReportInfo[]>;
+    reports(): import("../types").StreamPromise<ReportInfo[]>;
     /**
      * Get dashboard object of Analytics API
      */
@@ -158,6 +158,6 @@ export declare class Analytics<S extends Schema> {
     /**
      * Get recent dashboard list
      */
-    dashboards(): import("../util/promise").StreamPromise<DashboardInfo[]>;
+    dashboards(): import("../types").StreamPromise<DashboardInfo[]>;
 }
 export default Analytics;

package/lib/api/apex.d.ts

@@ -19,26 +19,26 @@ export declare class Apex<S extends Schema> {
     /**
      * Call Apex REST service in GET request
      */
-    get<R = unknown>(path: string, options?: Object): import("../util/promise").StreamPromise<R>;
+    get<R = unknown>(path: string, options?: Object): import("../types").StreamPromise<R>;
     /**
      * Call Apex REST service in POST request
      */
-    post<R = unknown>(path: string, body?: Object, options?: Object): import("../util/promise").StreamPromise<R>;
+    post<R = unknown>(path: string, body?: Object, options?: Object): import("../types").StreamPromise<R>;
     /**
      * Call Apex REST service in PUT request
      */
-    put<R = unknown>(path: string, body?: Object, options?: Object): import("../util/promise").StreamPromise<R>;
+    put<R = unknown>(path: string, body?: Object, options?: Object): import("../types").StreamPromise<R>;
     /**
      * Call Apex REST service in PATCH request
      */
-    patch<R = unknown>(path: string, body?: Object, options?: Object): import("../util/promise").StreamPromise<R>;
+    patch<R = unknown>(path: string, body?: Object, options?: Object): import("../types").StreamPromise<R>;
     /**
      * Call Apex REST service in DELETE request
      */
-    delete<R = unknown>(path: string, options?: Object): import("../util/promise").StreamPromise<R>;
+    delete<R = unknown>(path: string, options?: Object): import("../types").StreamPromise<R>;
     /**
      * Synonym of Apex#delete()
      */
-    del: <R = unknown>(path: string, options?: Object) => import("../util/promise").StreamPromise<R>;
+    del: <R = unknown>(path: string, options?: Object) => import("../types").StreamPromise<R>;
 }
 export default Apex;

package/lib/api/bulk.d.ts

@@ -220,7 +220,7 @@ export declare class Bulk<S extends Schema> {
     /**
      *
      */
-    _request<T>(request_: BulkRequest): import("../util/promise").StreamPromise<T>;
+    _request<T>(request_: BulkRequest): import("../types").StreamPromise<T>;
     /**
      * Create and start bulkload job and batch
      *

package/lib/api/chatter.d.ts

@@ -109,7 +109,7 @@ export declare class Chatter<S extends Schema> {
      * Sending request to API endpoint
      * @private
      */
-    _request<R>(req_: ChatterRequestParams): import("../util/promise").StreamPromise<R>;
+    _request<R>(req_: ChatterRequestParams): import("../types").StreamPromise<R>;
     /**
      * Convert path to site root relative url
      * @private

package/lib/api/tooling.d.ts

@@ -263,22 +263,22 @@ export declare class Tooling<S extends Schema> {
     /**
      *
      */
-    request<R = unknown>(request: string | HttpRequest, options?: Object): import("../util/promise").StreamPromise<R>;
+    request<R = unknown>(request: string | HttpRequest, options?: Object): import("../types").StreamPromise<R>;
     /**
      * Executes Apex code anonymously
      */
-    executeAnonymous(body: string): import("../util/promise").StreamPromise<ExecuteAnonymousResult>;
+    executeAnonymous(body: string): import("../types").StreamPromise<ExecuteAnonymousResult>;
     /**
      * Executes Apex tests asynchronously
      */
-    runTestsAsynchronous(req: RunTestsAsyncRequest): import("../util/promise").StreamPromise<string | null>;
+    runTestsAsynchronous(req: RunTestsAsyncRequest): import("../types").StreamPromise<string | null>;
     /**
      * Executes Apex tests synchronously
      */
-    runTestsSynchronous(req: RunTestsRequest): import("../util/promise").StreamPromise<RunTestsResult | null>;
+    runTestsSynchronous(req: RunTestsRequest): import("../types").StreamPromise<RunTestsResult | null>;
     /**
      * Retrieves available code completions of the referenced type
      */
-    completions(type?: 'apex' | 'visualforce'): import("../util/promise").StreamPromise<CompletionsResult>;
+    completions(type?: 'apex' | 'visualforce'): import("../types").StreamPromise<CompletionsResult>;
 }
 export default Tooling;

package/lib/connection.d.ts

@@ -129,7 +129,10 @@ export declare class Connection<S extends Schema = Schema> extends EventEmitter
      */
     loginByOAuth2(username: string, password: string): Promise<UserInfo>;
     /**
-     *
+     * Login by SOAP protocol
+     * @deprecated The SOAP login() API will be retired in Summer '27 (API version 65.0).
+     * Please use OAuth 2.0 Username-Password Flow instead.
+     * For more information, see https://help.salesforce.com/s/articleView?id=release-notes.rn_api_upcoming_retirement_258rn.htm&release=258&type=5
      */
     loginBySoap(username: string, password: string): Promise<UserInfo>;
     /**

package/lib/connection.js

@@ -383,9 +383,15 @@ class Connection extends events_1.EventEmitter {
         return userInfo;
     }
     /**
-     *
+     * Login by SOAP protocol
+     * @deprecated The SOAP login() API will be retired in Summer '27 (API version 65.0).
+     * Please use OAuth 2.0 Username-Password Flow instead.
+     * For more information, see https://help.salesforce.com/s/articleView?id=release-notes.rn_api_upcoming_retirement_258rn.htm&release=258&type=5
      */
     async loginBySoap(username, password) {
+        this._logger.warn('DEPRECATION WARNING: The SOAP login() API will be retired in Summer \'27 (API version 65.0). ' +
+            'Please use OAuth 2.0 Username-Password Flow instead. ' +
+            'For more information, see https://help.salesforce.com/s/articleView?id=release-notes.rn_api_upcoming_retirement_258rn.htm&release=258&type=5');
         if (!username || !password) {
             return Promise.reject(new Error('no username password given'));
         }

package/lib/index.d.ts

@@ -10,4 +10,5 @@ import './api/streaming';
 import './api/tooling';
 export * from './types';
 export * from './core';
+export * from './util/promise';
 export default jsforce;

package/lib/index.js

@@ -29,4 +29,5 @@ require("./api/streaming");
 require("./api/tooling");
 __exportStar(require("./types"), exports);
 __exportStar(require("./core"), exports);
+__exportStar(require("./util/promise"), exports);
 exports.default = jsforce_1.default;

package/lib/process.d.ts

@@ -39,7 +39,7 @@ export declare class ProcessRule<S extends Schema> {
     /**
      * Trigger process rule for given entities
      */
-    trigger(contextIds: string | string[]): import("./util/promise").StreamPromise<{
+    trigger(contextIds: string | string[]): import("./types").StreamPromise<{
         errors: null;
         success: true;
     } | {
@@ -98,7 +98,7 @@ export declare class ApprovalProcess<S extends Schema> {
     /**
      * Send bulk requests for approval process
      */
-    request(requests: Array<ApprovalProcessRequestConfig | ApprovalProcessRequest<S>>): import("./util/promise").StreamPromise<ApprovalProcessRequestResult[]>;
+    request(requests: Array<ApprovalProcessRequestConfig | ApprovalProcessRequest<S>>): import("./types").StreamPromise<ApprovalProcessRequestResult[]>;
     /**
      * Create approval process request
      *

package/lib/query.d.ts

@@ -288,6 +288,11 @@ export declare class Query<S extends Schema, N extends SObjectNames<S>, R extend
     update<UR extends SObjectInputRecord<S, N>>(mapping: ((rec: R) => UR) | UR, type: N, options?: QueryUpdateOptions): Promise<SaveResult[]>;
     update<UR extends SObjectInputRecord<S, N>>(mapping: ((rec: R) => UR) | UR, options?: QueryUpdateOptions): Promise<SaveResult[]>;
     private mapBulkV2ResultsToSaveResults;
+    /**
+     * Fetches all records for a subquery field by following nextRecordsUrl
+     * @private
+     */
+    private _fetchAllSubqueryRecords;
 }
 /**
  * SubQuery object for representing child relationship query

package/lib/query.js

@@ -373,6 +373,23 @@ class Query extends events_1.EventEmitter {
         const data = await this._conn.request({ method: 'GET', url, headers });
         this.emit('fetch');
         this.totalSize = data.totalSize;
+        // If autoFetch is true, fetch all records for any subqueries
+        if (autoFetch && data.records.length > 0) {
+            const recordKeys = Object.keys(data.records[0]);
+            for (const record of data.records) {
+                for (const key of recordKeys) {
+                    const field = record[key];
+                    if (field && typeof field === 'object' && 'records' in field && 'nextRecordsUrl' in field) {
+                        record[key] = {
+                            ...field,
+                            records: await this._fetchAllSubqueryRecords(record, key, headers),
+                            done: true,
+                            nextRecordsUrl: undefined
+                        };
+                    }
+                }
+            }
+        }
         this.records = this.records?.concat(maxFetch - this.records.length > data.records.length
             ? data.records
             : data.records.slice(0, maxFetch - this.records.length));
@@ -741,6 +758,30 @@ class Query extends events_1.EventEmitter {
         });
         return [...successSaveResults, ...failedSaveResults];
     }
+    /**
+     * Fetches all records for a subquery field by following nextRecordsUrl
+     * @private
+     */
+    async _fetchAllSubqueryRecords(record, fieldName, headers) {
+        const subqueryField = record[fieldName];
+        if (!subqueryField || !subqueryField.records) {
+            return [];
+        }
+        let allRecords = [...subqueryField.records];
+        let nextRecordsUrl = subqueryField.nextRecordsUrl;
+        while (nextRecordsUrl) {
+            // When following nextRecordsUrl for a subquery, we need to preserve the relationship context
+            // by using the full URL as-is rather than trying to reconstruct it
+            const data = await this._conn.request({
+                method: 'GET',
+                url: nextRecordsUrl,
+                headers
+            });
+            allRecords = allRecords.concat(data.records);
+            nextRecordsUrl = data.nextRecordsUrl;
+        }
+        return allRecords;
+    }
 }
 exports.Query = Query;
 /*--------------------------------------------*/

package/lib/sobject.d.ts

@@ -198,7 +198,7 @@ export declare class SObject<S extends Schema, N extends SObjectNames<S>, FieldN
      * @param {Callback.<ListViewsInfo>} [callback] - Callback function
      * @returns {Promise.<ListViewsInfo>}
      */
-    listviews(): import("./util/promise").StreamPromise<unknown>;
+    listviews(): import("./types").StreamPromise<unknown>;
     /**
      * Returns the list view info in specifed view id
      *
@@ -212,7 +212,7 @@ export declare class SObject<S extends Schema, N extends SObjectNames<S>, FieldN
      * @param {Callback.<Array.<QuickAction~QuickActionInfo>>} [callback] - Callback function
      * @returns {Promise.<Array.<QuickAction~QuickActionInfo>>}
      */
-    quickActions(): import("./util/promise").StreamPromise<unknown>;
+    quickActions(): import("./types").StreamPromise<unknown>;
     /**
      * Get reference for specified quick aciton in the SObject
      *
@@ -241,7 +241,7 @@ declare class ListView {
     /**
      * Executes query for the list view and returns the resulting data and presentation information.
      */
-    results(): import("./util/promise").StreamPromise<unknown>;
+    results(): import("./types").StreamPromise<unknown>;
     /**
      * Returns detailed information about a list view
      */
@@ -249,10 +249,10 @@ declare class ListView {
         headers?: {
             [name: string]: string;
         };
-    }): import("./util/promise").StreamPromise<unknown>;
+    }): import("./types").StreamPromise<unknown>;
     /**
      * Explain plan for executing list view
      */
-    explain(): import("./util/promise").StreamPromise<any>;
+    explain(): import("./types").StreamPromise<any>;
 }
 export default SObject;

package/lib/types/index.d.ts

@@ -5,3 +5,4 @@ export * from './record';
 export * from './util';
 export * from './soap';
 export * from './standard-schema';
+export * from '../util/promise';

package/lib/types/index.js

@@ -21,3 +21,4 @@ __exportStar(require("./record"), exports);
 __exportStar(require("./util"), exports);
 __exportStar(require("./soap"), exports);
 __exportStar(require("./standard-schema"), exports);
+__exportStar(require("../util/promise"), exports);

package/package.json

@@ -10,7 +10,7 @@
     "database.com"
   ],
   "homepage": "http://github.com/jsforce/jsforce",
-  "version": "3.10.4",
+  "version": "3.10.6",
   "repository": {
     "type": "git",
     "url": "git://github.com/jsforce/jsforce.git"
@@ -243,6 +243,7 @@
     "karma-sourcemap-loader": "^0.4.0",
     "karma-webpack": "^5.0.0",
     "nock": "^13.4.0",
+    "os-browserify": "^0.3.0",
     "path-browserify": "^1.0.1",
     "power-assert": "^1.6.1",
     "prettier": "^2.2.1",