feat: rename FilCDN to FilBeam (#239)

update `filcdn` -> `filbeam`

Author: juliangruber

src/retriever/filcdn.ts src/retriever/filbeam.tssrc/retriever/filcdn.ts renamed to src/retriever/filbeam.ts

@@ -1,13 +1,13 @@
 /**
- * FilCdnRetriever - CDN optimization wrapper for piece retrieval
+ * FilBeamRetriever - CDN optimization wrapper for piece retrieval
  *
  * This intercepts piece requests and attempts CDN retrieval before falling back
  * to the base retriever.
  */
 
 import type { FilecoinNetworkType, PieceCID, PieceRetriever } from '../types.ts'
 
-export class FilCdnRetriever implements PieceRetriever {
+export class FilBeamRetriever implements PieceRetriever {
   private readonly baseRetriever: PieceRetriever
   private readonly network: FilecoinNetworkType
 
@@ -17,7 +17,7 @@ export class FilCdnRetriever implements PieceRetriever {
   }
 
   hostname(): string {
-    return this.network === 'mainnet' ? 'filcdn.io' : 'calibration.filcdn.io'
+    return this.network === 'mainnet' ? 'filbeam.io' : 'calibration.filbeam.io'
   }
 
   async fetchPiece(

src/retriever/index.ts

@@ -3,10 +3,10 @@
  *
  * This module provides different strategies for retrieving pieces:
  * - ChainRetriever: Queries on-chain data to find providers
- * - FilCdnRetriever: CDN optimization wrapper
+ * - FilBeamRetriever: CDN optimization wrapper
  * - SubgraphRetriever: Queries a GraphQL subgraph to find providers
  */
 
 export { ChainRetriever } from './chain.ts'
-export { FilCdnRetriever } from './filcdn.ts'
+export { FilBeamRetriever } from './filbeam.ts'
 export { SubgraphRetriever } from './subgraph.ts'

src/synapse.ts

@@ -4,7 +4,7 @@
 
 import { ethers } from 'ethers'
 import { PaymentsService } from './payments/index.ts'
-import { ChainRetriever, FilCdnRetriever, SubgraphRetriever } from './retriever/index.ts'
+import { ChainRetriever, FilBeamRetriever, SubgraphRetriever } from './retriever/index.ts'
 import { SPRegistryService } from './sp-registry/index.ts'
 import type { StorageService } from './storage/index.ts'
 import { StorageManager } from './storage/manager.ts'
@@ -146,7 +146,7 @@ export class Synapse {
     if (options.pieceRetriever != null) {
       pieceRetriever = options.pieceRetriever
     } else {
-      // Create default retriever chain: FilCDN wraps the base retriever
+      // Create default retriever chain: FilBeam wraps the base retriever
       const chainRetriever = new ChainRetriever(warmStorageService, spRegistry)
 
       // Check for subgraph option
@@ -159,8 +159,8 @@ export class Synapse {
         baseRetriever = new SubgraphRetriever(subgraphService)
       }
 
-      // Wrap with FilCDN retriever
-      pieceRetriever = new FilCdnRetriever(baseRetriever, network)
+      // Wrap with FilBeam retriever
+      pieceRetriever = new FilBeamRetriever(baseRetriever, network)
     }
 
     return new Synapse(

src/test/retriever-filcdn.test.ts

@@ -1,13 +1,13 @@
 /* globals describe it */
 import { assert } from 'chai'
 import { asPieceCID } from '../piece/index.ts'
-import { FilCdnRetriever } from '../retriever/filcdn.ts'
+import { FilBeamRetriever } from '../retriever/filbeam.ts'
 import type { PieceCID, PieceRetriever } from '../types.ts'
 
 // Create a mock PieceCID for testing
 const mockPieceCID = asPieceCID('bafkzcibeqcad6efnpwn62p5vvs5x3nh3j7xkzfgb3xtitcdm2hulmty3xx4tl3wace') as PieceCID
 
-describe('FilCdnRetriever', () => {
+describe('FilBeamRetriever', () => {
   describe('pass-through behavior', () => {
     it('should pass through when withCDN=false', async () => {
       let baseCalled = false
@@ -29,7 +29,7 @@ describe('FilCdnRetriever', () => {
       }
 
       try {
-        const cdnRetriever = new FilCdnRetriever(mockBaseRetriever, 'calibration')
+        const cdnRetriever = new FilBeamRetriever(mockBaseRetriever, 'calibration')
         const response = await cdnRetriever.fetchPiece(mockPieceCID, '0xClient', {
           withCDN: false,
         })
@@ -60,7 +60,7 @@ describe('FilCdnRetriever', () => {
       }
 
       try {
-        const cdnRetriever = new FilCdnRetriever(mockBaseRetriever, 'mainnet')
+        const cdnRetriever = new FilBeamRetriever(mockBaseRetriever, 'mainnet')
         await cdnRetriever.fetchPiece(mockPieceCID, '0xClient', {
           signal: controller.signal,
           withCDN: false,
@@ -94,7 +94,7 @@ describe('FilCdnRetriever', () => {
       }
 
       try {
-        const cdnRetriever = new FilCdnRetriever(mockBaseRetriever, 'calibration')
+        const cdnRetriever = new FilBeamRetriever(mockBaseRetriever, 'calibration')
         const response = await cdnRetriever.fetchPiece(mockPieceCID, '0xClient', {
           withCDN: true,
         })
@@ -129,7 +129,7 @@ describe('FilCdnRetriever', () => {
       }
 
       try {
-        const cdnRetriever = new FilCdnRetriever(mockBaseRetriever, 'calibration')
+        const cdnRetriever = new FilBeamRetriever(mockBaseRetriever, 'calibration')
         const response = await cdnRetriever.fetchPiece(mockPieceCID, '0xClient', {
           withCDN: true,
         })
@@ -163,7 +163,7 @@ describe('FilCdnRetriever', () => {
       }
 
       try {
-        const cdnRetriever = new FilCdnRetriever(mockBaseRetriever, 'calibration')
+        const cdnRetriever = new FilBeamRetriever(mockBaseRetriever, 'calibration')
         const response = await cdnRetriever.fetchPiece(mockPieceCID, '0xClient', {
           withCDN: true,
         })
@@ -194,14 +194,14 @@ describe('FilCdnRetriever', () => {
         cdnCalled = true
         assert.strictEqual(
           url,
-          `https://0xClient.calibration.filcdn.io/${mockPieceCID.toString()}`,
+          `https://0xClient.calibration.filbeam.io/${mockPieceCID.toString()}`,
           'CDN URL should be constructed correctly'
         )
         return cdnResponse
       }
 
       try {
-        const cdnRetriever = new FilCdnRetriever(mockBaseRetriever, 'calibration')
+        const cdnRetriever = new FilBeamRetriever(mockBaseRetriever, 'calibration')
         const response = await cdnRetriever.fetchPiece(mockPieceCID, '0xClient', {
           withCDN: true,
         })
@@ -221,19 +221,19 @@ describe('FilCdnRetriever', () => {
         fetchPiece: async () => new Response(),
       }
 
-      const cdnRetriever = new FilCdnRetriever(mockBaseRetriever, 'mainnet')
+      const cdnRetriever = new FilBeamRetriever(mockBaseRetriever, 'mainnet')
       assert.exists(cdnRetriever)
-      assert.strictEqual(cdnRetriever.hostname(), 'filcdn.io')
+      assert.strictEqual(cdnRetriever.hostname(), 'filbeam.io')
     })
 
     it('should accept calibration network', () => {
       const mockBaseRetriever: PieceRetriever = {
         fetchPiece: async () => new Response(),
       }
 
-      const cdnRetriever = new FilCdnRetriever(mockBaseRetriever, 'calibration')
+      const cdnRetriever = new FilBeamRetriever(mockBaseRetriever, 'calibration')
       assert.exists(cdnRetriever)
-      assert.strictEqual(cdnRetriever.hostname(), 'calibration.filcdn.io')
+      assert.strictEqual(cdnRetriever.hostname(), 'calibration.filbeam.io')
     })
   })
 })

src/test/synapse.test.ts

@@ -403,7 +403,7 @@ describe('Synapse', () => {
       const testData = new TextEncoder().encode('test data')
       server.use(
         JSONRPC({ ...presets.basic }),
-        http.get<{ cid: string; wallet: string }>(`https://:wallet.calibration.filcdn.io/:cid`, async ({ params }) => {
+        http.get<{ cid: string; wallet: string }>(`https://:wallet.calibration.filbeam.io/:cid`, async ({ params }) => {
           deferred.resolve(params)
           return HttpResponse.arrayBuffer(testData.buffer)
         }),