@aurahelper/languages

Aura Helper Languages Modules

Aura Helper Languages Module has usefull inner modules to work with all supported Salesforce languages (Apex, Javascript, Aura...)

You can Tokenize and Parse any apex class to get data from classes like name, variables, methods, constructors... Also you can format your apex classes using the Apex Formatter class

Like Apex classes, you can Tokenize and Parse XML Aura Files and Aura Javascript files with Aura and Javascript modules.

To parse any XML file to process it, you can use the XML Module and its classes to parse prepare and process any XML File.

The languages module has a system module too, to get System apex classes data or Lightning Aura componetns defined on salesforce.

Table of Contents

• Apex Module
  • ApexTokenizer Class
  • ApexParser Class
  • ApexFormatter Class

• Aura Module
  • AuraTokenizer Class
  • AuraParser Class

• Javascript Module
  • JSTokenizer Class
  • JSParser Class

• XML Module
  • XMLUtils Class
  • XMLParser Class

• System Module
  • System Class

Apex Module

Module with classes to tokenize Apex Classes or Parse Apex Classes to extract classes data like variables, fields, methods, constructors...

ApexTokenizer Class

Methods

• tokenize(filePathOrContent, systemData)

  Method to tokenize an Apex file

tokenize(filePathOrContent, systemData)

Method to tokenize an Apex file

Parameters:

• filePathOrContent: File path or file content to tokenize
  • String
• systemData: Object with the system data to identify tokens with more precission
  • Object

Return:

Returns an array with all file tokens

• String

Examples:

Tokenize an Apex Class

    const { Apex } = require('@aurahelper/languages');
    const ApexTokenizer = Apex.ApexTokenizer;

    const tokens = ApexTokenizer.tokenize('./path/to/apex/class.cls');

    console.log(tokens);

ApexParser Class

Methods

ApexFormatter Class

Class to format any Apex Class with a selected configuration to format code as you want

Methods

• config()

  Method to get a default formatter config object

• format(pathContentOrTokens, config)

  Method to format an Apex Class with the selected options

config()

Method to get a default formatter config object

Return:

Returns a default formatter config object

• ApexFormatterConfig

Examples:

Get default apex formatter config

    const { Apex } = require('@aurahelper/languages');
    const ApexFormatter = Apex.ApexFormatter;

    const config = ApexFormatter.config();

    console.log(config);

format(pathContentOrTokens, config)

Method to format an Apex Class with the selected options

Parameters:

• pathContentOrTokens: Class file path or String file content or Apex Class Tokens (Use ApexTokenizer)
  • String | Array<Token>
• config: Apex formatter config object or VSCode Config JSON object
  • ApexFormatterConfig | Object
• systemData: System data like System Apex Classes or Namespaces to tokenize apex class if pathContentOrTokens is a class content or file path because is used to tokenize with precission. Can get it with System Class from System Module
  • Object

Return:

Returns the Apex Class content formatted

• String

Throws:

This method can throw the next exceptions:

• WrongDatatypeException: If pathContentOrTokens datatype is not an String, path or file tokens
• WrongFilePathException: If the file Path is not a String or can't convert to absolute path
• FileNotFoundException: If the file not exists or not have access to it
• InvalidFilePathException: If the path is not a file

Examples:

Format apex class from file

    const { Apex, System } = require('@aurahelper/languages');
    const ApexFormatter = Apex.ApexFormatter;

    const filePath = 'path/to/apexClass.cls';
    const formatedClassStr = ApexFormatter.format(filePath);

    console.log(formatedClassStr);

Format apex class from file content

    const { Apex } = require('@aurahelper/languages');
    const ApexFormatter = Apex.ApexFormatter;

    const fileContent = 'public class ApexclassName {' + 
                            'private String property1 { get; set; }' + 
                            'private void privateMethod(String param1, Integer param2) {' + 
                                '// Method body' + 
                            '}';
                            'public String publicMethod(Map<String, List<Account>>) {' + 
                                '// Method body' + 
                            '}' +
                        '}';
    const formatedClassStr = ApexFormatter.format(fileContent);

    console.log(formatedClassStr);

Format apex class from file tokens

    const { Apex } = require('@aurahelper/languages');
    const ApexFormatter = Apex.ApexFormatter;
    const ApexTokenizer = Apex.ApexTokenizer;

    const filePath = 'path/to/apexClass.cls';
    const fileTokens = ApexTokenizer.tokenize(filePath);
    const formatedClassStr = ApexFormatter.format(fileTokens);

    console.log(formatedClassStr);

Aura Module

Module with classes to tokenize Aura XML Files or Parse Aura XML Files to extract data from applications, components or events like RegisteredEvents, Handlers, Attributes...

AuraTokenizer Class

Methods

AuraParser Class

Methods

Javascript Module

Module with classes to tokenize Aura JS Files or Parse Aura JS Files to extract methods data from Controller and Helper files

JSTokenizer Class

Methods

JSParser Class

Methods

XML Module

Module with classes to parse any XML file to extract data and process it

XMLUtils Class

Methods

XMLParser Class

Methods

System Module

Module with one class and to many JSON files with Salesforce System Apex Classes and Namespaces and System Aura Components from all Namespaces (aura, lightning, ui...). Use the system class to get this data.

System Class

Methods

Changelog

[2.0.0 - 2021-12-13]

Added

• Changed to Typescript
• Added support to API 53.0

Fixed

• Fix Apex formatter error when has .class... into the code
• Fix all minor errors