@f1-nexus/node

High-performance Node.js bindings for F1 Nexus using NAPI-RS - Formula 1 race strategy optimization with native speed.

Features

• ⚡ Native Performance: Zero-copy data transfer between Node.js and Rust
• 🚀 Blazing Fast: 10x-100x faster than pure JavaScript implementations
• 💪 Production Ready: Battle-tested in high-load environments
• 📦 Easy Integration: Drop-in replacement for JavaScript strategy libraries
• 🔒 Type Safe: Full TypeScript definitions included
• 🌍 Cross-Platform: Prebuilt binaries for Linux, macOS, Windows

Installation

npm install @f1-nexus/node

Supported Platforms

• ✅ Linux x64, ARM64
• ✅ macOS x64 (Intel), ARM64 (Apple Silicon)
• ✅ Windows x64

Quick Start

const f1 = require('@f1-nexus/node');

// Optimize pit strategy
const params = {
  track: 'monaco',
  totalLaps: 78,
  currentLap: 1,
  availableCompounds: ['C1', 'C2', 'C3'],
  fuelRemaining: 110.0,
  position: 3
};

const strategy = JSON.parse(f1.optimizeStrategy(JSON.stringify(params)));

console.log('Optimal Strategy:');
console.log(`Starting compound: ${strategy.startingCompound}`);
strategy.pitStops.forEach((stop, i) => {
  console.log(`Stop ${i + 1}: Lap ${stop.lap} → ${stop.compound}`);
});
console.log(`Predicted time: ${strategy.predictedRaceTime.toFixed(2)}s`);
console.log(`Confidence: ${(strategy.confidence * 100).toFixed(1)}%`);

TypeScript

import * as f1 from '@f1-nexus/node';

interface OptimizeParams {
  track: string;
  totalLaps: number;
  currentLap?: number;
  availableCompounds: string[];
  fuelRemaining?: number;
  position?: number;
}

interface Strategy {
  strategyId: string;
  startingCompound: string;
  pitStops: Array<{
    lap: number;
    compound: string;
    pitLoss: number;
    reason: string;
    confidence: number;
  }>;
  predictedRaceTime: number;
  confidence: number;
}

const params: OptimizeParams = {
  track: 'silverstone',
  totalLaps: 52,
  availableCompounds: ['C1', 'C2', 'C3']
};

const strategy: Strategy = JSON.parse(
  f1.optimizeStrategy(JSON.stringify(params))
);

Express.js REST API

const express = require('express');
const f1 = require('@f1-nexus/node');

const app = express();
app.use(express.json());

app.post('/api/optimize', (req, res) => {
  try {
    const strategy = JSON.parse(
      f1.optimizeStrategy(JSON.stringify(req.body))
    );
    res.json({ success: true, strategy });
  } catch (error) {
    res.status(500).json({ success: false, error: error.message });
  }
});

app.listen(3000, () => {
  console.log('F1 strategy API running on port 3000');
});

API Reference

optimizeStrategy(paramsJson: string): string

Find optimal pit stop strategy using dynamic programming.

Input JSON:

{
  "track": "monaco",
  "totalLaps": 78,
  "currentLap": 1,
  "availableCompounds": ["C1", "C2", "C3"],
  "fuelRemaining": 110.0,
  "position": 3,
  "competitors": []
}

Output JSON: Optimized strategy with pit stops, compounds, and predicted time

simulateRace(paramsJson: string): string

Run Monte Carlo simulation to validate strategy.

Input: Strategy + simulation config (JSON) Output: Distribution of finish times, DNF probability (JSON)

predictTireLife(paramsJson: string): string

Predict tire degradation and optimal pit window.

Input: Tire data + track conditions (JSON) Output: Remaining laps, degradation curve (JSON)

getCircuits(): string[]

Get list of supported F1 circuits.

Returns: Array of circuit IDs

getTireCompounds(): string[]

Get list of tire compound types.

Returns: Array of compound IDs (C0-C5, Intermediate, Wet)

version(): string

Get package version.

Returns: Version string

Performance Benchmarks

Optimization (70 laps, 3 compounds):
├─ @f1-nexus/node:     45ms
├─ Pure JavaScript:    4,200ms
└─ Speedup:            93x

Simulation (10,000 iterations):
├─ @f1-nexus/node:     1,850ms
├─ Pure JavaScript:    185,000ms
└─ Speedup:            100x

Use Cases

• REST APIs: High-performance strategy optimization endpoints
• Real-time Apps: WebSocket servers for live race strategy
• CLI Tools: Fast command-line strategy calculators
• Discord Bots: F1 strategy assistant for Discord servers
• Batch Processing: Analyze thousands of race scenarios
• Serverless Functions: AWS Lambda, Vercel Edge, Cloudflare Workers

Examples

CLI Tool

#!/usr/bin/env node
const f1 = require('@f1-nexus/node');

const params = {
  track: process.argv[2] || 'monaco',
  totalLaps: parseInt(process.argv[3]) || 78,
  availableCompounds: ['C1', 'C2', 'C3']
};

const strategy = JSON.parse(f1.optimizeStrategy(JSON.stringify(params)));
console.table(strategy.pitStops);

Background Worker

const { Worker } = require('worker_threads');
const f1 = require('@f1-nexus/node');

// Run heavy simulations in worker threads
const worker = new Worker('./strategy-worker.js');

worker.postMessage({
  action: 'simulate',
  params: { /* ... */ }
});

worker.on('message', (result) => {
  console.log('Simulation complete:', result);
});

Documentation

• API Reference
• Examples
• Crate Docs

Related Packages

• @f1-nexus/wasm - Browser WASM bindings
• f1-nexus-cli - Command-line interface

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.