root dd2c917f05 feat(data-quality): product_type classification + form_factor recovery + lead_time docs
sql/119: product_type enum (module|dac|aoc|aec|switch|nic|accessory) computed by
trigger trg_transceivers_biu from part_number/category/reach on every insert/update.
Backfilled 41008 rows (36284 module, 2791 dac, 1835 aoc, 29 aec, 27 accessory,
26 switch, 16 nic). Cables and switches/NICs no longer counted as modules;
BASE-T/RJ45 copper modules protected from cable demotion; AOC/DAC keyword beats
the optical-token guard. Consumers filter product_type=module.

sql/120: conservative form_factor recovery. Corrects only provably-wrong rows
(form_factors.max_speed < speed_gbps) via an explicit title token; 87 fixed
(e.g. 400G cables mislabelled SFP+ to QSFP-DD), 947 opaque rows left untouched
(never guessed). Scraped original preserved in new column form_factor_raw.

sql/121: document lead_time_days as not-collected (0 percent populated on all
time-series tables) so no consumer fabricates a default.

scraper/utils/db.ts: note that product_type/form_factor are trigger-maintained.
2026-07-04 16:05:28 +00:00

transceiver-db

🚀 Live Demo — Try it in your browser, no installation needed.

npm version License: MIT TypeScript Zero Dependencies

Open-source optical transceiver database for network engineers, tooling developers, and infrastructure automation.

159 products. 42 IEEE/MSA standards. 16 form factors. 9 speed tiers.

From 1G SFP to 800G OSFP. Zero dependencies.

Why?

🚀 Live Demo — Try it in your browser, no installation needed.

No open-source transceiver database existed. Network engineers, inventory systems, and automation tools had to maintain their own fragmented lists. Now there is a single, typed, searchable source of truth.

Install

npm install transceiver-db

Quick Start

import { searchTransceivers, getBySpeed, getStandard } from 'transceiver-db';

// Search by any keyword
const results = searchTransceivers('100G LR');
console.log(results.map(t => `${t.standard} (${t.formFactor}) - ${t.reachLabel}`));

// Filter by speed
const optics400g = getBySpeed('400G');
console.log(`Found ${optics400g.length} 400G transceivers`);

// Look up an IEEE standard
const standard = getStandard('400GBASE-DR4');
console.log(standard?.notes); // "4x100G parallel SMF. THE key 400G data center optic."

API Reference

Transceivers

import {
  transceivers,          // All 159 transceivers (readonly array)
  searchTransceivers,    // Full-text search across all fields
  getByFormFactor,       // Filter by form factor ("SFP+", "QSFP-DD", etc.)
  getBySpeed,            // Filter by speed tier ("10G", "100G", "400G", etc.)
  getByReach,            // Filter by minimum reach in meters
  getByCategory,         // Filter by category ("DataCenter", "Coherent", etc.)
  getById,               // Get single transceiver by ID
} from 'transceiver-db';

Standards

import {
  standards,             // All 42 IEEE/MSA standards
  getStandard,           // Find by exact or partial name
  searchStandards,       // Search by keyword
} from 'transceiver-db';

Competitors

import {
  competitors,           // 12 major vendors (Cisco, Juniper, Arista, etc.)
  getCompetitor,         // Find by name
} from 'transceiver-db';

Breakout Cables

import { breakouts } from 'transceiver-db'; // 11 breakout configurations

Types

import type {
  Transceiver,
  Standard,
  Competitor,
  Breakout,
  FormFactor,      // "SFP" | "SFP+" | "QSFP-DD" | "OSFP" | ...
  FiberType,       // "MMF" | "SMF" | "Copper" | "N/A"
  ConnectorType,   // "LC" | "MPO-12" | "MPO-16" | "RJ45" | ...
  ProductCategory, // "DataCenter" | "Metro" | "Coherent" | "DAC" | ...
  PriceTier,       // "Budget" | "Standard" | "Premium"
  MarketStatus,    // "Mainstream" | "Growth" | "Emerging" | "Legacy"
} from 'transceiver-db';

Coverage

Speed Products Form Factors
1G 9 GBIC, SFP
10G 13 XFP, SFP+
25G 6 SFP28
40G 4 QSFP+
50G 2 SFP56
100G 20 QSFP28, CFP, CFP2, CFP4, CXP
200G 4 QSFP56
400G 18 QSFP-DD, OSFP, CFP2-DCO
800G 5 OSFP
DAC 6 SFP+ to OSFP
AOC 3 SFP+ to QSFP-DD

Each transceiver includes: standard, form factor, speed, reach, fiber type, wavelengths, connector, power consumption, temperature range, vendor compatibility patterns, use case description, and tags.

Data Sources

All data comes from publicly available sources:

  • IEEE 802.3 standards (802.3z, 802.3ae, 802.3ba, 802.3bs, 802.3cd, 802.3cu, 802.3cm, 802.3df, etc.)
  • OIF standards (400ZR, 800ZR)
  • Multi-Source Agreements (100G CWDM4 MSA, 100G PSM4 MSA, 100G Lambda MSA, OpenZR+)
  • Vendor datasheets and public documentation

Flexoptix Catalog Import

Private TIP deployments can import the normalized Flexoptix shop catalog produced by Magatama/Pulso:

npm run flexoptix:catalog:import -- --dry-run
TIP_DB_PASS=... npm run flexoptix:catalog:import

See docs/FLEXOPTIX_CATALOG_IMPORT.md for the full producer/import workflow and safety rules.

Contributing

Contributions welcome. To add a new transceiver:

  1. Fork the repo
  2. Add the entry to src/database.ts following the existing format
  3. Include all required fields from the Transceiver type
  4. Add relevant vendor compatibility patterns
  5. Submit a PR with a description of what you added

To add a new standard, update src/standards.ts.

License

MIT

Description
Transceiver Intelligence Platform - npm package + data
Readme MIT 74 MiB
Languages
TypeScript 81.6%
HTML 13.1%
PLpgSQL 2.1%
Python 1.4%
JavaScript 1%
Other 0.8%