fix: export ipfs http client type and use option extension for client (#3763)

Bubbles the `OptionExtension` up to the root type for use by the HTTP client and exports an interface for use by consuming modules.

Supersedes #3749 and #3736

Author: achingbrain

src/index.js

@@ -20,6 +20,7 @@ const { base58btc } = require('multiformats/bases/base58')
  * @typedef {import('./types').EndpointConfig} EndpointConfig
  * @typedef {import('./types').Options} Options
  * @typedef {import('multiformats/codecs/interface').BlockCodec<any, any>} BlockCodec
+ * @typedef {import('./types').IPFSHTTPClient} IPFSHTTPClient
  */
 
 /**
@@ -49,7 +50,7 @@ function create (options = {}) {
     loadHasher: options.ipld && options.ipld.loadHasher
   })
 
-  /** @type {import('ipfs-core-types').IPFS & { getEndpointConfig: () => EndpointConfig }} */
+  /** @type {IPFSHTTPClient} */
   const client = {
     add: require('./add')(options),
     addAll: require('./add-all')(options),

src/types.d.ts

@@ -2,6 +2,7 @@ import { Agent as HttpAgent } from 'http'
 import { Agent as HttpsAgent } from 'https'
 import { Multiaddr } from 'multiaddr'
 import type { BlockCodec } from 'multiformats/codecs/interface'
+import type { IPFS } from 'ipfs-core-types'
 
 export interface Options {
   host?: string
@@ -40,3 +41,7 @@ export interface EndpointConfig {
   pathname: string
   'api-path': string
 }
+
+export interface IPFSHTTPClient extends IPFS<HTTPClientExtraOptions> {
+  getEndpointConfig: () => EndpointConfig
+}