@salesforce/lds-runtime-mobile 1.259.0 → 1.261.0

package/dist/main.js

@@ -19,6 +19,7 @@ import { parseAndVisit, Kind, buildSchema, isObjectType, defaultFieldResolver, v
 import { RECORD_ID_PREFIX, RECORD_FIELDS_KEY_JUNCTION, isStoreKeyRecordViewEntity, getRecordId18, RECORD_REPRESENTATION_NAME, extractRecordIdFromStoreKey, keyBuilderQuickActionExecutionRepresentation, ingestQuickActionExecutionRepresentation, keyBuilderContentDocumentCompositeRepresentation, getResponseCacheKeysContentDocumentCompositeRepresentation, keyBuilderFromTypeContentDocumentCompositeRepresentation, ingestContentDocumentCompositeRepresentation, keyBuilderRecord, RECORD_VIEW_ENTITY_ID_PREFIX, getTypeCacheKeysRecord, keyBuilderFromTypeRecordRepresentation, ingestRecord, RecordRepresentationRepresentationType, ObjectInfoRepresentationType, getRecordAdapterFactory, getObjectInfoAdapterFactory, getObjectInfosAdapterFactory, getObjectInfoDirectoryAdapterFactory, UiApiNamespace, RecordRepresentationType, RecordRepresentationTTL, RecordRepresentationVersion, getRecordsAdapterFactory } from '@salesforce/lds-adapters-uiapi';
 import ldsIdempotencyWriteDisabled from '@salesforce/gate/lds.idempotencyWriteDisabled';
 import ldsBackdatingEnabled from '@salesforce/gate/lds.backdatingEnabled';
+import FIRST_DAY_OF_WEEK from '@salesforce/i18n/firstDayOfWeek';
 import caseSensitiveUserId from '@salesforce/user/Id';
 import { idleDetector, getInstrumentation } from 'o11y/client';
 import ldsUseShortUrlGate from '@salesforce/gate/lds.useShortUrl';
@@ -7453,16 +7454,21 @@ var DateRange;
 (function (DateRange) {
     DateRange["last_n_days"] = "last_n_days";
     DateRange["next_n_days"] = "next_n_days";
+    DateRange["n_days_ago"] = "n_days_ago";
     DateRange["last_n_weeks"] = "last_n_weeks";
     DateRange["next_n_weeks"] = "next_n_weeks";
+    DateRange["n_weeks_ago"] = "n_weeks_ago";
     DateRange["last_n_months"] = "last_n_months";
     DateRange["next_n_months"] = "next_n_months";
+    DateRange["n_months_ago"] = "n_months_ago";
     DateRange["last_n_quarters"] = "last_n_quarters";
     DateRange["next_n_quarters"] = "next_n_quarters";
+    DateRange["n_quarters_ago"] = "n_quarters_ago";
     DateRange["last_n_fiscal_quarters"] = "last_n_fiscal_quarters";
     DateRange["next_n_fiscal_quarters"] = "next_n_fiscal_quarters";
     DateRange["last_n_years"] = "last_n_years";
     DateRange["next_n_years"] = "next_n_years";
+    DateRange["n_years_ago"] = "n_years_ago";
     DateRange["last_n_fiscal_years"] = "last_n_fiscal_years";
     DateRange["next_n_fiscal_years"] = "next_n_fiscal_years";
 })(DateRange || (DateRange = {}));
@@ -7533,6 +7539,7 @@ function dateTimeRange(input, op, field, alias) {
         dataType: field.dataType,
     };
 }
+// relative date ranges defined at https://help.salesforce.com/s/articleView?id=sf.filter_dates_relative.htm&type=5
 function dateRangesFrom(dateRange, input, dateFunction) {
     // use 'start of day' to ensure the timestamp is 00:00:00 for date time values
     switch (dateRange) {
@@ -7562,7 +7569,86 @@ function dateRangesFrom(dateRange, input, dateFunction) {
                 },
             };
         }
