Add sample scripts

Author: surajp

README.md

@@ -24,7 +24,9 @@ alert(Array(5).fill(0).map((e,i)=>'Hello, '+i));
 
 ```javascript 
 let accts=|| Select Name,(Select Id from Contacts) from Account order by createddate desc limit 100 ||;
-let contacts = accts.filter((a)=>!a.Contacts || a.Contacts.length===0).slice(0,10).map((a)=>({LastName: a.Name+'-Contact', AccountId: a.Id}));
+let contacts = accts.filter((a)=>!a.Contacts || a.Contacts.length===0)
+                    .slice(0,10)
+                    .map((a)=>({LastName: a.Name+'-Contact', AccountId: a.Id}));
 let contactIds = || insert Contact(contacts) ||; /*Note how the SObjectType has been specified. This is required for insert and upsert*/
 $A.get('e.force:refreshView').fire(); /* $A is supported!*/
 ```
@@ -47,13 +49,14 @@ $A.get('e.force:refreshView').fire();
 * Upsert and Update statements must be qualified with the SObjectType thus `|| insert Account(accts) ||;`
 * SOQL statements are parsed using template literals. Any arguments should follow the appropriate syntax `${argument}`
 * SOQL and DML statements may not be wrapped in a function.
+* All statements must be strictly terminated by a semicolon.
 
 ### Known Limitations
 
 * Support for delete has been intentionally withheld.
 * Single-line comments are not supported. 
 * Haven't tested DML with date, datetime, boolean, geolocation and other compound fields. I will update this section as I do so.
-* Explicit use of async/await, Promises and Generators is not supported, atm.
+* SOQL and DML statements should be enclosed in async functions, if they are required to be contained in functions. The program automatically adds `await` to SOQL and DML statements
 * DML on Files, Attachments, Documents, etc. is not supported
 
 ### For Developers: Extending to more than one Button per SObjectType

scripts/jsButton/README.md

@@ -0,0 +1,4 @@
+## These scripts assume you've a named credential named 'salesforce' created for your instance. The detailed steps for doing so are below:
+
+* Create an Auth Provider of type 'Salesforce'. You can either create your own Connected App or use the following consumer key and secret. The scopes should include `api` and `refresh_token` 
+* Create a named credential using the Auth Provider above and name it `salesforce`. The authentication type should be `OAuth`. For better security, I suggest you used `Per User` authentication so only authorized users can use the Salesforce APIs through the button

scripts/jsButton/createNewJSButton.js

@@ -0,0 +1,88 @@
+try {
+  let cmpName = prompt(
+    "Enter the name for your aura bundle. This will be the name of the custom metadata record backing this bundle as well"
+  );
+
+  if (!cmpName) return;
+
+  this.httpRequest.setEndpoint(
+    "callout:salesforce/services/data/v48.0/tooling/sobjects/AuraDefinitionBundle/"
+  );
+
+  this.httpRequest.setMethod("POST");
+
+  this.httpRequest.addHeader("Content-Type", "application/json");
+
+  this.httpRequest.setBody({
+    MasterLabel: cmpName,
+    Description: "created by js button",
+    ApiVersion: 48.0,
+    DeveloperName: cmpName
+  });
+
+  let resp = await this.httpRequest.send();
+
+  let auraBundleId = JSON.parse(resp.body).id;
+
+  alert(auraBundleId);
+
+  this.httpRequest.clear();
+
+  this.httpRequest.setEndpoint(
+    "callout:salesforce/services/data/v48.0/tooling/sobjects/AuraDefinition/"
+  );
+
+  this.httpRequest.setMethod("POST");
+  this.httpRequest.addHeader("Content-Type", "application/json");
+
+  let source = ` <aura:component implements="force:lightningQuickActionWithoutHeader,force:hasRecordId,force:hasSObjectName">
+  <c:jsButtonLwc
+  aura:id="jsbutton"
+  recordId="{!v.recordId}"
+  cmdtName="${cmpName}"
+  oninitcomplete="{!c.doInit}"
+  ></c:jsButtonLwc>
+  </aura:component>`;
+
+  this.httpRequest.setBody({
+    AuraDefinitionBundleId: auraBundleId,
+    DefType: "COMPONENT",
+    Format: "XML",
+    Source: source
+  });
+
+  resp = await this.httpRequest.send();
+
+  alert(resp.statusCode);
+
+  source = ` ({
+  doInit: function (component) {
+  component
+  .find("jsbutton")
+  .invoke()
+  .then(
+  $A.getCallback((resp) => {
+  $A.get("e.force:closeQuickAction").fire();
+  })
+  )
+  .catch(
+  $A.getCallback((err) => {
+  $A.get("e.force:closeQuickAction").fire();
+  })
+  );
+  }
+  });`;
+
+  this.httpRequest.setBody({
+    AuraDefinitionBundleId: auraBundleId,
+    DefType: "CONTROLLER",
+    Format: "JS",
+    Source: source
+  });
+
+  resp = await this.httpRequest.send();
+
+  alert(resp.statusCode);
+} catch (e) {
+  alert(JSON.stringify(e));
+}

scripts/jsButton/deleteInactiveFlowVersions.js

@@ -0,0 +1,25 @@
+try {
+  this.httpRequest.setEndpoint(
+    "callout:salesforce/services/data/v48.0/tooling/query/?q=Select+Id,FullName+from+Flow+where+status+!=+'Active'"
+  );
+
+  let resp = await this.httpRequest.send();
+  let respJson = JSON.parse(resp.body);
+
+  let results = await Promise.all(
+    respJson.records.map(async (rec) => {
+      this.httpRequest.clear();
+      let flowId = rec.Id;
+      this.httpRequest.setEndpoint(
+        "callout:salesforce/services/data/v48.0/tooling/sobjects/Flow/" + flowId + "/"
+      );
+      this.httpRequest.setMethod("DELETE");
+      resp = await this.httpRequest.send();
+      return resp.statusCode;
+    })
+  );
+
+  alert(results);
+} catch (e) {
+  alert(JSON.stringify(e));
+}