@salesforce/lds-runtime-bridge 1.259.0 → 1.261.0

package/dist/ldsRuntimeBridge.js

@@ -18,6 +18,7 @@ import { isStoreKeyRecordViewEntity, RECORD_ID_PREFIX, RECORD_FIELDS_KEY_JUNCTIO
 import '@salesforce/gate/lds.idempotencyWriteDisabled';
 import '@salesforce/gate/lds.backdatingEnabled';
 import { Kind, buildSchema, isObjectType, defaultFieldResolver } from 'force/ldsGraphqlParser';
+import FIRST_DAY_OF_WEEK from '@salesforce/i18n/firstDayOfWeek';
 import excludeStaleRecordsGate from '@salesforce/gate/lds.graphqlEvalExcludeStaleRecords';
 import networkAdapter from 'force/ldsNetwork';
 import ldsEngineCreator from 'force/ldsEngineCreator';
@@ -1979,16 +1980,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 = {}));
@@ -2059,6 +2065,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) {
@@ -2088,7 +2095,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: {
@@ -2101,7 +2187,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 {
@@ -2115,11 +2202,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';
@@ -3762,4 +3963,4 @@ function ldsRuntimeBridge() {
 }
 
 export { ldsRuntimeBridge as default };
-// 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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/lds-runtime-bridge",
-    "version": "1.259.0",
+    "version": "1.261.0",
     "license": "SEE LICENSE IN LICENSE.txt",
     "description": "LDS runtime for bridge.app.",
     "main": "dist/ldsRuntimeBridge.js",
@@ -34,17 +34,17 @@
         "release:corejar": "yarn build && ../core-build/scripts/core.js --name=lds-runtime-bridge"
     },
     "dependencies": {
-        "@salesforce/lds-adapters-uiapi": "^1.259.0",
-        "@salesforce/lds-instrumentation": "^1.259.0",
+        "@salesforce/lds-adapters-uiapi": "^1.261.0",
+        "@salesforce/lds-instrumentation": "^1.261.0",
         "@salesforce/user": "0.0.21",
         "o11y": "244.0.0"
     },
     "devDependencies": {
-        "@salesforce/lds-drafts-adapters-uiapi": "^1.259.0",
-        "@salesforce/lds-network-aura": "^1.259.0",
-        "@salesforce/lds-runtime-aura": "^1.259.0",
-        "@salesforce/lds-store-nimbus": "^1.259.0",
-        "@salesforce/nimbus-plugin-lds": "^1.259.0",
+        "@salesforce/lds-drafts-adapters-uiapi": "^1.261.0",
+        "@salesforce/lds-network-aura": "^1.261.0",
+        "@salesforce/lds-runtime-aura": "^1.261.0",
+        "@salesforce/lds-store-nimbus": "^1.261.0",
+        "@salesforce/nimbus-plugin-lds": "^1.261.0",
         "babel-plugin-dynamic-import-node": "^2.3.3"
     },
     "luvioBundlesize": [