[Breaking change] change handleGetCollectionContents

[anjor]

Tested as follows:

Created a collection

anjor@seven ~ $ curl -k http://localhost:3004/collections/create -d '{"name":"test_collections", "description":"testing collections"}' -H "Authorization: Bearer $ESTUARY_TOKEN" | jq .
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   236  100   172  100    64   4646   1728 --:--:-- --:--:-- --:--:--  7612
{
  "createdAt": "2022-07-20T19:57:06.522091Z",
  "uuid": "998d6947-7c3d-417d-bc1d-d5a833d4d6e6",
  "name": "test_collections",
  "description": "testing collections",
  "userId": 1,
  "cid": ""
}

Added file "a" to /test1/test2/test3, and then fetched contents at /, /test1, /test1/test2 and /test1/test2/test3

anjor@seven ~ $ uuid=998d6947-7c3d-417d-bc1d-d5a833d4d6e6
anjor@seven ~ $ curl -XPOST "http://localhost:3004/content/add?coluuid=$uuid&dir=/test1/test2/test3" -H "Authorization: Bearer $ESTUARY_TOKEN" -F 'data=@/Users/anjor/a'
{"cid":"bafkqaarrbi","estuaryId":8,"providers":["/ip4/192.168.86.32/tcp/6744/p2p/12D3KooWEuqadJHhbB1cerfsd5M7u2KSXGJRzhTRmxL3FJEdFeGb","/ip4/127.0.0.1/tcp/6744/p2p/12D3KooWEuqadJHhbB1cerfsd5M7u2KSXGJRzhTRmxL3FJEdFeGb"]}
anjor@seven ~ $ curl "http://localhost:3004/collections/content?coluuid=$uuid&dir=/test1/test2/test3" -H "Authorization: Bearer $ESTUARY_TOKEN"  | jq .
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   141  100   141    0     0  10960      0 --:--:-- --:--:-- --:--:-- 20142
[
  {
    "name": "a",
    "type": "",
    "size": 2,
    "contId": 8,
    "cid": "bafkqaarrbi",
    "dir": "/test1/test2/test3",
    "coluuid": "998d6947-7c3d-417d-bc1d-d5a833d4d6e6"
  }
]
anjor@seven ~ $ curl "http://localhost:3004/collections/content?coluuid=$uuid&dir=/test1/test2" -H "Authorization: Bearer $ESTUARY_TOKEN"  | jq .
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   128  100   128    0     0  11400      0 --:--:-- --:--:-- --:--:-- 25600
[
  {
    "name": "test3",
    "type": "directory",
    "size": 0,
    "contId": 0,
    "dir": "/test1/test2",
    "coluuid": "998d6947-7c3d-417d-bc1d-d5a833d4d6e6"
  }
]
anjor@seven ~ $ curl "http://localhost:3004/collections/content?coluuid=$uuid&dir=/test1" -H "Authorization: Bearer $ESTUARY_TOKEN"  | jq .
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   122  100   122    0     0  10738      0 --:--:-- --:--:-- --:--:-- 24400
[
  {
    "name": "test2",
    "type": "directory",
    "size": 0,
    "contId": 0,
    "dir": "/test1",
    "coluuid": "998d6947-7c3d-417d-bc1d-d5a833d4d6e6"
  }
]
anjor@seven ~ $ curl "http://localhost:3004/collections/content?coluuid=$uuid&dir=/" -H "Authorization: Bearer $ESTUARY_TOKEN"  | jq .
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   117  100   117    0     0  14523      0 --:--:-- --:--:-- --:--:-- 39000
[
  {
    "name": "test1",
    "type": "directory",
    "size": 0,
    "contId": 0,
    "dir": "/",
    "coluuid": "998d6947-7c3d-417d-bc1d-d5a833d4d6e6"
  }
]

Then added a file "b" at /test1/test2, and again fetched contents.

anjor@seven ~ $ curl -XPOST "http://localhost:3004/content/add?coluuid=$uuid&dir=/test1/test2" -H "Authorization: Bearer $ESTUARY_TOKEN" -F 'data=@/Users/anjor/b'
{"cid":"bafkqaarrbi","estuaryId":9,"providers":["/ip4/192.168.86.32/tcp/6744/p2p/12D3KooWEuqadJHhbB1cerfsd5M7u2KSXGJRzhTRmxL3FJEdFeGb","/ip4/127.0.0.1/tcp/6744/p2p/12D3KooWEuqadJHhbB1cerfsd5M7u2KSXGJRzhTRmxL3FJEdFeGb"]}
anjor@seven ~ $ curl "http://localhost:3004/collections/content?coluuid=$uuid&dir=/test1/test2/test3" -H "Authorization: Bearer $ESTUARY_TOKEN"  | jq .
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   141  100   141    0     0  11352      0 --:--:-- --:--:-- --:--:-- 23500
[
  {
    "name": "a",
    "type": "",
    "size": 2,
    "contId": 8,
    "cid": "bafkqaarrbi",
    "dir": "/test1/test2/test3",
    "coluuid": "998d6947-7c3d-417d-bc1d-d5a833d4d6e6"
  }
]
anjor@seven ~ $ curl "http://localhost:3004/collections/content?coluuid=$uuid&dir=/test1/test2" -H "Authorization: Bearer $ESTUARY_TOKEN"  | jq .
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   261  100   261    0     0  23206      0 --:--:-- --:--:-- --:--:-- 65250
[
  {
    "name": "test3",
    "type": "directory",
    "size": 0,
    "contId": 0,
    "dir": "/test1/test2",
    "coluuid": "998d6947-7c3d-417d-bc1d-d5a833d4d6e6"
  },
  {
    "name": "b",
    "type": "",
    "size": 2,
    "contId": 9,
    "cid": "bafkqaarrbi",
    "dir": "/test1/test2",
    "coluuid": "998d6947-7c3d-417d-bc1d-d5a833d4d6e6"
  }
]
anjor@seven ~ $ curl "http://localhost:3004/collections/content?coluuid=$uuid&dir=/test1" -H "Authorization: Bearer $ESTUARY_TOKEN"  | jq .
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   122  100   122    0     0  11236      0 --:--:-- --:--:-- --:--:-- 30500
[
  {
    "name": "test2",
    "type": "directory",
    "size": 0,
    "contId": 0,
    "dir": "/test1",
    "coluuid": "998d6947-7c3d-417d-bc1d-d5a833d4d6e6"
  }
]
anjor@seven ~ $ curl "http://localhost:3004/collections/content?coluuid=$uuid&dir=/" -H "Authorization: Bearer $ESTUARY_TOKEN"  | jq .
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   117  100   117    0     0  12831      0 --:--:-- --:--:-- --:--:-- 58500
[
  {
    "name": "test1",
    "type": "directory",
    "size": 0,
    "contId": 0,
    "dir": "/",
    "coluuid": "998d6947-7c3d-417d-bc1d-d5a833d4d6e6"
  }
]

I think the behaviour is generally what we want. There are a couple of things I still want to work out:

1. I think the way we handle subDir, there will be an issue if there are subdirectories with the same name, for example /abc/def/def
2. What exactly is going on with r.Type? I don't think we actually set that when we add content.

Ideally I would at least like to fix (1) in this PR. We can handle (2) separately.
on second thoughts, would like to merge this as soon as possible.

[anjor]

Associated RFC: https://docs.google.com/document/d/1jrPeo3hxAbI4SGS3c1cBhddwP4mIABQWdmQvV6kRbrQ/edit