@blockcast/mmt-container 0.1.0-main.149f78a4adae

package/src/fec-codec.ts

@@ -0,0 +1,61 @@
+/**
+ * Generic FEC codec interface. Transport-agnostic, algorithm-pluggable.
+ * Implementations: NoneCodec (passthrough), RaptorQCodec (wraps WASM),
+ * ReedSolomonCodec (placeholder).
+ */
+export interface FecCodec {
+  readonly algorithm: 'raptorq' | 'reed-solomon' | 'none'
+  addSymbol(blockId: number, symbolId: number, data: Uint8Array, isRepair: boolean): Uint8Array | null
+  configure(params: Uint8Array): void
+  cleanup(now: number): Uint8Array
+}
+
+/** Passthrough codec for reliable transports (QUIC streams). Returns data immediately. */
+export class NoneCodec implements FecCodec {
+  readonly algorithm = 'none' as const
+
+  addSymbol(_blockId: number, _symbolId: number, data: Uint8Array, _isRepair: boolean): Uint8Array | null {
+    return data
+  }
+
+  configure(_params: Uint8Array): void {}
+
+  cleanup(_now: number): Uint8Array {
+    return new Uint8Array(0)
+  }
+}
+
+/**
+ * Create a FecCodec from a catalog algorithm name.
+ * RaptorQ is not returned here — it requires a WASM module and is injected
+ * via FECManager.setFecDecoder(). This factory covers non-WASM codecs.
+ */
+export function createFecCodec(algorithm: string): FecCodec {
+  switch (algorithm) {
+    case 'none': return new NoneCodec()
+    case 'reed-solomon': return new ReedSolomonCodec()
+    case 'raptorq':
+      // RaptorQ requires WASM — caller must use FECManager.setFecDecoder() instead.
+      // Return NoneCodec as a safe fallback (passthrough, no recovery).
+      console.warn('[FEC] RaptorQ requested via createFecCodec — use FECManager.setFecDecoder() for WASM RaptorQ. Falling back to NoneCodec.')
+      return new NoneCodec()
+    default:
+      console.warn(`[FEC] Unknown algorithm "${algorithm}", falling back to NoneCodec`)
+      return new NoneCodec()
+  }
+}
+
+/** Placeholder for Reed-Solomon GF(2^8) per RFC 5510. Not yet implemented. */
+export class ReedSolomonCodec implements FecCodec {
+  readonly algorithm = 'reed-solomon' as const
+
+  addSymbol(_blockId: number, _symbolId: number, _data: Uint8Array, _isRepair: boolean): Uint8Array | null {
+    return null
+  }
+
+  configure(_params: Uint8Array): void {}
+
+  cleanup(_now: number): Uint8Array {
+    return new Uint8Array(0)
+  }
+}