@apexdevtools/apex-parser 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# apex-parser - Changelog
+
+## 3.1.0 - 2022-11-17
+
+* Adds DISTANCE and GEOLOCATION literals for SOQL.
+* Removes support for modulus operator to match apex.
+* Use of `void.class` no longer causes syntax error.
+* Now supports newer Date literals from API 55.
+
+## 3.0.0 - 2022-06-14
+
+* Initial github release.

package/README.md

@@ -1,15 +1,15 @@
-apex-parser
-===========
+# apex-parser
 
-Parser for Salesforce Apex (including Triggers & inline SOQL/SOQL). This is based on an [ANTLR4](https://www.antlr.org/) grammar, see antlr/ApexParser.g4. 
+Parser for Salesforce Apex (including Triggers & inline SOQL/SOQL). This is based on an [ANTLR4](https://www.antlr.org/) grammar, see antlr/ApexParser.g4.
 
 There are two builds of the parser available, a NPM module for use with Node and a Maven package for use on JVMs.
 
-These builds just contain the Parser & Lexer and provides no further support for analysing the generated parse trees beyond what is provided by ANTLR4. 
+These builds just contain the Parser & Lexer and provides no further support for analysing the generated parse trees beyond what is provided by ANTLR4.
 
-As Apex & SOQL/SOQL are case-insenstive languages you need to use the provided CaseInsensitiveInputStream for the parser to function correctly. When parsing Apex, inline SOQL/SOSL is automtaically parsed, but you can also parse SOQL/SOQL directly. You can find some minimal examples in the test classes. 
+As Apex & SOQL/SOQL are case-insenstive languages you need to use the provided CaseInsensitiveInputStream for the parser to function correctly. When parsing Apex, inline SOQL/SOSL is automtaically parsed, but you can also parse SOQL/SOQL directly. You can find some minimal examples in the test classes.
+
+## Example
 
-### Example
 To parse a class file (NPM version):
 
     let lexer = new ApexLexer(new CaseInsensitiveInputStream("public class Hello {}"))
@@ -20,19 +20,28 @@ To parse a class file (NPM version):
 
 The 'context' is a CompilationUnitContext object which is the root of the parsed representation of the class. You can access the parse tree via functions on it.
 
-### Unicode handling
-Prior to 2.12.0 the use of ANTLRInputStream for reading data in CaseInsensitiveStream would result character positions being given for UTF-16. The switch to CharStream input in 2.12.0 for JVM and 2.14.0 for node results in character positions reflecting Unicode code points. 
+## Unicode handling
+
+Prior to 2.12.0 the use of ANTLRInputStream for reading data in CaseInsensitiveStream would result character positions being given for UTF-16. The switch to CharStream input in 2.12.0 for JVM and 2.14.0 for node results in character positions reflecting Unicode code points.
 
-### antlr4ts versions
+## antlr4ts versions
 
 The npm module uses antlr4ts 0.5.0-alpha.4, this was updated from 0.5.0-alpha.3 in the 2.9.1 version. You should make
-sure that if you are using a matching versions of this dependency if you use it directly. To avoid issues you can 
+sure that if you are using a matching versions of this dependency if you use it directly. To avoid issues you can
 import 'CommonTokenStream' & 'ParseTreeWalker' from 'apex-parser' instead of from antlr4ts.
 
     import { CommonTokenStream} from "apex-parser";
     import { ParseTreeWalker } from "apex-parser";
 
-### Packages
+## SOSL FIND quoting
+
+SOSL FIND uses ' as a quoting character when embedded in Apex, in the API braces are used:
+
+    Find {something} RETURNING Account
+
+To parse the API format there is an alternative parser rule, soslLiteralAlt, that you can use instead of soslLiteral. See SOSLParserTest for some examples of how these differ.
+
+## Packages
 
 Maven
 
@@ -46,12 +55,26 @@ NPM
 
     "@apexdevtools/apex-parser": "^3.0.0"
 
-### Building
+## Building
+
 To build both distributions:
 
     npm run build
 
-### History
+## Testing
+
+Unit tests are executed during the respective package builds. The system tests require both packages to be built, as the js test also spawns the jar version. They use a collection of sample projects located in the [apex-samples](https://github.com/apex-dev-tools/apex-samples) repository. Follow the README instructions in apex-samples to checkout the submodules or use `git clone --recurse-submodules <repo-url>`. To run the tests:
+
+    # Set SAMPLES env var to samples repo location
+    export SAMPLES=<abs path to apex-samples>
+
+    # Exec test script
+    npm run test-samples
+
+System test failures relating to the snapshots may highlight regressions. Though if an error is expected or the samples have changed, instead use `npm run test-snapshot` to update the snapshots, then commit the changes.
+
+## History
+
     3.0.0 - Move to @apexdevtools/apex-parser
     2.14.0 - Change npm api to replace ANTLRInputStream with CharStream, for Unicode char positions  
     2.13.0 - Fixes for negative numerics & Currency literals in SOQL 
@@ -74,6 +97,6 @@ To build both distributions:
     2.1.0 - Supports trigger parsing and switch statement parsing syntax was corrected
     1.0.0 - Initial version
 
-### Source & Licenses
+## Source & Licenses
 
 All the source code included uses a 3-clause BSD license. The only third-party component included is the Apex Antlr4 grammar originally from [Tooling-force.com](https://github.com/neowit/tooling-force.com), although this version used is now markedly different from the original.  

package/lib/ApexLexer.d.ts

@@ -111,133 +111,141 @@ export declare class ApexLexer extends Lexer {
     static readonly VIEWSTAT = 106;
     static readonly CUSTOM = 107;
     static readonly STANDARD = 108;
-    static readonly CALENDAR_MONTH = 109;
-    static readonly CALENDAR_QUARTER = 110;
-    static readonly CALENDAR_YEAR = 111;
-    static readonly DAY_IN_MONTH = 112;
-    static readonly DAY_IN_WEEK = 113;
-    static readonly DAY_IN_YEAR = 114;
-    static readonly DAY_ONLY = 115;
-    static readonly FISCAL_MONTH = 116;
-    static readonly FISCAL_QUARTER = 117;
-    static readonly FISCAL_YEAR = 118;
-    static readonly HOUR_IN_DAY = 119;
-    static readonly WEEK_IN_MONTH = 120;
-    static readonly WEEK_IN_YEAR = 121;
-    static readonly CONVERT_TIMEZONE = 122;
-    static readonly YESTERDAY = 123;
-    static readonly TODAY = 124;
-    static readonly TOMORROW = 125;
-    static readonly LAST_WEEK = 126;
-    static readonly THIS_WEEK = 127;
-    static readonly NEXT_WEEK = 128;
-    static readonly LAST_MONTH = 129;
-    static readonly THIS_MONTH = 130;
-    static readonly NEXT_MONTH = 131;
-    static readonly LAST_90_DAYS = 132;
-    static readonly NEXT_90_DAYS = 133;
-    static readonly LAST_N_DAYS_N = 134;
-    static readonly NEXT_N_DAYS_N = 135;
-    static readonly NEXT_N_WEEKS_N = 136;
-    static readonly LAST_N_WEEKS_N = 137;
-    static readonly NEXT_N_MONTHS_N = 138;
-    static readonly LAST_N_MONTHS_N = 139;
-    static readonly THIS_QUARTER = 140;
-    static readonly LAST_QUARTER = 141;
-    static readonly NEXT_QUARTER = 142;
-    static readonly NEXT_N_QUARTERS_N = 143;
-    static readonly LAST_N_QUARTERS_N = 144;
-    static readonly THIS_YEAR = 145;
-    static readonly LAST_YEAR = 146;
-    static readonly NEXT_YEAR = 147;
-    static readonly NEXT_N_YEARS_N = 148;
-    static readonly LAST_N_YEARS_N = 149;
-    static readonly THIS_FISCAL_QUARTER = 150;
-    static readonly LAST_FISCAL_QUARTER = 151;
-    static readonly NEXT_FISCAL_QUARTER = 152;
-    static readonly NEXT_N_FISCAL_QUARTERS_N = 153;
-    static readonly LAST_N_FISCAL_QUARTERS_N = 154;
-    static readonly THIS_FISCAL_YEAR = 155;
-    static readonly LAST_FISCAL_YEAR = 156;
-    static readonly NEXT_FISCAL_YEAR = 157;
-    static readonly NEXT_N_FISCAL_YEARS_N = 158;
-    static readonly LAST_N_FISCAL_YEARS_N = 159;
-    static readonly DateLiteral = 160;
-    static readonly DateTimeLiteral = 161;
-    static readonly IntegralCurrencyLiteral = 162;
-    static readonly FIND = 163;
-    static readonly EMAIL = 164;
-    static readonly NAME = 165;
-    static readonly PHONE = 166;
-    static readonly SIDEBAR = 167;
-    static readonly FIELDS = 168;
-    static readonly METADATA = 169;
-    static readonly PRICEBOOKID = 170;
-    static readonly NETWORK = 171;
-    static readonly SNIPPET = 172;
-    static readonly TARGET_LENGTH = 173;
-    static readonly DIVISION = 174;
-    static readonly RETURNING = 175;
-    static readonly LISTVIEW = 176;
-    static readonly FindLiteral = 177;
-    static readonly IntegerLiteral = 178;
-    static readonly LongLiteral = 179;
-    static readonly NumberLiteral = 180;
-    static readonly BooleanLiteral = 181;
-    static readonly StringLiteral = 182;
-    static readonly NullLiteral = 183;
-    static readonly LPAREN = 184;
-    static readonly RPAREN = 185;
-    static readonly LBRACE = 186;
-    static readonly RBRACE = 187;
-    static readonly LBRACK = 188;
-    static readonly RBRACK = 189;
-    static readonly SEMI = 190;
-    static readonly COMMA = 191;
-    static readonly DOT = 192;
-    static readonly ASSIGN = 193;
-    static readonly GT = 194;
-    static readonly LT = 195;
-    static readonly BANG = 196;
-    static readonly TILDE = 197;
-    static readonly QUESTIONDOT = 198;
-    static readonly QUESTION = 199;
-    static readonly COLON = 200;
-    static readonly EQUAL = 201;
-    static readonly TRIPLEEQUAL = 202;
-    static readonly NOTEQUAL = 203;
-    static readonly LESSANDGREATER = 204;
-    static readonly TRIPLENOTEQUAL = 205;
-    static readonly AND = 206;
-    static readonly OR = 207;
-    static readonly INC = 208;
-    static readonly DEC = 209;
-    static readonly ADD = 210;
-    static readonly SUB = 211;
-    static readonly MUL = 212;
-    static readonly DIV = 213;
-    static readonly BITAND = 214;
-    static readonly BITOR = 215;
-    static readonly CARET = 216;
-    static readonly MOD = 217;
-    static readonly MAPTO = 218;
-    static readonly ADD_ASSIGN = 219;
-    static readonly SUB_ASSIGN = 220;
-    static readonly MUL_ASSIGN = 221;
-    static readonly DIV_ASSIGN = 222;
-    static readonly AND_ASSIGN = 223;
-    static readonly OR_ASSIGN = 224;
-    static readonly XOR_ASSIGN = 225;
-    static readonly MOD_ASSIGN = 226;
-    static readonly LSHIFT_ASSIGN = 227;
-    static readonly RSHIFT_ASSIGN = 228;
-    static readonly URSHIFT_ASSIGN = 229;
-    static readonly ATSIGN = 230;
-    static readonly Identifier = 231;
-    static readonly WS = 232;
-    static readonly DOC_COMMENT = 233;
-    static readonly COMMENT = 234;
-    static readonly LINE_COMMENT = 235;
+    static readonly DISTANCE = 109;
+    static readonly GEOLOCATION = 110;
+    static readonly CALENDAR_MONTH = 111;
+    static readonly CALENDAR_QUARTER = 112;
+    static readonly CALENDAR_YEAR = 113;
+    static readonly DAY_IN_MONTH = 114;
+    static readonly DAY_IN_WEEK = 115;
+    static readonly DAY_IN_YEAR = 116;
+    static readonly DAY_ONLY = 117;
+    static readonly FISCAL_MONTH = 118;
+    static readonly FISCAL_QUARTER = 119;
+    static readonly FISCAL_YEAR = 120;
+    static readonly HOUR_IN_DAY = 121;
+    static readonly WEEK_IN_MONTH = 122;
+    static readonly WEEK_IN_YEAR = 123;
+    static readonly CONVERT_TIMEZONE = 124;
+    static readonly YESTERDAY = 125;
+    static readonly TODAY = 126;
+    static readonly TOMORROW = 127;
+    static readonly LAST_WEEK = 128;
+    static readonly THIS_WEEK = 129;
+    static readonly NEXT_WEEK = 130;
+    static readonly LAST_MONTH = 131;
+    static readonly THIS_MONTH = 132;
+    static readonly NEXT_MONTH = 133;
+    static readonly LAST_90_DAYS = 134;
+    static readonly NEXT_90_DAYS = 135;
+    static readonly LAST_N_DAYS_N = 136;
+    static readonly NEXT_N_DAYS_N = 137;
+    static readonly N_DAYS_AGO_N = 138;
+    static readonly NEXT_N_WEEKS_N = 139;
+    static readonly LAST_N_WEEKS_N = 140;
+    static readonly N_WEEKS_AGO_N = 141;
+    static readonly NEXT_N_MONTHS_N = 142;
+    static readonly LAST_N_MONTHS_N = 143;
+    static readonly N_MONTHS_AGO_N = 144;
+    static readonly THIS_QUARTER = 145;
+    static readonly LAST_QUARTER = 146;
+    static readonly NEXT_QUARTER = 147;
+    static readonly NEXT_N_QUARTERS_N = 148;
+    static readonly LAST_N_QUARTERS_N = 149;
+    static readonly N_QUARTERS_AGO_N = 150;
+    static readonly THIS_YEAR = 151;
+    static readonly LAST_YEAR = 152;
+    static readonly NEXT_YEAR = 153;
+    static readonly NEXT_N_YEARS_N = 154;
+    static readonly LAST_N_YEARS_N = 155;
+    static readonly N_YEARS_AGO_N = 156;
+    static readonly THIS_FISCAL_QUARTER = 157;
+    static readonly LAST_FISCAL_QUARTER = 158;
+    static readonly NEXT_FISCAL_QUARTER = 159;
+    static readonly NEXT_N_FISCAL_QUARTERS_N = 160;
+    static readonly LAST_N_FISCAL_QUARTERS_N = 161;
+    static readonly N_FISCAL_QUARTERS_AGO_N = 162;
+    static readonly THIS_FISCAL_YEAR = 163;
+    static readonly LAST_FISCAL_YEAR = 164;
+    static readonly NEXT_FISCAL_YEAR = 165;
+    static readonly NEXT_N_FISCAL_YEARS_N = 166;
+    static readonly LAST_N_FISCAL_YEARS_N = 167;
+    static readonly N_FISCAL_YEARS_AGO_N = 168;
+    static readonly DateLiteral = 169;
+    static readonly DateTimeLiteral = 170;
+    static readonly IntegralCurrencyLiteral = 171;
+    static readonly FIND = 172;
+    static readonly EMAIL = 173;
+    static readonly NAME = 174;
+    static readonly PHONE = 175;
+    static readonly SIDEBAR = 176;
+    static readonly FIELDS = 177;
+    static readonly METADATA = 178;
+    static readonly PRICEBOOKID = 179;
+    static readonly NETWORK = 180;
+    static readonly SNIPPET = 181;
+    static readonly TARGET_LENGTH = 182;
+    static readonly DIVISION = 183;
+    static readonly RETURNING = 184;
+    static readonly LISTVIEW = 185;
+    static readonly FindLiteral = 186;
+    static readonly FindLiteralAlt = 187;
+    static readonly IntegerLiteral = 188;
+    static readonly LongLiteral = 189;
+    static readonly NumberLiteral = 190;
+    static readonly BooleanLiteral = 191;
+    static readonly StringLiteral = 192;
+    static readonly NullLiteral = 193;
+    static readonly LPAREN = 194;
+    static readonly RPAREN = 195;
+    static readonly LBRACE = 196;
+    static readonly RBRACE = 197;
+    static readonly LBRACK = 198;
+    static readonly RBRACK = 199;
+    static readonly SEMI = 200;
+    static readonly COMMA = 201;
+    static readonly DOT = 202;
+    static readonly ASSIGN = 203;
+    static readonly GT = 204;
+    static readonly LT = 205;
+    static readonly BANG = 206;
+    static readonly TILDE = 207;
+    static readonly QUESTIONDOT = 208;
+    static readonly QUESTION = 209;
+    static readonly COLON = 210;
+    static readonly EQUAL = 211;
+    static readonly TRIPLEEQUAL = 212;
+    static readonly NOTEQUAL = 213;
+    static readonly LESSANDGREATER = 214;
+    static readonly TRIPLENOTEQUAL = 215;
+    static readonly AND = 216;
+    static readonly OR = 217;
+    static readonly INC = 218;
+    static readonly DEC = 219;
+    static readonly ADD = 220;
+    static readonly SUB = 221;
+    static readonly MUL = 222;
+    static readonly DIV = 223;
+    static readonly BITAND = 224;
+    static readonly BITOR = 225;
+    static readonly CARET = 226;
+    static readonly MAPTO = 227;
+    static readonly ADD_ASSIGN = 228;
+    static readonly SUB_ASSIGN = 229;
+    static readonly MUL_ASSIGN = 230;
+    static readonly DIV_ASSIGN = 231;
+    static readonly AND_ASSIGN = 232;
+    static readonly OR_ASSIGN = 233;
+    static readonly XOR_ASSIGN = 234;
+    static readonly LSHIFT_ASSIGN = 235;
+    static readonly RSHIFT_ASSIGN = 236;
+    static readonly URSHIFT_ASSIGN = 237;
+    static readonly ATSIGN = 238;
+    static readonly Identifier = 239;
+    static readonly WS = 240;
+    static readonly DOC_COMMENT = 241;
+    static readonly COMMENT = 242;
+    static readonly LINE_COMMENT = 243;
     static readonly WHITESPACE_CHANNEL = 2;
     static readonly COMMENT_CHANNEL = 3;
     static readonly channelNames: string[];