feat: add head bytes endpoint

src/bee.ts

@@ -67,6 +67,7 @@
   PublicKey,
   RedistributionState,
   Reference,
+  ReferenceInformation,
   RemovePeerResponse,
   ReserveState,
   SOCReader,
@@ -207,6 +208,18 @@
     return bytes.upload(this.getRequestOptionsForCall(requestOptions), data, postageBatchId, options)
   }
 
+  /**
+   * Requests content length for a `/bytes` reference
+   *
+   * @see [Bee API reference - `HEAD /bytes/`](https://docs.ethswarm.org/api/#tag/Bytes/paths/~1bytes~1%7Breference%7D/head)
+   */
+  async probeData(reference: ReferenceOrEns | string, options?: BeeRequestOptions): Promise<ReferenceInformation> {
+    assertRequestOptions(options)
+    assertReferenceOrEns(reference)
+
+    return bytes.head(this.getRequestOptionsForCall(options), reference)
+  }
+
   /**
    * Download data as a byte array
    *
@@ -346,7 +359,7 @@
         ReferenceType.MANIFEST,
       )
     } else if (isReadable(data) && options?.tag && !options.size) {
       // TODO: Needed until https://github.com/ethersphere/bee/issues/2317 is resolved
       const result = await bzz.uploadFile(
         this.getRequestOptionsForCall(requestOptions),
         data,
@@ -724,7 +737,7 @@
         await this.makeFeedReader(type, canonicalTopic, canonicalOwner).download()
 
         return true
       } catch (e: any) {
         if (e?.response?.status === 404) {
           return false
         }
@@ -1818,7 +1831,7 @@
         if (stamp.usable) {
           return
         }
       } catch (error: any) {}
 
       await System.sleepMillis(TIME_STEP)
     }

src/modules/bytes.ts

@@ -4,6 +4,7 @@ import type {
   Data,
   DownloadRedundancyOptions,
   Reference,
+  ReferenceInformation,
   ReferenceOrEns,
   UploadOptions,
   UploadRedundancyOptions,
@@ -47,6 +48,24 @@ export async function upload(
   }
 }
 
+/**
+ * Requests content length for a reference
+ *
+ * @param requestOptions Options for making requests
+ * @param hash Bee content reference
+ */
+export async function head(requestOptions: BeeRequestOptions, hash: ReferenceOrEns): Promise<ReferenceInformation> {
+  const response = await http<void>(requestOptions, {
+    url: `${endpoint}/${hash}`,
+    method: 'head',
+    responseType: 'json',
+  })
+
+  return {
+    contentLength: parseInt(response.headers['content-length'] as string),
+  }
+}
+
 /**
  * Download data as a byte array
  *

src/types/index.ts

@@ -323,6 +323,10 @@ export interface Pin {
   reference: string
 }
 
+export interface ReferenceInformation {
+  contentLength: number
+}
+
 /**
  * Helper interface that adds utility functions
  * to work more conveniently with bytes in normal