refactor: simplify ctx API

[antongolub]

• Tests pass
• Types updated

closes #416

[antonmedv]

This is pretty basic. any is not any types at all.

[antonmedv]

Let’s wait for my idea.

[antongolub]

I just want to see where my own thinking takes me )

[antongolub]

$.block(($) => {
   $.verbose = false
   fetch('https://example.com')
})

$.o = (opts) => $.block(($) => {
   Object.assign($, opts)
   return $
})

const quiet = (...args) {
  if (args[0] instanceof ProcessPromise) {
      args[0].ctx.verbose = false
      return args[0]
  } 

  return $.o({verbose: false})(...args)
}

quiet`cmd foo`

quiet($`cmd foo`)

[antongolub]

It works!

  const createHook = (opts, cb = v => v) => (...args) => {
    const p = args[0]
    if (p instanceof ProcessPromise) {
      Object.assign(p.ctx, opts)
      return cb(p)
    }
    return cb($.o(opts)(...args))
  }

  const quiet = createHook({verbose: false})
  const debug = createHook({verbose: 2})
  const timeout = (t, signal) => createHook(null, (p) => {
    if (!t) return p
    let timer = setTimeout(() => p.kill(signal), t)
    return p.finally(() => clearTimeout(timer))
  })

  await quiet`echo foo`
  await quiet($`echo foo`)

  try {
    await timeout(100, 'SIGKILL')`sleep 9999`
  } catch {}

  try {
    const p = $`sleep 9999`
    await timeout(100, 'SIGKILL')(p)
  } catch {}

[antongolub]

@antonmedv,

ctx() rocks! #385 chain API proposal is here:

  try {
    await quiet(timeout(100, 'SIGKILL')`sleep 9999`)
  } catch {
    console.log('killed1')
  }

  try {
    const p = $`sleep 9999`
    await quiet(timeout(100, 'SIGKILL')(p))
  } catch {
    console.log('killed2')
  }

  try {
    await $`sleep 9999`.quiet().timeout(100, 'SIGKILL')
  } catch {
    console.log('killed3')
  }

[antongolub]

Let's introduce issue labels: v6, experimental, docs, etc