#!/usr/bin/env node // Fetches TSP data from the Catena API at build time and generates: // - get-started/providers/{slug}.mdx (one page per provider) // - get-started/supported-providers.mdx (static table replacing the React component) // - snippets/provider-count.mdx (static count replacing the React component) // - snippets/providers-table.mdx (static table replacing the React component) // - snippets/status-legend.mdx (Integration Status Guide, from STATUS_CONFIG) // - docs.json navigation update const fs = require('node:fs'); const path = require('node:path'); const ROOT = path.join(__dirname, '..'); const ORG_TSPS_URL = 'https://api.catenatelematics.com/v2/orgs/tsps'; const INTEGRATION_TSPS_URL = 'https://api.catenatelematics.com/v2/integrations/tsps'; const INTEGRATION_LABELS = { asset: 'Asset', driver_association: 'Driver Association', driver_vehicle_association: 'Driver-Vehicle Association', driver_event_log: 'Driver Event Log', driver_safety_event: 'Driver Safety Event', dvir_log: 'DVIR Log', dvir_log_defect: 'DVIR Log Defect', engine_log: 'Engine Log', engine_status: 'Engine Status', fuel_transaction: 'Fuel Transaction', fleet_info: 'Fleet Info', hos_availability: 'HOS Availability', hos_daily_snapshot: 'HOS Daily Snapshot', hos_event: 'HOS Event', hos_event_annotation: 'HOS Event Annotation', hos_event_attachment: 'HOS Event Attachment', hos_violation: 'HOS Violation', ifta_summary: 'IFTA Summary', location_segment: 'Location Segment', message: 'Message', group_message: 'Group Message', user: 'User', vehicle: 'Vehicle', vehicle_location: 'Vehicle Location', vehicle_sensor: 'Vehicle Sensor', vehicle_region_segment: 'Vehicle Region Segment', trailer: 'Trailer', trailer_association: 'Trailer Association', trailer_vehicle_association: 'Trailer-Vehicle Association', trailer_location: 'Trailer Location', trailer_status: 'Trailer Status', workflow: 'Workflow', }; const INTEGRATION_STATUS_DISPLAY = { implemented: '', not_implemented: '', not_supported: '', unknown: '—', }; const STATUS_CONFIG = { active: { label: 'Active', icon: 'check', color: '#059669', description: 'Fully operational and available for use.', }, integrated: { label: 'Integrated', icon: 'code-merge', color: '#0ba7f5', description: 'Integration is complete and awaiting final approval from the provider.', }, in_progress: { label: 'In Development', icon: 'spinner', color: '#f59e0b', description: 'Actively being built by our team.', }, pending: { label: 'Planned', icon: 'clock', color: '#64748b', description: 'Queued for integration.', }, inactive: { label: 'Inactive', icon: 'xmark', color: '#dc2626', description: 'Not currently available.', }, }; const FALLBACK_STATUS = { label: 'Unknown', icon: 'circle-question', color: '#9ca3af', description: 'Status not recognised by the docs site.', }; const unrecognisedStatuses = new Set(); function resolveStatus(status) { // Own-property lookup only: a bare `STATUS_CONFIG[status]` matches inherited keys // like `toString`, so an upstream value of that name would return a non-entry // object and render `icon="undefined"` instead of degrading. const key = status == null ? '' : String(status); if (Object.prototype.hasOwnProperty.call(STATUS_CONFIG, key)) return STATUS_CONFIG[key]; // Statuses are owned upstream; an unseen value must degrade to a badge rather // than leak a raw enum to readers or fail the scheduled rebuild. unrecognisedStatuses.add(key || '(empty)'); return FALLBACK_STATUS; } function statusBadge(entry) { return ` ${entry.label}`; } async function fetchJson(url) { const controller = new AbortController(); const timeout = setTimeout(() => controller.abort(), 30_000); try { const res = await fetch(url, { headers: { Accept: 'application/json', 'User-Agent': 'catena-docs-builder/1.0 (+https://docs.catenatelematics.com)', }, signal: controller.signal, }); if (!res.ok) throw new Error(`Failed to fetch ${url}: ${res.status} ${res.statusText}`); return res.json(); } finally { clearTimeout(timeout); } } function generateProviderPage(provider, integration) { const name = provider.name || provider.display_name || 'Unknown Provider'; const statusHtml = statusBadge(resolveStatus(provider.status)); const website = provider.websites && provider.websites.length > 0 ? provider.websites[0] : null; const hasValidWebsite = website && !website.toLowerCase().includes('unknown'); const logoUrl = provider.logo_url || null; const websiteRow = hasValidWebsite ? `| **Website** | [${website.replace(/^https?:\/\/(www\.)?/, '').replace(/\/$/, '')}](${website}) |` : ''; const logoSection = logoUrl ? ` ${name} logo