-        // next_n_months range starts the first day of the next month at 00:00:00 and ends end of the nth month 23:59:59
+        // n_days_ago
+        // starts 12:00:00 am -(n) days from today
+        // ends 11:59:99 pm -(n) days from today
+        case DateRange.n_days_ago: {
+            return {
+                binding: {
+                    upper: `${-input + 1} days`,
+                    lower: `-${input} days`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'start of day', ?)`,
+                },
+            };
+        }
+        // next_n_weeks
+        // starts at 00:00:00 the first day of the week n weeks after the current week
+        // ends 23:59:59 of the last day of week before the current
+        case DateRange.next_n_weeks: {
+            const isStartOfWeek = isTodayStartOfWeek();
+            return {
+                binding: {
+                    // weekday FIRST_DAY_OF_WEEK goes to the next weekday of FIRST_DAY_OF_WEEK if not that current day
+                    // if that current day then it will be that day
+                    // so for the upper bound if today is the start of the week we need to add 7 more days to the value to get next week as the start
+                    upper: `${input * 7 + (isStartOfWeek ? 7 : 0)} days`,
+                    //lower bound starts out 00:00:00 of next week
+                    lower: `${isStartOfWeek ? 7 : 0} days`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?)`,
+                },
+            };
+        }
+        // last_n_weeks
+        // starts at 00:00:00 of day 0 n weeks before the current week
+        // ends 23:59:59 at last day of the week before the current week
+        case DateRange.last_n_weeks: {
+            const isStartOfWeek = isTodayStartOfWeek();
+            return {
+                binding: {
+                    // ending on at 23:59:59 of the week before the current week
+                    // -7 more days if today not start of week
+                    upper: `${-(isStartOfWeek ? 0 : 7)} days`,
+                    // starting on 00:00:00 of n * weeks before current week
+                    // -7 more days if today not the start of the week because weekday FIRST_DAY_OF_WEEK puts us next week day 0
+                    lower: `${-input * 7 - (isStartOfWeek ? 0 : 7)} days`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?)`,
+                },
+            };
+        }
+        // n_weeks_ago
+        // starts 00:00:00 on day 0 of n weeks before the current week
+        // ends 7 days after the start
+        case DateRange.n_weeks_ago: {
+            const isStartOfWeek = isTodayStartOfWeek();
+            return {
+                binding: {
+                    // end of week n weeks before current week
+                    // if today is start of the week then we need to -7 from the days given by n
+                    // so add 7 to remove a week from -(n)
+                    upper: `${-input * 7 + (isStartOfWeek ? 7 : 0)} days`,
+                    // start of the week n weeks from the current week
+                    // if today is the start of the week then -(n) will do to be the previous week, but
+                    // if today is not the start of the week we need to go back 1 more week since weekday FIRST_DAY_OF_WEEK will put us next week
+                    lower: `${-input * 7 - (isStartOfWeek ? 0 : 7)} days`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?)`,
+                },
+            };
+        }
+        // next_n_months
+        // starts the first day of the next month at 00:00:00 and
+        // ends end of the nth month 23:59:59
         case DateRange.next_n_months: {
             return {
                 binding: {
@@ -7575,7 +7661,8 @@ function dateRangesFrom(dateRange, input, dateFunction) {
                 },
             };
         }
-        // last_n_months range starts at 00:00:00 first day of n months before the current month and
+        // last_n_months
+        // starts at 00:00:00 first day of n months before the current month and
         // ends at 23:59:59 the last day of the month before the current month
         case DateRange.last_n_months: {
             return {
@@ -7589,11 +7676,125 @@ function dateRangesFrom(dateRange, input, dateFunction) {
                 },
             };
         }
+        // n_months_ago
+        // starts at the first day of the month 00:00:00 n months ago from now
+        // ends at 23:59:59 of n months ago
+        case DateRange.n_months_ago: {
+            return {
+                binding: {
+                    // need to go 1 less month back then -1 seconds to get the end of it
+                    upper: `${-input + 1} months`,
+                    lower: `-${input} months`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'start of month', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'start of month', ?)`,
+                },
+            };
+        }
+        // next_n_years
+        // starts 00:00:00 Jan 1st the year after the current year
+        // ends Dec 31 23:59:59 of the nth year
+        case DateRange.next_n_years: {
+            return {
+                binding: {
+                    upper: `+${input + 1} years`,
+                    lower: `+1 year`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'start of year', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'start of year', ?)`,
+                },
+            };
+        }
+        // last_n_years starts
+        // starts 00:00:00 Jan 1 n+1 year ago and
+        // ends dec 31 23:59:59 of the year before the current
+        case DateRange.last_n_years: {
+            return {
+                binding: {
+                    upper: `-1 seconds`,
+                    lower: `-${input + 1} years`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'start of year', ?)`,
+                    lower: `${dateFunction}('now', 'start of year', ?)`,
+                },
+            };
+        }
+        // n_years_ago
+        // starts 00:00:00 Jan 1 of n years before the current year and
+        // ends Dec 31 23:59:59 of that year
+        case DateRange.n_years_ago: {
+            return {
+                binding: {
+                    upper: `-${input - 1} years`,
+                    lower: `-${input} years`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'start of year', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'start of year', ?)`,
+                },
+            };
+        }
+        // next_n_quarters
+        // starts 00:00:00 first day of the quarter after the current quarter
+        // ends 23:59:59 of the last day of n quarters in the future
+        case DateRange.next_n_quarters: {
+            const currentQuarterString = quarterStart(new Date());
+            return {
+                binding: {
+                    // add another quarter input to -1 seconds to get the end of the last day of the quarter
+                    upper: `${(input + 1) * 3} months`,
+                    lower: `3 months`,
+                },
+                range: {
+                    upper: `${dateFunction}('${currentQuarterString}', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('${currentQuarterString}', 'start of day', ?)`,
+                },
+            };
+        }
+        // last_n_quarters
+        // starts 00:00:00 the first day of n quarters ago
+        // end 23:59:59 the last day of the quarter before the current quarter
+        case DateRange.last_n_quarters: {
+            const currentQuarterString = quarterStart(new Date());
+            return {
+                binding: {
+                    upper: `-1 seconds`,
+                    lower: `-${input * 3} months`,
+                },
+                range: {
+                    upper: `${dateFunction}('${currentQuarterString}', 'start of day', ?)`,
+                    lower: `${dateFunction}('${currentQuarterString}', 'start of day', ?)`,
+                },
+            };
+        }
+        // n_quarters_ago
+        // starts 00:00:00 first day of the quarter n quarters before the current
+        // ends 23:59:59 last day of the same quarter
+        case DateRange.n_quarters_ago: {
+            const currentQuarterString = quarterStart(new Date());
+            return {
+                binding: {
+                    // minus 1 quarter to be able to -1 seconds to get the end of the nth quarter
+                    upper: `-${(input - 1) * 3} months`,
+                    lower: `-${input * 3} months`,
+                },
+                range: {
+                    upper: `${dateFunction}('${currentQuarterString}', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('${currentQuarterString}', 'start of day', ?)`,
+                },
+            };
+        }
         default:
             // eslint-disable-next-line @salesforce/lds/no-error-in-production
             throw new Error(`DateRangeInput ${dateRange} is not supported in local evalutation`);
     }
 }
