feat: allow use as a singleton

packages/verified-fetch/src/index.ts

@@ -278,15 +278,15 @@ export interface VerifiedFetchInit extends RequestInit, ProgressOptions<BubbledP
 /**
  * Create and return a Helia node
  */
-export async function createVerifiedFetch (init: Helia | CreateVerifiedFetchWithOptions): Promise<VerifiedFetch> {
+export async function createVerifiedFetch (init?: Helia | CreateVerifiedFetchWithOptions): Promise<VerifiedFetch> {
   if (!isHelia(init)) {
     init = await createHeliaHTTP({
       blockBrokers: [
         trustlessGateway({
-          gateways: init.gateways
+          gateways: init?.gateways
         })
       ],
-      routers: init.routers?.map((routerUrl) => delegatedHTTPRouting(routerUrl))
+      routers: (init?.routers ?? ['https://delegated-ipfs.dev']).map((routerUrl) => delegatedHTTPRouting(routerUrl))
     })
   }
 
@@ -300,6 +300,8 @@ export async function createVerifiedFetch (init: Helia | CreateVerifiedFetchWith
   return verifiedFetch
 }
 
+export { verifiedFetch } from './singleton.js'
+
 function isHelia (obj: any): obj is Helia {
   // test for the presence of known Helia properties, return a boolean value
   return obj?.blockstore != null &&

packages/verified-fetch/src/singleton.ts

@@ -0,0 +1,23 @@
+import { createVerifiedFetch } from './index.js'
+import type { Resource, VerifiedFetch, VerifiedFetchInit } from './index.js'
+
+interface VerifiedFetchSingleton extends VerifiedFetch {
+  _impl?: VerifiedFetch
+}
+
+const singleton: VerifiedFetchSingleton = async function verifiedFetch (resource: Resource, options?: VerifiedFetchInit): Promise<Response> {
+  if (singleton._impl == null) {
+    singleton._impl = await createVerifiedFetch()
+  }
+
+  return singleton._impl(resource, options)
+}
+singleton.start = async function () {
+  await singleton._impl?.stop()
+}
+singleton.stop = async function () {
+  await singleton._impl?.stop()
+}
+const verifiedFetchSingleton: VerifiedFetch = singleton
+
+export { verifiedFetchSingleton as verifiedFetch }

packages/verified-fetch/test/index.spec.ts

@@ -2,7 +2,7 @@
 import { createHeliaHTTP } from '@helia/http'
 import { expect } from 'aegir/chai'
 import { createHelia } from 'helia'
-import { createVerifiedFetch } from '../src/index.js'
+import { createVerifiedFetch, verifiedFetch } from '../src/index.js'
 
 describe('createVerifiedFetch', () => {
   it('can be constructed with a HeliaHttp instance', async () => {
@@ -38,4 +38,17 @@ describe('createVerifiedFetch', () => {
     expect(verifiedFetch).to.be.ok()
     await verifiedFetch.stop()
   })
+
+  it('can be constructed with no options', async () => {
+    const verifiedFetch = await createVerifiedFetch()
+
+    expect(verifiedFetch).to.be.ok()
+    await verifiedFetch.stop()
+  })
+
+  it('can be used as a singleton', () => {
+    expect(verifiedFetch).to.be.a('function')
+    expect(verifiedFetch.stop).to.be.a('function')
+    expect(verifiedFetch.start).to.be.a('function')
+  })
 })