\n\n` : ''; let dataSection; if (integration?.integrations) { const rows = Object.entries(integration.integrations) .filter(([, value]) => value === 'implemented' || value === 'not_implemented' || value === 'not_supported') .map(([key, value]) => { const label = INTEGRATION_LABELS[key] || key; const display = INTEGRATION_STATUS_DISPLAY[value] || value; return `| ${label} | ${display} |`; }) .join('\n'); dataSection = `## Data Availability ${INTEGRATION_STATUS_DISPLAY.implemented} **${integration.implemented_count} implemented**
${INTEGRATION_STATUS_DISPLAY.not_implemented} ${integration.not_implemented_count} not implemented
${INTEGRATION_STATUS_DISPLAY.not_supported} ${integration.not_supported_count} not supported | Data Type | Status | |---|---| ${rows}`; } else { dataSection = `## Data Availability Data availability details for ${name} are not yet available. Contact [support@catenaclearing.io](mailto:support@catenaclearing.io) for more information. `; } return `--- title: ${JSON.stringify(name)} sidebarTitle: ${JSON.stringify(name)} description: ${JSON.stringify(`Integration status and data availability for ${name} on the Catena Telematics API`)} --- ${logoSection}| | | |---|---| | **Status** | ${statusHtml} | ${websiteRow} ${dataSection} --- Contact our support team for help with ${name} integrations. `; } function generateProviderTableSnippet(providers) { const items = providers .map((p) => { const name = p.name || p.display_name || 'Unknown Provider'; const statusHtml = statusBadge(resolveStatus(p.status)); const logoUrl = p.logo_url || null; const logoImg = logoUrl ? `

` : ``; return `

${logoImg}${name}${statusHtml}

`; }) .join('\n'); return `

${items} `; } function generateProviderCountSnippet(count) { return `export const providerCount = ${count}; export const ProviderCountSnippet = () => (

Catena currently supports ${count} ELD providers. See the list.

); `; } function generateStatusLegendSnippet() { // "Unknown" is not part of the vocabulary Catena publishes, so it earns a row // only while a provider on the page is actually wearing that badge. const entries = Object.values(STATUS_CONFIG); if (unrecognisedStatuses.size > 0) entries.push(FALLBACK_STATUS); const rows = entries .map( ({ label, icon, color, description }) => `

${label} - ${description}

`, ) .join('\n'); return `{/* Generated by scripts/generate-tsp-pages.js — hand edits are overwritten by the next build. */}

Integration Status Guide

${rows}

Have questions about a provider's integration status? Contact our support team.

