command.js

import { EOL } from 'node:os'

export function issueCommand(command, properties, message) {
  const cmd = new Command(command, properties, message)
  process.stdout.write(cmd.toString() + EOL)
}

export function issue(name, message = '') {
  issueCommand(name, {}, message)
}

const CMD_STRING = '::'

class Command {
  #command
  #message
  #properties

  constructor(command, properties, message) {
    if (!command) command = 'missing.command'

    this.#command = command
    this.#properties = properties
    this.#message = message
  }

  toString() {
    let cmdStr = CMD_STRING + this.#command

    if (this.#properties && Object.keys(this.#properties).length > 0) {
      cmdStr += ' '
      let first = true
      for (const key in this.#properties) {
        if (this.#properties.hasOwnProperty(key)) {
          const val = this.#properties[key]
          if (val) {
            if (first) first = false
            else cmdStr += ','
            cmdStr += `${key}=${escapeProperty(val)}`
          }
        }
      }
    }

    cmdStr += `${CMD_STRING}${escapeData(this.#message)}`
    return cmdStr
  }
}

function escapeData(s) {
  return toCommandValue(s)
    .replace(/%/g, '%25')
    .replace(/\r/g, '%0D')
    .replace(/\n/g, '%0A')
}

function escapeProperty(s) {
  return toCommandValue(s)
    .replace(/%/g, '%25')
    .replace(/\r/g, '%0D')
    .replace(/\n/g, '%0A')
    .replace(/:/g, '%3A')
    .replace(/,/g, '%2C')
}

export function toCommandValue(input) {
  if (input === null || input === undefined) return ''
  else if (typeof input === 'string' || input instanceof String) return input
  return JSON.stringify(input)
}