fix: update tests, fix some bugs I found

also improve JSDocs for new lib.js functions

I'm not entirely sure the bin test mocks are done properly - would love careful review there

can.js

@@ -50,7 +50,7 @@ export async function storeList (opts = {}) {
   }
 
   const spinner = ora('Listing CARs').start()
-  const res = await client.capability.store.list()
+  const res = await client.capability.store.list(listOptions)
   spinner.stop()
   console.log(storeListResponseToString(res, opts))
 }

lib.js

@@ -14,6 +14,9 @@ import { CarReader } from '@ipld/car'
 
 /**
  * @typedef {import('@web3-storage/w3up-client/types').FileLike & { size: number }} FileLike
+ * @typedef {import('@web3-storage/w3up-client/src/types').ListResponse} ListResponse
+ * @typedef {import('@web3-storage/w3up-client/src/types').StoreListResult} StoreListResult
+ * @typedef {import('@web3-storage/w3up-client/src/types').UploadListResult} UploadListResult
  */
 
 export function getPkg () {
@@ -195,6 +198,13 @@ async function * filesFromDir (dir, filter) {
   }
 }
 
+/**
+ * @param {ListResponse<UploadListResult>} res
+ * @param {boolean} [opts.raw]
+ * @param {boolean} [opts.json]
+ * @param {boolean} [opts.shards]
+ * @returns {string}
+ */
 export function uploadListResponseToString (res, opts = {}) {
   if (opts.raw) {
     return JSON.stringify(res)
@@ -216,6 +226,12 @@ export function uploadListResponseToString (res, opts = {}) {
   }
 }
 
+/**
+ * @param {ListResponse<StoreListResult>} res
+ * @param {boolean} [opts.raw]
+ * @param {boolean} [opts.json]
+ * @returns {string}
+ */
 export function storeListResponseToString (res, opts = {}) {
   if (opts.raw) {
     return JSON.stringify(res)