Clean up/respond to feedback

packages/core/src/command.ts

@@ -0,0 +1,81 @@
+import * as os from 'os'
+
+/**
+ * Commands
+ *
+ * Command Format:
+ *   ##[name key=value;key=value]message
+ *
+ * Examples:
+ *   ##[warning]This is the user warning message
+ *   ##[set-secret name=mypassword]definatelyNotAPassword!
+ */
+export function issueCommand(
+  command: string,
+  properties: any,
+  message: string
+) {
+  const cmd = new Command(command, properties, message)
+  process.stdout.write(cmd.toString() + os.EOL)
+}
+
+export function issue(name: string, message: string) {
+  issueCommand(name, {}, message)
+}
+
+const CMD_PREFIX = '##['
+
+class Command {
+  constructor(command: string, properties: {[key: string]: string}, message: string) {
+    if (!command) {
+      command = 'missing.command'
+    }
+
+    this.command = command
+    this.properties = properties
+    this.message = message
+  }
+
+  public command: string
+  public message: string
+  public properties: {[key: string]: string}
+
+  public toString() {
+    let cmdStr = CMD_PREFIX + this.command
+
+    if (this.properties && Object.keys(this.properties).length > 0) {
+      cmdStr += ' '
+      for (const key in this.properties) {
+        if (this.properties.hasOwnProperty(key)) {
+          const val = this.properties[key]
+          if (val) {
+            // safely append the val - avoid blowing up when attempting to
+            // call .replace() if message is not a string for some reason
+            cmdStr += `${key}=${escape(`${val || ''}`)};`
+          }
+        }
+      }
+    }
+
+    cmdStr += ']'
+
+    // safely append the message - avoid blowing up when attempting to
+    // call .replace() if message is not a string for some reason
+    const message: string = `${this.message || ''}`
+    cmdStr += escapedata(message)
+
+    return cmdStr
+  }
+}
+
+function escapedata(s: string): string {
+  return s.replace(/\r/g, '%0D').replace(/\n/g, '%0A')
+}
+
+function escape(s: string): string {
+  return s
+    .replace(/\r/g, '%0D')
+    .replace(/\n/g, '%0A')
+    .replace(/]/g, '%5D')
+    .replace(/;/g, '%3B')
+}