feat: add can store rm & can upload rm commands

[olizilla]

adds impl, tests, and docs for the can store rm and can upload rm commands.

# remove root cid from upload list
$ w3 can upload rm <root-cid>

# remove car from store
$ w3 can store rm <car-cid>

License: MIT

[alanshaw]

LGTM - a few suggestions but they are non blocking 🙂

[alanshaw]

Alternatively you could make this a type assertion function:

/**
 * Return true if CID is a CAR CID and false if not.
 * @param {import('multiformats').UnknownLink} cid
 * @returns {cid is import('multiformats').Link<Uint8Array, typeof CAR.codec.code>}
 */
export function isCarLink (cid) {
  return cid.version === 1 && cid.code === CAR.codec.code
}

...and then typescript knows it's a CAR CID later in the code and you don't have to re-assign e.g.:

[alanshaw]

Suggested change

	} catch (err) {
	} catch {

[alanshaw]

Kinda weird to destructure error from console...

I'd probably just have it throw when not a CAR CID and then in the calling code:

let cid
try {
  cid = parseCarLink(cidStr)
} catch {
  console.error(`Error: invalid CAR CID: ${cidStr}`)
  process.exit(1)
}

[olizilla]

yeah it used to be parseCarLinkOrExit but that was weird too. Have simplified it again.

export function parseCarLink (cidStr) {
  try {
    return asCarLink(CID.parse(cidStr.trim()))
  } catch {}
}

calling code

const shard = parseCarLink(cidStr)
if (!shard) {
  console.error(`Error: ${cidStr} is not a CAR CID`)
  process.exit(1)
}