fix: rename get batch methods (#1029)

Author: Cafe137

src/bee.ts

@@ -1825,15 +1825,34 @@ export class Bee {
    *
    * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive)
    * @see [Bee Debug API reference - `GET /stamps`](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps/get)
+   * @deprecated Use `getPostageBatches` instead
    */
   async getAllPostageBatch(options?: BeeRequestOptions): Promise<PostageBatch[]> {
-    return stamps.getAllPostageBatches(this.getRequestOptionsForCall(options))
+    return stamps.getAllPostageBatches(this.getRequestOptionsForCall(options)) // TODO: remove in June 2025
   }
 
   /**
    * Return all globally available postage batches.
+   * @deprecated Use `getGlobalPostageBatches` instead
    */
   async getAllGlobalPostageBatch(options?: BeeRequestOptions): Promise<GlobalPostageBatch[]> {
+    return stamps.getGlobalPostageBatches(this.getRequestOptionsForCall(options)) // TODO: remove in June 2025
+  }
+
+  /**
+   * Return all postage batches that belong to the node.
+   *
+   * @see [Bee docs - Keep your data alive / Postage stamps](https://docs.ethswarm.org/docs/develop/access-the-swarm/introduction/#keep-your-data-alive)
+   * @see [Bee Debug API reference - `GET /stamps`](https://docs.ethswarm.org/api/#tag/Postage-Stamps/paths/~1stamps/get)
+   */
+  async getPostageBatches(options?: BeeRequestOptions): Promise<PostageBatch[]> {
+    return stamps.getAllPostageBatches(this.getRequestOptionsForCall(options))
+  }
+
+  /**
+   * Return all globally available postage batches.
+   */
+  async getGlobalPostageBatches(options?: BeeRequestOptions): Promise<GlobalPostageBatch[]> {
     return stamps.getGlobalPostageBatches(this.getRequestOptionsForCall(options))
   }
 

test/integration/stamp.spec.ts

@@ -5,7 +5,7 @@ import { batch, makeBee } from '../utils'
 const bee = makeBee()
 
 test('GET stamps', async () => {
-  const stamps = await bee.getAllPostageBatch()
+  const stamps = await bee.getPostageBatches()
   expect(stamps.length).toBeGreaterThan(0)
 
   const stamp = await bee.getPostageBatch(stamps[0].batchID)
@@ -16,7 +16,7 @@ test('GET stamps', async () => {
 })
 
 test('GET batches', async () => {
-  const batches = await bee.getAllGlobalPostageBatch()
+  const batches = await bee.getGlobalPostageBatches()
   expect(batches.length).toBeGreaterThan(0)
 })