Merge branch 'main' of https://github.com/web3-storage/w3-protocol

* 'main' of https://github.com/web3-storage/w3-protocol:
  feat: add support for list pagination in list capability invocations (#184)

packages/access-client/src/capabilities/store.js

@@ -140,6 +140,17 @@ export const list = base.derive({
  * be stored.
  */
  with: URI.match({ protocol: 'did:' }),
+ nb: {
+ /**
+ * A pointer that can be moved back and forth on the list.
+ * It can be used to paginate a list for instance.
+ */
+ cursor: Schema.string().optional(),
+ /**
+ * Maximum number of items per page.
+ */
+ size: Schema.integer().optional(),
+ },
  derives: (claimed, delegated) => {
  if (claimed.with !== delegated.with) {
  return new Failure(

packages/access-client/src/capabilities/upload.js

@@ -8,7 +8,7 @@
  *
  * @module
  */
-import { capability, Link, URI } from '@ucanto/validator'
+import { capability, Link, URI, Schema } from '@ucanto/validator'
 import { codec as CAR } from '@ucanto/transport/car'
 import { equalWith, fail, equal } from './utils.js'
 import { top } from './top.js'
@@ -140,6 +140,17 @@ export const list = base.derive({
  to: capability({
  can: 'upload/list',
  with: URI.match({ protocol: 'did:' }),
+ nb: {
+ /**
+ * A pointer that can be moved back and forth on the list.
+ * It can be used to paginate a list for instance.
+ */
+ cursor: Schema.string().optional(),
+ /**
+ * Maximum number of items per page.
+ */
+ size: Schema.integer().optional(),
+ },
  }),
  /**
  * `upload/list` can be derived from the `upload/*` & `*` capability
@@ -150,4 +161,4 @@ export const list = base.derive({
 
 // ⚠️ We export imports here so they are not omited in generated typedefs
 // @see https://github.com/microsoft/TypeScript/issues/51548
-export { Link }
+export { Link, Schema }

packages/access-client/test/capabilities/upload.test.js

@@ -328,6 +328,7 @@ describe('upload capabilities', function () {
  audience: w3,
  with: account.did(),
  proofs: [await any],
+ nb: {},
  })
 
  const result = await access(await list.delegate(), {
@@ -357,6 +358,7 @@ describe('upload capabilities', function () {
  issuer: bob,
  with: account.did(),
  proofs: [await upload.delegate()],
+ nb: {},
  })
 
  const result = await access(await list.delegate(), {
@@ -379,13 +381,15 @@ describe('upload capabilities', function () {
  audience: bob,
  with: account.did(),
  proofs: [await any],
+ nb: {},
  })
 
  const list = Upload.list.invoke({
  audience: w3,
  issuer: bob,
  with: account.did(),
  proofs: [await delegation.delegate()],
+ nb: {},
  })
 
  const result = await access(await list.delegate(), {