+function isTodayStartOfWeek() {
+    return new Date().getDay() === FIRST_DAY_OF_WEEK;
+}
 
 const JSON_EXTRACT_PATH_INGESTION_TIMESTAMP = '$.ingestionTimestamp';
 const JSON_EXTRACT_PATH_INGESTION_APINAME = '$.apiName';
@@ -14758,11 +14959,14 @@ function mergeBatchRecordsFields(first, second, collectionMergeFunc) {
  * @param endpoint Regular Expression to check the endpoint to aggregate
  * @returns undefined if we should not aggregate. object if we should.
  */
-function createAggregateBatchRequestInfo(resourceRequest, endpoint) {
+function createAggregateBatchRequestInfo(resourceRequest, endpoint, instrumentationSink) {
     // only handle GETs on the given endpoint regex
     if (!isGetRequestForEndpoint(endpoint, resourceRequest)) {
         return undefined;
     }
+    if (instrumentationSink) {
+        instrumentationSink.reportChunkCandidateUrlLength(calculateEstimatedTotalUrlLength(resourceRequest));
+    }
     const { queryParams: { fields, optionalFields }, } = resourceRequest;
     // only handle requests with fields or optional fields
     if (fields === undefined && optionalFields === undefined) {
@@ -14874,6 +15078,21 @@ function getMaxLengthPerChunkAllowed(request) {
     // MAX_URL_LENGTH  - full lenght without fields, optionalFields
     return MAX_URL_LENGTH - roughUrlLengthWithoutFieldsAndOptionFields;
 }
+// we don't have access to the host so we cannot calculate the exact length of the url
+// so we will estimate it
+function calculateEstimatedTotalUrlLength(request) {
+    const { baseUri, basePath, queryParams } = request;
+    let url = `${baseUri}${basePath}`;
+    if (queryParams) {
+        const queryParamString = entries$2(queryParams)
+            .map(([key, value]) => `${key}=${value}`)
+            .join('&');
+        if (queryParamString) {
+            url += `?${queryParamString}`;
+        }
+    }
+    return url.length;
+}
 
 const RECORD_ENDPOINT_REGEX = /^\/ui-api\/records\/?(([a-zA-Z0-9]+))?$/;
 const referenceId$3 = 'LDS_Records_AggregateUi';
@@ -14898,9 +15117,9 @@ function mergeGetRecordResult(first, second) {
     mergeRecordFields(first, second);
     return first;
 }
-function makeNetworkChunkFieldsGetRecord(networkAdapter) {
+function makeNetworkChunkFieldsGetRecord(networkAdapter, instrumentationSink) {
     return (resourceRequest, resourceRequestContext) => {
-        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RECORD_ENDPOINT_REGEX);
+        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RECORD_ENDPOINT_REGEX, instrumentationSink);
         if (batchRequestInfo === undefined) {
             return networkAdapter(resourceRequest, resourceRequestContext);
         }
@@ -14914,9 +15133,9 @@ function makeNetworkChunkFieldsGetRecord(networkAdapter) {
 
 const RECORDS_BATCH_ENDPOINT_REGEX = /^\/ui-api\/records\/batch\/?(([a-zA-Z0-9|,]+))?$/;
 const referenceId$2 = 'LDS_Records_Batch_AggregateUi';
-function makeNetworkChunkFieldsGetRecordsBatch(networkAdapter) {
+function makeNetworkChunkFieldsGetRecordsBatch(networkAdapter, intrumentationSink) {
     return (resourceRequest, resourceRequestContext) => {
-        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RECORDS_BATCH_ENDPOINT_REGEX);
+        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RECORDS_BATCH_ENDPOINT_REGEX, intrumentationSink);
         if (batchRequestInfo === undefined) {
             return networkAdapter(resourceRequest, resourceRequestContext);
         }
@@ -14962,9 +15181,9 @@ function mergeRelatedRecordsFields(first, second) {
         throw new Error('Aggregate UI response is invalid');
     }
 }
-function makeNetworkChunkFieldsGetRelatedListRecords(networkAdapter) {
+function makeNetworkChunkFieldsGetRelatedListRecords(networkAdapter, instrumentationSink) {
     return (resourceRequest, resourceRequestContext) => {
-        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RELATED_LIST_RECORDS_ENDPOINT_REGEX);
+        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RELATED_LIST_RECORDS_ENDPOINT_REGEX, instrumentationSink);
         if (batchRequestInfo === undefined) {
             return networkAdapter(resourceRequest, resourceRequestContext);
         }
@@ -15040,9 +15259,9 @@ function recordIdsAllMatch(first, second) {
 
 const RELATED_LIST_RECORDS_BATCH_ENDPOINT_REGEX = /^\/ui-api\/related-list-records\/batch\/?(([a-zA-Z0-9]+))?\//;
 const referenceId = 'LDS_Related_List_Records_AggregateUi';
-function makeNetworkChunkFieldsGetRelatedListRecordsBatch(networkAdapter) {
+function makeNetworkChunkFieldsGetRelatedListRecordsBatch(networkAdapter, instrumentationSink) {
     return (resourceRequest, resourceRequestContext) => {
-        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RELATED_LIST_RECORDS_BATCH_ENDPOINT_REGEX);
+        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RELATED_LIST_RECORDS_BATCH_ENDPOINT_REGEX, instrumentationSink);
         if (batchRequestInfo === undefined) {
             return networkAdapter(resourceRequest, resourceRequestContext);
         }
@@ -15065,7 +15284,7 @@ function makeNetworkChunkFieldsGetRelatedListRecordsBatch(networkAdapter) {
  *
  * @param networkAdapter the network adapter to do the call.
  */
-function makeNetworkAdapterChunkRecordFields(networkAdapter) {
+function makeNetworkAdapterChunkRecordFields(networkAdapter, instrumentationSink) {
     // endpoint handlers that support aggregate-ui field batching
     const batchHandlers = [
         makeNetworkChunkFieldsGetRecord,
@@ -15074,7 +15293,7 @@ function makeNetworkAdapterChunkRecordFields(networkAdapter) {
         makeNetworkChunkFieldsGetRelatedListRecordsBatch,
     ];
     return batchHandlers.reduce((network, handler) => {
-        return handler(network);
+        return handler(network, instrumentationSink);
     }, networkAdapter);
 }
 
@@ -15351,6 +15570,11 @@ function reportPrimingConflict(resolutionType, recordCount) {
         resolutionType,
     });
 }
+/** Network */
+function reportChunkCandidateUrlLength(urlLength) {
+    const buckets = [8000, 10000, 12000, 14000, 16000];
+    ldsMobileInstrumentation.bucketValue('chunk-candidate-url-length-histogram', urlLength, buckets);
+}
 
 /**
  * HOF (high-order-function) that instruments any async operation.  If the operation
@@ -17561,7 +17785,9 @@ function getRuntime() {
         const { newRecordId, isGenerated } = recordIdGenerator(userId);
         // non-draft-aware base services
         const store = new InMemoryStore();
-        lazyNetworkAdapter = platformNetworkAdapter(makeNetworkAdapterChunkRecordFields(NimbusNetworkAdapter));
+        lazyNetworkAdapter = platformNetworkAdapter(makeNetworkAdapterChunkRecordFields(NimbusNetworkAdapter, {
+            reportChunkCandidateUrlLength: reportChunkCandidateUrlLength,
+        }));
         lazyBaseDurableStore = getNimbusDurableStore();
         // specific adapters
         const internalAdapterStore = new InMemoryStore();
@@ -17690,4 +17916,4 @@ register({
 });
 
 export { O11Y_NAMESPACE_LDS_MOBILE, getRuntime, registerReportObserver, reportGraphqlQueryParseError };
-// version: 1.259.0-921ca6033
+// version: 1.261.0-faaa0c74a

package/dist/types/__mocks__/o11y/instrumentation.d.ts

@@ -3,12 +3,14 @@ declare function error(_err: Error, _userSchemaOrText?: string, _data?: any): vo
 declare function startActivity(_name: string): any;
 declare function incrementCounter(_operation: string, _increment?: number, _hasError?: boolean, _tags?: any): void;
 declare function trackValue(_operation: string, _value: number, _hasError?: boolean, _tags?: any): void;
+declare function bucketValue(_operation: string, _value: number, _buckets: number[]): void;
 export declare const instrumentation: {
     log: typeof log;
     error: typeof error;
     startActivity: typeof startActivity;
     incrementCounter: typeof incrementCounter;
     trackValue: typeof trackValue;
+    bucketValue: typeof bucketValue;
 };
 export declare const METRIC_KEYS: {};
 export {};

package/dist/types/instrumentation/metrics.d.ts

@@ -15,3 +15,5 @@ export declare function reportPrimingSessionCreated(): void;
 export declare function reportPrimingError(errorType: string, recordCount: number): void;
 export declare function reportPrimingSuccess(recordCount: number): void;
 export declare function reportPrimingConflict(resolutionType: string, recordCount: number): void;
+/** Network */
+export declare function reportChunkCandidateUrlLength(urlLength: number): void;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/lds-runtime-mobile",
-    "version": "1.259.0",
+    "version": "1.261.0",
     "license": "SEE LICENSE IN LICENSE.txt",
     "description": "LDS runtime for mobile/hybrid environments.",
     "main": "dist/main.js",
@@ -32,25 +32,25 @@
         "release:corejar": "yarn build && ../core-build/scripts/core.js --name=lds-runtime-mobile"
     },
     "dependencies": {
-        "@salesforce/lds-adapters-uiapi": "^1.259.0",
-        "@salesforce/lds-bindings": "^1.259.0",
-        "@salesforce/lds-instrumentation": "^1.259.0",
-        "@salesforce/lds-priming": "^1.259.0",
+        "@salesforce/lds-adapters-uiapi": "^1.261.0",
+        "@salesforce/lds-bindings": "^1.261.0",
+        "@salesforce/lds-instrumentation": "^1.261.0",
+        "@salesforce/lds-priming": "^1.261.0",
         "@salesforce/user": "0.0.21",
         "o11y": "244.0.0"
     },
     "devDependencies": {
-        "@salesforce/lds-adapters-graphql": "^1.259.0",
-        "@salesforce/lds-drafts": "^1.259.0",
-        "@salesforce/lds-drafts-adapters-uiapi": "^1.259.0",
-        "@salesforce/lds-graphql-eval": "^1.259.0",
-        "@salesforce/lds-network-adapter": "^1.259.0",
-        "@salesforce/lds-network-nimbus": "^1.259.0",
-        "@salesforce/lds-store-binary": "^1.259.0",
-        "@salesforce/lds-store-nimbus": "^1.259.0",
-        "@salesforce/lds-store-sql": "^1.259.0",
-        "@salesforce/lds-utils-adapters": "^1.259.0",
-        "@salesforce/nimbus-plugin-lds": "^1.259.0",
+        "@salesforce/lds-adapters-graphql": "^1.261.0",
+        "@salesforce/lds-drafts": "^1.261.0",
+        "@salesforce/lds-drafts-adapters-uiapi": "^1.261.0",
+        "@salesforce/lds-graphql-eval": "^1.261.0",
+        "@salesforce/lds-network-adapter": "^1.261.0",
+        "@salesforce/lds-network-nimbus": "^1.261.0",
+        "@salesforce/lds-store-binary": "^1.261.0",
+        "@salesforce/lds-store-nimbus": "^1.261.0",
+        "@salesforce/lds-store-sql": "^1.261.0",
+        "@salesforce/lds-utils-adapters": "^1.261.0",
+        "@salesforce/nimbus-plugin-lds": "^1.261.0",
         "babel-plugin-dynamic-import-node": "^2.3.3",
         "wait-for-expect": "^3.0.2"
     },
@@ -59,7 +59,7 @@
             "path": "./dist/main.js",
             "maxSize": {
                 "none": "800 kB",
-                "min": "310 kB",
+                "min": "315 kB",
                 "compressed": "150 kB"
             }
         },
@@ -67,7 +67,7 @@
             "path": "./sfdc/main.js",
             "maxSize": {
                 "none": "800 kB",
-                "min": "310 kB",
+                "min": "315 kB",
                 "compressed": "150 kB"
             }
         }

package/sfdc/main.js

@@ -19,6 +19,7 @@ import { parseAndVisit, Kind, buildSchema, isObjectType, defaultFieldResolver, v
 import { RECORD_ID_PREFIX, RECORD_FIELDS_KEY_JUNCTION, isStoreKeyRecordViewEntity, getRecordId18, RECORD_REPRESENTATION_NAME, extractRecordIdFromStoreKey, keyBuilderQuickActionExecutionRepresentation, ingestQuickActionExecutionRepresentation, keyBuilderContentDocumentCompositeRepresentation, getResponseCacheKeysContentDocumentCompositeRepresentation, keyBuilderFromTypeContentDocumentCompositeRepresentation, ingestContentDocumentCompositeRepresentation, keyBuilderRecord, RECORD_VIEW_ENTITY_ID_PREFIX, getTypeCacheKeysRecord, keyBuilderFromTypeRecordRepresentation, ingestRecord, RecordRepresentationRepresentationType, ObjectInfoRepresentationType, getRecordAdapterFactory, getObjectInfoAdapterFactory, getObjectInfosAdapterFactory, getObjectInfoDirectoryAdapterFactory, UiApiNamespace, RecordRepresentationType, RecordRepresentationTTL, RecordRepresentationVersion, getRecordsAdapterFactory } from 'force/ldsAdaptersUiapi';
 import ldsIdempotencyWriteDisabled from '@salesforce/gate/lds.idempotencyWriteDisabled';
 import ldsBackdatingEnabled from '@salesforce/gate/lds.backdatingEnabled';
+import FIRST_DAY_OF_WEEK from '@salesforce/i18n/firstDayOfWeek';
 import caseSensitiveUserId from '@salesforce/user/Id';
 import { idleDetector, getInstrumentation } from 'o11y/client';
 import ldsUseShortUrlGate from '@salesforce/gate/lds.useShortUrl';
@@ -7453,16 +7454,21 @@ var DateRange;
 (function (DateRange) {
     DateRange["last_n_days"] = "last_n_days";
     DateRange["next_n_days"] = "next_n_days";
+    DateRange["n_days_ago"] = "n_days_ago";
     DateRange["last_n_weeks"] = "last_n_weeks";
     DateRange["next_n_weeks"] = "next_n_weeks";
+    DateRange["n_weeks_ago"] = "n_weeks_ago";
     DateRange["last_n_months"] = "last_n_months";
     DateRange["next_n_months"] = "next_n_months";
+    DateRange["n_months_ago"] = "n_months_ago";
     DateRange["last_n_quarters"] = "last_n_quarters";
     DateRange["next_n_quarters"] = "next_n_quarters";
+    DateRange["n_quarters_ago"] = "n_quarters_ago";
     DateRange["last_n_fiscal_quarters"] = "last_n_fiscal_quarters";
     DateRange["next_n_fiscal_quarters"] = "next_n_fiscal_quarters";
     DateRange["last_n_years"] = "last_n_years";
     DateRange["next_n_years"] = "next_n_years";
+    DateRange["n_years_ago"] = "n_years_ago";
     DateRange["last_n_fiscal_years"] = "last_n_fiscal_years";
     DateRange["next_n_fiscal_years"] = "next_n_fiscal_years";
 })(DateRange || (DateRange = {}));
@@ -7533,6 +7539,7 @@ function dateTimeRange(input, op, field, alias) {
         dataType: field.dataType,
     };
 }
+// relative date ranges defined at https://help.salesforce.com/s/articleView?id=sf.filter_dates_relative.htm&type=5
 function dateRangesFrom(dateRange, input, dateFunction) {
     // use 'start of day' to ensure the timestamp is 00:00:00 for date time values
     switch (dateRange) {
@@ -7562,7 +7569,86 @@ function dateRangesFrom(dateRange, input, dateFunction) {
                 },
             };
         }
-        // next_n_months range starts the first day of the next month at 00:00:00 and ends end of the nth month 23:59:59
+        // n_days_ago
+        // starts 12:00:00 am -(n) days from today
+        // ends 11:59:99 pm -(n) days from today
+        case DateRange.n_days_ago: {
+            return {
+                binding: {
+                    upper: `${-input + 1} days`,
+                    lower: `-${input} days`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'start of day', ?)`,
+                },
+            };
+        }
+        // next_n_weeks
+        // starts at 00:00:00 the first day of the week n weeks after the current week
+        // ends 23:59:59 of the last day of week before the current
+        case DateRange.next_n_weeks: {
+            const isStartOfWeek = isTodayStartOfWeek();
+            return {
+                binding: {
+                    // weekday FIRST_DAY_OF_WEEK goes to the next weekday of FIRST_DAY_OF_WEEK if not that current day
+                    // if that current day then it will be that day
+                    // so for the upper bound if today is the start of the week we need to add 7 more days to the value to get next week as the start
+                    upper: `${input * 7 + (isStartOfWeek ? 7 : 0)} days`,
+                    //lower bound starts out 00:00:00 of next week
+                    lower: `${isStartOfWeek ? 7 : 0} days`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?)`,
+                },
+            };
+        }
+        // last_n_weeks
+        // starts at 00:00:00 of day 0 n weeks before the current week
+        // ends 23:59:59 at last day of the week before the current week
+        case DateRange.last_n_weeks: {
+            const isStartOfWeek = isTodayStartOfWeek();
+            return {
+                binding: {
+                    // ending on at 23:59:59 of the week before the current week
+                    // -7 more days if today not start of week
+                    upper: `${-(isStartOfWeek ? 0 : 7)} days`,
+                    // starting on 00:00:00 of n * weeks before current week
+                    // -7 more days if today not the start of the week because weekday FIRST_DAY_OF_WEEK puts us next week day 0
+                    lower: `${-input * 7 - (isStartOfWeek ? 0 : 7)} days`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?)`,
+                },
+            };
+        }
+        // n_weeks_ago
+        // starts 00:00:00 on day 0 of n weeks before the current week
+        // ends 7 days after the start
+        case DateRange.n_weeks_ago: {
+            const isStartOfWeek = isTodayStartOfWeek();
+            return {
+                binding: {
+                    // end of week n weeks before current week
+                    // if today is start of the week then we need to -7 from the days given by n
+                    // so add 7 to remove a week from -(n)
+                    upper: `${-input * 7 + (isStartOfWeek ? 7 : 0)} days`,
+                    // start of the week n weeks from the current week
+                    // if today is the start of the week then -(n) will do to be the previous week, but
+                    // if today is not the start of the week we need to go back 1 more week since weekday FIRST_DAY_OF_WEEK will put us next week
+                    lower: `${-input * 7 - (isStartOfWeek ? 0 : 7)} days`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'weekday ${FIRST_DAY_OF_WEEK}', 'start of day', ?)`,
+                },
+            };
+        }
+        // next_n_months
+        // starts the first day of the next month at 00:00:00 and
+        // ends end of the nth month 23:59:59
         case DateRange.next_n_months: {
             return {
                 binding: {
@@ -7575,7 +7661,8 @@ function dateRangesFrom(dateRange, input, dateFunction) {
                 },
             };
         }
-        // last_n_months range starts at 00:00:00 first day of n months before the current month and
+        // last_n_months
+        // starts at 00:00:00 first day of n months before the current month and
         // ends at 23:59:59 the last day of the month before the current month
         case DateRange.last_n_months: {
             return {
@@ -7589,11 +7676,125 @@ function dateRangesFrom(dateRange, input, dateFunction) {
                 },
             };
         }
+        // n_months_ago
+        // starts at the first day of the month 00:00:00 n months ago from now
+        // ends at 23:59:59 of n months ago
+        case DateRange.n_months_ago: {
+            return {
+                binding: {
+                    // need to go 1 less month back then -1 seconds to get the end of it
+                    upper: `${-input + 1} months`,
+                    lower: `-${input} months`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'start of month', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'start of month', ?)`,
+                },
+            };
+        }
+        // next_n_years
+        // starts 00:00:00 Jan 1st the year after the current year
+        // ends Dec 31 23:59:59 of the nth year
+        case DateRange.next_n_years: {
+            return {
+                binding: {
+                    upper: `+${input + 1} years`,
+                    lower: `+1 year`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'start of year', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'start of year', ?)`,
+                },
+            };
+        }
+        // last_n_years starts
+        // starts 00:00:00 Jan 1 n+1 year ago and
+        // ends dec 31 23:59:59 of the year before the current
+        case DateRange.last_n_years: {
+            return {
+                binding: {
+                    upper: `-1 seconds`,
+                    lower: `-${input + 1} years`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'start of year', ?)`,
+                    lower: `${dateFunction}('now', 'start of year', ?)`,
+                },
+            };
+        }
+        // n_years_ago
+        // starts 00:00:00 Jan 1 of n years before the current year and
+        // ends Dec 31 23:59:59 of that year
+        case DateRange.n_years_ago: {
+            return {
+                binding: {
+                    upper: `-${input - 1} years`,
+                    lower: `-${input} years`,
+                },
+                range: {
+                    upper: `${dateFunction}('now', 'start of year', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('now', 'start of year', ?)`,
+                },
+            };
+        }
+        // next_n_quarters
+        // starts 00:00:00 first day of the quarter after the current quarter
+        // ends 23:59:59 of the last day of n quarters in the future
+        case DateRange.next_n_quarters: {
+            const currentQuarterString = quarterStart(new Date());
+            return {
+                binding: {
+                    // add another quarter input to -1 seconds to get the end of the last day of the quarter
+                    upper: `${(input + 1) * 3} months`,
+                    lower: `3 months`,
+                },
+                range: {
+                    upper: `${dateFunction}('${currentQuarterString}', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('${currentQuarterString}', 'start of day', ?)`,
+                },
+            };
+        }
+        // last_n_quarters
+        // starts 00:00:00 the first day of n quarters ago
+        // end 23:59:59 the last day of the quarter before the current quarter
+        case DateRange.last_n_quarters: {
+            const currentQuarterString = quarterStart(new Date());
+            return {
+                binding: {
+                    upper: `-1 seconds`,
+                    lower: `-${input * 3} months`,
+                },
+                range: {
+                    upper: `${dateFunction}('${currentQuarterString}', 'start of day', ?)`,
+                    lower: `${dateFunction}('${currentQuarterString}', 'start of day', ?)`,
+                },
+            };
+        }
+        // n_quarters_ago
+        // starts 00:00:00 first day of the quarter n quarters before the current
+        // ends 23:59:59 last day of the same quarter
+        case DateRange.n_quarters_ago: {
+            const currentQuarterString = quarterStart(new Date());
+            return {
+                binding: {
+                    // minus 1 quarter to be able to -1 seconds to get the end of the nth quarter
+                    upper: `-${(input - 1) * 3} months`,
+                    lower: `-${input * 3} months`,
+                },
+                range: {
+                    upper: `${dateFunction}('${currentQuarterString}', 'start of day', ?, '-1 seconds')`,
+                    lower: `${dateFunction}('${currentQuarterString}', 'start of day', ?)`,
+                },
+            };
+        }
         default:
             // eslint-disable-next-line @salesforce/lds/no-error-in-production
             throw new Error(`DateRangeInput ${dateRange} is not supported in local evalutation`);
     }
 }
+function isTodayStartOfWeek() {
+    return new Date().getDay() === FIRST_DAY_OF_WEEK;
+}
 
 const JSON_EXTRACT_PATH_INGESTION_TIMESTAMP = '$.ingestionTimestamp';
 const JSON_EXTRACT_PATH_INGESTION_APINAME = '$.apiName';
@@ -14758,11 +14959,14 @@ function mergeBatchRecordsFields(first, second, collectionMergeFunc) {
  * @param endpoint Regular Expression to check the endpoint to aggregate
  * @returns undefined if we should not aggregate. object if we should.
  */
-function createAggregateBatchRequestInfo(resourceRequest, endpoint) {
+function createAggregateBatchRequestInfo(resourceRequest, endpoint, instrumentationSink) {
     // only handle GETs on the given endpoint regex
     if (!isGetRequestForEndpoint(endpoint, resourceRequest)) {
         return undefined;
     }
+    if (instrumentationSink) {
+        instrumentationSink.reportChunkCandidateUrlLength(calculateEstimatedTotalUrlLength(resourceRequest));
+    }
     const { queryParams: { fields, optionalFields }, } = resourceRequest;
     // only handle requests with fields or optional fields
     if (fields === undefined && optionalFields === undefined) {
@@ -14874,6 +15078,21 @@ function getMaxLengthPerChunkAllowed(request) {
     // MAX_URL_LENGTH  - full lenght without fields, optionalFields
     return MAX_URL_LENGTH - roughUrlLengthWithoutFieldsAndOptionFields;
 }
+// we don't have access to the host so we cannot calculate the exact length of the url
+// so we will estimate it
+function calculateEstimatedTotalUrlLength(request) {
+    const { baseUri, basePath, queryParams } = request;
+    let url = `${baseUri}${basePath}`;
+    if (queryParams) {
+        const queryParamString = entries$2(queryParams)
+            .map(([key, value]) => `${key}=${value}`)
+            .join('&');
+        if (queryParamString) {
+            url += `?${queryParamString}`;
+        }
+    }
+    return url.length;
+}
 
 const RECORD_ENDPOINT_REGEX = /^\/ui-api\/records\/?(([a-zA-Z0-9]+))?$/;
 const referenceId$3 = 'LDS_Records_AggregateUi';
@@ -14898,9 +15117,9 @@ function mergeGetRecordResult(first, second) {
     mergeRecordFields(first, second);
     return first;
 }
-function makeNetworkChunkFieldsGetRecord(networkAdapter) {
+function makeNetworkChunkFieldsGetRecord(networkAdapter, instrumentationSink) {
     return (resourceRequest, resourceRequestContext) => {
-        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RECORD_ENDPOINT_REGEX);
+        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RECORD_ENDPOINT_REGEX, instrumentationSink);
         if (batchRequestInfo === undefined) {
             return networkAdapter(resourceRequest, resourceRequestContext);
         }
@@ -14914,9 +15133,9 @@ function makeNetworkChunkFieldsGetRecord(networkAdapter) {
 
 const RECORDS_BATCH_ENDPOINT_REGEX = /^\/ui-api\/records\/batch\/?(([a-zA-Z0-9|,]+))?$/;
 const referenceId$2 = 'LDS_Records_Batch_AggregateUi';
-function makeNetworkChunkFieldsGetRecordsBatch(networkAdapter) {
+function makeNetworkChunkFieldsGetRecordsBatch(networkAdapter, intrumentationSink) {
     return (resourceRequest, resourceRequestContext) => {
-        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RECORDS_BATCH_ENDPOINT_REGEX);
+        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RECORDS_BATCH_ENDPOINT_REGEX, intrumentationSink);
         if (batchRequestInfo === undefined) {
             return networkAdapter(resourceRequest, resourceRequestContext);
         }
@@ -14962,9 +15181,9 @@ function mergeRelatedRecordsFields(first, second) {
         throw new Error('Aggregate UI response is invalid');
     }
 }
-function makeNetworkChunkFieldsGetRelatedListRecords(networkAdapter) {
+function makeNetworkChunkFieldsGetRelatedListRecords(networkAdapter, instrumentationSink) {
     return (resourceRequest, resourceRequestContext) => {
-        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RELATED_LIST_RECORDS_ENDPOINT_REGEX);
+        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RELATED_LIST_RECORDS_ENDPOINT_REGEX, instrumentationSink);
         if (batchRequestInfo === undefined) {
             return networkAdapter(resourceRequest, resourceRequestContext);
         }
@@ -15040,9 +15259,9 @@ function recordIdsAllMatch(first, second) {
 
 const RELATED_LIST_RECORDS_BATCH_ENDPOINT_REGEX = /^\/ui-api\/related-list-records\/batch\/?(([a-zA-Z0-9]+))?\//;
 const referenceId = 'LDS_Related_List_Records_AggregateUi';
-function makeNetworkChunkFieldsGetRelatedListRecordsBatch(networkAdapter) {
+function makeNetworkChunkFieldsGetRelatedListRecordsBatch(networkAdapter, instrumentationSink) {
     return (resourceRequest, resourceRequestContext) => {
-        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RELATED_LIST_RECORDS_BATCH_ENDPOINT_REGEX);
+        const batchRequestInfo = createAggregateBatchRequestInfo(resourceRequest, RELATED_LIST_RECORDS_BATCH_ENDPOINT_REGEX, instrumentationSink);
         if (batchRequestInfo === undefined) {
             return networkAdapter(resourceRequest, resourceRequestContext);
         }
@@ -15065,7 +15284,7 @@ function makeNetworkChunkFieldsGetRelatedListRecordsBatch(networkAdapter) {
  *
  * @param networkAdapter the network adapter to do the call.
  */
-function makeNetworkAdapterChunkRecordFields(networkAdapter) {
+function makeNetworkAdapterChunkRecordFields(networkAdapter, instrumentationSink) {
     // endpoint handlers that support aggregate-ui field batching
     const batchHandlers = [
         makeNetworkChunkFieldsGetRecord,
@@ -15074,7 +15293,7 @@ function makeNetworkAdapterChunkRecordFields(networkAdapter) {
         makeNetworkChunkFieldsGetRelatedListRecordsBatch,
     ];
     return batchHandlers.reduce((network, handler) => {
-        return handler(network);
+        return handler(network, instrumentationSink);
     }, networkAdapter);
 }
 
@@ -15351,6 +15570,11 @@ function reportPrimingConflict(resolutionType, recordCount) {
         resolutionType,
     });
 }
+/** Network */
+function reportChunkCandidateUrlLength(urlLength) {
+    const buckets = [8000, 10000, 12000, 14000, 16000];
+    ldsMobileInstrumentation.bucketValue('chunk-candidate-url-length-histogram', urlLength, buckets);
+}
 
 /**
  * HOF (high-order-function) that instruments any async operation.  If the operation
@@ -17561,7 +17785,9 @@ function getRuntime() {
         const { newRecordId, isGenerated } = recordIdGenerator(userId);
         // non-draft-aware base services
         const store = new InMemoryStore();
-        lazyNetworkAdapter = platformNetworkAdapter(makeNetworkAdapterChunkRecordFields(NimbusNetworkAdapter));
+        lazyNetworkAdapter = platformNetworkAdapter(makeNetworkAdapterChunkRecordFields(NimbusNetworkAdapter, {
+            reportChunkCandidateUrlLength: reportChunkCandidateUrlLength,
+        }));
         lazyBaseDurableStore = getNimbusDurableStore();
         // specific adapters
         const internalAdapterStore = new InMemoryStore();
@@ -17690,4 +17916,4 @@ register({
 });
 
 export { O11Y_NAMESPACE_LDS_MOBILE, getRuntime, registerReportObserver, reportGraphqlQueryParseError };
-// version: 1.259.0-921ca6033
+// version: 1.261.0-faaa0c74a

package/sfdc/types/__mocks__/o11y/instrumentation.d.ts

@@ -3,12 +3,14 @@ declare function error(_err: Error, _userSchemaOrText?: string, _data?: any): vo
 declare function startActivity(_name: string): any;
 declare function incrementCounter(_operation: string, _increment?: number, _hasError?: boolean, _tags?: any): void;
 declare function trackValue(_operation: string, _value: number, _hasError?: boolean, _tags?: any): void;
+declare function bucketValue(_operation: string, _value: number, _buckets: number[]): void;
 export declare const instrumentation: {
     log: typeof log;
     error: typeof error;
     startActivity: typeof startActivity;
     incrementCounter: typeof incrementCounter;
     trackValue: typeof trackValue;
+    bucketValue: typeof bucketValue;
 };
 export declare const METRIC_KEYS: {};
 export {};

package/sfdc/types/instrumentation/metrics.d.ts

@@ -15,3 +15,5 @@ export declare function reportPrimingSessionCreated(): void;
 export declare function reportPrimingError(errorType: string, recordCount: number): void;
 export declare function reportPrimingSuccess(recordCount: number): void;
 export declare function reportPrimingConflict(resolutionType: string, recordCount: number): void;
+/** Network */
+export declare function reportChunkCandidateUrlLength(urlLength: number): void;