`; } async function main() { console.log('Fetching TSP data...'); let orgData, integrationData; try { [orgData, integrationData] = await Promise.all([ fetchJson(ORG_TSPS_URL), fetchJson(INTEGRATION_TSPS_URL), ]); } catch (err) { console.warn(`Warning: could not fetch TSP data — ${err.message}`); console.warn('Skipping page generation; existing files are unchanged.'); process.exit(0); } const providers = (Array.isArray(orgData) ? orgData : []) .filter((p) => !p.is_sandbox) .sort((a, b) => { const nameA = (a.name || a.display_name || '').toLowerCase(); const nameB = (b.name || b.display_name || '').toLowerCase(); return nameA.localeCompare(nameB); }); console.log(`Found ${providers.length} providers`); // Build integration map keyed by source_name (multiple org providers share one integration source) const integrationMap = {}; for (const item of integrationData.items || []) { integrationMap[item.source_name] = item; } // Prepare providers directory — this dir is fully owned by this script const providersDir = path.join(ROOT, 'get-started', 'providers'); if (fs.existsSync(providersDir)) { for (const file of fs.readdirSync(providersDir)) { if (file.endsWith('.mdx')) fs.unlinkSync(path.join(providersDir, file)); } } else { fs.mkdirSync(providersDir, { recursive: true }); } // Generate individual provider pages const providerNavPaths = []; for (const provider of providers) { const integration = integrationMap[provider.source_name] || null; const content = generateProviderPage(provider, integration); fs.writeFileSync(path.join(providersDir, `${provider.slug}.mdx`), content, 'utf-8'); providerNavPaths.push(`get-started/providers/${provider.slug}`); } console.log(`Generated ${providerNavPaths.length} individual provider pages`); // Ensure snippets directory exists fs.mkdirSync(path.join(ROOT, 'snippets'), { recursive: true }); // Rewrite provider table snippet (imported by supported-providers.mdx) fs.writeFileSync( path.join(ROOT, 'snippets', 'providers-table.mdx'), generateProviderTableSnippet(providers), 'utf-8', ); console.log('Updated snippets/providers-table.mdx'); // Rewrite provider-count snippet fs.writeFileSync( path.join(ROOT, 'snippets', 'provider-count.mdx'), generateProviderCountSnippet(providers.length), 'utf-8', ); console.log('Updated snippets/provider-count.mdx'); // Rewrite the status legend snippet (imported by supported-providers.mdx) fs.writeFileSync( path.join(ROOT, 'snippets', 'status-legend.mdx'), generateStatusLegendSnippet(), 'utf-8', ); console.log('Updated snippets/status-legend.mdx'); // Update docs.json: replace flat "get-started/supported-providers" with a dropdown group const docsJsonPath = path.join(ROOT, 'docs.json'); const docsJson = JSON.parse(fs.readFileSync(docsJsonPath, 'utf-8')); const newProviderGroup = { group: 'Supported Providers', icon: 'list-check', pages: ['get-started/supported-providers', ...providerNavPaths], }; function replaceInNav(pages) { for (let i = 0; i < pages.length; i++) { const entry = pages[i]; if (entry === 'get-started/supported-providers') { pages[i] = newProviderGroup; } else if (entry && typeof entry === 'object' && entry.group === 'Supported Providers') { pages[i] = newProviderGroup; } else if (entry && typeof entry === 'object' && Array.isArray(entry.pages)) { replaceInNav(entry.pages); } } } for (const tab of docsJson.navigation?.tabs || []) { for (const group of tab.groups || []) { replaceInNav(group.pages || []); } } fs.writeFileSync(docsJsonPath, `${JSON.stringify(docsJson, null, 2)}\n`, 'utf-8'); console.log('Updated docs.json navigation with provider dropdown'); if (unrecognisedStatuses.size > 0) { // Warn, never fail: the scheduled rebuild commits straight to main, so a hard // failure over one cosmetic badge would freeze every provider update with it. console.warn( `Warning: unrecognised provider status(es): ${[...unrecognisedStatuses].sort().join(', ')}`, ); } console.log('Done.'); } main().catch((err) => { console.error(err); process.exit(1); });


Status	Active
Website	securepatheld.com

Data Type	Status
User
Vehicle
Vehicle Location

​Data Availability

Questions about this provider?

Data Availability